OSDN Git Service

Retire LDP man-pages repository
[linuxjm/LDP_man-pages.git] / release / man3 / errno.3
diff --git a/release/man3/errno.3 b/release/man3/errno.3
deleted file mode 100644 (file)
index bd16cea..0000000
+++ /dev/null
@@ -1,500 +0,0 @@
-.\" Copyright (c) 1996 Andries Brouwer (aeb@cwi.nl)
-.\"
-.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
-.\" This is free documentation; you can redistribute it and/or
-.\" modify it under the terms of the GNU General Public License as
-.\" published by the Free Software Foundation; either version 2 of
-.\" the License, or (at your option) any later version.
-.\"
-.\" The GNU General Public License's references to "object code"
-.\" and "executables" are to be interpreted as the output of any
-.\" document formatting or typesetting system, including
-.\" intermediate and printed output.
-.\"
-.\" This manual is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-.\" GNU General Public License for more details.
-.\"
-.\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, see
-.\" <http://www.gnu.org/licenses/>.
-.\" %%%LICENSE_END
-.\"
-.\" 5 Oct 2002, Modified by Michael Kerrisk <mtk.manpages@gmail.com>
-.\"    Updated for POSIX.1 2001
-.\" 2004-12-17 Martin Schulze <joey@infodrom.org>, mtk
-.\"    Removed errno declaration prototype, added notes
-.\" 2006-02-09 Kurt Wall, mtk
-.\"     Added non-POSIX errors
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
-.\"     all rights reserved.
-.\" Translated 1997-12-24, HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
-.\" Updated 1999-03-01, NAKANO Takeo <nakano@apm.seikei.ac.jp>
-.\" Updated 1999-08-21, NAKANO Takeo <nakano@apm.seikei.ac.jp>
-.\" Updated 2003-07-03, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2005-03-15, Akihiro MOTOKI
-.\" Updated 2006-02-15, Akihiro MOTOKI, Catch up to LDP v2.23
-.\" Updated 2006-07-14, Akihiro MOTOKI, Catch up to LDP v2.34
-.\" Updated 2008-08-07, Akihiro MOTOKI, Catch up to LDP v3.05
-.\"
-.TH ERRNO 3 2015\-01\-22 "" "Linux Programmer's Manual"
-.SH 名前
-errno \- 直近に発生したエラーの番号
-.SH 書式
-.\".sp
-.\".BI "extern int " errno ;
-\fB#include <errno.h>\fP
-.SH 説明
-ヘッダーファイル \fI<errno.h>\fP で整数型の変数 \fIerrno\fP が定義されており、
-システムコールやいくつかのライブラリ関数は、エラーが発生した際に この変数にその原因を示す値を設定する。 この値は呼び出しの返り値がエラー
-(ほとんどのシステムコールでは \-1 で、ほとんどのライブラリ関数では \-1 か NULL) を示したときに
-のみ意味を持つが、ライブラリ関数は成功した場合も \fIerrno\fP を変更することが許されている。
-
-有効なエラー番号はいずれも 0 以外の値を持つ。 どのシステムコールもライブラリ関数も \fIerrno\fP を 0 に設定することはない。
-
-いくつかのシステムコールやライブラリ関数 (例えば \fBgetpriority\fP(2))  では、成功した場合の有効な返り値として \-1
-が返されることがある。 このような場合、成功なのかエラーなのかを区別するためには、 呼び出しの前に \fIerrno\fP を 0
-に設定しておけばよい。呼び出しの返り値がエラー発生の可能性を 示すものだった場合には、 \fIerrno\fP が 0 以外の値かを見て確認すればよい。
-
-\fIerrno\fP は、ISO C standard で \fIint\fP 型の変更可能な左辺値 として定義されており、明示的に宣言を行ってはならない;
-\fIerrno\fP はマクロの場合もありえる。 \fIerrno\fP はスレッド毎に値を持つ。 つまりあるスレッドで \fIerrno\fP が設定されても、
-他のスレッドの \fIerrno\fP には影響しない。
-
-POSIX.1 で定義されているすべてのエラー名には、 それぞれ異なる値が対応していなければならない。 但し、 \fBEAGAIN\fP と
-\fBEWOULDBLOCK\fP は例外で、これらは同じ値を持ってもよい。
-
-.\" The following is now
-.\" POSIX.1 (2001 edition) lists the following symbolic error names.  Of
-.\" these, \fBEDOM\fP and \fBERANGE\fP are in the ISO C standard.  ISO C
-.\" Amendment 1 defines the additional error number \fBEILSEQ\fP for
-.\" coding errors in multibyte or wide characters.
-.\"
-Below is a list of the symbolic error names that are defined on Linux.  Some
-of these are marked \fIPOSIX.1\fP, indicating that the name is defined by
-POSIX.1\-2001, or \fIC99\fP, indicating that the name is defined by C99.
-.TP  16
-\fBE2BIG\fP
-引き数リストが長過ぎる (POSIX.1)
-.TP 
-\fBEACCES\fP
-許可がない (POSIX.1)
-.TP 
-\fBEADDRINUSE\fP
-アドレスがすでに使用されている (POSIX.1)
-.TP 
-\fBEADDRNOTAVAIL\fP
-.\" EADV is only an error on HURD(?)
-アドレスが使用できない (POSIX.1)
-.TP 
-\fBEAFNOSUPPORT\fP
-アドレスファミリーがサポートされていない (POSIX.1)
-.TP 
-\fBEAGAIN\fP
-リソースが一時的に利用不可 (\fBEWOULDBLOCK\fP と同じ値でもよい) (POSIX.1)
-.TP 
-\fBEALREADY\fP
-接続が既に処理中である (POSIX.1)
-.TP 
-\fBEBADE\fP
-不正なやり取り (exchange) である
-.TP 
-\fBEBADF\fP
-ファイルディスクリプターが不正である (POSIX.1)
-.TP 
-\fBEBADFD\fP
-ファイルディスクリプターが不正な状態である
-.TP 
-\fBEBADMSG\fP
-メッセージが不正である (POSIX.1)
-.TP 
-\fBEBADR\fP
-不正なリクエストディスクリプター
-.TP 
-\fBEBADRQC\fP
-不正なリクエストコード
-.TP 
-\fBEBADSLT\fP
-.\" EBFONT is defined but appears not to be used by kernel or glibc.
-不正なスロット
-.TP 
-\fBEBUSY\fP
-リソースが使用中である (POSIX.1)
-.TP 
-\fBECANCELED\fP
-操作がキャンセルされた (POSIX.1)
-.TP 
-\fBECHILD\fP
-子プロセスが無い (POSIX.1)
-.TP 
-\fBECHRNG\fP
-チャンネル番号が範囲外である
-.TP 
-\fBECOMM\fP
-送信時に通信エラーが発生した
-.TP 
-\fBECONNABORTED\fP
-接続が中止された (POSIX.1)
-.TP 
-\fBECONNREFUSED\fP
-接続が拒否された (POSIX.1)
-.TP 
-\fBECONNRESET\fP
-接続がリセットされた (POSIX.1)
-.TP 
-\fBEDEADLK\fP
-リソースのデッドロックを回避した (POSIX.1)
-.TP 
-\fBEDEADLOCK\fP
-\fBEDEADLK\fP の同義語
-.TP 
-\fBEDESTADDRREQ\fP
-宛先アドレスが必要である (POSIX.1)
-.TP 
-\fBEDOM\fP
-.\" EDOTDOT is defined but appears to be unused
-数学関数で引き数が領域外である (out of domain)
-.TP 
-\fBEDQUOT\fP
-.\" POSIX just says "Reserved"
-ディスククォータ (quota) を超過した (POSIX.1)
-.TP 
-\fBEEXIST\fP
-ファイルが存在する (POSIX.1)
-.TP 
-\fBEFAULT\fP
-アドレスが不正である (POSIX.1)
-.TP 
-\fBEFBIG\fP
-ファイルが大き過ぎる (POSIX.1)
-.TP 
-\fBEHOSTDOWN\fP
-ホストがダウンしている
-.TP 
-\fBEHOSTUNREACH\fP
-ホストに到達不能である (POSIX.1)
-.TP 
-\fBEIDRM\fP
-識別子が削除された (POSIX.1)
-.TP 
-\fBEILSEQ\fP
-不正なバイト列 (POSIX.1, C99)
-.TP 
-\fBEINPROGRESS\fP
-操作が実行中である (POSIX.1)
-.TP 
-\fBEINTR\fP
-関数呼び出しが割り込まれた (POSIX.1); \fBsignal\fP(7)  参照。
-.TP 
-\fBEINVAL\fP
-引数が無効である (POSIX.1)
-.TP 
-\fBEIO\fP
-入出力エラー (POSIX.1)
-.TP 
-\fBEISCONN\fP
-ソケットが接続されている (POSIX.1)
-.TP 
-\fBEISDIR\fP
-ディレクトリである (POSIX.1)
-.TP 
-\fBEISNAM\fP
-名前付きのファイルである
-.TP 
-\fBEKEYEXPIRED\fP
-鍵が期限切れとなった
-.TP 
-\fBEKEYREJECTED\fP
-鍵がサーバにより拒否された
-.TP 
-\fBEKEYREVOKED\fP
-鍵が無効となった
-.TP 
-\fBEL2HLT\fP
-停止 (レベル 2)
-.TP 
-\fBEL2NSYNC\fP
-同期できていない (レベル 2)
-.TP 
-\fBEL3HLT\fP
-停止 (レベル 3)
-.TP 
-\fBEL3RST\fP
-停止 (レベル 3)
-.TP 
-\fBELIBACC\fP
-必要な共有ライブラリにアクセスできなかった
-.TP 
-\fBELIBBAD\fP
-壊れた共有ライブラリにアクセスしようとした
-.TP 
-\fBELIBMAX\fP
-リンクしようとした共有ライブラリが多過ぎる
-.TP 
-\fBELIBSCN\fP
-a.out のライブラリセクションが壊れている (corrupted)
-.TP 
-\fBELIBEXEC\fP
-共有ライブラリを直接実行できなかった
-.TP 
-\fBELOOP\fP
-.\" ELNRNG is defined but appears to be unused
-シンボリックリンクの回数が多過ぎる (POSIX.1)
-.TP 
-\fBEMEDIUMTYPE\fP
-間違ったメディア種別である
-.TP 
-\fBEMFILE\fP
-オープンしているファイルが多過ぎる (POSIX.1)。 通常は \fBgetrlimit\fP(2) に説明があるリソース上限
-\fBRLIMIT_NOFILE\fP を超過した場合に発生する。
-.TP 
-\fBEMLINK\fP
-リンクが多過ぎる (POSIX.1)
-.TP 
-\fBEMSGSIZE\fP
-メッセージが長過ぎる (POSIX.1)
-.TP 
-\fBEMULTIHOP\fP
-.\" POSIX says "Reserved"
-マルチホップ (multihop) を試みた (POSIX.1)
-.TP 
-\fBENAMETOOLONG\fP
-.\" ENAVAIL is defined, but appears not to be used
-ファイル名が長過ぎる (POSIX.1)
-.TP 
-\fBENETDOWN\fP
-ネットワークが不通である (POSIX.1)
-.TP 
-\fBENETRESET\fP
-接続がネットワーク側から中止された (POSIX.1)
-.TP 
-\fBENETUNREACH\fP
-ネットワークが到達不能である (POSIX.1)
-.TP 
-\fBENFILE\fP
-.\" ENOANO is defined but appears to be unused.
-システム全体でオープンされているファイルが多過ぎる (POSIX.1)
-.TP 
-\fBENOBUFS\fP
-.\" ENOCSI is defined but appears to be unused.
-使用可能なバッファー空間がない (POSIX.1 (XSI STREAMS option))
-.TP 
-\fBENODATA\fP
-ストリームの読み出しキューの先頭に読み出し可能なメッセージがない (POSIX.1)
-.TP 
-\fBENODEV\fP
-そのようなデバイスは無い (POSIX.1)
-.TP 
-\fBENOENT\fP
-そのようなファイルやディレクトリは無い (POSIX.1)
-.TP 
-\fBENOEXEC\fP
-実行ファイル形式のエラー (POSIX.1)
-.TP 
-\fBENOKEY\fP
-要求された鍵が利用できない
-.TP 
-\fBENOLCK\fP
-利用できるロックが無い (POSIX.1)
-.TP 
-\fBENOLINK\fP
-.\" POSIX says "Reserved"
-リンクが切れている (POSIX.1)
-.TP 
-\fBENOMEDIUM\fP
-メディアが見つからない
-.TP 
-\fBENOMEM\fP
-十分な空きメモリー領域が無い (POSIX.1)
-.TP 
-\fBENOMSG\fP
-要求された型のメッセージが存在しない (POSIX.1)
-.TP 
-\fBENONET\fP
-マシンがネットワーク上にない
-.TP 
-\fBENOPKG\fP
-パッケージがインストールされていない
-.TP 
-\fBENOPROTOOPT\fP
-指定されたプロトコルが利用できない (POSIX.1)
-.TP 
-\fBENOSPC\fP
-デバイスに空き領域が無い (POSIX.1)
-.TP 
-\fBENOSR\fP
-指定されたストリームリソースが存在しない (POSIX.1 (XSI STREAMS option))
-.TP 
-\fBENOSTR\fP
-ストリームではない (POSIX.1 (XSI STREAMS option))
-.TP 
-\fBENOSYS\fP
-関数が実装されていない (POSIX.1)
-.TP 
-\fBENOTBLK\fP
-ブロックデバイスが必要である
-.TP 
-\fBENOTCONN\fP
-ソケットが接続されていない (POSIX.1)
-.TP 
-\fBENOTDIR\fP
-ディレクトリではない (POSIX.1)
-.TP 
-\fBENOTEMPTY\fP
-.\" ENOTNAM is defined but appears to be unused.
-ディレクトリが空ではない (POSIX.1)
-.TP 
-\fBENOTSOCK\fP
-ソケットではない (POSIX.1)
-.TP 
-\fBENOTSUP\fP
-操作がサポートされていない (POSIX.1)
-.TP 
-\fBENOTTY\fP
-I/O 制御操作が適切でない (POSIX.1)
-.TP 
-\fBENOTUNIQ\fP
-名前がネットワークで一意ではない
-.TP 
-\fBENXIO\fP
-そのようなデバイスやアドレスはない (POSIX.1)
-.TP 
-\fBEOPNOTSUPP\fP
-ソケットでサポートしていない操作である (POSIX.1)
-.sp
-(Linux では \fBENOTSUP\fP と \fBEOPNOTSUPP\fP は同じ値を持つが、 POSIX.1
-に従えば両者のエラー値は区別されるべきである。)
-.TP 
-\fBEOVERFLOW\fP
-指定されたデータ型に格納するには値が大き過ぎる (POSIX.1)
-.TP 
-\fBEPERM\fP
-操作が許可されていない (POSIX.1)
-.TP 
-\fBEPFNOSUPPORT\fP
-サポートされていないプロトコルファミリーである
-.TP 
-\fBEPIPE\fP
-パイプが壊れている (POSIX.1)
-.TP 
-\fBEPROTO\fP
-プロトコルエラー (POSIX.1)
-.TP 
-\fBEPROTONOSUPPORT\fP
-プロトコルがサポートされていない (POSIX.1)
-.TP 
-\fBEPROTOTYPE\fP
-ソケットに指定できないプロトコルタイプである (POSIX.1)
-.TP 
-\fBERANGE\fP
-結果が大き過ぎる (POSIX.1, C99)
-.TP 
-\fBEREMCHG\fP
-リモートアドレスが変わった
-.TP 
-\fBEREMOTE\fP
-オブジェクトがリモートにある
-.TP 
-\fBEREMOTEIO\fP
-リモート I/O エラー
-.TP 
-\fBERESTART\fP
-システムコールが中断され再スタートが必要である
-.TP 
-\fBEROFS\fP
-読み出し専用のファイルシステムである (POSIX.1)
-.TP 
-\fBESHUTDOWN\fP
-通信相手がシャットダウンされて送信できない
-.TP 
-\fBESPIPE\fP
-無効なシーク (POSIX.1)
-.TP 
-\fBESOCKTNOSUPPORT\fP
-サポートされていないソケット種別である
-.TP 
-\fBESRCH\fP
-.\" ESRMNT is defined but appears not to be used
-そのようなプロセスは無い (POSIX.1)
-.TP 
-\fBESTALE\fP
-ファイルハンドルが古い状態になっている (POSIX.1)
-.sp
-NFS や他のファイルシステムで起こりうる。
-.TP 
-\fBESTRPIPE\fP
-ストリームパイプエラー
-.TP 
-\fBETIME\fP
-時間が経過した (POSIX.1 (XSI STREAMS option))
-.sp
-(POSIX.1 では "STREAM \fBioctl\fP(2)  timeout" と書かれている)
-.TP 
-\fBETIMEDOUT\fP
-.\" ETOOMANYREFS is defined, but appears not to be used.
-操作がタイムアウトした (POSIX.1)
-.TP 
-\fBETXTBSY\fP
-テキストファイルが使用中である (POSIX.1)
-.TP 
-\fBEUCLEAN\fP
-Structure needs cleaning
-.TP 
-\fBEUNATCH\fP
-プロトコルのドライバが付与 (attach) されていない
-.TP 
-\fBEUSERS\fP
-ユーザー数が多過ぎる
-.TP 
-\fBEWOULDBLOCK\fP
-操作がブロックされる見込みである (\fBEAGAIN\fP と同じ値でもよい) (POSIX.1)
-.TP 
-\fBEXDEV\fP
-不適切なリンク (POSIX.1)
-.TP 
-\fBEXFULL\fP
-変換テーブルが一杯である
-.SH 注意
-以下はよくやる間違いである。
-.in +4n
-.nf
-
-if (somecall() == \-1) {
-    printf("somecall() failed\en");
-    if (errno == ...) { ... }
-}
-
-.fi
-.in
-このようにすると、参照している時点では \fIerrno\fP はもはや \fIsomecall\fP()  から返された値を保持しているとは限らない
-(\fBprintf\fP(3)  により変更されているかもしれない)。 ライブラリコールをまたいで \fIerrno\fP
-の値を保存したい場合は、以下のように保存しなければならない:
-.in +4n
-.nf
-
-if (somecall() == \-1) {
-    int errsv = errno;
-    printf("somecall() failed\en");
-    if (errsv == ...) { ... }
-}
-.fi
-.in
-.PP
-昔の C では、 \fI<errno.h>\fP をインクルードするのではなく \fIerrno\fP を手動で (\fIextern int
-errno\fP のように) 定義するのが一般的であった。 \fBこのようなことはしないこと\fP。 こうすると、最近のバージョンの C
-ライブラリでは正しく動作しないだろう。 しかし、(非常に) 古い UNIX システムでは、 \fI<errno.h>\fP
-がなく、宣言が必要なことがあるかもしれない。
-.SH 関連項目
-.\" In the moreutils package
-\fBerrno\fP(1), \fBerr\fP(3), \fBerror\fP(3), \fBperror\fP(3), \fBstrerror\fP(3)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。