Bash-Befehlszeilen-Exit-Codes entmystifiziert

Hinweis: Sie sehen oft Exit-Code als Ausgangsstatus bezeichnet oder sogar als Ausgangsstatuscodes . Die Begriffe werden austauschbar verwendet, außer in der Dokumentation. Hoffentlich ist Ihnen meine Verwendung der beiden Begriffe klar.

Ich bin kein Programmierer. Es fällt mir schwer, das zuzugeben, aber es ist wahr. Ich habe sowohl formal als auch informell BASIC, FORTRAN und einige andere Sprachen studiert, und ich muss sagen, dass ich definitiv kein Programmierer bin. Oh sicher, ich kann ein wenig in PHP, Perl, Bash und sogar PowerShell Skripte schreiben und programmieren (ja, ich bin auch ein Windows-Administrator), aber ich könnte nie meinen Lebensunterhalt mit dem Programmieren verdienen, weil ich zu langsam beim Schreiben von Code bin und Trial-and-Error ist keine effiziente Debugging-Strategie. Es ist wirklich traurig, aber ich bin so kompetent darin, gefundenen Code zu kopieren und anzupassen, dass ich meine erforderlichen Aufgaben erfüllen kann. Und doch verwende ich auch Exit-Codes, um herauszufinden, wo meine Probleme liegen und warum etwas schief läuft.

[ Das könnte Ihnen auch gefallen:Ein kleiner Zauber zum Kopieren von SSH-Dateien in der Befehlszeile. ]

Exit-Codes sind bis zu einem gewissen Grad nützlich, können aber auch vage sein. Beispielsweise ist ein Exit-Code von 1 ein generischer Bucket für verschiedene Fehler und überhaupt nicht hilfreich. In diesem Artikel erkläre ich die Handvoll reservierter Fehlercodes , wie sie auftreten können und wie Sie sie verwenden, um herauszufinden, was Ihr Problem ist. Ein reservierter Fehlercode wird von Bash verwendet und Sie sollten keine eigenen Fehlercodes erstellen, die damit in Konflikt stehen.

Genug Hintergrundgeschichte. Es ist an der Zeit, sich Beispiele anzusehen, was Fehlercodes/Status generiert.

Extrahieren des schwer fassbaren Exit-Codes

Verwenden Sie den folgenden Befehl, um den Exit-Code für den letzten Befehl anzuzeigen, den Sie in der Befehlszeile ausgeführt haben:

$ echo $?

Die angezeigte Antwort enthält keinen Pomp oder Umstand. Es ist einfach eine Zahl. Möglicherweise erhalten Sie auch eine Shell-Fehlermeldung von Bash, die den Fehler weiter beschreibt, aber der Exit-Code und der Shell-Fehler zusammen sollten Ihnen dabei helfen, herauszufinden, was schief gelaufen ist.

Ausgangsstatus 0

Ein Exit-Status von 0 ist im Allgemeinen das bestmögliche Szenario. Es teilt Ihnen mit, dass Ihr letzter Befehl oder Ihr letztes Skript erfolgreich ausgeführt wurde. Der Erfolg ist relativ, da der Exit-Code Sie nur darüber informiert, dass das Skript oder der Befehl ordnungsgemäß ausgeführt wurde, aber der Exit-Code sagt Ihnen nicht, ob die darin enthaltenen Informationen einen Wert haben. Beispiele veranschaulichen besser, was ich beschreibe.

Listen Sie beispielsweise Dateien in Ihrem Home-Verzeichnis auf. Ich habe nichts in meinem Home-Verzeichnis außer versteckten Dateien und Verzeichnissen, also gibt es hier nichts zu sehen, aber der Exit-Code kümmert sich um nichts anderes als um den Erfolg der Befehlsausführung:

$ ls
$ echo $?
0

Der Exit-Code von 0 bedeutet, dass der ls Befehl lief ohne Probleme. Auch hier bieten mir die Informationen aus dem Exit-Code keinen wirklichen Wert.

Führen Sie nun ls aus Befehl auf /etc Verzeichnis und zeigen Sie dann den Exit-Code an:

$ ls /etc
**Many files**
$ echo $?
0

Sie können sehen, dass jede erfolgreiche Ausführung zu einem Exit-Code von 0 führt, einschließlich etwas, das völlig falsch ist, wie z. B. das Ausgeben des cat Befehl für eine ausführbare Binärdatei wie ls Befehl: 

