.TH FIND 1 \" -*- nroff -*-
.SH NV
find \- fjlokat keres egy knyvtrstruktrban
.SH TTEKINTS
.B find
[tvonal...] [kifejezs]
.SH LERS
Ez a kziknyv lap a
.BR find
GNU vltozatt dokumentlja.
.PP
A
.B find
program a megadott fjloktl indul knyvtrfban keres a megadott
kifejezs balrl jobbra val kirtkelsvel. A program ltal
figyelembe vett precedenicaszablyokat lsd az OPERTOROK
fejezetetben. Mihelyt egyrtelm, hogy egy fjl megfelel-e a
kifejezsnek, a kvetkez fjl vizsglatba kezd.  (Nem felttlen
rtkeli ki teht a teljes kifejezst. Pl. ha egy \fIand\fR kifejezs
bal oldaln hamis, vagy egy \fIor\fR kifejezs bal oldaln igaz
felttel van, az egyrtelmv teszi az egsz kifejezs rtkt. Ilyenkor a 
.B find
nem vizsglja tovbb a kifejezst.)
.PP
Az els argumentum, amely `\-', `(', `)', `,', vagy `!' jellel
kezddik jelenti a kifejezs elejt. Az ez eltti argumentumokat
keressi tvonalaknak veszi a program, az ez utniakat a kifejezs
tovbbi rszeknt. Ha nincs tvonal megadva, az aktulis knyvtrbl
indul a keress. Ha pedig nincs kifejezs megadva, a `-print' lesz
hasznlva.
.PP
A
.B find
kilpsi llapota 0 ha minden fjlt sikeresen feldolgozott, nagyobb,
mint 0, ha valami hiba trtnt.
.SH KIFEJEZSEK
.P
A kifejezs opcikbl, tesztekbl s akcikbl ll, melyeket
opertorok vlasztanak el egymstl. Az opcik a teljes mveletet
befolysoljk, nemcsak egy fjlra vonatkoznak, s mindig igaz a
visszatrsi rtkk. A tesztek igaz s hamis rtket egyarnt
visszaadhatnak. Az akciknak oldalhatsuk (side effect) van, s igaz
vagy hamis rtkkel is visszatrhetnek.
.PP
Az opertor elhagyhat, ilyenkor az alaprtelmezett \-and kerl
behelyettestsre. Amennyiben a kifejezs a \-prune -on kvl nem
tartalmaz akcit, a \-print lesz vgrehajtva minden fjlra, melyre a
kifejezs igaz.
.SH OPCIK
.P
Minden opci mindig igaz rtket ad vissza. Mindig hatnak, nemcsak
akkor, amikor a feldolgozs eljut a helykre. Ezrt az ttekinthetsg
kedvrt a kifejezs elejre clszer tenni ket.
.IP \-daystart
Az idpontokat (\-amin, \-atime, \-cmin, \-ctime, \-mmin, s \-mtime esete)
a mai nap kezdettl szmtja, nem 24 rval ezelttl.
.IP \-depth
A knyvtrak feldolgozsa eltt tartalmukat dolgozza fel.
.IP \-follow
Nem a szimbolikus ktsekre hivatkozik, hanem az ltaluk mutatott
fjlra. Bekapcsolja \-noleaf-ot is.
.IP "\-help, \-\-help"
Egy sszegzst r ki a
.B find
hasznlatrl, majd kilp.
.IP "\-maxdepth \fIlevels\fR"
Legfeljebb \fIlevels\fR (ez egy nemnegatv szm) mlysgben megy bele
a knyvtrstruktrba. `\-maxdepth 0' azt jelenti, hogy csak a
parancssorban argumentumknt megadott fjlokra kell a teszteket s az
akcikat vgrehajtani.
.IP "\-mindepth \fIlevels\fR"
A \fIlevels\fR-ben adott nemnegatv egsznl kisebb mlysgben nem
alkalmaz egyetlen tesztet vagy akcit sem. `\-mindepth 1' azt jelenti,
hogy a parancssori argumentumokat nem, csak az alattuk lev
knyvtrakat dolgozza fel.
.IP \-mount
Nem megy bele olyan alknyvtrba, amely ms fjlrendszeren
van. Ugyanaz, mint \-xdev. (Csak kompatibilitsi okokbl kerlt
implementlsra.)
.IP "\-noleaf"
Nem hasznlja azt a feltevst, hogy a knyvtrak kettvel kevesebb
alknyvtrat tartalmaznak, mint a kemny ktseik szma. Erre olyankor
van szksg, amikor a keress olyan fjlrendszeren trtnik, amelyik
nem kveti a Unix knyvtrkonvenciit, mint pl. az MS-DOS vagy a
CD-ROM-ok. 
.PP
Unix alatt ugyanis minden knyvtrnak van kt kemny ktse: a sajt
neve s a `.' bejegyzs. Tovbb, minden alknyvtrnak van egy `..'
bejegyzse, amely r vonatkozik. Ezrt teht a Unix-ban egy knyvtr
kemny ktseinek szma mindig kettvel tbb alknyvtrainak
szmnl. Ennek felhasznlsval a keress Unix rendszereken
jelentsen gyorsthat, mert a kemny ktsek szmnl kettvel
kevesebb alknyvtr megvizsglsa utn nem kell tovbbiakat keresni,
azaz nem kell egy csom msik fjlt vizsglni, hisz azok biztosan
normlis, azaz "levl" (leaf) fjlok. Ez a felttelezs termszetesen
nem igaz ms rendszerekben, gy ott
.B find
kihagyhatna alknyvtrakat.
.IP "\-version, \-\-version"
Kirja a verziszmot s kilp.
.IP \-xdev
Nem megy bele olyan alknyvtrba, amely ms fjlrendszeren van.
.SH TESZTEK
.P
Numerikus argumentumok az albbi mdon adhatk meg:
.IP \fI+n\fP
nagyobb mint
.IR n ,
.IP \fI\-n\fP
kisebb mint 
.IR n ,
.IP \fIn\fP
pontosan
.IR n .
.IP "\-amin \fIn\fR"
A fjl utoljra \fIn\fR perce lett hasznlva.
.IP "\-anewer \fIfile\fR"
A fjl utols hasznlata frissebb, mint a \fIfile\fR mdostsi
dtuma.  \-anewer -t csak akkor befolysolja a \-follow, ha a
\-follow elbb szerepel a parancssorban, mint \-anewer.
.IP "\-atime \fIn\fR"
A fjl utoljra \fIn\fR*24 rja lett hasznlva.
.IP "\-cmin \fIn\fR"
A fjl sttusza \fIn\fR perce lett utoljra mdostva.
.IP "\-cnewer \fIfile\fR"
A fjl utols sttuszmdostsa frissebb, mint a \fIfile\fR mdostsi
dtuma.  \-cnewer -t csak akkor befolysolja a \-follow, ha a
\-follow elbb szerepel a parancssorban, mint \-cnewer.
.IP "\-ctime \fIn\fR"
A fjl sttusza utoljra \fIn\fR*24 rja lett mdostva.
.IP \-empty
A fjl res. (Szablyos fjlra s knyvtrra is vonatkozik.)
.IP \-false
Mindig hamis
.IP "\-fstype \fItype\fR"
A fjl \fItype\fR tpus fjlrendszeren van. Az rvnyes
fjlrendszer-tpusok a Unix vltozataitl fggenek. Egy nem teljes
lista a Unix rendszerek alatt elfordul fjlrendszerekrl: ufs, 4.2,
4.3, nfs, tmp, mfs, S51K, S52K. (Linux alatt a legjellemzbbek: ext2,
msdos, minix, iso9660, vfat.) A \-printf a %F direktvval
a fjlrendszer tpusnak megllaptsra hasznlhat.
.IP "\-gid \fIn\fR"
A fjl numerikus csoportazonostja (group ID) \fIn\fR.
.IP "\-group \fIgname\fR"
A fjl a \fIgname\fR csoporthoz tartozik. (Numerikus rtk is megengedett.)
.IP "\-ilname \fIpattern\fR"
Ugyanaz, mint \-lname, csak nem tesz klnbsget a kis- s nagybetk kztt.
.IP "\-iname \fIpattern\fR"
Ugyanaz, mint \-name, csak nem tesz klnbsget a kis- s nagybetk
kztt.  Pldul a `fo*' s `F??' mintk illeszkednek a `Foo', `FOO',
`foo', `fOo' fjlnevekhez is.
.IP "\-inum \fIn\fR"
A fjl inode szma \fIn\fR.
.IP "\-ipath \fIpattern\fR"
Ugyanaz, mint \-path, csak nem tesz klnbsget a kis- s nagybetk kztt.
.IP "\-iregex \fIpattern\fR"
Ugyanaz, mint \-regex, csak nem tesz klnbsget a kis- s nagybetk kztt.
.IP "\-links \fIn\fR"
A fjlnak \fIn\fR ktse van.
.IP "\-lname \fIpattern\fR"
A fjl egy szimbolikus kts, melynek tartalma illeszkedik a
\fIpattern\fR burokmintra. A metakarakterek nem kezelik a `/'-t s a
`.'-t specilisan.
.IP "\-mmin \fIn\fR"
A fjl adatai utoljra \fIn\fR perce lettek mdostva.
.IP "\-mtime \fIn\fR"
A fjl adatai utoljra \fIn\fR*24 rja lettek mdostva.
.IP "\-name \fIpattern\fR"
A fjlnv alapja (azaz a fjl elrsi tja a bevezet knyvtrak
nlkl) illeszkedik a \fIpattern\fR burokminthoz. A metakarakterek
(`*', `?' s `[]') nem illeszkednek a fjl alapneve elejn tallhat
`.'-hoz. Egy knyvtr s az alatta lev fjlok figyelmen kvl
hagysra a \-prune hasznlhat. (Lsd a \-path lersnl lev pldt.)
.IP "\-newer \fIfile\fR"
A fjl frissebben lett mdostva, mint \fIfile\fR. 
\-newer -t csak akkor befolysolja a \-follow, ha a
\-follow elbb szerepel a parancssorban, mint \-newer.
.IP \-nouser
Nincs a fjl numerikus felhasznli azonostjnak (user ID) megfelel
felhasznl.
.IP \-nogroup
Nincs a fjl numerikus csoportazonostjnak (group ID) megfelel
csoport.
.IP "\-path \fIpattern\fR"
A fjlnv illeszkedik a \fIpattern\fR burokminthoz. A metakarakterek
nem kezelik `/'-t s `.'-t specilisan. Pldul:
.br
.in +1i
find . \-path './sr*sc'
.br
.in -1i
kinyomtat egy bejegyzst a './src/misc' knyvtrrl, ha az
ltezik. Egy teljes knyvtrfa figyelmen kvl hagyshoz a \-prune
hasznlhat a fa minden fjljnak ellenrzse helyett. Pldul a
'src/emacs' s minden fjljnak illetve alknyvtrnak tlpse, s a
tbbi fjl nevnek nyomtatsa megvalsthat a kvetkez mdon:
.br
.in +1i
find . \-path './src/emacs' -prune -o -print
.br
.in -1i
.IP "\-perm \fImode\fR"
A fjl engedlybitjei pontosan a \fImode\fR -nak megfelelek. A
\fImode\fR megadsa lehet oktlis vagy szimbolikus. Szimbolikus
esetben a 0 md a kiinduls.
.IP "\-perm \-\fImode\fR"
A \fImode\fR minden engedlybitje be van lltva a fjlra is.
.IP "\-perm +\fImode\fR"
A \fImode\fR engedlybitjeinek valamelyike be van lltva a fjlra is.
.IP "\-regex \fIpattern\fR"
A fjlnv illeszkedik a \fIpattern\fR szablyos kifejezshez. Az
illeszkeds a teljes elrsi tra vonatkozik, nem a keressre. Pldul
egy `./fubar3' fjlhoz val illeszkedsre hasznlhat a `.*bar.' vagy
`.*b.*3' szablyos kifejezs, de a `b.*r3' nem.
.IP "\-size \fIn\fR[bckw]"
A fjl mrete \fIn\fR egysgnyi. Az egysg az 512-bjtos blokk
alaprtelmezsben vagy `b' vgzds esetn, bjt, ha a vgzds `c',
kilobjt, ha a vgzds `k', 2-bjtos sz, ha a vgzds `w'. 
.IP \-true
Mindig igaz.
.IP "\-type \fIc\fR"
A fjl \fIc\fR tpus, ahol a lehetsges rtkek:
.RS
.IP b
blokkos (pufferelt) specilis eszkzfjl
.IP c
karakteres (nem pufferelt) specilis eszkzfjl
.IP d
knyvtr
.IP p
cshlzat (named pipe, FIFO)
.IP f
szablyos fjl
.IP l
szimbolikus kts
.IP s
socket
.RE
.IP "\-uid \fIn\fR"
A fjl numerikus felhasznli azonostja (user ID) \fIn\fR. 
.IP "\-used \fIn\fR"
A fjl utoljra \fIn\fR nappal a sttusza megvltoztatsa utn volt
hasznlatban. 
.IP "\-user \fIuname\fR"
A fjl a \fIuname\fR felhasznl tulajdonban van. (Numerikus rtk is
megengedett.)
.IP "\-xtype \fIc\fR"
Ugyanaz, mint \-type, hacsak nem a fjl szimbolikus kts. Ebbean az
esetben: ha \-follow nem adott, akkor igaz az rtke amennyiben a fjl
egy \fIc\fR tpus fjlra mutat link; amennyiben \-follow is adott,
igaz, ha \fIc\fR egyenl `l'-lel. Ms szavakkal: szimbolikus kts
esetn \-xtype annak a fjlnak a tpust vizsglja, amit \-type nem vizsgl.
.SH AKCIK
.IP "\-exec \fIcommand\fR ;"
Vgrehajtja a \fIcommand\fR parancsot. rtke igaz, ha a parancs 0
sttuszt ad vissza. A kvetkez `;'-ig a
.B find
minden argumentumt a parancs argumentumnak veszi. A `{}' string az
aktulisan feldolgozs alatt ll fjl nevvel helyettestdik. Ezen
szerkezeteket esetlegesen meg kell vdeni (a `\e' hasznlatval)
attl, hogy a burok kifejtese ket. A parancs vgrehajtsa a
kiindulsi knyvtrbl trtnik.
.IP "\-fls \fIfile\fR"
Igaz; ugyanaz, mint \-ls, csak a \fIfile\fR-ba r. (Az \-fprint -hez
hasonlan.)
.IP "\-fprint \fIfile\fR"
Igaz. A teljes fjlnevet a \fIfile\fR fjlba rja. Amennyiben a
\fIfile\fR nem ltezik a \fIfind\fR futtatsakor, a \fIfind\fR
ltrehozza, ha pedig ltezik, csonkolja. A ``/dev/stdout'' s
``/dev/stderr'' fjlenevket specilisan kezeli: a szabvnyos kimenetre
s szabvnyos bemenetre vonatkoznak.
.IP "\-fprint0 \fIfile\fR"
Igaz; ugyanaz, mint \-print0, csak az\fIfile\fR fjlba r.  (Az \-fprint -hez
hasonlan.)
.IP "\-fprintf \fIfile\fR \fIformat\fR"
Igaz; ugyanaz, mint \-printf, csak az\fIfile\fR fjlba r.  (Az \-fprint -hez
hasonlan.)
.IP "\-ok \fIcommand\fR ;"
Ugyanaz, mint \-exec, de elszr megkrdezi a felhasznlt a standard
bemeneten. Amennyiben a vlasz nem `y'-nal vagy `Y'-nal kezddik, nem
futtatja a parancsot, s hamis rtkkel tr vissza.
.IP \-print
Igaz; a fjl teljes nevt, majd egy jsor-jelet a szabvnyos kimenetre rja.
.IP \-print0
Igaz; a fjl teljes nevt, majd egy null-karaktert a standard
kimenetre rja.  Ez megengedi, hogy jsor-jelet tartalmaz fjlnevek
esetn a \fIfind\fR kimenett feldolgoz programok jl mkdjenek.
.IP "\-printf \fIformat\fR"
Igaz; a \fIformat\fR ltal megadott formtumban nyomtat a a standard
kimenetre. rtelmezi a `\e' s `%' direktvkat. Mezszlessg s
pontossg a C-beli `printf'-fel megegyez mdon adhat meg. A
\-print-tl eltren \-printf nem r ki automatikusan jsorjelet a
kimenetre. A direktvk a kvetkezk lehetnek:
.RS
.IP \ea
Figyelmeztet cseng (alarm bell).
.IP \eb
Fordtott trtvonal (backspace).
.IP \ec
Ezen formtumbl val nyomtatst meglltja s kirja (flush) a kimenetet.
.IP \ef
Soremels (form feed).
.IP \en
jsor (newline).
.IP \er
Kocsi vissza (carriage return).
.IP \et
Vzszintes tabultor (horizontal tab).
.IP \ev
Fggleges tabultor (vertical tab).
.IP \e\e
Bet szerinti fordtott trtvonal (literal backslash, `\e').
.PP
Egy `\e', majed egy msik karakter rendes karakterknt viselkedik,
azaz mindegyik kinyomtatsra kerl.
.IP %%
Bet szerinti szzalkjel.
.IP %a
A flj utols elrsi ideje a C `ctime' fggvnynek formtumban.
.IP %A\fIk\fP
A flj utols elrsi ideje a \fIk\fR ltal megadott formtumban. Ez
lehet `@', vagy egy direktva a C `strftime' fggvnynek
megfelelen. \fIk\fR lehetsges rtkeit a kvetkezkben
megadjuk. Nhny kzlk nem minden rendszeren elrhet a `strftime'
fggvnyek rendszerfggsge miatt.
.RS
.IP @
1970. janur 1. 00:00 GMT ta eltelt msodpercek.
.PP
Idmezk:
.IP H
ra (00..23)
.IP I
ra (01..12)
.IP k
ra ( 0..23)
.IP l
ra ( 1..12)
.IP M
perc (00..59)
.IP p
a `locale'-nak megfelel AM vagy PM
.IP r
id 12 rs formtumban (hh:mm:ss [AP]M)
.IP S
msodperc (00..61)
.IP T
id 24 rs formtumban (hh:mm:ss)
.IP X
a `locale'-nak megfelel idjelzs (H:M:S)
.IP Z
idzna (pl. EDT) vagy semmi, ha az idzna nem meghatrozhat
.PP
Dtum mezk:
.IP a
a `locale'-nak megfelel rvidtett napnv (pl. Sun..Sat)
.IP A
a `locale'-nak megfelel teljes napnv (pl. Sunday..Saturday)
.IP b
a `locale'-nak megfelel rvidtett hnapnv (pl. Jan..Dec)
.IP B
a `locale'-nak megfelel teljes hnapnv (pl. January..December)
.IP c
a `locale'-nak megfelel dtum s id (pl. Sat Nov 04 12:02:33 EST 1989)
.IP d
a hnap napja (01..31)
.IP D
dtum (mm/dd/yy) 
.IP h
ugyanaz, mint b
.IP j
az v napja (001..366)
.IP m
hnap (01..12)
.IP U
az v hnyadik hetrl van sz, ha vasrnappal kezdjk a heteket (00..53)
.IP w
a ht hnyadik napja (0..6)
.IP W
az v hnyadik hetrl van sz, ha htfvel kezdjk a heteket (00..53)
.IP x
a `locale'-nak megfelel dtum (pl. mm/dd/yy)
.IP y
az v utols kt jegye (00..99)
.IP Y
v (1970...)
.RE
.IP %b
A fjlmret 512 bjtos blokkokban (felkerektve).
.IP %c
A fjl sttusznak utols megvltoztatsi ideje a C `ctime'
fggvnynek formtumban.
.IP %C\fIk\fP
A fjl sttusznak utols megvltoztatsi ideje a \fIk\fR formtum
ltal megadott mdon (%A-hoz hasonlan).
.IP %d
A fjl mlysge a knyvtrfban. A 0 azt jelenti, hogy a fjl
parancssori argumentum volt.
.IP %f
A fjl neve a bevezet knyvtrnevek nlkl.
.IP %F
A fjlrendszer neve. Ez az rtk hasznlhat az \-fstype-nl.
.IP %g
A fjl csoportneve vagy a numerikus csoportazonost, ha nincs neve a
csoportnak.
.IP %G
A fjl numerikus csoportazonostja.
.IP %h
A teljes fjnv bevezet knyvtrnevei.
.IP %H
Azon parancssori argumentumok, melyek alatt nem tallt fjlt a \fIfind\fR.
.IP %i
A fjl inode szma decimlisan.
.IP %k
A fjl mrete 1K blokkokban (felkerektve).
.IP %l
A szimbolikus kts clja. (res, ha a fjl nem szimbolikus kts.)
.IP %m
A fjl engedlybitjei oktlisan.
.IP %n
A fjl kemny ktseinek szma.
.IP %p
A fjl (teljes) neve.
.IP %P
A fjl neve azon parancssori argumentum nlkl, amely alatt megtallta
a \fIfind\fR.
.IP %s
A fjl mrete bjtokban.
.IP %t
A fjl utols mdostsi ideje a C `ctime' fggvnynek formtumban.
.IP %T\fIk\fP
A fjl utols mdostsi ideje a \fIk\fR ltal megadott
formban. (Lsd %A-nl.)
.IP %u
A fjl tulajdonosnak neve, vagy numerikus felhasznli azonostja,
ha nincs neve a felhasznlnak.
.IP %U
A fjl tulajdonosnak numerikus felhasznli azonostja.
.PP
A `%' jel utn ll brmely ms karakter esetn csak a megadott
karakter rdik ki.
.RE
.IP \-prune
Ha nincs \-depth megadva, akkor igaz. Nem megy bele az aktulis knyvtrba.
.br
Ha \-depth adott, akkor hamis s nincs hatsa.
.IP \-ls
Igaz. listzza az aktulis fjlt `ls \-dils' formban a standard
kimenetre. A blokkmret 1K, hacsak nem a POSIXLY_CORRECT krnyezeti
vltoznak rtket adtunk. Ekkor 512 bjtos blokkmrettel szmol.
.SH OPERTOROK
.P
Az opertorokat cskken precedenciasorrendben listzzuk:
.IP "( \fIexpr\fR )"
Precedencia vltoztats.
.IP "! \fIexpr\fR"
Igaz, ha az \fIexpr\fR kifejezs hamis.
.IP "\-not \fIexpr\fR"
Ugyanaz, mint ! \fIexpr\fR.
.IP "\fIexpr1 expr2\fR"
Logikai s. Nem rtkeli ki \fIexpr2\fR-t, ha \fIexpr1\fR hamis.
.IP "\fIexpr1\fR \-a \fIexpr2\fR"
Ugyanaz, mint \fIexpr1 expr2\fR.
.IP "\fIexpr1\fR \-and \fIexpr2\fR"
Ugyanaz, mint \fIexpr1 expr2\fR.
.IP "\fIexpr1\fR \-o \fIexpr2\fR"
Logikai vagy. \fIexpr2\fR-t nem rtkeli ki, ha \fIexpr1\fR igaz.
.IP "\fIexpr1\fR \-or \fIexpr2\fR"
Ugyanaz, mint \fIexpr1\fR \-o \fIexpr2\fR.
.IP "\fIexpr1\fR , \fIexpr2\fR"
Listz. \fIexpr1\fR s \fIexpr2\fR is mindig kirtkelsre
kerl. \fIexpr1\fR rtke nem szmt, a lista \fIexpr2\fR rtkt adja
vissza.
.SH LSD MG
\fBlocate\fP(1), \fBlocatedb\fP(5), \fBupdatedb\fP(1), \fBxargs\fP(1)
\fBFinding Files\fP (Info fjl, vagy nyomtatott vltozat)
.SH MAGYAR FORDTS
Horvth Andrs <horvatha@rs1.szif.hu>