OSDN Git Service

(split) LDP: Update drafts based on LDP 3.52 release
[linuxjm/LDP_man-pages.git] / draft / man3 / strerror.3
index 0a32cc7..61d6b93 100644 (file)
@@ -41,7 +41,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH STRERROR 3 2012\-04\-22 "" "Linux Programmer's Manual"
+.TH STRERROR 3 2013\-06\-21 "" "Linux Programmer's Manual"
 .SH 名前
 strerror, strerror_r \- エラー番号を説明する文字列を返す。
 .SH 書式
@@ -88,13 +88,13 @@ 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 は不定である)。文字列には必ず終端ヌル文字が含ま
-れる。
+The GNU\-specific \fBstrerror_r\fP()  returns a pointer to a string containing
+the error message.  This may be either a pointer to a string that the
+function stores in \fIbuf\fP, or a pointer to some (immutable) static string
+(in which case \fIbuf\fP is unused).  If the function stores a string in
+\fIbuf\fP, then at most \fIbuflen\fP bytes are stored (the string may be truncated
+if \fIbuflen\fP is too small and \fIerrnum\fP is unknown).  The string always
+includes a terminating null byte (\(aq\e0\(aq).
 .SH 返り値
 \fBstrerror\fP()  と \fBstrerror_r\fP()  はエラー内容を説明する 文字列を返す。エラー番号が未知の場合は "Unknown
 error nnn" という メッセージを返す。
@@ -115,6 +115,11 @@ XSI 準拠の \fBstrerror_r\fP() 関数は成功すると 0 を返す。エラ
 .TP 
 \fBERANGE\fP
 エラーコードを説明する文字列のために、充分な領域が確保できなかった。
+.SH ATTRIBUTES
+.SS "Multithreading (see pthreads(7))"
+The \fBstrerror\fP()  function is not thread\-safe.
+.LP
+The \fBstrerror_r\fP()  function is thread\-safe.
 .SH 準拠
 \fBstrerror\fP()  は POSIX.1\-2001, C89, C99 で規定されている。 \fBstrerror_r\fP()  は
 POSIX.1\-2001 で規定されている。
@@ -133,6 +138,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.51 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。