Manpages

NIMI

find − tiedostojen haku hakemistohierarkiasta

YLEISKATSAUS

find [polku...] [lauseke]

KUVAUS

Tämä käsikirjan sivu dokumentoi find-ohjelman GNU-version. find etsii kuhunkin annettuun tiedostonimeen liittyvän hakemistopuun laskemalla annetun lausekkeen arvon vasemmalta oikealle noudattaen laskentajärjestyssääntöjä (katso luku OPERAATTORIT), kunnes lopputulos on tiedossa (vasemman puolen and operaatioiden tulos on epätosi ja or operaatioiden tosi), jolloin find siirtyy seuraavaan tiedostonimeen.

Ensimmäinen argumentti, joka alkaa ’−’, ’(’, ’)’, ’,’ tai ’!’ oletetaan lausekkeen alkukohdaksi; kaikki argumentit ennen sitä ovat hakupolkuja, ja kaikki argumentit sen jälkeen ovat lausekkeen jatkoa. Ellei polkuja ole annettu, käytetään nykyistä hakemistoa. Jos mitään lauseketta ei ole annettu, käytetään lauseketta ’−print’.

find-ohjelman suorituksen jälkeen paluuarvo on 0, jos kaikki tiedostot on käsitelty onnistuneesti ja suurempi kuin 0, jos esiintyy virheitä.

LAUSEKKEET

Lauseke koostuu optioista (jotka vaikuttavat kokonaisoperaatioon eivätkä tietyn tiedoston käsittelyyn, ja palauttavat aina arvon tosi), testeistä (jotka palauttavat arvon tosi tai epätosi) ja toiminnoista (joilla on sivuvaikutuksia ja jotka palauttavat arvon tosi tai epätosi). Näitä kaikkia erottavat toisistaan operaattorit. −and on oletusarvo, jos operaattori puuttuu. Jos lauseke ei sisällä muita toimintoja kuin −prune, käytetään toimintoa −print kaikille tiedostoille, joilla lauseke saa arvon tosi.

OPTIOT
Kaikki optiot palauttavat aina arvon tosi. Ne vaikuttavat aina, eivät pelkästään silloin, kun niiden paikka lausekkeessa saavutetaan. Siksi ne on paras selvyyden vuoksi sijoittaa lausekkeen alkuun.
−daystart

Mittaa aikoja (−amin, −atime, −cmin, −ctime, −mmin ja −mtime) tämän vuorokauden alusta eikä ajankohdasta 24 tuntia sitten.

−follow

Seuraa symbolisia linkkejä. Olettaa option −noleaf.

−help, −−help

Tulostaa find −ohjelman komentorivin käyttöohjeen ja poistuu ohjelmasta.

−maxdepth tasot

Laskeudutaan enintään tasot (ei-negatiivinen kokonaisluku) hakemistotasoa komentoriviargumenttien alapuolelle.’−maxdepth 0’ tarkoittaa, että testejä ja toimintoja voidaan soveltaa vain komentoriviargumentteihin.

−mindepth tasot

Ei sovelleta testejä tai toimintoja tasoilla, jotka ovat vähemmän kuin tasot (ei-negatiivinen kokonaisluku). ’−mindepth 1’ tarkoittaa sitä, että käsitellään kaikki tiedostot lukuunottamatta komentoriviargumentteja.

−noleaf

Ei oleteta, että hakemistoissa on 2 alihakemistoa vähemmän kuin niiden kovien linkkien lukumäärä. Tämä optio tarvitaan, kun haku kohdistuu tiedostojärjestelmiin, jotka eivät noudata Unixin hakemisto-linkki-konventiota, esim. CD-ROM- tai MS-DOS -tiedostojärjestelmät tai AFS-tietovälineasemat. Jokaisella normaalin Unix-tiedostojärjestelmän hakemistolla on ainakin 2 kovaa linkkiä: sen nimi ja sen ’.’-linkki. Lisäksi sen alihakemistoilla (jos niitä on) on jokaisella ’..’-linkki ko. hakemistoon. Kun find tutkii hakemistoa, ja havaitsee alihakemistojen lukumäärän olevan 2 pienempi kuin hakemiston linkkien lukumäärä, se tietää, että loput linkeistä hakemistossa eivät ole hakemistoja (hakemistopuun ’lehti’-tiedostoja). Jos vain tiedostojen nimet (eikä niiden tilatietoja) tarvitsee tutkia, tämä merkitsee huomattavaa hakunopeuden lisäystä.

