Manpages

NÉV

find − fájlokat keres egy könyvtárstruktúrában

ÁTTEKINTÉS

find [útvonal...] [kifejezés]

LEÍRÁS

Ez a kézikönyv lap a find GNU változatát dokumentálja.

A find program a megadott fájloktól induló könyvtárfában keres a megadott kifejezés balról jobbra való kiértékelésével. A program által figyelembe vett precedenicaszabályokat lásd az OPERÁTOROK fejezetetben. Mihelyt egyértelmű, hogy egy fájl megfelel-e a kifejezésnek, a következő fájl vizsgálatába kezd. (Nem feltétlen értékeli ki tehát a teljes kifejezést. Pl. ha egy and kifejezés bal oldalán hamis, vagy egy or kifejezés bal oldalán igaz feltétel van, az egyértelművé teszi az egész kifejezés értékét. Ilyenkor a find nem vizsgálja tovább a kifejezést.)

Az első argumentum, amely ’−’, ’(’, ’)’, ’,’, vagy ’!’ jellel kezdődik jelenti a kifejezés elejét. Az ez előtti argumentumokat keresési útvonalaknak veszi a program, az ez utániakat a kifejezés további részeként. Ha nincs útvonal megadva, az aktuális könyvtárból indul a keresés. Ha pedig nincs kifejezés megadva, a ’-print’ lesz használva.

A find kilépési állapota 0 ha minden fájlt sikeresen feldolgozott, nagyobb, mint 0, ha valami hiba történt.

KIFEJEZÉSEK

A kifejezés opciókból, tesztekből és akciókból áll, melyeket operátorok választanak el egymástól. Az opciók a teljes műveletet befolyásolják, nemcsak egy fájlra vonatkoznak, és mindig igaz a visszatérési értékük. A tesztek igaz és hamis értéket egyaránt visszaadhatnak. Az akcióknak oldalhatásuk (side effect) van, és igaz vagy hamis értékkel is visszatérhetnek.

Az operátor elhagyható, ilyenkor az alapértelmezett −and kerül behelyettesítésre. Amennyiben a kifejezés a −prune -on kívül nem tartalmaz akciót, a −print lesz végrehajtva minden fájlra, melyre a kifejezés igaz.

OPCIÓK

Minden opció mindig igaz értéket ad vissza. Mindig hatnak, nemcsak akkor, amikor a feldolgozás eljut a helyükre. Ezért az áttekinthetőség kedvéért a kifejezés elejére célszerű tenni őket.
−daystart

Az időpontokat (−amin, −atime, −cmin, −ctime, −mmin, és −mtime esete) a mai nap kezdetétől számítja, nem 24 órával ezelőttől.

−follow

Nem a szimbolikus kötésekre hivatkozik, hanem az általuk mutatott fájlra. Bekapcsolja −noleaf-ot is.

−help, −−help

Egy összegzést ír ki a find használatáról, majd kilép.

−maxdepth levels

Legfeljebb levels (ez egy nemnegatív szám) mélységben megy bele a könyvtárstruktúrába. ’−maxdepth 0’ azt jelenti, hogy csak a parancssorban argumentumként megadott fájlokra kell a teszteket és az akciókat végrehajtani.

−mindepth levels

A levels-ben adott nemnegatív egésznél kisebb mélységben nem alkalmaz egyetlen tesztet vagy akciót sem. ’−mindepth 1’ azt jelenti, hogy a parancssori argumentumokat nem, csak az alattuk levő könyvtárakat dolgozza fel.

−noleaf

Nem használja azt a feltevést, hogy a könyvtárak kettővel kevesebb alkönyvtárat tartalmaznak, mint a kemény kötéseik száma. Erre olyankor van szükség, amikor a keresés olyan fájlrendszeren történik, amelyik nem követi a Unix könyvtárkonvencióit, mint pl. az MS-DOS vagy a CD-ROM-ok.

Unix alatt ugyanis minden könyvtárnak van két kemény kötése: a saját neve és a ’.’ bejegyzés. Továbbá, minden alkönyvtárának van egy ’..’ bejegyzése, amely rá vonatkozik. Ezért tehát a Unix-ban egy könyvtár kemény kötéseinek száma mindig kettővel több alkönyvtárainak számánál. Ennek felhasználásával a keresés Unix rendszereken jelentősen gyorsítható, mert a kemény kötések számánál kettővel kevesebb alkönyvtár megvizsgálása után nem kell továbbiakat keresni, azaz nem kell egy csomó másik fájlt vizsgálni, hisz azok biztosan normális, azaz "levél" (leaf) fájlok. Ez a feltételezés természetesen nem igaz más rendszerekben, így ott find kihagyhatna alkönyvtárakat.
−version, −−version

