.\" (michael@cantor.informatik.rwth-aachen.de), 1995-03-16
.\" Copyright (c) 1996 Andries Brouwer (aeb@cwi.nl), 1996-01-13
.\"
+.\" %%%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
.\" 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, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
.\"
.\" 1996-01-13 aeb: merged in some text contributed by Melvin Smith
.\" (msmith@falcon.mercer.peachnet.edu) and various other changes.
.\" Modified 1996-05-16 by Martin Schulze (joey@infodrom.north.de)
.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
.\" Japanese Version Copyright (c) 1998 TACHIBANA Akira
.\" all rights reserved.
.\" Translated 1998-05-28, TACHIBANA Akira <tati@tky.3web.ne.jp>
.\" Updated 2001-12-21, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2005-03-15, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2012-04-30, Akihiro MOTOKI <amotoki@gmail.com>
.\"
-.TH PERROR 3 2007-07-26 "" "Linux Programmer's Manual"
+.TH PERROR 3 2012\-04\-17 "" "Linux Programmer's Manual"
.SH 名前
perror \- システムエラーメッセージを出力する
.SH 書式
-.B #include <stdio.h>
+\fB#include <stdio.h>\fP
.sp
-.BI "void perror(const char *" s );
+\fBvoid perror(const char *\fP\fIs\fP\fB);\fP
.sp
-.B #include <errno.h>
+\fB#include <errno.h>\fP
.sp
-.BI "const char *" sys_errlist [];
+\fBconst char *\fP\fIsys_errlist\fP\fB[];\fP
.br
-.BI "int " sys_nerr ;
+\fBint \fP\fIsys_nerr\fP\fB;\fP
.br
-.BI "int " errno ;
+\fBint \fP\fIerrno\fP\fB;\fP
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.IR sys_errlist ,
-.IR sys_nerr :
-_BSD_SOURCE
+\fIsys_errlist\fP, \fIsys_nerr\fP: _BSD_SOURCE
.SH 説明
-関数
-.BR perror ()
-は、システムコールやライブラリ関数の呼び出しにおいて、最後に発生した
-エラーに関する説明メッセージを生成し、標準エラー出力に出力する。
-.RI ( s
-が NULL でなく、
-.I *s
-が NULL バイト (\(aq\\0\(aq) でない場合には) 引き数の文字列
-.I s
-がまず出力され、続いてコロン、空白が出力され、
+関数 \fBperror\fP() は、システムコールやライブラリ関数の呼び出しにおいて、最後に発生した
+エラーに関する説明メッセージを生成し、標準エラー出力に出力する。 (\fIs\fP が NULL でなく、 \fI*s\fP がヌルバイト
+(\(aq\e0\(aq) でない場合には) 引き数の文字列 \fIs\fP がまず出力され、続いてコロン、空白が出力され、
それからメッセージと改行が出力される。
-このメッセージを最大限活用するためには、引き数文字列にエラーが発生した
-関数名を入れておくとよい。
-エラー番号は外部変数
-.I errno
-から取得される。
-.I errno
-はエラーが発生した時に設定され、
-成功した呼び出しではクリアされない。
+このメッセージを最大限活用するためには、引き数文字列にエラーが発生した 関数名を入れておくとよい。 エラー番号は外部変数 \fIerrno\fP
+から取得される。 \fIerrno\fP はエラーが発生した時に設定され、 成功した呼び出しではクリアされない。
-大域変数のエラーリスト
-.IR sys_errlist "[]"
-は
-.I errno
-を添字とする配列で、この配列から改行無しのエラーメッセージが取得される。
-テーブルでの最大のメッセージ番号は
-.IR sys_nerr " \-1"
-となる。
-このテーブルを直接参照する際には注意すること。なぜなら、新しいエラー番号が
-.IR sys_errlist "[]"
-に追加済とは限らないからである。
+大域変数のエラーリスト \fIsys_errlist\fP[] は \fIerrno\fP を添字とする配列で、この
+配列から改行無しのエラーメッセージが取得される。 テーブルでの最大のメッセージ
+番号は \fIsys_nerr\fP \-1 となる。 このテーブルを直接参照する際には注意すること。
+なぜなら、新しいエラー番号が \fIsys_errlist\fP[] に追加済とは限らないからである。
+現在では、\fIsys_errlist\fP[] の使用は非推奨となっている。
-システムコールが失敗した場合、通常、返り値として \-1 が返り、
-.I errno
-にエラーを識別する値が設定される (設定されるエラー番号は
-.I <errno.h>
-に記載されている)。
-多くのライブラリ関数も同様の動作となる。
-関数
-.BR perror ()
-は、このエラーコードの可読なメッセージへの変換を行う。
-.I errno
-は、ライブラリ呼び出しが成功した後には未定義であることに注意が必要である:
-その呼び出し自身は成功したとしても、内部で呼び出した他のライブラリ関数が
-失敗して、その結果をこの変数に設定することがあるからだ。
-よって、失敗した呼び出しの直後に
-.BR perror ()
-を呼ばない場合には
-.I errno
-の値を
-保存しておかなければならない。
+システムコールが失敗した場合、通常、返り値として \-1 が返り、 \fIerrno\fP にエラーを識別する値が設定される (設定されるエラー番号は
+\fI<errno.h>\fP に記載されている)。 多くのライブラリ関数も同様の動作となる。 関数 \fBperror\fP()
+は、このエラーコードの可読なメッセージへの変換を行う。 \fIerrno\fP は、ライブラリ呼び出しが成功した後には未定義であることに注意が必要である:
+その呼び出し自身は成功したとしても、内部で呼び出した他のライブラリ関数が 失敗して、その結果をこの変数に設定することがあるからだ。
+よって、失敗した呼び出しの直後に \fBperror\fP() を呼ばない場合には \fIerrno\fP の値を 保存しておかなければならない。
.SH 準拠
-関数
-.BR perror ()
-と外部変数
-.I errno
-.RB ( errno (3)
-参照) は C89, 4.3BSD, POSIX.1-2001 に準拠している。
-外部変数
-.I sys_nerr
-と
-.I sys_errlist
-は BSD に準拠している。
+関数 \fBperror\fP() と外部変数 \fIerrno\fP (\fBerrno\fP(3) 参照) は C89, 4.3BSD, POSIX.1\-2001
+に準拠している。 外部変数 \fIsys_nerr\fP と \fIsys_errlist\fP は BSD に準拠している。
.SH 注意
-外部変数
-.I sys_nerr
-と
-.I sys_errlist
-は glibc で定義されているが、
-.I <stdio.h>
-に含まれている。
-.\" .B _BSD_SOURCE
-.\" が定義された場合にのみ、これらの変数は定義される。
+.\" and only when _BSD_SOURCE is defined.
+.\" When
.\" .B _GNU_SOURCE
-.\" が定義された場合は、
+.\" is defined, the symbols
.\" .I _sys_nerr
-.\" と
+.\" and
.\" .I _sys_errlist
-.\" というシンボルが提供される。
+.\" are provided.
+外部変数 \fIsys_nerr\fP と \fIsys_errlist\fP は glibc で定義されているが、 \fI<stdio.h>\fP
+に含まれている。
.SH 関連項目
-.BR err (3),
-.BR errno (3),
-.BR error (3),
-.BR strerror (3)
+\fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBstrerror\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
