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

Schakel waarschuwing berichten aan of uit. Deze waarschuwingen hebben alleen betrekking op het gebruik van de commando regel, niet op elke conditie die find tegen kan komen terwijl het mappen doorzoekt. Het standaard gedrag komt overeen met -warn als de standaard invoer een tty is, en anders met -nowarn. Als er een waarschuwing wordt geproduceerd die gerelateerd is aan het gebruik van de commando regel, dan wordt de afsluit status van find niet gewijzigd. Als de POSIXLY_CORRECT omgevingsvariabele is gezet en -warn ook werd gebruikt dan is het niet gespecificeerd of er enige waarschuwing actief zal worden.

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.

-files0-from bestand

Lees de beginpunten van bestand in plaats van ze te verkrijgen via de commando regel. In tegenstelling tot de bekende beperkingen van het verkrijgen van beginpunten via argumenten op de commando regel, namelijk de limitatie van het aantal bestandsnamen en de inherente ambiguïteit van bestandsnamen die botsen met optie namen, staat deze optie toe om veilig een willekeurig aantal van startpunten aan find mee te geven.

Het gebruik van deze optie en het doorgeven van startpunten op de commando regel sluit elkaar uit, en worden daarom niet tegelijkertijd toegestaan.

Het bestand argument is verplicht. Men kan -files0-from - gebruiken om de lijst van startpunten te lezen van de standaard invoer stream, en b.v. van een pijp. In dit geval zijn de acties -ok en -okdir niet toegestaan, omdat deze duidelijk interfereren met het lezen van standaard invoer om op deze manier de bevestiging van de gebruiker te verkrijgen.

De startpunten in bestand moeten worden gescheiden door ASCII NUL tekens. Twee opeenvolgende NUL tekens, m.a.w. een startpunt met een bestandsnaam van lengte nul wordt niet toegestaan en zal leiden tot een fout diagnose gevolgd door een niet-nul afsluit code.

In dit geval is het gegeven bestand leeg, find zal geen enkel startpunt verwerken en daarom onmiddellijk na het ontleden van de programma argumenten eindigen. Dit is anders dan de standaard invocatie waar find aanneemt dat de huidige map het startpunten is zodra er geen pad argument werd mee gegeven.

Het verwerken van de beginpunten is als gebruikelijk, b.v. find zal in submappen duiken tenzij dit voorkomen werd. Om alleen de beginpunten te verwerken kan men additioneel nog -maxdepth 0 mee geven.

Verdere opmerkingen: indien een bestand meer dan eens werd opgegeven in het invoer bestand, dan is het niet zeker dat het ook meer dan eens werd gevonden. Als het bestand werd veranderd tijdens het uitvoeren van find dan is het resultaat niet bepaald. Tot slot, is de zoek positie in het genoemde bestand op het moment dat find eindigt ook niet bepaald. Met "niet bepaald" wordt hier bedoeld dat het al dan niet werkt of een specifiek ding doet, en dat het gedrag anders kan zijn tussen de verschillende platformen, of van findutils release tot release.

-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.

-xautofs

Daal niet af in mappen op autofs bestandssystemen.

-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

Vind bestanden die uitvoerbaar en mappen die doorzoekbaar zijn (in de betekenis van de gezochte bestandsnaam) door de huidige gebruiker. Dit houdt rekening met toegangs controle lijsten en andere rechten artefacten die de -perm test negeert. Deze test maakt gebruik van de access(2) systeem aanroep, en kan dus voor de gek worden gehouden door NFS servers die UID uitvoeren (of root-squashing), omdat veel systemen access(2) in de kernel van de client implementeren en daarom geen gebruik kunnen maken van de UID informatie bijgehouden in de server. Omdat deze test alleen is gebaseerd op het resultaat van de access(2) systeem aanroep, is er geen garantie dat een bestand waarvoor de test succesvol was ook daadwerkelijk kan worden uitgevoerd.