$ cat /usr/bin/ls
**A lot of screen gibberish and beeping**
$ echo $?
0

Ausgangsstatus 1

Verwenden Sie das obige Beispiel, aber fügen Sie die lange Auflistung und rekursive Optionen hinzu (-lR ), erhalten Sie einen neuen Exit-Code von 1:

$ ls -lR /etc
**A lengthy list of files**
$ echo $?
1

Obwohl die Ausgabe des Befehls so aussieht, als ob alles gut gelaufen wäre, sehen Sie beim Scrollen nach oben mehrere Fehler "Berechtigung verweigert" in der Liste. Diese Fehler führen zu einem Exit-Status von 1, was als "unzulässige Vorgänge" bezeichnet wird. Obwohl Sie vielleicht erwarten, dass der Fehler „Berechtigung verweigert“ zu einem Exit-Status von 1 führt, liegen Sie falsch, wie Sie im nächsten Abschnitt sehen werden.

Eine Division durch Null ergibt jedoch einen Exit-Status von 1. Sie erhalten außerdem eine Fehlermeldung von der Shell, die Sie darüber informiert, dass die von Ihnen durchgeführte Operation "unzulässig:"

$ let a=1
$ let b=0
$ let c=a/b
-bash: let: c=a/b: division by 0 (error token is "b")
$ echo $?
1

Ohne einen Shell-Fehler ist ein Exit-Status von 1 nicht sehr hilfreich, wie Sie am ersten Beispiel sehen können. Im zweiten Beispiel wissen Sie, warum Sie den Fehler erhalten haben, weil Bash es Ihnen mit einer Shell-Fehlermeldung mitteilt. Wenn Sie einen Exit-Status von 1 erhalten, suchen Sie im Allgemeinen nach unzulässigen Vorgängen (Berechtigung verweigert Nachrichten) gemischt mit Ihren Erfolgen (z. B. das Auflisten aller Dateien unter /etc , wie im ersten Beispiel in diesem Abschnitt).

Ausgangsstatus 2

Wie oben erwähnt, führt eine Shell-Warnung „Permission denied“ zu einem Exit-Status von 2 statt 1. Um sich das selbst zu beweisen, versuchen Sie, Dateien in /root aufzulisten :

$ ls /root
ls: cannot open directory '/root': Permission denied
$ echo $?
2

Exit-Status 2 wird angezeigt, wenn ein Berechtigungsproblem oder ein fehlendes Schlüsselwort in einem Befehl oder Skript vorliegt. Ein Beispiel für ein fehlendes Schlüsselwort ist das Vergessen, ein done hinzuzufügen im do eines Skripts Schleife. Die beste Methode zum Debuggen von Skripts mit diesem Exit-Status besteht darin, Ihren Befehl in einer interaktiven Shell abzusetzen, um die erhaltenen Fehler anzuzeigen. Diese Methode zeigt im Allgemeinen, wo das Problem liegt.

Berechtigungsprobleme sind etwas weniger schwierig zu entschlüsseln und zu debuggen als andere Arten von Problemen. Das einzige, was "Berechtigung verweigert" bedeutet, ist, dass Ihr Befehl oder Skript versucht, eine Berechtigungsbeschränkung zu verletzen.

Ausgangsstatus 126

Exit-Status 126 ist ein interessanter Berechtigungsfehlercode. Der einfachste Weg, um zu demonstrieren, wann dieser Code erscheint, besteht darin, eine Skriptdatei zu erstellen und zu vergessen, dieser Datei Ausführungsberechtigungen zu erteilen. Hier ist das Ergebnis:

$ ./blah.sh
-bash: ./blah.sh: Permission denied
$ echo $?
126

Dieses Berechtigungsproblem ist kein Zugriffsproblem, sondern eines der Einstellung, wie im Modus. Um diesen Fehler zu beseitigen und stattdessen einen Exit-Status von 0 zu erhalten, geben Sie chmod +x blah.sh aus .

$ blah.sh
-bash: blah.sh: command not found
$ echo $?
127

$ bash
$ exit 261
exit
$ echo $?
5

$ bash
$ exit 256
exit
$ echo $?
0

$ ls -lR /
**Lots of files scrolling by**
^C
$ echo $?
130

$ ip
**Usage info for the ip command**
  
$ echo $?
255