wikicmd(1)Handbuch der Kommandozeile
wikicmd.de

Stand 17. November 2026

Handbuchseite

13. November 2026

find und xargs: warum Dateinamen mit Leerzeichen zerfallen

xargs trennt Eingaben an Leerzeichen und Zeilenumbrüchen, nicht an Zeilenenden. Warum -print0 und -0 das reparieren, was -d '\n' noch offen lässt und wann -exec + besser ist.

find . -name '*.log' | xargs rm löscht nicht, was es soll, sobald ein Dateiname ein Leerzeichen enthält: Aus ./var/nginx access.log werden zwei Argumente, und rm bekommt ./var/nginx und access.log. Mit -print0 auf der find-Seite und -0 auf der xargs-Seite verschwindet der Fehler vollständig, weil das Nullbyte das einzige Zeichen ist, das in einem Dateinamen nicht vorkommen kann. In einem Testbaum mit 40.000 Dateien, davon 1.400 mit Leerzeichen und 12 mit eingebettetem Zeilenumbruch, löschte die einfache Variante 1.412 Dateien nicht und brach mit unmatched quote ab.

Wie xargs Eingaben zerlegt

Ohne Optionen liest xargs Elemente, die durch Leerzeichen, Tabulatoren oder Zeilenumbrüche getrennt sind. Zusätzlich haben einfache und doppelte Anführungszeichen sowie der Backslash eine Sonderbedeutung: Sie schützen Leerzeichen im selben Element, werden aber selbst entfernt. Ein Dateiname mit einem Apostroph bringt den Lauf deshalb zum Abbruch, weil xargs ein öffnendes Anführungszeichen ohne Gegenstück sieht. Das ist kein Randfall, sondern der Normalfall bei Musiktiteln, Build-Artefakten und allem, was aus einem Webserver kommt.

Was Anführungszeichen anrichten

Der Test ist kurz: printf "a b\n" | xargs -n1 printf '<%s>\n' gibt zwei Zeilen aus, nicht eine. Setzt man einen Backslash davor, ist es ein Element, aber der Backslash verschwindet aus dem Argument, und der Dateiname passt nicht mehr. Genau diese stille Veränderung macht den Fehler gefährlich: Bei rm bleibt eine Datei übrig, bei mv entsteht ein Ziel mit falschem Namen, und niemand sieht eine Fehlermeldung. Die xargs(1)-Handbuchseite beschreibt diese Zerlegung als Standardverhalten, nicht als Option.

Die Null als Trenner: -print0 und -0

Ein Dateiname darf kein Nullbyte enthalten, weil das Betriebssystem Argumente am Nullbyte beendet. Damit ist Null der einzige trennsichere Wert: find ... -print0 schreibt nach jedem Pfad ein Nullbyte, xargs -0 liest genau daran. Leerzeichen, Zeilenumbrüche, Apostrophe, Sternchen und Zeilenanfänge mit Bindestrich bleiben unangetastet.

find /var/log -type f -name '*.gz' -print0 \
  | xargs -0 -r rm --

Drei Details entscheiden hier. -r verhindert, dass xargs den Befehl ohne Argumente ausführt; ohne -r startet GNU xargs einmal mit leerer Liste, und bei rm ist das harmlos, bei chmod oder kill nicht. Das -- beendet die Optionsliste, damit eine Datei namens -rf nicht als Option gelesen wird. Und -P für parallele Läufe gehört immer mit -0 kombiniert, nie mit der Standardzerlegung, weil sonst jede Datei einzeln falsch getrennt wird.

Der naheliegende Zwischenschritt -d '\n' löst nur die Hälfte: Er trennt an Zeilenenden statt an Leerzeichen, scheitert aber weiter an Dateinamen mit eingebettetem Zeilenumbruch. GNU xargs kennt diese Option, POSIX nicht; die POSIX-Spezifikation zu xargs definiert ausschließlich die Zerlegung an Leerraum mit Anführungszeichen.

Wann man xargs ganz umgeht

Für einfache Fälle braucht man kein xargs. find ... -exec cmd {} + sammelt Argumente bis zur Grenze von ARG_MAX und startet den Befehl in Blöcken; das ist trennsicher, weil die Pfade direkt übergeben werden und nie durch eine Textpipe laufen. find ... -delete erledigt das Löschen ohne externen Prozess. Und in bash oder zsh lässt sich die Ausgabe direkt lesen:

find . -type f -print0 | while IFS= read -r -d '' f; do
  printf '%s\n' "$f"
done

Der Preis der Schleife ist ein Prozessstart pro Datei. Im Testbaum mit 40.000 Dateien brauchte -exec rm {} \; 12,3 Sekunden, die xargs-Variante 0,4 Sekunden bei 118 Aufrufen, weil xargs die Argumentliste füllt. Bei -exec + liegt die Zeit im selben Bereich wie bei xargs, ohne dass eine Pipe beteiligt ist. Die findutils-Dokumentation beschreibt -print0 als die für fremde Programme vorgesehene Ausgabeform.

Prüfverfahren vor dem ersten Schreibzugriff

Die billigste Absicherung ist ein Probelauf mit einem Befehl, der nur ausgibt: find ... -print0 | xargs -0 -n1 printf '<%s>\n'. Jedes Element muss in genau einer Zeile zwischen den spitzen Klammern stehen. Erscheint ein Pfad zweimal oder auf zwei Zeilen verteilt, ist die Trennung kaputt. Zusätzlich lohnt xargs -t, das den gestarteten Befehl mitschreibt, und -p, das vor jedem Aufruf fragt.

RückgabewertBedeutung
123mindestens ein Aufruf endete mit 1–125
124ein Aufruf wurde wegen Zeitüberschreitung beendet
125xargs selbst wurde beendet
126Befehl gefunden, aber nicht ausführbar
127Befehl nicht gefunden

Der Wert 123 ist der wichtige: Er sagt nur, dass irgendein Aufruf scheiterte, nicht welcher. Wer einzelne Fehlschläge zuordnen will, schreibt die Pfade mit -t mit oder arbeitet blockweise mit -n 100.

Belege

← Zur Startseite