終了ステータス

bash の終了ステータスの範囲は 0 から 255 で、0 は正常終了、それ以外は異常終了である。 範囲外の整数が exit に渡された場合、終了ステータスは 256 の剰余となる。 直前のコマンドの終了ステータスは $? で取得でき、if, &&, || などの制御演算子で利用できる。

以下の終了ステータスが予約されている。[3]

C言語では、main関数からの復帰で整数値を返すことで成功か失敗かを通知することができ、そのためのマクロEXIT_SUCCESSとEXIT_FAILUREもある。POSIXではEXIT_SUCCESSは0、EXIT_FAILUREは1とされている[4]。また exit() 関数で整数値や上述のマクロを引数に指定することで終了ステータスを指定することもできる。

EXIT_SUCCESSとEXIT_FAILUREを除けば、Cの標準ではリターンコードの意味を全く定義していない。したがって、リターンコードについての規則はプラットフォームによって異なる。

Javaでは、セキュリティマネージャが禁止していない限り、任意のメソッドから System.exit(int status) を呼び出すことができる。それによって動作中のJava仮想マシンが終了する。引数はステータスコードとして扱われ、慣習的にゼロでないステータスコードは異常終了を表すものとされている[5]。

Unix系では、waitシステムコールがセットするステータスは子プロセスの終了時の各種情報をまとめたビットフィールドで構成されている。子プロセスが正常終了した場合（WIFEXITEDマクロで判定する。他にはシグナル受信で終了させられる場合がある）、SUSではステータスの下位8ビットが子プロセスが設定した終了ステータスを示すことになっている[6]。その値は wait.h に定義されたマクロ WEXITSTATUS で取得することができる。このため、Unix系の終了ステータスの値は0から255まで（8ビット符号なし整数）に限られている（それ以上の値を指定しても親プロセス側が下位8ビットしか受け取れない）。

慣習的に正常終了時はゼロ、異常終了時はゼロ以外を返すのが一般的である[7]。各種エラーコードの意味について規約を定めようとした例もある。例えばGNUは上位ビットを深刻なエラーを示すために予約することを推奨している[4]。BSDではさらに細かく推奨される解釈を文書化している[8][9][10]。

DOSでは終了ステータスをエラーレベルとも呼ぶ。通常、0から255までの値をとる。バッチファイルで終了ステータスを参照するコマンドとしてERRORLEVELがあり、指定した値以上かどうかで判断するようになっている。

OpenVMSでは、正常終了を奇数値、異常終了を偶数値で表す。終了スタータスは32ビット整数だが、サブフィールドに分割されており、制御ビット群、ファシリティ番号、メッセージ番号、深刻度で構成される。深刻度の値は正常 (Success, Informational) と異常 (Warning, Error, Fatal) に分けられる[11]。

Windowsでは終了コードとして32ビット符号付き整数を使用する[12]。プロセスの初期化時点で失敗した場合、Windowsのシステムエラーコードが返される[13]。Windowsのシステムエラーコードはオンラインで公開されている[14]。

cmd.exeの errorlevel はCOMMAND.COMのそれをそのまま継承している。.NET Framework のプロセスと Windows PowerShell は終了ステータスを Process オブジェクトの ExitCode 属性として参照する。