.TH LS 1 "GNU File Utilities" "FSF" \" -*- nroff -*-
.SH NV
ls, dir, vdir \- knyvtrak tartalmnak listzsa
.SH TTEKINTS
.B ls
[\fIOPCI\fR]... [\fINV\fR]...
.SH LERS
Ez a dokumentci a tovbbiakban nincs karbantartva s pontatlan vagy
hinyos lehet. A Texinfo dokumentci a hiteles forrs. 
.PP
Ez a kziknyv lap az
.BR ls
GNU vltozatt dokumentlja.
.B dir
s
.B vdir
az
.B ls
vltozatai ms alaprtelmezett kimeneti formtummal. Ezek a programok a
megadott fjlokat s knyvtrakat listzzk. A knyvtrak tartalma ABC
szerint lesz rendezve.
Az
.BR ls
alaprtelmezs szerint oszlopokba rendezett listt ad, fggleges
rendezssel ha a kimenet egy terminl. Ms esetben soronknt egy nevet r ki. 
A
.BR dir
s a
.BR vdir
alaprtelmezs szerint hossz formtum listt adnak.
.SH OPCIK
.TP
.I "\-a, \-\-all"
Minden knyvtrbeli fjlt listz, belertve a `.'-tal kezdd neveket is.
.TP
.I "\-b, \-\-escape"
A fjlnevekben elfordul nemgrafikus karaktereket \\xxx formban jelenti
meg, ahol xxx helyn llhat bet vagy oktlis szm. Ez a jells a
nemgrafikus karakterek C-beli jellsvel egyezik meg.
.TP
.I "\-c, \-\-time=ctime, \-\-time=status"
A knyvtr tartalmt a fjlok sttusznak megvltoztatsi ideje 
szerint rendezi a mdostsi id helyett. Hossz listzsi forma esetn a
sttusz megvltoztatsnak idejt rja ki a mdostsi id helyett.
.TP
.I "\-d, \-\-directory"
A knyvtrakat a tbbi fjlhoz hasonlan listzza ahelyett, hogy a
tartalmukat listzn.
.TP
.I "\-f"
Nem rendezi a knytrak tartalmt, hanem a lemezen val trolsi
sorrendjkben jelenti meg.
Ugyanaz, mint
.I \-a
s
.I \-U
megengedse s
.I \-l,
.I \-s,
s
.I \-t
kikapcsolsa.
.TP
.I "\-\-full-time"
Az idket teljes formban jelenti meg a szoksos rvidtsi szoksok szerint.
.TP
.I \-g
Nincs funkcija, csak a Unix kompatibilits miatt szerepel.
.TP
.I "\-i, \-\-inode"
A fjlnevek mellett bal oldalon megjelenti a fjl indexnek szmt.
.TP
.I "\-k, \-\-kilobytes"
A fjlmreteket (ha egytaln listzsra kerlnek) kilobjtban adja meg.
Fellbrlja a POSIXLY_CORRECT krnyezeti vltoz hatst.
.TP
.I "\-l, \-\-format=long, \-\-format=verbose"
A fjlnevek mellett megadja a fjl tpust, engedlyeit a kemny ktsek
(hard link) szmt, a tulajdonos- s a csoportnevet, a mretet bjtokban s
az idblyeget, azaz a mdostsi idt, hacsak nem ms idt vlasztottunk
egy msik opcival. Hat hnapnl rgebbi, vagy a jelenleginl tbb mint egy
rval ksbbi idvel rendelkez fjlok esetn az idblyeg az vet
tartalmazza a napon belli idpont helyett.
.TP
.I "\-m, \-\-format=commas"
A fjlneveket sorfolytonosan, vesszkkel elvlasztva listzza.
.TP
.I "\-n, \-\-numeric-uid-gid"
Az UID s GID rtkeket numerikusan listzza a nevek helyett.
.TP
.I \-p
A fjlnevekhez egy tpust jelz karaktert fz. (A knyvtrak nev utn
/-jelet.)
.TP
.I "\-q, \-\-hide-control-chars"
A nemgrafikus karakterek helyett krdjeleket r a fjlnevekbe.
.TP
.I "\-r, \-\-reverse"
A rendezst megfordtja.
.TP
.I "\-s, \-\-size"
A fjlok mrett is kijelzi. Alaprtelmezs
szerint ez 1 kilobjtos egysgekben rtend, hacsak nem a rtket adtunk a 
POSIXLY_CORRECT krnyezeti vltoznak. Ekkor 512 bjtos blokkok szmtanak
egysgnek.
.TP
.I "\-t, \-\-sort=time"
A knyvtr tartalmt az idblyeg szerint rendezi; az jabb fjlok kerlnek
elbbre.
.TP
.I "\-u, \-\-time=atime, \-\-time=access, \-\-time=use"
A knyvtr tartalmt a fjlok utols elrsi ideje szerint rendezi a
mdostsi id helyett. Hossz listzsi forma esetn az utols elrs ideje
kerl kirsra a mdostsi id helyett.
.TP
.I "\-x, \-\-format=across, \-\-format=horizontal"
Oszlopokba rendezetten dolgozik, vzszintes irnyban rendez.
.TP
.I "\-A, \-\-almost-all"
A `.' s `..' knyvtrakon kvl minden fjlt listz.
.TP
.I "\-B, \-\-ignore-backups"
Nem listzza a `~'-re vgzd fjlokat, hacsak nem a parancssorban adottak.
.TP
.I "\-C, \-\-format=vertical"
Oszlopokba rendezetten dolgozik, fggleges irnyban rendez.
.TP
.I "\-F, \-\-classify"
A fjlnevekhez egy, a fjl tpust jelz karaktert fz. Szablyos
vgrehajthat fjl esetn ez egy `*'-jel, knyvtr esetn `/', szimbolikus
kts esetn `@', FIFO esetn `|', socketek esetn `=', ms esetekben semmi.
.TP
.I "\-G, \-\-no\-group"
Elhagyja a csoportra vonatkoz informcik kijelzst hossz listzskor.
.TP
.I "\-L, \-\-dereference"
A szimbolikus ktsek ltal mutatott fjlokat listzza a kts listzsa
helyett.
.TP
.I "\-N, \-\-literal"
A fjlneveket pontosan adja vissza. (Ellentte -b -nek.)
.TP
.I "\-Q, \-\-quote-name"
A fjlneveket idzjelek kz teszi s a nemgrafikus karaktereket a C
nyelvnek megfelelen rja ki.
.TP
.I "\-R, \-\-recursive"
Minden knyvtr tartalmt rekurzvan listzza.
.TP
.I "\-S, \-\-sort=size"
A knyvtr tartalmt fjlmret szerint rendezi; a nagyobb fjlok kerlnek
elre.
.TP
.I "\-U, \-\-sort=none"
Nem rendezi a knyvtr tartalmt, hanem a lemezen val trols sorrendjben
listzza ket. Ezt az opcit azrt nem 
.I \-f
-nek nevezik, mert a Unix
.B ls
.I \-f
opci szintn megengedi a 
.I \-a
-t s nem engedi 
.IR \-l ,
.IR \-s ,
s
.IR \-t .
Az eredeti Unix 
.I -f
-je
haszontalannak s azon csnya dolgok csoportjba tartoznak tnik, melyek
olyan dolgokat kapcsolnak ssze egy opciban, melyeknek nincs kzk egymshoz.
Mivel 
.I -U
nem csinlja ezt, ezrt ms nevet kapott kompatibilitsi okokbl.
.TP
.I "\-X, \-\-sort=extension"
A knyvtrat a fjlok kiterjesztse alapjn rendezi. (Kiterjeszts = az
utols `.' utni rsze a fjlnvnek.) A kiterjeszts nlkli fjlokat elre
teszi.
.TP
.I "\-1, \-\-format=single-column"
Soronknt egy fjlt listz.
.TP
.I "\-w, \-\-width cols"
A kpernyt
.I cols
oszlopszlessgnek ttelezi fel. Az alaprtelmezett rtket a terminl
meghajtprogramjbl prblja venni, ha nem sikerl, akkor a 
.B COLUMNS
krnyezeti vltoz rtkt hasznlja, ha ez sincs belltva, akkor 80-nak
veszi.
.TP
.I "\-T, \-\-tabsize cols"
A tabultorjeleket 
.I cols
oszlopszlessgnek ttelezi fel. Alaprtelmezs: 8.
.TP
.I "\-I, \-\-ignore pattern"
Nem listzza a 
.I pattern
mintnak megfelel fjlokat, hacsak nem adottak a parancssorban. 
.TP
.I "\-\-color, \-\-colour, \-\-color=yes, \-\-colour=yes"
Fjltpustl fggen sznezi a fjlok nevt. Lsd az
.B A KIMENET SZNEZSE
fejezetet lentebb.
.TP
.I "\-\-color=tty, \-\-colour=tty"
Ugyanaz, mint
.I \-\-color
de csak ha a szabvnyos kimenet egy terminl. Nagyon hasznos shell
szkriptekben s `alias' parancsoknl, klnsen ha a kedvenc trdeld
(pager) nem tmogatja a sznvezrl kdokat. 
.TP
.I "\-\-color=no, \-\-colour=no"
Kikapcsolja a sznezst. Ez az alaprtelmezett. Elz sznez opci
kikapcsolsra szolgl.
.TP
.I "\-\-help"
Hasznlati tmutatt r a szabvnyos kimenetre, majd kilp.
.TP
.I "\-\-version"
A program verzijrl r ki informcit a szabvnyos kimenetre, majd 
kilp.
.SH A KIMENET SZNEZSE
A 
.I "\-\-color"
opci hasznlatakor az
.B ls
jelen vltozata a kirt fjlneveket kisznezi a fjl tpusnak megfelelen.
Alaprtelmezs szerint ez a sznezs csak a tpustl fgg, s a hasznlt
kdok megfelelnek az ISO 6429 (ANSI) szabvnynak.
.PP
Az alaprtelmezett sznezst fellbrlhatjuk a 
.B LS_COLORS
(vagy
.BR LS_COLOURS )
krnyezeti vltozval.
Ezen vltoz tartalmnak formtuma emlkeztet a termcap(5) fjlformtumra:
kettsponttal elvlaszott kifejezsek listja, ahol a kifejezsek
"xx=string" formtumak. Itt "xx" egy ktkarakteres vltoznv, melyeket a
kvetkez tblzat tartalmaz alaprtelmezett rtkkkel egytt.
.sp
.RS +.2i
.ta 1.0i 2.5i
.nf
\fBno\fR       0       Normlis (nem fjlnv) szveg
\fBfi\fR       0       Szablyos fjl
\fBdi\fR       32      Knyvtr
\fBln\fR       36      Szimbolikus kts
\fBpi\fR       31      Cs (Named pipe, FIFO)
\fBso\fR       33      Socket
\fBbd\fR       44;37   Blokkos egysg (Block device)
\fBcd\fR       44;37   Karakteres egysg (Character device)
\fBex\fR       35      Vgrehajthat fjl
\fBmi\fR       (none)  hinyz fjl (fi alaprtelmezettje)
\fBor\fR       (none)  rva szimbolikus kts (ln alaprtelmezettje)
\fBlc\fR       \ee[    Bal kd
\fBrc\fR       m       Jobb kd
\fBec\fR       (none)  Vg kd (lc+no+rc -t helyettesti)
.fi
.RE
.sp
Csak azokat a vltozkat kell csatolni, melyek eltrnek az alaprtelmezettl.
.PP
A fjlnevek kiterjesztsk alapjn is sznezhetek. Ez az LS_COLORS
vltozban llthatjuk be "*ext=string" formban. Pldul ISO 6429 kdokat
hasznlva a "*.c=34" taggal a C forrsfjlokat kkkel jelenthetjk meg. Ez
teht minden .c-re vgzd fjlt kkre (34-es kd) sznez.
.PP
A vezrlkarakterek C-stlusban (\e-escaped jellssel) vagy
.BR stty 
-szeren (a ^-jellssel) is rhatk. A C-stlusban \ee az Escape-t, \e_
normlis szkzt, \e? a trlst jelenti. Tovbb a \e escpace-karakter
hasznlhat a \e, ^, : s = alaprtelmezett rtelmezsnek fellbrlsra.
.PP
Mindegyik fjl az albbi formban rdik ki: "<lc> <color\ code> <rc>
<fjlnv> <ec>". Amennyiben <ec> nem definilt, akkor az "<lc> <no> <rc>"
sorozat helyettesti. Ezt ltalban knyelmesebb hasznlni, de kevsb
ltalnos. A bal- jobb- s vgkdok olyan mdon llnak rendelkezsre, 
hogy ne kelljen jr s jra azonos ismtld rszeket begpelni klnleges
terminlok esetn. ltalban nem is kell ket megvltoztatni, csak akkor, ha
a terminl nem hasznlja az ISO 6429 sznsorozatokat.
.PP
Ha a terminl az ISO 6429 sznkdokat hasznlja, a tpuskdok sszellthatk
(az
.BR lc ,
.BR rc ,
s
.B ec
kdok kivtelvel) 
pontosvesszkkel elvlasztoyy numerikus parancsokbl. A leggyakoribb
parancsoka:
.sp
.RS +.2i
.ta 1.0i
.nf
 0     alaprtelmezett szn visszalltsa
 1     vilgosabb szn
 4     alhzott szveg
 5     villog szveg
30     fekete eltr
31     vrs eltr
32     zld eltr
33     srga (vagy barna) eltr
34     kk eltr
35     bbor eltr
36     vilgoskk (cyan) eltr
37     fehr (vagy szrke) eltr
40     fekete httr
41     vrs httr
42     zld httr
43     srga (vagy barna) httr
44     kk httr
45     bbor httr
46     vilgoskk (cyan) httr
47     fehr (vagy szrke) httr
.fi
.RE
.sp
Nem minden parancs mkdik minden rendszeren s kijelz eszkzn.
.PP
Nhny terminlprogram nem rtlemezi az alaprtelmezett vgkdot
tkletesen. Ha minden szveg szines lesz egy knyvtrlistzs utn, prbld
meg kicserlni a
.B no
s
.B fi
kdokat 0-rl a sajt standard el- s httrszneidre.
.SH HIBK
BSD rendszereken a 
.I \-s
opci a pontos rtkek felt adja azokra a fjlokra, melyek NFS-en keresztl HP-UX
rendszerrl vannak beptve (mount-olva). HP-UX rendszereken a pontos
rtkek ktszerest adja az NFS-en keresztl beptett BSD rendszerekrl. Ez
a HP-UX hinyossga miatt van, amely a HP-UX sajt
.B ls
programjt is befolysolja.
.PP
Ha volna egyetlen standard az angol nyelvre, nem lenne szksg redundns
betzs tmogatsra. (color, colour)
.SH MAGYAR FORDTS
Horvth Andrs <horvatha@rs1.szif.hu>