SYSEXITS

Section: C Library Functions (3)
索引 jman

BSD mandoc

索引

名称

sysexits - プログラムの望ましい終了コード

索引

書式

In sysexits.h

索引

解説

style(9) によれば、プログラムを終了するときに失敗の状態を示すために任意の値を使って exit(3) を呼び出すのは、よいやり方ではありません。代りに、 sysexits からの事前に定義された終了コードを使うべきであり、そうすればプロセスの呼び出し者はソースコードを調べなくても失敗クラスをおおよそ推定することができます。

無事に終了したことは、常にステータス 0 または EX_OK によって示されます。任意のプログラムが常に返す可能性のあるその他の終了ステータスと衝突する可能性を減らすために、エラー番号は EX__BASE から始まります。コードの意味は、おおよそ次に示す通りです：

EX_USAGE (64): コマンドが不正に使用されました。例えば、引数の数の誤り、誤ったフラグ、パラメータの誤った構文など。
EX_DATAERR (65): 入力データがどこかで不正です。これは、ユーザデータのみに使用する必要があり、システムファイルには使用すべきではありません。
EX_NOINPUT (66): 入力ファイル (システムファイルではなく) が存在しないか、または読み取り可能ではありません。これには、メーラに対する ``message '' のようなエラーも含まれます (このようなエラーまで捕えようとする場合)。
EX_NOUSER (67): ユーザが指定したものは存在しません。これは、メールアドレスやリモートログインに使用することができます。
EX_NOHOST (68): ホストが指定したものは存在しません。これは、メールアドレスやネットワークリクエストに使用することができます。
EX_UNAVAILABLE (69): そのサービスは利用できません。これは、サポートプログラムやファイルが存在しない場合に起きます。これは、何かやりたいことができないで、その理由が分からないときのキャッチコールメッセージとして使うこともできます。
EX_SOFTWARE (70): 内部ソフトウェアエラーが検出されました。これは、できるだけオペレーティングシステム関連ではないエラーに限る必要があります。
EX_OSERR (71): オペレーティングシステムエラーが検出されました。これは、 ``分岐できない、'' ``パイプを作成できない'' などのようなエラーに使うよう意図されています。これには、 passwd ファイルに存在しないユーザに対して getuid を返すようなものも含まれます。
EX_OSFILE (72): システムファイルのどれか (例えば、 /etc/passwd 、 /var/run/utmp など) が存在しないか、開けないか、または何らかのエラー (例えば、構文エラー) があります。
EX_CANTCREAT (73): (ユーザ指定の) 出力ファイルが作成できません。
EX_IOERR (74): いずれかのファイルに対して I/O 操作中にエラーが起きました。
EX_TEMPFAIL (75): 一時的な失敗で、本当のエラーではないことを示します。 sendmail では、これはメーラが (例えば) 接続を確立できず、リクエストは後で再試行する必要があることを意味します。
EX_PROTOCOL (76): リモートシステムがプロトコル交換の間に「可能でない」何かを返しました。
EX_NOPERM (77): その操作を実行するために十分な許可を持っていません。これは、ファイルシステムの問題のためではなく、より高いレベルの許可のために意図されています。ファイルシステムに対しては、 EX_NOINPUT または EX_CANTCREAT を使用すべきです。
EX_CONFIG (78): 何かがコンフィギュレーションされていない、またはコンフィギュレーションが間違っている状態にあります。