−version, −−version

Näytä find:n version numero ja poistu ohjelmasta.

TESTIT
Numeeriset argumentit voidaan määritellä seuraavasti:

−amin n

Tiedostoa luettiin viimeksi n minuuttia sitten.

−anewer tiedosto

Tiedostoa luettiin viimeksi myöhemmin kuin tiedostoa muutettiin. −anewer ottaa huomioon option −follow vain, jos −follow on ennen testiä −anewer komentorivillä.

−atime n

Tiedostoa luettiin viimeksi n*24 tuntia sitten.

−cmin n

Tiedoston tilaa muutettiin viimeksi n minuuttia sitten.

−cnewer tiedosto

Tiedoston tilaa muutettiin viimeksi myöhemmin kuin tiedosto muutettiin. −cnewer ottaa huomioon option −follow vain jos −follow on ennen testiä −cnewer komentorivillä.

−ctime n

Tiedoston tilaa muutettiin viimeksi n*24 tuntia sitten.

−fstype tyyppi

Tiedosto on tyypin tyyppi tiedostojärjestelmässä. Kelvolliset tiedostojärjestelmätyypit vaihtelevat eri Unix-versioissa. Voit käyttää optiota −printf %F−direktiivin kanssa nähdäksesi tiedostojärjestelmiesi tyypit.

−group ryhmätunnus

Tiedosto kuuluu ryhmään ryhmätunnus (numeerinen ryhmätunnus on sallittu).

−ilname kuvio

Kuten −lname, mutta vertailu ei erota isoja ja pieniä kirjaimia.

−iname kuvio

Kuten −name, mutta vertailu ei erota isoja ja pieniä kirjaimia. Esimerkiksi kuviot ’fo*’ ja ’F??’ vastaavat tiedostonimiä ’Foo’, ’FOO’, ’foo’, ’fOo’ jne.

−inum n

Tiedostolla on inode luku n.

−ipath kuvio

Kuten −path, mutta vertailu ei erota isoja ja pieniä kirjaimia.

−iregex kuvio

Kuten −regex, mutta vertailu ei erota isoja ja pieniä kirjaimia.

−links n

Tiedostolla on n linkkiä.

−lname kuvio

Tiedosto on symbolinen linkki, jonka sisältö vastaa komentotulkin kuviota (shell pattern) kuvio. Metamerkit (metacharacters) eivät käsittele merkkejä ’/’ tai ’.’ erityisellä tavalla.

−mmin n

Tiedoston tietosisältöä muutettiin viimeksi n minuuttia sitten.

−mtime n

Tiedoston tietosisältöä muutettiin viimeksi n*24 tuntia sitten.

−name kuvio

Tiedostonimen perusosa (polku, josta nimen alun hakemistot on poistettu) vastaa komentotulkin kuviota kuvio. Metamerkit (’*’, ’?’, ja ’[]’) eivät vastaa merkkiä ’.’ nimen perusosan alussa. Käytä optiota −prune hakemiston ja sen alaisten tiedostojen ohitukseen; katso esimerkkiä option −path kuvauksessa.

−newer tiedosto

Tiedostoa muutettiin myöhemmin kuin tiedosto muutettiin. −newer ottaa huomioon option −follow vain, jos −follow on ennen testiä −newer komentorivillä.

−nouser

Mikään käyttäjä ei vastaa tiedoston numeerista käyttäjätunnusta.

−nogroup

