imported>Pluderhose: /* Weblinks */ deutsche Manpage nach vorn

2025-08-12T10:12:48Z

Weblinks: deutsche Manpage nach vorn

Neue Seite

{{Begriffsklärungshinweis|Siehe auch: [[Fint]].}}
{{SEITENTITEL:find}}
'''find''' (<code>/usr/bin/find</code>) ist ein Programm zur Durchmusterung von [[Dateisystem|Filesystemen]]. Es ist ein grundlegender Bestandteil der Softwareausstattung von [[UNIX]]-Systemen und als solcher durch den
[[POSIX]]-Standard (beziehungsweise den identischen Standards IEEE Std 1003 und ISO/IEC 9945)<ref name=posix>{{Internetquelle |url=https://pubs.opengroup.org/onlinepubs/009695399/utilities/find.html |titel=find (Opengroup Base Specifications Issue 6)|sprache=en|zugriff=2018-03-08}}</ref> definiert, als ''mandatory'' (erforderlicher Bestandteil) gekennzeichnet und somit Teil der [[Single UNIX Specification]]. Auch UNIX-ähnliche Betriebssysteme verfügen in der Regel über diesen Befehl.

Unter [[Microsoft Windows]] gibt es ebenfalls den Befehl ''find'', dieser durchsucht jedoch den Inhalt von Dateien und hat eher (entfernte) Ähnlichkeit mit dem Kommando [[grep]].

== Geschichte ==
Das erste <code>find</code> erschien in ''Fifth Edition Unix'' (ca. Juni 1974) als Teil des [[PWB/UNIX]]-Projekts (''Programmer’s Workbench''), der in ''Research Unix''<ref name=resunix>Die Bezeichnung wurde allerdings erst ab 1978 für diese Entwicklungslinie gebräuchlich, um sie von PWB/UNIX und [[MERT]] abzugrenzen, siehe ''Bell System Technical Journal'' Vol. 57, No 6, Pt. 2 Jul/Aug 1978</ref> übernommen wurde. Es wurde von '''Richard C. (''Dick'') Haight''', einem Mitglied der PWB/UNIX-Entwickler, geschrieben, ebenso wie [[cpio]] und [[expr]].<ref name=mcill>{{Internetquelle |url=https://www.cs.dartmouth.edu/~doug/reader.pdf |titel=A Research Unix reader: annotated excerpts from the Programmer's Manual, 1971–1986|format=pdf|sprache=en|autor=[[Douglas McIlroy|M. Douglas McIlroy]]|zugriff=2018-03-08}}</ref> <code>find</code> und <code>cpio</code> wurden für den gemeinsamen Einsatz entworfen.

== Arbeitsweise ==
Als typisches Kommandozeilen-Utility ist das Verhalten <code>find</code>s durch die Sektion 12.2 des Standards (''Utility Syntax Guidelines'') geregelt.<ref name=usg>{{Internetquelle |url=https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap12.html#tag_12_02 |titel=The Open Group Base Specifications Issue 7, 2018 edition, Kap. 12. Utility Conventions |sprache=en|zugriff=2019-05-15}}</ref> Ausgehend von einem anzugebenden Basisverzeichnis durchschreitet <code>find</code> die Filesystemstruktur rekursiv und erzeugt eine Liste von Filesystem-Inhalten (Files, Directories etc..), die (wenigstens in den meisten Fällen) auf <code><stdout></code> ausgegeben wird. Diese Liste kann durch einen oder mehrere ''Operanden'' nach verschiedenen Gesichtspunkten fortschreitend eingeschränkt werden:

:<code>find /some/dir -print # jeden Eintrag in /some/dir anzeigen</code>
:<code>find /some/dir -type f -print # angezeigte Einträge auf (reguläre) Dateien beschränken</code>
:<code>find /some/dir -type f -name 'x*' -print # angezeigte Einträge auf Dateien deren Namen mit „x“ beginnt, einschränken</code>

Es ist möglich, mehrere solche Operanden durch logische Operationen (UND, ODER, NICHT) zu verknüpfen wie auch durch Klammern die Präzedenz der Operanden zu beeinflussen. So können auch komplexe Filtertypen realisiert werden.

Allen Operanden ist gemeinsam, dass sie als Ergebnis ein logisches <code>TRUE</code> oder <code>FALSE</code> zurückgeben, aufgrund dessen die gerade untersuchte Entität an der weiteren Verarbeitung teilnimmt (bis sie – üblicherweise – am Schluss ausgegeben wird) oder von derselben ausgeschlossen wird.

Es ist möglich, das Ausgabeformat auf den reinen Dateinamen zu beschränken (<code>-print</code>) oder auch eine Liste von Attributen in Tabellenform (<code>-ls</code>, was eine Ausgabe ähnlich der des Kommandos <code>ls -dils</code> bewirkt) auszugeben.

=== -exec ===
Eine besondere Stellung unter den Operanden nimmt <code>-exec</code> ein. Es erwartet als Argument ein (einfaches oder auch zusammengesetztes) Kommando, in welchem der Name der gerade untersuchten Entität durch das Symbol <code>{}</code> vertreten wird. Damit ist es möglich, für eine eben erzeugte Liste von Filesystem-Einträgen eine durch ein Kommando repräsentierte Aktion durchzuführen. Das Beispiel sucht in allen Dateien <code>*.c</code> in dem Directory <code>/some/dir</code> nach Aufrufen oder dem Code der Funktion <code>myfunc()</code> (die Datei <code>/dev/null</code> wird angegeben, damit <code>grep</code> die Dateinamen der Fundstellen mit anzeigt):

:<code>find /some/dir -type f -name '*\.c' -exec grep 'myfunc<nowiki>(</nowiki>' /dev/null {} \;</code>

Darüber hinaus gibt <code>-exec</code> als Rückgabewert den ''Return Code'' des aufgerufenen Kommandos zurück, sodass es ebenfalls für Filterungszwecke genutzt werden kann. Falls im obigen Beispiel nur die Dateinamen der Dateien, in denen die Funktion verwendet wird, gesucht werden, so kann dies durch:

:<code>find /some/dir -type f -name '*\.c' -exec grep -q 'myfunc<nowiki>(</nowiki>' {} \; -print</code>

geschehen.

=== Zeitmessung und -vergleiche ===
Verschiedene Operanden (<code>-atime</code>, <code>-ctime</code>, <code>-mtime</code>) ermöglichen das Vergleichen von Zeitstempeln von Dateien, wobei die Vergleichszeiträume in ''Tagen'' angegeben werden. Tatsächlich werden diese Zeiträume allerdings als Ergebnis einer Integer-Division der Zeitdifferenz in Sekunden durch 86400 interpretiert. Der Standard führt in seinen Erläuterungen als (hier vervollständigtes) Beispiel

:<code>find /some/dir -atime 2</code>

an<ref name=posix />, das alle Dateien (oder sonstigen Filesystem-Entitäten) findet, deren Zeitpunkt des letzten Zugriffs zwischen 48 und 72 Stunden vor Ausführung des Befehls liegt.

== Hinweise und Einschränkungen ==
=== Numerische Argumente ===
Verschiedene Operanden (zum Beispiel <code>-size</code> oder <code>-atime</code>) erwarten numerische Argumente. Bei solchen gilt, dass die Angabe ''n'' (für numerische Werte ''n'') immer ''genau n'' bedeutet, ''-n'' hingegen ''kleiner als n'' und ''+n'' bedeutet ''größer als n''.

=== Vorsicht bei -exec ===
Da oftmals beim Aufruf von <code>find</code> nicht feststeht, wie viele Treffer schließlich im Ergebnis-Set vorliegen, kann die Verwendung von <code>-exec</code> zu einer unverhältnismäßigen Belastung des Systems führen, da ja für jeden Treffer ein (durch vergleichsweise hohen Ressourcenverbrauch gekennzeichneter) [[Fork (Unix)|fork()]]-Systemcall durchzuführen ist.

=== Execplus ===
Mit dem POSIX-Standard konforme Implementationen kennen deshalb das den externen Aufruf abschließende Plus (<code>+</code>). Hier wird das externe Kommando mit einer Liste von Treffern gleichzeitig aufgerufen, sodass die erwähnte Belastung des Systems durch viele fork()-s verringert wird. Gleichzeitig aber wird der Rückgabewert des Kommandos für eine einzelne Datei unbestimmt, sodass <code>-exec</code> nicht mehr weiter als filternder Operand wirken kann.

Weitere Probleme bei der Verwendung von <code>-exec</code> können sich bei komplexen Kommandos ergeben: es ist zwar grundsätzlich möglich, verschachtelte Kommandos zu verwenden, aber letztlich ist <code>find</code> keine Shell und deshalb in der Interpretation solcher Schachtelungen beschränkt. Insbesondere Shell-übliche Konstruktionen wie etwa die logische Verknüpfung ''cmd1 && cmd2'' schlagen innerhalb von Kommandos in <code>-exec</code> fehl.

=== {} und -exec ===
Das Argument <code>{}</code> kann lediglich ein einziges Mal in einem <code>-exec</code>-Operanden verwendet werden, nicht öfter. Darüber hinaus muss es als einzelnes (das heißt alleinstehendes) Argument verwendet werden. Die folgenden Konstruktionen sind deshalb alle ungültig:

:<code>find /some/where -type f -exec mv {} {}.old \;</code>
:<code>find /some/where -type f -exec gzip {} >/packed/files/{} \;</code>

Für solche Zwecke sollte ein Script geschrieben werden, dem als Parameter der Dateiname übergeben wird und das als Argument in <code>-exec</code> eingesetzt wird. Etwa für das erste Beispiel:

:<code>$ echo 'mv $1 ${1}.old' > /tmp/mymove.sh</code>
:<code>$ chmod u+x /tmp/mymove.sh</code>

:<code>$ find /some/where -type f -exec /tmp/mymove.sh {} \;</code>

=== Schutz vor unendlichem Regress ===
In der Praxis kann es durchaus vorkommen, dass in Filesystemen (durch [[Harter Link|Hardlinks]] oder [[Symbolische Verknüpfung|Softlinks]]) Endlosreferenzen aufgebaut werden. Der POSIX-Standard schreibt deshalb vor, dass konforme Versionen diesen Umstand zu erkennen und die Rekursion abzubrechen haben.<ref name=posix />

== Nonstandard-Varianten ==
Das [[GNU]]-Projekt verfügt über einen Nachbau des Kommandos als Teil des ''findutils''-Pakets. Es unterscheidet sich vom POSIX-konformen Original in einigen Punkten.

== Weblinks ==
* {{man|1|find|gnu|in einer Verzeichnishierarchie nach Dateien suchen}} (deutsch)
* {{man|1|find|posix|find files}} (englisch)
* {{man|1|find|bsd|walk a file hierarchy}} (englisch)
* [https://shapeshed.com/unix-find/ Linux and Unix find command tutorial with examples (engl.)] (englisch)

== Einzelnachweise ==
<references />

[[Kategorie:Unix-Software]]
[[Kategorie:Unix-Betriebssystemkomponente]]

Find - Versionsgeschichte

imported>Pluderhose: /* Weblinks */ deutsche Manpage nach vorn