wikicmd(1)Handbuch der Kommandozeile
wikicmd.de

Stand 15. November 2026

Rubrik 5

Dateiformate und Fehler

Stolperfallen

Neun Fälle, in denen ein Befehl keinen Fehler meldet und trotzdem das Falsche tut. Jeder Eintrag nennt den Befund, die Ursache, eine Prüfung und ein Gegenmittel.

Vorbemerkung

Warum stille Fehler

Die teuren Fehler auf der Kommandozeile sind selten die lauten. Ein Tippfehler in einer Option erzeugt eine Meldung, und die Sitzung endet dort. Ein falscher Trenner erzeugt keine Meldung, sondern ein Ergebnis, das plausibel aussieht.

Jeder Eintrag folgt derselben Ordnung: was zu sehen war, warum es passiert, wie man es vorher prüft und was zu tun ist. Die Prüfbefehle sind so gewählt, dass sie nichts verändern.

Fall

01 von 09

Der Löschlauf trifft die falschen Dateien

Eine Liste mit 40 Dateien wird an xargs übergeben, gelöscht werden 61. Der Befehl meldet keinen Fehler.

Ursache. Ohne -0 zerlegt xargs seine Eingabe an Leerzeichen, Tabulatoren und Zeilenumbrüchen und beachtet dabei Anführungszeichen nur halb. Ein Dateiname mit Leerzeichen wird zu zwei Argumenten, ein Name mit Zeilenumbruch zu zweien in verschiedenen Aufrufen.

Prüfung. Zähle die Einträge vor dem Lauf und vergleiche sie mit der Anzahl der bearbeiteten Namen. Bei NUL-getrennten Listen geht das mit tr -cd "\0" | wc -c.

Gegenmittel. Auf der erzeugenden Seite -print0, auf der lesenden Seite -0. Beide Seiten gehören zusammen; eine allein hilft nicht.

find /srv/upload -type f -name "*.tmp" -print0 | xargs -0 rm -v

Fall

02 von 09

sed -i bricht auf macOS mit einer Fehlermeldung ab

Dasselbe Skript läuft auf dem Server und scheitert auf dem Laptop: sed: 1: "…": invalid command code.

Ursache. BSD sed verlangt nach -i ein Argument für die Sicherungskopie. GNU sed nimmt an dieser Stelle bereits das Skript. Ein leerer String als Argument löst das, ist aber auf GNU sed ein Dateiname.

Prüfung. sed --version antwortet auf GNU-Systemen mit einer Versionszeile, auf BSD mit einem Fehler. In Skripten ist das eine verlässlichere Abfrage als uname.

Gegenmittel. Zwei Aufrufe oder eine Fallunterscheidung. Für portable Skripte hat sich ein temporäres File mit mv bewährt.

sed -i '' -e 's/alt/neu/g' datei.conf   # BSD
sed -i -e 's/alt/neu/g' datei.conf      # GNU

Fall

03 von 09

find -mtime +30 löscht Dateien, die erst zwei Wochen alt sind

Ein Aufräumlauf entfernt Protokolle, die nach dem Kalender noch lange nicht fällig waren.

Ursache. -mtime rechnet in Blöcken von 24 Stunden ab dem Zeitpunkt des Aufrufs, nicht in Kalendertagen ab Mitternacht. Eine Datei von gestern 23 Uhr und eine von heute 1 Uhr können in verschiedenen Blöcken liegen.

Prüfung. find mit -printf "%TY-%Tm-%Td %TH:%TM %p\n" zeigt Datum und Uhrzeit, mit denen find tatsächlich rechnet. Auf BSD fehlt -printf; dort hilft ls -l mit dem Ergebnis von -print.

Gegenmittel. Für Kalendertage -daystart verwenden oder mit -newermt und einem ausgerechneten Datum arbeiten.

find /var/log -type f -name "*.gz" -daystart -mtime +30 -print

Fall

04 von 09

sort ordnet Umlaute an eine andere Stelle als erwartet

Zwei Maschinen mit derselben Datei liefern zwei verschiedene Reihenfolgen. Ein Vergleich per diff meldet Unterschiede, die es nicht gibt.

Ursache. sort richtet sich nach der Locale. In de_DE.UTF-8 werden Umlaute wie ihre Grundbuchstaben einsortiert, in C nach Bytewert. Auch die Behandlung von Groß- und Kleinschreibung hängt daran.

Prüfung. locale zeigt die wirksamen Einstellungen. Ein Lauf mit LC_ALL=C sort datei macht den Unterschied sofort sichtbar.

Gegenmittel. In Skripten, deren Ausgabe weiterverarbeitet wird, LC_ALL=C setzen. Für Menschen bleibt die Locale des Systems besser.

