OSDN Git Service

(split) LDP: Restore and add Copyrights for draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / strerror.3
index cfbf1c8..7ceb05b 100644 (file)
@@ -1,6 +1,7 @@
 .\" Copyright (C) 1993 David Metcalfe (david@prism.demon.co.uk)
 .\" and Copyright (C) 2005, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -20,6 +21,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH STRERROR 3 2012\-04\-22 "" "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1997 YOSHINO Takashi
+.\"       all rights reserved.
+.\" Translated 1997-01-20, YOSHINO Takashi <yoshino@civil.jcn.nihon-u.ac.jp>
+.\" Updated & Modified 2001-11-03, Yuichi SATO <ysato@h4.dion.ne.jp>
+.\" Updated 2005-12-26, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2007-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.64
+.\" Updated 2012-05-02, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-07-22, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH STRERROR 3 2013\-06\-21 "" "Linux Programmer's Manual"
 .SH 名前
 strerror, strerror_r \- エラー番号を説明する文字列を返す。
 .SH 書式
@@ -86,18 +98,15 @@ XSI 準拠のバージョンの \fBstrerror_r\fP() がデフォルトで提供
 移植性が必要なアプリケーションでは、 XSI 準拠の \fBstrerror_r\fP()  を使う方がよい。 この関数は、ユーザーから提供される長さ
 \fIbuflen\fP のバッファ \fIbuf\fP にエラー文字列を返す。
 
-GNU 仕様の \fBstrerror_r\fP() は、エラーメッセージを格納した文字列へのポイ
-ンタを返す。返り値は、この関数が \fIbuf\fP に格納した文字列へのポインタか、
-何らかの (不変な) 静的な文字列へのポインタ、のいずれかとなる (後者の場
-合は \fIbuf\fP は使用されない)。 \fIbuf\fP に文字列が格納される場合は、最大で
-\fIbuflen\fP バイトが格納される (\fIbuflen\fP が小さ過ぎたときには文字列は切
-り詰められ、 \fIerrnum\fP は不定である)。文字列には必ず終端ヌル文字が含ま
-れる。
+GNU 仕様の \fBstrerror_r\fP() は、 エラーメッセージを格納した文字列へのポインタを返す。 返り値は、 この関数が \fIbuf\fP
+に格納した文字列へのポインタか、 何らかの (不変な) 静的な文字列へのポインタ、 のいずれかとなる (後者の場合は \fIbuf\fP は使用されない)。
+\fIbuf\fP に文字列が格納される場合は、 最大で \fIbuflen\fP バイトが格納される (\fIbuflen\fP
+が小さ過ぎたときには文字列は切り詰められ、 \fIerrnum\fP は不定である)。 文字列には必ず終端ヌル文字 (\(aq\e0\(aq) が含まれる。
 .SH 返り値
 \fBstrerror\fP()  と \fBstrerror_r\fP()  はエラー内容を説明する 文字列を返す。エラー番号が未知の場合は "Unknown
 error nnn" という メッセージを返す。
 
-POSIX.1\-2001 と POSIX.1\-2008 では、 \fBstrerror\fP(3) が成功した場合は
+POSIX.1\-2001 と POSIX.1\-2008 では、 \fBstrerror\fP() が成功した場合は
 \fIerrno\fP を変更せずに元のままにしなければならないとされている。関数のど
 の返り値もエラーを示すために予約されていないので、エラーをチェックした
 いアプリケーションは呼び出しを行う前に \fIerrno\fP を 0 に初期化し、呼び出
@@ -113,6 +122,11 @@ XSI 準拠の \fBstrerror_r\fP() 関数は成功すると 0 を返す。エラ
 .TP 
 \fBERANGE\fP
 エラーコードを説明する文字列のために、充分な領域が確保できなかった。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBstrerror\fP() 関数はスレッドセーフではない。
+.LP
+\fBstrerror_r\fP() 関数はスレッドセーフである。
 .SH 準拠
 \fBstrerror\fP()  は POSIX.1\-2001, C89, C99 で規定されている。 \fBstrerror_r\fP()  は
 POSIX.1\-2001 で規定されている。
@@ -131,6 +145,6 @@ NULL 以外になることが求められている。
 .SH 関連項目
 \fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBperror\fP(3), \fBstrsignal\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。