終了ステータス

AmigaOS、MorphOS、AROSでは、4つのレベルが定義されています。

1. OK 0
2. 警告5
3. エラー10
4. 失敗20

シェルスクリプトは通常、コマンドを実行し、その終了ステータスを取得します。

シェルの目的上、終了ステータスがゼロで終了するコマンドは成功したとみなされます。ゼロ以外の終了ステータスは失敗を示します。この一見直感に反するスキームは、成功を示す明確な方法が1つあり、さまざまな失敗モードを示す方法が複数あるようにするために使用されています。コマンドが番号が のシグナルによって終了するとN、シェルは変数を$?128 より大きい値に設定します。ほとんどのシェルは128+Nを使用しますが、ksh93 は256+Nを使用します。

コマンドが見つからない場合、シェルはステータス127を返す必要があります。コマンドが見つかったが実行できない場合は、戻りステータスは126 である必要があります。^{[ 2 ]}ただし、これはすべてのシェルに当てはまるわけではありません。

展開またはリダイレクト中のエラーが原因でコマンドが失敗した場合、終了ステータスはゼロより大きい値になります。

CおよびC++プログラミング言語では、メイン関数から終了または戻るプログラムが、整数を返すか、マクロとを返すことで、成功または失敗を通知することができます。Unix ライクなシステムでは、これらはそれぞれ と に等しくなります。[ ^{3 ] AC}プログラムは、最初のパラメータとして整数ステータスまたは終了マクロを指定する関数を使用することもできます。これにより、プログラムが停止します。EXIT_SUCCESSEXIT_FAILURE01exit()

からの戻り値は関数mainに渡されexit、値がゼロの場合は、EXIT_SUCCESSまたは正常終了または異常終了EXIT_FAILUREの「実装定義形式」に変換される場合があります。

0マクロとを除きEXIT_SUCCESS、EXIT_FAILUREC標準では戻りコードの意味は定義されていません。戻りコードの使用に関する規則はプラットフォームによって異なります（プラットフォーム固有のセクションを参照してください）。

C#では、Main()メソッドは通常、型を返しません (型はvoid、またはの場合async、ですSystem.Threading.Tasks.Task)。ただし、は、オペレーティングシステムに返されるMain()型の戻り値型を示す場合があります。メソッドがとして宣言されている場合、代わりにが返されます。^{[ 4 ]}intMain()asyncSystem.Threading.Tasks.Task<int>

DOS の用語では、エラーレベルは実行可能プログラムまたはサブルーチンによって返される整数の終了コードです。エラーレベルは通常0から255の範囲です。^{[ 5 ] [ 6 ] [ 7 ] [ 8 ]} DOSでは256 個のエラーコードしか使用できませんが、DR DOS 6.0以降では、少なくともCONFIG.SYSで 16 ビットのエラーコードがサポートされています。^{[ 7 ]} 4DOSおよび DR-DOS COMMAND.COMでは、終了コード (バッチジョブ内) はEXIT n ^{[ 7 ]}で、また ( CONFIG.SYS内) はERROR= nで設定できます。^{[ 7 ]}

終了ステータスは、バッチ プログラムによってIF ERRORLEVELコマンドで取得されることがよくあります。^{[ 5 ] [ 7 ]}マルチユーザーDOS は、アプリケーションから戻ると自動的に更新される予約済みの環境変数%ERRORLVL%をサポートしています。DR -DOS 7.02以降のCOMMAND.COM は、同様の擬似環境変数%ERRORLVL%と%ERRORLEVEL%をサポートしています。CONFIG.SYSでは、DR DOS 6.0 以降はONERRORを使用してデバイス ドライバのロード ステータスと戻りコード、およびプログラムの終了コードをテストします。^{[ 7 ]} 

Javaでは、main()終了コードは示されないため、必要に応じて、終了コードは を介し​​て手動で指定されjava.lang.System::exit()、これによりプログラムと JVM が終了します。System.exit()セキュリティマネージャが許可しない限り、どのメソッドでも を呼び出すことができます。引数はステータス コードとして機能します。慣例として、ゼロ以外のステータス コードは異常終了を示します。^{[ 9 ]}

OpenVMSでは、奇数値は成功、偶数値は失敗を示します。値は32ビット整数で、制御ビット、施設番号、メッセージ番号、重大度というサブフィールドがあります。重大度値は、成功（成功、情報）と失敗（警告、エラー、致命的）に分けられます。^{[ 10 ]}

Plan 9 の C では、終了ステータスはexits()関数に渡される文字列によって示され、関数main()はvoid型です。

Unixやその他のPOSIX 互換システムでは、親プロセスはPOSIX ヘッダーwait()で定義されているシステムコール群を使用して子プロセスの終了ステータスを取得できます。^{[ 11 ]} これらのうち、^{[ 12 ]}コールは完全な終了ステータスを取得しますが、古いコールと^{[ 13 ]}コールは終了ステータスの最下位 8 ビットのみを取得します。<wait.h>waitid()wait()waitpid()

およびインターフェースは、さまざまな種類の子終了情報を含むビットフィールドとしてパックされたタイプのステータス値を設定しますwait()。子が終了によって終了した場合（マクロによって決定されます。通常は、捕捉されないシグナルによって終了した場合）、SUSは、マクロを使用してステータス値から終了ステータスの下位8ビットを取得できると規定しています。waitpid()intWIFEXITED()WEXITSTATUS()

システムコール（SUSv1で追加）ではwaitid()、子終了ステータスやその他の情報はビットフィールドではなく、型の構造体に格納されるようになったsiginfo_t。^{[ 14 ]}

POSIX互換システムでは、通常、成功にはゼロ、エラーにはゼロ以外の値を使用する慣例が用いられます。^{[ 15 ]} さまざまなエラーコードの相対的な意味については、いくつかの慣例が発展してきました。たとえば、GNUでは、最上位ビットがセットされたコードは重大なエラーのために予約しておくことを推奨しています。^{[ 3 ]}

BSD 由来の OS は、推奨される解釈の広範なセットを定義しています。15 個のステータス コード 64 ～ 78 の意味は POSIX ヘッダーで定義されています<sysexits.h>。^{[ 16 ]}これらは歴史的にsendmailやその他のメッセージ転送エージェントに由来しますが、その後、他の多くのプログラムでも使用されるようになりました。^{[ 17 ]} これは非推奨であり、使用は推奨されていません。^{[ 16 ]}

高度なBashスクリプトガイドには、0以外の終了ステータスコードの意味に関する情報がいくつかあります。^{[ 18 ]}

Rustでは、main()トレイトを実装する任意の型を返すことができますstd::process::Termination。^{[ 19 ]}

Rustランタイム内部では、これらはlibc::EXIT_SUCCESS実行が成功した場合とlibc::EXIT_FAILURE失敗した場合にそれぞれ値を返します。

Rust標準ライブラリでは、以下の型に実装がありますstd::process::Termination。

• !（決してないタイプ）
• ()（ユニットタイプ）
• std::convert::Infallible
• std::process::ExitCode（定数とをSUCCESS含むFAIL）
• std::result::Result<T, E>

^{[ 20 ]}

Microsoft Windows は、終了コードとして 32 ビットの符号なし整数を使用しますが、^{[ 21 ] [ 22 ]}コマンド インタプリタはそれらを符号付きとして扱います。^{[ 23 ]}

終了コードは、例えば、DOSから受け継がれた用語で、コマンドラインインタープリタCMD.exeなどによって直接参照されます。.NET FrameworkプロセスやWindows PowerShellでは、オブジェクトのプロパティとして参照されます。errorlevelExitCodeProcess