LC_ALL=C sort -t: -k1,1 datei > sortiert.txt

Fall

05 von 09

rsync legt auf dem Ziel eine Ebene tiefer ab

Statt /srv/www/html/index.html liegt danach /srv/www/html/html/index.html im Ziel.

Ursache. Ein Quellpfad ohne abschließenden Schrägstrich bedeutet: dieses Verzeichnis mit seinem Namen kopieren. Mit Schrägstrich bedeutet er: den Inhalt kopieren. Der Unterschied ist ein Zeichen.

Prüfung. Immer erst mit -n (Probelauf) arbeiten und die Zeilen zählen. rsync -an gibt genau aus, was es tun würde, ohne etwas zu schreiben.

Gegenmittel. Vor dem ersten Lauf -n, danach --itemize-changes. Für Spiegelungen zusätzlich --delete, aber niemals ohne Probelauf.

rsync -an --delete --itemize-changes /srv/www/html/ ziel:/srv/www/html/

Fall

06 von 09

tar entpackt ein Archiv über das ganze System

Ein Archiv, das mit absoluten Pfaden gepackt wurde, schreibt beim Entpacken nach /etc und /var, unabhängig vom aktuellen Verzeichnis.

Ursache. tar speichert Pfade, wie es sie bekommt. Führenden Schrägstrich entfernt GNU tar beim Packen nur mit -P nicht, und beim Entpacken warnt es zwar, schreibt aber trotzdem.

Prüfung. tar -tzf archiv.tar.gz | head -n 20 zeigt die Pfade im Archiv, bevor etwas auf die Platte geht. Zeilen, die mit / beginnen, sind ein Warnsignal.

Gegenmittel. Beim Packen relative Pfade verwenden, beim Entpacken mit -C in ein leeres Zielverzeichnis arbeiten.

tar -tzf archiv.tar.gz | head -n 20
tar -xzf archiv.tar.gz -C /srv/neu/

Fall

07 von 09

grep -P ist auf dem Mac nicht vorhanden

Ein Muster mit \d und Lookahead funktioniert auf Linux und scheitert auf macOS mit der Meldung invalid option.

Ursache. PCRE ist eine Erweiterung von GNU grep. BSD grep bringt sie nicht mit, und macOS liefert BSD grep aus.

Prüfung. grep -V zeigt die Variante. Ein Aufruf mit einem einfachen Muster und -P entscheidet schneller, ob die Option überhaupt existiert.

Gegenmittel. Für portable Muster reichen -E und die Grundlagen aus. Wer echte Lookaheads braucht, nimmt perl -ne oder installiert GNU grep.

grep -E '^[0-9]{1,3}(\.[0-9]{1,3}){3}$' adressen.txt

Fall

08 von 09

journalctl zeigt nur die letzten Tage, obwohl mehr da war

Ein Vorfall von vor drei Wochen lässt sich nicht mehr nachlesen. Das Journal reicht nur bis zum letzten Neustart zurück.

Ursache. systemd-journald schreibt standardmäßig nach /run, also in den Arbeitsspeicher, wenn /var/log/journal fehlt. Nach einem Neustart ist der Teil weg. Zusätzlich greift eine Größenbegrenzung.

Prüfung. journalctl --disk-usage zeigt die belegte Größe, journalctl --list-boots die vorhandenen Starts. Fehlt der Ordner /var/log/journal, ist das Journal flüchtig.

Gegenmittel. Persistenz mit mkdir -p /var/log/journal und systemctl restart systemd-journald einschalten, danach eine Obergrenze in journald.conf setzen.

journalctl --list-boots | tail -n 5
journalctl -u nginx --since "2026-10-20" --until "2026-10-21"

Fall

09 von 09

pkill -f beendet die eigene Sitzung

Ein Aufruf, der einen Hintergrundprozess beenden soll, trennt die SSH-Verbindung. Der Prozess läuft weiter.

Ursache. Mit -f vergleicht pkill die vollständige Befehlszeile. Die eigene Shell hat den Suchbegriff als Argument in ihrer Kommandozeile und wird damit selbst zum Treffer.

Prüfung. pgrep -af muster zeigt vorher, welche Prozesse mit pid und Zeile treffen. Erscheint die eigene Shell in der Liste, ist das Muster zu weit gefasst.

Gegenmittel. Erst pgrep -af prüfen, dann mit pkill -f und einem engeren Muster arbeiten. In Skripten ist kill mit einer gespeicherten pid sicherer.

pgrep -af "worker --queue" 

Siehe auch

Weiter
  • Befehlstafel: die Formen, aus denen diese Fallen entstehen.
  • Musterkasten: Ketten, die die Fallen bereits umgehen.
  • Kontakt: eine Falle melden, die hier fehlt.