-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 bestandsnaam (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 meta-karakters (`*', `?', and `[]') passen op een `.' aan het begin van de basis (dit is een verandering in findutils-4.2.2; zie sectie VOLDOET AAN 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 referentie

Slaagt als tijdstempel X van het overwogen bestand nieuwer is dan de tijdstempel Y van de bestand referentie. De letters X en Y kan een van de onderstaande letters zijn:

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.

Een aantal combinaties zijn ongeldig; bij voorbeeld, is het ongeldig dat X gelijk is aan t. Sommige combinaties zijn niet geïmplementeerd op alle systemen; B is b.v. niet geïmplementeerd op alle systemen. Als een ongeldige of niet ondersteunde combinatie van XY werd opgegeven, dan resulteert dit in een fatale fout. Tijd specificaties worden geïnterpreteerd zoals die van het argument van de -d optie van GNU date. Als u de aanmaak tijd van een referentie bestand probeert te gebruiken en de aanmaak tijd kon niet worden bepaald dan resulteert dit in een fatale fout. Als u een test specificeert die verwijst naar de aanmaak tijd van onderzochte bestanden, dan zal deze test falen voor elk bestand waarvan de aanmaak tijd onbekend is.

-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 vergelijkt het -path argument met de samenvoeging van de map naam en de basis naam van het onderzochte bestand. Omdat de samenvoeging nooit eindigt met een schuine streep, zullen -path argumenten eindigend met een schuine streep met niks overeenkomen (behalve misschien met een beginpunt opgegeven op de commando regel). Het predicaat -path wordt ook ondersteund door HP-UX find en is onderdeel van de POSIX 2008 standaard.

-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

Vindt bestanden die leesbaar zijn door de huidige gebruiker. Er wordt rekening gehouden met toegang controle lijsten en andere permissie artefacten die de -perm test negeert. Deze test maakt gebruik van de access(2) systeem aanroep en kan voor de gek gehouden worden door NFS servers die UID mapping (of root- squashing) uitvoeren, omdat veel systemen access(2) in de kernel van de client implementeren kunnen zij niet gebruik maken van de UID mapping informatie zoals die door de server wordt bijgehouden.

-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

Bestand verwijst naar dezelfde inode als naam. Wanneer -L gebruikt werd, dan kan deze symbolische koppelingen bevatten.

-size n[cwbkMG]

Bestand gebruikt afgerond minder dan, meer dan of exact n eenheden ruimte. De volgende achtervoegsels kunnen gebruikt worden:

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.

De + en - voorvoegsels betekenen groter dan en kleiner dan, zoals gebruikelijk; m.a.w. een exacte grootte van n eenheden komt niet overeen. Merk op dat de grootte wordt afgerond op de volgende eenheid. Daarom is -size -1M niet equivalent met -size -1048576c. De eerste komt alleen overeen met lege bestanden, de laatste vind bestanden van 0 tot 1.048.575 bytes.

-true

Altijd waar.

-type c

Bestand is van soort c:

Om te zoeken naar meer dan een type in een keer, kunt u de gecombineerde lijst van de typen letters gescheiden door een komma opgeven ¨," (GNU uitbreiding).

-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

Zie -path. Dit alternatief is minder overdraagbaar dan -path.

-writable

Vindt bestanden die schrijfbaar zijn door de huidige gebruiker. Er wordt rekening gehouden met toegang controle lijsten en andere permissie artefacten die de -perm test negeert. Deze test maakt gebruik van de access(2) systeem aanroep en kan voor de gek gehouden worden door NFS servers die UID mapping (of root- squashing) uitvoeren, omdat veel systemen access(2) in de kernel van de client implementeren kunnen zij niet gebruik maken van de UID mapping informatie zoals die door de server wordt bijgehouden.

-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 het verwijderen lukte. Als het verwijderen mislukte, dan wordt een foutmelding gegeven, en zal de beëindigingsstatus van find niet-nul zijn (zodra het uiteindelijk eindigt).

Waarschuwing: Vergeet niet dat find de commando regel evalueert als een expressie, het vooraf laten gaan van -delete zorgt er voor dat find alles onder het door u opgegeven startpunt probeert te wissen.

Het gebruik van de -delete actie op de commando regel zal automatisch de -depth optie activeren. Op zijn beurt maakt -depth -prune niet effectief, de -delete actie kan niet bruikbaar worden gecombineerd met -prune.

Often, the user might want to test a find command line with -print prior to adding -delete for the actual removal run. To avoid surprising results, it is usually best to remember to use -depth explicitly during those earlier test runs.

De -delete actie zal falen een map te wissen, behalve als deze leeg is.

Samen met de -ignore_readdir_race optie zal find fouten van de -delete actie negeren in het geval dat het bestand verdween na het moment dat de ouder map werd gelezen: het zal geen fout diagnose tonen, de afsluit code niet naar niet-nul veranderen, bovendien zal de afsluit code van -delete actie 'waar' zijn.

-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 ONGEBRUIKELIJKE BESTANDSNAMEN 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. Deze actie mag niet tegelijkertijd met de -files0-from optie worden opgegeven

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 -execdir 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. Deze actie mag niet tegelijkertijd met de -files0-from optie worden opgegeven.

-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:

-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.

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.

Processing arbitrary starting points¶

•

Given that another program proggy pre-filters and creates a huge NUL-separated list of files, process those as starting points, and find all regular, empty files among them:

$ proggy | find -files0-from - -maxdepth 0 -type f -empty


    

The use of `-files0-from -` means to read the names of the starting points from standard input, i.e., from the pipe; and -maxdepth 0 ensures that only explicitly those entries are examined without recursing into directories (in the case one of the starting points is one).

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]


    

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