Exit-Codes

Teil des Abschnitts Grundlagen der Assembly-Journey von Coddy. Lektion 33 von 45.

Wenn dein Programm beendet wird, sendet es eine kleine Zahl an das Betriebssystem zurück. Diese Zahl wird als exit code oder exit status bezeichnet.

Warum Exit-Codes wichtig sind:

Skripte verwenden Exit-Codes, um zu überprüfen, ob ein Programm erfolgreich war. Beispielsweise fährt ein Backup-Skript möglicherweise nur fort, wenn der vorherige Befehl erfolgreich war.

Exit-Codes helfen ebenfalls beim Debugging. Du kannst unterschiedliche Fehlercodes für verschiedene Probleme verwenden.

Du kannst Programme auch miteinander verketten, sodass ein Programm nur ausgeführt wird, wenn das vorherige erfolgreich war. Die Shell überprüft den Exit-Code, bevor sie den nächsten Befehl ausführt.

Die Regeln für Exit-Codes:

Exit-Code	Bedeutung
0	Success: Alles hat funktioniert
1-255	Etwas ist schiefgelaufen

Fehlercodes auswählen:

Du kannst eine beliebige Zahl von 1 bis 255 verwenden. Was die jeweilige Zahl bedeutet, liegt bei dir als Programmierer.

Exit-Code	Was du möglicherweise meinst
1	Allgemeiner Fehler
2	Eingabedatei fehlt
3	Zugriff verweigert
4	Netzwerkfehler

Was passiert, wenn du keinen Exit-Code festlegst?

Du musst rdi vor dem exit-Syscall immer setzen. Wenn du das vergisst, enthält rdi den zufälligen Wert, der im Register zurückgeblieben ist, und dein Programm wird mit einem zufälligen Code beendet.

Aufgabe

Schreibe ein vollständiges Assembly-Programm, das mit dem Exit-Code 2 beendet wird (um „file not found“ zu signalisieren).

Der Print-Code wird dir bereitgestellt. Du musst nur den Exit-Syscall hinzufügen.

Probier es selbst

section .data
    msg db 'Backup complete', 0x0a
    msgLen equ $ - msg

section .text
    global _start

_start:
    ; Nachricht ausgeben (vom Test-Harness bereitgestellt)
    mov rax, 1
    mov rdi, 1
    mov rsi, msg
    mov rdx, msgLen
    syscall

    ; Hier kommt der Code des Studenten hin
    %include "solution.asm"