Mikään ryhmä ei vastaa tiedoston numeerista ryhmätunnusta.

−path kuvio

Tiedostonimi vastaa komentotulkin kuviota kuvio. Metamerkit eivät käsittele merkkejä ’/’ tai ’.’ erityisellä tavalla; siten esimerkiksi

find . −path ’./sr*sc’

tulostaa merkinnän hakemistosta ’./src/misc’ (jos se on olemassa). Jos haluat ohittaa kokonaisen hakemistopuun, käytä optiota −prune, jolloin ei tarvitse tarkistaa puun jokaista tiedostoa. Esimerkiksi hakemiston ’src/emacs’ ja kaikkien sen alaisten tiedostojen ja hakemistojen ohittamiseksi ja muiden löytyneiden tiedostojen ja hakemistojen nimien tulostamiseksi menettele seuraavasti:

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

−perm moodi

Tiedoston käyttöoikeusbitit ovat täsmälleen moodi (oktaali tai symbolinen). Symboliset moodit käyttävät moodia 0 lähtökohtana.

−perm −moodi

Kaikki käyttöoikeusbitit moodi asetetaan tiedostolle.

−perm +moodi

Mitkä tahansa käyttöoikeusbitit moodi asetetaan tiedostolle.

−regex kuvio

Tiedostonimi vastaa säännöllistä lauseketta kuvio. Kyseessä on koko polun vastaavuus, ei haku. Esimerkiksi tiedoston ’./fubar3’ vastineen löytämiseksi voit käyttää säännöllistä lauseketta ’.*bar.’ tai ’.*b.*3’, mutta et lauseketta ’b.*r3’.

−size n[bckw]

Tiedosto käyttää n yksikköä tilaa. Yksiköt ovat 512-tavuisia lohkoja joko oletusarvoisesti tai jos ’b’ seuraa arvoa n, tavuja jos ’c’ seuraa arvoa n, kilotavuja, jos ’k’ seuraa arvoa n, tai 2-tavuisia sanoja, jos ’w’ seuraa arvoa n. Koko ei ota huomioon epäsuoria lohkoja, mutta ottaa huomioon harvat tiedostot, joita ei tosiasiassa ole varattu.

−type c

Tiedosto on tyyppiä c:

Tiedoston numeerinen käyttäjätunnus on n.

−used n

Tiedostoa luettiin viimeksi n päivää sen jälkeen, kun sen tila muuttui.

−user uname

Tiedoston omistaa käyttäjätunnus (numeerinen käyttäjätunnus sallittu).

−xtype c

Sama kuin −type ellei tiedosto ole symbolinen linkki. Symbolisen linkin tapauksessa: tosi, jos −follow ei ole annettu ja tiedosto on linkki tyypin c tiedostoon; tosi, jos −follow on annettu ja c ’l’. Toisin sanoen, symbolisten linkkien tapauksessa −xtype tarkistaa tiedostotyypin, jota −type ei tarkista.

TOIMINNOT
−exec komento ;

Suorita komento komento; tosi jos paluuarvo on 0. Kaikki find:a seuraavat argumentit ovat komennon argumentteja kunnes kohdataan argumentti ’;’. Merkkijono ’{}’ korvataan nykyisellä tiedostonimellä, joka prosessoidaan kaikkialla, missä se esiintyy komennon argumenteissa, eikä pelkästään yksin esiintyesään, kuten on asianlaita eräissä muissa find:n versioissa. Molemmat näistä rakenteista saattavat tarvita suojausta (’\’) tai lainausmerkkejä komentotulkin tekemän laajennuksen estämiseksi. Komento suoritetaan alkuhakemistossa.

−fls tiedosto

Tosi; kuten −ls, mutta kirjoittaa tiedostoon tiedosto kuten −fprint.

−fprint tiedosto

