1 .\" Copyright (c) 1996 Andries Brouwer (aeb@cwi.nl)
3 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
9 .\" The GNU General Public License's references to "object code"
10 .\" and "executables" are to be interpreted as the output of any
11 .\" document formatting or typesetting system, including
12 .\" intermediate and printed output.
14 .\" This manual is distributed in the hope that it will be useful,
15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 .\" GNU General Public License for more details.
19 .\" You should have received a copy of the GNU General Public
20 .\" License along with this manual; if not, see
21 .\" <http://www.gnu.org/licenses/>.
24 .\" 5 Oct 2002, Modified by Michael Kerrisk <mtk.manpages@gmail.com>
25 .\" Updated for POSIX.1 2001
26 .\" 2004-12-17 Martin Schulze <joey@infodrom.org>, mtk
27 .\" Removed errno declaration prototype, added notes
28 .\" 2006-02-09 Kurt Wall, mtk
29 .\" Added non-POSIX errors
31 .\"*******************************************************************
33 .\" This file was generated with po4a. Translate the source file.
35 .\"*******************************************************************
37 .\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
38 .\" all rights reserved.
39 .\" Translated 1997-12-24, HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
40 .\" Updated 1999-03-01, NAKANO Takeo <nakano@apm.seikei.ac.jp>
41 .\" Updated 1999-08-21, NAKANO Takeo <nakano@apm.seikei.ac.jp>
42 .\" Updated 2003-07-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
43 .\" Updated 2005-03-15, Akihiro MOTOKI
44 .\" Updated 2006-02-15, Akihiro MOTOKI, Catch up to LDP v2.23
45 .\" Updated 2006-07-14, Akihiro MOTOKI, Catch up to LDP v2.34
46 .\" Updated 2008-08-07, Akihiro MOTOKI, Catch up to LDP v3.05
48 .TH ERRNO 3 2008\-07\-09 "" "Linux Programmer's Manual"
50 errno \- 直近に発生したエラーの番号
53 .\".BI "extern int " errno ;
54 \fB#include <errno.h>\fP
56 ヘッダファイル \fI<errno.h>\fP で整数型の変数 \fIerrno\fP が定義されており、
57 システムコールやいくつかのライブラリ関数は、エラーが発生した際に この変数にその原因を示す値を設定する。 この値は呼び出しの返り値がエラー
58 (ほとんどのシステムコールでは \-1 で、ほとんどのライブラリ関数では \-1 か NULL) を示したときに
59 のみ意味を持つが、ライブラリ関数は成功した場合も \fIerrno\fP を変更することが許されている。
61 有効なエラー番号はいずれも 0 以外の値を持つ。 どのシステムコールもライブラリ関数も \fIerrno\fP を 0 に設定することはない。
63 いくつかのシステムコールやライブラリ関数 (例えば \fBgetpriority\fP(2)) では、成功した場合の有効な返り値として \-1
64 が返されることがある。 このような場合、成功なのかエラーなのかを区別するためには、 呼び出しの前に \fIerrno\fP を 0
65 に設定しておけばよい。呼び出しの返り値がエラー発生の可能性を 示すものだった場合には、 \fIerrno\fP が 0 以外の値かを見て確認すればよい。
67 \fIerrno\fP は、ISO C standard で \fIint\fP 型の変更可能な左辺値 として定義されており、明示的に宣言を行ってはならない;
68 \fIerrno\fP はマクロの場合もありえる。 \fIerrno\fP はスレッド毎に値を持つ。 つまりあるスレッドで \fIerrno\fP が設定されても、
69 他のスレッドの \fIerrno\fP には影響しない。
71 POSIX.1 で定義されているすべてのエラー名には、 それぞれ異なる値が対応していなければならない。 但し、 \fBEAGAIN\fP と
72 \fBEWOULDBLOCK\fP は例外で、これらは同じ値を持ってもよい。
74 .\" The following is now
75 .\" POSIX.1 (2001 edition) lists the following symbolic error names. Of
76 .\" these, \fBEDOM\fP and \fBERANGE\fP are in the ISO C standard. ISO C
77 .\" Amendment 1 defines the additional error number \fBEILSEQ\fP for
78 .\" coding errors in multibyte or wide characters.
80 Below is a list of the symbolic error names that are defined on Linux. Some
81 of these are marked \fIPOSIX.1\fP, indicating that the name is defined by
82 POSIX.1\-2001, or \fIC99\fP, indicating that the name is defined by C99.
91 アドレスがすでに使用されている (POSIX.1)
94 .\" EADV is only an error on HURD(?)
98 アドレス・ファミリーがサポートされていない (POSIX.1)
101 リソースが一時的に利用不可 (\fBEWOULDBLOCK\fP と同じ値でもよい) (POSIX.1)
104 接続が既に処理中である (POSIX.1)
107 不正なやり取り (exchange) である
110 ファイルディスクリプタが不正である (POSIX.1)
116 メッセージが不正である (POSIX.1)
125 .\" EBFONT is defined but appears not to be used by kernel or glibc.
129 リソースが使用中である (POSIX.1)
132 操作がキャンセルされた (POSIX.1)
153 リソースのデッドロックを回避した (POSIX.1)
159 宛先アドレスが必要である (POSIX.1)
162 .\" EDOTDOT is defined but appears to be unused
163 数学関数で引き数が領域外である (out of domain)
166 .\" POSIX just says "Reserved"
167 ディスク・クォータ (quota) を超過した (POSIX.1)
182 ホストに到達不能である (POSIX.1)
188 不正なバイト列 (POSIX.1, C99)
194 関数呼び出しが割り込まれた (POSIX.1); \fBsignal\fP(7) 参照。
203 ソケットが接続されている (POSIX.1)
233 必要な共有ライブラリにアクセスできなかった
236 壊れた共有ライブラリにアクセスしようとした
239 リンクしようとした共有ライブラリが多過ぎる
242 a.out のライブラリセクションが壊れている (corrupted)
248 .\" ELNRNG is defined but appears to be unused
249 シンボリック・リンクの回数が多過ぎる (POSIX.1)
255 オープンされているファイルが多過ぎる (POSIX.1)
264 .\" POSIX says "Reserved"
265 マルチホップ (multihop) を試みた (POSIX.1)
268 .\" ENAVAIL is defined, but appears not to be used
272 ネットワークが不通である (POSIX.1)
275 接続がネットワーク側から中止された (POSIX.1)
278 ネットワークが到達不能である (POSIX.1)
281 .\" ENOANO is defined but appears to be unused.
282 システム全体でオープンされているファイルが多過ぎる (POSIX.1)
285 .\" ENOCSI is defined but appears to be unused.
286 使用可能なバッファ空間がない (POSIX.1 (XSI STREAMS option))
289 ストリームの読み出しキューの先頭に読み出し可能なメッセージがない (POSIX.1)
292 そのようなデバイスは無い (POSIX.1)
295 そのようなファイルやディレクトリは無い (POSIX.1)
298 実行ファイル形式のエラー (POSIX.1)
304 利用できるロックが無い (POSIX.1)
307 .\" POSIX says "Reserved"
314 十分な空きメモリ領域が無い (POSIX.1)
317 要求された型のメッセージが存在しない (POSIX.1)
326 指定されたプロトコルが利用できない (POSIX.1)
329 デバイスに空き領域が無い (POSIX.1)
332 指定されたストリーム・リソースが存在しない (POSIX.1 (XSI STREAMS option))
335 ストリームではない (POSIX.1 (XSI STREAMS option))
338 関数が実装されていない (POSIX.1)
344 ソケットが接続されていない (POSIX.1)
350 .\" ENOTNAM is defined but appears to be unused.
351 ディレクトリが空ではない (POSIX.1)
357 操作がサポートされていない (POSIX.1)
360 I/O 制御操作が適切でない (POSIX.1)
366 そのようなデバイスやアドレスはない (POSIX.1)
369 ソケットでサポートしていない操作である (POSIX.1)
371 (Linux では \fBENOTSUP\fP と \fBEOPNOTSUPP\fP は同じ値を持つが、 POSIX.1
372 に従えば両者のエラー値は区別されるべきである。)
375 指定されたデータ型に格納するには値が大き過ぎる (POSIX.1)
378 操作が許可されていない (POSIX.1)
381 サポートされていないプロトコルファミリーである
389 \fBEPROTONOSUPPORT\fP
390 プロトコルがサポートされていない (POSIX.1)
393 ソケットに指定できないプロトコル・タイプである (POSIX.1)
396 結果が大き過ぎる (POSIX.1, C99)
408 システムコールが中断され再スタートが必要である
411 読み出し専用のファイルシステムである (POSIX.1)
414 通信相手がシャットダウンされて送信できない
419 \fBESOCKTNOSUPPORT\fP
423 .\" ESRMNT is defined but appears not to be used
424 そのようなプロセスは無い (POSIX.1)
427 ファイルハンドルが古い状態になっている (POSIX.1)
429 NFS や他のファイルシステムで起こりうる。
435 時間が経過した (POSIX.1 (XSI STREAMS option))
437 (POSIX.1 では "STREAM \fBioctl\fP(2) timeout" と書かれている)
440 .\" ETOOMANYREFS is defined, but appears not to be used.
441 操作がタイムアウトした (POSIX.1)
444 テキストファイルが使用中である (POSIX.1)
447 Structure needs cleaning
450 プロトコルのドライバが付与 (attach) されていない
456 操作がブロックされる見込みである (\fBEAGAIN\fP と同じ値でもよい) (POSIX.1)
468 if (somecall() == \-1) {
469 printf("somecall() failed\en");
470 if (errno == ...) { ... }
475 このようにすると、参照している時点では \fIerrno\fP はもはや \fIsomecall\fP() から返された値を保持しているとは限らない
476 (\fBprintf\fP(3) により変更されているかもしれない)。 ライブラリコールをまたいで \fIerrno\fP
477 の値を保存したい場合は、以下のように保存しなければならない:
481 if (somecall() == \-1) {
483 printf("somecall() failed\en");
484 if (errsv == ...) { ... }
489 昔の C では、 \fI<errno.h>\fP をインクルードするのではなく \fIerrno\fP を手動で (\fIextern int
490 errno\fP のように) 定義するのが一般的であった。 \fBこのようなことはしないこと\fP。 こうすると、最近のバージョンの C
491 ライブラリでは正しく動作しないだろう。 しかし、(非常に) 古い UNIX システムでは、 \fI<errno.h>\fP
492 がなく、宣言が必要なことがあるかもしれない。
494 \fBerr\fP(3), \fBerror\fP(3), \fBperror\fP(3), \fBstrerror\fP(3)
496 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
497 である。プロジェクトの説明とバグ報告に関する情報は
498 http://www.kernel.org/doc/man\-pages/ に書かれている。