Kiírja a verziószámot és kilép.

TESZTEK

Numerikus argumentumok az alábbi módon adhatók meg:

−amin n

A fájl utoljára n perce lett használva.

−anewer file

A fájl utolsó használata frissebb, mint a file módosítási dátuma. −anewer -t csak akkor befolyásolja a −follow, ha a −follow előbb szerepel a parancssorban, mint −anewer.

−atime n

A fájl utoljára n*24 órája lett használva.

−cmin n

A fájl státusza n perce lett utoljára módosítva.

−cnewer file

A fájl utolsó státuszmódosítása frissebb, mint a file módosítási dátuma. −cnewer -t csak akkor befolyásolja a −follow, ha a −follow előbb szerepel a parancssorban, mint −cnewer.

−ctime n

A fájl státusza utoljára n*24 órája lett módosítva.

−fstype type

A fájl type típusú fájlrendszeren van. Az érvényes fájlrendszer-típusok a Unix változataitól függenek. Egy nem teljes lista a Unix rendszerek alatt előforduló fájlrendszerekről: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K. (Linux alatt a legjellemzőbbek: ext2, msdos, minix, iso9660, vfat.) A −printf a %F direktívával a fájlrendszer típusának megállapítására használható.

−group gname

A fájl a gname csoporthoz tartozik. (Numerikus érték is megengedett.)

−ilname pattern

Ugyanaz, mint −lname, csak nem tesz különbséget a kis- és nagybetűk között.

−iname pattern

Ugyanaz, mint −name, csak nem tesz különbséget a kis- és nagybetűk között. Páldául a ’fo*’ és ’F??’ minták illeszkednek a ’Foo’, ’FOO’, ’foo’, ’fOo’ fájlnevekhez is.

−inum n

A fájl inode száma n.

−ipath pattern

Ugyanaz, mint −path, csak nem tesz különbséget a kis- és nagybetűk között.

−iregex pattern

Ugyanaz, mint −regex, csak nem tesz különbséget a kis- és nagybetűk között.

−links n

A fájlnak n kötése van.

−lname pattern

A fájl egy szimbolikus kötés, melynek tartalma illeszkedik a pattern burokmintára. A metakarakterek nem kezelik a ’/’-t és a ’.’-t speciálisan.

−mmin n

A fájl adatai utoljára n perce lettek módosítva.

−mtime n

A fájl adatai utoljára n*24 órája lettek módosítva.

−name pattern

A fájlnév alapja (azaz a fájl elérési útja a bevezető könyvtárak nélkül) illeszkedik a pattern burokmintához. A metakarakterek (’*’, ’?’ és ’[]’) nem illeszkednek a fájl alapneve elején található ’.’-hoz. Egy könyvtár és az alatta levő fájlok figyelmen kívül hagyására a −prune használható. (Lásd a −path leírásánál levő példát.)

−newer file

A fájl frissebben lett módosítva, mint file. −newer -t csak akkor befolyásolja a −follow, ha a −follow előbb szerepel a parancssorban, mint −newer.

−nouser

Nincs a fájl numerikus felhasználói azonosítójának (user ID) megfelelő felhasználó.

−nogroup

Nincs a fájl numerikus csoportazonosítójának (group ID) megfelelő csoport.

−path pattern

A fájlnév illeszkedik a pattern burokmintához. A metakarakterek nem kezelik ’/’-t és ’.’-t speciálisan. Például:

find . −path ’./sr*sc’

kinyomtat egy bejegyzést a ’./src/misc’ könyvtárról, ha az létezik. Egy teljes könyvtárfa figyelmen kívül hagyásához a −prune használható a fa minden fájljának ellenőrzése helyett. Például a többi fájl nevének nyomtatása megvalósítható a következő módon:

find . −path ’./src/emacs’ -prune -o -print

−perm mode

A fájl engedélybitjei pontosan a mode -nak megfelelőek. A mode megadása lehet oktális vagy szimbolikus. Szimbolikus esetben a 0 mód a kiindulás.

−perm −mode

A mode minden engedélybitje be van állítva a fájlra is.

−perm +mode

A mode engedélybitjeinek valamelyike be van állítva a fájlra is.

−regex pattern

A fájlnév illeszkedik a pattern szabályos kifejezéshez. Az illeszkedés a teljes elérési útra vonatkozik, nem a keresésre. Például egy ’./fubar3’ fájlhoz való illeszkedésre használható a ’.*bar.’ vagy ’.*b.*3’ szabályos kifejezés, de a ’b.*r3’ nem.

−size n[bckw]