Tosi; tulosta täydellinen tiedostonimi tiedostoon tiedosto. Jos tiedostoa tiedosto ei ole, kun find toteutetaan, se luodaan; jos se on olemassa, se typistetään. Tiedostonimet ’’/dev/stdout’’ ja ’’/dev/stderr’’ saavat erityiskäsittelyn; ne viittaavat vastaavasti vakiotulosteeseen ja vakiovirheeseen.

−fprint0 tiedosto

Tosi; kuten −print0, mutta kirjoittaa tiedostoon tiedosto, kuten −fprint.

−fprintf tiedosto mallinne

Tosi; kuten −print0, mutta kirjoittaa tiedostoon tiedosto, kuten −fprint.

−ok komento ;

Kuten −exec, mutta kysyy ennen suoritusta käyttäjältä lupaa (vakiosyötteestä); jos vastaus ei ala merkillä ’y’ tai ’Y’, älä toteuta komentoa ja palauta epätosi.

−print0

Tosi; tulosta täydellinen tiedostonimi ja nollamerkki (null) vakiotulosteeseen. Tämä sallii komennon find tulostusta käsittelevien ohjelmien tulkita oikein tiedostonimet, joihin sisältyy rivinvaihtoja.

−printf mallinne

Tosi; tulostaa mallinne vakiotulosteeseen ja tulkitsee ’\’-merkit (escapes) ja ’%’-ohjeet (directives). Kentänleveydet ja tarkkuudet määritellään kuten C-funktiossa ’printf’. Toisin kuin −print, −printf ei lisää rivinvaihtoa merkkijonon loppuun. ’\’-merkit ( escapes) ja direktiivit ovat:

Kenoviiva ’\’, jota seuraa jokin muu merkki käsitellään tavallisena merkkinä; molemmat tulostetaan.

@

Kellonaikakentät:

Päivämääräkentät:

Tiedoston koko 512 tavun lohkoina (ylöspäin pyöristettynä).

Merkki ’%’ minkä tahansa muun merkin seuraamana hylätään (tämä muu merkki tulostetaan).

Jos −depth on käytössä, epätosi; ei vaikutusta.

OPERAATTORIT
Lueteltuna alenevan suoritusjärjestyksen mukaan:
( expr )

Pakollinen suoritusjärjestys.

−not expr

Sama kuin ! expr.

expr1 expr2

Ja (oletus); Arvoa expr2 ei lasketa jos expr1 on epätosi.

expr1 −a expr2

Sama kuin expr1 expr2.

expr1 −and expr2

Sama kuin expr1 expr2.

expr1 −o expr2

Tai; Arvoa expr2 ei lasketa jos expr1 on tosi..

expr1 −or expr2

Sama kuin expr1 −o expr2.

expr1 , expr2

Lista; molemmat arvot expr1 ja expr2 lasketaan aina. Arvo expr1 hylätään; listan arvo on lausekkeen expr2 arvo.

ESIMERKKEJÄ

find $HOME −print

Listaa kaikki kotihakemistosi tiedostot ja alihakemistot.

find $HOME −name ’*.txt’ −print

Hae kaikki kotihakemistosi .txt−loppuiset tiedostot.

find $HOME \! −name ’[A-Z]*’ −print

Hae ne kotihakemistosi tiedostot, joiden nimi ei ala isolla kirjaimella.

find / −type d −name ’man*’ -print

Etsi järjestelmän käsikirjahakemistot.

gzip ’find \! −name ’*.gz’ −print’

Etsi ja tiivistä ne aktiivisen hakemiston tiedostot, jotka eivät pääty .gz

find . −size 0 -ok rm {} \;

Poista aktiivisen hakemiston tyhjät tiedostot (kysellen).

find . −mtime -14 −type f −print

Etsi kahden viime viikon aikana muutetut tavalliset tiedostot.

find / −user matti −print

Etsi käyttäjän matti kaikki tiedostot.

KATSO MYÖS

locate(1L) locatedb(5L) updatedb(1L) xargs(1L) Finding Files (on−line järjestelmässä Info tai tulosteena).