From: Akihiro MOTOKI Date: Wed, 17 Jul 2013 04:58:50 +0000 (+0900) Subject: (split) LDP: Update release pages (based on PO updates X-Git-Tag: LDP-3.52-final~12 X-Git-Url: http://git.osdn.net/view?p=linuxjm%2FLDP_man-pages.git;a=commitdiff_plain;h=8ff1aed018ca2e17241d5f83dab4cdd87dd3f377 (split) LDP: Update release pages (based on PO updates --- diff --git a/release/man3/drand48.3 b/release/man3/drand48.3 index 4fea2bd4..89a38bb6 100644 --- a/release/man3/drand48.3 +++ b/release/man3/drand48.3 @@ -127,10 +127,9 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBseed48\fP() を呼ぶと、前述の \fIa\fP と \fIc\fP の 標準値が再び設定される。 .SH ATTRIBUTES .SS "Multithreading (see pthreads(7))" -The \fBdrand48\fP(), \fBerand48\fP(), \fBlrand48\fP(), \fBnrand48\fP(), \fBmrand48\fP(), -\fBjrand48\fP(), \fBsrand48\fP(), \fBseed48\fP(), and \fBlcong48\fP() functions record -global state information for the random number generator, so they are not -thread\-safe. +関数 \fBdrand48\fP(), \fBerand48\fP(), \fBlrand48\fP(), \fBnrand48\fP(), \fBmrand48\fP(), +\fBjrand48\fP(), \fBsrand48\fP(), \fBseed48\fP(), \fBlcong48\fP() は、 +乱数生成に使用する状態情報をグローバルに保持する。 そのため、 これらの関数はスレッドセーフではない。 .SH 準拠 SVr4, POSIX.1\-2001. .SH 注意 diff --git a/release/man3/fgetgrent.3 b/release/man3/fgetgrent.3 index 7d54e04b..17857da8 100644 --- a/release/man3/fgetgrent.3 +++ b/release/man3/fgetgrent.3 @@ -67,9 +67,8 @@ struct group { .fi .in .SH 返り値 -The \fBfgetgrent\fP() function returns a pointer to a \fIgroup\fP structure, or -NULL if there are no more entries or an error occurs. In the event of an -error, \fIerrno\fP is set to indicate the cause. +\fBfgetgrent\fP() 関数は \fIgroup\fP 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL +を返す。 エラーの場合、 \fIerrno\fP に原因を示す値が設定される。 .SH エラー .TP \fBENOMEM\fP diff --git a/release/man3/fgetpwent.3 b/release/man3/fgetpwent.3 index 7a64945a..2efc555b 100644 --- a/release/man3/fgetpwent.3 +++ b/release/man3/fgetpwent.3 @@ -73,9 +73,8 @@ struct passwd { .fi .in .SH 返り値 -The \fBfgetpwent\fP() function returns a pointer to a \fIpasswd\fP structure, or -NULL if there are no more entries or an error occurs. In the event of an -error, \fIerrno\fP is set to indicate the cause. +\fBfgetpwent\fP() 関数は、 \fIpasswd\fP 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL +を返す。 エラーの場合、 \fIerrno\fP に原因を示す値が設定される。 .SH エラー .TP \fBENOMEM\fP diff --git a/release/man3/getgrent.3 b/release/man3/getgrent.3 index 4714369c..f96c87bc 100644 --- a/release/man3/getgrent.3 +++ b/release/man3/getgrent.3 @@ -123,9 +123,9 @@ I/O エラー。 ローカルのグループ・データベースファイル .SH ATTRIBUTES .SS "Multithreading (see pthreads(7))" -The \fBgetgrent()\fP function is not thread\-safe. +\fBgetgrent()\fP 関数はスレッドセーフではない。 .LP -The \fBsetgrent()\fP and \fBendgrent()\fP functions are thread\-safe. +関数 \fBsetgrent()\fP と \fBendgrent()\fP はスレッドセーフである。 .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. .SH 関連項目 diff --git a/release/man3/getgrnam.3 b/release/man3/getgrnam.3 index 0447a691..1099532b 100644 --- a/release/man3/getgrnam.3 +++ b/release/man3/getgrnam.3 @@ -145,9 +145,9 @@ I/O エラー。 ローカルのグループ・データベースファイル .SH ATTRIBUTES .SS "Multithreading (see pthreads(7))" -The functions \fBgetgrnam\fP() and \fBgetgrgid\fP() are not thread\-safe. +関数 \fBgetgrnam\fP() と \fBgetgrgid\fP() はスレッドセーフではない。 .LP -The functions \fBgetgrnam_r\fP() and \fBgetgrgid_r\fP() are thread\-safe. +関数 \fBgetgrnam_r\fP() と \fBgetgrgid_r\fP() はスレッドセーフである。 .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. .SH 注意 diff --git a/release/man3/getpwent.3 b/release/man3/getpwent.3 index 2878be63..2b2b30dd 100644 --- a/release/man3/getpwent.3 +++ b/release/man3/getpwent.3 @@ -120,9 +120,9 @@ I/O エラー。 ローカルのパスワード・データベースファイル .SH ATTRIBUTES .SS "Multithreading (see pthreads(7))" -The \fBgetpwent()\fP function is not thread\-safe. +\fBgetpwent()\fP 関数はスレッドセーフではない。 .LP -The \fBsetpwent()\fP and \fBendpwent()\fP functions are thread\-safe. +関数 \fBsetpwent()\fP と \fBendpwent()\fP はスレッドセーフである。 .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. \fIpw_gecos\fP フィールドは POSIX では規定されていないが、 ほとんどの実装に存在する。 diff --git a/release/man3/getpwnam.3 b/release/man3/getpwnam.3 index 93dc6905..f36d5fba 100644 --- a/release/man3/getpwnam.3 +++ b/release/man3/getpwnam.3 @@ -152,9 +152,9 @@ I/O エラー。 ローカルのパスワード・データベースファイル .SH ATTRIBUTES .SS "Multithreading (see pthreads(7))" -The functions \fBgetpwnam\fP() and \fBgetpwuid\fP() are not thread_safe. +関数 \fBgetpwnam\fP() と \fBgetpwuid\fP() はスレッドセーフではない。 .LP -The functions \fBgetpwnam_r\fP() and \fBgetpwuid_r\fP() are thread\-safe. +関数 \fBgetpwnam_r\fP() と \fBgetpwuid_r\fP() はスレッドセーフである。 .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. \fIpw_gecos\fP フィールドは POSIX では規定されていないが、 ほとんどの実装に存在する。 diff --git a/release/man3/getspnam.3 b/release/man3/getspnam.3 index 40a869f9..9448b383 100644 --- a/release/man3/getspnam.3 +++ b/release/man3/getspnam.3 @@ -150,10 +150,8 @@ struct spwd { .fi .in .SH 返り値 -The functions that return a pointer return NULL if no more entries are -available or if an error occurs during processing. The functions which have -\fIint\fP as the return value return 0 for success and \-1 for failure, with -\fIerrno\fP set to indicate the cause of the error. +ポインタを返す関数は、これ以上エントリがない場合や 処理中にエラーが発生した場合 NULL を返す。 \fIint\fP を返り値として持つ関数は、 +成功した場合 0 を返し、失敗した場合、 \-1 を返し、 \fIerrno\fP にエラーの原因を示す値を設定する。 .LP リエントラント版でない関数では、返り値が静的な領域を指しており、 引き続いてこれらの関数を呼び出した場合に上書きされる可能性がある。 .LP diff --git a/release/man3/pthread_attr_setinheritsched.3 b/release/man3/pthread_attr_setinheritsched.3 index c9fc35bb..7e4b48d4 100644 --- a/release/man3/pthread_attr_setinheritsched.3 +++ b/release/man3/pthread_attr_setinheritsched.3 @@ -28,10 +28,10 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PTHREAD_ATTR_SETINHERITSCHED 3 2012\-03\-15 Linux "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETINHERITSCHED 3 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 -pthread_attr_setinheritsched, pthread_attr_getinheritsched \- -スレッド属性オブジェクトの inherit scheduler 属性の設定/取得を行う +pthread_attr_setinheritsched, pthread_attr_getinheritsched \- スレッド属性オブジェクトの +inherit\-scheduler 属性の設定/取得を行う .SH 書式 .nf \fB#include \fP @@ -44,12 +44,15 @@ pthread_attr_setinheritsched, pthread_attr_getinheritsched \- \fI\-pthread\fP でコンパイルしてリンクする。 .fi .SH 説明 -\fBpthread_attr_setinheritsched\fP() 関数は、 -\fIattr\fP が参照するスレッド属性オブジェクトの inherit scheduler 属性を -\fIinheritsched\fP で指定された値に設定する。 -inherit scheduler 属性により、スレッド属性オブジェクト \fIattr\fP を使って -作成されるスレッドが、呼び出したスレッドのスケジューリング属性を継承 -するか、\fIattr\fP からスケジューリング属性を取得するかが決定される。 +\fBpthread_attr_setinheritsched\fP() 関数は、 \fIattr\fP が参照するスレッド属性オブジェクトの +inherit\-scheduler 属性を \fIinheritsched\fP で指定された値に設定する。 inherit\-scheduler +属性により、スレッド属性オブジェクト \fIattr\fP を使って作成されるスレッドが、呼び出したスレッドのスケジューリング属性を継承するか、 +\fIattr\fP からスケジューリング属性を取得するかが決定される。 + +The following scheduling attributes are affected by the inherit\-scheduler +attribute: scheduling policy (\fBpthread_attr_setschedpolicy\fP(3)), scheduling +priority (\fBpthread_attr_setschedparam\fP(3)), and contention scope +(\fBpthread_attr_setscope\fP(3)). 以下の値を \fIinheritsched\fP に指定できる。 .TP @@ -63,12 +66,11 @@ inherit scheduler 属性により、スレッド属性オブジェクト \fIattr \fIattr\fP を使って作成されたスレッドは、スレッド属性オブジェクトで 指定された値からスケジューリング属性を取得する。 .PP -新たに初期化されたスレッド属性オブジェクトの inherit scheduler 属性の -デフォルト設定は \fBPTHREAD_INHERIT_SCHED\fP である。 +新たに初期化されたスレッド属性オブジェクトの inherit\-scheduler 属性のデフォルト設定は +\fBPTHREAD_INHERIT_SCHED\fP である。 -\fBpthread_attr_getinheritsched\fP() は、 -スレッド属性オブジェクト \fIattr\fP の inherit scheduler 属性を -\fIinheritsched\fP が指すバッファに入れて返す。 +\fBpthread_attr_getinheritsched\fP() は、 スレッド属性オブジェクト \fIattr\fP の +inherit\-scheduler 属性を \fIinheritsched\fP が指すバッファに入れて返す。 .SH 返り値 成功すると、これらの関数は 0 を返す。 エラーの場合、0 以外のエラー番号を返す。 @@ -88,15 +90,11 @@ POSIX.1\-2001. .SH バグ .\" FIXME . Track status of the following bug: .\" http://sourceware.org/bugzilla/show_bug.cgi?id=7007 -glibc 2.8 の時点では、スレッド属性オブジェクトが -\fBpthread_attr_init\fP(3) を使って初期化された場合、 -スレッド属性オブジェクトのスケジューリングポリシーが \fBSCHED_OTHER\fP に、 -スケジューリング優先度が 0 に設定される。一方、その後 inherit -scheduling 属性に \fBPTHREAD_EXPLICIT_SCHED\fP が設定されると、このスレッ -ド属性オブジェクトを使って作成されたスレッドでは、スレッドを作成するス -レッドのスケジューリング属性が間違って継承されてしまう。 -\fBpthread_create\fP(3) を呼び出す前にスケジューリングポリシー属性か -スケジューリング優先度属性のどちらかが明示的に設定された場合には、 +glibc 2.8 の時点では、スレッド属性オブジェクトが \fBpthread_attr_init\fP(3) を使って初期化された場合、 +スレッド属性オブジェクトのスケジューリングポリシーが \fBSCHED_OTHER\fP に、 スケジューリング優先度が 0 に設定される。一方、その後 +inherit\-scheduler 属性に \fBPTHREAD_EXPLICIT_SCHED\fP +が設定されると、このスレッド属性オブジェクトを使って作成されたスレッドでは、スレッドを作成するスレッドのスケジューリング属性が間違って継承されてしまう。 +\fBpthread_create\fP(3) を呼び出す前にスケジューリングポリシー属性かスケジューリング優先度属性のどちらかが明示的に設定された場合には、 このバグは発生しない。 .SH 例 \fBpthread_setschedparam\fP(3) を参照。 @@ -105,9 +103,9 @@ scheduling 属性に \fBPTHREAD_EXPLICIT_SCHED\fP が設定されると、この .nh \fBsched_setscheduler\fP(2), \fBpthread_attr_init\fP(3), \fBpthread_attr_setschedparam\fP(3), \fBpthread_attr_setschedpolicy\fP(3), -\fBpthread_create\fP(3), \fBpthread_setschedparam\fP(3), -\fBpthread_setschedprio\fP(3), \fBpthreads\fP(7) +\fBpthread_attr_setscope\fP(3), \fBpthread_create\fP(3), +\fBpthread_setschedparam\fP(3), \fBpthread_setschedprio\fP(3), \fBpthreads\fP(7) .SH この文書について -この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部 +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man3/pthread_attr_setscope.3 b/release/man3/pthread_attr_setscope.3 index ea0fa84e..e0f8107d 100644 --- a/release/man3/pthread_attr_setscope.3 +++ b/release/man3/pthread_attr_setscope.3 @@ -66,9 +66,9 @@ POSIX.1\-2001 では、これらのスレッドがシステム上の他のプロ された他のスレッドとどのようにリソースを取り合うかは、 規定されないままになっている。 .PP -POSIX.1\-2001 requires that an implementation support at least one of these -contention scopes. Linux supports \fBPTHREAD_SCOPE_SYSTEM\fP, but not -\fBPTHREAD_SCOPE_PROCESS\fP. +POSIX.1\-2001 で求められているのは、スレッド実装がこれらの contention scope のうち少なくとも 1 +つをサポートすることだけである。 Linux は \fBPTHREAD_SCOPE_SYSTEM\fP をサポートしているが、 +\fBPTHREAD_SCOPE_PROCESS\fP はサポートしていない。 On systems that support multiple contention scopes, then, in order for the parameter setting made by \fBpthread_attr_setscope\fP() to have effect when diff --git a/release/man3/pthread_setname_np.3 b/release/man3/pthread_setname_np.3 index dff9a25f..afd21401 100644 --- a/release/man3/pthread_setname_np.3 +++ b/release/man3/pthread_setname_np.3 @@ -42,13 +42,11 @@ pthread_setname_np, pthread_getname_np \- スレッド名の設定/取得を行 .sp \fI\-pthread\fP を付けてコンパイルとリンクを行う。 .SH 説明 -By default, all the threads created using \fBpthread_create\fP() inherit the -program name. The \fBpthread_setname_np\fP() function can be used to set a -unique name for a thread, which can be useful for debugging multithreaded -applications. The thread name is a meaningful C language string, whose -length is restricted to 16 characters, including the terminating null byte -(\(aq\e0\(aq). The \fIthread\fP argument specifies the thread whose name is to -be changed; \fIname\fP specifies the new name. +デフォルトでは、 \fBpthread_create\fP() で作成されたすべてのスレッドはプログラム名を継承する。 +\fBpthread_setname_np\fP() 関数を使うとスレッドに固有の名前を設定することができる。 +スレッド固有の名前はマルチスレッド・アプリケーションのデバッグに便利である。 スレッド名は意味のある C 言語の文字列である。 その長さは 16 +文字に限定されており、 終端の NULL バイト (\(aq\e0\(aq) も 16 文字に含まれる。 \fIthread\fP +引き数で名前を変更するスレッドを指定する。 \fIname\fP には新しい名前を指定する。 \fBpthread_getname_np\fP() 関数を使うと、 スレッド名を取得することができる。 \fIthread\fP 引き数は名前を取得するスレッドを指定する。 バッファ \fIname\fP はスレッド名を返すのに使用される。 \fIlen\fP には \fIname\fP diff --git a/release/man3/putpwent.3 b/release/man3/putpwent.3 index 60f1a3fe..5e885dcf 100644 --- a/release/man3/putpwent.3 +++ b/release/man3/putpwent.3 @@ -68,8 +68,7 @@ struct passwd { .fi .in .SH 返り値 -The \fBputpwent\fP() function returns 0 on success, or \-1 if an error occurs. -In the event of an error, \fIerrno\fP is set to indicate the cause. +\fBputpwent\fP() 関数は、成功した場合 0 を返す。 エラーが発生した場合 \-1 を返し、 \fIerrno\fPに原因を示す値が設定される。 .SH エラー .TP \fBEINVAL\fP diff --git a/release/man3/random.3 b/release/man3/random.3 index f32f7509..6ed34536 100644 --- a/release/man3/random.3 +++ b/release/man3/random.3 @@ -78,15 +78,12 @@ _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOP \fBinitstate\fP() または \fBsetstate\fP() が 次に呼び出されるまで、乱数の生成に使用される。 \fIstate\fP は \fBinitstate\fP() を用いて最初に初期化されているか、 以前に呼び出した \fBsetstate\fP() の結果でなければならない。 .SH 返り値 -The \fBrandom\fP() function returns a value between 0 and \fBRAND_MAX\fP. The -\fBsrandom\fP() function returns no value. +関数 \fBrandom\fP() と \fBrand_r\fP() は 0 以上 \fBRAND_MAX\fP 以下の数を返す。 +関数 \fBsrandom\fP() は値を返さない。 -The \fBinitstate\fP() function returns a pointer to the previous state array. -On error, \fIerrno\fP is set to indicate the cause. +関数 \fBinitstate\fP() は、変更前の状態配列へのポインタを返す。エラーの場合、 \fIerrno\fP に原因を示す値が設定される。 -On success, \fBsetstate\fP() returns a pointer to the previous state array. -On error, it returns NULL, with \fIerrno\fP set to indicate the cause of the -error. +関数 \fBsetstate\fP() は、成功すると 0 を返す。 エラーの場合、\-1 を返し、 \fIerrno\fP にエラーの原因を示す値が設定される。 .SH エラー .TP \fBEINVAL\fP