A fájl mérete n egységnyi. Az egység az 512-bájtos blokk alapértelmezésben vagy ’b’ végződés esetén, bájt, ha a végződés ’c’, kilobájt, ha a végződés ’k’, 2-bájtos szó, ha a végződés ’w’.

−type c

A fájl c típusú, ahol a lehetséges értékek:

A fájl numerikus felhasználói azonosítója (user ID) n.

−used n

A fájl utoljára n nappal a státusza megváltoztatása után volt használatban.

−user uname

A fájl a uname felhasználó tulajdonában van. (Numerikus érték is megengedett.)

−xtype c

Ugyanaz, mint −type, hacsak nem a fájl szimbolikus kötés. Ebbean az esetben: ha −follow nem adott, akkor igaz az értéke amennyiben a fájl egy c típusú fájlra mutató link; amennyiben −follow is adott, igaz, ha c egyenlő ’l’-lel. Más szavakkal: szimbolikus kötés esetén −xtype annak a fájlnak a típusát vizsgálja, amit −type nem vizsgál.

AKCIÓK

−exec command ;

Végrehajtja a command parancsot. Értéke igaz, ha a parancs 0 státuszt ad vissza. A következő ’;’-ig a find minden argumentumát a parancs argumentumának veszi. A ’{}’ string az aktuálisan feldolgozás alatt álló fájl nevével helyettesítődik. Ezen szerkezeteket esetlegesen meg kell védeni (a ’\’ használatával) attól, hogy a burok kifejtese őket. A parancs végrehajtása a kiindulási könyvtárból történik.

−fls file

Igaz; ugyanaz, mint −ls, csak a file-ba ír. (Az −fprint -hez hasonlóan.)

−fprint file

Igaz. A teljes fájlnevet a file fájlba írja. Amennyiben a file nem létezik a find futtatásakor, a find létrehozza, ha pedig létezik, csonkolja. A ’’/dev/stdout’’ és ’’/dev/stderr’’ fájlenevket speciálisan kezeli: a szabványos kimenetre és szabványos bemenetre vonatkoznak.

−fprint0 file

Igaz; ugyanaz, mint −print0, csak azfile fájlba ír. (Az −fprint -hez hasonlóan.)

−fprintf file format

Igaz; ugyanaz, mint −printf, csak azfile fájlba ír. (Az −fprint -hez hasonlóan.)

−ok command ;

Ugyanaz, mint −exec, de először megkérdezi a felhasználót a standard bemeneten. Amennyiben a válasz nem ’y’-nal vagy ’Y’-nal kezdődik, nem futtatja a parancsot, és hamis értékkel tér vissza.

−print0

Igaz; a fájl teljes nevét, majd egy null-karaktert a standard kimenetre írja. Ez megengedi, hogy újsor-jelet tartalmazó fájlnevek esetén a find kimenetét feldolgozó programok jól működjenek.

−printf format

Igaz; a format által megadott formátumban nyomtat a a standard kimenetre. Értelmezi a ’\’ és ’%’ direktívákat. Mezőszélesség és pontosság a C-beli ’printf’-fel megegyező módon adható meg. A −print-től eltérően −printf nem ír ki automatikusan újsorjelet a kimenetre. A direktívák a következők lehetnek:

Egy ’\’, majed egy másik karakter rendes karakterként viselkedik, azaz mindegyik kinyomtatásra kerül.

@

Időmezők:

Dátum mezők:

A fájlméret 512 bájtos blokkokban (felkerekítve).

A ’%’ jel után álló bármely más karakter esetén csak a megadott karakter íródik ki.

Ha −depth adott, akkor hamis és nincs hatása.

OPERÁTOROK

Az operátorokat csökkenő precedenciasorrendben listázzuk:
( expr )

Precedencia változtatás.

−not expr

Ugyanaz, mint ! expr.

expr1 expr2

Logikai és. Nem értékeli ki expr2-t, ha expr1 hamis.

expr1 −a expr2

Ugyanaz, mint expr1 expr2.

expr1 −and expr2

Ugyanaz, mint expr1 expr2.

expr1 −o expr2

Logikai vagy. expr2-t nem értékeli ki, ha expr1 igaz.

expr1 −or expr2

Ugyanaz, mint expr1 −o expr2.

expr1 , expr2

Listáz. expr1 és expr2 is mindig kiértékelésre kerül. expr1 értéke nem számít, a lista expr2 értékét adja vissza.

LÁSD MÉG

locate(1), locatedb(5), updatedb(1), xargs(1) Finding Files (Info fájl, vagy nyomtatott változat)

MAGYAR FORDÍTÁS

Horváth András <horvatha [AT] rs1.hu>