find und xargs ohne Überraschungen: NUL-getrennte Namen, -exec + und Trockenläufe

Ziel

Dateien nach Name, Typ, Alter oder Grösse auswählen und einen Befehl so auf sie anwenden, dass er bei ungewöhnlichen Dateinamen nicht bricht und nicht auf der falschen Menge wirkt.

Voraussetzungen

GNU findutils oder eine andere Implementierung mit -print0 und xargs -0. Das Bewusstsein, dass find seine Argumente als einen einzigen Ausdruck von links nach rechts auswertet.

Schritte

1. Zuerst nur die Auswahl schreiben und ausgeben: find . -type f -name '*.log' -mtime +30 -print. Die Liste durchsehen. -maxdepth 1 begrenzt die Tiefe; -path ./node_modules -prune -o -type f -print überspringt einen Teilbaum.
2. Entscheiden, wie der Befehl ausgeführt wird. Für einen Befehl über viele Dateien -exec cmd {} + verwenden: Die Man-Page besagt, dass die Befehlszeile wie bei xargs durch Anhängen von Namen gebildet wird, sodass es deutlich weniger Aufrufe gibt als mit -exec cmd {} \;, das einmal pro Datei läuft. -execdir führt den Befehl aus dem Verzeichnis der Datei aus; die Man-Page empfiehlt es aus Sicherheitsgründen gegenüber -exec.
3. Muss ein anderes Programm die Namen verarbeiten, sie mit NUL trennen: find ... -print0 | xargs -0 cmd. Die xargs-Man-Page erklärt, dass ihre Standard-Trennzeichen (Leerzeichen und Zeilenumbrüche, wobei Anführungszeichen und Backslashes eine besondere Bedeutung haben) Namen, die diese enthalten, falsch behandeln, während -0 jedes Byte wörtlich nimmt.
4. -r (--no-run-if-empty) zu xargs hinzufügen. Ohne dieses hält die Man-Page fest, läuft der Befehl auch dann einmal, wenn keine Eingabe vorliegt, was bei manchen Befehlen «alles» bedeutet.
5. -I{} verwenden, wenn der Name mitten im Befehl stehen muss (dies impliziert ein Element pro Aufruf), -n 1 für ein Element nach dem anderen, und -P 4 zusammen mit -n für parallele Läufe.
6. Vor destruktiven Aktionen echo vor den Befehl setzen oder -print beibehalten; danach -print durch -delete ersetzen. Die Man-Page warnt, dass ein zuerst geschriebenes -delete alles unterhalb der Startpunkte löscht und dass es -depth einschaltet, wodurch -prune wirkungslos wird.
7. Exit-Status prüfen: xargs gibt 123 zurück, wenn ein Aufruf fehlgeschlagen ist, 124, wenn ein Befehl mit 255 beendet wurde (was auch xargs stoppt), 126 oder 127, wenn der Befehl nicht ausgeführt oder nicht gefunden werden konnte.

Erwartetes Ergebnis

Eine Befehlszeile, die mit jedem Dateinamen zurechtkommt, das Werkzeug so selten wie nötig aufruft, bei leerer Auswahl nichts tut und als Auflistung geprüft wurde, bevor sie irgendetwas verändert hat.

Grenzen und Prüfbasis

Das Verhalten folgt den zitierten GNU-Man-Pages; die xargs-Man-Page hält fest, dass -0 und -r erst mit der Ausgabe 2024 Teil von POSIX wurden und dass -delete und -execdir nicht POSIX sind, weshalb andere Implementierungen sie eventuell nicht besitzen. Sowohl -exec ... + als auch xargs teilen lange Listen auf mehrere Aufrufe auf, der Befehl muss also auch in Stapeln sicher ausführbar sein. Es werden keine Zeitmessungen behauptet.

Trockenläufe, die zur Löschung passen

-delete impliziert -depth, und bei -depth hat die Aktion -prune keine Wirkung, sodass eine mit -prune ... -print vorab betrachtete Auswahl bei der Ausführung mit -delete auch innerhalb des ausgeschlossenen Teilbaums löscht. Vorschau und Ausführung müssen denselben Durchlauf verwenden. Entweder -depth zur Vorschau hinzufügen und das Prune durch einen Test ersetzen, der den Teilbaum nicht auswählt (find . -depth -not -path './node_modules/*' -name '*.log' -print, danach dasselbe mit -delete), oder -prune beibehalten und über eine Pipe löschen: find . -path ./node_modules -prune -o -name '*.log' -print0 | xargs -0r rm --. Unabhängig von der gewählten Form die Zeile einmal mit -print oder mit vorangestelltem echo rm ausführen und die Liste vergleichen, bevor sie tatsächlich ausgeführt wird.