Provided by: manpages-nl_4.13-4_all 
NAAM
find - zoek bestanden in een hiërarchie van mappen
SAMENVATTING
find [-H] [-L] [-P] [-D debugopts] [-Olevel] [begin-punt..] [expressie]
BESCHRIJVING
Deze handleiding documenteert de GNU versie van find. GNU find door zoekt de mappen boom vanaf elk
opgegeven startpunt terwijl het de expressie van links naar rechts evalueert, volgens de voorrangsregels
(zie sectie OPERATORS), totdat de uitkomst bekend is (de linker kant is onwaar voor en operaties, waar
voor of, vanaf welk punt find naar de volgende bestandsnaam springt. Als geen startpunt werd opgegeven
dan wordt `.' aangenomen.
Als u find gebruikt in een omgeving waar veiligheid belangrijk is (bijvoorbeeld als u het gebruikt om te
zoeken naar mappen die schrijfbaar zijn door andere gebruikers), dan wordt u aangeraden het hoofdstuk
"Veiligheids Overwegingen" uit de findutils documentatie te lezen, dat Bestanden Zoeken heet en onderdeel
is van findutils. Dat document bevat ook meer details en discussie dan deze handleiding, daarom zult u
dat mogelijk een betere bruikbare bron van informatie vinden.
OPTIES
De -H, -L en -P opties bepalen de behandeling van symbolische koppelingen. Argumenten op de
commando-regel die deze volgen, worden geïnterpreteerd als namen van bestanden of mappen die onderzocht
moeten worden, tot en met het eerste argument dat begint met een `-', of het argument `(' of `!'. Dit
argument en de volgende argumenten worden gezien als een expressie die beschrijft wat er gezocht moet
worden. Als geen paden opgegeven werden, dan wordt de huidige map gebruikt. Is geen expressie werd
opgegeven, dan wordt de print expressie gebruikt (hoewel u in elk geval beter print0 zou moeten
gebruiken).
Deze handleiding spreekt over 'opties' in een lijst van expressies. Deze opties bepalen het gedrag van
find maar worden onmiddellijk na de laatste padnaam opgegeven. De vijf 'reële' opties -H, -L, -P, -D en
-O moeten opgegeven worden vóór de eerste padnaam, of in het geheel niet. Een dubbel streepje, --, zou
theoretisch kunnen worden gebruikt om resterende argumenten aan te duiden die geen opties zijn, maar dat
werkt niet echt vanwege de manier waarop find het einde van het volgende pad argument bepaald: het doet
dit door te lezen totdat een expressie volgt (die ook start met een '-'). Welnu, als een pad argument
zou beginnen met een '-' dan zou find het in plaats als een pad behandelen als een expressie argument. Om
u ervan te verzekeren dat alle startpunten als zodanig herkend worden, en speciaal om te voorkomen dan
jokertekens patronen worden geëxpandeerd door de aanroepende shell per ongeluk als een expressie argument
behandeld worden, is het in het algemeen veiliger om de jokertekens of dubieuze padnamen vooraf te laten
gaan door hetzij een './' hetzij een absolute padnaam te gebruiken die begint met een '/'.
-P Volg nooit symbolische koppelingen. Dit is standaard gedrag. Indien find informatie over
bestanden onderzoekt of toont, en het bestand zelf een symbolische koppeling is, dan wordt de
informatie van de eigenschappen van de symbolische koppeling zelf genomen.
-L Volg symbolische koppelingen. Indien find informatie over bestanden onderzoekt of toont, dan wordt
deze informatie uit de eigenschappen van het bestand waar de koppeling naar wijst getoond, niet
van de koppeling zelf (behalve als het een defecte symbolische koppeling is of find is niet in
staat het bestand waar de koppeling naar wijst te onderzoeken). Het gebruik van deze optie
impliceert -noleaf. Als u later de -P optie gebruikt, dan is -noleaf nog steeds geldig. Als -L
geldig is en find vindt een symbolische koppeling naar een onder-map tijdens het zoeken, dan wordt
de onder-map aangewezen door de symbolische koppeling doorzocht.
Indien de -L optie werd gebruikt, dan zal het -type predicaat altijd passen op het type bestand
waar een symbolische koppeling naar wijst in plaats van de koppeling zelf (behalve als de
symbolische koppeling defect is). Acties die ervoor kunnen zorgen dat symbolische koppelingen
defect raken terwijl find wordt uitgevoerd (b.v. delete kunnen aanleiding geven tot verwarrend
gedrag. -L gebruiken zorgt ervoor dat de -lname en -ilname predicaten altijd onwaar retourneren.
-H Volg symbolische koppelingen niet, behalve tijdens het verwerken van de argumenten op de commando
regel. Zodra find informatie over bestanden onderzoekt of afdrukt, zal deze ontnomen worden uit de
eigenschappen van de symbolische koppeling zelf. De enige uitzondering op de gedrag is als het
bestand opgegeven op de commando regel een symbolische koppeling is en de koppeling kan worden
bevestigd. In deze situatie wordt de informatie gebruikt waar de koppeling naar wijst (m.a.w. de
koppeling wordt gevolgd). De informatie over de koppeling zelf wordt gebruikt om op terug te
vallen indien het door de koppeling aangewezen bestand niet onderzocht kan worden. Als -H werd
gebruikt en een van de, op de commando regel opgegeven, paden is een symbolische koppeling naar
een map, dan zal de inhoud van deze map worden onderzocht (hoewel natuurlijk --maxdepth 0 dit zou
voorkomen).
Als meer dan een van -H, -L en -P werd opgegeven, dan vervangt de een alle andere; de laatste optie die
op de commando regel werd opgegeven wordt gezet. Omdat dat de standaard is, moet men ervan uitgaan dat de
-P optie gezet is, behalve als of -H of -L werd opgegeven.
GNU find 'stat' bestanden frequent tijdens het verwerken van de commando regel zelf, vóór dat enig zoeken
begonnen is. Deze opties beïnvloeden ook hoe de argumenten verwerkt worden. Zo zijn er een aantal testen
die bestanden opgegeven op de commando regel vergelijken met een bestand dat we onderzoeken. In elk geval
zal het bestand worden onderzocht en sommige van zijn eigenschappen worden bewaard. Als het genoemde
bestand een symbolische koppeling is, en de -P optie is gezet (of als noch -H noch -L werden gezet), dan
wordt de informatie gebruikt voor de vergelijking genomen van de eigenschappen van de symbolische
koppeling. Anders wordt deze genomen van de eigenschappen van het bestand waar de koppeling naar wijst.
Als find de koppeling niet kan volgen (omdat het b.v. onvoldoende rechten heeft of omdat hij naar een
niet bestaand bestand wijst) dan worden de eigenschappen van de koppeling zelf gebruikt.
Als of de -H of -L optie gezet is, dan wordt elke symbolische koppeling gegeven door het volgen van het
argument van -newer, en wordt de tijdstempel gehaald van het bestand waar de koppeling naar wijst.
Dezelfde consideratie is van toepassing op -newerXY, -anewer en -cnewer.
De -follow optie heeft een vergelijkbaar effect als -L, hoewel het in effect treed vanaf het punt waar
deze verschijnt (dit betekent, als -L niet werd gebruikt maar -follow wel, elke symbolische koppeling die
verschijnt ná -follow op de commando regel gevolgd en die er vóór niet).
-D debugopts
Toon diagnostische informatie; dit kan behulpzaam zijn om problemen te onderzoeken indien find
niet doet wat u wilt. De lijst van debug opties moet gescheiden worden met komma´s.
Compatibiliteit van de debug opties is neit gegarandeerd tussen uitgaven van findutils. Zie voor
de complete lijst van debug opties de uitvoer van find -D help. Geldige debug opties zijn
exec Toon diagnostische informatie over -exec, -execdir, -ok en -okdir
opt Toon diagnostische informatie over de optimalisatie van de expressie boom; zie de -O optie
rates Toon een samenvatting die aangeeft hoe vaak een predicaat slaagde of faalde.
search Navigeer uitgebreid de map boom.
stat Toon berichten als bestanden worden onderzocht met de stat en lstat systeem aanroepen. Het
find programma probeert deze aanroepen te minimaliseren.
tree Toon de expressie boom in originele en geoptimaliseerde vorm.
all Schakel alle andere debug opties in (behalve help).
help Let de debug opties uit.
-Olevel
Schakel verzoek optimalisatie in. Het find programma herschikt testen met als doel de uitvoer te
versnellen terwijl het effect gehandhaafd moet blijven; dat wil zeggen, predicaten met bij
effecten worden niet onderling geherschikt. De optimalisatie uitgevoerd op elk optimalisatie
niveau zijn als volgt.
0 Equivalent aan optimalisatie niveau 1.
1 Dit is het standaard optimalisatie niveau, het komt overeen met het traditionele gedrag.
Expressies worden van volgorde verandert zodat testen die alleen op de bestandsnamen zijn
gebaseerd (bij voorbeeld -name en -regex) als eerste worden uitgevoerd.
2 Elke -type of -xtype test worden uitgevoerd na elke test die alleen gebaseerd is op de
namen van de bestanden, maar voor elke test die informatie van de inode vereist. Op moderne
versies van Linux worden bestandstypen geretourneerd door readdir() en daarom evalueren
deze predicaten sneller dan predicaten die eerst het bestand moeten stat´en. Indien u het
-fstype FOO predicaat gebruikt en een bestandssysteem type FOO specificeert dat onbekend is
(dat is, aanwezig in '/etc/mtab') op het moment dat find start, dan is dat predicaat
equivalent aan -false.
3 Bij dit optimalisatie niveau wordt de op kosten-gebaseerde query optimalisatie
ingeschakeld. De volgorde van testen wordt zo aangepast dat goedkope (m.a.w. snelle) testen
als eerste worden uitgevoerd en duurdere worden indien nodig later uitgevoerd. Binnen elke
kosten band worden predicaten vroeger of later geëvalueerd gebaseerd op of ze succesvol
zullen zijn of niet. Dus -o predicaten die hoogstwaarschijnlijk zullen slagen worden later
geëvalueerd, en dus -a predicaten die hoogstwaarschijnlijk zullen falen worden eerder
geëvalueerd.
De op kosten-gebaseerde optimalisator heeft een vast idee hoe waarschijnlijk enige test zal
slagen. In sommige gevallen houdt de waarschijnlijkheid rekening met het gedrag van een specifieke
test (bijvoorbeeld zal -type f waarschijnlijker vaker slagen dan -type c). De kosten-gebaseerde
optimalisator wordt momenteel geëvalueerd. Als deze niet daadwerkelijk de prestaties van find
verbeterd zal hij weer worden verwijderd. Daarentegen zullen optimalisaties die bewezen hebben
betrouwbaar, robuuste en effectief te zijn aangezet worden voor lagere optimalisatie niveau´s
mettertijd. Hoewel het standaard gedrag (i.e. optimalisatie niveau 1) niet zal worden veranderd
in de 4.3.x series. De findutils test suite voert alle testen in find bij elk optimalisatie niveau
uit en verzekert dat de resultaten hetzelfde zijn.
EXPRESSIE
Het deel van de commando regel na de lijst van startpunten is de expressie. Het is een soort van query
specificatie die beschrijft hoe we bestande vergelijken en wat we doen met bestanden die overeen kwamen.
Een expressie is samengesteld uit een rij van dingen:
Testen Testen geven een waar of onwaar terug, normaliter op basis van een eigenschap van het bestand dat
we overwegen. De empty test bij voorbeeld alleen waar als het huidige bestand leeg is.
Acties Acties hebben neven effecten (zoals het tonen van iets op de standaard uitvoer) en retourneren
ofwel waar of niet-waar, gebaseerd of al dan niet succesvol zijn. De -print actie bijvoorbeeld
toont de naam van het huidige bestand op de standaard uitvoer.
Globale opties
Globale opties beinvloeden de werking van testen en acties zoals gespecificeerd in enig deel van
de commando regel. Globale opties retourneren altijd waar. De -depth optie zorgt er bijvoorbeeld
voor dat find het bestandssysteem in omgekeerde volgorde afloopt.
Positie opties
Positie opties beinvloeden alleen de daarop volgende testen of acties. Positie opties retourneren
altijd waar. De -regextype optie is bijvoorbeeld positioneel, die het reguliere expressie dialect
specificeert voor reguliere expressies die later op de commando regel voorkomen.
Operatoren
Operatoren koppelen de andere items in een expressie. Voorbeelden zijn -o (de logische OF) en -a
(de logische EN). Als een operator ontbreekt dan wordt -a aangenomen.
De -print actie wordt uitgevoerd op alle bestanden waarvoor de hele expressie waar is, behalve als deze
een actie bevat anders dan -prune of -quit. Acties die de standaard -print verbieden zijn -delete, -exec,
-execdir, -ok, -okdir, -fls, -fprint, -fprintf, -ls, -print en -printf.
De -delete actie gedraagt zich ook als een optie (omdat deze -depth impliceert.
POSITIONALE OPTIES
Positionale opties geven `waar' terug. Ze hebben altijd gevolgen en worden nietalleen verwerkt als hun
positie in de expressie bereikt wordt.
-daystart
Meet de tijden (voor -amin, -atime, -cmin, -ctime, -mmin, en -mtime) van het begin van vandaag in
plaats van 24 uur geleden. Dezeoptie beïnvloed alleen testen die later op de commando regel
verschenen.
-follow
Afgekeurd; gebruik de -L optie in plaats hiervan. Volg symbolische koppelingen. Impliceert
-noleaf. De -follow optie beïnvloed alleen die testen die verschijnen na deze op de commando
regel. Behalve als de -H of -L opties werden opzet, veranderd de positie van de -follow optie het
gedrag van het het -newer predicaat; alle bestanden opgegeven als argument van -newer worden
gevolgd als dat symbolische koppelingen zijn. Dezelfde overweging is van toepassing op -newerXY,
-anewer en -cnewer. Hiermee vergelijkbaar zal het -type predicaat altijd passen op het type van
het bestand waar de symbolische koppeling naar wijst in plaats van het bestand zelf. Het gebruik
van -follow zorgt er voor dat de -lname en -ilname predicaten altijd onwaar terug geven.
-regextype type
Verandert de reguliere expressie syntax zoals begrepen door de -regex en -iregex testen die later
op de commando regel verschijnen. Gebruik -regextype help om te zien welke typen reguliere
expressie begrepen worden. De Texinfo documentatie (Zie ZIE OOK) legt de betekenis van en de
verschillen tussen de diverse reguliere expressies uit.
-warn, -nowarn
Turn warning messages on or off. These warnings apply only to the command line usage, not to any
conditions that find might encounter when it searches directories. The default behaviour
corresponds to -warn if standard input is a tty, and to -nowarn otherwise. If a warning message
relating to command-line usage is produced, the exit status of find is not affected. If the
POSIXLY_CORRECT environment variable is set, and -warn is also used, it is not specified which, if
any, warnings will be active.
GLOBALE OPTIES
Globale opties retourneren altijd waar. Globale opties gelden zelfs voor testen die eerder op de commando
regel werden opgegeven. Om verwarring te voorkomen moeten globale opties na de lijst met startpunten maar
voor de eerste test, positionele optie of actie, opgegeven worden. Als u een globale optie op een andere
plek opgeeft zal find een waarschuwing geven, die uitlegt dat dat verwarrend kan zijn.
De globale opties komen voor na de lijst van startpunten, en zijn daarom niet van dezelfde soort opties
als bijvoorbeeld -L.
-d De synoniem van-depth, voor compatibiliteit met FreeBSD, NetBSD, MacOS X en OpenBSD.
-depth Verwerk de inhoud van elke map vóór de map zelf. De -delete actie impliceert ook -depth.
-help, --help
Toon een samenvatting van het gebruik van het commando find en stop.
-ignore_readdir_race
Normaliter zal find een fout melden wanneer het een bestand niet kan "stat"-en. Als u deze optie
gebruikt en een bestand werd gewist tussen het tijdstip date find de naam van het bestand van de
map las en de tijd dat het het bestand probeert te "stat"-en, dan wordt geen foutmelding gegeven.
Dit is ook van toepassing op bestanden of mappen wiens naam op de commando regel werden opgegeven.
De optie wordt gezet op het moment dat de commando regel wordt gelezen, hetgeen betekent dat u
niet een deel van het bestandssysteem kunt doorzoeken met deze optie aan een een ander deel met de
optie uit (als u dat nodig heeft dan zult u twee find commando´s moeten maken, een met de optie
aan en een zonder).
Bovendien van find met de -ignore_readdir_race optie fouten van de -delete. actie negeren in het
geval het bestand verdween vanaf het moment dat de ouder map werd gelezen: het zal geen fout
diagnostiek melden en de terugkeer code van de -delete actie zal waar zijn.
-maxdepth niveaus
Daal maximaal niveaus (een niet-negatief heel getal) van mappen af onder het start-punten. Gebruik
-maxdepth 0 om de testen en acties alleen op de start-punten toe te passen.
-mindepth niveaus
Pas geen testen of acties toe op niveaus lager dan niveaus (een niet negatief heel getal).
-mindepth 1 betekend verwerk alle bestanden behalve de start-punten.
-mount Daal niet af in mappen op andere bestandsystemen. Een alternatief voor -xdev, voor
overdraagbaarheid met andere versies van find.
-noignore_readdir_race
Schakel het effect van -ignore_readdir_race uit.
-noleaf
Maak uitvoering niet sneller door aan te nemen dat mappen 2 minder submappen bevatten dan hun
harde koppelingen aantal. Deze optie is nodig bij zoeken door bestandssystemen die de Unix
map-koppelingen gewoontes niet volgen zoals CD-ROM of MS-DOS bestandssystemen, of AFS volume mount
punten. Elke map op een normaal Unix bestandsysteem heeft tenminste 2 harde koppelingen: zijn naam
en zijn `.' ingang. Daar bovenop hebben zijn submappen (als aanwezig) elk een `..' ingang
verbonden naar die map. Wanneer find een map onderzoekt, nadat het 2 minder submappen rekent dan
het koppelingen aantal van de map, weet het dat de rest van de ingangen in de map niet-mappen zijn
(`blad' bestanden in de mappen boom). Als alleen debestandsnamen onderzocht dienen te worden is
het niet nodig ze te beoordelen; dit geeft een belangrijke toename van zoek snelheid.
-version, --version
Druk het find versie nummer af en eindig.
-xdev Daal niet af in mappen op andere bestandsystemen.
TESTS
Sommige testen, bijvoorbeeld -newerXY en -samefile, staan toe bestanden, die onderzochie bestand op de
commando regel, te vergelijken. Indien deze testen worden gebruikt, wordt de interpretatie van het
referentie bestand bepaald door de opties -H, -L and -P en enige voorafgaande -follow, maar wordt het
referentie bestand slechts eenmaal onderzocht, op het moment dat de commando regel wordt gelezen. Als het
referentie bestand niet kan worden onderzocht (bijvoorbeeld, als de stat(2) systeem aanroep faalt), dan
wordt een foutmelding getoond en zal find met een niet-nul status eindigen.
Een numeriek argument n kan worden meegegeven aan testen (zoals -amin, -mtime, -gid, -inum, -links,
-size, -uid en -used) als
+n voor groter dan n,
-n voor minder dan n,
n voor precies n.
Ondersteunde testen:
-amin n
Het bestand werd minder dan, meer dan of exact n minuten geleden benaderd.
-anewer bestand
De tijd van de laatste toegang van het huidige bestand is recenter dan die van de laatste datum
wijziging van het referentie bestand. Als referentie een een symbolische koppeling is en de -H
optie of de -L optie werd gebruikt, dan wordt altijd de laatste wijzigingstijd van het bestand
waarnaar gewezen gebruikt.
-atime n
Het bestand werd minder dan, meer dan of exact n*24 uur geleden benaderd. Als find erachter komt
hoeveel 24-uur perioden geleden een bestand voor het laatst benaderd werd, dan wordt elke fractie
genegeerd om zo met -atime +1 over een te komen, een bestand moet op zijn minst two dagen geleden
zijn benaderd.
-cmin n
De status van het bestand werd minder dan, meer dan of exact n minuten geleden gewijzigd.
-cnewer bestand
Tijd van de laatste status verandering van het huidige bestand is recenter dan dat van de laatste
datum wijziging van het referentie bestand. Als referentie een symbolische koppeling is en de -H
optie of de -L optie werden gebruikt, dan wordt altijd de tijd van de laatste datum wijziging van
het bestand waar het naar wijst gebruikt.
-ctime n
Bestand-status werd voor het laatst minder dan, meer dan of exact n*24 uur geleden veranderd. Zie
het commentaar voor -atime om te begrijpen hoe het afronden de interpretatie van de bestandsstatus
veranderings tijden beïnvloed.
-empty Bestand is leeg en is of een normaal bestand, of een map.
-executable
Matches files which are executable and directories which are searchable (in a file name resolution
sense) by the current user. This takes into account access control lists and other permissions
artefacts which the -perm test ignores. This test makes use of the access(2) system call, and so
can be fooled by NFS servers which do UID mapping (or root-squashing), since many systems
implement access(2) in the client's kernel and so cannot make use of the UID mapping information
held on the server. Because this test is based only on the result of the access(2) system call,
there is no guarantee that a file for which this test succeeds can actually be executed.
-false Altijd onwaar.
-fstype soort
Bestand staat op een bestandssysteem van type soort. De geldige bestandssysteem typen verschillen
tussen verschillende versies van Unix; een onvolledige lijst van bestandssysteem soorten die
geaccepteerd worden op een of andere versie van Unix is: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K.
U kunt -printf met de %F richtlijn gebruiken om de typen van uw bestandssystemen te zien.
-gid n Het numerieke groep ID van bestand is kleiner dan, groter dan of exact n.
-group gnaam
Bestand hoort bij groep gnaam (numeriek groep ID toegestaan).
-ilname patroon
Net als -lname, maar de overeenkomst is ongevoelig voor het verschil tussen hoofd- en kleine-
letters. Als de -L optie of de -follow optie werden gebruikt dan geeft deze test een onwaar terug
behalve als de symbolische koppeling defect was.
-iname patroon
Net als -name, maar de overeenkomst is ongevoelig voor het verschil tussen hoofd- en kleine-
letters. Bijvoorbeeld, de patronen `fl*' en `F???' komen overeen met de namen `Flip', `FLIP',
`flip', `fLIp', enz.
-inum n
Bestand heeft inode nummer kleiner dan, groter dan of exact n. Het is normaliter eenvoudiger om in
plaats daarvan de -samefile test te gebruiken.
-ipath patroon
Net als -path, maar de overeenkomst is ongevoelig voor het verschil tussen hoofd- en kleine-
letters.
-iregex patroon
Net als -regex, maar de overeenkomst is ongevoelig voor het verschil tussenhoofd- en kleine-
letters.
-iwholename patroon
Zie -ipath. Dit alternatief is minder overdraagbaar dan -ipath.
-links n
Bestand heeft minder dan, meer dan of exact n harde koppelingen.
-lname patroon
Bestand is een symbolische koppeling wiens inhoud overeenkomt met shell patroon patroon. De
meta-tekens behandelen `/' en `.' niet speciaal. Als de -L optie of de -follow optie werden
gebruikt dan geeft deze test een onwaar terug behalve als de symbolische koppeling defect was.
-mmin n
Bestandsgegevens werden het laatst minder dan, meer dan of exact n minuten geleden aangepast.
-mtime n
Bestandgegevens werden het laatst minder dan, meer dan of exact n*24 uur geleden aangepast. Zie
het commentaar voor -atime om te begrijpen hoe het afronden de interpretatie van de bestandsstatus
veranderings tijden beïnvloed.
-name patroon
Basis van de bestandnaam (het pad met het voorvoegsel van mappen verwijderd) komt overeen met
shell patroon patroon. Omdat het voorvoegsel van mappen verwijderd is, zullen de bestandsnamen die
bekeken worden voor de overeenkomst met -name nooit een schuine streep bevatten, daarom zal '-name
a/b' nooit overeenkomen met iets (u dient mogelijk -path in plaats hiervan te gebruiken). Er zal
een waarschuwing gegeven worden als u dit probeert te doen, behalve als de omgevingsvariabele
POSIXLY_CORRECT werd gezet. De megakarakters (`*', `?', and `[]') passen op een `.' aan het begin
van de basis (dit is een verandering in findutils-4.2.2; zie sectie STANDARDS CONFORMANCE
hieronder). Om een map en de bestanden daaronder te negeren, gebruik dan -prune in plaats van het
controleren van elk bestand in de boom; zie een voorbeeld in de beschrijven van die actie. Haakjes
worden niet herkend als zijnde speciaal, ondanks het feit dat sommige shells inclusief Bash
haakjes gebruiken met een speciale betekenis in shell patronen. Het herkennen van de bestandsnaam
wordt gedaan door het gebruik van de fnmatch(3) bibliotheek functie. Vergeet niet het patroon met
aanhalingstekens te omgeven, om te voorkomen dat de shell het expandeert.
-newer bestand
De tijd van de laatste data modificatie van het huidige bestand is recenter dan die van de laatste
date modificatie van het reference bestand. Als reference een symbolische koppeling is en de -H
optie of de -L optie werd gezet, dan wordt de tijd van de laatste data modificatie van het bestand
waar deze naar wijst altijd gebruikt.
-newerXY reference
Succeeds if timestamp X of the file being considered is newer than timestamp Y of the file
reference. The letters X and Y can be any of the following letters:
a De toegangstijd van het bestand referentie
B De aanmaak tijd van het bestand referentie
c De veranderingstijd van de inode van referentie
m De wijzigingstijd van het bestand referentie
t referentie werd direct als een tijd geïnterpreteerd.
Some combinations are invalid; for example, it is invalid for X to be t. Some combinations are
not implemented on all systems; for example B is not supported on all systems. If an invalid or
unsupported combination of XY is specified, a fatal error results. Time specifications are
interpreted as for the argument to the -d option of GNU date. If you try to use the birth time of
a reference file, and the birth time cannot be determined, a fatal error message results. If you
specify a test which refers to the birth time of files being examined, this test will fail for any
files where the birth time is unknown.
-nogroup
Geen enkele groep hoort bij het numerieke groep ID van bestand.
-nouser
Geen enkele gebruiker hoort bij het bestand numerieke ID.
-path patroon
Bestandsnaam komt overeen met shell patroon patroon. De meta-tekensbehandelen `/' en `.' niet
speciaal; dus, bijvoorbeeld,
find . -path "./sr*sc"
zal een ingang voor een map genaamd './src/misc' (als die bestaat) tonen. Gebruik -prune mm een
hele mappen boom te negeren, in plaats van elk bestand in de boom te testen. Merk op dat de test
op de overeenkomst van het patroon van toepassing is op de hele bestandsnaam, beginnend bij een
van de begin punten genoemd op de commando regel. Het is hier alleen zinvol om een absoluut
padnaam te gebruiken als het relevante begin punt ook een absoluut pad is. Dit betekent dat dit
commando nooit op iets zal passen:
find bar -path /foo/bar/myfile -print
Find compares the -path argument with the concatenation of a directory name and the base name of
the file it's examining. Since the concatenation will never end with a slash, -path arguments
ending in a slash will match nothing (except perhaps a start point specified on the command line).
The predicate -path is also supported by HP-UX find and is part of the POSIX 2008 standard.
-perm modus
Bestandspermissie-bits zijn precies mode (octaal of symbolisch). Omdat een exacte overeenkomst is
vereist, als u deze vorm wilt gebruiken voor symbolische modi, dan dient u een behoorlijk complexe
mode tekenreeks op te geven. Bijvoorbeeld '-perm g=w' zal alleen passen op bestanden met een mode
0020 (dat is, die waarvoor de groep schrijf rechten het enige recht is dat gezet werd). Het is
meer waarschijnlijk dat u de `/' of `-' vormen wilt gebruiken, bijvoorbeeld `-perm -g=w', die
elk bestand met de groep schrijf rechten vind. Zie de VOORBEELDEN sectie voor enkele illustratieve
voorbeelden.
-perm -modus
Alle rechten bits mode zijn gezet voor het bestand. Symbolische modi worden geaccepteerd in deze
vorm, en dit is de gebruikelijke manier op welke u deze zou willen gebruiken. U dient `u', `g' of
`o' op te geven indien u een symbolische mode wilt gebruiken. Zie de VOORBEELDEN sectie voor
enkele illustratieve voorbeelden.
-perm /modus
Enige rechten bits mode zijn gezet voor het bestand. Symbolische modi worden geaccepteerd in deze
vorm. U dient `u', `g' of `o' op te geven indien u een symbolische mode gebruikt. Zie de
VOORBEELDEN sectie voor enkele illustratieve voorbeelden. Als er geen rechten bits in mode werden
gezet, dan past deze test op elk bestand (het idee is hier om consistent met het gedrag van
-perm -000).
-perm +modus
Dit wordt niet langer ondersteund (en is verouderd vanaf 2005). Gebruik -perm /mode in de plaats
hiervan.
-readable
Matches files which are readable by the current user. This takes into account access control
lists and other permissions artefacts which the -perm test ignores. This test makes use of the
access(2) system call, and so can be fooled by NFS servers which do UID mapping (or
root-squashing), since many systems implement access(2) in the client's kernel and so cannot make
use of the UID mapping information held on the server.
-regex patroon
Bestandsnaam komt overeen met reguliere expressie patroon. Dit is een overeenkomst met het hele
pad, er wordt niet in gezocht. Bijvoorbeeld, om met een bestand genaamd `./flopje3' overeen te
komen, kunt u de reguliere expressie `.*opje.' of `.*o.*3', maar niet `o.*e3' gebruiken. De
reguliere expressies die door find begrepen worden zijn standaard Emacs Reguliere Expressie
(behalve dat ´. ' past op een nieuwe regel), echter kan dit worden veranderd met de -regextype
optie.
-samefile naam
File refers to the same inode as name. When -L is in effect, this can include symbolic links.
-size n[cwbkMG]
Bestand gebruikt afgerond minder dan, meer dan of exact n eenheden ruimte. De volgende
achtervoegsels kunnen gebruikt worden:
`b' voor 512-byte blokken (dit is standaard als geen achtervoegsel gebruikt werd).
`c' voor bytes
`w' voor twee-byte woorden
`k' voor kibibytes (KiB, eenheden van 1024 bytes)
`M' voor mebibytes (MiB, eenheden van 1024 * 1024 = 1048576 bytes)
`G' voor gibibytes (GiB, eenheden van 1024 * 1024 * 1024 = 1073741824 bytes)
De grootte is eenvoudig het st_size element van de struct stat gezet door de lstat (of stat)
systeem aanroep, afgerond zoals hierboven aangegeven. Met andere woorden, het is consistent met de
resultaten die u verkrijgt met ls -l. Onthoud dat de `%k' en `%b' formaat specificaties van
-printf ijle bestanden anders behandelen. Het 'b' achtervoegsel duid altijd 512-byte blokken aan
en nooit 1024-byte blokken, dit is anders dan het gedrag van -ls.
The + and - prefixes signify greater than and less than, as usual; i.e., an exact size of n units
does not match. Bear in mind that the size is rounded up to the next unit. Therefore -size -1M
is not equivalent to -size -1048576c. The former only matches empty files, the latter matches
files from 0 to 1,048,575 bytes.
-true Altijd waar.
-type c
Bestand is van soort c:
b blok (gebufferd) speciaal
c karakter (ongebufferd) speciaal
d directory
p benoemde pijp (FIFO)
f normaal bestand
l symbolische koppeling; dit is nooit waar als de -L optie of de -follow optie gezet zijn,
behalve als de symbolische koppeling defect is. Indien u wenst te zoeken naar symbolische
koppelingen terwijl -L gezet is, gebruik dan -xtype.
s socket
D deur (Solaris)
To search for more than one type at once, you can supply the combined list of type letters
separated by a comma `,' (GNU extension).
-uid n Het numerieke gebruiker ID van het bestand is kleiner dan, groter dan of exact n.
-used n
Het bestand werd voor het laatste benadert minder dan, meer dan of exact n dagen nadat zijn status
voor het laatst werd veranderd.
-user gnaam
Bestand is eigendom van gebruiker gnaam (numeriek gebruiker ID toegestaan).
-wholename patroon
See -path. This alternative is less portable than -path.
-writable
Matches files which are writable by the current user. This takes into account access control
lists and other permissions artefacts which the -perm test ignores. This test makes use of the
access(2) system call, and so can be fooled by NFS servers which do UID mapping (or
root-squashing), since many systems implement access(2) in the client's kernel and so cannot make
use of the UID mapping information held on the server.
-xtype c
Hetzelfde als -type tenzij het bestand een symbolische koppeling is. Voor symbolische koppelingen:
als de -H of -P optie niet gegeven werd, `waar' als het bestand een koppeling is naar een bestand
van soort c; als de -L optie werd gegeven, `waar' als c gelijk is aan `l'. Met andere woorden,
voor symbolische koppelingen test -xtype het type bestand dat -type niet test.
-context patroon
(alleen SELinux) De veiligheid context van het bestand past op glob patroon.
ACTIES
-delete
Verwijder bestanden; waar als verwijderen lukte. Als het verwijderen mislukte, dan wordt een fout
melding gegeven. Als -delete faalt, dan zal de beëindigingsstatus van find niet-nul zijn (zodra
het uiteindelijk eindigt). Het gebruik van -delete zet automatisch de `-depth' optie aan.
Warnings: Don't forget that the find command line is evaluated as an expression, so putting
-delete first will make find try to delete everything below the starting points you specified.
When testing a find command line that you later intend to use with -delete, you should explicitly
specify -depth in order to avoid later surprises. Because -delete implies -depth, you cannot
usefully use -prune and -delete together.
Together with the -ignore_readdir_race option, find will ignore errors of the -delete action in
the case the file has disappeared since the parent directory was read: it will not output an error
diagnostic, and the return code of the -delete action will be true.
-exec opdracht ;
Voer opdracht uit; `waar' als 0 status teruggegeven is. Alle volgende argumenten voor find worden
als argumenten voor de opdracht genomen totdat een argument bestaande uit `;' wordt tegengekomen.
De string `{}' wordt vervangen door de huidige bestandsnaam die wordt verwerkt, overal waar het
opduikt in de argumenten voor de opdracht, niet alleen in argumenten waar het alleen is, zoals in
sommige versies van find. Allebei deze constructies moeten misschien ge-escape't (met een `\') of
geciteerd worden om ze te beschermen tegen interpretatie door de shell. De opdracht wordt
uitgevoerd in de start map.
-exec opdracht {} +
This variant of the -exec action runs the specified command on the selected files, but the command
line is built by appending each selected file name at the end; the total number of invocations of
the command will be much less than the number of matched files. The command line is built in much
the same way that xargs builds its command lines. Only one instance of `{}' is allowed within the
command, and it must appear at the end, immediately before the `+'; it needs to be escaped (with a
`\') or quoted to protect it from interpretation by the shell. The command is executed in the
starting directory. If any invocation with the `+' form returns a non-zero value as exit status,
then find returns a non-zero exit status. If find encounters an error, this can sometimes cause
an immediate exit, so some pending commands may not be run at all. For this reason
-exec my-command ... {} + -quit may not result in my-command actually being run. This variant of
-exec always returns true.
-execdir opdracht ;
-execdir opdracht {} +
Like -exec, but the specified command is run from the subdirectory containing the matched file,
which is not normally the directory in which you started find. As with -exec, the {} should be
quoted if find is being invoked from a shell. This a much more secure method for invoking
commands, as it avoids race conditions during resolution of the paths to the matched files. As
with the -exec action, the `+' form of -execdir will build a command line to process more than one
matched file, but any given invocation of command will only list files that exist in the same
subdirectory. If you use this option, you must ensure that your $PATH environment variable does
not reference `.'; otherwise, an attacker can run any commands they like by leaving an
appropriately-named file in a directory in which you will run -execdir. The same applies to
having entries in $PATH which are empty or which are not absolute directory names. If any
invocation with the `+' form returns a non-zero value as exit status, then find returns a non-zero
exit status. If find encounters an error, this can sometimes cause an immediate exit, so some
pending commands may not be run at all. The result of the action depends on whether the + or the
; variant is being used; -execdir command {} + always returns true, while -execdir command {} ;
returns true only if command returns 0.
-fls bestand
Waar; net als -ls maar schrijf naar bestand zoals -fprint. Het uitvoer bestand wordt altijd
gemaakt, zelfs als het predicaat nooit past. Zie de ONGEBRUIKELIJKE BESTANDSNAMEN sectie voor
informatie over hoe ongebruikelijke tekens in bestandsnamen worden afgehandeld.
-fprint bestand
Waar; schrijf de volle bestandsnaam naar bestand bestand. Als bestand niet bestaat als find
draait, wordt het gemaakt; als het bestaat, wordt het afgehakt. De bestandsnamen “/dev/stdout” en
“/dev/stderr” worden speciaal behandeld; zij verwijzen naar de standaard uitvoer en standaard fout
uitvoer, respectievelijk. Zie de ONGEBRUIKELIJKE BESTANDSNAMEN sectie voor informatie over hoe
ongebruikelijke tekens in bestandsnamen worden afgehandeld.
-fprint0 bestand
Waar; zoals -print0 maar schrijf naar bestand zoals -fprint. Zie de ONGEBRUIKELIJKE BESTANDSNAMEN
sectie voor informatie over hoe ongebruikelijke tekens in bestandsnamen worden afgehandeld.
-fprintf bestand vorm
Waar; zoals -printf maar schrijf naar bestand zoals -fprint. Zie de ONGEBRUIKELIJKE BESTANDSNAMEN
sectie voor informatie over hoe ongebruikelijke tekens in bestandsnamen worden afgehandeld.
-ls 'Waar'; toon het huidige bestand in ls -dils vorm op standaard uitvoer. Het aantal blokken is in
blokken van 1 KB, tenzij de omgevingsvariabele POSIXLY_CORRECT gezet is, in welk geval 512-byte
blokken worden gebruikt. Zie de UNUSUAL FILENAMES sectie voor informatie over hoe niet
gebruikelijke tekens in bestandsnamen worden afgehandeld.
-ok opdracht ;
Zoals -exec maar vraag de gebruiker eerst. Voer het commando uit als de gebruiker akkoord is.
Retourneer anders 'onwaar'. Als het commando wordt uitgevoerd, wordt zijn standaard invoer
omgeleid van /dev/null.
The response to the prompt is matched against a pair of regular expressions to determine if it is
an affirmative or negative response. This regular expression is obtained from the system if the
`POSIXLY_CORRECT' environment variable is set, or otherwise from find's message translations. If
the system has no suitable definition, find's own definition will be used. In either case, the
interpretation of the regular expression itself will be affected by the environment variables
'LC_CTYPE' (character classes) and 'LC_COLLATE' (character ranges and equivalence classes).
-okdir opdracht ;
Zoals -exec maar vraag de gebruiker eerst op dezelfde manier als voor -ok. Retourneer 'onwaar' als
de gebruiker niet akkoord is . Als het commando wordt uitgevoerd, wordt zijn standaard invoer
omgeleid van /dev/null.
-print Waar; druk de volle bestandsnaam af op de standaard uitvoer, gevolgd door een nieuwe regel. Zie de
ONGEBRUIKELIJKE BESTANDSNAMEN sectie voor informatie over hoe ongebruikelijke tekens in
bestandsnamen worden afgehandeld.
-print0
Waar; druk de volle bestandsnaam af op de standaard uitvoer, gevolgd door een nul karakter. Dit
laat bestandsnamen die nieuwe regels bevatten toe om goed geïnterpreteerd te kunnen worden door
programma's die de find uitvoer verwerken.
-printf vorm
'Waar'; druk vorm af op de standaard uitvoer, interpreteer `\' stuurcodes en `%' richtlijnen. Veld
breedten en precisie kunnen opgegeven worden zoals bij de printf(3) C functie. Merk op dat veel
velden worden getoond als %s inplaats van %d, en dit kan beteken dat vlaggen niet werken zoals u
zou verwachten. Dit betekent ok dat de '-' vlag niet werkt (dit dwingt velden links uitgelijnd te
zijn). Niet zoals -print, voegt -printf geen nieuwe regel toe aan het einde van het string. De
stuurcodes en richtlijnen zijn:
\a Alarm bel.
\b Backspace.
\c Stop afdrukken van deze vorm onmiddellijk en spoel de uitvoer door.
\f Nieuwe bladzijde.
\n Nieuwe regel.
\r Wagen terugloop.
\t Horizontale tabulatie.
\v Verticale tab.
\0 ASCII NUL.
\\ Een letterlijke backslash (`\').
\NNN Het teken wiens ASCII code NNN (octaal) is.
Een `\' karakter gevolgd door een ander karakter wordt behandeld als een normaal karakter, zodat
ze allebei afgedrukt worden.
%% Een letterlijk procent teken.
%a Laatste toegangstijd van het bestand in formaat zoals teruggegeven door de C ctime(3)
functie.
%Ak Laatste toegangstijd van het bestand in de vorm gegeven door k, die of `@' is of een
richtlijn voor de C strftime(3) functie. De mogelijke waardes voor k worden onder gegeven;
sommige ervan zijn misschien niet beschikbaar op alle systemen, ten gevolge van verschillen
in `strftime' tussen systemen.
@ seconden sinds 1 januari 1970, 00:00 GMT, met een fractie.
Tijd velden:
H uur (00...23)
I het uur (01..12)
k uur ( 0..23)
l uur ( 1..12)
M minuut (00...59)
p locale AM of PM
r tijd, 12-uur (hh:mm:ss [AP]M)
S Seconden (00.00 .. 61.00). Er is een fractie.
T tijd, 24-uur (hh:mm:ss.xxxxxxxxxx)
+ Datum en tijd, gescheiden door een '+', bijvoorbeeld `2004-04-28+22:22:05.0'. Dit is
een GNU uitbreiding. De tijd is gegeven in de huidige tijd zone (die beïnvloed kan
zijn door het zetten van de TZ omgevingsvariabele). Het seconden veld bevat een
fractie.
X locale tijd voorstelling (H:M:S). Het seconden veld bevat een fractie.
Z tijd zone (o.a. CET), of niets als de tijd zone niet vast te stellen is
Datum velden:
a locale afgekorte weekdag naam (Zon..Zat)
A locale volle weekdag naam, variabele lengte (Zondag..Zaterdag)
b locale afgekorte maand naam (jan..dec)
B locale volle maand naam, variabele lengte (januari..december)
c locale datum en tijd (Zat Nov 04 12:02:33 CET 1989). Het formaat is hetzelfde als
voor ctime(3) en om compatibiliteit te waarborgen met dat formaat, is er geen
fractie in het seconden veld.
d dag van de maand (01..31)
D datum (mm/dd/jj)
F datum (jjjj-mm-dd)
h hetzelfde als b
j de dag in het jaar (001...366)
m de maand (01...12)
U week nummer van jaar met zondag als eerste dag van de week (00..53)
w dag van de week (0..6)
W week nummer van jaar met maandag als eerste dag van de week (00..53)
x locale datum voorstelling (mm/dd/jj)
y de laatste twee cijfers van het jaar (00...99)
Y jaar (1970...)
%b De hoeveelheid schijfruimte gebruikt voor dit bestand in 512-byte blokken. Omdat
schijfruimte wordt toegewezen in veelvouden van de grootte van bestandssysteem blokken is
deze normaliter groter dan %s/512, maar het kan ook kleiner zijn als het een ijl bestand
is.
%c Laatste toegangstijd van het bestand in formaat zoals teruggegeven door de C ctime(3)
functie.
%Ck Bestand laatste status veranderingstijd in de vorm opgegeven door k, wat hetzelfde is als
voor %A.
%d Diepte van het bestand in de mappen boom; 0 betekend dat het bestand een begin punt is.
%D The device number on which the file exists (the st_dev field of struct stat), in decimal.
%f Toon de basisnaam; de bestandsnaam met enige voorafgaand mappen verwijderd (alleen het
laatste element). Voor /, is het resultaat `/'. Zie de VOORBEELDEN sectie voor een
voorbeeld..
%F Soort bestandsysteem waar het bestand op staat; deze waarde kan gebruikt worden voor
-fstype.
%g Groep naam van bestand, of numerieke groep ID als de groep geen naam heeft.
%G Numerieke groep ID van bestand.
%h Mapnaam; Voorafgaande mappen van bestandsnaam (alle behalve het laatste deel).
%H Opdrachtregel-argument waaronder het bestand gevonden werd.
%i inode nummer van het bestand (decimaal).
%k De grootte van schrijfruimte gebruikt voor dit bestand in 1 KB blokken. Omdat schrijfruimte
toegewezen wordt in meervouden van de de bestandssysteem blok grootte is deze meestal
groter dan %s/1024, maar ze kan ook kleiner zijn als het bestand een ijl bestand is.
%l Voorwerp van symbolische koppeling (lege string als bestand geen symbolische koppeling is).
%m Rechten bits van het bestand (octaal).
%M Rechten van het bestand (in symbolische vorm, zoals voor ls). Dit directief wordt
ondersteund vanaf findutils 4.2.5.
%n Aantal harde koppelingen voor bestand.
%p Naam van bestand.
%P Naam van bestand met de naam van het startpunt waaronder het gevonden werd verwijderd.
%s Grootte van bestand in bytes.
%S IJlheid van het bestand.
%t Laatste aanpassings tijd van bestand in de vorm teruggegeven door de C ctime(3) functie.
%Tk Laatste aanpassings tijd van bestand in de vorm opgegeven door k, wat hetzelfde is als voor
%A.
%u Gebruiker naam van bestand, of numerieke gebruiker ID als de gebruiker geen naam heeft.
%U Numerieke gebruiker ID van bestand.
%y Bestandstype (zoals in ls -l), U=onbekend type (zou niet moeten voorkomen)
%Y File's type (like %y), plus follow symbolic links: `L'=loop, `N'=nonexistent, `?' for any
other error when determining the type of the target of a symbolic link.
%Z (alleen SELinux) veiligheids context van het bestand.
%{ %[ %(
Reserved for future use.
A `%' character followed by any other character is discarded, but the other character is printed
(don't rely on this, as further format characters may be introduced). A `%' at the end of the
format argument causes undefined behaviour since there is no following character. In some
locales, it may hide your door keys, while in others it may remove the final page from the novel
you are reading.
The %m and %d directives support the #, 0 and + flags, but the other directives do not, even if
they print numbers. Numeric directives that do not support these flags include G, U, b, D, k and
n. The `-' format flag is supported and changes the alignment of a field from right-justified
(which is the default) to left-justified.
Zie de ONGEBRUIKELIJKE BESTANDSNAMEN sectie voor informatie over hoe ongebruikelijke tekens in
bestandsnamen worden afgehandeld.
-prune 'Waar'; als het bestand een map is, daal er dan niet in af. Als -depth werd opgegeven, dan heeft
-prune geen effect. Omdat -delete -depth impliceert, is het gebruik van -prune en -delete samen,
niet nuttig. Om bijvoorbeeld de map src/emacs en alle bestanden en mappen daaronder over te
slaan , en de namen van de gevonden bestanden te tonen, gebruikt u bij voorbeeld:
find . -path ./src/emacs -prune -o -print
-quit Exit immediately (with return value zero if no errors have occurred). This is different to -prune
because -prune only applies to the contents of pruned directories, while -quit simply makes find
stop immediately. No child processes will be left running. Any command lines which have been
built by -exec ... + or -execdir ... + are invoked before the program is exited. After -quit is
executed, no more files specified on the command line will be processed. For example,
`find /tmp/foo /tmp/bar -print -quit` will print only `/tmp/foo`.
One common use of -quit is to stop searching the file system once we have found what we want. For
example, if we want to find just a single file we can do this:
find / -name needle -print -quit
OPERATOREN
Gegeven in volgorde van aflopende voorrang:
( expr )
Dwing volgorde af. Omdat haakjes speciaal zijn voor de shell, moeten ze normaliter tussen
aanhalingstekens staan. Veel van de voorbeelden in deze handleiding gebruiken backslashes voor dit
doel: `\(...\)' in plaats van `(...)'.
! expr Waar als expr ongeldig is. Dit teken dient ook beschermd te worden voor interpretatie door de
shell.
-not expr
Hetzelfde als ! expr, maar voldoet niet aan POSIX.
expr1 expr2
Twee expressies in een rij worden samengevoegd met een impliciete -a; expr2 wordt niet beoordeeld
als expr1 `fout' is.
expr1 -a expr2
Zelfde als expr1 expr2.
expr1 -and expr2
Hetzelfde als expr1 expr2, maar voldoet niet aan POSIX.
expr1 -o expr2
Of; expr2 wordt niet beoordeeld als expr1 `waar' is.
expr1 -or expr2
Zelfde als expr1 -o expr2.
expr1 , expr2
Lijst; beide expr1 en expr2 worden altijd beoordeeld. De waarde van expr1 wordt genegeerd; de
waarde van de lijst is de waarde van expr2. De komma operator kan nuttig zijn voor het zoeken naar
diverse verschillende type dingen terwijl het bestandssysteem maar een keer doorlopen wordt. De
-fprintf actie kan worden gebruikt om de diverse gevonden items in verschillende uitvoer bestanden
te noemen.
Please note that -a when specified implicitly (for example by two tests appearing without an explicit
operator between them) or explicitly has higher precedence than -o. This means that find . -name afile
-o -name bfile -print will never print afile.
ONGEBRUIKELIJKE BESTANDSNAMEN
Many of the actions of find result in the printing of data which is under the control of other users.
This includes file names, sizes, modification times and so forth. File names are a potential problem
since they can contain any character except `\0' and `/'. Unusual characters in file names can do
unexpected and often undesirable things to your terminal (for example, changing the settings of your
function keys on some terminals). Unusual characters are handled differently by various actions, as
described below.
-print0, -fprint0
Always print the exact filename, unchanged, even if the output is going to a terminal.
-ls, -fls
Unusual characters are always escaped. White space, backslash, and double quote characters are
printed using C-style escaping (for example `\f', `\"'). Other unusual characters are printed
using an octal escape. Other printable characters (for -ls and -fls these are the characters
between octal 041 and 0176) are printed as-is.
-printf, -fprintf
If the output is not going to a terminal, it is printed as-is. Otherwise, the result depends on
which directive is in use. The directives %D, %F, %g, %G, %H, %Y, and %y expand to values which
are not under control of files' owners, and so are printed as-is. The directives %a, %b, %c, %d,
%i, %k, %m, %M, %n, %s, %t, %u and %U have values which are under the control of files' owners but
which cannot be used to send arbitrary data to the terminal, and so these are printed as-is. The
directives %f, %h, %l, %p and %P are quoted. This quoting is performed in the same way as for GNU
ls. This is not the same quoting mechanism as the one used for -ls and -fls. If you are able to
decide what format to use for the output of find then it is normally better to use `\0' as a
terminator than to use newline, as file names can contain white space and newline characters. The
setting of the `LC_CTYPE' environment variable is used to determine which characters need to be
quoted.
-print, -fprint
Quoting is handled in the same way as for -printf and -fprintf. If you are using find in a script
or in a situation where the matched files might have arbitrary names, you should consider using
-print0 instead of -print.
The -ok and -okdir actions print the current filename as-is. This may change in a future release.
VOLDOET AAN
For closest compliance to the POSIX standard, you should set the POSIXLY_CORRECT environment variable.
The following options are specified in the POSIX standard (IEEE Std 1003.1-2008, 2016 Edition):
-H This option is supported.
-L This option is supported.
-name This option is supported, but POSIX conformance depends on the POSIX conformance of the system's
fnmatch(3) library function. As of findutils-4.2.2, shell metacharacters (`*', `?' or `[]' for
example) match a leading `.', because IEEE PASC interpretation 126 requires this. This is a
change from previous versions of findutils.
-type Supported. POSIX specifies `b', `c', `d', `l', `p', `f' and `s'. GNU find also supports `D',
representing a Door, where the OS provides these. Furthermore, GNU find allows multiple types to
be specified at once in a comma-separated list.
-ok Supported. Interpretation of the response is according to the `yes' and `no' patterns selected by
setting the `LC_MESSAGES' environment variable. When the `POSIXLY_CORRECT' environment variable
is set, these patterns are taken system's definition of a positive (yes) or negative (no)
response. See the system's documentation for nl_langinfo(3), in particular YESEXPR and NOEXPR.
When `POSIXLY_CORRECT' is not set, the patterns are instead taken from find's own message
catalogue.
-newer Ondersteund. Als het opgegeven bestand een symbolische koppeling is, wordt deze altijd gevolgd.
Dit is een verandering vergeleken met het voorgaande gedrag, die de relevante tijd van de
symbolische koppeling haalde; zie GESCHIEDENIS hieronder.
-perm Supported. If the POSIXLY_CORRECT environment variable is not set, some mode arguments (for
example +a+x) which are not valid in POSIX are supported for backward-compatibility.
Other primaries
The primaries -atime, -ctime, -depth, -exec, -group, -links, -mtime, -nogroup, -nouser, -ok,
-path, -print, -prune, -size, -user and -xdev are all supported.
The POSIX standard specifies parentheses `(', `)', negation `!' and the logical AND/OR operators -a and
-o.
All other options, predicates, expressions and so forth are extensions beyond the POSIX standard. Many
of these extensions are not unique to GNU find, however.
The POSIX standard requires that find detects loops:
The find utility shall detect infinite loops; that is, entering a previously visited directory
that is an ancestor of the last file encountered. When it detects an infinite loop, find shall
write a diagnostic message to standard error and shall either recover its position in the
hierarchy or terminate.
GNU find complies with these requirements. The link count of directories which contain entries which are
hard links to an ancestor will often be lower than they otherwise should be. This can mean that GNU find
will sometimes optimise away the visiting of a subdirectory which is actually a link to an ancestor.
Since find does not actually enter such a subdirectory, it is allowed to avoid emitting a diagnostic
message. Although this behaviour may be somewhat confusing, it is unlikely that anybody actually depends
on this behaviour. If the leaf optimisation has been turned off with -noleaf, the directory entry will
always be examined and the diagnostic message will be issued where it is appropriate. Symbolic links
cannot be used to create filesystem cycles as such, but if the -L option or the -follow option is in use,
a diagnostic message is issued when find encounters a loop of symbolic links. As with loops containing
hard links, the leaf optimisation will often mean that find knows that it doesn't need to call stat() or
chdir() on the symbolic link, so this diagnostic is frequently not necessary.
The -d option is supported for compatibility with various BSD systems, but you should use the
POSIX-compliant option -depth instead.
De POSIXLY_CORRECT omgevingsvariabele beïnvloed het gedrag van de -regex of -iregex testen niet omdat
deze testen niet gespecificeerd zijn in de de POSIX standard.
OMGEVINGSVARIABELEN
LANG Provides a default value for the internationalization variables that are unset or null.
LC_ALL If set to a non-empty string value, override the values of all the other internationalization
variables.
LC_COLLATE
The POSIX standard specifies that this variable affects the pattern matching to be used for the
-name option. GNU find uses the fnmatch(3) library function, and so support for `LC_COLLATE'
depends on the system library. This variable also affects the interpretation of the response to
-ok; while the `LC_MESSAGES' variable selects the actual pattern used to interpret the response to
-ok, the interpretation of any bracket expressions in the pattern will be affected by
`LC_COLLATE'.
LC_CTYPE
This variable affects the treatment of character classes used in regular expressions and also with
the -name test, if the system's fnmatch(3) library function supports this. This variable also
affects the interpretation of any character classes in the regular expressions used to interpret
the response to the prompt issued by -ok. The `LC_CTYPE' environment variable will also affect
which characters are considered to be unprintable when filenames are printed; see the section
UNUSUAL FILENAMES.
LC_MESSAGES
Bepaald het taalgebied dat gebruikt wordt voor geïnternationaliseerde berichten. Indien de
POSIXLY_CORRECT omgevingsvariabele is gezet, dan bepaald deze ook de interpretatie van het
antwoord op de prompt veroorzaakt door de -ok actie.
NLSPATH
Bepaald de locatie van de internationale berichten catalogi.
PATH Beïnvloed de mappen die worden doorzocht om de uitvoerbare bestanden te vinden die aangeroepen
worden door -exec, -execdir, -ok en -okdir.
POSIXLY_CORRECT
Bepaald de blok grootte gebruikt door -ls en -fls. Als POSIXLY_CORRECT werd gezet, dan is de
eenheid 512 bytes. Anders zijn het eenheden van 1024 bytes.
Setting this variable also turns off warning messages (that is, implies -nowarn) by default,
because POSIX requires that apart from the output for -ok, all messages printed on stderr are
diagnostics and must result in a non-zero exit status.
Als POSIXLY_CORRECT niet is gezet dan wordt -perm +zzz precies zo behandeld als -perm /zzz als
+zzz is geen geldige symbolische mode is. Indien POSIXLY_CORRECT is gezet, dan worden deze
constructies behandeld als een fout.
When POSIXLY_CORRECT is set, the response to the prompt made by the -ok action is interpreted
according to the system's message catalogue, as opposed to according to find's own message
translations.
TZ Affects the time zone used for some of the time-related format directives of -printf and -fprintf.
VOORBEELDEN
Simple `find|xargs` approach
• Find files named core in or below the directory /tmp and delete them.
$ find /tmp -name core -type f -print | xargs /bin/rm -f
Note that this will work incorrectly if there are any filenames containing newlines, single or
double quotes, or spaces.
Safer `find -print0 | xargs -0` approach
• Find files named core in or below the directory /tmp and delete them, processing filenames in such
a way that file or directory names containing single or double quotes, spaces or newlines are
correctly handled.
$ find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f
The -name test comes before the -type test in order to avoid having to call stat(2) on every file.
Note that there is still a race between the time find traverses the hierarchy printing the matching
filenames, and the time the process executed by xargs works with that file.
Executing a command for each file
• Run file on every file in or below the current directory.
$ find . -type f -exec file '{}' \;
Notice that the braces are enclosed in single quote marks to protect them from interpretation as
shell script punctuation. The semicolon is similarly protected by the use of a backslash, though
single quotes could have been used in that case also.
In veel gevallen, zou men `-exec ... +` prefereren of nog beter `-execdir ... +` syntax vanwege prestatie
en veiligheid redenen.
Traversing the filesystem just once - for 2 different actions
• Traverse the filesystem just once, listing set-user-ID files and directories into /root/suid.txt
and large files into /root/big.txt.
$ find / \
\( -perm -4000 -fprintf /root/suid.txt '%#m %u %p\n' \) , \
\( -size +100M -fprintf /root/big.txt '%-10s %p\n' \)
This example uses the line-continuation character '\' on the first two lines to instruct the shell
to continue reading the command on the next line.
Searching files by age
• Search for files in your home directory which have been modified in the last twenty-four hours.
$ find $HOME -mtime 0
This command works this way because the time since each file was last modified is divided by 24
hours and any remainder is discarded. That means that to match -mtime 0, a file will have to have
a modification in the past which is less than 24 hours ago.
Searching files by permissions
• Search for files which are executable but not readable.
$ find /sbin /usr/sbin -executable \! -readable -print
• Search for files which have read and write permission for their owner, and group, but which other
users can read but not write to.
$ find . -perm 664
Files which meet these criteria but have other permissions bits set (for example if someone can
execute the file) will not be matched.
• Search for files which have read and write permission for their owner and group, and which other
users can read, without regard to the presence of any extra permission bits (for example the
executable bit).
$ find . -perm -664
This will match a file which has mode 0777, for example.
• Search for files which are writable by somebody (their owner, or their group, or anybody else).
$ find . -perm /222
• Search for files which are writable by either their owner or their group.
$ find . -perm /220
$ find . -perm /u+w,g+w
$ find . -perm /u=w,g=w
All three of these commands do the same thing, but the first one uses the octal representation of
the file mode, and the other two use the symbolic form. The files don't have to be writable by
both the owner and group to be matched; either will do.
• Search for files which are writable by both their owner and their group.
$ find . -perm -220
$ find . -perm -g+w,u+w
Beide commando´s doen hetzelfde.
• A more elaborate search on permissions.
$ find . -perm -444 -perm /222 \! -perm /111
$ find . -perm -a+r -perm /a+w \! -perm /a+x
These two commands both search for files that are readable for everybody (-perm -444 or -perm
-a+r), have at least one write bit set (-perm /222 or -perm /a+w) but are not executable for
anybody (! -perm /111 or ! -perm /a+x respectively).
Pruning - omitting files and subdirectories
• Copy the contents of /source-dir to /dest-dir, but omit files and directories named .snapshot (and
anything in them). It also omits files or directories whose name ends in '~', but not their
contents.
$ cd /source-dir
$ find . -name .snapshot -prune -o \( \! -name '*~' -print0 \) \
| cpio -pmd0 /dest-dir
The construct -prune -o \( ... -print0 \) is quite common. The idea here is that the expression
before -prune matches things which are to be pruned. However, the -prune action itself returns
true, so the following -o ensures that the right hand side is evaluated only for those directories
which didn't get pruned (the contents of the pruned directories are not even visited, so their
contents are irrelevant). The expression on the right hand side of the -o is in parentheses only
for clarity. It emphasises that the -print0 action takes place only for things that didn't have
-prune applied to them. Because the default `and' condition between tests binds more tightly than
-o, this is the default anyway, but the parentheses help to show what is going on.
• Gegeven de volgende map van projecten en hun geassocieerde SCM administratieve mappen, doorzoek op
een efficiënte manier de hoofdmappen:
$ find repo/ \
\( -exec test -d '{}/.svn' \; \
-or -exec test -d '{}/.git' \; \
-or -exec test -d '{}/CVS' \; \
\) -print -prune
Voorbeeld uitvoer:
repo/project1/CVS
repo/gnu/project2/.svn
repo/gnu/project3/.svn
repo/gnu/project3/src/.svn
repo/project4/.git
In dit voorbeeld, voorkomt -prune het onnodige afdalen in mappen die al ontdekt werden (bij
voorbeeld wordt project3/src niet doorzocht omdat we project3/.svn) reeds gevonden werd), maar
verzekert wel dat naast gelegen mappen (project2 en project3 gevonden worden.
Andere bruikbare voorbeelden
• Zoek voor diverse bestandstypen
$ find /tmp -type f,d,l
Search for files, directories, and symbolic links in the directory /tmp passing these types as a
comma-separated list (GNU extension), which is otherwise equivalent to the longer, yet more
portable:
$ find /tmp \( -type f -o -type d -o -type l \)
• Search for files with the particular name needle and stop immediately when we find the first one.
$ find / -name needle -print -quit
• Demonstrate the interpretation of the %f and %h format directives of the -printf action for some
corner-cases. Here is an example including some output.
$ find . .. / /tmp /tmp/TRACE compile compile/64/tests/find -maxdepth 0 -printf '[%h][%f]\n'
[.][.]
[.][..]
[][/]
[][tmp]
[/tmp][TRACE]
[.][compile]
[compile/64/tests][find]
EIND WAARDE
find exits with status 0 if all files are processed successfully, greater than 0 if errors occur. This
is deliberately a very broad description, but if the return value is non-zero, you should not rely on the
correctness of the results of find.
When some error occurs, find may stop immediately, without completing all the actions specified. For
example, some starting points may not have been examined or some pending program invocations for
-exec ... {} + or -execdir ... {} + may not have been performed.
GESCHIEDENIS
As of findutils-4.2.2, shell metacharacters (`*', `?' or `[]' for example) used in filename patterns
match a leading `.', because IEEE POSIX interpretation 126 requires this.
As of findutils-4.3.3, -perm /000 now matches all files instead of none.
Nanosecond-resolution timestamps were implemented in findutils-4.3.3.
As of findutils-4.3.11, the -delete action sets find's exit status to a nonzero value when it fails.
However, find will not exit immediately. Previously, find's exit status was unaffected by the failure of
-delete.
Feature Added in Also occurs in
-newerXY 4.3.3 BSD
-D 4.3.1
-O 4.3.1
-readable 4.3.0
-writable 4.3.0
-executable 4.3.0
-regextype 4.2.24
-exec ... + 4.2.12 POSIX
-execdir 4.2.12 BSD
-okdir 4.2.12
-samefile 4.2.11
-H 4.2.5 POSIX
-L 4.2.5 POSIX
-P 4.2.5 BSD
-delete 4.2.3
-quit 4.2.3
-d 4.2.3 BSD
-wholename 4.2.0
-iwholename 4.2.0
-ignore_readdir_race 4.2.0
-fls 4.0
-ilname 3.8
-iname 3.8
-ipath 3.8
-iregex 3.8
The syntax -perm +MODE was removed in findutils-4.5.12, in favour of -perm /MODE. The +MODE syntax had
been deprecated since findutils-4.2.21 which was released in 2005.
NON-BUGS
Operator precedence surprises
Het commando find . -name afile -o -name bfile -print zal nooit afile tonen omdat dit eigenlijk
equivalent is aan find . -name afile -o \( -name bfile -a -print \). Merk op dat de prioriteit van -a
hoger is dan die van -o en indien geen operator werd opgegeven tussen de testen, -a wordt aangenomen.
“paden moeten de expressie vooraf gaan” fout melding
$ find . -name *.c -print
find: paden moeten aan de expressie vooraf gaan
find: mogelijk een patroon zonder aanhalingstekens na het predicaat `-name'?
This happens when the shell could expand the pattern *.c to more than one file name existing in the
current directory, and passing the resulting file names in the command line to find like this:
find . -name frcode.c locate.c word_io.c -print
That command is of course not going to work, because the -name predicate allows exactly only one pattern
as argument. Instead of doing things this way, you should enclose the pattern in quotes or escape the
wildcard, thus allowing find to use the pattern with the wildcard during the search for file name
matching instead of file names expanded by the parent shell:
$ find . -name '*.c' -print
$ find . -name \*.c -print
BUGS
Er bestaan veiligheidsproblemen die inherent zijn aan het gedrag dat de POSIX standaard specificeert voor
find, en die daarom ook niet opgelost kunnen worden. Bij voorbeeld is de -exec actie inherent onveilig en
daarom zou steeds -execdir gebruikt moeten worden.
De omgevingsvariabele LC_COLLATE heeft geen effect op de -ok actie.
RAPPORTEREN VAN BUGS
Online hulp bij GNU findutils: <https://www.gnu.org/software/findutils/#get-help>
Meld alle vertaalfouten op <https://translationproject.org/team/nl.html>
Rapporteer enig ander onderwerp via het formulier op de GNU Savannah bug site.
<https://savannah.gnu.org/bugs/?group=findutils>
Algemene onderwerpen over het GNU findutils pakket worden bediscussieerd op de bug-findutils mail lijst.
<https://lists.gnu.org/mailman/listinfo/bug-findutils>
COPYRIGHT
Copyright © 1990-2021 Free Software Foundation, Inc. Licentie GPLv3+: GNU GPL versie 3 of later
<https://gnu.org/licenses/gpl.html>.
Dit is vrije software: u mag het vrijelijk wijzigen en verder verspreiden. Deze software kent GEEN
GARANTIE, voor zover de wet dit toestaat.
ZIE OOK
chmod(1), locate(1), ls(1), updatedb(1), xargs(1), lstat(2), stat(2), ctime(3) fnmatch(3), printf(3),
strftime(3), locatedb(5), regex(7)
Volledige documentatie: <https://www.gnu.org/software/findutils/find>
of lokaal beschikbaar via: info find
VERTALING
De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema <joshb@xs4all.nl>, Mario
Blättermann <mario.blaettermann@gmail.com> en Luc Castermans <luc.castermans@gmail.com>
Deze vertaling is vrije documentatie; lees de GNU General Public License Version 3 of later over de
Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID.
Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar debian-l10n-
dutch@lists.debian.org.
FIND(1)