From: Akihiro MOTOKI Date: Mon, 15 Jul 2013 10:12:55 +0000 (+0900) Subject: (split) LDP: Update releases based on LDP 3.52 release X-Git-Tag: LDP-3.52-final~17 X-Git-Url: http://git.osdn.net/view?p=linuxjm%2FLDP_man-pages.git;a=commitdiff_plain;h=9bab846d3fbabd0a6c37bcac1ec38299cae9683b (split) LDP: Update releases based on LDP 3.52 release --- diff --git a/release/man1/intro.1 b/release/man1/intro.1 index d3cb4d13..64ae7a4c 100644 --- a/release/man1/intro.1 +++ b/release/man1/intro.1 @@ -180,6 +180,6 @@ UNIX システムでは、多くのユーザプロセスとシステムプロセ .SH 関連項目 \fBstandards\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/man1/ldd.1 b/release/man1/ldd.1 index 62a57458..19ce7ead 100644 --- a/release/man1/ldd.1 +++ b/release/man1/ldd.1 @@ -23,19 +23,16 @@ ldd \- 共有ライブラリへの依存関係を表示する \fBldd\fP [OPTION]... FILE... .SH 説明 \fBldd\fP はコマンドラインで指定したプログラムや共有ライブラリについて、 それぞれで必要とされる共有ライブラリを表示する。 -.SS Security +.SS セキュリティ .\" Mainline glibc's ldd allows this possibility (the line .\" try_trace "$file" .\" in glibc 2.15, for example), but many distro versions of .\" ldd seem to remove that code path from the script. -In the usual case, \fBldd\fP invokes the standard dynamic linker (see -\fBld.so\fP(8)) with the \fBLD_TRACE_LOADED_OBJECTS\fP environment variable set -to 1, which causes the linker to display the library dependencies. Be -aware, however, that in some circumstances, some versions of \fBldd\fP may -attempt to obtain the dependency information by directly executing the -program. Thus, you should \fInever\fP employ \fBldd\fP on an untrusted -executable, since this may result in the execution of arbitrary code. A -safer alternative when dealing with untrusted executables is: +通常の場合、 \fBldd\fP は標準の動的リンカ (\fBld.so\fP(8) 参照) を \fBLD_TRACE_LOADED_OBJECTS\fP 環境変数に +1 をセットして起動する。 \fBLD_TRACE_LOADED_OBJECTS\fP に 1 +をセットすると、リンカはライブラリの依存関係を表示する。但し、状況次第では、依存関係の情報を得るのにプログラムを直接実行するバージョンの \fBldd\fP +が存在する。したがって、信頼できない実行ファイルに対しては「決して」 \fBldd\fP +を使っては「ならない」。任意のコードを実行することにつながるからである。信頼できない実行ファイルを扱う、より安全な別の方法としては次のようにするとよい。 $ objdump \-p /path/to/program | grep NEEDED .SH オプション @@ -76,6 +73,6 @@ libc5 バージョンのプログラムでは、 コマンドラインで与え .SH 関連項目 \fBld.so\fP(8), \fBldconfig\fP(8) .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/man1/time.1 b/release/man1/time.1 index 93b3f641..97dc7eeb 100644 --- a/release/man1/time.1 +++ b/release/man1/time.1 @@ -215,6 +215,6 @@ GNU \fBtime\fP に対する提案やバグレポートは .SH 関連項目 \fBtcsh\fP(1), \fBtimes\fP(2), \fBwait3\fP(2) .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/man2/_exit.2 b/release/man2/_exit.2 index c63ad0cd..adf6b2e2 100644 --- a/release/man2/_exit.2 +++ b/release/man2/_exit.2 @@ -86,6 +86,6 @@ exit の効果、終了状態の受渡し、ゾンビプロセス、シグナル \fBwait4\fP(2), \fBwaitpid\fP(2), \fBatexit\fP(3), \fBexit\fP(3), \fBon_exit\fP(3), \fBtermios\fP(3) .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/man2/_syscall.2 b/release/man2/_syscall.2 index bfcadbe7..f4898c12 100644 --- a/release/man2/_syscall.2 +++ b/release/man2/_syscall.2 @@ -83,11 +83,13 @@ _syscall\fIX\fP(\fItype\fP,\fIname\fP,\fItype1\fP,\fIarg1\fP,\fItype2\fP,\fIarg2 _syscall() マクロはプロトタイプを「生成しない」。 ユーザはプロトタイプを自分で書かなければならないかもしれない。 とりわけ C++ ユーザの場合はそうであろう。 -システムコールは、正のエラーコードのみ、または負のエラーコードのみを返すように -定められている訳ではない。そのシステムコールがどのようなエラーコードを返すかを -確認するには、そのソースコードを読む必要がある。たいていの場合は、標準のエラー コードを負にしたものである (例えば \-\fBEPERM\fP)。 -_syscall() マクロは、そのシステムコールの返り値 \fIr\fP が負でない場合、その値 をそのまま返す。一方、\fIr\fP が負の場合には、変数 -\fIerrno\fP に \-\fIr\fP を設定し、\-1 を返す。 エラーコードについては \fBerrno\fP(3) を参照。 +System calls are not required to return only positive or negative error +codes. You need to read the source to be sure how it will return errors. +Usually, it is the negative of a standard error code, for example, i +\-\fIEPERM\fP. The _syscall() macros will return the result \fIr\fP of the system +call when \fIr\fP is nonnegative, but will return \-1 and set the variable +\fIerrno\fP to \-\fIr\fP when \fIr\fP is negative. For the error codes, see +\fBerrno\fP(3). .\" The preferred way to invoke system calls that glibc does not know .\" about yet is via @@ -149,6 +151,6 @@ Number of processes = 40 .SH 関連項目 \fBintro\fP(2), \fBsyscall\fP(2), \fBerrno\fP(3) .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/man2/accept.2 b/release/man2/accept.2 index 7e89debf..074a6c50 100644 --- a/release/man2/accept.2 +++ b/release/man2/accept.2 @@ -217,6 +217,6 @@ Single UNIX Specification や glibc2 ではこのように宣言されるよう \fBbind\fP(2), \fBconnect\fP(2), \fBlisten\fP(2), \fBselect\fP(2), \fBsocket\fP(2), \fBsocket\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/man2/access.2 b/release/man2/access.2 index 0335f7af..46f9d607 100644 --- a/release/man2/access.2 +++ b/release/man2/access.2 @@ -161,6 +161,6 @@ POSIX.1\-2001 では、 呼び出し元プロセスが適切な特権を持っ \fBsetuid\fP(2), \fBstat\fP(2), \fBeauidaccess\fP(3), \fBcredentials\fP(7), \fBpath_resolution\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/man2/acct.2 b/release/man2/acct.2 index 58c5ce9f..7cd78d22 100644 --- a/release/man2/acct.2 +++ b/release/man2/acct.2 @@ -117,6 +117,6 @@ SVr4, 4.3BSD (POSIX ではない)。 .SH 関連項目 \fBacct\fP(5) .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/man2/adjtimex.2 b/release/man2/adjtimex.2 index 388cc040..2a963b19 100644 --- a/release/man2/adjtimex.2 +++ b/release/man2/adjtimex.2 @@ -116,6 +116,6 @@ struct timex { .SH 関連項目 \fBsettimeofday\fP(2), \fBadjtime\fP(3), \fBcapabilities\fP(7), \fBtime\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/man2/alarm.2 b/release/man2/alarm.2 index a714b651..5ec5cae9 100644 --- a/release/man2/alarm.2 +++ b/release/man2/alarm.2 @@ -44,7 +44,7 @@ alarm \- シグナル配送のためのアラーム・クロックを設定す .SH 説明 \fBalarm\fP() は \fBSIGALRM\fP シグナルを \fIseconds\fP 秒後に呼び出したプロセスに配送するように手配する。 -\fIseconds\fP がゼロならば、処理待ち (pending) のアラームはすべてキャンセルされる。 +If \fIseconds\fP is zero, any pending alarm is canceled. 今までに設定されていた \fBalarm\fP() は中断される。 .SH 返り値 @@ -62,6 +62,6 @@ SVr4, POSIX.1\-2001, 4.3BSD. \fBgettimeofday\fP(2), \fBpause\fP(2), \fBselect\fP(2), \fBsetitimer\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsleep\fP(3), \fBtime\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/man2/alloc_hugepages.2 b/release/man2/alloc_hugepages.2 index 724cb726..9b4ac187 100644 --- a/release/man2/alloc_hugepages.2 +++ b/release/man2/alloc_hugepages.2 @@ -93,6 +93,6 @@ HugePages_Free, Hugepagesize の サイズについての情報を提供する .\" mount -t hugetlbfs hugetlbfs /huge .\" SHM_HUGETLB .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/man2/arch_prctl.2 b/release/man2/arch_prctl.2 index 7777d8b5..182405c6 100644 --- a/release/man2/arch_prctl.2 +++ b/release/man2/arch_prctl.2 @@ -39,9 +39,10 @@ arch_prctl \- アーキテクチャ固有のスレッド状態を設定する \fBint arch_prctl(int \fP\fIcode\fP\fB, unsigned long *\fP\fIaddr\fP\fB);\fP .fi .SH 説明 -\fBarch_prctl\fP() 関数はアーキテクチャ固有のプロセス状態またはスレッド状態を設定する。 \fIcode\fP は副機能を選択し、引き数 -\fIaddr\fP を副機能に渡す。 \fIaddr\fP は、"set" 操作では \fIunsigned long\fP として、"get" 操作では -\fIunsigned long *\fP として解釈される。 +The \fBarch_prctl\fP() function sets architecture\-specific process or thread +state. \fIcode\fP selects a subfunction and passes argument \fIaddr\fP to it; +\fIaddr\fP is interpreted as either an \fIunsigned long\fP for the "set" +operations, or as an \fIunsigned long\ *\fP, for the "get" operations. .LP x86\-64 の副機能は以下の通り: .TP @@ -94,6 +95,6 @@ x86\-64 の副機能は以下の通り: AMD X86\-64 Programmer's manual .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/man2/bdflush.2 b/release/man2/bdflush.2 index 78893195..92931c6a 100644 --- a/release/man2/bdflush.2 +++ b/release/man2/bdflush.2 @@ -81,6 +81,6 @@ bdflush \- バッファー・ダーティー・フラッシュ・デーモンを .SH 関連項目 \fBfsync\fP(2), \fBsync\fP(2), \fBsync\fP(8), \fBupdate\fP(8) .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/man2/bind.2 b/release/man2/bind.2 index 9a90a235..1764b3bb 100644 --- a/release/man2/bind.2 +++ b/release/man2/bind.2 @@ -246,6 +246,6 @@ main(int argc, char *argv[]) \fBgetaddrinfo\fP(3), \fBgetifaddrs\fP(3), \fBip\fP(7), \fBipv6\fP(7), \fBpath_resolution\fP(7), \fBsocket\fP(7), \fBunix\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/man2/brk.2 b/release/man2/brk.2 index dfc278c1..2200dfc4 100644 --- a/release/man2/brk.2 +++ b/release/man2/brk.2 @@ -113,6 +113,6 @@ Linux では \fBsbrk\fP() は \fBbrk\fP() システムコールを使うライ .SH 関連項目 \fBexecve\fP(2), \fBgetrlimit\fP(2), \fBend\fP(3), \fBmalloc\fP(3) .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/man2/cacheflush.2 b/release/man2/cacheflush.2 index f2b5de2f..1e6e34f2 100644 --- a/release/man2/cacheflush.2 +++ b/release/man2/cacheflush.2 @@ -67,6 +67,6 @@ cacheflush \- 命令キャッシュやデータキャッシュの内容をフラ .SH バグ 現在の実装では、引き数 \fIaddr\fP と \fInbytes\fP は無視される。そのため、 常に全てのキャッシュがフラッシュされる。 .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/man2/capget.2 b/release/man2/capget.2 index dbb18b14..b4b2b0c1 100644 --- a/release/man2/capget.2 +++ b/release/man2/capget.2 @@ -137,6 +137,6 @@ VFS ケーパビリティのサポートでは、特権実行ファイルにケ .SH 関連項目 \fBclone\fP(2), \fBgettid\fP(2), \fBcapabilities\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/man2/chdir.2 b/release/man2/chdir.2 index 5f8557c3..6ad54237 100644 --- a/release/man2/chdir.2 +++ b/release/man2/chdir.2 @@ -111,6 +111,6 @@ SVr4, 4.4BSD, POSIX.1\-2001. .SH 関連項目 \fBchroot\fP(2), \fBgetcwd\fP(3), \fBpath_resolution\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/man2/chmod.2 b/release/man2/chmod.2 index 0b1104ca..dfe7cc7d 100644 --- a/release/man2/chmod.2 +++ b/release/man2/chmod.2 @@ -178,6 +178,6 @@ I/O エラーが発生した。 \fBchown\fP(2), \fBexecve\fP(2), \fBfchmodat\fP(2), \fBopen\fP(2), \fBstat\fP(2), \fBpath_resolution\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/man2/chown.2 b/release/man2/chown.2 index 7ace1eaa..5a106854 100644 --- a/release/man2/chown.2 +++ b/release/man2/chown.2 @@ -231,6 +231,6 @@ main(int argc, char *argv[]) \fBchmod\fP(2), \fBfchownat\fP(2), \fBflock\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/chroot.2 b/release/man2/chroot.2 index 37f9040f..228755bc 100644 --- a/release/man2/chroot.2 +++ b/release/man2/chroot.2 @@ -130,6 +130,6 @@ FreeBSD にはより強力な \fBjail\fP() システムコールがある。 .SH 関連項目 \fBchdir\fP(2), \fBpath_resolution\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/man2/clock_getres.2 b/release/man2/clock_getres.2 index 5e78f438..613a4efc 100644 --- a/release/man2/clock_getres.2 +++ b/release/man2/clock_getres.2 @@ -81,9 +81,9 @@ struct timespec { その場合は全てのプロセスから見ることができる。 また 1 つのプロセス内でのみ時間を計測する場合は、 プロセス毎に適用することもできる。 .LP 全ての実装においてシステム全体のリアルタイムクロックがサポートされ、 \fBCLOCK_REALTIME\fP で識別される。 時間は紀元 (the -Epoch) からの秒とナノ秒で表される。 時間が変更された場合、相対的な時間間隔のタイマは影響を受けないが、 絶対的な時点のタイマは影響を受ける。 +Epoch) からの秒とナノ秒で表される。 時間が変更された場合、相対的な時間間隔のタイマーは影響を受けないが、 絶対的な時点のタイマーは影響を受ける。 .LP -さらにいくつかのクロックが実装されているかもしれない。 対応する時間の値を解釈する方法とタイマへの影響は、定められていない。 +さらにいくつかのクロックが実装されているかもしれない。 対応する時間の値を解釈する方法とタイマーへの影響は、定められていない。 .LP glibc と Linux カーネルの最新のバージョンでは、 以下のクロックがサポートされている。 @@ -120,14 +120,13 @@ glibc と Linux カーネルの最新のバージョンでは、 \fBCLOCK_BOOTTIME\fP (Linux 2.6.39 以降; Linux 固有) .\" commit 7fdd7f89006dd5a4c702fa0ce0c272345fa44ae0 .\" commit 70a08cca1227dc31c784ec930099a4417a06e7d0 -Identical to \fBCLOCK_MONOTONIC\fP, except it also includes any time that the -system is suspended. This allows applications to get a suspend\-aware -monotonic clock without having to deal with the complications of -\fBCLOCK_REALTIME\fP, which may have discontinuities if the time is changed -using \fBsettimeofday\fP(2). +\fBCLOCK_MONOTONIC\fP と同じだが、システムがサスペンドされている時間も含まれる点が異なる。 +これを使うと、アプリケーションはサスペンド状態も扱える "monotonic" なクロックを得ることができる。 しかも、 +\fBCLOCK_REALTIME\fP における複雑な処理を行う必要もなくなる。 \fBCLOCK_REALTIME\fP では、 +\fBsettimeofday\fP(2) を使って時刻を変更した場合、時刻に不連続な変化が発生するからだ。 .TP \fBCLOCK_PROCESS_CPUTIME_ID\fP -CPU による高分解能のプロセス毎のタイマ。 +CPU による高分解能のプロセス毎のタイマー。 .TP \fBCLOCK_THREAD_CPUTIME_ID\fP スレッド固有の CPU タイムクロック。 @@ -156,16 +155,16 @@ SUSv2, POSIX.1\-2001. \fBCLOCK_THREAD_CPUTIME_ID\fP が利用可能なことを示す。 (\fBsysconf\fP(3) も参照すること。) .SH 注意 .SS "SMP システムについての注意" -\fBCLOCK_PROCESS_CPUTIME_ID\fP と \fBCLOCK_THREAD_CPUTIME_ID\fP クロックは、CPU からのタイマ +\fBCLOCK_PROCESS_CPUTIME_ID\fP と \fBCLOCK_THREAD_CPUTIME_ID\fP クロックは、CPU からのタイマー (i386 上の TSC、Itanium 上の AR.ITC) を用いて実現されている。 これらのレジスタは CPU 間で異なる可能性があり、 プロセスが他の CPU に移動させられた場合、 結果としてこれらのクロックが\fB偽の結果\fP (bogus results) を返すかもしれない。 .PP -SMP システムの各 CPU が別々のクロック源を持つ場合、 タイマレジスタ間の相互関係を管理する方法はない。 これは各 CPU +SMP システムの各 CPU が別々のクロック源を持つ場合、 タイマーレジスタ間の相互関係を管理する方法はない。 これは各 CPU が微妙に異なる周波数で動作するためである。 これが真実の場合 (訳註: 各 CPU が別々のクロック源を持つ場合)、 \fIclock_getcpuclockid(0)\fP は \fBENOENT\fP を返して、その状況を表す。 2 つのクロックは、プロセスが特定の CPU 上に留まっていることが 保証できる場合にのみ有効である。 .PP -SMP システムの各プロセッサは全く同じ時刻に起動する訳ではないので、 各タイマレジスタは通常はあるオフセットで動作している。 +SMP システムの各プロセッサは全く同じ時刻に起動する訳ではないので、 各タイマーレジスタは通常はあるオフセットで動作している。 オフセットをブート時に制限するコードが含まれるアーキテクチャもある。 しかし、このコードがオフセットを正確に調整することは保証できない。 glibc は (Linux カーネルとは異なり) オフセットを扱うためのコードを提供しない。 通常はこれらのオフセットが小さいので、多くの場合でその影響は無視できる。 .SH バグ @@ -179,6 +178,6 @@ POSIX.1\-2001 では、 「適切な特権 (appropriate privileges)」を持っ \fBadjtime\fP(3), \fBclock_getcpuclockid\fP(3), \fBctime\fP(3), \fBftime\fP(3), \fBpthread_getcpuclockid\fP(3), \fBsysconf\fP(3), \fBtime\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/man2/clock_nanosleep.2 b/release/man2/clock_nanosleep.2 index 59873310..d34457ca 100644 --- a/release/man2/clock_nanosleep.2 +++ b/release/man2/clock_nanosleep.2 @@ -125,7 +125,7 @@ POSIX.1\-2001. の精度の倍数ちょうどでない場合、停止期間は一番近い次の倍数に 切り上げられる。さらに、停止が完了した後に、CPU が呼び出したスレッドを もう一度実行できるようになるまでには、遅延が入る可能性がある。 -絶対値指定のタイマを使うのは、 \fBnanosleep\fP(2) に書かれている類のタイマのずれの問題を防止するのに役立つ +絶対値指定のタイマーを使うのは、 \fBnanosleep\fP(2) に書かれている類のタイマーのずれの問題を防止するのに役立つ (この種の問題は、シグナルに割り込まれた際に相対指定の停止を 繰り返し再開しようとするプログラムでは、かえって悪化する)。 これらの問題を回避して相対指定の停止を実行するには、 希望するクロックで \fBclock_gettime\fP(2) を呼び出し、その返り値の時刻値に希望する期間を加算してから、 \fBTIMER_ABSTIME\fP フラグを指定して @@ -149,6 +149,6 @@ POSIX.1 の規定では、 \fBclock_settime\fP(2) で \fBCLOCK_REALTIME\fP ク \fBclock_getres\fP(2), \fBnanosleep\fP(2), \fBtimer_create\fP(2), \fBsleep\fP(3), \fBusleep\fP(3), \fBtime\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/man2/clone.2 b/release/man2/clone.2 index 4e1058b3..2573f2b3 100644 --- a/release/man2/clone.2 +++ b/release/man2/clone.2 @@ -52,7 +52,7 @@ clone, __clone2 \- 子プロセスを作成する .SH 書式 .nf -/* Prototype for the glibc wrapper function */ +/* glibc ラッパー関数のプロトタイプ */ \fB#include \fP @@ -60,7 +60,7 @@ clone, __clone2 \- 子プロセスを作成する \fB int \fP\fIflags\fP\fB, void *\fP\fIarg\fP\fB, ... \fP \fB /* pid_t *\fP\fIptid\fP\fB, struct user_desc *\fP\fItls\fP\fB, pid_t *\fP\fIctid\fP\fB */ );\fP -/* Prototype for the raw system call */ +/* 素のシステムコールのプロトタイプ */ \fBlong clone(unsigned long \fP\fIflags\fP\fB, void *\fP\fIchild_stack\fP\fB,\fP \fB void *\fP\fIptid\fP\fB, void *\fP\fIctid\fP\fB,\fP @@ -68,8 +68,7 @@ clone, __clone2 \- 子プロセスを作成する .fi .sp .in -4n -Feature Test Macro Requirements for glibc wrapper function (see -\fBfeature_test_macros\fP(7)): +glibc ラッパー関数の機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .sp \fBclone\fP(): @@ -77,23 +76,21 @@ Feature Test Macro Requirements for glibc wrapper function (see .RS 4 .PD 0 .TP 4 -Since glibc 2.14: +glibc 2.14 以降: _GNU_SOURCE .TP 4 .\" FIXME See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749 -Before glibc 2.14: +glibc 2.14 より前: _BSD_SOURCE || _SVID_SOURCE - /* _GNU_SOURCE also suffices */ + /* _GNU_SOURCE も定義される */ .PD .RE .ad b .SH 説明 -\fBclone\fP() creates a new process, in a manner similar to \fBfork\fP(2). +\fBclone\fP() は、 \fBfork\fP(2) と似た方法で新しいプロセスを作成する。 -This page describes both the glibc \fBclone\fP() wrapper function and the -underlying system call on which it is based. The main text describes the -wrapper function; the differences for the raw system call are described -toward the end of this page. +このページでは、 glibc の \fBclone\fP() ラッパー関数とその裏で呼ばれるシステムコールの両方について説明している。 +メインの説明はラッパー関数に関するものである。 素のシステムコールにおける差分はこのページの最後の方で説明する。 \fBfork\fP(2) とは異なり、\fBclone\fP() では、子プロセス (child process) と呼び出し元のプロセスとが、メモリ空間、ファイルディスクリプタのテーブル、シグナル・ハンドラのテーブルなどの 実行コンテキストの一部を共有できる。 @@ -177,15 +174,12 @@ I/O コンテキストは、ディスクスケジュールの I/O スコープ .\" commit 7eafd7c74c3f2e67c27621b987b28397110d643f .\" https://lwn.net/Articles/312232/ -An IPC namespace provides an isolated view of System V IPC objects (see -\fBsvipc\fP(7)) and (since Linux 2.6.30) POSIX message queues (see -\fBmq_overview\fP(7)). The common characteristic of these IPC mechanisms is -that IPC objects are identified by mechanisms other than filesystem -pathnames. +IPC 名前空間は、独立の System V IPC オブジェクト空間 (\fBsvipc\fP(7) 参照) を提供する 。 (Linux 2.6.30 +以降では) 独立した POSIX メッセージキュー空間 (\fBmq_overview\fP(7) 参照) も提供される。 これらの IPC +機構に共通の特徴として、 IPC オブジェクトはファイルシステムのパス名とは違った仕組みで識別されるという点がある。 -Objects created in an IPC namespace are visible to all other processes that -are members of that namespace, but are not visible to processes in other IPC -namespaces. +ある IPC 名前空間に作成されたオブジェクトは、 その名前空間のメンバーである他のすべてのプロセスからも見えるが、 違う IPC +名前空間のプロセスからは見えない。 IPC 名前空間が破棄される時 (すなわち、その名前空間のメンバーの最後のプロセスが終了する時)、 その名前空間の全ての IPC オブジェクトは自動的に破棄される。 @@ -403,12 +397,11 @@ Linux 2.5.35 以降では、 \fBCLONE_THREAD\fP を指定する場合、 \fIflag \fBCLONE_VM\fP が設定されていない場合、子プロセスは \fBclone\fP() が実行された時点での、親プロセスのメモリ空間をコピーした 別のメモリ空間で実行される。 一方のプロセスが行ったメモリへの書き込みや ファイルのマップ/アンマップは、 \fBfork\fP(2) の場合と同様、もう一方のプロセスには影響しない。 -.SS 生のシステムコールのインターフェース -The raw \fBclone\fP() system call corresponds more closely to \fBfork\fP(2) in -that execution in the child continues from the point of the call. As such, -the \fIfn\fP and \fIarg\fP arguments of the \fBclone\fP() wrapper function are -omitted. Furthermore, the argument order changes. The raw system call -interface on x86 and many other architectures is roughly: +.SS 素のシステムコールのインターフェース +素の \fBclone\fP システムコールは、より \fBfork\fP(2) に近いかたちになっており、 +子プロセスの実行が呼び出しが行われた場所から続けられる。 そのため、 \fBclone\fP() ラッパー関数の引き数 \fIfn\fP と \fIarg\fP +は省略される。 また、 引き数の順序も違っている。 x86 と他の多くのアーキテクチャにおける、 素のシステムコールのインターフェースは、 +おおまかには次のようになっている。 .in +4 .nf @@ -423,14 +416,11 @@ interface on x86 and many other architectures is roughly: 子プロセスがスタック・ページの独立したコピーを得られることが保証される。 この場合、正常に動作させるためには、 \fBCLONE_VM\fP オプションを指定してはならない。 -For some architectures, the order of the arguments for the system call -differs from that shown above. On the score, microblaze, ARM, ARM 64, -PA\-RISC, arc, Power PC, xtensa, and MIPS architectures, the order of the -fourth and fifth arguments is reversed. On the cris and s390 architectures, -the order of the first and second arguments is reversed. -.SS "blackfin, m68k, and sparc" -The argument\-passing conventions on blackfin, m68k, and sparc are different -from descriptions above. For details, see the kernel (and glibc) source. +いくつかのアーキテクチャでは、システムコールの引き数の順序は上記とは異なっている。 microblaze, ARM, ARM 64, PA\-RISC, +arc, Power PC, xtensa, MIPS アーキテクチャでは、 4 番目と 5 番目の引き数の順番が逆である。 cris と s390 +アーキテクチャでは、最初と 2 番目の引き数の順番が逆である。 +.SS "blackfin, m68k, sparc" +blackfin, m68k, sparc では引き数渡しの規約が上記の説明とは異なる。 詳細は、カーネル (と glibc) のソースを参照のこと。 .SS ia64 ia64 では、別のインターフェースが使用される: .nf @@ -441,15 +431,13 @@ ia64 では、別のインターフェースが使用される: \fB /* pid_t *\fP\fIptid\fP\fB, struct user_desc *\fP\fItls\fP\fB, pid_t *\fP\fIctid\fP\fB */ );\fP .fi .PP -The prototype shown above is for the glibc wrapper function; the raw system -call interface has no \fIfn\fP or \fIarg\fP argument, and changes the order of the -arguments so that \fIflags\fP is the first argument, and \fItls\fP is the last -argument. +上記のプロトタイプは glibc ラッパー関数用のものである。 素のシステムコールのインターフェースには引き数 \fIfn\fP と \fIarg\fP がない。 +また、引き数の順序が変わり、 \fIflags\fP が最初の引き数で、 \fItls\fP が最後の引き数である。 .PP \fB__clone2\fP() は \fBclone\fP() と同じように動作するが、以下の点が異なる: \fIchild_stack_base\fP は子プロセスのスタックエリアの最小のアドレスを指し、 \fIstack_size\fP は \fIchild_stack_base\fP が指し示すスタックエリアの大きさを示す。 -.SS "Linux 2.4 and earlier" +.SS "Linux 2.4 以前" Linux 2.4 以前では、 \fBclone\fP() は引き数 \fIptid\fP, \fItls\fP, \fIctid\fP を取らない。 .SH 返り値 .\" gettid(2) returns current->pid; @@ -545,14 +533,11 @@ NPTL スレッド・ライブラリを含んでいる GNU C ライブラリの .\" See also the following bug reports .\" https://bugzilla.redhat.com/show_bug.cgi?id=417521 .\" http://sourceware.org/bugzilla/show_bug.cgi?id=6910 -.SH EXAMPLE -.SS "Create a child that executes in a separate UTS namespace" -The following program demonstrates the use of \fBclone\fP() to create a child -process that executes in a separate UTS namespace. The child changes the -hostname in its UTS namespace. Both parent and child then display the -system hostname, making it possible to see that the hostname differs in the -UTS namespaces of the parent and child. For an example of the use of this -program, see \fBsetns\fP(2). +.SH 例 +.SS "別の UTS 名前空間で動作する子プロセスを作成する" +以下のプログラムは、 別の UTS 名前空間で動作する子プロセスを \fBclone\fP() を使って作成する例である。 子プロセスは、自分の UTS +名前空間においてホスト名を変更する。 それから、親プロセスと子プロセスの両方でシステムのホスト名を表示し、 親プロセスと子プロセスの UTS +名前空間でホスト名が異なることを確認する。 このプログラムの使用方法については \fBsetns\fP(2) を参照。 .nf #define _GNU_SOURCE @@ -567,38 +552,38 @@ program, see \fBsetns\fP(2). #define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \e } while (0) -static int /* Start function for cloned child */ +static int /* clone された子プロセスの開始関数 */ childFunc(void *arg) { struct utsname uts; - /* Change hostname in UTS namespace of child */ + /* 子プロセスの UTS 名前空間でホスト名を変更する */ if (sethostname(arg, strlen(arg)) == \-1) errExit("sethostname"); - /* Retrieve and display hostname */ + /* ホスト名を取得し表示する */ if (uname(&uts) == \-1) errExit("uname"); printf("uts.nodename in child: %s\en", uts.nodename); - /* Keep the namespace open for a while, by sleeping. - This allows some experimentation\-\-for example, another - process might join the namespace. */ + /* sleep を使ってしばらく名前空間をオープンされたままにする。 + これにより実験を行うことができる \-\- 例えば、 + 別のプロセスがこの名前空間に参加するなど。 */ sleep(200); - return 0; /* Child terminates now */ + return 0; /* 子プロセスを終了する */ } -#define STACK_SIZE (1024 * 1024) /* Stack size for cloned child */ +#define STACK_SIZE (1024 * 1024) /* clone される子プロセスのスタックサイズ */ int main(int argc, char *argv[]) { - char *stack; /* Start of stack buffer */ - char *stackTop; /* End of stack buffer */ + char *stack; /* スタックバッファの先頭 */ + char *stackTop; /* スタックバッファの末尾 */ pid_t pid; struct utsname uts; @@ -607,33 +592,33 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } - /* Allocate stack for child */ + /* 子プロセス用のスタックを割り当てる */ stack = malloc(STACK_SIZE); if (stack == NULL) errExit("malloc"); - stackTop = stack + STACK_SIZE; /* Assume stack grows downward */ + stackTop = stack + STACK_SIZE; /* スタックは下方向に伸びるものとする */ - /* Create child that has its own UTS namespace; - child commences execution in childFunc() */ + /* 自分専用の UTS 名前空間を持つ子プロセスを作成する; + 子プロセスは childFunc() の実行を開始する */ pid = clone(childFunc, stackTop, CLONE_NEWUTS | SIGCHLD, argv[1]); if (pid == \-1) errExit("clone"); printf("clone() returned %ld\en", (long) pid); - /* Parent falls through to here */ + /* 親プロセスの実行はここに来る */ - sleep(1); /* Give child time to change its hostname */ + sleep(1); /* 子プロセスがホスト名を変更する時間を与える */ - /* Display hostname in parent\(aqs UTS namespace. This will be - different from hostname in child\(aqs UTS namespace. */ + /* 親プロセスの UTS 名前空間でのホスト名を表示する; + これは子プロセスの UTS 名前空間でのホスト名とは異なる */ if (uname(&uts) == \-1) errExit("uname"); printf("uts.nodename in parent: %s\en", uts.nodename); - if (waitpid(pid, NULL, 0) == \-1) /* Wait for child */ + if (waitpid(pid, NULL, 0) == \-1) /* 子プロセスを待つ */ errExit("waitpid"); printf("child has terminated\en"); @@ -645,6 +630,6 @@ main(int argc, char *argv[]) \fBset_thread_area\fP(2), \fBset_tid_address\fP(2), \fBsetns\fP(2), \fBtkill\fP(2), \fBunshare\fP(2), \fBwait\fP(2), \fBcapabilities\fP(7), \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/man2/close.2 b/release/man2/close.2 index 9b9165ba..54164899 100644 --- a/release/man2/close.2 +++ b/release/man2/close.2 @@ -93,6 +93,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. \fBfcntl\fP(2), \fBfsync\fP(2), \fBopen\fP(2), \fBshutdown\fP(2), \fBunlink\fP(2), \fBfclose\fP(3) .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/man2/connect.2 b/release/man2/connect.2 index a7fb4745..52975fc1 100644 --- a/release/man2/connect.2 +++ b/release/man2/connect.2 @@ -90,7 +90,7 @@ connect \- ソケットの接続を行う データグラムを受信する唯一のアドレスを示すに過ぎない。 ソケットが \fBSOCK_STREAM\fP 型もしくは \fBSOCK_SEQPACKET\fP 型であれば、このシステムコールは \fIaddr\fP で指定されたアドレスに結び付けられたソケットに対する接続の 作成を試みる。 .PP -一般的に、接続指向 (connection\-oriented) プロトコルでは一度だけ \fBconnect\fP() が成功する。 非接続 +一般的に、接続指向 (connection\-oriented) プロトコルでは一度だけ \fBconnect\fP() が成功する。 コネクションレス (connectionless) プロトコルでは対応を変更するために何度も \fBconnect\fP() を使用できる。 非接続ソケットは \fIsockaddr\fP の \fIsa_family\fP メンバに \fBAF_UNSPEC\fP を設定することで、接続アドレスの対応を解消することができる (\fBAF_UNSPEC\fP はカーネル 2.2 以降の Linux でサポート)。 @@ -182,6 +182,6 @@ POSIX.1\-2001 では \fI\fP のインクルードは必須とされ \fBaccept\fP(2), \fBbind\fP(2), \fBgetsockname\fP(2), \fBlisten\fP(2), \fBsocket\fP(2), \fBpath_resolution\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/man2/create_module.2 b/release/man2/create_module.2 index ca293c1b..43025ba1 100644 --- a/release/man2/create_module.2 +++ b/release/man2/create_module.2 @@ -22,7 +22,7 @@ create_module \- ローダブルモジュールのエントリを作成する \fBcaddr_t create_module(const char *\fP\fIname\fP\fB, size_t \fP\fIsize\fP\fB);\fP .fi .SH 説明 -\fBNote\fP: This system call is present only in kernels before Linux 2.6. +\fB注意\fP: このシステムコールが存在するのは、カーネル 2.6 より前の Linux だけである。 \fBcreate_module\fP() は、ローダブルモジュールのエントリを作成し、そのモジュールの保持に必要な カーネルメモリを予約しようとする。 このシステムコールを使うには特権が必要である。 @@ -43,8 +43,7 @@ create_module \- ローダブルモジュールのエントリを作成する モジュールを格納するのに必要な大きさの連続したメモリブロックを カーネルが確保できなかった。 .TP \fBENOSYS\fP -\fBcreate_module\fP() is not supported in this version of the kernel (e.g., -the kernel is version 2.6 or later). +\fBcreate_module\fP() がこのバージョンのカーネルではサポートされていない (例えば、カーネルのバージョンが 2.6 以降)。 .TP \fBEPERM\fP 呼び出し元が特権 (\fBCAP_SYS_MODULE\fP ケーパビリティ) を持っていなかった。 @@ -56,6 +55,6 @@ the kernel is version 2.6 or later). .SH 関連項目 \fBdelete_module\fP(2), \fBinit_module\fP(2), \fBquery_module\fP(2) .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/man2/dup.2 b/release/man2/dup.2 index 371c9921..c44ac3ff 100644 --- a/release/man2/dup.2 +++ b/release/man2/dup.2 @@ -121,6 +121,6 @@ close\-on\-exec flag (\fBfcntl\fP(2) 参照) は off となる。 .SH 関連項目 \fBclose\fP(2), \fBfcntl\fP(2), \fBopen\fP(2) .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/man2/epoll_create.2 b/release/man2/epoll_create.2 index 94e38bd5..54ebe386 100644 --- a/release/man2/epoll_create.2 +++ b/release/man2/epoll_create.2 @@ -98,6 +98,6 @@ Linux 2.6.8 以降では、\fIsize\fP 引き数は無視されるが、 0 より .SH 関連項目 \fBclose\fP(2), \fBepoll_ctl\fP(2), \fBepoll_wait\fP(2), \fBepoll\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/man2/epoll_ctl.2 b/release/man2/epoll_ctl.2 index 21b50d04..f747df7f 100644 --- a/release/man2/epoll_ctl.2 +++ b/release/man2/epoll_ctl.2 @@ -147,6 +147,6 @@ NULL を指定できるようになっている。 2.6.9 より前のカーネ .SH 関連項目 \fBepoll_create\fP(2), \fBepoll_wait\fP(2), \fBpoll\fP(2), \fBepoll\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/man2/epoll_wait.2 b/release/man2/epoll_wait.2 index 54295dd5..47dae78f 100644 --- a/release/man2/epoll_wait.2 +++ b/release/man2/epoll_wait.2 @@ -140,6 +140,6 @@ struct epoll_event { .SH 関連項目 \fBepoll_create\fP(2), \fBepoll_ctl\fP(2), \fBepoll\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/man2/eventfd.2 b/release/man2/eventfd.2 index 4b406112..e3c25d99 100644 --- a/release/man2/eventfd.2 +++ b/release/man2/eventfd.2 @@ -274,6 +274,6 @@ main(int argc, char *argv[]) \fBsignalfd\fP(2), \fBtimerfd_create\fP(2), \fBwrite\fP(2), \fBepoll\fP(7), \fBsem_overview\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/man2/execve.2 b/release/man2/execve.2 index ce10ba9e..af251456 100644 --- a/release/man2/execve.2 +++ b/release/man2/execve.2 @@ -39,7 +39,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH EXECVE 2 2012\-10\-27 Linux "Linux Programmer's Manual" +.TH EXECVE 2 2013\-07\-04 Linux "Linux Programmer's Manual" .SH 名前 execve \- プログラムを実行する .SH 書式 @@ -317,9 +317,11 @@ Linux はスクリプトの set\-user\-ID と set\-group\-ID ビットを無視 .\" Bug filed 30 Apr 2007: http://bugzilla.kernel.org/show_bug.cgi?id=8408 .\" Bug rejected (because fix would constitute an ABI change). .\" -Linux では、 \fIargv\fP に NULL を指定することができる。これは、この引き数に NULL ポインタ -1個だけを含むリストへのポインタを指定したのと同じ効果を持つ。 \fB「この間違った機能を利用しないこと」\fP。 これは非標準で、移植性もない。 -他のほとんどの UNIX システムでは、これを行うとエラー (\fBEFAULT\fP) になる。 +On Linux, either \fIargv\fP or \fIenvp\fP can be specified as NULL, which has the +same effect as specifying these arguments as a pointer to a list containing +a single NULL pointer. \fBDo not take advantage of this misfeature!\fP It is +nonstandard and nonportable: on most other UNIX systems doing this will +result in an error (\fBEFAULT\fP). .\" .\" .SH BUGS @@ -432,6 +434,6 @@ argv[4]: world \fBgetopt\fP(3), \fBcredentials\fP(7), \fBenviron\fP(7), \fBpath_resolution\fP(7), \fBld.so\fP(8) .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/man2/exit_group.2 b/release/man2/exit_group.2 index 37e6d3af..e8da6f63 100644 --- a/release/man2/exit_group.2 +++ b/release/man2/exit_group.2 @@ -50,6 +50,6 @@ glibc 2.3 以降では、 \fBexit\fP(2) のラッパー関数が呼び出され .SH 関連項目 \fBexit\fP(2) .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/man2/faccessat.2 b/release/man2/faccessat.2 index 2d739488..1a3844ab 100644 --- a/release/man2/faccessat.2 +++ b/release/man2/faccessat.2 @@ -109,6 +109,6 @@ POSIX.1\-2008. \fBaccess\fP(2), \fBopenat\fP(2), \fBeauidaccess\fP(3), \fBcredentials\fP(7), \fBpath_resolution\fP(7), \fBsymlink\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/man2/fallocate.2 b/release/man2/fallocate.2 index 2a80a5e4..983ba4d8 100644 --- a/release/man2/fallocate.2 +++ b/release/man2/fallocate.2 @@ -13,7 +13,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FALLOCATE 2 2013\-02\-12 Linux "Linux Programmer's Manual" +.TH FALLOCATE 2 2013\-06\-10 Linux "Linux Programmer's Manual" .SH 名前 fallocate \- ファイル空間の操作 .SH 書式 @@ -54,21 +54,20 @@ POSIX.1 で規定された方法である \fBposix_fallocate\fP(3) を使うこ 割り当てはブロックサイズ単位で行われるため、 \fBfallocate\fP() は指定されたより も大きなディスク領域を割り当てることがある。 .SS ファイル空間の割り当て解除 -Specifying the \fBFALLOC_FL_PUNCH_HOLE\fP flag (available since Linux 2.6.38) -in \fImode\fP deallocates space (i.e., creates a hole) in the byte range -starting at \fIoffset\fP and continuing for \fIlen\fP bytes. Within the specified -range, partial file system blocks are zeroed, and whole file system blocks -are removed from the file. After a successful call, subsequent reads from -this range will return zeroes. +\fBFALLOC_FL_PUNCH_HOLE\fP フラグ (Linux 2.6.38 以降で利用可能) を \fImode\fP に指定すると、 +\fIoffset\fP で始まる \fIlen\fP バイトの領域の空間を解放する (ホールを作成する)。 指定された範囲のうち、 +部分的に使用しているファイルシステムブロックは 0 で埋められ、 全体を使用しているファイルシステムブロックはそのファイルから削除される。 +呼び出しが成功すると、 これ以降のこの範囲からの読み出しでは 0 を返す。 -The \fBFALLOC_FL_PUNCH_HOLE\fP flag must be ORed with \fBFALLOC_FL_KEEP_SIZE\fP in -\fImode\fP; in other words, even when punching off the end of the file, the -file size (as reported by \fBstat\fP(2)) does not change. +\fBFALLOC_FL_PUNCH_HOLE\fP フラグは \fBFALLOC_FL_KEEP_SIZE\fP と論理和 (OR) をとって \fImode\fP +に指定しなければならない。 つまり、 ファイル末尾の punch off を行った場合でも、 (\fBstat\fP(2) で報告される) +ファイルサイズが変化しない。 -Not all file systems support \fBFALLOC_FL_PUNCH_HOLE\fP; if a file system -doesn't support the operation, an error is returned. +すべてのファイルシステムで \fBFALLOC_FL_PUNCH_HOLE\fP がサポートされているわけではない。 +ファイルシステムがこの操作をサポートしていない場合は、 エラーが返る。 .SH 返り値 -\fBfallocate\fP() は成功すると 0 を返し、エラーの場合は \-1 を返す。 +On success, \fBfallocate\fP() returns zero. On error, \-1 is returned and +\fIerrno\fP is set to indicate the error. .SH エラー .TP \fBEBADF\fP @@ -107,9 +106,9 @@ doesn't support the operation, an error is returned. \fImode\fP をサポートしていない。 .TP \fBEPERM\fP -The file referred to by \fIfd\fP is marked immutable (see \fBchattr\fP(1)). Or: -\fImode\fP specifies \fBFALLOC_FL_PUNCH_HOLE\fP and the file referred to by \fIfd\fP -is marked append\-only (see \fBchattr\fP(1)). +\fIfd\fP が参照するファイルに変更不可 (immutable) の属性が付いている (\fBchattr\fP(1) 参照)。 \fImode\fP に +\fBFALLOC_FL_PUNCH_HOLE\fP が指定されたが、 \fIfd\fP が参照するファイルに追加のみ (append\-only) +の属性が付いている (\fBchattr\fP(1) 参照)。 .TP \fBESPIPE\fP \fIfd\fP がパイプか FIFO を参照している。 @@ -122,6 +121,6 @@ is marked append\-only (see \fBchattr\fP(1)). .SH 関連項目 \fBfallocate\fP(1), \fBftruncate\fP(2), \fBposix_fadvise\fP(3), \fBposix_fallocate\fP(3) .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/man2/fchmodat.2 b/release/man2/fchmodat.2 index 07bfc4a5..d959668f 100644 --- a/release/man2/fchmodat.2 +++ b/release/man2/fchmodat.2 @@ -104,6 +104,6 @@ POSIX で規定されたインターフェースを実装している。 .SH 関連項目 \fBchmod\fP(2), \fBopenat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/fchownat.2 b/release/man2/fchownat.2 index 16b6dfce..9f9a7cc0 100644 --- a/release/man2/fchownat.2 +++ b/release/man2/fchownat.2 @@ -97,6 +97,6 @@ POSIX.1\-2008. Solaris には、これと同じようなシステムコール .SH 関連項目 \fBchown\fP(2), \fBopenat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/fcntl.2 b/release/man2/fcntl.2 index 40c6eed7..5645a65d 100644 --- a/release/man2/fcntl.2 +++ b/release/man2/fcntl.2 @@ -657,6 +657,6 @@ Linux カーネルソースの \fIDocumentation/filesystems/\fP ディレクト \fIDocumentation/\fP ディレクトリ直下にあり、 \fImandatory\-locking.txt\fP は \fImandatory.txt\fP という名前であった) .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/man2/flock.2 b/release/man2/flock.2 index e082f25e..fa74af44 100644 --- a/release/man2/flock.2 +++ b/release/man2/flock.2 @@ -132,6 +132,6 @@ kernel 2.0 以降では、 \fBflock\fP() は、GNU C ライブラリでの \fBf Linux カーネルソース内の \fIDocumentation/filesystem/locks.txt\fP (以前のカーネルでは \fIDocumentation/locks.txt\fP) .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/man2/fork.2 b/release/man2/fork.2 index c2fbd9b5..7b45ad16 100644 --- a/release/man2/fork.2 +++ b/release/man2/fork.2 @@ -154,6 +154,6 @@ glibc のラッパー関数は \fBpthread_atfork\fP(3) を使って設定され \fBclone\fP(2), \fBexecve\fP(2), \fBexit\fP(2), \fBsetrlimit\fP(2), \fBunshare\fP(2), \fBvfork\fP(2), \fBwait\fP(2), \fBdaemon\fP(3), \fBcapabilities\fP(7), \fBcredentials\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/man2/fstatat.2 b/release/man2/fstatat.2 index 5bd409ed..70e756ae 100644 --- a/release/man2/fstatat.2 +++ b/release/man2/fstatat.2 @@ -110,6 +110,6 @@ glibc の \fBfstatat\fP() のラッパー関数が利用するシステムコー .SH 関連項目 \fBopenat\fP(2), \fBstat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/fsync.2 b/release/man2/fsync.2 index b24dfe8d..98785c39 100644 --- a/release/man2/fsync.2 +++ b/release/man2/fsync.2 @@ -114,6 +114,6 @@ Linux 2.2 以前では、 \fBfdatasync\fP() は \fBfsync\fP() と等価であ \fBbdflush\fP(2), \fBopen\fP(2), \fBsync\fP(2), \fBsync_file_range\fP(2), \fBhdparm\fP(8), \fBmount\fP(8), \fBsync\fP(8), \fBupdate\fP(8) .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/man2/futex.2 b/release/man2/futex.2 index d758fb0e..b4e6275d 100644 --- a/release/man2/futex.2 +++ b/release/man2/futex.2 @@ -125,13 +125,11 @@ wake させる。 引き数 \fItimeout\fP, \fIuaddr2\fP, \fIval3\fP は無視さ 保持されていない場合、操作はエラー \fBEAGAIN\fP で失敗する。引き数 \fItimeout\fP は無視される。 .SH 返り値 .PP -In the event of an error, all operations return \-1, and set \fIerrno\fP to -indicate the error. The return value on success depends on the operation, -as described in the following list: +エラーの場合、全ての操作で \-1 が返り、 \fIerrno\fP +がエラーの内容を示す値に設定される。成功時の返り値は操作によって異なり、以下のリストに書かれている通りである。 .TP \fBFUTEX_WAIT\fP -Returns 0 if the process was woken by a \fBFUTEX_WAKE\fP call. See ERRORS for -the various possible error returns. +そのプロセスが \fBFUTEX_WAKE\fP により wake された場合 0 を返す。発生する可能性があるエラーについては「エラー」の節を参照。 .TP \fBFUTEX_WAKE\fP wake したプロセスの数を返す。 @@ -150,19 +148,17 @@ wake したプロセスの数を返す。 futex メモリに読み込みアクセス権がなかった。 .TP \fBEAGAIN\fP -\fBFUTEX_CMP_REQUEUE\fP detected that the value pointed to by \fIuaddr\fP is not -equal to the expected value \fIval3\fP. (This probably indicates a race; use -the safe \fBFUTEX_WAKE\fP now.) +\fBFUTEX_CMP_REQUEUE\fP で、\fIuaddr\fP が指す値が期待値 \fIval3\fP と異なる状況が検出された。 +(これは競合を示しているかもしれない。この場合は安全な \fBFUTEX_WAKE\fP を使うこと。) .TP \fBEFAULT\fP ユーザ空間から \fItimeout\fP の情報を取得する際にエラーが発生した。 .TP \fBEINTR\fP -A \fBFUTEX_WAIT\fP operation was interrupted by a signal (see \fBsignal\fP(7)) or -a spurious wakeup. +\fBFUTEX_WAIT\fP 操作がシグナル (\fBsignal\fP(7) 参照) もしくは偽の wakeup により中断された。 .TP \fBEINVAL\fP -Invalid argument. +無効な引き数。 .TP \fBENFILE\fP オープンされているファイルの総数がシステムの制限に達した。 @@ -171,11 +167,10 @@ Invalid argument. \fIop\fP に無効な操作が指定された。 .TP \fBETIMEDOUT\fP -Timeout during the \fBFUTEX_WAIT\fP operation. +\fBFUTEX_WAIT\fP 操作でタイムアウトが発生した。 .TP \fBEWOULDBLOCK\fP -\fIop\fP was \fBFUTEX_WAIT\fP and the value pointed to by \fIuaddr\fP was not equal -to the expected value \fIval\fP at the time of the call. +\fIop\fP が \fBFUTEX_WAIT\fP で、その呼び出しにおいて \fIuaddr\fP が指す値が期待値 \fIval\fP と異なっていた。 .SH バージョン .PP 最初の futex 対応は Linux 2.5.7 で組み込まれたが、 上記のセマンティクスとは異なる。 4 @@ -209,6 +204,6 @@ futex の使用例ライブラリ, futex\-*.tar.bz2 .UR ftp://ftp.nl.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/ .UE .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/man2/futimesat.2 b/release/man2/futimesat.2 index 7c32a933..51de5742 100644 --- a/release/man2/futimesat.2 +++ b/release/man2/futimesat.2 @@ -86,6 +86,6 @@ Solaris には、これと同じようなシステムコールが存在する。 \fBstat\fP(2), \fButimensat\fP(2), \fButimes\fP(2), \fBfutimes\fP(3), \fBpath_resolution\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/man2/get_kernel_syms.2 b/release/man2/get_kernel_syms.2 index 0fd7f481..0060ff51 100644 --- a/release/man2/get_kernel_syms.2 +++ b/release/man2/get_kernel_syms.2 @@ -22,7 +22,7 @@ get_kernel_syms \- 公開されているカーネルやモジュールのシン \fBint get_kernel_syms(struct kernel_sym *\fP\fItable\fP\fB);\fP .fi .SH 説明 -\fBNote\fP: This system call is present only in kernels before Linux 2.6. +\fB注意\fP: このシステムコールが存在するのは、カーネル 2.6 より前の Linux だけである。 \fBget_kernel_syms\fP() は、 \fItable\fP が NULL の場合、 問い合わせできるシンボルの数を返す。 NULL 以外の場合、以下の構造体の列 (table) に値を入れて返す。 @@ -65,6 +65,6 @@ struct kernel_sym { \fBcreate_module\fP(2), \fBdelete_module\fP(2), \fBinit_module\fP(2), \fBquery_module\fP(2) .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/man2/get_mempolicy.2 b/release/man2/get_mempolicy.2 index 8951a7f8..f24390bd 100644 --- a/release/man2/get_mempolicy.2 +++ b/release/man2/get_mempolicy.2 @@ -111,6 +111,6 @@ NUMA (非対称メモリアクセス) マシンでは、CPU により メモリ \fBgetcpu\fP(2), \fBmbind\fP(2), \fBmmap\fP(2), \fBset_mempolicy\fP(2), \fBnuma\fP(3), \fBnuma\fP(7), \fBnumactl\fP(8) .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/man2/get_thread_area.2 b/release/man2/get_thread_area.2 index 83167d29..b5825e8a 100644 --- a/release/man2/get_thread_area.2 +++ b/release/man2/get_thread_area.2 @@ -47,6 +47,6 @@ get_thread_area \- スレッド局所記憶 (TLS) 領域を取り出す .SH 関連項目 \fBmodify_ldt\fP(2), \fBset_thread_area\fP(2) .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/man2/getcpu.2 b/release/man2/getcpu.2 index ff56e4ec..9dec4332 100644 --- a/release/man2/getcpu.2 +++ b/release/man2/getcpu.2 @@ -34,9 +34,8 @@ getcpu \- 呼び出し元スレッドが動作している CPU と NUMA ノー \fIcpu\fP か \fInode\fP のいずれかが NULL であれば、 その引き数に対応する情報の書き込みは行われない。 -The third argument to this system call is nowadays unused, and should be -specified as NULL unless portability to Linux 2.6.23 or earlier is required -(see NOTES). +このシステムコールの 3 番目の引き数は現在は使われておらず、 Linux 2.6.23 以前への移植性が必要な場合以外は NULL を渡すべきである +(「注意」を参照)。 \fIcpu\fP に格納された情報が最新だと保証できるのは、システムコールが呼ばれ た時点だけである。\fBsched_setaffinity\fP(2) を使って CPU affinity が固定 @@ -114,6 +113,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し \fBmbind\fP(2), \fBsched_setaffinity\fP(2), \fBset_mempolicy\fP(2), \fBsched_getcpu\fP(3), \fBcpuset\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/man2/getdents.2 b/release/man2/getdents.2 index 4b6f553d..4be908cc 100644 --- a/release/man2/getdents.2 +++ b/release/man2/getdents.2 @@ -235,6 +235,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBreaddir\fP(2), \fBreaddir\fP(3) .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/man2/getdomainname.2 b/release/man2/getdomainname.2 index f3787ed1..d91648cd 100644 --- a/release/man2/getdomainname.2 +++ b/release/man2/getdomainname.2 @@ -92,6 +92,6 @@ Linux 1.0 以降では、ドメイン名の長さの上限は 終端の NULL バ .SH 関連項目 \fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2) .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/man2/getgid.2 b/release/man2/getgid.2 index b9998fe9..3cd64c08 100644 --- a/release/man2/getgid.2 +++ b/release/man2/getgid.2 @@ -56,6 +56,6 @@ glibc の \fBgetgid\fP() と \fBgetegid\fP() のラッパー関数は .SH 関連項目 \fBgetresgid\fP(2), \fBsetgid\fP(2), \fBsetregid\fP(2), \fBcredentials\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/man2/getgroups.2 b/release/man2/getgroups.2 index d9236b9e..bd39feb9 100644 --- a/release/man2/getgroups.2 +++ b/release/man2/getgroups.2 @@ -115,6 +115,6 @@ SVr4, 4.3BSD. \fBgetgroups\fP() 関数は POSIX.1\-2001 に準拠している \fBgetgid\fP(2), \fBsetgid\fP(2), \fBgetgrouplist\fP(3), \fBinitgroups\fP(3), \fBcapabilities\fP(7), \fBcredentials\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/man2/gethostname.2 b/release/man2/gethostname.2 index 2008240f..2a477d1f 100644 --- a/release/man2/gethostname.2 +++ b/release/man2/gethostname.2 @@ -111,6 +111,6 @@ GNU C ライブラリは、 \fBgethostname\fP() システムコールを利用 .SH 関連項目 \fBgetdomainname\fP(2), \fBsetdomainname\fP(2), \fBuname\fP(2) .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/man2/getitimer.2 b/release/man2/getitimer.2 index 1c812381..59985288 100644 --- a/release/man2/getitimer.2 +++ b/release/man2/getitimer.2 @@ -98,18 +98,17 @@ POSIX.1\-2001, SVr4, 4.4BSD (このコールは 4.2BSD で始めて現われた) POSIX.1 では、 \fBsetitimer\fP() と、 \fBalarm\fP(2), \fBsleep\fP(3), \fBusleep\fP(3) という 3 つのインタフェースとの相互の影響については規定していない。 -The standards are silent on the meaning of the call: +標準では、次の呼び出しの意味については規定されていない。 setitimer(which, NULL, &old_value); -Many systems (Solaris, the BSDs, and perhaps others) treat this as -equivalent to: +(Solaris, BSD 系やおそらく他のシステムもそうだが) 多くのシステムでは、 +この呼び出しは以下と等価である。 getitimer(which, &old_value); -In Linux, this is treated as being equivalent to a call in which the -\fInew_value\fP fields are zero; that is, the timer is disabled. \fIDon't use -this Linux misfeature\fP: it is nonportable and unnecessary. +Linux では、この呼び出しは \fInew_value\fP フィールドが 0 の呼び出しと等価なものと扱われる。 つまり、タイマーが無効になる。 +\fILinux のこの間違った機能を使用しないこと\fP。移植性もなく、不必要な機能である。 .SH バグ シグナルの生成と配送は別個のものであり、 前述のシグナルのそれぞれについて一つだけがプロセスのために 待機する。 非常に重い負荷の下では、 \fBITIMER_REAL\fP タイマーでは、時間切れにより生成された一つ前のシグナルが配送される前に、 次の時間切れが起こる場合がある。 @@ -137,6 +136,6 @@ POSIX.1\-2001 では \fBsetitimer\fP() は \fItv_usec\fP の値が 0 から 999 \fBgettimeofday\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBtimer_create\fP(2), \fBtimerfd_create\fP(2), \fBtime\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/man2/getpagesize.2 b/release/man2/getpagesize.2 index 9ef010ce..891d9505 100644 --- a/release/man2/getpagesize.2 +++ b/release/man2/getpagesize.2 @@ -88,6 +88,6 @@ long sz = sysconf(_SC_PAGESIZE); .SH 関連項目 \fBmmap\fP(2), \fBsysconf\fP(3) .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/man2/getpeername.2 b/release/man2/getpeername.2 index 1e25c05d..7ecb8a37 100644 --- a/release/man2/getpeername.2 +++ b/release/man2/getpeername.2 @@ -84,25 +84,22 @@ getpeername \- 接続している相手ソケットの名前を取得する .SH 準拠 SVr4, 4.4BSD (\fBgetpeername\fP() 関数は 4.2BSD で登場した), POSIX.1\-2001. .SH 注意 -\fBgetpeername\fP() の三番目の引き数は実際には \fI`int *'\fP である (4.x BSD, libc4, libc5 では -このようになっている)。 POSIX では紆余曲折を経て現在の \fIsocklen_t\fP になっており、 glibc でも \fIsocklen_t\fP -を使っている。 \fBaccept\fP(2) も参照のこと。 +The third argument of \fBgetpeername\fP() is in reality an \fIint\ *\fP (and this +is what 4.x BSD and libc4 and libc5 have). Some POSIX confusion resulted in +the present \fIsocklen_t\fP, also used by glibc. See also \fBaccept\fP(2). -For stream sockets, once a \fBconnect\fP(2) has been performed, either socket -can call \fBgetpeername\fP() to obtain the address of the peer socket. On the -other hand, datagram sockets are connectionless. Calling \fBconnect\fP(2) on -a datagram socket merely sets the peer address for outgoing datagrams sent -with \fBwrite\fP(2) or \fBrecv\fP(2). The caller of \fBconnect\fP(2) can use -\fBgetpeername\fP() to obtain the peer address that it earlier set for the -socket. However, the peer socket is unaware of this information, and -calling \fBgetpeername\fP() on the peer socket will return no useful -information (unless a \fBconnect\fP(2) call was also executed on the peer). -Note also that the receiver of a datagram can obtain the address of the -sender when using \fBrecvfrom\fP(2). +ストリームソケットでは、 いったん \fBconnect\fP(2) が実行されると、 どのソケットも \fBgetpeername\fP() +を使って相手ソケットのアドレスを取得できる。 一方、データグラムソケットはコネクションレスである (接続がない)。 データグラムソケットに対する +\fBconnect\fP(2) の呼び出しは、 \fBwrite\fP(2) や \fBrecv\fP(2) +で送信される出力データグラムの相手アドレスを設定するだけである。 +\fBconnect\fP(2) の呼び出し元は、 \fBgetpeername\fP() +を使って、それ以前にそのソケットに設定された相手アドレスを取得することができる。 しかし、相手ソケットはこの情報を知らないので、 相手ソケットで +\fBgetpeername\fP() を呼び出しても、 役に立つ情報は得られない (相手側でも \fBconnect\fP(2) が呼び出されている場合を除く)。 +なお、データグラムの受信側では \fBrecvfrom\fP(2) を使って送信元アドレスを 取得できることも覚えておいてほしい。 .SH 関連項目 \fBaccept\fP(2), \fBbind\fP(2), \fBgetsockname\fP(2), \fBip\fP(7), \fBsocket\fP(7), \fBunix\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/man2/getpid.2 b/release/man2/getpid.2 index 1dbc78b4..fcd524d4 100644 --- a/release/man2/getpid.2 +++ b/release/man2/getpid.2 @@ -85,6 +85,6 @@ glibc バージョン 2.3.4 以降では、 glibc の \fBgetpid\fP() のラッ \fBclone\fP(2), \fBfork\fP(2), \fBkill\fP(2), \fBexec\fP(3), \fBmkstemp\fP(3), \fBtempnam\fP(3), \fBtmpfile\fP(3), \fBtmpnam\fP(3), \fBcredentials\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/man2/getpriority.2 b/release/man2/getpriority.2 index 5461c6fa..ddf99993 100644 --- a/release/man2/getpriority.2 +++ b/release/man2/getpriority.2 @@ -126,17 +126,15 @@ Ultrix 4.2, 4.3BSD, FreeBSD 4.3, OpenBSD\-2.5等) は、 Linux 2.6.12 以降と \fI\fP で \fIrusage\fP 構造体が定義されているが、そのフィールドで使用されている \fIstruct timeval\fP 型は \fI\fP で定義されている)。 .SH バグ -According to POSIX, the nice value is a per\-process setting. However, under -the current Linux/NPTL implementation of POSIX threads, the nice value is a -per\-thread attribute: different threads in the same process can have -different nice values. Portable applications should avoid relying on the -Linux behavior, which may be made standards conformant in the future. +POSIX では nice 値はプロセス単位の設定となっている。 一方、 現在の POSIX スレッドの Linux/NPTL 実装では、 nice +値はスレッド単位の属性である。 同じプロセスの別々のスレッドが異なる nice 値を持つ場合がある。 移植性が必要なアプリケーションではこの Linux +の動作を前提するのは避けるべきである。 Linux の動作は将来標準に準拠した動作になるかもしれない。 .SH 関連項目 \fBnice\fP(1), \fBrenice\fP(1), \fBfork\fP(2), \fBcapabilities\fP(7) Linux カーネルのソースツリー内の \fIDocumentation/scheduler/sched\-nice\-design.txt\fP (Linux 2.6.23 以降) .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/man2/getresuid.2 b/release/man2/getresuid.2 index 6aaceee7..a8bd8315 100644 --- a/release/man2/getresuid.2 +++ b/release/man2/getresuid.2 @@ -68,6 +68,6 @@ glibc の \fBgetresuid\fP() と \fBgetresgid\fP() のラッパー関数は \fBgetuid\fP(2), \fBsetresuid\fP(2), \fBsetreuid\fP(2), \fBsetuid\fP(2), \fBcredentials\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/man2/getrlimit.2 b/release/man2/getrlimit.2 index e4950543..b26179d2 100644 --- a/release/man2/getrlimit.2 +++ b/release/man2/getrlimit.2 @@ -173,8 +173,10 @@ ID にロックされる 共有メモリセグメント (\fBshmget\fP(2) を参 .fi ここで \fIattr\fP は \fImq_attr\fP 構造体であり、 \fBmq_open\fP(3) の第 4 引き数として指定される。 -\fIsizeof(struct msg_msg *)\fP (Linux/i386 では 4 バイト) を含む最初の加数は、 ユーザーが長さ 0 -のメッセージを無制限に作れないこと保証している (このようなメッセージであっても、 記録のためのオーバーヘッドでシステムメモリを消費する)。 +The first addend in the formula, which includes \fIsizeof(struct msg_msg\ *)\fP +(4 bytes on Linux/i386), ensures that the user cannot create an unlimited +number of zero\-length messages (such messages nevertheless each consume some +system memory for bookkeeping overhead). .TP \fBRLIMIT_NICE\fP (Linux 2.6.12 以降, 下記の「バグ」の節も参照) \fBsetpriority\fP(2) や \fBnice\fP(2) を使って引き上げられるプロセスの nice 値の上限を指定する。 nice @@ -234,29 +236,24 @@ Linux 2.6.23 以降では、この制限はプロセスのコマンドライン .\" commit c022a0acad534fd5f5d5f17280f6d4d135e74e81 .\" Author: Jiri Slaby .\" Date: Tue May 4 18:03:50 2010 +0200 -The Linux\-specific \fBprlimit\fP() system call combines and extends the -functionality of \fBsetrlimit\fP() and \fBgetrlimit\fP(). It can be used to both -set and get the resource limits of an arbitrary process. +Linux 固有の \fBprlimit\fP() システムコールは、 \fBsetrlimit\fP() と \fBgetrlimit\fP +の機能を合わせて拡張したものである。 このシステムコールを使って、任意のプロセスのリソース上限の設定と取得を行うことができる。 -The \fIresource\fP argument has the same meaning as for \fBsetrlimit\fP() and -\fBgetrlimit\fP(). +\fIresource\fP 引き数は \fBsetrlimit\fP() や \fBgetrlimit\fP() と同じ意味である。 -If the \fInew_limit\fP argument is a not NULL, then the \fIrlimit\fP structure to -which it points is used to set new values for the soft and hard limits for -\fIresource\fP. If the \fIold_limit\fP argument is a not NULL, then a successful -call to \fBprlimit\fP() places the previous soft and hard limits for -\fIresource\fP in the \fIrlimit\fP structure pointed to by \fIold_limit\fP. +\fInew_limit\fP 引き数が NULL 以外の場合、 \fInew_limit\fP が指す \fIrlimit\fP 構造体を使って \fIresource\fP +のソフトリミットとハードリミットの新しい値が設定される。 \fIold_limit\fP 引き数が NULL 以外の場合、 \fBprlimit\fP() +の呼び出しが成功すると、 \fIresource\fP の直前のソフトリミットとハードリミットが \fIold_limit\fP が指す \fIrlimit\fP +構造体に格納される。 .\" FIXME this permission check is strange .\" Asked about this on LKML, 7 Nov 2010 .\" "Inconsistent credential checking in prlimit() syscall" -The \fIpid\fP argument specifies the ID of the process on which the call is to -operate. If \fIpid\fP is 0, then the call applies to the calling process. To -set or get the resources of a process other than itself, the caller must -have the \fBCAP_SYS_RESOURCE\fP capability, or the real, effective, and saved -set user IDs of the target process must match the real user ID of the caller -\fIand\fP the real, effective, and saved set group IDs of the target process -must match the real group ID of the caller. +\fIpid\fP 引き数は呼び出しの操作対象となるプロセス ID を指定する。 \fIpid\fP が 0 +の場合、呼び出しは呼び出し元プロセスに対して適用される。 自分以外のプロセスのリソースの設定と取得を行うためには、 呼び出し元プロセスが +\fBCAP_SYS_RESOURCE\fP ケーパビリティを持っているか、 対象となるプロセスの実ユーザ ID、 実効ユーザ ID、 保存 +set\-user\-ID が呼び出し元プロセスの実ユーザ ID と一致し、 かつ、 対象となるプロセスの実グループ ID、 実効グループ ID、 保存 +set\-group\-ID が呼び出し元プロセスの実グループ ID と一致していなければならない。 .SH 返り値 成功した場合、これらのシステムコールは 0 を返す。 エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。 @@ -279,14 +276,14 @@ must match the real group ID of the caller. 設定する許可を持っていなかった。 .TP \fBESRCH\fP -Could not find a process with the ID specified in \fIpid\fP. +\fIpid\fP で指定された ID のプロセスが見つからなかった。 .SH バージョン -The \fBprlimit\fP() system call is available since Linux 2.6.36. Library -support is available since glibc 2.13. +\fBprlimit\fP() システムコールは Linux 2.6.36 以降で利用できる。 ライブラリのサポートは glibc 2.13 +以降で利用できる。 .SH 準拠 \fBgetrlimit\fP(), \fBsetrlimit\fP(): SVr4, 4.3BSD, POSIX.1\-2001. .br -\fBprlimit\fP(): Linux\-specific. +\fBprlimit\fP(): Linux 固有。 \fBRLIMIT_MEMLOCK\fP と \fBRLIMIT_NPROC\fP は BSD から派生し、 POSIX.1\-2001 には指定されていない。 @@ -302,8 +299,8 @@ POSIX.1\-2001 には指定されていない。 シェルのリソース制限は、シェルの組み込みコマンドである \fIulimit\fP (\fBcsh\fP(1) では \fIlimit )\fP を使って設定することができる。 このシェルのリソース制限は、コマンドを実行してシェルが生成するプロセス に引き継がれる。 -Since Linux 2.6.24, the resource limits of any process can be inspected via -\fI/proc/[pid]/limits\fP; see \fBproc\fP(5). +Linux 2.6.24 以降では、 プロセスのリソース上限は \fI/proc/[pid]/limits\fP で知ることができる。 \fBproc\fP(5) +参照。 古いシステムでは、 \fBsetrlimit\fP() と同様の目的を持つ関数 \fBvlimit\fP() が提供されていた。 後方互換性のため、glibc でも \fBvlimit\fP() を提供している。 全ての新しいアプリケーションでは、 \fBsetrlimit\fP() を使用すべきである。 @@ -337,21 +334,17 @@ Since Linux 2.6.24, the resource limits of any process can be inspected via .\" Date: 2005-01-23 23:27:46 GMT .\" Tested Solaris 10, FreeBSD 9, OpenBSD 5.0 .\" FIXME https://bugzilla.kernel.org/show_bug.cgi?id=50951 -Since Linux 2.6.12, if a process reaches its soft \fBRLIMIT_CPU\fP limit and -has a handler installed for \fBSIGXCPU\fP, then, in addition to invoking the -signal handler, the kernel increases the soft limit by one second. This -behavior repeats if the process continues to consume CPU time, until the -hard limit is reached, at which point the process is killed. Other -implementations do not change the \fBRLIMIT_CPU\fP soft limit in this manner, -and the Linux behavior is probably not standards conformant; portable -applications should avoid relying on this Linux\-specific behavior. The -Linux\-specific \fBRLIMIT_RTTIME\fP limit exhibits the same behavior when the -soft limit is encountered. +Linux 2.6.12 以降では、 プロセスがその \fBRLIMIT_CPU\fP ソフトリミットに達し、 \fBSIGXCPU\fP +に対してシグナルハンドラが設定されている場合、 シグナルハンドラを起動するだけでなく、 カーネルは 1 秒間ソフトリミットを増やす。 そのプロセスが +CPU 時間を消費し続けている限り、 ハードリミットに達するまで、この動作が繰り返される。 ハードリミットに達すると、その時点でプロセスは kill +される。 他の実装では、上記のような \fBRLIMIT_CPU\fP ソフトリミットの変更は行われず、 おそらく Linux の動作は標準に準拠していない。 +移植性が必要なアプリケーションではこの Linux 固有の動作を前提にするのは避けるべきである。 Linux 固有の上限 +\fBRLIMIT_RTTIME\fP でも、 ソフトリミットに達した場合に同じ動作となる。 2.4.22 より前のカーネルでは、 \fIrlim\->rlim_cur\fP が \fIrlim\->rlim_max\fP より大きかった場合、 \fBsetrlimit\fP() での \fBEINVAL\fP エラーを検出できない。 .SH 例 -The program below demonstrates the use of \fBprlimit\fP(). +以下のプログラムに \fBprlimit\fP() の使用例を示す。 .PP .nf #define _GNU_SOURCE @@ -411,6 +404,6 @@ main(int argc, char *argv[]) \fBshmctl\fP(2), \fBmalloc\fP(3), \fBsigqueue\fP(3), \fBulimit\fP(3), \fBcore\fP(5), \fBcapabilities\fP(7), \fBsignal\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/man2/getrusage.2 b/release/man2/getrusage.2 new file mode 100644 index 00000000..32882f47 --- /dev/null +++ b/release/man2/getrusage.2 @@ -0,0 +1,202 @@ +.\" Copyright (c) 1992 Drew Eckhardt, March 28, 1992 +.\" and Copyright (c) 2002 Michael Kerrisk +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" 2004-11-16 -- mtk: the getrlimit.2 page, which formerly included +.\" coverage of getrusage(2), has been split, so that the latter is +.\" now covered in its own getrusage.2. For older details of change +.\" history, etc., see getrlimit.2 +.\" +.\" Modified 2004-11-16, mtk, Noted that the nonconformance +.\" when SIGCHLD is being ignored is fixed in 2.6.9. +.\" 2008-02-22, Sripathi Kodi : Document RUSAGE_THREAD +.\" 2008-05-25, mtk, clarify RUSAGE_CHILDREN + other clean-ups. +.\" 2010-05-24, Mark Hills : Description of fields, +.\" document ru_maxrss +.\" 2010-05-24, mtk, enhanced description of various fields +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH GETRUSAGE 2 2010\-09\-26 Linux "Linux Programmer's Manual" +.SH 名前 +getrusage \- 資源の使用量を取得する +.SH 書式 +\fB#include \fP +.br +\fB#include \fP +.sp +\fBint getrusage(int \fP\fIwho\fP\fB, struct rusage *\fP\fIusage\fP\fB);\fP +.SH 説明 +.PP +\fBgetrusage\fP() は \fIwho\fP の資源 (resource) の使用量を返す。 \fIwho\fP には以下のいずれか一つを指定できる。 +.TP +\fBRUSAGE_SELF\fP +呼び出したプロセスの資源使用量、 そのプロセス内の全スレッドが使用している資源の合計を返す。 +.TP +\fBRUSAGE_CHILDREN\fP +呼び出したプロセスの子プロセスのうち、 終了して待ち状態にある全プロセスが使用している資源使用量の統計を返す。 +これらの統計情報には、孫プロセスやその子孫のプロセスのうち、 削除待ちのものが使用している資源も含まれる。 +.TP +\fBRUSAGE_THREAD\fP (Linux 2.6.26 以降) +呼び出したスレッドに関する資源使用量の統計を返す。 +.PP +資源使用量は \fIusage\fP が指す構造体に格納されて返される。 構造体は以下の形式である。 +.PP +.in +4n +.nf +struct rusage { + struct timeval ru_utime; /* 使用されたユーザー CPU 時間 */ + struct timeval ru_stime; /* 使用されたシステム CPU 時間 */ + long ru_maxrss; /* RAM 上に存在する仮想ページのサイズ + (resident set size) の最大値 */ + long ru_ixrss; /* 共有メモリの合計サイズ */ + long ru_idrss; /* 非共有データの合計サイズ */ + long ru_isrss; /* 非共有スタックの合計サイズ */ + long ru_minflt; /* ページの再利用 (ソフトページフォルト) */ + long ru_majflt; /* ページフォールト (ハードページフォルト) */ + long ru_nswap; /* スワップ */ + long ru_inblock; /* ブロック入力操作 */ + long ru_oublock; /* ブロック出力操作 */ + long ru_msgsnd; /* 送信された IPC メッセージ */ + long ru_msgrcv; /* 受信された IPC メッセージ */ + long ru_nsignals; /* 受信されたシグナル */ + long ru_nvcsw; /* 意図したコンテキスト切り替え */ + long ru_nivcsw; /* 意図しないコンテキスト切り替え */ +}; +.fi +.in +.PP +すべてのフィールドがサポートされているわけではない。 メンテナンスされていないフィールドには、 カーネルが 0 を設定する +(メンテナンスされていないフィールドは、 他のシステムとの互換性のために提供されており、 いつか Linux でもサポートされるかもしれない)。 +各フィールドの詳細は以下の通りである。 +.TP +\fIru_utime\fP +ユーザモードでの実行で消費された合計時間。 \fItimeval\fP 構造体 (秒とミリ秒) で表現される。 +.TP +\fIru_stime\fP +カーネルモードでの実行で消費された合計時間。 \fItimeval\fP 構造体 (秒とミリ秒) で表現される。 +.TP +\fIru_maxrss\fP (Linux 2.6.32 以降) +使用された resident set size の最大値 (キロバイト単位)。 \fBRUSAGE_CHILDREN\fP の場合には、プロセスツリーの +resident set size の最大値ではなく、 最も大きい子プロセスの resident set size となる。 +.TP +\fIru_ixrss\fP (メンテナンスされていない) +.\" On some systems, +.\" this is the integral of the text segment memory consumption, +.\" expressed in kilobyte-seconds. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_idrss\fP (メンテナンスされていない) +.\" On some systems, this is the integral of the data segment memory consumption, +.\" expressed in kilobyte-seconds. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_isrss\fP (メンテナンスされていない) +.\" On some systems, this is the integral of the stack memory consumption, +.\" expressed in kilobyte-seconds. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_minflt\fP +I/O 動作なしで発生したページフォルトの回数。 再割り当てを待っているページリストからページフレームを「回収」 (reclaim) することで、 +I/O 動作を避けることができる。 +.TP +\fIru_majflt\fP +I/O 動作を必要とするページフォルトの回数。 +.TP +\fIru_nswap\fP (メンテナンスされていない) +.\" On some systems, this is the number of swaps out of physical memory. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_inblock\fP (Linux 2.6.22 以降) +ファイルシステムが入力を実行する必要があった回数。 +.TP +\fIru_oublock\fP (Linux 2.6.22 以降) +ファイルシステムが出力を実行する必要があった回数。 +.TP +\fIru_msgsnd\fP (メンテナンスされていない) +.\" On FreeBSD 6.2, this appears to measure messages sent over sockets +.\" On some systems, +.\" this field records the number of messages sent over sockets. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_msgrcv\fP (メンテナンスされていない) +.\" On FreeBSD 6.2, this appears to measure messages received over sockets +.\" On some systems, +.\" this field records the number of messages received over sockets. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_nsignals\fP (メンテナンスされていない) +.\" On some systems, this field records the number of signals received. +このフィールドは現在のところ Linux では未使用である。 +.TP +\fIru_nvcsw\fP (Linux 2.6 以降) +自分のタイムスライスが完了する前にプロセスが自発的にプロセッサを解放して行われたコンテキストスイッチの回数 +(通常はリソースが利用可能になるのを待つために行われる)。 +.TP +\fImemory_migrate\fP (Linux 2.6.16 以降) +優先度が自分より高いプロセッサが実行可能になったか、現在のプロセスが自分のタイムスライスを超過したことにより行われたコンテキストスイッチの回数。 +.PP +.SH 返り値 +成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。 +.SH エラー +.TP +\fBEFAULT\fP +\fIusage\fP がアクセス可能なアドレス空間の外を指している。 +.TP +\fBEINVAL\fP +\fIwho\fP が無効である。 +.SH 準拠 +SVr4, 4.3BSD. POSIX.1\-2001 は \fBgetrusage\fP() を規定しているが、規定しているフィールドは +\fIru_utime\fP と \fIru_stime\fP だけである。 + +\fBRUSAGE_THREAD\fP は Linux 固有である。 +.SH 注意 +\fBexecve\fP(2) の前後でリソース使用量の指標は保持される。 + +今日では \fI\fP をインクルードする必要はないが、 インクルードしておけば移植性が増す。 (実際 +\fIstruct timeval\fP は \fI\fP で定義されている。) +.PP +.\" See the description of getrusage() in XSH. +.\" A similar statement was also in SUSv2. +2.6.9 より前のバージョンの Linux カーネルでは、 \fBSIGCHLD\fP の処理が \fBSIG_IGN\fP に設定されていると、 +子プロセスのリソース使用量が \fBRUSAGE_CHILDREN\fP で返される値に自動的に含められる。 しかし POSIX.1\-2001 +では、これを明確に禁止している。 この準拠していなかった点は、Linux 2.6.9 以降で改正された。 +.LP +このページの最初で示した構造体の定義は 4.3BSD Reno のものである。 + +古いシステムでは、 \fBgetrusage\fP() と同様の目的を持つ関数 \fBvtimes\fP() が提供 +されていた。後方互換性のため、glibc でも \fBvtimes\fP() を提供している。 +全ての新しいアプリケーションでは \fBgetrusage\fP() を使用すべきである。 + +\fBproc\fP(5) にある \fI/proc/PID/stat\fP の説明も参照のこと。 +.SH 関連項目 +\fBclock_gettime\fP(2), \fBgetrlimit\fP(2), \fBtimes\fP(2), \fBwait\fP(2), \fBwait4\fP(2), +\fBclock\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man2/getsid.2 b/release/man2/getsid.2 index b1d0292e..ef80a5b6 100644 --- a/release/man2/getsid.2 +++ b/release/man2/getsid.2 @@ -73,6 +73,6 @@ Linux は \fBEPERM\fP を返さない。 .SH 関連項目 \fBgetpgid\fP(2), \fBsetsid\fP(2), \fBcredentials\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/man2/getsockname.2 b/release/man2/getsockname.2 index 4833ebe3..163dc81b 100644 --- a/release/man2/getsockname.2 +++ b/release/man2/getsockname.2 @@ -81,13 +81,13 @@ getsockname \- ソケットの名前を取得する .\" and ENOSR error codes. SVr4, 4.4BSD (\fBgetsockname\fP() 関数は 4.2BSD で追加された), POSIX.1\-2001. .SH 注意 -\fBgetsockname\fP() の三番目の引き数は (4.x BSD や libc4, libc5 と同様に) 実際には \fIint *\fP である。 -glibc でも使われている現在の \fIsocklen_t\fP に関して、 POSIX には少し混乱がある。 詳しくは \fBaccept\fP(2) -を参照のこと。 +The third argument of \fBgetsockname\fP() is in reality an \fIint\ *\fP (and this +is what 4.x BSD and libc4 and libc5 have). Some POSIX confusion resulted in +the present \fIsocklen_t\fP, also used by glibc. See also \fBaccept\fP(2). .SH 関連項目 \fBbind\fP(2), \fBsocket\fP(2), \fBgetifaddrs\fP(3), \fBip\fP(7), \fBsocket\fP(7), \fBunix\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/man2/getsockopt.2 b/release/man2/getsockopt.2 index 09a81790..ef73bac1 100644 --- a/release/man2/getsockopt.2 +++ b/release/man2/getsockopt.2 @@ -125,6 +125,6 @@ glibc でも \fIsocklen_t\fP を使っている。 \fBaccept\fP(2) も参照の \fBioctl\fP(2), \fBsocket\fP(2), \fBgetprotoent\fP(3), \fBprotocols\fP(5), \fBsocket\fP(7), \fBtcp\fP(7), \fBunix\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/man2/gettid.2 b/release/man2/gettid.2 index 60756517..8b851426 100644 --- a/release/man2/gettid.2 +++ b/release/man2/gettid.2 @@ -69,6 +69,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し \fBsched_setaffinity\fP(2), \fBsched_setparam\fP(2), \fBsched_setscheduler\fP(2), \fBtimer_create\fP(2), \fBtgkill\fP(2) .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/man2/gettimeofday.2 b/release/man2/gettimeofday.2 index b73d91c2..027aa3c1 100644 --- a/release/man2/gettimeofday.2 +++ b/release/man2/gettimeofday.2 @@ -179,6 +179,6 @@ Linux において \fBsettimeofday\fP() を呼び出すときは、 \fBctime\fP(3), \fBftime\fP(3), \fBtimeradd\fP(3), \fBcapabilities\fP(7), \fBtime\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/man2/getuid.2 b/release/man2/getuid.2 index c8ec1c41..cdfc572d 100644 --- a/release/man2/getuid.2 +++ b/release/man2/getuid.2 @@ -61,6 +61,6 @@ glibc の \fBgetuid\fP() と \fBgeteuid\fP() のラッパー関数は .SH 関連項目 \fBgetresuid\fP(2), \fBsetreuid\fP(2), \fBsetuid\fP(2), \fBcredentials\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/man2/getxattr.2 b/release/man2/getxattr.2 index 478953d4..cd3a0bec 100644 --- a/release/man2/getxattr.2 +++ b/release/man2/getxattr.2 @@ -96,6 +96,6 @@ inode に対して、互いに独立な名前空間が複数あってもよい \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBlistxattr\fP(2), \fBopen\fP(2), \fBremovexattr\fP(2), \fBsetxattr\fP(2), \fBstat\fP(2), \fBattr\fP(5), \fBsymlink\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/man2/idle.2 b/release/man2/idle.2 index 64de9fbf..8ef62dbf 100644 --- a/release/man2/idle.2 +++ b/release/man2/idle.2 @@ -59,6 +59,6 @@ Linux 2.3.13 以降では、もはやこのシステムコールは存在しな .SH 準拠 この関数は Linux 特有であり、移植を意図したプログラムでは 使用すべきでない。 .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/man2/inotify_add_watch.2 b/release/man2/inotify_add_watch.2 index c8bd06c7..038d1b7b 100644 --- a/release/man2/inotify_add_watch.2 +++ b/release/man2/inotify_add_watch.2 @@ -86,6 +86,6 @@ inotify は Linux カーネル 2.6.13 に組み込まれた。 .SH 関連項目 \fBinotify_init\fP(2), \fBinotify_rm_watch\fP(2), \fBinotify\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/man2/inotify_init.2 b/release/man2/inotify_init.2 index 473c59c5..9e231836 100644 --- a/release/man2/inotify_init.2 +++ b/release/man2/inotify_init.2 @@ -80,6 +80,6 @@ inotify インスタンスの総数がシステムの上限に達していた。 .SH 関連項目 \fBinotify_add_watch\fP(2), \fBinotify_rm_watch\fP(2), \fBinotify\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/man2/inotify_rm_watch.2 b/release/man2/inotify_rm_watch.2 index e0cb0db8..c08458ad 100644 --- a/release/man2/inotify_rm_watch.2 +++ b/release/man2/inotify_rm_watch.2 @@ -59,6 +59,6 @@ inotify は Linux カーネル 2.6.13 に組み込まれた。 .SH 関連項目 \fBinotify_add_watch\fP(2), \fBinotify_init\fP(2), \fBinotify\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/man2/intro.2 b/release/man2/intro.2 index 104eaaad..3818275d 100644 --- a/release/man2/intro.2 +++ b/release/man2/intro.2 @@ -71,6 +71,6 @@ Linux のシステムコールのリストについては \fBsyscalls\fP(2) を \fBsem_overview\fP(7), \fBshm_overview\fP(7), \fBsignal\fP(7), \fBsocket\fP(7), \fBstandards\fP(7), \fBsvipc\fP(7), \fBsymlink\fP(7), \fBtime\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/man2/io_cancel.2 b/release/man2/io_cancel.2 index 9e7f16d1..acc5a808 100644 --- a/release/man2/io_cancel.2 +++ b/release/man2/io_cancel.2 @@ -72,6 +72,6 @@ glibc はこのシステムコールのラッパー関数を提供していな \fBio_destroy\fP(2), \fBio_getevents\fP(2), \fBio_setup\fP(2), \fBio_submit\fP(2), \fBaio\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/man2/io_destroy.2 b/release/man2/io_destroy.2 index 6ee214b0..3aa859f0 100644 --- a/release/man2/io_destroy.2 +++ b/release/man2/io_destroy.2 @@ -66,6 +66,6 @@ glibc はこのシステムコールのラッパー関数を提供していな \fBio_cancel\fP(2), \fBio_getevents\fP(2), \fBio_setup\fP(2), \fBio_submit\fP(2), \fBaio\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/man2/io_getevents.2 b/release/man2/io_getevents.2 index f6e4b21a..3f640074 100644 --- a/release/man2/io_getevents.2 +++ b/release/man2/io_getevents.2 @@ -80,6 +80,6 @@ glibc はこのシステムコールのラッパー関数を提供していな \fBio_cancel\fP(2), \fBio_destroy\fP(2), \fBio_setup\fP(2), \fBio_submit\fP(2), \fBaio\fP(7), \fBtime\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/man2/io_setup.2 b/release/man2/io_setup.2 index 0d41ccc4..da3dd887 100644 --- a/release/man2/io_setup.2 +++ b/release/man2/io_setup.2 @@ -9,7 +9,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH IO_SETUP 2 2013\-04\-08 Linux "Linux Programmer's Manual" +.TH IO_SETUP 2 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 io_setup \- 非同期 I/O コンテキストを作成する .SH 書式 @@ -22,8 +22,8 @@ io_setup \- 非同期 I/O コンテキストを作成する \fI注\fP: このシステムコールには glibc のラッパー関数は存在しない。「注意」の節を参照。 .SH 説明 .PP -\fBio_setup\fP() システムコールは、少なくとも \fInr_events\fP 個のイベントを -同時に実行可能な非同期 I/O (AIO) コンテキストの作成を行う。 \fIctx_idp\fP 引き数 +\fBio_setup\fP() システムコールは、 \fInr_events\fP 個のイベントを +同時に実行に適した非同期 I/O (AIO) コンテキストの作成を行う。 \fIctx_idp\fP 引き数 は、すでに存在する AIO コンテキストを指していてはならず、 \fBio_setup\fP() の呼び出しの前に 0 に初期化されていなければならない。 AIO コンテキストの作成に成功すると、 \fI*ctx_idp\fP に作成された AIO @@ -79,6 +79,6 @@ glibc はこのシステムコールのラッパー関数を提供していな \fBio_cancel\fP(2), \fBio_destroy\fP(2), \fBio_getevents\fP(2), \fBio_submit\fP(2), \fBaio\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/man2/io_submit.2 b/release/man2/io_submit.2 index eb9656e1..34e0e77e 100644 --- a/release/man2/io_submit.2 +++ b/release/man2/io_submit.2 @@ -78,6 +78,6 @@ glibc はこのシステムコールのラッパー関数を提供していな \fBio_cancel\fP(2), \fBio_destroy\fP(2), \fBio_getevents\fP(2), \fBio_setup\fP(2), \fBaio\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/man2/ioctl.2 b/release/man2/ioctl.2 index 9b6560fa..2758ec12 100644 --- a/release/man2/ioctl.2 +++ b/release/man2/ioctl.2 @@ -94,6 +94,6 @@ UNIX の ストリーム I/O モデル に きちんと適合していない操 .\" .BR mt (4), \fBexecve\fP(2), \fBfcntl\fP(2), \fBioctl_list\fP(2), \fBopen\fP(2), \fBsd\fP(4), \fBtty\fP(4) .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/man2/ioctl_list.2 b/release/man2/ioctl_list.2 index 46b47fac..d4df508b 100644 --- a/release/man2/ioctl_list.2 +++ b/release/man2/ioctl_list.2 @@ -40,9 +40,10 @@ ioctl_list \- Linux/i386 カーネルの ioctl のリスト コールの一覧です。このリストは \fI\fP にある 421 の ioctl を含んでいます。全ての ioctl に対して、数値、名称、 引き数の型を列挙してあります。 .PP -引き数型 \fIconst struct foo *\fP は、その引き数がカーネルへの入力である事を意味します。また、 \fIstruct foo *\fP -は、その引き数がカーネルからの出力である事を意味します。 カーネルがその引き数を入力と出力の両方に使用する場合は、 \fI//\ I\-O\fP -マークを付けてあります。 +An argument type of \fIconst struct foo\ *\fP means the argument is input to +the kernel. \fIstruct foo\ *\fP means the kernel outputs the argument. If the +kernel uses the argument for both input and output, this is marked with +\fI//\ I\-O\fP. .PP いくつかの ioctl は複数の構造体の引き数を必要としたり、値を返したり します。これらには \fI//\ MORE\fP マークを付けて、 さらに分離したセクションで説明してあります。 @@ -726,13 +727,15 @@ l l l. // More arguments. いくつかの ioctl は追加のポインタを含む構造体へのポインタを使用します。 ここでこれらをアルファベット順に説明します。 -\fBCDROMREADAUDIO\fP は入力ポインタ \fIconst struct cdrom_read_audio *\fP を使用します。 \fIbuf\fP -フィールドは大きさ \fInframes * CD_FRAMESIZE_RAW\fP の出力バッファへのポインタです。 +\fBCDROMREADAUDIO\fP takes an input pointer \fIconst struct cdrom_read_audio\ *\fP. The \fIbuf\fP field points to an output buffer of length \fInframes\ * +CD_FRAMESIZE_RAW\fP. -\fBCDROMREADCOOKED\fP, \fBCDROMREADMODE1\fP, \fBCDROMREADMODE2\fP, \fBCDROMREADRAW\fP -は入力ポインタ \fIconst struct cdrom_msf *\fP を使用します。これらは同じポインタを \fIchar []\fP -への出力ポインタとして使用します。 長さは要求によって変化します。 \fBCDROMREADMODE1\fP には、多くのデバイスが CD_FRAMESIZE -を使用しますが、光学記憶装置 (光ディスク) のドライバは OPT_BLOCKSIZE を使用します (どちらも同じ値で 2048 です)。 +\fBCDROMREADCOOKED\fP, \fBCDROMREADMODE1\fP, \fBCDROMREADMODE2\fP, and +\fBCDROMREADRAW\fP take an input pointer \fIconst struct cdrom_msf\ *\fP. They +use the same pointer as an output pointer to \fIchar []\fP. The length varies +by request. For \fBCDROMREADMODE1\fP, most drivers use CD_FRAMESIZE, but the +Optics Storage driver uses OPT_BLOCKSIZE instead (both have the numerical +value 2048). .nf CDROMREADCOOKED char [CD_FRAMESIZE] @@ -742,8 +745,8 @@ l l l. .fi \fBEQL_ENSLAVE\fP, \fBEQL_EMANCIPATE\fP, \fBEQL_GETSLAVECFG\fP, \fBEQL_SETSLAVECFG\fP, -\fBEQL_GETMASTERCFG\fP, \fBEQL_SETMASTERCFG\fP は \fIstruct ifreq *\fP を使用します。 -\fIifr_data\fP フィールドは以下に示す別の構造体へのポインタです: +\fBEQL_GETMASTERCFG\fP, and \fBEQL_SETMASTERCFG\fP take a \fIstruct ifreq\ *\fP. The +\fIifr_data\fP field is a pointer to another structure as follows: .nf EQL_ENSLAVE const struct slaving_request * @@ -754,17 +757,20 @@ l l l. EQL_SETMASTERCFG const struct master_config * .fi -\fBFDRAWCMD\fP は \fIstruct floppy raw_cmd *\fP を使用します。 \fIflags & FD_RAW_WRITE\fP -がゼロ以外の場合、 \fIdata\fP は大きさ \fIlength\fP の入力バッファへのポインタになります。 \fIflags & FD_RAW_READ\fP -がゼロ以外の場合、 \fIdata\fP は大きさ \fIlength\fP の出力バッファへのポインタになります。 +\fBFDRAWCMD\fP takes a \fIstruct floppy raw_cmd\ *\fP. If \fIflags & FD_RAW_WRITE\fP +is nonzero, then \fIdata\fP points to an input buffer of length \fIlength\fP. If +\fIflags & FD_RAW_READ\fP is nonzero, then \fIdata\fP points to an output buffer +of length \fIlength\fP. -\fBGIO_FONTX\fP, \fBPIO_FONTX\fP はそれぞれ \fIstruct console_font_desc *\fP と \fIconst -struct console_font_desc *\fP を使用します。 \fIchardata\fP は \fIchar [charcount]\fP -バッファへのポインタです。 これは \fBGIO_FONTX\fP の出力バッファと \fBPIO_FONTX\fP の入力バッファです。 +\fBGIO_FONTX\fP and \fBPIO_FONTX\fP take a \fIstruct console_font_desc\ *\fP or a +\fIconst struct console_font_desc\ *\fP, respectively. \fIchardata\fP points to a +buffer of \fIchar [charcount]\fP. This is an output buffer for \fBGIO_FONTX\fP +and an input buffer for \fBPIO_FONTX\fP. -\fBGIO_UNIMAP\fP, \fBPIO_UNIMAP\fP はそれぞれ \fIstruct unimapdesc *\fP と \fIconst struct -unimapdesc *\fP を使用します。 \fIentries\fP は \fIstruct unipair [entry_ct]\fP -バッファへのポインタです。 これは \fBGIO_UNIMAP\fP の出力バッファと \fBPIO_UNIMAP\fP の入力バッファです。 +\fBGIO_UNIMAP\fP and \fBPIO_UNIMAP\fP take a \fIstruct unimapdesc\ *\fP or a \fIconst +struct unimapdesc\ *\fP, respectively. \fIentries\fP points to a buffer of +\fIstruct unipair [entry_ct]\fP. This is an output buffer for \fBGIO_UNIMAP\fP +and an input buffer for \fBPIO_UNIMAP\fP. KDADDIO, KDDELIO, KDDISABIO, KDENABIO は I/O ポートへのアクセスを 可能/不可能にします。これらは本質的に、'ioperm' への別の インターフェースです。 @@ -772,8 +778,9 @@ KDADDIO, KDDELIO, KDDISABIO, KDENABIO は I/O ポートへのアクセスを \fBKDMAPDISP\fP, \fBKDUNMAPDISP\fP はメモリ・マッピングや I/O ポートへのアクセスを可能/不可能にします。 これらはカーネルに実装されていません。 -\fBSCSI_IOCTL_PROBE_HOST\fP は入力ポインタ \fIconst int *\fP を大きさとして使用します。これは同じ大きさの -\fIchar []\fP バッファ への出力ポインタとしても使用します。 +\fBSCSI_IOCTL_PROBE_HOST\fP takes an input pointer \fIconst int\ *\fP, which is a +length. It uses the same pointer as an output pointer to a \fIchar []\fP +buffer of this length. \fBSIOCADDRT\fP, \fBSIOCDELRT\fP は型が以下のプロトコルに依存する入力ポインタを使用します: .nf @@ -783,8 +790,9 @@ KDADDIO, KDDELIO, KDDISABIO, KDENABIO は I/O ポートへのアクセスを NET/ROM const struct nr_route_struct * .fi -\fBSIOCGIFCONF\fP は \fIstruct ifconf *\fP を使用します。この \fIifc_buf\fP フィールドは長さ \fIifc_len\fP -バイトのバッファへのポインタです。 これにカーネルが \fIstruct ifreq []\fP 型のリストへ書き込みます。 +\fBSIOCGIFCONF\fP takes a \fIstruct ifconf\ *\fP. The \fIifc_buf\fP field points to +a buffer of length \fIifc_len\fP bytes, into which the kernel writes a list of +type \fIstruct ifreq []\fP. \fBSIOCSIFHWADDR\fP は型が以下のプロトコルに依存する入力ポインタを使用します: .nf @@ -793,9 +801,10 @@ KDADDIO, KDDELIO, KDDISABIO, KDENABIO は I/O ポートへのアクセスを AX.25 const char [AX25_ADDR_LEN] .fi -\fBTIOCLINUX\fP は \fIconst char *\fP を使用します。このポインタをいくつかの -独立したサブクラスを識別する為に使用します。以下のテーブルの中で、 \fIN + foo\fP は N バイトの詰めものの後にある \fIfoo\fP -を意味します。 \fIstruct selection\fP は暗黙的に \fIdrivers/char/selection.c\fP の中で定義されています。 +\fBTIOCLINUX\fP takes a \fIconst char\ *\fP. It uses this to distinguish several +independent subcases. In the table below, \fIN + foo\fP means \fIfoo\fP after an +N\-byte pad. \fIstruct selection\fP is implicitly defined in +\fIdrivers/char/selection.c\fP .nf TIOCLINUX\-2 1 + const struct selection * @@ -822,6 +831,6 @@ l l l. .SH 関連項目 \fBioctl\fP(2) .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/man2/ioperm.2 b/release/man2/ioperm.2 index d42a545c..de226a7f 100644 --- a/release/man2/ioperm.2 +++ b/release/man2/ioperm.2 @@ -88,6 +88,6 @@ libc5 ではシステムコールとして扱い \fI\fP にプロト .SH 関連項目 \fBiopl\fP(2), \fBoutb\fP(2), \fBcapabilities\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/man2/iopl.2 b/release/man2/iopl.2 index 32082268..d7b5952a 100644 --- a/release/man2/iopl.2 +++ b/release/man2/iopl.2 @@ -43,8 +43,7 @@ iopl \- I/O 特権レベルを変更する .sp \fBint iopl(int \fP\fIlevel\fP\fB);\fP .SH 説明 -\fBiopl\fP() changes the I/O privilege level of the calling process, as -specified by the two least significant bits in \fIlevel\fP. +\fBiopl\fP() は呼び出し元のプロセスの I/O 特権レベルを \fIlevel\fP の下位 2 ビットで指定した値に変更する。 この関数は 8514 互換の X サーバを Linux で動作させるために必要である。 なぜならこの X サーバは 65536 個の I/O ポート全てへのアクセスを要求するので \fBioperm\fP(2) 関数では不十分だからである。 @@ -68,9 +67,8 @@ specified by the two least significant bits in \fIlevel\fP. このシステムコールは実装されていない。 .TP \fBEPERM\fP -The calling process has insufficient privilege to call \fBiopl\fP(); the -\fBCAP_SYS_RAWIO\fP capability is required to raise the I/O privilege level -above its current value. +呼び出し元プロセスに \fBiopl\fP() を呼び出すのに十分な権限がなかった。 I/O 特権レベルを現在の値より上げるには +\fBCAP_SYS_RAWIO\fP ケーパビリティが必要である。 .SH 準拠 \fBipc\fP() は Linux 特有であり、 移植を意図したプログラムでは 使用してはいけない。 .SH 注意 @@ -80,6 +78,6 @@ libc5 ではシステムコールとして扱い \fI\fP にプロト .SH 関連項目 \fBioperm\fP(2), \fBoutb\fP(2), \fBcapabilities\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/man2/ioprio_set.2 b/release/man2/ioprio_set.2 index 9ea92c85..c6917a33 100644 --- a/release/man2/ioprio_set.2 +++ b/release/man2/ioprio_set.2 @@ -35,7 +35,7 @@ ioprio_get, ioprio_set \- I/O スケジューリングクラスと優先度の \fBint ioprio_set(int \fP\fIwhich\fP\fB, int \fP\fIwho\fP\fB, int \fP\fIioprio\fP\fB);\fP .fi -\fINote\fP: There are no glibc wrappers for these system calls; see NOTES. +\fI注意\fP: これらのシステムコールには glibc ラッパー関数は存在しない。 「注意」の節を参照。 .SH 説明 システムコール \fBioprio_get\fP() / \fBioprio_set\fP() は、(1つ以上の) スレッドの I/O スケジューリングクラスと 優先度の取得/設定を行う。 @@ -44,13 +44,12 @@ ioprio_get, ioprio_set \- I/O スケジューリングクラスと優先度の をどのように解釈するかを決めるもので、以下のいずれか一つを指定する。 .TP \fBIOPRIO_WHO_PROCESS\fP -\fIwho\fP is a process ID or thread ID identifying a single process or thread. -If \fIwho\fP is 0, then operate on the calling thread. +\fIwho\fP は特定のプロセスやスレッドを特定するためのプロセス ID かスレッド ID である。 \fIwho\fP が 0 +の場合、呼び出し元のスレッドに対して操作が行われる。 .TP \fBIOPRIO_WHO_PGRP\fP -\fIwho\fP is a process group ID identifying all the members of a process -group. If \fIwho\fP is 0, then operate on the process group of which the -caller is a member. +\fIwho\fP はプロセスグループ ID であり、プロセスグループの全メンバが対象となる。 \fIwho\fP が 0 の場合、 +呼び出し元がメンバーとなっているプロセスグループに対して操作が行われる。 .TP \fBIOPRIO_WHO_USER\fP .\" FIXME who==0 needs to be documented, @@ -106,13 +105,10 @@ I/O 優先度は読み出しと同期書き込み (\fBO_DIRECT\fP, \fBO_SYNC\fP) .SH 注意 glibc はこれらのシステムコールに対するラッパー関数を提供していない。 \fBsyscall\fP(2) を使って呼び出すこと。 -Two or more processes or threads can share an I/O context. This will be the -case when \fBclone\fP(2) was called with the \fBCLONE_IO\fP flag. However, by -default, the distinct threads of a process will \fBnot\fP share the same I/O -context. This means that if you want to change the I/O priority of all -threads in a process, you may need to call \fBioprio_set\fP() on each of the -threads. The thread ID that you would need for this operation is the one -that is returned by \fBgettid\fP(2) or \fBclone\fP(2). +複数のプロセスやスレッドが一つの I/O コンテキストを共有する場合がある。 \fBclone\fP(2) を \fBCLONE_IO\fP +フラグ付きで呼び出した場合にはこの状況となる。 しかしながら、デフォルトでは、一つのプロセスの個々のスレッドは I/O コンテキストを共有「しない」。 +したがって、 プロセス内のすべてのスレッドの I/O 優先度を変更したい場合には、 それぞれのスレッドに対して \fBioprio_set\fP() +を呼び出す必要がある。 この操作を行うのに必要となるスレッド ID には \fBgettid\fP(2) か \fBclone\fP(2) が返す値を指定する。 これらのシステムコールは、I/O 優先度に対応した I/O スケジューラと 組み合わせて使用された場合にのみ効果を持つ。 カーネル 2.6.17 では、この条件を満たすスケジューラは Completely Fair Queuing (CFQ) I/O スケジューラだけである。 @@ -193,6 +189,6 @@ glibc は、このページに記載された関数プロトタイプやマク Linux カーネルソース内の \fIDocumentation/block/ioprio.txt\fP .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/man2/ipc.2 b/release/man2/ipc.2 index 57423bbf..488d282d 100644 --- a/release/man2/ipc.2 +++ b/release/man2/ipc.2 @@ -52,6 +52,6 @@ ipc \- System V IPC システムコール \fBsemget\fP(2), \fBsemop\fP(2), \fBshmat\fP(2), \fBshmctl\fP(2), \fBshmdt\fP(2), \fBshmget\fP(2) .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/man2/kexec_load.2 b/release/man2/kexec_load.2 index 669a71a4..fd2581f8 100644 --- a/release/man2/kexec_load.2 +++ b/release/man2/kexec_load.2 @@ -52,11 +52,12 @@ kexec_load \- 新しいカーネルを後で実行するためにロードする .\" FIXME figure out how this is really used システムのクラッシュ時に、新しいカーネルを自動的に実行する。 .TP -\fBKEXEC_PRESERVE_CONTEXT\fP (since Linux 2.6.27) -Preserve the system hardware and software states before executing the new -kernel. This could be used for system suspend. This flag is available only -if the kernel was configured with \fBCONFIG_KEXEC_JUMP\fP, and is effective -only if \fInr_segments\fP is greater than 0. +\fBKEXEC_PRESERVE_CONTEXT\fP (Linux 2.6.27 以降) +新しいカーネルを実行する前に、 +システムのハードウェアとソフトウェアの状態を保存する。 +システムの中断時 (suspend) などで使用できる。 +このフラグは、カーネルの設定で \fBCONFIG_KEXEC_JUMP\fP が有効の場合のみ +利用可能であり、 \fInr_segments\fP が 0 より大きい場合のみ効果がある。 .PP \fIflags\fP の下位ビットには、実行されるカーネルのアーキテクチャが入る。 現在のアーキテクチャを使うことを意味する定数 \fBKEXEC_ARCH_DEFAULT\fP か、 @@ -120,6 +121,6 @@ struct kexec_segment { .SH 関連項目 \fBreboot\fP(2), \fBsyscall\fP(2) .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/man2/kill.2 b/release/man2/kill.2 index 14391d5a..446dea3b 100644 --- a/release/man2/kill.2 +++ b/release/man2/kill.2 @@ -127,6 +127,6 @@ Linux では、特権のないプロセスが他のプロセスにシグナル \fB_exit\fP(2), \fBkillpg\fP(2), \fBsignal\fP(2), \fBtkill\fP(2), \fBexit\fP(3), \fBsigqueue\fP(3), \fBcredentials\fP(7), \fBcapabilities\fP(7), \fBsignal\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/man2/killpg.2 b/release/man2/killpg.2 index a7e8e42a..ef91e23a 100644 --- a/release/man2/killpg.2 +++ b/release/man2/killpg.2 @@ -77,7 +77,7 @@ set\-user\-ID と 等しくなければならない。 \fBSIGCONT\fP の場合 .SH エラー .TP \fBEINVAL\fP -\fIsig\fP で指定された値は無効なシグナル番号である。 +\fIsig\fP is not a valid signal number. .TP \fBEPERM\fP プロセスが、受信するプロセスのいずれに対しても シグナルを送る許可を持っていない。 @@ -100,6 +100,6 @@ Linux では、 \fBkillpg\fP() はライブラリ関数として実装されて \fBgetpgrp\fP(2), \fBkill\fP(2), \fBsignal\fP(2), \fBcredentials\fP(7), \fBcapabilities\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/man2/link.2 b/release/man2/link.2 index f7091614..e7c7da61 100644 --- a/release/man2/link.2 +++ b/release/man2/link.2 @@ -56,7 +56,7 @@ link \- ファイルの新しい名前を作成する へのディレクトリのどれかに検索許可がない (\fBpath_resolution\fP(7) を参照)。 .TP \fBEDQUOT\fP -The user's quota of disk blocks on the file system has been exhausted. +ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。 .TP \fBEEXIST\fP \fInewpath\fP が既に存在する。 @@ -95,8 +95,8 @@ I/O エラーが発生した。 \fIoldpath\fP と \fInewpath\fP を含んでいるファイルシステムがハードリンクをサポートしていない。 .TP \fBEPERM\fP (Linux 3.6 以降) -The caller does not have permission to create a hard link to this file (see -the description of \fI/proc/sys/fs/protected_hardlink\fP in \fBproc\fP(5)). +呼び出し元にこのファイルへのハードリンクを作成する許可がなかった (\fBproc\fP(5) の +\fI/proc/sys/fs/protected_hardlink\fP の説明を参照)。 .TP \fBEROFS\fP ファイルが読み込み専用のファイルシステムに存在する。 @@ -132,6 +132,6 @@ NFS ファイルシステムでは、NFS サーバーがリンクを作成した \fBln\fP(1), \fBlinkat\fP(2), \fBopen\fP(2), \fBrename\fP(2), \fBstat\fP(2), \fBsymlink\fP(2), \fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/linkat.2 b/release/man2/linkat.2 index 1dfb2606..0a84dbd1 100644 --- a/release/man2/linkat.2 +++ b/release/man2/linkat.2 @@ -98,6 +98,6 @@ POSIX.1\-2008. .SH 関連項目 \fBlink\fP(2), \fBopenat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/listen.2 b/release/man2/listen.2 index 7704642e..d65315ce 100644 --- a/release/man2/listen.2 +++ b/release/man2/listen.2 @@ -118,6 +118,6 @@ syncookie が有効になっている場合、 論理的な最大長は存在せ .SH 関連項目 \fBaccept\fP(2), \fBbind\fP(2), \fBconnect\fP(2), \fBsocket\fP(2), \fBsocket\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/man2/listxattr.2 b/release/man2/listxattr.2 index 542155bb..0a3849c4 100644 --- a/release/man2/listxattr.2 +++ b/release/man2/listxattr.2 @@ -110,6 +110,6 @@ system.posix_acl_access\e0system.posix_acl_default\e0 \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBgetxattr\fP(2), \fBopen\fP(2), \fBremovexattr\fP(2), \fBsetxattr\fP(2), \fBstat\fP(2), \fBattr\fP(5), \fBsymlink\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/man2/llseek.2 b/release/man2/llseek.2 index db49be9a..5e8119b9 100644 --- a/release/man2/llseek.2 +++ b/release/man2/llseek.2 @@ -68,6 +68,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し .SH 関連項目 \fBlseek\fP(2), \fBlseek64\fP(3) .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/man2/lookup_dcookie.2 b/release/man2/lookup_dcookie.2 index 0f10d163..c2b14616 100644 --- a/release/man2/lookup_dcookie.2 +++ b/release/man2/lookup_dcookie.2 @@ -74,6 +74,6 @@ Linux 2.5.43 以降で利用できる。 エラー \fBENAMETOOLONG\fP を返す 指定されたディレクトリ・エントリが削除されていた場合、返されるパス名の最後に " (deleted)" という文字列が付加されることがある。 .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/man2/lseek.2 b/release/man2/lseek.2 index 49c4d6a8..de80a802 100644 --- a/release/man2/lseek.2 +++ b/release/man2/lseek.2 @@ -74,47 +74,37 @@ lseek \- ファイルの読み書きオフセットの位置を変える \fBlseek\fP() 関数は、オフセットをファイルの末尾を越えた位置に設定できる (但し、これによりファイルのサイズが変わらない)。 もしデータがこのオフセット位置以降に書き込まれた場合、 間の空隙の部分 ("穴 (hole)") の読み出しがあると、 実際にそこにデータを書き込まれるまでは NULL バイト (\(aq\e0\(aq) の列が返される。 -.SS "Seeking file data and holes" -Linux バージョン 3.1 以降では、 -\fIwhence\fP に以下の値も指定することができる。 +.SS ファイルのデータとホールの探索 +Linux バージョン 3.1 以降では、 \fIwhence\fP に以下の値も指定することができる。 .TP \fBSEEK_DATA\fP -Adjust the file offset to the next location in the file greater than or -equal to \fIoffset\fP containing data. If \fIoffset\fP points to data, then the -file offset is set to \fIoffset\fP. +ファイルオフセットを \fIoffset\fP 以上で次にデータがある位置に設定する。 \fIoffset\fP がデータを指している場合には、 +ファイルオフセットは \fIoffset\fP に設定される。 .TP \fBSEEK_HOLE\fP -Adjust the file offset to the next hole in the file greater than or equal to -\fIoffset\fP. If \fIoffset\fP points into the middle of a hole, then the file -offset is set to \fIoffset\fP. If there is no hole past \fIoffset\fP, then the -file offset is adjusted to the end of the file (i.e., there is an implicit -hole at the end of any file). +ファイルオフセットを、 位置が \fIoffset\fP 以上の次のホール (hole) に設定する。 \fIoffset\fP +がホールの内部にある場合は、ファイルシステムは \fIoffset\fP に設定される。 \fIoffset\fP 以降にホールがない場合は、 +ファイルオフセットはファイル末尾に設定される (つまり、 どのファイルの末尾にも暗黙のホールが存在するということだ)。 .PP -In both of the above cases, \fBlseek\fP() fails if \fIoffset\fP points past the -end of the file. +上記のどちらの場合も、 \fIoffset\fP がファイル末尾よりも先を指している場合には \fBlseek\fP() は失敗する。 -These operations allow applications to map holes in a sparsely allocated -file. This can be useful for applications such as file backup tools, which -can save space when creating backups and preserve holes, if they have a -mechanism for discovering holes. +これらの操作を使うことで、 アプリケーションが、 まばら (sparse ) にページが割り当てられたファイルでホールをマップすることができる。 +この機能はファイルバックアップツールなどのアプリケーションで有用である。 ホールを見つける仕組みがあれば、 ファイルバックアップツールで、 +バックアップを作成する際に保存領域を節約し、ホールを保持することができる。 .\" https://lkml.org/lkml/2011/4/22/79 .\" http://lwn.net/Articles/440255/ .\" http://blogs.oracle.com/bonwick/entry/seek_hole_and_seek_data -For the purposes of these operations, a hole is a sequence of zeros that -(normally) has not been allocated in the underlying file storage. However, -a file system is not obliged to report holes, so these operations are not a -guaranteed mechanism for mapping the storage space actually allocated to a -file. (Furthermore, a sequence of zeros that actually has been written to -the underlying storage may not be reported as a hole.) In the simplest -implementation, a file system can support the operations by making -\fBSEEK_HOLE\fP always return the offset of the end of the file, and making -\fBSEEK_DATA\fP always return \fIoffset\fP (i.e., even if the location referred to -by \fIoffset\fP is a hole, it can be considered to consist of data that is a -sequence of zeros). +これらの操作の目的としては、 ホールは (通常は) バックエンドのファイルストレージには割り当てられていない連続する 0 の列である。 +しかし、ファイルシステムにはホールを報告する義務はなく、 そのため、 これらの操作は、 +ファイルに実際に割り当てられたストレージ領域をマッピングする方法としては確実性のある仕組みではない。 +(また、バックエンドのストレージに実際に書き込まれた連続する 0 の列はホールとして報告されないこともある。) 最も単純な実装としては、 +\fBSEEK_HOLE\fP は常にファイル末尾のオフセットを返すようにし、 \fBSEEK_DATA\fP は常に \fIoffset\fP を返すようにすることで、 +ファイルシステムはこれらの操作をサポートすることができる (\fBSEEK_DATA\fP は常に \fIoffset\fP を返すというのは、 \fIoffset\fP +が参照する場所がホールであったとしても、 連続する 0 の列のデータで構成されているとみなすということである)。 -The \fB_GNU_SOURCE\fP feature test macro must be defined in order to obtain the -definitions of \fBSEEK_DATA\fP and \fBSEEK_HOLE\fP from \fI\fP. +\fI\fP から \fBSEEK_DATA\fP と \fBSEEK_HOLE\fP の定義を得るには、 機能検査マクロ +\fB_GNU_SOURCE\fP を定義しなければならない。 .SH 返り値 成功した場合、 \fBlseek\fP() は結果のファイル位置をファイルの先頭からのバイト数で返す。 エラーの場合、値 \fI(off_t)\ \-1\fP が返され、 \fIerrno\fP にエラーが指示される。 @@ -143,9 +133,8 @@ definitions of \fBSEEK_DATA\fP and \fBSEEK_HOLE\fP from \fI\fP. SVr4, 4.3BSD, POSIX.1\-2001. .\" FIXME . Review http://austingroupbugs.net/view.php?id=415 in the future -\fBSEEK_DATA\fP and \fBSEEK_HOLE\fP are nonstandard extensions also present in -Solaris, FreeBSD, and DragonFly BSD; they are proposed for inclusion in the -next POSIX revision (Issue 8). +\fBSEEK_DATA\fP と \fBSEEK_HOLE\fP は非標準の拡張で、 Solaris, FreeBSD, DragonFly BSD +にも存在する。 これらは POSIX の次の版 (Issue 8) に入れるよう提案されている。 .SH 注意 いくつかのデバイスでは seek ができない。 POSIX はどのデバイスが \fBlseek\fP() に対応すべきかは規定していない。 @@ -175,6 +164,6 @@ position pointer) を共有しているので、 このようなファイルで \fBdup\fP(2), \fBfork\fP(2), \fBopen\fP(2), \fBfseek\fP(3), \fBlseek64\fP(3), \fBposix_fallocate\fP(3) .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/man2/madvise.2 b/release/man2/madvise.2 index ab88e5c5..55128539 100644 --- a/release/man2/madvise.2 +++ b/release/man2/madvise.2 @@ -251,6 +251,6 @@ Linux 版の \fBmadvise\fP() では、指定されたアドレス範囲にマ \fBgetrlimit\fP(2), \fBmincore\fP(2), \fBmmap\fP(2), \fBmprotect\fP(2), \fBmsync\fP(2), \fBmunmap\fP(2), \fBcore\fP(5) .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/man2/mbind.2 b/release/man2/mbind.2 index 21a853c2..1fddae31 100644 --- a/release/man2/mbind.2 +++ b/release/man2/mbind.2 @@ -211,6 +211,6 @@ NUMA ポリシーは、 \fBMAP_SHARED\fP フラグが指定されてマップさ \fBshmat\fP(2), \fBshmget\fP(2), \fBnuma\fP(3), \fBcpuset\fP(7), \fBnuma\fP(7), \fBnumactl\fP(8) .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/man2/migrate_pages.2 b/release/man2/migrate_pages.2 index e7bae542..e90e8f62 100644 --- a/release/man2/migrate_pages.2 +++ b/release/man2/migrate_pages.2 @@ -94,10 +94,10 @@ migrate_pages \- プロセスの全ページを別のノード集合に移動す .SH 関連項目 \fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBset_mempolicy\fP(2), \fBnuma\fP(3), \fBnuma_maps\fP(5), \fBcpuset\fP(7), \fBnuma\fP(7), \fBmigratepages\fP(8), -\fBnuma_stat\fP(8) +\fBnumastat\fP(8) Linux カーネルソースの \fIDocumentation/vm/page_migration\fP .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/man2/mincore.2 b/release/man2/mincore.2 index 0fb3a663..191c28ee 100644 --- a/release/man2/mincore.2 +++ b/release/man2/mincore.2 @@ -115,6 +115,6 @@ Linux 2.3.99pre1 と glibc 2.2 から利用可能である。 .SH 関連項目 \fBmlock\fP(2), \fBmmap\fP(2) .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/man2/mkdir.2 b/release/man2/mkdir.2 index 135d4991..5f525b82 100644 --- a/release/man2/mkdir.2 +++ b/release/man2/mkdir.2 @@ -47,7 +47,7 @@ group ID ビットがセットされていたり、ファイルシステムが B (\fBpath_resolution\fP(7) も参照)。 .TP \fBEDQUOT\fP -このファイルシステムの、ディスク・ブロックか inode のユーザクォータに達した。 +ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。 .TP \fBEEXIST\fP \fIpathname\fP が既に存在している(ただしそれがディレクトリであるとは限らない)。 \fIpathname\fP がシンボリックリンクの場合も @@ -99,6 +99,6 @@ NFS を実現しているプロトコルには多くの不備が存在し、 そ \fBmount\fP(2), \fBrmdir\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2), \fBpath_resolution\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/man2/mkdirat.2 b/release/man2/mkdirat.2 index d5260e3c..dd2f426f 100644 --- a/release/man2/mkdirat.2 +++ b/release/man2/mkdirat.2 @@ -86,6 +86,6 @@ POSIX.1\-2008. .SH 関連項目 \fBmkdir\fP(2), \fBopenat\fP(2), \fBpath_resolution\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/man2/mknod.2 b/release/man2/mknod.2 index a66e4d32..718fdd12 100644 --- a/release/man2/mknod.2 +++ b/release/man2/mknod.2 @@ -73,8 +73,7 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOP (\fBpath_resolution\fP(7) も参照すること)。 .TP \fBEDQUOT\fP -The user's quota of disk blocks or inodes on the file system has been -exhausted. +ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。 .TP \fBEEXIST\fP \fIpathname\fP がすでに存在する。 これには \fIpathname\fP がシンボリックリンクである場合も含まれる @@ -134,6 +133,6 @@ NFS を実現しているプロトコルには多くの不備が存在し、 そ \fBmount\fP(2), \fBsocket\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2), \fBmakedev\fP(3), \fBmkfifo\fP(3), \fBpath_resolution\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/man2/mknodat.2 b/release/man2/mknodat.2 index 13a43fbc..9884ba05 100644 --- a/release/man2/mknodat.2 +++ b/release/man2/mknodat.2 @@ -88,6 +88,6 @@ POSIX.1\-2008. .SH 関連項目 \fBmknod\fP(2), \fBopenat\fP(2), \fBpath_resolution\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/man2/mlock.2 b/release/man2/mlock.2 index 92f0e01e..662fdc37 100644 --- a/release/man2/mlock.2 +++ b/release/man2/mlock.2 @@ -190,6 +190,6 @@ Linux 2.6.9 以降では、特権を持つプロセスがロックできるメ \fBmmap\fP(2), \fBsetrlimit\fP(2), \fBshmctl\fP(2), \fBsysconf\fP(3), \fBproc\fP(5), \fBcapabilities\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/man2/mmap.2 b/release/man2/mmap.2 index 06cd0dca..40f0524b 100644 --- a/release/man2/mmap.2 +++ b/release/man2/mmap.2 @@ -54,7 +54,7 @@ mmap, munmap \- ファイルやデバイスをメモリにマップ/アンマッ \fBint munmap(void *\fP\fIaddr\fP\fB, size_t \fP\fIlength\fP\fB);\fP .fi -See NOTES for information on feature test macro requirements. +機能検査マクロの要件に関する情報は「注意」の節を参照。 .SH 説明 \fBmmap\fP() は、新しいマッピングを呼び出し元プロセスの仮想アドレス空間に作成する。 新しいマッピングの開始アドレスは \fIaddr\fP で指定される。マッピングの長さは \fIlength\fP 引き数で指定される。 @@ -263,9 +263,9 @@ See NOTES for information on feature test macro requirements. \fBMAP_DENYWRITE\fP がセットされているが \fIfd\fP で指定されているオブジェクトは書き込み用に開かれている。 .TP \fBEOVERFLOW\fP -On 32\-bit architecture together with the large file extension (i.e., using -64\-bit \fIoff_t\fP): the number of pages used for \fIlength\fP plus number of -pages used for \fIoffset\fP would overflow \fIunsigned long\fP (32 bits). +32 ビットアーキテクチャで large file 拡張を使っている場合 (つまり 64 ビットの \fIoff_t\fP を使う場合)、 \fIlength\fP +で使うページ数と \fIoffset\fP で使うページ数を足した値は \fIunsigned long\fP (32 ビット) を超えてしまう +(オーバーフローしてしまう) 場合がある。 .LP マップ領域を利用する際に、以下のシグナルが発生することがある: .TP @@ -303,14 +303,12 @@ SVr4, 4.4BSD, POSIX.1\-2001. にならないように選択される。 \fBMAP_FIXED\fP フラグが指定され、かつ \fIaddr\fP が 0 (NULL) の場合には、マップされるアドレスが 0 (NULL) になる。 -Certain \fIflags\fP constants are defined only if either \fB_BSD_SOURCE\fP or -\fB_SVID_SOURCE\fP is defined. (Requiring \fB_GNU_SOURCE\fP also suffices, and -requiring that macro specifically would have been more logical, since these -flags are all Linux specific.) The relevant flags are: \fBMAP_32BIT\fP, -\fBMAP_ANONYMOUS\fP (and the synonym \fBMAP_ANON\fP), \fBMAP_DENYWRITE\fP, -\fBMAP_EXECUTABLE\fP, \fBMAP_FILE\fP, \fBMAP_GROWSDOWN\fP, \fBMAP_HUGETLB\fP, -\fBMAP_LOCKED\fP, \fBMAP_NONBLOCK\fP, \fBMAP_NORESERVE\fP, \fBMAP_POPULATE\fP, and -\fBMAP_STACK\fP. +特定の \fIflags\fP 定数は \fB_BSD_SOURCE\fP か \fB_SVID_SOURCE\fP のいずれかが定義された場合にのみ定義される。 +(\fB_GNU_SOURCE\fP も定義されている必要がある。これらのフラグはすべて Linux 固有のものなので、 特に \fB_GNU_SOURCE\fP +を必要とする点はもっと論理的に決められるべきであった。) 関係するフラグは \fBMAP_32BIT\fP, \fBMAP_ANONYMOUS\fP +(とその同義語の \fBMAP_ANON\fP), \fBMAP_DENYWRITE\fP, \fBMAP_EXECUTABLE\fP, \fBMAP_FILE\fP, +\fBMAP_GROWSDOWN\fP, \fBMAP_HUGETLB\fP, \fBMAP_LOCKED\fP, \fBMAP_NONBLOCK\fP, +\fBMAP_NORESERVE\fP, \fBMAP_POPULATE\fP, \fBMAP_STACK\fP である。 .SH バグ Linux においては、上記の \fBMAP_NORESERVE\fP で述べられているような保証はない。 デフォルトでは、システムがメモリを使い切った場合には、 どのプロセスがいつ強制終了されるか分からないからである。 @@ -322,15 +320,12 @@ SUSv3 では、 \fIlength\fP が 0 の場合、 \fBmmap\fP() は失敗すると より前のカーネルでは、 この場合に \fBmmap\fP() は成功していた (マッピングは作成されず、 \fIaddr\fP が返されていた)。 カーネル 2.6.12 以降では、 \fBmmap\fP() はエラー \fBEINVAL\fP で失敗する。 -POSIX specifies that the system shall always zero fill any partial page at -the end of the object and that system will never write any modification of -the object beyond its end. On Linux, when you write data to such partial -page after the end of the object, the data stays in the page cache even -after the file is closed and unmapped and even though the data is never -written to the file itself, subsequent mappings may see the modified -content. In some cases, this could be fixed by calling \fBmsync\fP(2) before -the unmap takes place; however, this doesn't work on tmpfs (for example, -when using POSIX shared memory interface documented in \fBshm_overview\fP(7)). +POSIX では、 システムはオブジェクト末尾の部分ページを常に 0 で埋め、 末尾より後ろのオブジェクトを決して変更してはならない、と規定している。 +Linux では、 オブジェクト末尾より後ろの部分ページにデータを書き込んだ場合、 +そのファイルをクローズしてアンマップした後であってもページキャッシュにデータが残り続け、 データがファイル自体に書き込まれていなくても、 +それ以降のマッピングで変更された内容が見える可能性がある。 いくつかの場合では、 アンマップを行う前に \fBmsync\fP(2) を呼び出すことで、 +この状況を修正することができる。 しかし、 これは tmpfs では機能しない (例えば、 \fBshm_overview\fP(7) で説明されている +POSIX 共有メモリインターフェースを使った場合)。 .SH 例 .\" FIXME . Add an example here that uses an anonymous shared region for .\" IPC between parent and child. @@ -413,14 +408,14 @@ main(int argc, char *argv[]) \fBmremap\fP(2), \fBmsync\fP(2), \fBremap_file_pages\fP(2), \fBsetrlimit\fP(2), \fBshmat\fP(2), \fBshm_open\fP(3), \fBshm_overview\fP(7) -The descriptions of the following files in \fBproc\fP(5): \fI/proc/[pid]/maps\fP, -\fI/proc/[pid]/map_files\fP, and \fI/proc/[pid]/smaps\fP. +\fBproc\fP(5) の \fI/proc/[pid]/maps\fP, \fI/proc/[pid]/map_files\fP, +\fI/proc/[pid]/smaps\fP の説明。 .\" .\" Repeat after me: private read-only mappings are 100% equivalent to .\" shared read-only mappings. No ifs, buts, or maybes. -- Linus B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128\-129 and 389\-391. .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/man2/mmap2.2 b/release/man2/mmap2.2 index 96b6215c..2ebf0f62 100644 --- a/release/man2/mmap2.2 +++ b/release/man2/mmap2.2 @@ -60,7 +60,7 @@ mmap2 \- ファイルやデバイスをメモリにマップする ユーザ空間からデータを取得するときに問題があった。 .TP \fBEINVAL\fP -(ページサイズが 4096 バイトでないプラットフォームにおいて) \fIoffset * 4096\fP がシステムのページサイズの倍数ではない。 +(Various platforms where the page size is not 4096 bytes.) \fIoffset\ *\ 4096\fP is not a multiple of the system page size. .PP \fBmmap2\fP() は \fBmmap\fP(2) に載っているエラーを返すこともある。 .SH バージョン @@ -78,6 +78,6 @@ ia64 では、 \fIoffset\fP の単位は、実際にはシステムのページ .SH 関連項目 \fBgetpagesize\fP(2), \fBmmap\fP(2), \fBmremap\fP(2), \fBmsync\fP(2), \fBshm_open\fP(3) .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/man2/modify_ldt.2 b/release/man2/modify_ldt.2 index fa875dd0..77ad8ef8 100644 --- a/release/man2/modify_ldt.2 +++ b/release/man2/modify_ldt.2 @@ -99,6 +99,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し .SH 関連項目 \fBvm86\fP(2) .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/man2/mount.2 b/release/man2/mount.2 index a3090970..17b78aa7 100644 --- a/release/man2/mount.2 +++ b/release/man2/mount.2 @@ -307,6 +307,6 @@ Linux 独自のファイル \fI/proc/PID/mounts\fP では、指定された ID \fBumount\fP(2), \fBnamespaces\fP(7), \fBpath_resolution\fP(7), \fBmount\fP(8), \fBumount\fP(8) .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/man2/move_pages.2 b/release/man2/move_pages.2 index 48861a7d..f0479f1d 100644 --- a/release/man2/move_pages.2 +++ b/release/man2/move_pages.2 @@ -59,7 +59,7 @@ ID か保存 set\-user\-ID のどちらかと 一致しなければならない は、そのプロセスが排他的に使用しているページだけを移動することを意味する。 \fBMPOL_MF_MOVE_ALL\fP は、複数のプロセス間で共有されているページも移動できることを意味する。 \fBMPOL_MF_MOVE_ALL\fP を使用するためには、そのプロセスが特権 (\fBCAP_SYS_NICE\fP) を持っていなければならない。 -.SH "status 配列に格納されるページ状態" +.SS "status 配列に格納されるページ状態" \fIstatus\fP 配列の各要素として、以下の値が返される。 .TP \fB0..MAX_NUMNODES\fP @@ -144,8 +144,8 @@ dirty なページを移動できない。 ファイルシステムが dirty な .SH 関連項目 \fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBset_mempolicy\fP(2), \fBnuma\fP(3), \fBnuma_maps\fP(5), \fBcpuset\fP(7), \fBnuma\fP(7), \fBmigratepages\fP(8), -\fBnuma_stat\fP(8) +\fBnumastat\fP(8) .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/man2/mprotect.2 b/release/man2/mprotect.2 index a207fbdf..8d0ee4de 100644 --- a/release/man2/mprotect.2 +++ b/release/man2/mprotect.2 @@ -185,6 +185,6 @@ main(void) .SH 関連項目 \fBmmap\fP(2), \fBsysconf\fP(3) .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/man2/mq_getsetattr.2 b/release/man2/mq_getsetattr.2 index 3b90e450..4b5a6508 100644 --- a/release/man2/mq_getsetattr.2 +++ b/release/man2/mq_getsetattr.2 @@ -54,6 +54,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し .SH 関連項目 \fBmq_getattr\fP(3), \fBmq_overview\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/man2/mremap.2 b/release/man2/mremap.2 index a476bed5..f46e04f8 100644 --- a/release/man2/mremap.2 +++ b/release/man2/mremap.2 @@ -70,11 +70,12 @@ Linux ではメモリはページに分割される。ユーザー・プロセ マッピングが再配置されると、古いマッピング位置への絶対ポインタは 無効になる (マッピングの開始アドレスからの相対オフセットは有効のままである)。 .TP \fBMREMAP_FIXED\fP (Linux 2.3.31 以降) -このフラグは \fBmmap\fP(2) の \fBMAP_FIXED\fP フラグと似たような目的で用いられる。 このフラグが指定されると、 -\fBmremap\fP() は 5 番目の引き数 \fIvoid *new_address\fP -を受け取り、この引数はマッピングが移動されるべきアドレスを指定する。 このアドレスはページ境界に合っていなければならない。 \fInew_address\fP -と \fInew_size\fP で指定されるアドレス範囲に過去のマッピングがあった場合、 そのマッピングはアンマップされる (unmapped)。 -\fBMREMAP_FIXED\fP を指定した場合は、 \fBMREMAP_MAYMOVE\fP も指定しなければならない。 +This flag serves a similar purpose to the \fBMAP_FIXED\fP flag of \fBmmap\fP(2). +If this flag is specified, then \fBmremap\fP() accepts a fifth argument, +\fIvoid\ *new_address\fP, which specifies a page\-aligned address to which the +mapping must be moved. Any previous mapping at the address range specified +by \fInew_address\fP and \fInew_size\fP is unmapped. If \fBMREMAP_FIXED\fP is +specified, then \fBMREMAP_MAYMOVE\fP must also be specified. .PP \fIold_address\fP と \fIold_size\fP で指定されるメモリセグメントが (\fBmlock\fP(2) や同様のもので) ロックされている場合、セグメントのサイズが変わったり 再配置されたりした時にロックも維持される。 @@ -119,6 +120,6 @@ Linux ではメモリはページに分割される。ユーザー・プロセ Randolf Bentson, \fIThe Design of the UNIX Operating System\fP by Maurice J. Bach.) .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/man2/msgctl.2 b/release/man2/msgctl.2 index d8aaca68..51ff0501 100644 --- a/release/man2/msgctl.2 +++ b/release/man2/msgctl.2 @@ -202,6 +202,6 @@ Linux や POSIX の全てのバージョンでは、 \fI\fP と \fI \fBmsgget\fP(2), \fBmsgrcv\fP(2), \fBmsgsnd\fP(2), \fBcapabilities\fP(7), \fBmq_overview\fP(7), \fBsvipc\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/man2/msgget.2 b/release/man2/msgget.2 index 39bd12d8..c10f6dee 100644 --- a/release/man2/msgget.2 +++ b/release/man2/msgget.2 @@ -126,6 +126,6 @@ Linux 2.3.20 までは、削除が予定されているメッセージ・キュ \fBmsgctl\fP(2), \fBmsgrcv\fP(2), \fBmsgsnd\fP(2), \fBftok\fP(3), \fBcapabilities\fP(7), \fBmq_overview\fP(7), \fBsvipc\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/man2/msgop.2 b/release/man2/msgop.2 index 2e5ead56..40727afd 100644 --- a/release/man2/msgop.2 +++ b/release/man2/msgop.2 @@ -232,6 +232,6 @@ Linux や POSIX の全てのバージョンでは、 \fI\fP と \fI \fBmsgctl\fP(2), \fBmsgget\fP(2), \fBcapabilities\fP(7), \fBmq_overview\fP(7), \fBsvipc\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/man2/msync.2 b/release/man2/msync.2 index 881acd9e..aed9ec88 100644 --- a/release/man2/msync.2 +++ b/release/man2/msync.2 @@ -75,6 +75,6 @@ POSIX.1\-2001. B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128\-129 and 389\-391. .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/man2/nanosleep.2 b/release/man2/nanosleep.2 index cb8b7ceb..4149a474 100644 --- a/release/man2/nanosleep.2 +++ b/release/man2/nanosleep.2 @@ -126,6 +126,6 @@ Linux 2.4 では、 \fBnanosleep\fP() が (\fBSIGTSTP\fP などの) シグナ \fBclock_nanosleep\fP(2), \fBsched_setscheduler\fP(2), \fBtimer_create\fP(2), \fBsleep\fP(3), \fBusleep\fP(3), \fBtime\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/man2/nfsservctl.2 b/release/man2/nfsservctl.2 index 88c1e3e3..1cf5d28b 100644 --- a/release/man2/nfsservctl.2 +++ b/release/man2/nfsservctl.2 @@ -57,6 +57,6 @@ union nfsctl_res { .SH 準拠 このコールは Linux 特有である。 .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/man2/nice.2 b/release/man2/nice.2 index abf5f469..060581f0 100644 --- a/release/man2/nice.2 +++ b/release/man2/nice.2 @@ -75,6 +75,6 @@ glibc 2.2.4 以降では、 \fBnice\fP() は \fBgetpriority\fP(2) を呼び出 \fBnice\fP(1), \fBrenice\fP(1), \fBfork\fP(2), \fBgetpriority\fP(2), \fBsetpriority\fP(2), \fBcapabilities\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/man2/open.2 b/release/man2/open.2 index f1422ad6..61a3e1c3 100644 --- a/release/man2/open.2 +++ b/release/man2/open.2 @@ -291,8 +291,7 @@ PID を組み合わせた名前) を作成し、 \fBlink\fP(2) を使用して またはファイルが存在せず、親ディレクトリへの書き込み許可がなかった。 (\fBpath_resolution\fP(7) も参照すること。) .TP \fBEDQUOT\fP -Where \fBO_CREAT\fP is specified, the file does not exist, and the user's quota -of disk blocks or inodes on the file system has been exhausted. +\fBO_CREAT\fP が指定された場合で、そのファイルが存在せず、ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。 .TP \fBEEXIST\fP \fIpathname\fP は既に存在し、 \fBO_CREAT\fP と \fBO_EXCL\fP が使用された。 @@ -495,6 +494,6 @@ NFS で \fBO_DIRECT\fP を使った場合の動作はローカルのファイル \fBsocket\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2), \fBwrite\fP(2), \fBfopen\fP(3), \fBfifo\fP(7), \fBpath_resolution\fP(7), \fBsymlink\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/man2/openat.2 b/release/man2/openat.2 index ecf5cd43..1a692ad4 100644 --- a/release/man2/openat.2 +++ b/release/man2/openat.2 @@ -113,6 +113,6 @@ POSIX.1\-2008. Solaris には、これと同じようなシステムコール \fBreadlinkat\fP(2), \fBrenameat\fP(2), \fBsymlinkat\fP(2), \fBunlinkat\fP(2), \fButimensat\fP(2), \fBmkfifoat\fP(3), \fBpath_resolution\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/man2/outb.2 b/release/man2/outb.2 index c1da6c6c..dc4e3136 100644 --- a/release/man2/outb.2 +++ b/release/man2/outb.2 @@ -83,6 +83,6 @@ outb_p, outw_p, outl_p, inb_p, inw_p, inl_p \- ポート入出力 .SH 関連項目 \fBioperm\fP(2), \fBiopl\fP(2) .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/man2/pause.2 b/release/man2/pause.2 index e0c56e32..47f1ff59 100644 --- a/release/man2/pause.2 +++ b/release/man2/pause.2 @@ -55,6 +55,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. .SH 関連項目 \fBkill\fP(2), \fBselect\fP(2), \fBsignal\fP(2), \fBsigsuspend\fP(2) .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/man2/pciconfig_read.2 b/release/man2/pciconfig_read.2 index f0be468f..cc9f7475 100644 --- a/release/man2/pciconfig_read.2 +++ b/release/man2/pciconfig_read.2 @@ -75,6 +75,6 @@ I/O エラー。 .SH 関連項目 \fBcapabilities\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/man2/personality.2 b/release/man2/personality.2 index 9c7a3656..ebfa4fff 100644 --- a/release/man2/personality.2 +++ b/release/man2/personality.2 @@ -57,6 +57,6 @@ Linux は、プロセス毎の異なる実行ドメイン、すなわち パー .SH 準拠 \fBpersonality\fP() は Linux 固有であり、移植を意図したプログラムで使用すべきではない。 .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/man2/pipe.2 b/release/man2/pipe.2 index ba5f435a..5be0c620 100644 --- a/release/man2/pipe.2 +++ b/release/man2/pipe.2 @@ -151,6 +151,6 @@ main(int argc, char *argv[]) \fBfork\fP(2), \fBread\fP(2), \fBsocketpair\fP(2), \fBwrite\fP(2), \fBpopen\fP(3), \fBpipe\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/man2/pivot_root.2 b/release/man2/pivot_root.2 index d53b6fd3..182be234 100644 --- a/release/man2/pivot_root.2 +++ b/release/man2/pivot_root.2 @@ -97,6 +97,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し .SH 関連項目 \fBchdir\fP(2), \fBchroot\fP(2), \fBstat\fP(2), \fBinitrd\fP(4), \fBpivot_root\fP(8) .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/man2/poll.2 b/release/man2/poll.2 index b1a8be88..a29fb740 100644 --- a/release/man2/poll.2 +++ b/release/man2/poll.2 @@ -226,6 +226,6 @@ Linux の \fBppoll\fP() システムコールは \fItimeout_ts\fP 引き数を .SH 関連項目 \fBselect\fP(2), \fBselect_tut\fP(2), \fBtime\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/man2/posix_fadvise.2 b/release/man2/posix_fadvise.2 index 74ce5d5f..bc04fcf9 100644 --- a/release/man2/posix_fadvise.2 +++ b/release/man2/posix_fadvise.2 @@ -118,16 +118,14 @@ Linux では、\fBPOSIX_FADV_NORMAL\fP はバッキングデバイスの デフ まだ書き出されていないページは影響を受けないので、 そのページの解放が保証されることをアプリケーションが望んでいるなら、 最初に \fBfsync\fP(2) または \fBfdatasync\fP(2) を呼ぶべきである。 -.SS "Architecture\-specific variants" -Some architectures require 64\-bit arguments to be aligned in a suitable pair -of registers (see \fBsyscall\fP(2) for further detail). On such -architectures, the call signature of \fBposix_fadvise\fP() shown in the -SYNOPSIS would force a register to be wasted as padding between the \fIfd\fP -and \fIlen\fP arguments. Therefore, these architectures define a version of -the system call that orders the arguments suitably, but otherwise is -otherwise exactly the same as \fBposix_fadvise\fP(). +.SS アーキテクチャ固有の派生バージョン +いくつかのアーキテクチャでは、 64 ビットの引き数は適切なレジスタの組に割り当てる必要がある (\fBsyscall\fP(2) 参照)。 +このようなアーキテクチャでは、 「書式」に書かれている \fBposix_fadvise\fP() の呼び出しシグネチャーで、 引き数 \fIfd\fP と +\fIoffset\fP の間のパディング (詰めもの) でレジスタが一つ消費されてしまう。 そのため、 +これらのアーキテクチャでは引き数が適切な順序になった別のシステムコールが定義されているが、 それ以外は \fBposix_fadvise\fP() +と全く同じである。 -For example, since Linux 2.6.14, ARM has the following system call: +例えば、 Linux 2.6.14 以降では、 ARM には以下のシステムコールが存在する。 .PP .in +4n .nf @@ -136,9 +134,8 @@ For example, since Linux 2.6.14, ARM has the following system call: .fi .in .PP -These architecture\-specific details are generally hidden from applications -by the glibc \fBposix_fadvise\fP() wrapper function, which invokes the -appropriate architecture\-specific system call. +通常、 glibc の \fBposix_fadvise\fP() ラッパー関数により、 これらのアーキテクチャ固有の詳細はアプリケーションには見えない。 +glibc のラッパー関数では、適切なアーキテクチャ固有のシステムコールが呼び出される。 .SH バグ 2.6.6 より前のカーネルでは、 \fIlen\fP に 0 が指定された場合、 「ファイルの終りまでの全てのバイト」という意味ではなく、 文字通り「0 バイト」として解釈されていた。 @@ -147,6 +144,6 @@ appropriate architecture\-specific system call. \fBreadahead\fP(2), \fBsync_file_range\fP(2), \fBposix_fallocate\fP(3), \fBposix_madvise\fP(3) .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/man2/pread.2 b/release/man2/pread.2 index 85fd5b31..3bfc49d1 100644 --- a/release/man2/pread.2 +++ b/release/man2/pread.2 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PREAD 2 2013\-04\-01 Linux "Linux Programmer's Manual" +.TH PREAD 2 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 pread, pwrite \- 指定したオフセットでファイルディスクリプタを読み書きする .SH 書式 @@ -75,6 +75,11 @@ _XOPEN_SOURCE\ >=\ 500 .SH 準拠 POSIX.1\-2001. .SH 注意 +The \fBpread\fP() and \fBpwrite\fP() system calls are especially useful in +multithreaded applications. They allow multiple threads to perform I/O on +the same file descriptor without being affected by changes to the file +offset by other threads. + Linux では、裏で呼び出されるシステムコールの名前がカーネル 2.6 で変更された。 \fBpread\fP() は \fBpread64\fP() になり、 \fBpwrite\fP() は \fBpwrite64\fP() になった。 システムコールの番号は変更されていない。 @@ -92,6 +97,6 @@ POSIX では、\fBO_APPEND\fP フラグを指定してファイルをオープ .SH 関連項目 \fBlseek\fP(2), \fBread\fP(2), \fBreadv\fP(2), \fBwrite\fP(2) .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/man2/query_module.2 b/release/man2/query_module.2 index cd3282ca..742aaaf8 100644 --- a/release/man2/query_module.2 +++ b/release/man2/query_module.2 @@ -25,7 +25,7 @@ query_module \- モジュールに関連する各種の情報をカーネルに \fI注\fP: このシステムコールには glibc のラッパー関数は存在しない。「注意」の節を参照。 .SH 説明 -\fBNote\fP: This system call is present only in kernels before Linux 2.6. +\fB注意\fP: このシステムコールが存在するのは、カーネル 2.6 より前の Linux だけである。 \fBquery_module\fP() は、ローダブルモジュールに関する情報をカーネルに問い合わせる。 情報は \fIbuf\fP が指し示すバッファに格納されて返される。 呼び出し元は \fIbuf\fP のサイズを \fIbufsize\fP に指定しなければならない。 @@ -104,17 +104,15 @@ struct module_info { 与えられたバッファの大きさが小さすぎる。 \fIret\fP には最小限必要なバッファのサイズが設定される。 .TP \fBENOSYS\fP -\fBquery_module\fP() is not supported in this version of the kernel (e.g., the -kernel is version 2.6 or later). +\fBquery_module\fP() はこのバージョンのカーネルではサポートされていない (例えば、カーネルのバージョンが 2.6 以降)。 .SH バージョン .\" Removed in Linux 2.5.48 このシステムコールが存在するのはカーネル 2.4 までの Linux だけである。 Linux 2.6 では削除された。 .SH 準拠 \fBquery_module\fP() は Linux 固有である。 .SH 注意 -Some of the information that was formerly available via \fBquery_module\fP() -can be obtained from \fI/proc/modules\fP, \fI/proc/kallsyms\fP, and the files -under the directory \fI/sys/module\fP. +以前 \fBquery_module\fP() で得られた情報のいくつかは、 \fI/proc/modules\fP, \fI/proc/kallsyms\fP および +\fI/sys/module\fP ディレクトリ内のファイルから取得できる。 glibc はこのシステムコールに対するラッパー関数を提供していない。おそらくないと思うが、古いカーネルでこのシステムコールを使いたい場合は \fBsyscall\fP(2) を使うこと。 @@ -122,6 +120,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し \fBcreate_module\fP(2), \fBdelete_module\fP(2), \fBget_kernel_syms\fP(2), \fBinit_module\fP(2), \fBlsmod\fP(8), \fBmodinfo\fP(8) .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/man2/read.2 b/release/man2/read.2 index 9664f6cf..c6c28b47 100644 --- a/release/man2/read.2 +++ b/release/man2/read.2 @@ -50,14 +50,12 @@ read \- ファイルディスクリプタから読み込む \fBread\fP() はファイルディスクリプタ (file descriptor) \fIfd\fP から最大 \fIcount\fP バイトを \fIbuf\fP で始まるバッファーへ読み込もうとする。 -On files that support seeking, the read operation commences at the current -file offset, and the file offset is incremented by the number of bytes -read. If the current file offset is at or past the end of file, no bytes -are read, and \fBread\fP() returns zero. +seek に対応しているファイルでは、read +は現在のファイルオフセットから行われ、ファイルオフセットは読み込んだバイト数分だけ進められる。現在のファイルオフセットがファイル末尾かそれより先の場合は、読み出しは行われず、 +\fBread\fP() は 0 を返す。 -If \fIcount\fP is zero, \fBread\fP() \fImay\fP detect the errors described below. -In the absence of any errors, or if \fBread\fP() does not check for errors, a -\fBread\fP() with a \fIcount\fP of 0 returns zero and has no other effects. +\fIcount\fP が 0 の場合、 \fBread\fP() は以下で説明するエラーを検出する\fI場合がある\fP。 どのエラーもなかった場合、もしくは +\fBread\fP() がエラーのチェックを行わない場合、 \fIcount\fP が 0 で呼び出された \fBread\fP() は 0 を返し、何も行わない。 \fIcount\fP が \fBSSIZE_MAX\fP より大きければ、結果は規定できない。 .SH 返り値 @@ -118,6 +116,6 @@ NFS において。少量のデータを読み込む場合、最初の時のみ \fBreaddir\fP(2), \fBreadlink\fP(2), \fBreadv\fP(2), \fBselect\fP(2), \fBwrite\fP(2), \fBfread\fP(3) .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/man2/readahead.2 b/release/man2/readahead.2 index aa93a6f0..45de3168 100644 --- a/release/man2/readahead.2 +++ b/release/man2/readahead.2 @@ -64,11 +64,11 @@ readahead \- 前もってファイルをページ・キャッシュに読み込 .SH 準拠 \fBreadahead\fP() システムコールは Linux 固有であり、移植を考慮したプログラムでは 使用を避けるべきである。 .SH 注意 -On some 32\-bit architectures, the calling signature for this system call -differs, for the reasons described in \fBsyscall\fP(2). +いくつかの 32 ビットアーキテクチャでは、このシステムコールの呼び出しシグネチャーが違っている。 理由は \fBsyscall\fP(2) +で説明されている。 .SH 関連項目 \fBlseek\fP(2), \fBmadvise\fP(2), \fBmmap\fP(2), \fBposix_fadvise\fP(2), \fBread\fP(2) .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/man2/readdir.2 b/release/man2/readdir.2 index b08ebe6e..030287c2 100644 --- a/release/man2/readdir.2 +++ b/release/man2/readdir.2 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH READDIR 2 2013\-03\-26 Linux "Linux Programmer's Manual" +.TH READDIR 2 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 readdir \- ディレクトリ・エントリを読み込む .SH 書式 @@ -65,9 +65,10 @@ struct old_linux_dirent { .fi .in .PP -\fId_ino\fP は inode 番号である。 \fId_off\fP はディレクトリの最初からこの \fIold_linux_dirent\fP まで距離である。 -\fId_reclen\fP は \fId_name\fP の大きさで、終端のヌルバイト (null byte) を含まない。 \fId_name\fP -はヌルバイトで終わるファイル名である。 +\fId_ino\fP is an inode number. \fId_off\fP is the distance from the start of the +directory to this \fIold_linux_dirent\fP. \fId_reclen\fP is the size of +\fId_name\fP, not counting the terminating null byte (\(aq\e0\(aq). \fId_name\fP +is a null\-terminated filename. .SH 返り値 成功した場合は、1 が返される。 ディレクトリの最後では 0 が返される。 エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。 .SH エラー @@ -97,6 +98,6 @@ glibc はこのシステムコールに対するラッパー関数を提供し .SH 関連項目 \fBgetdents\fP(2), \fBreaddir\fP(3) .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/man2/readlink.2 b/release/man2/readlink.2 index bf88dd6b..d8e3104f 100644 --- a/release/man2/readlink.2 +++ b/release/man2/readlink.2 @@ -185,6 +185,6 @@ main(int argc, char *argv[]) \fBreadlink\fP(1), \fBlstat\fP(2), \fBreadlinkat\fP(2), \fBstat\fP(2), \fBsymlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/readlinkat.2 b/release/man2/readlinkat.2 index 486bf787..166df171 100644 --- a/release/man2/readlinkat.2 +++ b/release/man2/readlinkat.2 @@ -90,6 +90,6 @@ POSIX.1\-2008. .SH 関連項目 \fBopenat\fP(2), \fBreadlink\fP(2), \fBpath_resolution\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/man2/readv.2 b/release/man2/readv.2 index 0d7e4355..12584ad9 100644 --- a/release/man2/readv.2 +++ b/release/man2/readv.2 @@ -169,6 +169,6 @@ nwritten = writev(STDOUT_FILENO, iov, 2); .SH 関連項目 \fBpread\fP(2), \fBread\fP(2), \fBwrite\fP(2) .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/man2/reboot.2 b/release/man2/reboot.2 index 05da177c..11d4b913 100644 --- a/release/man2/reboot.2 +++ b/release/man2/reboot.2 @@ -122,6 +122,6 @@ magic の数字か \fIcmd\fP が間違っている。 \fBsync\fP(2), \fBbootparam\fP(7), \fBctrlaltdel\fP(8), \fBhalt\fP(8), \fBreboot\fP(8), \fBcapabilities\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/man2/recv.2 b/release/man2/recv.2 index 7b216a27..b85ff781 100644 --- a/release/man2/recv.2 +++ b/release/man2/recv.2 @@ -43,7 +43,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH RECV 2 2012\-12\-21 Linux "Linux Programmer's Manual" +.TH RECV 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 recv, recvfrom, recvmsg \- ソケットからメッセージを受け取る .SH 書式 @@ -243,7 +243,9 @@ struct cmsghdr { \fBMSG_ERRQUEUE\fP データは受信しなかったが ソケットのエラー・キューから拡張エラーを受信したことを示す。 .SH 返り値 -これらのコールは受信したバイト数を返す。 エラーの場合は \-1 を返す。 接続先が正しくシャットダウンを実行した場合は、返り値は 0 となる。 +These calls return the number of bytes received, or \-1 if an error +occurred. In the event of an error, \fIerrno\fP is set to indicate the error. +The return value will be 0 when the peer has performed an orderly shutdown. .SH エラー これらはソケット層で発生する一般的なエラーである。 他のエラーが下層のプロトコル・モジュールで生成され、 返されるかもしれない。 それらのマニュアルを参照すること。 @@ -306,6 +308,6 @@ POSIX.1\-2001 では、構造体 \fImsghdr\fP のフィールド \fImsg_controll \fBfcntl\fP(2), \fBgetsockopt\fP(2), \fBread\fP(2), \fBrecvmmsg\fP(2), \fBselect\fP(2), \fBshutdown\fP(2), \fBsocket\fP(2), \fBcmsg\fP(3), \fBsockatmark\fP(3), \fBsocket\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/man2/recvmmsg.2 b/release/man2/recvmmsg.2 new file mode 100644 index 00000000..4678f5cc --- /dev/null +++ b/release/man2/recvmmsg.2 @@ -0,0 +1,197 @@ +.\" Copyright (C) 2011 by Andi Kleen +.\" and Copyright (c) 2011 by Michael Kerrisk +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" Syscall added in following commit +.\" commit a2e2725541fad72416326798c2d7fa4dafb7d337 +.\" Author: Arnaldo Carvalho de Melo +.\" Date: Mon Oct 12 23:40:10 2009 -0700 +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH RECVMMSG 2 2012\-12\-24 Linux "Linux Programmer's Manual" +.SH 名前 +recvmmsg \- 複数のメッセージをソケットから受信する +.SH 書式 +.nf +\fB#define _GNU_SOURCE\fP +\fB#include \fP + +\fBint recvmmsg(int \fP\fIsockfd\fP\fB, struct mmsghdr *\fP\fImsgvec\fP\fB, unsigned int \fP\fIvlen\fP\fB,\fP +.br +\fB unsigned int \fP\fIflags\fP\fB, struct timespec *\fP\fItimeout\fP\fB);\fP +.fi +.SH 説明 +\fBrecvmmsg\fP() システムコールは \fBrecvmsg\fP(2) の拡張で、 +このシステムコールを使うと一度の呼び出しでソケットから複数のメッセージを受信することができる (アプリケーションによっては性能上のメリットがある)。 +他に \fBrecvmsg\fP(2) から拡張されている点としては、受信操作におけるタイムアウトのサポートがある。 + +\fIsockfd\fP 引き数は、データを受信するソケットのファイルディスクリプタである。 + +\fImsgvec\fP 引き数は \fImmsghdr\fP 構造体の配列である。 この配列の大きさは \fIvlen\fP で指定する。 + +\fImmsghdr\fP 構造体は \fI\fP で次のように定義されている。 + +.in +4n +.nf +struct mmsghdr { + struct msghdr msg_hdr; /* メッセージヘッダ */ + unsigned int msg_len; /* このヘッダで受信されたバイト数 */ +}; +.fi +.in +.PP +\fImsg_hdr\fP フィールドは、 \fBrecvmsg\fP(2) で説明されている \fImsghdr\fP 構造体である。 \fImsg_len\fP +フィールドは、 このエントリで返されるメッセージのバイト数で、 このヘッダに対して \fBrecvmsg\fP(2) を呼び出した場合の返り値と同じ値が入る。 + +\fIflags\fP 引き数には複数のフラグを論理和 (OR) で指定できる。 フラグは、 \fBrecvmsg\fP(2) +で説明されているものに加えて、以下が使用できる。 +.TP +\fBMSG_WAITFORONE\fP (Linux 2.6.34 以降) +最初のメッセージを受信後に \fBMSG_DONTWAIT\fP を有効にする。 +.PP +\fItimeout\fP 引き数は \fIstruct timespec\fP (\fBclock_gettime\fP(2) 参照) へのポインタで、 +この構造体で受信操作のタイムアウト (秒とナノ秒) を指定する +(待ち時間はシステムクロックの粒度に切り上げられ、カーネルのスケジューリング遅延により少しだけ長くなる可能性がある)。 \fItimeout\fPが +\fINULL\fP の場合、 受信操作は無期限に停止 (block) する。 + +停止 (blocking) モードの \fBrecvmmsg\fP() の呼び出しは、 \fIvlen\fP +個のメッセージを受信するか、タイムアウトが満了するまで停止する。 非停止 (nonblocking) モードの呼び出しでは、 読み出し可能なメッセージ +(最大で \fIvlen\fP 個) を読み出し、 すぐに返る。 + +\fBrecvmmsg\fP() が返った際には、 \fImsgvec\fP のうちデータが受信された要素には、受信したそれぞれのメッセージの情報が格納されている。 +また、 \fImsg_len\fP には受信したメッセージの大きさが入り、 \fImsg_hdr\fP の各フィールドは \fBrecvmsg\fP(2) +に書かれている通りに更新される。 呼び出しの返り値は、更新された \fImsgvec\fP の要素数である。 +.SH 返り値 +成功すると、 \fBrecvmmsg\fP() は \fImsgvec\fP に受信されたメッセージ数を返す。 エラーの場合、 \-1 を返し、 \fIerrno\fP +にエラーを示す値を設定する。 +.SH エラー +エラーは \fBrecvmsg\fP(2) と同じである。 これに加えて、以下のエラーが起こる場合がある。 +.TP +\fBEINVAL\fP +\fItimeout\fP が無効である。 +.SH バージョン +\fBrecvmmsg\fP() システムコールは Linux 2.6.33 で追加された。 glibc でのサポートはバージョン 2.12 +以降で利用可能である。 +.SH 準拠 +\fBrecvmmsg\fP() は Linux 固有である。 +.SH 例 +.PP +以下のプログラムは、 \fBrecvmmsg\fP() を使って複数のメッセージをソケットから受信し、それらを複数のバッファに格納する。 +呼び出しは、すべてのバッファにメッセージが格納されるか、 指定したタイムアウト時間が経過すると返る。 + +以下のコマンドは、 ランダムな数字が入った UDP データグラムを定期的に生成する。 +.in +4n +.nf + +$\fB while true; do echo $RANDOM > /dev/udp/127.0.0.1/1234; \fP +\fBsleep 0.25; done\fP +.fi +.in + +生成されたデータグラムをサンプルアプリケーションが読み出し、以下のような出力が得られる。 +.in +4n +.nf + +$\fB ./a.out\fP +5 messages received +1 11782 +2 11345 +3 304 +4 13514 +5 28421 +.fi +.in +.SS プログラムのソース +\& +.nf +#define _GNU_SOURCE +#include +#include +#include +#include +#include + +int +main(void) +{ +#define VLEN 10 +#define BUFSIZE 200 +#define TIMEOUT 1 + int sockfd, retval, i; + struct sockaddr_in sa; + struct mmsghdr msgs[VLEN]; + struct iovec iovecs[VLEN]; + char bufs[VLEN][BUFSIZE+1]; + struct timespec timeout; + + sockfd = socket(AF_INET, SOCK_DGRAM, 0); + if (sockfd == \-1) { + perror("socket()"); + exit(EXIT_FAILURE); + } + + sa.sin_family = AF_INET; + sa.sin_addr.s_addr = htonl(INADDR_LOOPBACK); + sa.sin_port = htons(1234); + if (bind(sockfd, (struct sockaddr *) &sa, sizeof(sa)) == \-1) { + perror("bind()"); + exit(EXIT_FAILURE); + } + + memset(msgs, 0, sizeof(msgs)); + for (i = 0; i < VLEN; i++) { + iovecs[i].iov_base = bufs[i]; + iovecs[i].iov_len = BUFSIZE; + msgs[i].msg_hdr.msg_iov = &iovecs[i]; + msgs[i].msg_hdr.msg_iovlen = 1; + } + + timeout.tv_sec = TIMEOUT; + timeout.tv_nsec = 0; + + retval = recvmmsg(sockfd, msgs, VLEN, 0, &timeout); + if (retval == \-1) { + perror("recvmmsg()"); + exit(EXIT_FAILURE); + } + + printf("%d messages received\en", retval); + for (i = 0; i < retval; i++) { + bufs[i][msgs[i].msg_len] = 0; + printf("%d %s", i+1, bufs[i]); + } + exit(EXIT_SUCCESS); +} +.fi +.SH 関連項目 +\fBclock_gettime\fP(2), \fBrecvmsg\fP(2), \fBsendmmsg\fP(2), \fBsendmsg\fP(2), +\fBsocket\fP(2), \fBsocket\fP(7) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man2/remap_file_pages.2 b/release/man2/remap_file_pages.2 index 69c552cb..c81eb1e0 100644 --- a/release/man2/remap_file_pages.2 +++ b/release/man2/remap_file_pages.2 @@ -92,6 +92,6 @@ remap_file_pages \- 非線形ファイルマッピングを作成する。 \fBgetpagesize\fP(2), \fBmmap\fP(2), \fBmmap2\fP(2), \fBmprotect\fP(2), \fBmremap\fP(2), \fBmsync\fP(2) .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/man2/removexattr.2 b/release/man2/removexattr.2 index 65f45283..7e6aead5 100644 --- a/release/man2/removexattr.2 +++ b/release/man2/removexattr.2 @@ -82,6 +82,6 @@ inode に対し、互いに独立な名前空間が複数あってもよい。 \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBgetxattr\fP(2), \fBlistxattr\fP(2), \fBopen\fP(2), \fBsetxattr\fP(2), \fBstat\fP(2), \fBattr\fP(5), \fBsymlink\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/man2/rename.2 b/release/man2/rename.2 index 1abf56fb..69d1d9af 100644 --- a/release/man2/rename.2 +++ b/release/man2/rename.2 @@ -80,7 +80,7 @@ rename \- ファイルの名前や位置を変更する ただし、そのような状況で、システムが他に返すエラーがない場合には \fBEBUSY\fP を返すことが許されている。) .TP \fBEDQUOT\fP -The user's quota of disk blocks on the file system has been exhausted. +ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。 .TP \fBEFAULT\fP \fIoldpath\fP や \fInewpath\fP がアクセス可能なアドレス空間の外を指している。 @@ -145,6 +145,6 @@ NFS ファイルシステムでは、操作が失敗したからといって、 \fBmv\fP(1), \fBchmod\fP(2), \fBlink\fP(2), \fBrenameat\fP(2), \fBsymlink\fP(2), \fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/renameat.2 b/release/man2/renameat.2 index d84b6afc..60fd0f31 100644 --- a/release/man2/renameat.2 +++ b/release/man2/renameat.2 @@ -93,6 +93,6 @@ POSIX.1\-2008. .SH 関連項目 \fBopenat\fP(2), \fBrename\fP(2), \fBpath_resolution\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/man2/rmdir.2 b/release/man2/rmdir.2 index be84c427..96bc2ed7 100644 --- a/release/man2/rmdir.2 +++ b/release/man2/rmdir.2 @@ -98,6 +98,6 @@ NFS プロトコルに潜在している欠陥によって、まだ使用中の \fBrm\fP(1), \fBrmdir\fP(1), \fBchdir\fP(2), \fBchmod\fP(2), \fBmkdir\fP(2), \fBrename\fP(2), \fBunlink\fP(2), \fBunlinkat\fP(2) .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/man2/sched_get_priority_max.2 b/release/man2/sched_get_priority_max.2 index af12172b..631a7410 100644 --- a/release/man2/sched_get_priority_max.2 +++ b/release/man2/sched_get_priority_max.2 @@ -79,6 +79,6 @@ POSIX.1\-2001. \fIProgramming for the real world \- POSIX.4\fP by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1\-56592\-074\-0. .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/man2/sched_rr_get_interval.2 b/release/man2/sched_rr_get_interval.2 index 4f594f2e..e5c78849 100644 --- a/release/man2/sched_rr_get_interval.2 +++ b/release/man2/sched_rr_get_interval.2 @@ -88,15 +88,11 @@ POSIX システムで \fBsched_rr_get_interval\fP() は \fI\fP に \fB_POSIX_PRIORITY_SCHEDULING\fP が定義されている場合にのみ使用可能である。 .SS "Linux での注意" .\" commit a4ec24b48ddef1e93f7578be53270f0b95ad666c -POSIX does not specify any mechanism for controlling the size of the -round\-robin time quantum. Older Linux kernels provide a (nonportable) -method of doing this. The quantum can be controlled by adjusting the -process's nice value (see \fBsetpriority\fP(2)). Assigning a negative (i.e., -high) nice value results in a longer quantum; assigning a positive (i.e., -low) nice value results in a shorter quantum. The default quantum is 0.1 -seconds; the degree to which changing the nice value affects the quantum has -varied somewhat across kernel versions. This method of adjusting the -quantum was removed starting with Linux 2.6.24. +POSIX ではラウンドロビン時間量の大きさを制御する仕組みが規定されていない。 古い Linux カーネルではこれを変更する方法が提供されている +(この方法に移植性はない)。 プロセスの nice 値を調整することで時間量を制御できる (\fBsetpriority\fP(2) 参照)。 負の nice +値 (すなわち、高い nice 値) を割り当てると時間量は長くなり、 正の nice 値 (すなわち、低い nice 値) +を割り当てると時間量は短くなる。 デフォルトの時間量は 0.1 秒である。 nice 値の変更が時間量にどの程度影響を与えるかは +カーネルのバージョンにより多少異なる。時間量を調整するこのメソッドは Linux 2.6.24 以降で削除された。 .\" commit ce0dbbbb30aee6a835511d5be446462388ba9eee .\" .SH BUGS @@ -105,10 +101,9 @@ quantum was removed starting with Linux 2.6.24. .\" returns with error .\" ENOSYS, because SCHED_RR has not yet been fully implemented and tested .\" properly. -Linux 3.9 added a new mechanism for adjusting (and viewing) the \fBSCHED_RR\fP -quantum: the \fI/proc/sys/kernel/sched_rr_timeslice_ms\fP file exposes the -quantum as a millisecond value, whose default is 100. Writing 0 to this -file resets the quantum to the default value. +Linux 3.9 で、 \fBSCHED_RR\fP の時間量の調整 (と参照) を行う新しい機構が追加された。 +\fI/proc/sys/kernel/sched_rr_timeslice_ms\fP ファイルでミリ秒単位の時間量の値が参照でき、 デフォルト値は 100 +である。 このファイルに 0 を書き込むと、 時間量をデフォルト値に戻すことができる。 .SH 関連項目 \fBsched_setscheduler\fP(2) に Linux のスケジューリング方式についての説明 がある。 @@ -116,6 +111,6 @@ file resets the quantum to the default value. \fIProgramming for the real world \- POSIX.4\fP by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1\-56592\-074\-0. .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/man2/sched_setaffinity.2 b/release/man2/sched_setaffinity.2 index c73c3a0f..b248442b 100644 --- a/release/man2/sched_setaffinity.2 +++ b/release/man2/sched_setaffinity.2 @@ -117,11 +117,13 @@ API を使用している場合、 \fBsched_setaffinity\fP() の代わりに \f \fBfork\fP(2) 経由で生成された子プロセスは親プロセスの CPU affinity マスクを継承する。 affinity マスクは \fBexecve\fP(2) の前後で保存される。 -このマニュアルページでは CPU affinity コールの glibc インタフェースを -説明している。実際のシステムコール・インタフェースは少し違っており、 実際の実装では CPU 集合は簡単なビットマスクであるという実状を反映し、 -\fImask\fP の型が \fIunsigned long *\fP となっている。 成功時には、生の \fBsched_getaffinity\fP() -システムコール自身は \fIcpumask_t\fP データ型の (バイト単位の) 大きさを返す。 \fIcpumask_t\fP はカーネル内部で CPU -集合のビットマスクを表現するのに 使われているデータ型である。 +This manual page describes the glibc interface for the CPU affinity calls. +The actual system call interface is slightly different, with the \fImask\fP +being typed as \fIunsigned long\ *\fP, reflecting the fact that the underlying +implementation of CPU sets is a simple bit mask. On success, the raw +\fBsched_getaffinity\fP() system call returns the size (in bytes) of the +\fIcpumask_t\fP data type that is used internally by the kernel to represent +the CPU set bit mask. .SH 関連項目 .ad l .nh @@ -131,6 +133,6 @@ API を使用している場合、 \fBsched_setaffinity\fP() の代わりに \f \fBCPU_SET\fP(3), \fBpthread_setaffinity_np\fP(3), \fBsched_getcpu\fP(3), \fBcapabilities\fP(7), \fBcpuset\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/man2/sched_setparam.2 b/release/man2/sched_setparam.2 index e2934c75..2e7a4df8 100644 --- a/release/man2/sched_setparam.2 +++ b/release/man2/sched_setparam.2 @@ -83,8 +83,7 @@ sched_setparam, sched_getparam \- スケジューリング・パラメータの POSIX.1\-2001. .SH 注意 .PP -Scheduling parameters are in fact per\-thread attributes on Linux; see -\fBsched_setscheduler\fP(2). +Linux では、スケジューリングパラメータは実際にはスレッド単位の属性である。 \fBsched_setscheduler\fP(2) 参照。 .SH 関連項目 .ad l .nh @@ -96,6 +95,6 @@ Scheduling parameters are in fact per\-thread attributes on Linux; see \fIProgramming for the real world \- POSIX.4\fP by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1\-56592\-074\-0. .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/man2/sched_setscheduler.2 b/release/man2/sched_setscheduler.2 index b03b5829..ec4085d3 100644 --- a/release/man2/sched_setscheduler.2 +++ b/release/man2/sched_setscheduler.2 @@ -282,14 +282,12 @@ POSIX.1 は、非特権プロセスが \fBsched_setscheduler\fP() を呼び出 詳細はシステムにより異なる。 例えば、Solaris 7 のマニュアルページでは、 呼び出し元プロセスの実ユーザ ID または実効ユーザ ID が 設定対象のプロセスの実ユーザ ID か保存 (save) set\-user\-ID と 一致していなければならない、となっている。 .PP -The scheduling policy and parameters are in fact per\-thread attributes on -Linux. The value returned from a call to \fBgettid\fP(2) can be passed in the -argument \fIpid\fP. Specifying \fIpid\fP as 0 will operate on the attribute for -the calling thread, and passing the value returned from a call to -\fBgetpid\fP(2) will operate on the attribute for the main thread of the -thread group. (If you are using the POSIX threads API, then use -\fBpthread_setschedparam\fP(3), \fBpthread_getschedparam\fP(3), and -\fBpthread_setschedprio\fP(3), instead of the \fBsched_*\fP(2) system calls.) +Linux では、 スケジューリングポリシーとスケジューリングパラメータは、 実際にはスレッド単位の属性である。 \fBgettid\fP(2) +の呼び出しの返り値をこのシステムコールの \fIpid\fP 引き数として渡すことができる。 \fIpid\fP に 0 を指定すると、 +呼び出し元のスレッドの属性が設定される。 \fBgetpid\fP(2) コールからの返り値を \fIpid\fP に指定すると、 +スレッドグループのメインスレッドの属性が設定される (POSIX スレッド API を使用している場合は、 \fBsched_*\fP(2) +システムコールの代わりに \fBpthread_setschedparam\fP(3), \fBpthread_getschedparam\fP(3), and +\fBpthread_setschedprio\fP(3) を使用すること)。 .PP もともとは、標準の Linux は一般目的のオペレーティングシステムとして 設計されており、バックグラウンド・プロセスや対話的アプリケーション、 リアルタイム性の要求が厳しくないリアルタイム・アプリケーション (普通はタイミングの応答期限 (deadline) を満たす必要があるアプリケーション) @@ -344,8 +342,8 @@ POSIX では、成功時に \fBsched_setscheduler\fP() は直前のスケジュ \fIProgramming for the real world \- POSIX.4\fP by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1\-56592\-074\-0. .PP -The Linux kernel source file \fIDocumentation/scheduler/sched\-rt\-group.txt\fP +Linux カーネルソースファイル \fIDocumentation/scheduler/sched\-rt\-group.txt\fP .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/man2/sched_yield.2 b/release/man2/sched_yield.2 index e8c3eedb..802851db 100644 --- a/release/man2/sched_yield.2 +++ b/release/man2/sched_yield.2 @@ -65,6 +65,6 @@ Linux のスケージュリング (scheduling) については \fBsched_setsched \fIProgramming for the real world \- POSIX.4\fP by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1\-56592\-074\-0. .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/man2/select.2 b/release/man2/select.2 index 5905f7c1..3c52313a 100644 --- a/release/man2/select.2 +++ b/release/man2/select.2 @@ -240,16 +240,13 @@ struct timeval { 悪いことに glibc 2.0 以前では \fBpselect\fP() のプロトタイプが間違っている。 glibc 2.1 から 2.2.1 では \fB_GNU_SOURCE\fP が定義されている場合に、 \fBpselect\fP() が提供される。 glibc 2.2.2 以降では、 \fBpselect\fP() を使用するには、「書式」に記載された要件を満たす必要がある。 -.SS "Multithreaded applications" -If a file descriptor being monitored by \fBselect\fP() is closed in another -thread, the result is unspecified. On some UNIX systems, \fBselect\fP() -unblocks and returns, with an indication that the file descriptor is ready -(a subsequent I/O operation will likely fail with an error, unless another -the file descriptor reopened between the time \fBselect\fP() returned and the -I/O operations was performed). On Linux (and some other systems), closing -the file descriptor in another thread has no effect on \fBselect\fP(). In -summary, any application that relies on a particular behavior in this -scenario must be considered buggy. +.SS マルチスレッド・アプリケーション +\fBselect\fP() で監視中のファイルディスクリプタが別のスレッドでクローズされた場合、どのような結果になるかは規定されていない。いくつかの +UNIX システムでは、 \fBselect\fP() は停止 (block) せず、すぐ返り、ファイルディスクリプタが ready だと報告される +(\fBselect\fP() が返ってから I/O 操作が実行されるまでの間に、 別のファイルディスクリプタが再度オープンされない限り、 それ以降の I/O +操作はおそらく失敗するだろう)。 Linux (や他のいくつかのシステム) では、 別のスレッドでファイルディスクリプタがクローズされても +\fBselect\fP() には影響を与えない。 +まとめると、このような場合に特定の動作に依存しているアプリケーションは「バグっている」と考えなければならない。 .SS "Linux での注意" このページで説明している \fBpselect\fP() のインターフェースは、glibc に 実装されているものである。内部で呼び出される Linux のシステムコールは @@ -350,6 +347,6 @@ main(void) 考察と使用例の書かれたチュートリアルとして、 \fBselect_tut\fP(2) がある。 .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/man2/select_tut.2 b/release/man2/select_tut.2 index d0332657..840e485a 100644 --- a/release/man2/select_tut.2 +++ b/release/man2/select_tut.2 @@ -602,6 +602,6 @@ main(int argc, char *argv[]) \fBsigaddset\fP(3), \fBsigdelset\fP(3), \fBsigemptyset\fP(3), \fBsigfillset\fP(3), \fBsigismember\fP(3), \fBepoll\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/man2/semctl.2 b/release/man2/semctl.2 index 68cf290f..5d3e3538 100644 --- a/release/man2/semctl.2 +++ b/release/man2/semctl.2 @@ -43,7 +43,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SEMCTL 2 2012\-05\-31 Linux "Linux Programmer's Manual" +.TH SEMCTL 2 2013\-06\-03 Linux "Linux Programmer's Manual" .SH 名前 semctl \- System V セマフォの制御操作を行なう .SH 書式 @@ -78,10 +78,10 @@ union semun { .in +4n struct semid_ds { - struct ipc_perm sem_perm; /* 所有権と許可 */ - time_t sem_otime; /* 最後の semop の時刻 */ - time_t sem_ctime; /* 最後に変更が行われた時刻 */ - unsigned short sem_nsems; /* 集合内のセマフォの数 */ + struct ipc_perm sem_perm; /* Ownership and permissions */ + time_t sem_otime; /* Last semop time */ + time_t sem_ctime; /* Last change time */ + unsigned long sem_nsems; /* No. of semaphores in set */ }; .in .fi @@ -102,7 +102,7 @@ struct ipc_perm { .in .fi .PP -\fIcmd\fP として有効な値は +\fIcmd\fP として有効な値は次の通りである。 .TP 10 \fBIPC_STAT\fP \fIsemid\fP に関連づけられたカーネルデータ構造体の情報を \fIarg.buf\fP で指された \fIsemid_ds\fP 構造体へコピーする。 @@ -248,6 +248,11 @@ struct seminfo { .SH 準拠 .\" SVr4 documents more error conditions EINVAL and EOVERFLOW. SVr4, POSIX.1\-2001. + +POSIX.1\-2001 specifies the \fIsem_nsems\fP field of the \fIsemid_ds\fP structure +as having the type \fIunsigned\ short\fP, and the field is so defined on most +other systems. It was also so defined on Linux 2.2 and earlier, but, since +Linux 2.4, the field has the type \fIunsigned\ long\fP. .SH 注意 .\" Like Linux, the FreeBSD man pages still document .\" the inclusion of these header files. @@ -277,6 +282,6 @@ POSIX.1\-2001 では呼び出し側がこの共用体を定義する必要があ \fBipc\fP(2), \fBsemget\fP(2), \fBsemop\fP(2), \fBcapabilities\fP(7), \fBsem_overview\fP(7), \fBsvipc\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/man2/semget.2 b/release/man2/semget.2 index 7d8d2f94..01290288 100644 --- a/release/man2/semget.2 +++ b/release/man2/semget.2 @@ -161,6 +161,6 @@ semid あたりのセマフォの最大数: 実装依存 (Linux では、この \fBsemctl\fP(2), \fBsemop\fP(2), \fBftok\fP(3), \fBcapabilities\fP(7), \fBsem_overview\fP(7), \fBsvipc\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/man2/semop.2 b/release/man2/semop.2 index 56a280cb..be8287e9 100644 --- a/release/man2/semop.2 +++ b/release/man2/semop.2 @@ -90,12 +90,9 @@ short sem_flg; /* 操作フラグ */ それぞれの操作はセマフォ集合の \fIsem_num\fP番目 のセマフォに対して実行される。セマフォ集合の最初のセマフォには 番号 0 が振られる。 そして操作は三種類あり、 \fIsem_op\fP の値で区別される。 .PP -If \fIsem_op\fP is a positive integer, the operation adds this value to the -semaphore value (\fIsemval\fP). Furthermore, if \fBSEM_UNDO\fP is specified for -this operation, the system subtracts the value \fIsem_op\fP from the semaphore -adjustment (\fIsemadj\fP) value for this semaphore. This operation can always -proceed\(emit never forces a thread to wait. The calling process must have -alter permission on the semaphore set. +\fIsem_op\fP が正の整数の場合、その値をセマフォの値 (\fIsemval\fP) に加算する。 さらに、この操作で \fBSEM_UNDO\fP +が指定されていた場合は、 システムはこのセマフォのの調整値 (\fIsemadj\fP) から値 \fIsem_op\fP を減算する。 この操作は必ず実行でき、 +スレッドの停止は起こらない。 呼び出し元プロセスは対象のセマフォ集合を変更する許可がなければならない。 .PP \fIsem_op\fP が 0 の場合、「ゼロまで待つ」操作である。この場合、プロセスは そのセマフォ集合に対する読み込み許可がなければならない。 \fIsemval\fP が 0 ならば、操作は直ちに行われる。 \fIsemval\fP が 0 でない場合、 \fIsem_flg\fP に @@ -113,21 +110,15 @@ alter permission on the semaphore set. \fBsemtimedop\fP() の \fItimeout\fP で指定された制限時間が経過した: このとき \fBsemtimedop\fP() は失敗し、 \fIerrno\fP に \fBEAGAIN\fP が設定される。 .PP -If \fIsem_op\fP is less than zero, the process must have alter permission on -the semaphore set. If \fIsemval\fP is greater than or equal to the absolute -value of \fIsem_op\fP, the operation can proceed immediately: the absolute -value of \fIsem_op\fP is subtracted from \fIsemval\fP, and, if \fBSEM_UNDO\fP is -specified for this operation, the system adds the absolute value of -\fIsem_op\fP to the semaphore adjustment (\fIsemadj\fP) value for this -semaphore. If the absolute value of \fIsem_op\fP is greater than \fIsemval\fP, -and \fBIPC_NOWAIT\fP is specified in \fIsem_flg\fP, \fBsemop\fP() fails, with -\fIerrno\fP set to \fBEAGAIN\fP (and none of the operations in \fIsops\fP is -performed). Otherwise \fIsemncnt\fP (the counter of threads waiting for this -semaphore's value to increase) is incremented by one and the thread sleeps -until one of the following occurs: +\fIsem_op\fP が 0 未満の場合、プロセスにはそのセマフォ集合を変更する許可がなければ ならない。 \fIsemval\fP が \fIsem_op\fP +の絶対値以上の場合は、操作は直ちに実行される: \fIsemval\fP から \fIsem_op\fP の絶対値を減算し、さらに、この操作に +\fBSEM_UNDO\fP が指定されている場合は、このセマフォの調整値 (\fIsemadj\fP) に \fIsem_op\fP の絶対値を加算する。 +\fIsemval\fP が \fIsem_op\fP の絶対値より小さく、 \fIsem_flg\fP に \fBIPC_NOWAIT\fP が指定された場合は、 +\fBsemop\fP() は失敗し、 \fIerrno\fP に \fBEAGAIN\fP が設定される (このとき \fIsops\fP の操作は全く実行されない)。 +\fIsemval\fP が \fIsem_op\fP の絶対値より小さく、 \fBIPC_WAIT\fP が指定されていない場合は、 \fIsemncnt\fP +(このセマフォの値が増加するのを待っているスレッド数のカウンタ) を 1 増加させて、以下のいずれかが起こるまでスレッドを停止 (sleep) する。 .IP \(bu 3 -\fIsemval\fP becomes greater than or equal to the absolute value of \fIsem_op\fP: -the operation now proceeds, as described above. +\fIsemval\fP が \fIsem_op\fP の絶対値以上になった。この時点で、操作は上述の通り実行される。 .IP \(bu セマフォ集合がシステムから削除された: このとき \fBsemop\fP() は失敗し \fIerrno\fP に \fBEIDRM\fP が設定される。 .IP \(bu @@ -207,16 +198,12 @@ Linux や POSIX の全てのバージョンでは、 \fI\fP と \fI \fBsemop\fP() はシグナルハンドラによって中断された後に、 決して自動的に再開することはない。 たとえシグナルハンドラの設定時に \fBSA_RESTART\fP フラグがセットされていても再開することはない -A semaphore adjustment (\fIsemadj\fP) value is a per\-process, per\-semaphore -integer that is the negated sum of all operations performed on a semaphore -specifying the \fBSEM_UNDO\fP flag. Each process has a list of \fIsemadj\fP -values\(emone value for each semaphore on which it has operated using -\fBSEM_UNDO\fP. When a process terminates, each of its per\-semaphore \fIsemadj\fP -values is added to the corresponding semaphore, thus undoing the effect of -that process's operations on the semaphore (but see BUGS below). When a -semaphore's value is directly set using the \fBSETVAL\fP or \fBSETALL\fP request -to \fBsemctl\fP(2), the corresponding \fIsemadj\fP values in all processes are -cleared. +セマフォの調整値 (\fIsemadj\fP) は、プロセス毎のセマフォ毎の整数で、 \fBSEM_UNDO\fP +フラグを指定して行われた、セマフォに対するすべての操作の合計値を反転したものである。 各プロセスは \fIsemadj\fP の値のリストを保持する \(em +リストのそれぞれの値は \fBSEM_UNDO\fP を使って操作が行われた個々のセマフォに対応する。 プロセスが終了する際、 セマフォ毎の +\fIsemadj\fP の各々の値が対応するセマフォに加算される。 これにより、そのプロセスがそのセマフォに対して行った操作の影響が取り消される +(ただし、下記の「バグ」を参照)。 \fBsemctl\fP(2) の \fBSETVAL\fP や \fBSETALL\fP を使ってセマフォの値が直接設定された場合、 +すべてのプロセスの対応する \fIsemadj\fP の値がクリアされる。 .PP あるセマフォの \fIsemval\fP, \fIsempid\fP, \fIsemzcnt\fP, \fIsemnct\fP の値はいずれも、適切な操作を指定して \fBsemctl\fP(2) を呼び出すことで取得できる。 @@ -275,6 +262,6 @@ cleared. \fBclone\fP(2), \fBsemctl\fP(2), \fBsemget\fP(2), \fBsigaction\fP(2), \fBcapabilities\fP(7), \fBsem_overview\fP(7), \fBsvipc\fP(7), \fBtime\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/man2/send.2 b/release/man2/send.2 index 3a51948e..e9ac8bea 100644 --- a/release/man2/send.2 +++ b/release/man2/send.2 @@ -251,6 +251,6 @@ Linux は \fBENOTCONN\fP を返す状況で \fBEPIPE\fP を返すことがある \fBsendmmsg\fP(2), \fBshutdown\fP(2), \fBsocket\fP(2), \fBwrite\fP(2), \fBcmsg\fP(3), \fBip\fP(7), \fBsocket\fP(7), \fBtcp\fP(7), \fBudp\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/man2/sendfile.2 b/release/man2/sendfile.2 index 682b2931..7f0a362a 100644 --- a/release/man2/sendfile.2 +++ b/release/man2/sendfile.2 @@ -124,6 +124,6 @@ Linux 固有の \fBsplice\fP(2) システムコールは、任意のファイル \fBmmap\fP(2), \fBopen\fP(2), \fBsocket\fP(2), \fBsplice\fP(2) .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/man2/sendmmsg.2 b/release/man2/sendmmsg.2 new file mode 100644 index 00000000..150bba54 --- /dev/null +++ b/release/man2/sendmmsg.2 @@ -0,0 +1,172 @@ +.\" Copyright (c) 2012 by Michael Kerrisk +.\" with some material from a draft by +.\" Stephan Mueller +.\" in turn based on Andi Kleen's recvmmsg.2 page. +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH SENDMMSG 2 2012\-12\-16 Linux "Linux Programmer's Manual" +.SH 名前 +sendmmsg \- 複数のメッセージをソケットへ送信する +.SH 書式 +.nf +\fB#define _GNU_SOURCE\fP +\fB#include \fP + +\fBint sendmmsg(int \fP\fIsockfd\fP\fB, struct mmsghdr *\fP\fImsgvec\fP\fB, unsigned int \fP\fIvlen\fP\fB,\fP +\fB unsigned int \fP\fIflags\fP\fB);\fP +.fi +.SH 説明 +.\" See commit 228e548e602061b08ee8e8966f567c12aa079682 +\fBsendmmsg\fP() システムコールは \fBsendmsg\fP(2) の拡張で、 +このシステムコールを使うと一度の呼び出しでソケットに複数のメッセージを送信できる (アプリケーションによっては性能上のメリットがある)。 + +\fIsockfd\fP 引き数は、 データを送信するソケットのファイルディスクリプタである。 + +\fImsgvec\fP 引き数は \fImmsghdr\fP 構造体の配列である。 この配列の大きさは \fIvlen\fP で指定する。 + +\fImmsghdr\fP 構造体は \fI\fP で次のように定義されている。 + +.in +4n +.nf +struct mmsghdr { + struct msghdr msg_hdr; /* メッセージヘッダ */ + unsigned int msg_len; /* 送信されたバイト数 */ +}; +.fi +.in +.PP +\fImsg_hdr\fP フィールドは、 \fBsendmsg\fP(2) で説明されている \fImsghdr\fP 構造体である。 \fImsg_len\fP +フィールドは \fImsg_hdr\fP から送信されたメッセージのバイト数を返すのに使用される。 この値は \fBsendmsg\fP(2) +をこのヘッダに対して呼び出した場合の返り値と同じである。 + +\fIflags\fP 引き数には複数のフラグを論理和 (OR) で指定できる。フラグは \fBsendmsg\fP(2) と同じである。 + +停止 (blocking) モードの \fBsendmmsg\fP() の呼び出しは、 \fIvlen\fP 個のメッセージが送信されるまで停止する。 非停止 +(nonblocking) モードの呼び出しでは、 送信できるだけのメッセージ (最大で \fIvlen\fP 個) を送信し、 すぐに返る。 + +\fBsendmmsg\fP() が返った際には、 \fImsgvec\fP の送信が行われた要素の \fImsg_len\fP フィールドは、対応する +\fImsg_hdr\fP から送信されたバイト数が入っている。 呼び出しの返り値は、更新された \fImsgvec\fP の要素数である。 +.SH 返り値 +成功すると、 \fBsendmmsg\fP() は \fImsgvec\fP から送信されたメッセージ数を返す。 返り値が \fIvlen\fP よりも小さい場合、 +呼び出した側では再度 \fBsendmmsg\fP を呼び出して残りのメッセージを送信することができる。 + +エラーの場合、 \-1 を返し、 \fIerrno\fP にエラーを示す値を設定する。 +.SH エラー +.\" commit 728ffb86f10873aaf4abd26dde691ee40ae731fe +.\" ... only return an error if no datagrams could be sent. +.\" If less than the requested number of messages were sent, the application +.\" must retry starting at the first failed one and if the problem is +.\" persistent the error will be returned. +.\" +.\" This matches the behaviour of other syscalls like read/write - it +.\" is not an error if less than the requested number of elements are sent. +エラーは \fBsendmsg\fP(2) と同じである。 エラーが返されるのは、 データグラムが全く送信できなかった場合のみである。 +.SH バージョン +\fBsendmmsg\fP() システムコールは Linux 3.0 で追加された。 glibc でのサポートはバージョン 2.14 で追加された。 +.SH 準拠 +\fBsendmmsg\fP() は Linux 固有である。 +.SH 注意 +.\" commit 98382f419f32d2c12d021943b87dea555677144b +.\" net: Cap number of elements for sendmmsg +.\" +.\" To limit the amount of time we can spend in sendmmsg, cap the +.\" number of elements to UIO_MAXIOV (currently 1024). +.\" +.\" For error handling an application using sendmmsg needs to retry at +.\" the first unsent message, so capping is simpler and requires less +.\" application logic than returning EINVAL. +\fIvlen\fP に指定できる値の最大値は \fBUIO_MAXIOV\fP (1024) である。 +.SH 例 +以下の例では、 \fBsendmmsg\fP() を使って、 一度のシステムコールで、 \fIonetwo\fP と \fIthree\fP を二つの別々の UDP +データグラムで送信する。 一つ目のデータグラムの内容は、二つのバッファから取得される。 + +.nf +#define _GNU_SOURCE +#include +#include +#include +#include +#include +#include + +int +main(void) +{ + int sockfd; + struct sockaddr_in sa; + struct mmsghdr msg[2]; + struct iovec msg1[2], msg2; + int retval; + + sockfd = socket(AF_INET, SOCK_DGRAM, 0); + if (sockfd == \-1) { + perror("socket()"); + exit(EXIT_FAILURE); + } + + sa.sin_family = AF_INET; + sa.sin_addr.s_addr = htonl(INADDR_LOOPBACK); + sa.sin_port = htons(1234); + if (connect(sockfd, (struct sockaddr *) &sa, sizeof(sa)) == \-1) { + perror("connect()"); + exit(EXIT_FAILURE); + } + + memset(msg1, 0, sizeof(msg1)); + msg1[0].iov_base = "one"; + msg1[0].iov_len = 3; + msg1[1].iov_base = "two"; + msg1[1].iov_len = 3; + + memset(&msg2, 0, sizeof(msg2)); + msg2.iov_base = "three"; + msg2.iov_len = 5; + + memset(msg, 0, sizeof(msg)); + msg[0].msg_hdr.msg_iov = msg1; + msg[0].msg_hdr.msg_iovlen = 2; + + msg[1].msg_hdr.msg_iov = &msg2; + msg[1].msg_hdr.msg_iovlen = 1; + + retval = sendmmsg(sockfd, msg, 2, 0); + if (retval == \-1) + perror("sendmmsg()"); + else + printf("%d messages sent\en", retval); + + exit(0); +} +.fi +.SH 関連項目 +\fBrecvmmsg\fP(2), \fBsendmsg\fP(2), \fBsocket\fP(2), \fBsocket\fP(7) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man2/set_mempolicy.2 b/release/man2/set_mempolicy.2 index bf32fc65..e08dc9e2 100644 --- a/release/man2/set_mempolicy.2 +++ b/release/man2/set_mempolicy.2 @@ -141,6 +141,6 @@ node)」に空きメモリが全くない場合、システムは 「近くの ( \fBget_mempolicy\fP(2), \fBgetcpu\fP(2), \fBmbind\fP(2), \fBmmap\fP(2), \fBnuma\fP(3), \fBcpuset\fP(7), \fBnuma\fP(7), \fBnumactl\fP(8) .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/man2/set_thread_area.2 b/release/man2/set_thread_area.2 index 79b2cc69..8cbcd955 100644 --- a/release/man2/set_thread_area.2 +++ b/release/man2/set_thread_area.2 @@ -53,6 +53,6 @@ set_thread_area \- スレッド局所記憶 (TLS) 領域を設定する .SH 関連項目 \fBget_thread_area\fP(2) .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/man2/set_tid_address.2 b/release/man2/set_tid_address.2 index 3d476af8..7e790f66 100644 --- a/release/man2/set_tid_address.2 +++ b/release/man2/set_tid_address.2 @@ -53,16 +53,13 @@ set_tid_address \- スレッド ID へのポインタを設定する システムコール \fBset_tid_address\fP() は呼び出し元プロセスの \fIclear_child_tid\fP の値を \fItidptr\fP に設定する。 .LP -When a process whose \fIclear_child_tid\fP is not NULL terminates, then, if the -process is sharing memory with other processes or threads, then 0 is written -at the address specified in \fIclear_child_tid\fP and the kernel performs the -following operation: +\fIclear_child_tid\fP が NULL でないプロセスが終了すると、そのプロセスが他のプロセスまたはスレッドとメモリを共有していれば、 +\fIclear_child_tid\fP で指定されたアドレスに 0 が書き込まれ、カーネルは以下の処理を実行する。 futex(clear_child_tid, FUTEX_WAKE, 1, NULL, NULL, 0); -The effect of this operation is to wake a single process that is performing -a futex wait on the memory location. Errors from the futex wake operation -are ignored. +この処理の結果、このメモリアドレスに対する futex wait を実行しているプロセスを一つ起こす (wake)。 futex wake +操作でのエラーは無視される。 .SH 返り値 \fBset_tid_address\fP() は常に現在のプロセスの PID を返す。 .SH エラー @@ -74,6 +71,6 @@ are ignored. .SH 関連項目 \fBclone\fP(2), \fBfutex\fP(2) .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/man2/seteuid.2 b/release/man2/seteuid.2 index f8cf0031..2060e473 100644 --- a/release/man2/seteuid.2 +++ b/release/man2/seteuid.2 @@ -80,13 +80,12 @@ _BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 実効ユーザー (グループ) ID を保存 set\-user\-ID (保存 set\-group\-ID) に 設定できるのは、Linux 1.1.37 (1.1.38) 以降である。 全てのシステムにおいて \fB_POSIX_SAVED_IDS\fP をチェックすべきである。 .LP -Under libc4, libc5 and glibc 2.0 \fBseteuid(\fP\fIeuid\fP\fB)\fP is equivalent to -\fBsetreuid(\-1,\fP\fI euid\fP\fB)\fP and hence may change the saved set\-user\-ID. -Under glibc 2.1 and later it is equivalent to \fBsetresuid(\-1,\fP\fI euid\fP\fB, -\-1)\fP and hence does not change the saved set\-user\-ID. Analogous remarks -hold for \fBsetegid\fP(), with the difference that the change in implementation -from \fBsetregid(\-1,\fP\fI egid\fP\fB)\fP to \fBsetresgid(\-1,\fP\fI egid\fP\fB, \-1)\fP -occurred in glibc 2.2 or 2.3 (dependeing on the hardware architecture). +libc4, libc5, glibc 2.0 では、 \fBseteuid(\fP\fIeuid\fP\fB)\fP は \fBsetreuid(\-1,\fP\fI +euid\fP\fB)\fP と等価であり、保存 set\-user\-ID を変更するかもしれない。 glibc 2.1 では、 +\fBsetresuid(\-1,\fP\fI euid\fP\fB, \-1)\fP と等価であり、保存 set\-user\-ID 変更しない。 同様のことが +\fBsetegid\fP() にも言えるが、 glibc 2.2 か 2.3 で、 実装が \fBsetregid(\-1,\fP\fI egid\fP\fB)\fP から +\fBsetresgid(\-1,\fP\fI egid\fP\fB, \-1)\fP へ変更された点だけが違う (どの glibc +バージョンで変更が行われたかは、ハードウェアアーキテクチャによって異なる)。 POSIX.1 では、 \fBseteuid\fP() (\fBsetegid\fP()) で、 \fIeuid\fP (\fIegid\fP) として現在の実効ユーザ (グループ) ID と同じ値を指定可能である 必要はないとされており、いくつかの実装では \fIeuid\fP (\fIegid\fP) として現在の実効ユーザ @@ -95,6 +94,6 @@ POSIX.1 では、 \fBseteuid\fP() (\fBsetegid\fP()) で、 \fIeuid\fP (\fIegid \fBgeteuid\fP(2), \fBsetresuid\fP(2), \fBsetreuid\fP(2), \fBsetuid\fP(2), \fBcapabilities\fP(7), \fBcredentials\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/man2/setfsgid.2 b/release/man2/setfsgid.2 index 4e34be84..520ca684 100644 --- a/release/man2/setfsgid.2 +++ b/release/man2/setfsgid.2 @@ -79,6 +79,6 @@ glibc の \fBsetfsgid\fP() のラッパー関数は .SH 関連項目 \fBkill\fP(2), \fBsetfsuid\fP(2), \fBcapabilities\fP(7), \fBcredentials\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/man2/setfsuid.2 b/release/man2/setfsuid.2 index ec0154fb..4d5bcdb0 100644 --- a/release/man2/setfsuid.2 +++ b/release/man2/setfsuid.2 @@ -79,6 +79,6 @@ glibc の \fBsetfsuid\fP() のラッパー関数は .SH 関連項目 \fBkill\fP(2), \fBsetfsgid\fP(2), \fBcapabilities\fP(7), \fBcredentials\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/man2/setgid.2 b/release/man2/setgid.2 index 4823ee28..db047414 100644 --- a/release/man2/setgid.2 +++ b/release/man2/setgid.2 @@ -67,6 +67,6 @@ glibc の \fBsetgid\fP() のラッパー関数は \fBgetgid\fP(2), \fBsetegid\fP(2), \fBsetregid\fP(2), \fBcapabilities\fP(7), \fBcredentials\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/man2/setns.2 b/release/man2/setns.2 index 11bf6a4f..2c6787d0 100644 --- a/release/man2/setns.2 +++ b/release/man2/setns.2 @@ -81,46 +81,39 @@ setns \- スレッドに名前空間を関連付けしなおす .SH 注意 新しいスレッドが \fBclone\fP(2) を使って作成された際に共有できる全ての属性を、 \fBsetns\fP() を使って変更できるわけではない。 -.SH EXAMPLE -The program below takes two or more arguments. The first argument specifies -the pathname of a namespace file in an existing \fI/proc/[pid]/ns/\fP -directory. The remaining arguments specify a command and its arguments. -The program opens the namespace file, joins that namespace using \fBsetns\fP(), -and executes the specified command inside that namespace. +.SH 例 +以下のプログラムは 2 つ以上の引き数を取る。 最初の引き数には、 既存の \fI/proc/[pid]/ns/\fP +ディレクトリの名前空間ファイルのパス名を指定する。 残りの引き数は、コマンドとその引き数を指定する。 このプログラムは名前空間ファイルをオープンし、 +\fBsetns\fP() を使って名前空間に参加し、 指定されたコマンドをその名前空間内で実行する。 -The following shell session demonstrates the use of this program (compiled -as a binary named \fIns_exec\fP) in conjunction with the \fBCLONE_NEWUTS\fP -example program in the \fBclone\fP(2) man page (complied as a binary named -\fInewuts\fP). +以下のシェルセッションでは、 このプログラム (\fIns_exec\fP という名前のバイナリとしてコンパイルされている)を、 \fBclone\fP(2) +のマニュアルページの \fBCLONE_NEWUTS\fP のサンプルプログラムと組み合わせて使っている。 -We begin by executing the example program in \fBclone\fP(2) in the -background. That program creates a child in a separate UTS namespace. The -child changes the hostname in its namespace, and then both processes display -the hostnames in their UTS namespaces, so that we can see that they are -different. +まず、 \fBclone\fP(2) のサンプルプログラムをバックグラウンドで実行する。 このプログラムは、 別の UTS 名前空間で子プロセスを作成する。 +子プロセスは自分の名前空間内でホスト名を変更する。 それから、 親プロセスと子プロセスの両方でそれぞれの UTS 名前空間のホスト名を表示し、 2 +つのホスト名が違うことが確認できる。 .nf .in +4n -$ \fBsu\fP # Need privilege for namespace operations +$ \fBsu\fP # 名前空間の操作には特権が必要 Password: # \fB./newuts bizarro &\fP [1] 3549 clone() returned 3550 uts.nodename in child: bizarro uts.nodename in parent: antero -# \fBuname \-n\fP # Verify hostname in the shell +# \fBuname \-n\fP # シェルでホスト名を確認 antero .in .fi -We then run the program shown below, using it to execute a shell. Inside -that shell, we verify that the hostname is the one set by the child created -by the first program: +次に、以下のプログラムを使ってシェルを実行する。 +このシェルの中では、ホスト名が最初のプログラムで作成された子プロセスが設定したホスト名になっていることを確認できる。 .nf .in +4n # \fB./ns_exec /proc/3550/ns/uts /bin/bash\fP -# \fBuname \-n\fP # Executed in shell started by ns_exec +# \fBuname \-n\fP # ns_exec で起動されたシェル内で実行 bizarro .in .fi @@ -146,20 +139,20 @@ main(int argc, char *argv[]) exit(EXIT_FAILURE); } - fd = open(argv[1], O_RDONLY); /* Get descriptor for namespace */ + fd = open(argv[1], O_RDONLY); /* 名前空間のディスクリプタを取得 */ if (fd == \-1) errExit("open"); - if (setns(fd, 0) == \-1) /* Join that namespace */ + if (setns(fd, 0) == \-1) /* 名前空間に参加 */ errExit("setns"); - execvp(argv[2], &argv[2]); /* Execute a command in namespace */ + execvp(argv[2], &argv[2]); /* 名前空間内でコマンドを実行 */ errExit("execvp"); } .fi .SH 関連項目 \fBclone\fP(2), \fBfork\fP(2), \fBvfork\fP(2), \fBproc\fP(5), \fBunix\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/man2/setpgid.2 b/release/man2/setpgid.2 index 874aa568..015aab0a 100644 --- a/release/man2/setpgid.2 +++ b/release/man2/setpgid.2 @@ -185,6 +185,6 @@ control) の実装のための プロセスグループを作成するのに使 \fBgetuid\fP(2), \fBsetsid\fP(2), \fBtcgetpgrp\fP(3), \fBtcsetpgrp\fP(3), \fBtermios\fP(3), \fBcredentials\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/man2/setresuid.2 b/release/man2/setresuid.2 index 39776a70..74518071 100644 --- a/release/man2/setresuid.2 +++ b/release/man2/setresuid.2 @@ -84,6 +84,6 @@ glibc の \fBsetresuid\fP() と \fBsetresgid\fP() のラッパー関数は \fBgetresuid\fP(2), \fBgetuid\fP(2), \fBsetfsgid\fP(2), \fBsetfsuid\fP(2), \fBsetreuid\fP(2), \fBsetuid\fP(2), \fBcapabilities\fP(7), \fBcredentials\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/man2/setreuid.2 b/release/man2/setreuid.2 index 4fe32bc0..4873874e 100644 --- a/release/man2/setreuid.2 +++ b/release/man2/setreuid.2 @@ -116,6 +116,6 @@ glibc の \fBsetreuid\fP() と \fBsetregid\fP() のラッパー関数は \fBgetgid\fP(2), \fBgetuid\fP(2), \fBseteuid\fP(2), \fBsetgid\fP(2), \fBsetresuid\fP(2), \fBsetuid\fP(2), \fBcapabilities\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/man2/setsid.2 b/release/man2/setsid.2 index 86bace82..9d6b6935 100644 --- a/release/man2/setsid.2 +++ b/release/man2/setsid.2 @@ -67,6 +67,6 @@ SVr4, POSIX.1\-2001. \fBsetsid\fP(1), \fBgetsid\fP(2), \fBsetpgid\fP(2), \fBsetpgrp\fP(2), \fBtcgetsid\fP(3), \fBcredentials\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/man2/setuid.2 b/release/man2/setuid.2 index 6edc850b..85077e01 100644 --- a/release/man2/setuid.2 +++ b/release/man2/setuid.2 @@ -90,6 +90,6 @@ glibc の \fBsetuid\fP() のラッパー関数は \fBgetuid\fP(2), \fBseteuid\fP(2), \fBsetfsuid\fP(2), \fBsetreuid\fP(2), \fBcapabilities\fP(7), \fBcredentials\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/man2/setup.2 b/release/man2/setup.2 index 89ea9356..a51b300d 100644 --- a/release/man2/setup.2 +++ b/release/man2/setup.2 @@ -60,9 +60,9 @@ Linux 2.1.121 以降では、もはやこの関数は存在しない。 .SH 準拠 この関数は Linux に特有のものであり、移植を考慮したプログラムでは 用いるべきではない。それどころか、あらゆるプログラムで用いるべきではない。 .SH 注意 -呼び出し手続きは変化してきた。 ある時は \fIsetup ()\fP は一つの引数 \fIvoid *BIOS\fP を取っており、またある時には \fIint -magic\fP を一つの引数として取っていた。 +The calling sequence varied: at some times \fIsetup ()\fP has had a single +argument \fIvoid\ *BIOS\fP and at other times a single argument \fIint magic\fP. .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/man2/setxattr.2 b/release/man2/setxattr.2 index fcc118d6..0a372656 100644 --- a/release/man2/setxattr.2 +++ b/release/man2/setxattr.2 @@ -102,6 +102,6 @@ inode に対して、互いに独立な名前空間が複数あってもよい \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBgetxattr\fP(2), \fBlistxattr\fP(2), \fBopen\fP(2), \fBremovexattr\fP(2), \fBstat\fP(2), \fBattr\fP(5), \fBsymlink\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/man2/sgetmask.2 b/release/man2/sgetmask.2 index ff3ff751..bfbe7210 100644 --- a/release/man2/sgetmask.2 +++ b/release/man2/sgetmask.2 @@ -62,6 +62,6 @@ glibc はこれらの古いシステムコールに対するラッパー関数 .SH 関連項目 \fBsigprocmask\fP(2), \fBsignal\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/man2/shmctl.2 b/release/man2/shmctl.2 index d030a48e..e9862531 100644 --- a/release/man2/shmctl.2 +++ b/release/man2/shmctl.2 @@ -121,8 +121,7 @@ struct ipc_perm { 呼び出し元は最終的にはセグメントを忘れずに破棄\fIしなければならない\fP。 そうでなれば、フォールト (fault) されたページは メモリかスワップ (swap) に残り続ける。 .IP -See also the description of \fI/proc/sys/kernel/shm_rmid_forced\fP in -\fBproc\fP(5). +\fBproc\fP(5) の \fI/proc/sys/kernel/shm_rmid_forced\fP の説明も参照のこと。 .TP 10 \fBIPC_INFO\fP (Linux 固有) システム全体での共有メモリの制限とパラメータに関する情報を、 \fIbuf\fP が指す構造体に入れて返す。 この構造体は \fIshminfo\fP 型である @@ -241,11 +240,9 @@ SVr4, POSIX.1\-2001. .SH 注意 .\" Like Linux, the FreeBSD man pages still document .\" the inclusion of these header files. -The inclusion of \fI\fP and \fI\fP isn't -required on Linux or by any version of POSIX. However, some old -implementations required the inclusion of these header files, and the SVID -also documented their inclusion. Applications intended to be portable to -such old systems may need to include these header files. +Linux や POSIX の全てのバージョンでは、 \fI\fP と \fI\fP +のインクルードは必要ない。しかしながら、いくつかの古い実装ではこれらのヘッダファイルのインクルードが必要であり、 SVID +でもこれらのインクルードをするように記載されている。このような古いシステムへの移植性を意図したアプリケーションではこれらのファイルをインクルードする必要があるかもしれない。 \fBIPC_INFO\fP, \fBSHM_STAT\fP, \fBSHM_INFO\fP 操作は、 \fBipcs\fP(1) プログラムで割り当て済の資源に関する情報を提供するために 使用されている。将来、これらの操作は変更されたり、 /proc @@ -262,6 +259,6 @@ Linux では、 \fIshmctl(IPC_RMID)\fP を使ってすでに削除マークが \fBmlock\fP(2), \fBsetrlimit\fP(2), \fBshmget\fP(2), \fBshmop\fP(2), \fBcapabilities\fP(7), \fBshm_overview\fP(7), \fBsvipc\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/man2/shmget.2 b/release/man2/shmget.2 index 19dd843b..394ff025 100644 --- a/release/man2/shmget.2 +++ b/release/man2/shmget.2 @@ -40,7 +40,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SHMGET 2 2012\-05\-31 Linux "Linux Programmer's Manual" +.TH SHMGET 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 shmget \- System V 共有メモリ・セグメントを割り当てる .SH 書式 @@ -103,7 +103,8 @@ shmget \- System V 共有メモリ・セグメントを割り当てる .PP 共有メモリ・セグメントが既に存在する場合、アクセス許可の検査と、 破壊 (destruction) マークがつけられていないかのチェックが行われる。 .SH 返り値 -成功した場合、有効なセグメント識別子 \fIshmid\fP が返される。エラーの場合、 \-1 が返される。 +On success, a valid shared memory identifier is returned. On errir, \-1 is +returned, and \fIerrno\fP is set to indicate the error. .SH エラー 失敗した場合は \fIerrno\fP が以下のどれかに設定される: .TP @@ -142,11 +143,9 @@ SVr4, POSIX.1\-2001. .SH 注意 .\" Like Linux, the FreeBSD man pages still document .\" the inclusion of these header files. -The inclusion of \fI\fP and \fI\fP isn't -required on Linux or by any version of POSIX. However, some old -implementations required the inclusion of these header files, and the SVID -also documented their inclusion. Applications intended to be portable to -such old systems may need to include these header files. +Linux や POSIX の全てのバージョンでは、 \fI\fP と \fI\fP +のインクルードは必要ない。しかしながら、いくつかの古い実装ではこれらのヘッダファイルのインクルードが必要であり、 SVID +でもこれらのインクルードをするように記載されている。このような古いシステムへの移植性を意図したアプリケーションではこれらのファイルをインクルードする必要があるかもしれない。 \fBIPC_PRIVATE\fP はフラグではなく \fIkey_t\fP 型である。 この特別な値が \fIkey\fP に使用された場合は、 \fBshmget\fP() は \fIshmflg\fP の下位 9 ビットを除いた全てを無視し、 (成功すれば) 新しい共有メモリ・セグメントを作成する。 @@ -181,6 +180,6 @@ such old systems may need to include these header files. \fBshmat\fP(2), \fBshmctl\fP(2), \fBshmdt\fP(2), \fBftok\fP(3), \fBcapabilities\fP(7), \fBshm_overview\fP(7), \fBsvipc\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/man2/shmop.2 b/release/man2/shmop.2 index a01d10ed..ff28a273 100644 --- a/release/man2/shmop.2 +++ b/release/man2/shmop.2 @@ -134,9 +134,10 @@ shmat, shmdt \- System V 共有メモリ (shared memory) の操作 .\" SVr4 documents an additional error condition EMFILE. SVr4, POSIX.1\-2001. -SVID 3 で (たぶんそれより前だと思うが) \fIshmaddr\fP 引き数の型は \fIchar *\fP から \fIconst void *\fP -に、\fIshmat\fP() の返り値の型は \fIchar *\fP から \fIvoid *\fP に変更された (Linux では libc4 と libc5 -のプロトタイプは \fIchar *\fP であり、glibc2 のプロトタイプは \fIvoid *\fP である)。 +In SVID 3 (or perhaps earlier) the type of the \fIshmaddr\fP argument was +changed from \fIchar\ *\fP into \fIconst void\ *\fP, and the returned type of +\fBshmat\fP() from \fIchar\ *\fP into \fIvoid\ *\fP. (Linux libc4 and libc5 have +the \fIchar\ *\fP prototypes; glibc2 has \fIvoid\ *\fP.) .SH 注意 共有メモリセグメントを付加する場合の移植性の高い方法としては、 \fIshmaddr\fP を NULL にして \fBshmat\fP() を使用するのがよい。 このような方法で付加される共有メモリセグメントは、 プロセスが異なれば別のアドレスに付加される、という点に注意すること。 @@ -160,6 +161,6 @@ POSIX.1\-2001 ではこのような動作を指定しておらず、 他の多 \fBbrk\fP(2), \fBmmap\fP(2), \fBshmctl\fP(2), \fBshmget\fP(2), \fBcapabilities\fP(7), \fBshm_overview\fP(7), \fBsvipc\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/man2/shutdown.2 b/release/man2/shutdown.2 index dd93b5f9..5dde722b 100644 --- a/release/man2/shutdown.2 +++ b/release/man2/shutdown.2 @@ -61,7 +61,7 @@ shutdown \- 全二重接続の一部を閉じる \fIsockfd\fP が有効なディスクリプターでない。 .TP \fBEINVAL\fP -An invalid value was specified in \fIhow\fP (but see BUGS). +\fIhow\fP に無効な値が指定された (バグが参照)。 .TP \fBENOTCONN\fP 指定されたソケットは接続されていない。 @@ -76,13 +76,11 @@ glibc\-2.1.91 以降、 \fI\fP で定義されている。 .SH バグ .\" FIXME .\" https://bugzilla.kernel.org/show_bug.cgi?id=47111 -As currently implemented, checks for the validity of \fIhow\fP are done in -domain\-specific code, and not all domains perform these checks. Most -notably, UNIX domain sockets simply ignore invalid values; this may change -in the future. +現在の実装では \fIhow\fP の妥当性チェックはドメイン固有のコードの中で行われているが、 すべてのドメインでこれらのチェックが行われている訳ではない。 +中でも注意すべきは、 UNIX ドメインソケットでは無効な値は単に無視される点である。 これは将来変更されるかもしれない。 .SH 関連項目 \fBconnect\fP(2), \fBsocket\fP(2), \fBsocket\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/man2/sigaction.2 b/release/man2/sigaction.2 index d127eebc..4819167c 100644 --- a/release/man2/sigaction.2 +++ b/release/man2/sigaction.2 @@ -49,7 +49,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGACTION 2 2013\-02\-12 Linux "Linux Programmer's Manual" +.TH SIGACTION 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 sigaction \- シグナルの動作の確認と変更 .SH 書式 @@ -195,10 +195,9 @@ siginfo_t { Linux では一般的には使用されない)。 構造体の残りの部分は、共用体 (union) になっているかもしれない。 その場合は該当するシグナルにおいて意味のあるフィールドのみを読み込む ことができる。 .IP * 2 -Signals sent with \fBkill\fP(2) and \fBsigqueue\fP(3) fill in \fIsi_pid\fP and -\fIsi_uid\fP. In addition, signals sent with \fBsigqueue\fP(3) fill in \fIsi_int\fP -and \fIsi_ptr\fP with the values specified by the sender of the signal; see -\fBsigqueue\fP(3) for more details. +\fBkill\fP(2) や \fBsigqueue\fP(3) で送信されたシグナルでは \fIsi_pid\fP と \fIsi_uid\fP が設定される。 +さらに、 \fBsigqueue\fP(3) で送信されたシグナルでは \fIsi_int\fP と \fIsi_pid\fP +にシグナルの送信者により指定された値が設定される。詳細は \fBsigqueue\fP(3) を参照。 .IP * POSIX.1b タイマ (Linux 2.6 以降) は \fIsi_overrun\fP と \fIsi_timerid\fP を 設定する。 \fIsi_timerid\fP フィールドはカーネルがタイマを特定するのに @@ -207,11 +206,9 @@ POSIX.1b タイマ (Linux 2.6 以降) は \fIsi_overrun\fP と \fIsi_timerid\fP これは \fBtimer_getoverrun\fP(2) の呼び出しで取得できる情報と同じである。 これらのフィールドは非標準で Linux による拡張である。 .IP * -Signals sent for message queue notification (see the description of -\fBSIGEV_SIGNAL\fP in \fBmq_notify\fP(3)) fill in \fIsi_int\fP/\fIsi_ptr\fP, with the -\fIsigev_value\fP supplied to \fBmq_notify\fP(3); \fIsi_pid\fP, with the process ID -of the message sender; and \fIsi_uid\fP, with the real user ID of the message -sender. +メッセージキューの通知用に送信されたシグナル (\fBmq_notify\fP(3) の \fBSIGEV_SIGNAL\fP の説明を参照) では、 +\fIsi_int\fP/\fIsi_ptr\fP に \fBmq_notify\fP(3) に渡された \fIsigev_value\fP が設定される。 \fIsi_pid\fP +にはメッセージ送信者のプロセス ID が設定され、 \fIsi_uid\fP にはメッセージ送信者の実ユーザ ID が設定される。 .IP * .\" FIXME . .\" When si_utime and si_stime where originally implemented, the @@ -247,24 +244,19 @@ CPU 時間の単位が (カーネルのコンフィグで指定される) シス .\" info.si_code = exit_code; .\" info.si_pid = task_pid_vnr(current); .\" info.si_uid = current_uid(); /* Real UID */ -\fBSIGILL\fP, \fBSIGFPE\fP, \fBSIGSEGV\fP, \fBSIGBUS\fP, and \fBSIGTRAP\fP fill in -\fIsi_addr\fP with the address of the fault. On some architectures, these -signals also fill in the \fIsi_trapno\fP filed. Some suberrors of \fBSIGBUS\fP, -in particular \fBBUS_MCEERR_AO\fP and \fBBUS_MCEERR_AR\fP, also fill in -\fIsi_addr_lsb\fP. This field indicates the least significant bit of the -reported address and therefore the extent of the corruption. For example, -if a full page was corrupted, \fIsi_addr_lsb\fP contains -\fIlog2(sysconf(_SC_PAGESIZE))\fP. \fBBUS_MCERR_*\fP and \fIsi_addr_lsb\fP are -Linux\-specific extensions. +\fBSIGILL\fP, \fBSIGFPE\fP, \fBSIGSEGV\fP, \fBSIGBUS\fP, \fBSIGTRAP\fP では、 \fIsi_addr\fP に +fault が発生したアドレスが設定される。 いくつかのアーキテクチャでは \fIsi_trapno\fP も設定される。 \fBSIGBUS\fP +が発生するエラーのいくつか、特に \fBBUS_MCEERR_AO\fP と \fBBUS_MCEERR_AR\fP では、 \fIsi_addr_lsb\fP +も設定される。 このフィールドは報告されるアドレスの最下位ビットを示し、 これによりメモリ破壊の程度を知ることができる。 +例えば、ページ全体が壊れている場合には \fIsi_addr_lsb\fP には \fIlog2(sysconf(_SC_PAGESIZE))\fP が入る。 +\fBBUS_MCERR_*\fP と \fIsi_addr_lsb\fP は Linux 固有の拡張である。 .IP * -\fBSIGIO\fP/\fBSIGPOLL\fP (the two names are synonyms on Linux) fills in -\fIsi_band\fP and \fIsi_fd\fP. The \fIsi_band\fP event is a bit mask containing the -same values as are filled in the \fIrevents\fP field by \fBpoll\fP(2). The -\fIsi_fd\fP field indicates the file descriptor for which the I/O event -occurred. +\fBSIGIO\fP/\fBSIGPOLL\fP (2 つの名前は Linux では同義語) では \fIsi_band\fP と \fIsi_fd\fP が設定される。 +\fIsi_band\fP イベントは、 \fBpoll\fP(2) が \fIrevents\fP フィールドに設定するのと同じ値が入ったビットマスクである。 +\fIsi_fd\fP フィールドは I/O イベントが発生したファイルディスクリプタを示す。 .PP -\fIsi_code\fP は、そのシグナルが送信された理由を示す値である (ビットマスクではない)。 以下のリストに、どのシグナルの場合でも -\fIsi_code\fP に入りうる値を、シグナルが生成された理由とともに記載する。 +\fIsi_code\fP は、そのシグナルが送信された理由を示す値である (ビットマスクではない)。 以下は、どのシグナルの場合でも \fIsi_code\fP +に入りうる値のリストである。シグナルが生成された理由も記載している。 .RS 4 .TP 15 \fBSI_USER\fP @@ -286,8 +278,8 @@ POSIX メッセージキューの状態が変化した (Linux 2.6.6 以降)。 \ 非同期 IO (AIO) が完了した .TP \fBSI_SIGIO\fP -Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward -\fBSIGIO\fP/\fBSIGPOLL\fP fills in \fIsi_code\fP as described below). +\fBSIGIO\fP がキューイングされた (Linux 2.2 以下のカーネルのみ; Linux 2.4 以降では以下で説明する +\fBSIGIO\fP/\fBSIGPOLL\fP の \fIsi_code\fP が入る)。 .TP \fBSI_TKILL\fP .\" SI_DETHREAD is defined in 2.6.9 sources, but isn't implemented @@ -296,7 +288,7 @@ Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward \fBtkill\fP(2) または \fBtgkill\fP(2) (Linux 2.4.19 以降) .RE .PP -\fBSIGILL\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる: +\fBSIGILL\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBILL_ILLOPC\fP @@ -324,7 +316,7 @@ Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward 内部スタックエラー .RE .PP -\fBSIGFPE\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる: +\fBSIGFPE\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBFPE_INTDIV\fP @@ -352,7 +344,7 @@ Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward 範囲外の添字 (subscript) .RE .PP -\fBSIGSEGV\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる: +\fBSIGSEGV\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBSEGV_MAPERR\fP @@ -362,7 +354,7 @@ Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward マッピングされたオブジェクトに対するアクセス許可がない .RE .PP -\fBSIGBUS\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる: +\fBSIGBUS\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBBUS_ADRALN\fP @@ -375,13 +367,13 @@ Queued \fBSIGIO\fP (only in kernels up to Linux 2.2; from Linux 2.4 onward オブジェクト固有のハードウェアエラー .TP \fBBUS_MCEERR_AR\fP (Linux 2.6.32 以降) -Hardware memory error consumed on a machine check; action required. +マシンチェックで使用中のハードウェアメモリのエラーが検出された。対応が必須。 .TP \fBBUS_MCEERR_AO\fP (Linux 2.6.32 以降) -Hardware memory error detected in process but not consumed; action optional. +実行中にハードウェアメモリエラーが検出されたが、使用中のメモリではない。対応は必須ではない。 .RE .PP -\fBSIGTRAP\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる: +\fBSIGTRAP\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBTRAP_BRKPT\fP @@ -391,13 +383,13 @@ Hardware memory error detected in process but not consumed; action optional. プロセスのトレース・トラップ .TP \fBTRAP_BRANCH\fP (Linux 2.4 以降) -process taken branch trap +プロセスのブランチ・トラップ .TP \fBTRAP_HWBKPT\fP (Linux 2.4 以降) -hardware breakpoint/watchpoint +ハードウェア・ブレークポイント/ウォッチポイント .RE .PP -\fBSIGCHLD\fP シグナルの場合、 \fIsi_code\fP には以下の値を指定できる: +\fBSIGCHLD\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBCLD_EXITED\fP @@ -419,8 +411,7 @@ hardware breakpoint/watchpoint 停止していた子プロセスが再開した (Linux 2.6.9 以降) .RE .PP -\fBSIGIO\fP/\fBSIGPOLL\fP シグナルの場合、 \fIsi_code\fP には以下の値を -指定できる: +\fBSIGIO\fP/\fBSIGPOLL\fP シグナルの場合、 \fIsi_code\fP には以下の値が入る可能性がある: .RS 4 .TP 15 \fBPOLL_IN\fP @@ -442,7 +433,8 @@ I/O エラー デバイスが接続されていない .RE .SH 返り値 -\fBsigaction\fP() は成功すれば 0 を返し、エラーならば \-1 を返す。 +\fBsigaction\fP() returns 0 on success; on error, \-1 is returned, and \fIerrno\fP +is set to indicate the error. .SH エラー .TP \fBEFAULT\fP @@ -507,6 +499,6 @@ POSIX.1\-2001 では \fBSA_NOCLDWAIT\fP, \fBSA_RESETHAND\fP, \fBSA_NODEFER\fP, \fBsigqueue\fP(3), \fBsigsetops\fP(3), \fBsigvec\fP(3), \fBcore\fP(5), \fBsignal\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/man2/sigaltstack.2 b/release/man2/sigaltstack.2 index 04f897a5..7f644d98 100644 --- a/release/man2/sigaltstack.2 +++ b/release/man2/sigaltstack.2 @@ -167,6 +167,6 @@ if (sigaltstack(&ss, NULL) == \-1) \fBexecve\fP(2), \fBsetrlimit\fP(2), \fBsigaction\fP(2), \fBsiglongjmp\fP(3), \fBsigsetjmp\fP(3), \fBsignal\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/man2/signal.2 b/release/man2/signal.2 index 1f6fb0f5..71f52191 100644 --- a/release/man2/signal.2 +++ b/release/man2/signal.2 @@ -38,7 +38,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGNAL 2 2013\-02\-09 Linux "Linux Programmer's Manual" +.TH SIGNAL 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 signal \- ANSI C シグナル操作 .SH 書式 @@ -69,7 +69,8 @@ signal \- ANSI C シグナル操作 .PP シグナル \fBSIGKILL\fP と \fBSIGSTOP\fP は捕捉できず、無視することもできない。 .SH 返り値 -\fBsignal\fP() は、今までのシグナル・ハンドラの値を返す。エラーの場合は \fBSIG_ERR\fP を返す。 +\fBsignal\fP() returns the previous value of the signal handler, or \fBSIG_ERR\fP +on error. In the event of an error, \fIerrno\fP is set to indicate the cause. .SH エラー .TP \fBEINVAL\fP @@ -119,14 +120,10 @@ System V でも、 \fBsignal\fP() に対してこれらの挙動を規定して 来るより前に、同じシグナルがまた配送される可能性がある。 さらに、同じシグナルが立て続けに配送されると、同じシグナルが ハンドラを繰り返し起動されることになる。 -BSD improved on this situation, but unfortunately also changed the semantics -of the existing \fBsignal\fP() interface while doing so. On BSD, when a -signal handler is invoked, the signal disposition is not reset, and further -instances of the signal are blocked from being delivered while the handler -is executing. Furthermore, certain blocking system calls are automatically -restarted if interrupted by a signal handler (see \fBsignal\fP(7)). The BSD -semantics are equivalent to calling \fBsigaction\fP(2) with the following -flags: +BSD はこの状況が改善したが、残念なことに、その過程で既存の \fBsignal\fP() の挙動も変更された。 BSD +では、シグナルハンドラが起動された際、 シグナルの処理方法はリセットされず、 ハンドラの実行中は、同じシグナルのさらなる生成は配送がブロックされる。 +また、 シグナルハンドラが中断された場合、 停止中のシステムコールのいくつかは自動的に再スタートされる。 BSD の挙動は、 以下のフラグを指定した +\fBsigaction\fP(2) の呼び出しと等価である。 sa.sa_flags = SA_RESTART; @@ -159,6 +156,6 @@ Linux の libc4 と libc5 の \fBsignal\fP() 関数は System V 方式である \fBsigqueue\fP(3), \fBsigsetops\fP(3), \fBsigvec\fP(3), \fBsysv_signal\fP(3), \fBsignal\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/man2/signalfd.2 b/release/man2/signalfd.2 index 569fef7c..24a3a883 100644 --- a/release/man2/signalfd.2 +++ b/release/man2/signalfd.2 @@ -263,6 +263,6 @@ main(int argc, char *argv[]) \fBsigprocmask\fP(2), \fBsigwaitinfo\fP(2), \fBtimerfd_create\fP(2), \fBsigsetops\fP(3), \fBsigwait\fP(3), \fBepoll\fP(7), \fBsignal\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/man2/sigpending.2 b/release/man2/sigpending.2 index c0541a6e..07286aa3 100644 --- a/release/man2/sigpending.2 +++ b/release/man2/sigpending.2 @@ -31,7 +31,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGPENDING 2 2008\-10\-04 Linux "Linux Programmer's Manual" +.TH SIGPENDING 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 sigpending \- 処理待ちのシグナルの検査 .SH 書式 @@ -52,7 +52,8 @@ _POSIX_SOURCE \fBsigpending\fP() は、呼び出し元のスレッドへの配送を待っている (pending) シグナル集合 (すなわち、禁止中に発生したシグナル) を返す。 処理待ちのシグナルのマスクが \fIset\fP に格納される。 .SH 返り値 -\fBsigpending\fP() は成功すれば 0 を返し、エラーならば \-1 を返す。 +\fBsigpending\fP() returns 0 on success and \-1 on error. In the event of an +error, \fIerrno\fP is set to indicate the cause. .SH エラー .TP \fBEFAULT\fP @@ -74,6 +75,6 @@ POSIX.1\-2001. \fBkill\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2), \fBsigsuspend\fP(2), \fBsigsetops\fP(3), \fBsignal\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/man2/sigprocmask.2 b/release/man2/sigprocmask.2 index decc29a2..36c5814a 100644 --- a/release/man2/sigprocmask.2 +++ b/release/man2/sigprocmask.2 @@ -31,7 +31,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGPROCMASK 2 2012\-04\-15 Linux "Linux Programmer's Manual" +.TH SIGPROCMASK 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 sigprocmask \- 禁止するシグナルの確認と変更 .SH 書式 @@ -71,7 +71,8 @@ _POSIX_SOURCE マルチスレッドのプロセスで \fBsigprocmask\fP() を使用した場合の動作は規定されていない。 \fBpthread_sigmask\fP(3) を参照のこと。 .SH 返り値 -\fBsigprocmask\fP() は成功すれば 0 を返し、エラーならば \-1 を返す。 +\fBsigprocmask\fP() returns 0 on success and \-1 on error. In the event of an +error, \fIerrno\fP is set to indicate the cause. .SH エラー .TP \fBEFAULT\fP @@ -99,6 +100,6 @@ POSIX.1\-2001. \fBsigsuspend\fP(2), \fBpthread_sigmask\fP(3), \fBsigqueue\fP(3), \fBsigsetops\fP(3), \fBsignal\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/man2/sigreturn.2 b/release/man2/sigreturn.2 index b1cb0fcf..4460dd92 100644 --- a/release/man2/sigreturn.2 +++ b/release/man2/sigreturn.2 @@ -58,6 +58,6 @@ Linux カーネルは、 シグナル・ハンドラ用にスタック・フレ .SH 関連項目 \fBkill\fP(2), \fBsigaltstack\fP(2), \fBsignal\fP(2), \fBsignal\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/man2/sigsuspend.2 b/release/man2/sigsuspend.2 index a021dbec..bd9869b8 100644 --- a/release/man2/sigsuspend.2 +++ b/release/man2/sigsuspend.2 @@ -31,7 +31,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGSUSPEND 2 2008\-08\-29 Linux "Linux Programmer's Manual" +.TH SIGSUSPEND 2 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 sigsuspend \- シグナルを待つ .SH 書式 @@ -58,7 +58,8 @@ _POSIX_SOURCE \fBSIGKILL\fP と \fBSIGSTOP\fP を禁止 (block) することはできない; これらのシグナルを \fImask\fP に指定しても、プロセスのシグナルマスクは影響を受けない。 .SH 返り値 -\fBsigsuspend\fP() は常に \-1 を返し、通常は \fBEINTR\fP エラーが発生する。 +\fBsigsuspend\fP() always returns \-1, with \fIerrno\fP set to inndicate the error +(normally, \fBEINTR\fP). .SH エラー .TP \fBEFAULT\fP @@ -81,6 +82,6 @@ POSIX.1\-2001. \fBkill\fP(2), \fBpause\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2), \fBsigwaitinfo\fP(2), \fBsigsetops\fP(3), \fBsigwait\fP(3), \fBsignal\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/man2/sigwaitinfo.2 b/release/man2/sigwaitinfo.2 index 37cbe60b..65c92a40 100644 --- a/release/man2/sigwaitinfo.2 +++ b/release/man2/sigwaitinfo.2 @@ -54,9 +54,8 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 NULL でない場合、配送されたシグナルの情報が入った \fIsiginfo_t\fP 型 (\fBsigaction\fP(2) を参照) の構造体を \fIinfo\fP が指すバッファに入れて返す。 .PP -If multiple signals in \fIset\fP are pending for the caller, the signal that is -retrieved by \fBsigwaitinfo\fP() is determined according to the usual ordering -rules; see \fBsignal\fP(7) for further details. +呼び出し元に対して \fIset\fP の複数のシグナルが処理待ちの場合、 \fBsigwaitinfo\fP() +で取得するシグナルは通常の順序決定ルールに基づいて決定される。 詳細は \fBsignal\fP(7) を参照のこと。 .PP \fBsigtimedwait\fP() は、 \fBsigwaitinfo\fP() と次の点を除いて全く同じように 動作する。この関数にはもう 1 つの引き数 \fItimeout\fP があり、シグナル待ち @@ -116,6 +115,6 @@ Linux では、 \fBsigwaitinfo\fP() は \fBsigtimedwait\fP() を用いて実 \fBsigprocmask\fP(2), \fBsigqueue\fP(3), \fBsigsetops\fP(3), \fBsigwait\fP(3), \fBsignal\fP(7), \fBtime\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/man2/socket.2 b/release/man2/socket.2 index 6c22d59e..ea6590b8 100644 --- a/release/man2/socket.2 +++ b/release/man2/socket.2 @@ -125,7 +125,7 @@ T} 帯域外(out\-of\-band)データ転送メカニズムもサポートされる。 .TP \fBSOCK_DGRAM\fP -データグラム(接続、信頼性無し、固定最大長メッセージ) をサポートする。 +データグラム (コネクションレス、信頼性無し、固定最大長メッセージ) をサポートする。 .TP \fBSOCK_SEQPACKET\fP 固定最大長のデータグラム転送パスに基づいた順序性、信頼性のある 双方向の接続に基づいた通信を提供する。受け取り側ではそれぞれの入力 @@ -256,6 +256,6 @@ POSIX.1\-2001 では \fI\fP のインクルードは必須とされ \(lqBSD Interprocess Communication Tutorial\(rq, (\fIUNIX Programmer's Supplementary Documents Volume 1.\fP として再版された) .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/man2/socketcall.2 b/release/man2/socketcall.2 index 4a9a233c..31e0209b 100644 --- a/release/man2/socketcall.2 +++ b/release/man2/socketcall.2 @@ -50,6 +50,6 @@ socketcall \- ソケット・システムコール \fBrecvfrom\fP(2), \fBrecvmsg\fP(2), \fBsend\fP(2), \fBsendmsg\fP(2), \fBsendto\fP(2), \fBsetsockopt\fP(2), \fBshutdown\fP(2), \fBsocket\fP(2), \fBsocketpair\fP(2) .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/man2/socketpair.2 b/release/man2/socketpair.2 index e9eb745f..67af5754 100644 --- a/release/man2/socketpair.2 +++ b/release/man2/socketpair.2 @@ -98,6 +98,6 @@ POSIX.1\-2001 では \fI\fP のインクルードは必須とされ .SH 関連項目 \fBpipe\fP(2), \fBread\fP(2), \fBsocket\fP(2), \fBwrite\fP(2), \fBsocket\fP(7), \fBunix\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/man2/splice.2 b/release/man2/splice.2 index 204d9fba..aa994615 100644 --- a/release/man2/splice.2 +++ b/release/man2/splice.2 @@ -143,6 +143,6 @@ splice \- パイプとの間でデータを継ぎ合わせる .SH 関連項目 \fBsendfile\fP(2), \fBtee\fP(2), \fBvmsplice\fP(2) .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/man2/spu_create.2 b/release/man2/spu_create.2 index 9ee75735..455fe085 100644 --- a/release/man2/spu_create.2 +++ b/release/man2/spu_create.2 @@ -190,6 +190,6 @@ See \fBspu_run\fP(2) for an example of the use of \fBspu_create\fP() .SH 関連項目 \fBclose\fP(2), \fBspu_run\fP(2), \fBcapabilities\fP(7), \fBspufs\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/man2/spu_run.2 b/release/man2/spu_run.2 index e79f1525..88c22c64 100644 --- a/release/man2/spu_run.2 +++ b/release/man2/spu_run.2 @@ -191,6 +191,6 @@ int main(void) .SH 関連項目 \fBclose\fP(2), \fBspu_create\fP(2), \fBcapabilities\fP(7), \fBspufs\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/man2/stat.2 b/release/man2/stat.2 index 90d7b2f1..9bc11dcc 100644 --- a/release/man2/stat.2 +++ b/release/man2/stat.2 @@ -459,6 +459,6 @@ main(int argc, char *argv[]) \fBaccess\fP(2), \fBchmod\fP(2), \fBchown\fP(2), \fBfstatat\fP(2), \fBreadlink\fP(2), \fButime\fP(2), \fBcapabilities\fP(7), \fBsymlink\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/man2/statfs.2 b/release/man2/statfs.2 index bc1f0bc5..6c0f3a57 100644 --- a/release/man2/statfs.2 +++ b/release/man2/statfs.2 @@ -196,6 +196,6 @@ statfs\fP を返す (\fI\fP で定義されている)。 この構造 .SH 関連項目 \fBstat\fP(2), \fBstatvfs\fP(2), \fBpath_resolution\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/man2/stime.2 b/release/man2/stime.2 index 85f51fd9..cb13fba7 100644 --- a/release/man2/stime.2 +++ b/release/man2/stime.2 @@ -63,6 +63,6 @@ SVr4. .SH 関連項目 \fBdate\fP(1), \fBsettimeofday\fP(2), \fBcapabilities\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/man2/swapon.2 b/release/man2/swapon.2 index 54fe274b..c6cce054 100644 --- a/release/man2/swapon.2 +++ b/release/man2/swapon.2 @@ -128,6 +128,6 @@ path のファイルが有効なスワップの署名 (signature) を 含んで .SH 関連項目 \fBmkswap\fP(8), \fBswapoff\fP(8), \fBswapon\fP(8) .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/man2/symlink.2 b/release/man2/symlink.2 index 4997097b..15830511 100644 --- a/release/man2/symlink.2 +++ b/release/man2/symlink.2 @@ -78,9 +78,8 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND に含まれているディレクトリのどれかに検索許可が与えられていない (\fBpath_resolution\fP(7) も参照すること)。 .TP \fBEDQUOT\fP -The user's quota of resources on the file system has been exhausted. The -resources could be inodes or disk blocks, depending on the file system -implementation. +そのファイルシステムのリソース使用量がユーザクォータに達している。対象となるリソースは inode +かディスクブロックで、どちらになるかはファイルシステムの実装依存である。 .TP \fBEEXIST\fP \fInewpath\fP が既に存在する。 @@ -130,6 +129,6 @@ symlink によって参照される名前を削除すると (それが他にハ \fBrename\fP(2), \fBsymlinkat\fP(2), \fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/symlinkat.2 b/release/man2/symlinkat.2 index 22c6082b..93865187 100644 --- a/release/man2/symlinkat.2 +++ b/release/man2/symlinkat.2 @@ -88,6 +88,6 @@ POSIX.1\-2008. .SH 関連項目 \fBopenat\fP(2), \fBsymlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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/man2/sync.2 b/release/man2/sync.2 index 04840ec1..66cac228 100644 --- a/release/man2/sync.2 +++ b/release/man2/sync.2 @@ -104,6 +104,6 @@ libc4, libc5 と、2.2.1 までの glibc ではプロトタイプは "int sync(v .SH 関連項目 \fBbdflush\fP(2), \fBfdatasync\fP(2), \fBfsync\fP(2), \fBsync\fP(8), \fBupdate\fP(8) .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/man2/sync_file_range.2 b/release/man2/sync_file_range.2 index 0ffbf578..4d9cc905 100644 --- a/release/man2/sync_file_range.2 +++ b/release/man2/sync_file_range.2 @@ -125,12 +125,10 @@ I/O エラー。 このシステムコールは Linux 独自であり、 移植性が必要なプログラムでは使用を避けるべきである。 .SH 注意 .\" See kernel commit edd5cd4a9424f22b0fa08bef5e299d41befd5622 -Some architectures (e.g., PowerPC, ARM) need 64\-bit arguments to be aligned -in a suitable pair of registers. On such architectures, the call signature -of \fBsync_file_range\fP() shown in the SYNOPSIS would force a register to be -wasted as padding between the \fIfd\fP and \fIoffset\fP arguments. (See -\fBsyscall\fP(2) for details.) Therefore, these architectures define a -different system call that orders the arguments suitably: +いくつかのアーキテクチャ (例えば、 PowerPC や ARM) では、 64 ビットの引き数は適切なレジスタの組に割り当てる必要がある。 +このようなアーキテクチャでは、 「書式」に書かれている \fBsync_file_range\fP() の呼び出しシグネチャーで、 引き数 \fIfd\fP と +\fIoffset\fP の間のパディング (詰めもの) でレジスタが一つ消費されてしまう (詳細は \fBsyscall\fP(2) 参照)。 そのため、 +これらのアーキテクチャでは引き数が適切な順序になった別のシステムコールが定義されている。 .PP .in +4n .nf @@ -153,6 +151,6 @@ glibc のラッパー関数は \fBsync_file_range\fP() という名前で .SH 関連項目 \fBfdatasync\fP(2), \fBfsync\fP(2), \fBmsync\fP(2), \fBsync\fP(2) .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/man2/syscall.2 b/release/man2/syscall.2 index 571a2905..050f9217 100644 --- a/release/man2/syscall.2 +++ b/release/man2/syscall.2 @@ -42,7 +42,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SYSCALL 2 2013\-04\-07 Linux "Linux Programmer's Manual" +.TH SYSCALL 2 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 syscall \- 間接システムコール .SH 書式 @@ -69,13 +69,11 @@ syscall \- 間接システムコール .SH 注意 \fBsyscall\fP() は 4BSD で最初に登場した。 .SS アーキテクチャ固有の要件 -Each architecture ABI has its own requirements on how system call arguments -are passed to the kernel. For system calls that have a glibc wrapper (e.g., -most system calls), glibc handles the details of copying arguments to the -right registers in a manner suitable for the architecture. However, when -using \fBsyscall\fP() to make a system call, the caller might need to handle -architecture\-dependent details; this requirement is most commonly -encountered on certain 32\-bit architectures. +各アーキテクチャの ABI には、 システムコールの引き数のカーネルへの渡し方に関する独自の要件がある。 +(ほとんどのシステムコールのように) glibc ラッパー関数があるシステムコールでは、 glibc +が詳細を処理し、アーキテクチャに応じた方法で引き数が適切なレジスタにコピーされる。 しかし、 システムコールを呼び出すのに \fBsyscall\fP() +を使う場合には、 呼び出し側でアーキテクチャ依存の詳細を処理しなければならない場合がある。 これはいくつかの 32 +ビットアーキテクチャでは非常によくあることだ。 例えば、ARM アーキテクチャの Embedded ABI (EABI) では、 (\fIlong long\fP などの) 64 ビット値は偶数番地のレジスタのペアに境界があっていなければならない。したがって、 glibc が提供するラッパー関数ではなく \fBsyscall\fP() @@ -101,15 +99,13 @@ syscall(SYS_readahead, fd, 0, 次のシステムコールに影響がある: \fBfadvise64_64\fP(2), \fBftruncate64\fP(2), \fBposix_fadvise\fP(2), \fBpread64\fP(2), \fBpwrite64\fP(2), \fBreadahead\fP(2), \fBsync_file_range\fP(2), \fBtruncate64\fP(2) -.SS "Architecture calling conventions" -Every architecture has its own way of invoking and passing arguments to the -kernel. The details for various architectures are listed in the two tables -below. +.SS アーキテクチャ毎の呼び出し規約 +各アーキテクチャには、それぞれ独自のシステムコール起動方法とカーネルへの引き数の渡し方がある。 各種のアーキテクチャの詳細を以下の 2 +つの表にまとめる。 -The first table lists the instruction used to transition to kernel mode, -(which might not be the fastest or best way to transition to the kernel, so -you might have to refer to the VDSO), the register used to indicate the -system call number, and the register used to return the system call result. +最初の表は、 カーネルモードに遷移するのに使用される命令、 システムコール番号を示すのに使用されるレジスタ、 +システムコールの結果を返すのに使用されるレジスタの一覧である (なお、 ここに載っているカーネルモードに遷移するのに使用される命令は、 +カーネルモードに遷移する最速や最善の方法でない場合もあるので、 VDSO を参照する必要があるかもしれない)。 .if t \{\ .ft CW \} @@ -123,8 +119,10 @@ blackfin excpt 0x0 P0 R0 i386 int $0x80 eax eax ia64 break 0x100000 r15 r10/r8 parisc ble 0x100(%sr2, %r0) r20 r28 +s390 svc 0 r1 r2 NR may be passed directly with +s390x svc 0 r1 r2 "svc NR" if NR is less than 256 sparc/32 t 0x10 g1 o0 -sparc/64 t 0x6d g1 o0 +sparc/64 t 0x6d g1 o0 x86_64 syscall rax rax .TE .if t \{\ @@ -132,7 +130,7 @@ x86_64 syscall rax rax .ft P \} .PP -The second table shows the registers used to pass the system call arguments. +2 つ目の表は、システムコールの引き数を渡すのに使用されるレジスタの一覧である。 .if t \{\ .ft CW \} @@ -146,6 +144,8 @@ blackfin R0 R1 R2 R3 R4 R5 \- i386 ebx ecx edx esi edi ebp \- ia64 r11 r9 r10 r14 r15 r13 \- parisc r26 r25 r24 r23 r22 r21 \- +s390 r2 r3 r4 r5 r6 r7 \- +s390x r2 r3 r4 r5 r6 r7 \- sparc/32 o0 o1 o2 o3 o4 o5 \- sparc/64 o0 o1 o2 o3 o4 o5 \- x86_64 rdi rsi rdx r10 r8 r9 \- @@ -155,8 +155,8 @@ x86_64 rdi rsi rdx r10 r8 r9 \- .ft P \} .PP -Note that these tables don't cover the entire calling convention\(emsome -architectures may indiscriminately clobber other registers not listed here. +これらの表にはすべての呼び出し規約が記載されているわけではない点に注意すること \(em +アーキテクチャによっては、ここに記載されていない他のレジスタが見境なく上書きされる場合もある。 .SH 例 .nf #define _GNU_SOURCE @@ -176,6 +176,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fB_syscall\fP(2), \fBintro\fP(2), \fBsyscalls\fP(2) .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/man2/syscalls.2 b/release/man2/syscalls.2 index 41c357c9..a06b317f 100644 --- a/release/man2/syscalls.2 +++ b/release/man2/syscalls.2 @@ -679,6 +679,6 @@ Linux 2.4 では、32 ビット・アーキテクチャ上のアプリケーシ .SH 関連項目 \fBsyscall\fP(2), \fBunimplemented\fP(2), \fBlibc\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/man2/sysctl.2 b/release/man2/sysctl.2 index 64103e29..0578fe2a 100644 --- a/release/man2/sysctl.2 +++ b/release/man2/sysctl.2 @@ -142,6 +142,6 @@ main(void) .SH 関連項目 \fBproc\fP(5) .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/man2/sysfs.2 b/release/man2/sysfs.2 index bccb1d70..f57a8308 100644 --- a/release/man2/sysfs.2 +++ b/release/man2/sysfs.2 @@ -73,6 +73,6 @@ SVr4. .SH バグ libc または glibc のサポートは存在しない。 \fIbuf\fP の大きさがどれだけ必要かを推測する方法がない。 .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/man2/sysinfo.2 b/release/man2/sysinfo.2 index ce18594c..7c12cf39 100644 --- a/release/man2/sysinfo.2 +++ b/release/man2/sysinfo.2 @@ -84,6 +84,6 @@ Linux カーネルは 0.98.pl6 から \fBsysinfo\fP() システムコールを .SH 関連項目 \fBproc\fP(5) .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/man2/syslog.2 b/release/man2/syslog.2 index 009e31bc..3f7441c1 100644 --- a/release/man2/syslog.2 +++ b/release/man2/syslog.2 @@ -1,5 +1,6 @@ .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl) .\" +.\" %%%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. @@ -19,6 +20,7 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .\" Written 11 June 1995 by Andries Brouwer .\" 2008-02-15, Jeremy Kerr @@ -31,7 +33,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SYSLOG 2 2012\-05\-05 Linux "Linux Programmer's Manual" +.TH SYSLOG 2 2012\-11\-29 Linux "Linux Programmer's Manual" .SH 名前 syslog, klogctl \- カーネルのメッセージ・リング・バッファを読んだり消去したりする; console_loglevel の設定を行う .SH 書式 @@ -50,75 +52,83 @@ syslog, klogctl \- カーネルのメッセージ・リング・バッファを \fBsyslog\fP(3) を見ること。この名前のシステム・コールはカーネルの \fIprintk\fP() バッファを制御するものであり、glibc ラッパー関数は \fBklogctl\fP() と呼ばれている。 - -\fItype\fP 引き数はこの関数の動作を決定する。以下を指定できる。 - -.nf - 0 \-\- ログを閉じる。現在の実装では何もしない (NOP) 。 - 1 \-\- ログを開く。現在の実装では何もしない (NOP) 。 - 2 \-\- ログから読み出す。 - 3 \-\- リング・バッファに残っているメッセージをすべて読み出す。 - 4 \-\- リング・バッファに残っているメッセージをすべて読み出し、消去する。 - 5 \-\- リングバッファを消去する。 - 6 \-\- コンソールへの printk を無効にする。 - 7 \-\- コンソールへの printk を有効にする。 - 8 \-\- コンソールに表示されるメッセージのレベルを設定する。 - 9 \-\- ログバッファの未読の文字数を返す。 - 10 \-\- ログバッファのサイズを返す。 -.fi - -type 9 は Linux 2.4.10 で追加された。 -type 10 は Linux 2.6.6 で追加された。 - -バージョン 2.6.37 より前の Linux カーネルでは、 -コマンド種別 3 と 10 だけが非特権プロセスに対して許可されている。 -Linux 2.6.37 以降では、\fI/proc/sys/kernel/dmesg_restrict\fP が値 0 の場合に -コマンド種別 3 と 10 だけが非特権プロセスに対して許可される。 -Linux 2.6.37 より前では、「特権を持つ (privileged)」とは呼び出し者が -\fBCAP_SYS_ADMIN\fP ケーパビリティを持つことを意味する。 -Linux 2.6.37 以降では、「特権を持つ」とは呼び出し者が -\fBCAP_SYS_ADMIN\fP ケーパビリティか -(新しい) \fBCAP_SYSLOG\fP ケーパビリティのいずれかを持つことを意味する -(この目的で \fBCAP_SYS_ADMIN\fP ケーパビリティを使うのは今は非推奨である)。 .SS "カーネル・ログ・バッファ (kernel log buffer)" .\" Under "General setup" ==> "Kernel log buffer size" .\" For 2.6, precisely the option seems to have appeared in 2.5.55. カーネルは長さ \fBLOG_BUF_LEN\fP の巡回式のバッファを持っており、 それにはカーネル関数の \fBprintk\fP() の引き数として与えられた メッセージが (そのログレベルにかかわらず) 格納される。 初期のカーネルでは \fBLOG_BUF_LEN\fP の値は 4096 であった。 カーネル 1.3.54 からは 8192、 カーネル 2.1.113 からは 16384 になり、 カーネル 2.4.23 以降および -2.6 以降ではカーネルのコンパイル時に 値を設定できるようになっている。 最近のカーネルでは、コマンド 10 でバッファのサイズを問い合わせできる。 - -\fIsyslog(2,buf,len)\fP の呼び出しはカーネル・ログ・バッファが空でなくなるまで待って、 最大 \fIlen\fP バイトまで \fIbuf\fP -へと読み出し、読み込んだ バイト数を返す。ログから読まれたバイトはログ・バッファから消える: 情報は一度しか読むことができない。 +2.6 以降ではカーネル設定オプション (\fBCONFIG_LOG_BUF_SHIFT\fP) +で値を設定できるようになっている。最近のカーネルでは、コマンド 10 (下記参照) でバッファのサイズを問い合わせできる。 +.SS コマンド +\fItype\fP 引き数はこの関数が行う動作を決定する。 以下のリストに示す値を \fItype\fP に指定できる。 +シンボル名はカーネルソースで定義されているが、ユーザ空間には公開されていない。 したがって、数字を使うか、名前を自分で定義する必要がある。 +.TP +\fBSYSLOG_ACTION_CLOSE\fP (0) +ログをクローズする。現在のところ NOP である。 +.TP +\fBSYSLOG_ACTION_OPEN\fP (1) +ログをオープンする。現在のところ NOP である。 +.TP +\fBSYSLOG_ACTION_READ\fP (2) +ログを読み出す。 この呼び出しは、 カーネル・ログ・バッファが空でなくなるまで待って、 最大 \fIlen\fP バイトまで \fIbufp\fP +が指すバッファに読み込み、 読み込んだバイト数を返す。 ログから読まれたバイトはログ・バッファから消える。 つまり、情報は一度しか読むことができない。 これはユーザーのプログラムが \fI/proc/kmsg\fP を読んだ時にカーネルによって実行される関数でもある。 - -\fIsyslog(3,buf,len)\fP の呼び出しはログ・バッファの最後の \fIlen\fP バイトを -(非破壊的に)読み出す、しかし、直近の「リング・バッファ消去」命令 (この命令はバッファを消去するわけではない) +.TP +\fBSYSLOG_ACTION_READ_ALL\fP (3) +リング・バッファに残っているメッセージをすべて読み出し、 \fIbufp\fP が指すバッファに格納する。 この呼び出しログ・バッファの最後の \fIlen\fP +バイトを (非破壊的に) 読み出すが、 最後の「リング・バッファ消去」命令 (下記のコマンド 5 参照) 以降にバッファに書き込まれた情報しか読み出せない。 返り値は読み込んだバイト数である。 - -\fIsyslog(4,buf,len)\fP 呼び出しは「リング・バッファ消去」命令も実行する以外は 機能 3 と完全に同じである。 - -\fIsyslog(5,dummy,dummy)\fP 呼び出しは「リング・バッファ消去」命令のみを実行する (呼び出しの書式で、 \fIbuf\fP や -\fIlen\fP が "dummy" と記載されている場合、その引き数の値が無視されることを表す)。 - -\fIsyslog(6,dummy,dummy)\fP 呼び出しはコンソールのログレベルを最小に設定し、 コンソールにメッセージが表示されないようにする。 - -\fIsyslog(7,dummy,dummy)\fP 呼び出しはコンソールのログレベルをデフォルトに設定し、 コンソールにメッセージが表示されるようにする。 - -\fIsyslog(8,dummy,level)\fP 呼び出しはコンソールのログレベルを \fIlevel\fP に設定する。 \fIlevel\fP は 1 以上 8 -以下の整数でなければならない。 詳細は \fBログレベル (loglevel)\fP の節を参照のこと。 - -\fIsyslog(9,dummy,dummy)\fP 呼び出しはカーネル・ログバッファにある現在読み出し可能なバイト数を返す。 - -\fIsyslog(10,dummy,dummy)\fP 呼び出しはカーネル・ログバッファの総量を返す。 +.TP +\fBSYSLOG_ACTION_READ_CLEAR\fP (4) +リング・バッファに残っているメッセージをすべて読み出し、クリアする。 この呼び出しは \fItype\fP 3 +と全く同じことを行い、追加で「リング・バッファ消去」 ("clear ring buffer") コマンドも実行する。 +.TP +\fBSYSLOG_ACTION_CLEAR\fP (5) +「リング・バッファ消去」 (\"clear ring buffer\") コマンドのみを実行する。 引き数 \fIbufp\fP と \fIlen\fP +は無視される。 +.IP +このコマンドは実際にリング・バッファをクリアするわけではなく、 コマンド 3 (\fBSYSLOG_ACTION_READ_ALL\fP) と 4 +(\fBSYSLOG_ACTION_READ_CLEAR\fP で返す内容を決定するカーネルの管理変数を設定する。 このコマンドはコマンド 2 +(\fBSYSLOG_ACTION_READ\fP) と 9 (\fBSYSLOG_ACTION_SIZE_UNREAD\fP) には影響を与えない。 +.TP +\fBSYSLOG_ACTION_CONSOLE_OFF\fP (6) +printk のコンソールへの出力を無効にする。 コンソールのログレベルを最小に設定し、 コンソールにメッセージが出力されないようにする。 引き数 +\fIbufp\fP と \fIlen\fP は無視される。 +.TP +\fBSYSLOG_ACTION_CONSOLE_ON\fP (7) +コンソールのログレベルをデフォルトに設定し、 コンソールにメッセージが表示されるようにする。 引き数 \fIbufp\fP と \fIlen\fP は無視される。 +.TP +\fBSYSLOG_ACTION_CONSOLE_LEVEL\fP (8) +コンソールのログレベルを \fIlen\fP で指定された値に設定する。 \fIlen\fP は 1 以上 8 以下の整数でなければならない。 詳細は +\fBログレベル (loglevel)\fP の節を参照のこと。 引き数 \fIbufp\fP は無視される。 +.TP +\fBSYSLOG_ACTION_SIZE_UNREAD\fP (9) (Linux 2.4.10 以降) +コマンド 2 (\fBSYSLOG_ACTION_READ\fP) でカーネル・ログ・バッファから読み出せるバイト数を返す。 引き数 \fIbufp\fP と +\fIlen\fP は無視される。 +.TP +\fBSYSLOG_ACTION_SIZE_BUFFER\fP (10) (Linux 2.6.6 以降) +カーネル・ログ・バッファの全体のサイズを返す。 引き数 \fIbufp\fP と \fIlen\fP は無視される。 +.PP +コマンド種別 3 と 10 以外のコマンドは全て特権が必要である。 +バージョン 2.6.37 より前の Linux カーネルでは、 +コマンド種別 3 と 10 は非特権プロセスも呼び出すことができる。 +Linux 2.6.37 以降では、\fI/proc/sys/kernel/dmesg_restrict\fP が値 0 の場合に限り、 +非特権プロセスはこれらのコマンドを呼び出すことができる。 +Linux 2.6.37 より前では、「特権を持つ (privileged)」とは呼び出し者が +\fBCAP_SYS_ADMIN\fP ケーパビリティを持つことを意味する。 +Linux 2.6.37 以降では、「特権を持つ」とは呼び出し者が +\fBCAP_SYS_ADMIN\fP ケーパビリティか +(新しい) \fBCAP_SYSLOG\fP ケーパビリティのいずれかを持つことを意味する +(この目的で \fBCAP_SYS_ADMIN\fP ケーパビリティを使うのは今は非推奨である)。 .SS "ログレベル (loglevel)" カーネル・ルーチンの \fBprintk\fP() は、ログレベルが \fIconsole_loglevel\fP 変数より小さいときにのみ、コンソールにメッセージを表示する。 \fIconsole_loglevel\fP は最初 \fBDEFAULT_CONSOLE_LOGLEVEL\fP (7) に設定されるが、起動時にカーネルの コマンド・ライン・オプションに "debug" という単語が含まれている場合は 10 に設定され、カーネル・フォールトが発生した場合には 15 に設定される (但し、10 や 15 -という数字に意味はなく、8 と同等である)。 この変数は \fIsyslog(8,dummy,value)\fP. 呼び出しによって設定され、値の範囲は -1\-8 である。 \fIsyslog(type,dummy,dummy)\fP 呼び出しで \fItype\fP が 6 もしくは 7 の場合、 -console_loglevel は 1 (カーネル・パニックのみ)、 7 (デバッグ・メッセージ以外の全て) にそれぞれ設定される。 +という数字に意味はなく、8 と同等である)。 この変数は \fItype\fP が 8 の \fBsyslog\fP() の呼び出しによって設定され、値の範囲は +1\-8 である。 \fItype\fP が 6 もしくは 7 の \fBsyslog\fP() の呼び出しの場合、 console_loglevel は 1 +(カーネル・パニックのみ)、 7 (デバッグ・メッセージ以外の全て) にそれぞれ設定される。 メッセージの各行はそれぞれにログレベルを持つ。このログレベルは \fIDEFAULT_MESSAGE_LOGLEVEL \- 1\fP (6) であるが、 (\fId\fP は 1\-7 の範囲の数字) で始まる行の ログレベルは \fId\fP である。 ログレベルの慣習的な意味は @@ -136,8 +146,8 @@ console_loglevel は 1 (カーネル・パニックのみ)、 7 (デバッグ・ .fi .SH 返り値 \fItype\fP が 2, 3, 4 の場合、成功すると \fBsyslog\fP() は読み出したバイト数を返す。 \fItype\fP が 9 の場合、 -カーネル・ログバッファにある現在読み出し可能なバイト数を返す。 \fItype\fP が 10 の場合、 カーネル・ログバッファの総量を返す。 \fItype\fP -がそれ以外の値の場合、成功すると 0 が返される。 +カーネル・ログ・バッファにある現在読み出し可能なバイト数を返す。 \fItype\fP が 10 の場合、 カーネル・ログ・バッファの総量を返す。 +\fItype\fP がそれ以外の値の場合、成功すると 0 が返される。 エラーの場合は、\-1\ が返り、 \fIerrno\fP にエラーを示す値が設定される。 .SH エラー @@ -169,6 +179,6 @@ console_loglevel は 1 (カーネル・パニックのみ)、 7 (デバッグ・ .SH 関連項目 \fBsyslog\fP(3), \fBcapabilities\fP(7) .SH この文書について -この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部 +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man2/tee.2 b/release/man2/tee.2 index 5a1d2d50..4c53678d 100644 --- a/release/man2/tee.2 +++ b/release/man2/tee.2 @@ -151,6 +151,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBsplice\fP(2), \fBvmsplice\fP(2) .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/man2/time.2 b/release/man2/time.2 index dce320e7..c481d5e0 100644 --- a/release/man2/time.2 +++ b/release/man2/time.2 @@ -66,6 +66,6 @@ POSIX.1 では、指定した時刻と紀元との間の秒数を近似する変 .SH 関連項目 \fBdate\fP(1), \fBgettimeofday\fP(2), \fBctime\fP(3), \fBftime\fP(3), \fBtime\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/man2/timerfd_create.2 b/release/man2/timerfd_create.2 index 18c11941..517a9e42 100644 --- a/release/man2/timerfd_create.2 +++ b/release/man2/timerfd_create.2 @@ -372,6 +372,6 @@ main(int argc, char *argv[]) \fBsignalfd\fP(2), \fBtimer_create\fP(2), \fBtimer_gettime\fP(2), \fBtimer_settime\fP(2), \fBepoll\fP(7), \fBtime\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/man2/times.2 b/release/man2/times.2 index a3782512..995bc6d1 100644 --- a/release/man2/times.2 +++ b/release/man2/times.2 @@ -130,6 +130,6 @@ V7 では構造体のメンバに \fIlong\fP 型を使っていた。まだ \fIt \fBtime\fP(1), \fBgetrusage\fP(2), \fBwait\fP(2), \fBclock\fP(3), \fBsysconf\fP(3), \fBtime\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/man2/tkill.2 b/release/man2/tkill.2 index 3c6d2969..e31f6588 100644 --- a/release/man2/tkill.2 +++ b/release/man2/tkill.2 @@ -101,6 +101,6 @@ glibc はこれらのシステムコールに対するラッパー関数を提 .SH 関連項目 \fBclone\fP(2), \fBgettid\fP(2), \fBkill\fP(2), \fBrt_sigqueueinfo\fP(2) .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/man2/truncate.2 b/release/man2/truncate.2 index c8993bd8..21d97fc3 100644 --- a/release/man2/truncate.2 +++ b/release/man2/truncate.2 @@ -196,6 +196,6 @@ glibc 2.12 のヘッダファイルにはバグがあり、 \fBftruncate\fP() .SH 関連項目 \fBopen\fP(2), \fBstat\fP(2), \fBpath_resolution\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/man2/umask.2 b/release/man2/umask.2 index a4ddd2f7..5c829531 100644 --- a/release/man2/umask.2 +++ b/release/man2/umask.2 @@ -84,8 +84,8 @@ umask の設定は、そのプロセスが生成する POSIX IPC オブジェク に設定される許可にも影響を与える。 一方、umask は、そのプロセスが (\fBmsgget\fP(2), \fBsemget\fP(2), \fBshmget\fP(2) を使って) 生成する System V IPC オブジェクトに設定される許可には 影響を与えない。 .SH 関連項目 -\fBchmod\fP(2), \fBmkdir\fP(2), \fBopen\fP(2), \fBstat\fP(2) \fBacl\fP(5) +\fBchmod\fP(2), \fBmkdir\fP(2), \fBopen\fP(2), \fBstat\fP(2), \fBacl\fP(5) .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/man2/umount.2 b/release/man2/umount.2 index 59199722..76a2bc87 100644 --- a/release/man2/umount.2 +++ b/release/man2/umount.2 @@ -117,6 +117,6 @@ Linux 2.1.116 から、 \fBumount2\fP() システムコールが追加された .SH 関連項目 \fBmount\fP(2), \fBpath_resolution\fP(7), \fBmount\fP(8), \fBumount\fP(8) .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/man2/uname.2 b/release/man2/uname.2 index 3974b4d7..e775b50f 100644 --- a/release/man2/uname.2 +++ b/release/man2/uname.2 @@ -102,6 +102,6 @@ utsname の情報は、 \fI/proc/sys/kernel/\fP{\fIostype\fP, \fIhostname\fP, \f .SH 関連項目 \fBuname\fP(1), \fBgetdomainname\fP(2), \fBgethostname\fP(2) .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/man2/unimplemented.2 b/release/man2/unimplemented.2 index 7228c1eb..9d611fb3 100644 --- a/release/man2/unimplemented.2 +++ b/release/man2/unimplemented.2 @@ -50,6 +50,6 @@ stty, tuxcall, ulimit, vserver \- 実装されていないシステムコール .SH 関連項目 \fBsyscalls\fP(2) .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/man2/unlink.2 b/release/man2/unlink.2 index 1a398c40..99b9ab8b 100644 --- a/release/man2/unlink.2 +++ b/release/man2/unlink.2 @@ -120,6 +120,6 @@ NFS プロトコルに内在する問題により、まだ使用中のファイ \fBrmdir\fP(2), \fBunlinkat\fP(2), \fBmkfifo\fP(3), \fBremove\fP(3), \fBpath_resolution\fP(7), \fBsymlink\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/man2/unlinkat.2 b/release/man2/unlinkat.2 index f8fd92d9..39d239e0 100644 --- a/release/man2/unlinkat.2 +++ b/release/man2/unlinkat.2 @@ -100,6 +100,6 @@ POSIX.1\-2008. Solaris には、これと同じようなシステムコール .SH 関連項目 \fBopenat\fP(2), \fBrmdir\fP(2), \fBunlink\fP(2), \fBpath_resolution\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/man2/unshare.2 b/release/man2/unshare.2 index e79fe2f0..757129d5 100644 --- a/release/man2/unshare.2 +++ b/release/man2/unshare.2 @@ -33,7 +33,7 @@ unshare \- プロセス実行コンテキストの一部を分離する .fi .sp .in -4n -Feature Test Macro Requirements for glibc (see \fBfeature_test_macros\fP(7)): +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .sp \fBunshare\fP(): @@ -41,13 +41,13 @@ Feature Test Macro Requirements for glibc (see \fBfeature_test_macros\fP(7)): .RS 4 .PD 0 .TP 4 -Since glibc 2.14: +glibc 2.14 以降: _GNU_SOURCE .TP 4 .\" FIXME See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749 -Before glibc 2.14: +glibc 2.14 より前: _BSD_SOURCE || _SVID_SOURCE - /* _GNU_SOURCE also suffices */ + /* _GNU_SOURCE も定義される */ .PD .RE .ad b @@ -179,6 +179,6 @@ System V セマフォのアンドゥ値を共有せず、呼び出し元プロ Linux カーネルソース内の \fIDocumentation/unshare.txt\fP .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/man2/uselib.2 b/release/man2/uselib.2 index c3277d1c..923af3e2 100644 --- a/release/man2/uselib.2 +++ b/release/man2/uselib.2 @@ -78,6 +78,6 @@ glibc2 は、このシステムコールを使用しない。 \fBar\fP(1), \fBgcc\fP(1), \fBld\fP(1), \fBldd\fP(1), \fBmmap\fP(2), \fBopen\fP(2), \fBdlopen\fP(3), \fBcapabilities\fP(7), \fBld.so\fP(8) .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/man2/ustat.2 b/release/man2/ustat.2 index 16ef590a..b8921004 100644 --- a/release/man2/ustat.2 +++ b/release/man2/ustat.2 @@ -91,6 +91,6 @@ HP\-UX 版の構造体 \fIustat\fP には、その他にフィールド \fIf_blk .SH 関連項目 \fBstat\fP(2), \fBstatfs\fP(2) .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/man2/utime.2 b/release/man2/utime.2 index 056f6ddf..c08023ee 100644 --- a/release/man2/utime.2 +++ b/release/man2/utime.2 @@ -120,6 +120,6 @@ libc4 と libc5 では、 \fButimes\fP() は単に \fButime\fP() のラッパ \fBchattr\fP(1), \fBfutimesat\fP(2), \fBstat\fP(2), \fButimensat\fP(2), \fBfutimens\fP(3), \fBfutimes\fP(3) .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/man2/vfork.2 b/release/man2/vfork.2 index 518346d1..9dcc4573 100644 --- a/release/man2/vfork.2 +++ b/release/man2/vfork.2 @@ -166,6 +166,6 @@ Linux では 2.2.0\-pre6 あたりまでは \fBfork\fP(2) と等価であった .SH 関連項目 \fBclone\fP(2), \fBexecve\fP(2), \fBfork\fP(2), \fBunshare\fP(2), \fBwait\fP(2) .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/man2/vhangup.2 b/release/man2/vhangup.2 index d51a3a69..5b14549f 100644 --- a/release/man2/vhangup.2 +++ b/release/man2/vhangup.2 @@ -60,6 +60,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH 関連項目 \fBcapabilities\fP(7), \fBinit\fP(8) .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/man2/vm86.2 b/release/man2/vm86.2 index 449c520a..c01a28fe 100644 --- a/release/man2/vm86.2 +++ b/release/man2/vm86.2 @@ -57,11 +57,11 @@ VM86 モードはプロテクトモードタスクにおける リアルモー この返り値は、このコールが現在のアーキテクチャで実装されていないことを示す。 .TP \fBEPERM\fP -Saved kernel stack exists. (This is a kernel sanity check; the saved stack -should exist only within vm86 mode itself.) +保存されたカーネルスタックが既に存在している。(これはカーネルが通常の 状態であるかをチェックしている。保存されたスタックは vm86 モードで +しか存在しない。) .SH 準拠 この関数は 32 ビット Intel プロセッサ上の Linux 特有の関数であり、 移植を意図したプログラムでは使用すべきでない。 .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/man2/vmsplice.2 b/release/man2/vmsplice.2 index 0e6fcc84..a95455a9 100644 --- a/release/man2/vmsplice.2 +++ b/release/man2/vmsplice.2 @@ -111,6 +111,6 @@ struct iovec { .SH 関連項目 \fBsplice\fP(2), \fBtee\fP(2) .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/man2/wait.2 b/release/man2/wait.2 index f9e8b977..91645161 100644 --- a/release/man2/wait.2 +++ b/release/man2/wait.2 @@ -292,11 +292,10 @@ Linux 2.4 より前では、スレッドは単に特殊なプロセスであっ .\" since patch-2.4.0-test8 同じスレッドグループの他のスレッドの子プロセスは待たない。 Linux 2.4 より前ではデフォルトであった。 .SH バグ -According to POSIX.1\-2008, an application calling \fBwaitid\fP() must ensure -that \fIinfop\fP points to a \fIsiginfo_t\fP structure (i.e., that it is a -non\-NULL pointer). On Linux, if \fIinfop\fP is NULL, \fBwaitid\fP() succeeds, -and returns the process ID of the waited\-for child. Applications should -avoid relying on this inconsistent, nonstandard, and unnecessary feature. +POSIX.1\-2008 によると、 \fBwaitid\fP() を呼び出すアプリケーションは、 \fIinfop\fP が \fIsiginfo_t\fP +構造体を指していること (つまり \fIinfop\fP が NULL でないポインタであること) を保証しなければならない。 Linux では、 +\fIinfop\fP が NULL の場合、 \fBwaitid\fP() は成功し、wait している子プロセスのプロセス ID を返す。 +アプリケーションは、この食い違った、非標準で、不必要な機能に依存しないようにすべきである。 .SH 例 .\" fork.2 refers to this example program. 以下のプログラムは、 \fBfork\fP(2) と \fBwaitpid\fP() の使用方法の例を示している。 このプログラムでは子プロセスを生成する。 @@ -375,6 +374,6 @@ main(int argc, char *argv[]) \fBsigaction\fP(2), \fBsignal\fP(2), \fBwait4\fP(2), \fBpthread_create\fP(3), \fBcredentials\fP(7), \fBsignal\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/man2/wait4.2 b/release/man2/wait4.2 index 75c767f0..144a7255 100644 --- a/release/man2/wait4.2 +++ b/release/man2/wait4.2 @@ -68,8 +68,7 @@ _BSD_SOURCE .RE .ad .SH 説明 -These functions are obsolete; use \fBwaitpid\fP(2) or \fBwaitid\fP(2) in new -programs. +これらの関数は廃止予定である。 新しいプログラムでは \fBwaitpid\fP(2) や \fBwaitid\fP(2) を使用すること。 システムコール \fBwait3\fP() と \fBwait4\fP() は \fBwaitpid\fP(2) と同様の動作をする。それに加え、子プロセスのリソース使用状況の情報を \fIrusage\fP が指す構造体に入れて返す。 @@ -110,8 +109,8 @@ programs. .SH 準拠 4.3BSD. -SUSv1 included a specification of \fBwait3\fP(); SUSv2 included \fBwait3\fP(), but -marked it LEGACY; SUSv3 removed it. +SUSv1 には \fBwait3\fP() の規定があった。 SUSv2 には \fBwait3\fP() が含まれていたが、「過去の名残 +(LEGACY)」となっていた。 SUSv3 では \fBwait3\fP() は削除された。 .SH 注意 現在では \fI\fP をインクルードする必要はないが、インクルードしておくと 移植性を高めることができる (実際には \fI\fP で \fIrusage\fP 構造体が定義されているが、そのフィールドで使用されている @@ -122,6 +121,6 @@ Linux では、 \fBwait3\fP() はライブラリ関数であり、 \fBwait4\fP( \fBfork\fP(2), \fBgetrusage\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBwait\fP(2), \fBsignal\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/man2/write.2 b/release/man2/write.2 index 94f54b38..8f192912 100644 --- a/release/man2/write.2 +++ b/release/man2/write.2 @@ -89,8 +89,7 @@ POSIX は \fBwrite\fP() が行なわれた後に実行した \fBread\fP(2) が \fIfd\fP が、 \fBconnect\fP(2) を使って通信相手のアドレスが設定されていないデータグラムソケットを 参照している。 .TP \fBEDQUOT\fP -The user's quota of disk blocks on the file system containing the file -referred to by \fIfd\fP has been exhausted. +\fIfd\fP が参照するファイルを含むファイルシステムのディスクブロックのユーザクォータの上限に達している。 .TP \fBEFAULT\fP \fIbuf\fP がアクセス可能なアドレス空間の外にある。 @@ -136,6 +135,6 @@ SVr4 では write が割り込まれると、データが書き込まれる直 \fBclose\fP(2), \fBfcntl\fP(2), \fBfsync\fP(2), \fBioctl\fP(2), \fBlseek\fP(2), \fBopen\fP(2), \fBpwrite\fP(2), \fBread\fP(2), \fBselect\fP(2), \fBwritev\fP(2), \fBfwrite\fP(3) .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/INFINITY.3 b/release/man3/INFINITY.3 index 37402154..b13f4e62 100644 --- a/release/man3/INFINITY.3 +++ b/release/man3/INFINITY.3 @@ -65,6 +65,6 @@ glibc システムではマクロ \fBHUGE_VAL\fP が常に使用可能である .SH 関連項目 \fBfpclassify\fP(3), \fBmath_error\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/MB_CUR_MAX.3 b/release/man3/MB_CUR_MAX.3 index fa0cc911..a7340dfd 100644 --- a/release/man3/MB_CUR_MAX.3 +++ b/release/man3/MB_CUR_MAX.3 @@ -38,6 +38,6 @@ C99, POSIX.1\-2001. \fBMB_LEN_MAX\fP(3), \fBmblen\fP(3), \fBmbstowcs\fP(3), \fBmbtowc\fP(3), \fBwcstombs\fP(3), \fBwctomb\fP(3) .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/MB_LEN_MAX.3 b/release/man3/MB_LEN_MAX.3 index de5fb7b8..4b0ee416 100644 --- a/release/man3/MB_LEN_MAX.3 +++ b/release/man3/MB_LEN_MAX.3 @@ -38,6 +38,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBMB_CUR_MAX\fP(3) .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/__setfpucw.3 b/release/man3/__setfpucw.3 index 7c3d51d9..9ede99e0 100644 --- a/release/man3/__setfpucw.3 +++ b/release/man3/__setfpucw.3 @@ -47,6 +47,6 @@ FPU のコントロールワードへどうしても直接アクセスする必 .br \fI\fP .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/a64l.3 b/release/man3/a64l.3 index def23558..0919ffa0 100644 --- a/release/man3/a64l.3 +++ b/release/man3/a64l.3 @@ -11,7 +11,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH A64L 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH A64L 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 a64l, l64a \- long と base\-64 を変換する .SH 書式 @@ -51,6 +51,11 @@ a\-z は 38\-63 を表す。 .fi .RE よって 123 = 59*64^0 + 1*64^1 = "v/" である。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +\fBl64a\fP() 関数はスレッドセーフではない。 +.LP +\fBa64l\fP() 関数はスレッドセーフである。 .SH 準拠 POSIX.1\-2001. .SH 注意 @@ -65,6 +70,6 @@ POSIX.1\-2001. .\" .BR itoa (3), \fBuuencode\fP(1), \fBstrtoul\fP(3) .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/abort.3 b/release/man3/abort.3 index c68ec777..4d832471 100644 --- a/release/man3/abort.3 +++ b/release/man3/abort.3 @@ -62,6 +62,6 @@ SVr4, POSIX.1\-2001, 4.3BSD, C89, C99. .SH 関連項目 \fBgdb\fP(1), \fBsigaction\fP(2), \fBexit\fP(3), \fBlongjmp\fP(3), \fBraise\fP(3) .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/abs.3 b/release/man3/abs.3 index ce11fe2b..30d5b046 100644 --- a/release/man3/abs.3 +++ b/release/man3/abs.3 @@ -36,7 +36,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ABS 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.TH ABS 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 abs, labs, llabs, imaxabs \- 整数の絶対値を計算する .SH 書式 @@ -71,6 +71,10 @@ or \fIcc\ \-std=c99\fP 関数は、 それぞれの関数の型に応じた引数 \fIj\fP の絶対値を計算する。 .SH 返り値 それぞれの関数の型に応じた整数の引数の絶対値を返す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBabs\fP(), \fBlabs\fP(), \fBllabs\fP(), and \fBimaxabs\fP() functions are +thread\-safe. .SH 準拠 .\" POSIX.1 (1996 edition) requires only the .\" .BR abs () @@ -91,6 +95,6 @@ GCC は \fBabs\fP() と \fBlabs\fP() をビルドイン関数として扱う .SH 関連項目 \fBcabs\fP(3), \fBceil\fP(3), \fBfabs\fP(3), \fBfloor\fP(3), \fBrint\fP(3) .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/acos.3 b/release/man3/acos.3 index ac0b9743..94565dfb 100644 --- a/release/man3/acos.3 +++ b/release/man3/acos.3 @@ -90,6 +90,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 \fBasin\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcacos\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) .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/acosh.3 b/release/man3/acosh.3 index 57c6935e..c5a1eb7b 100644 --- a/release/man3/acosh.3 +++ b/release/man3/acosh.3 @@ -98,6 +98,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBasinh\fP(3), \fBatanh\fP(3), \fBcacosh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3) .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/addseverity.3 b/release/man3/addseverity.3 index 9d20009e..5b9f2353 100644 --- a/release/man3/addseverity.3 +++ b/release/man3/addseverity.3 @@ -46,6 +46,6 @@ System V システムで利用可能である。 .SH 関連項目 \fBfmtmsg\fP(3) .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/adjtime.3 b/release/man3/adjtime.3 index 0d49d75f..2f86c628 100644 --- a/release/man3/adjtime.3 +++ b/release/man3/adjtime.3 @@ -91,6 +91,6 @@ struct timeval { .SH 関連項目 \fBadjtimex\fP(2), \fBgettimeofday\fP(2), \fBtime\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/aio_cancel.3 b/release/man3/aio_cancel.3 index ff5629ee..2f0d2522 100644 --- a/release/man3/aio_cancel.3 +++ b/release/man3/aio_cancel.3 @@ -90,6 +90,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\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/aio_error.3 b/release/man3/aio_error.3 index dbd5bfdf..435b6009 100644 --- a/release/man3/aio_error.3 +++ b/release/man3/aio_error.3 @@ -26,7 +26,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH AIO_ERROR 3 2012\-05\-08 "" "Linux Programmer's Manual" +.TH AIO_ERROR 3 2013\-07\-04 "" "Linux Programmer's Manual" .SH 名前 aio_error \- 非同期 I/O 操作のエラー状態を取得する .SH 書式 @@ -60,6 +60,9 @@ aio_error \- 非同期 I/O 操作のエラー状態を取得する \fBaio_error\fP() は実装されていない。 .SH バージョン \fBaio_error\fP() 関数は glibc 2.1 以降で利用できる。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +\fBaio_error\fP() 関数はスレッドセーフである。 .SH 準拠 POSIX.1\-2001, POSIX.1\-2008. .SH 例 @@ -68,6 +71,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_cancel\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\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/aio_fsync.3 b/release/man3/aio_fsync.3 index ebadbe42..e5ce41a8 100644 --- a/release/man3/aio_fsync.3 +++ b/release/man3/aio_fsync.3 @@ -77,6 +77,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\fP(7), \fBsigevent\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/aio_init.3 b/release/man3/aio_init.3 index e7179a42..e8504961 100644 --- a/release/man3/aio_init.3 +++ b/release/man3/aio_init.3 @@ -95,6 +95,6 @@ The \fBaio_init\fP() 関数は glibc 2.1 以降で利用できる。 .SH 関連項目 \fBaio\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/aio_read.3 b/release/man3/aio_read.3 index a2caa34a..2fa640d2 100644 --- a/release/man3/aio_read.3 +++ b/release/man3/aio_read.3 @@ -103,6 +103,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\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/aio_return.3 b/release/man3/aio_return.3 index f3361a86..a16c8def 100644 --- a/release/man3/aio_return.3 +++ b/release/man3/aio_return.3 @@ -26,7 +26,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH AIO_RETURN 3 2012\-05\-08 "" "Linux Programmer's Manual" +.TH AIO_RETURN 3 2013\-07\-04 "" "Linux Programmer's Manual" .SH 名前 aio_return \- 非同期 I/O 操作の返り値 (return status) を取得する .SH 書式 @@ -57,6 +57,9 @@ aio_return \- 非同期 I/O 操作の返り値 (return status) を取得する \fBaio_return\fP() は実装されていない。 .SH バージョン The \fBaio_return\fP() 関数は glibc 2.1 以降で利用できる。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBaio_return\fP() 関数はスレッドセーフである。 .SH 準拠 POSIX.1\-2001, POSIX.1\-2008. .SH 例 @@ -65,6 +68,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\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/aio_suspend.3 b/release/man3/aio_suspend.3 index 21e6dfbf..f903b1cc 100644 --- a/release/man3/aio_suspend.3 +++ b/release/man3/aio_suspend.3 @@ -93,6 +93,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\fP(7), \fBtime\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/aio_write.3 b/release/man3/aio_write.3 index 350119dc..d1733c75 100644 --- a/release/man3/aio_write.3 +++ b/release/man3/aio_write.3 @@ -102,6 +102,6 @@ POSIX.1\-2001, POSIX.1\-2008. \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBlio_listio\fP(3), \fBaio\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/alloca.3 b/release/man3/alloca.3 index da4d7db4..60c906ad 100644 --- a/release/man3/alloca.3 +++ b/release/man3/alloca.3 @@ -45,7 +45,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ALLOCA 3 2008\-01\-24 GNU "Linux Programmer's Manual" +.TH ALLOCA 3 2013\-05\-12 GNU "Linux Programmer's Manual" .SH 名前 alloca \- 自動的に解放されるメモリを割り当てる .SH 書式 @@ -74,14 +74,17 @@ alloca \- 自動的に解放されるメモリを割り当てる \fBalloca\fP() で割り当てられた空間を \fBfree\fP(3) しようとすることのないように！ .SS "GNU 版についての注意" -通常 \fBgcc\fP(1) は \fBalloca\fP() の呼び出しをインラインコードに変換する。 \fI\-ansi\fP, \fI\-std=c89\fP, -\fI\-std=c99\fP, \fI\-fno\-builtin\fP のいずれかのオプションが指定された場合、この変換は行われない (また -\fI\fP のインクルードも行われない)。 だだし、デフォルトでは glibc 版の -\fI\fP は \fI\fP -をインクルードしており、これには以下の行が含まれているので注意すること。 +Normally, \fBgcc\fP(1) translates calls to \fBalloca\fP() with inlined code. +This is not done when either the \fI\-ansi\fP, \fI\-std=c89\fP, \fI\-std=c99\fP, or the +\fI\-std=c11\fP option is given \fBand\fP the header \fI\fP is not +included. Otherwise (without an \-ansi or \-std=c* option) the glibc version +of \fI\fP includes \fI\fP and that contains +the lines: .nf + #ifdef __GNUC__ #define alloca(size) __builtin_alloca (size) + #endif .fi 独自版の __builtin_alloca (size) 関数があると厄介な結果になる。 @@ -99,6 +102,6 @@ alloca \- 自動的に解放されるメモリを割り当てる .SH 関連項目 \fBbrk\fP(2), \fBlongjmp\fP(3), \fBmalloc\fP(3) .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/asin.3 b/release/man3/asin.3 index 577f0c7b..c9713e29 100644 --- a/release/man3/asin.3 +++ b/release/man3/asin.3 @@ -93,6 +93,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 \fBacos\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcasin\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) .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/asinh.3 b/release/man3/asinh.3 index e26c8289..a776ca2a 100644 --- a/release/man3/asinh.3 +++ b/release/man3/asinh.3 @@ -94,6 +94,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBacosh\fP(3), \fBatanh\fP(3), \fBcasinh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3) .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/asprintf.3 b/release/man3/asprintf.3 index 25d9befe..cad53061 100644 --- a/release/man3/asprintf.3 +++ b/release/man3/asprintf.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ASPRINTF 3 2001\-12\-18 GNU "Linux Programmer's Manual" +.TH ASPRINTF 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 asprintf, vasprintf \- 文字列を割り当ててそれに出力する .SH 書式 @@ -42,9 +42,12 @@ asprintf, vasprintf \- 文字列を割り当ててそれに出力する \fBint vasprintf(char **\fP\fIstrp\fP\fB, const char *\fP\fIfmt\fP\fB, va_list \fP\fIap\fP\fB);\fP .SH 説明 -\fBasprintf\fP() 関数と \fBvasprintf\fP() 関数とは、それぞれ \fBsprintf\fP(3) 関数と -\fBvsprintf\fP(3) 関数とに似ているが、 出力文字列を (終端の NULL バイトも含めて) 保持するのに十分な大きさのメモリを確保し、 -最初の引数にその文字列へのポインタを返す。 このポインタは、不要になったら \fBfree\fP(3) に渡し、割り当てられた記憶領域を解放すべきである。 +The functions \fBasprintf\fP() and \fBvasprintf\fP() are analogs of +\fBsprintf\fP(3) and \fBvsprintf\fP(3), except that they allocate a string large +enough to hold the output including the terminating null byte (\(aq\e0\(aq), +and return a pointer to it via the first argument. This pointer should be +passed to \fBfree\fP(3) to release the allocated storage when it is no longer +needed. .SH 返り値 成功すると、これらの関数は出力されたバイト数を (\fBsprintf\fP(3) のように) 返す。 メモリの割り当てができなかったり、 その他エラーが生じると、 これらの関数は \-1 を返し、 \fIstrp\fP の内容は未定義となる。 @@ -54,6 +57,6 @@ asprintf, vasprintf \- 文字列を割り当ててそれに出力する .SH 関連項目 \fBfree\fP(3), \fBmalloc\fP(3), \fBprintf\fP(3) .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/assert.3 b/release/man3/assert.3 index 87b4c1d8..1d78f265 100644 --- a/release/man3/assert.3 +++ b/release/man3/assert.3 @@ -59,6 +59,6 @@ POSIX.1\-2001, C89, C99. C89 では \fBexpression\fP は \fIint\fP .SH 関連項目 \fBabort\fP(3), \fBassert_perror\fP(3), \fBexit\fP(3) .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/assert_perror.3 b/release/man3/assert_perror.3 index 64b25608..3f002aea 100644 --- a/release/man3/assert_perror.3 +++ b/release/man3/assert_perror.3 @@ -57,6 +57,6 @@ assert マクロの目的は、プログラマがプログラム中のバグを .SH 関連項目 \fBabort\fP(3), \fBassert\fP(3), \fBexit\fP(3), \fBstrerror\fP(3) .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/atan.3 b/release/man3/atan.3 index b97be008..5fdc4fff 100644 --- a/release/man3/atan.3 +++ b/release/man3/atan.3 @@ -88,6 +88,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 \fBacos\fP(3), \fBasin\fP(3), \fBatan2\fP(3), \fBcarg\fP(3), \fBcatan\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) .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/atan2.3 b/release/man3/atan2.3 index fe28b1af..9efd5e8f 100644 --- a/release/man3/atan2.3 +++ b/release/man3/atan2.3 @@ -116,6 +116,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 \fBacos\fP(3), \fBasin\fP(3), \fBatan\fP(3), \fBcarg\fP(3), \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) .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/atanh.3 b/release/man3/atanh.3 index 7bd19034..5c4cc1a8 100644 --- a/release/man3/atanh.3 +++ b/release/man3/atanh.3 @@ -111,6 +111,6 @@ glibc 2.9 とそれ以前のバージョンでは、 極エラーが発生した .SH 関連項目 \fBacosh\fP(3), \fBasinh\fP(3), \fBcatanh\fP(3), \fBcosh\fP(3), \fBsinh\fP(3), \fBtanh\fP(3) .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/atexit.3 b/release/man3/atexit.3 index 18793f95..8d749f3d 100644 --- a/release/man3/atexit.3 +++ b/release/man3/atexit.3 @@ -117,6 +117,6 @@ main(void) .SH 関連項目 \fB_exit\fP(2), \fBexit\fP(3), \fBon_exit\fP(3) .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/atof.3 b/release/man3/atof.3 index a6878879..db6b18e5 100644 --- a/release/man3/atof.3 +++ b/release/man3/atof.3 @@ -58,6 +58,6 @@ SVr4, POSIX.1\-2001, 4.3BSD, C89, C99. .SH 関連項目 \fBatoi\fP(3), \fBatol\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3) .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/atoi.3 b/release/man3/atoi.3 index 2fcda370..ae3bcd06 100644 --- a/release/man3/atoi.3 +++ b/release/man3/atoi.3 @@ -88,6 +88,6 @@ SVr4, POSIX.1\-2001, 4.3BSD, C99. C89 と POSIX.1\-1996 には \fBatoi\fP() .SH 関連項目 \fBatof\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3) .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/backtrace.3 b/release/man3/backtrace.3 index c7023b27..d007971c 100644 --- a/release/man3/backtrace.3 +++ b/release/man3/backtrace.3 @@ -43,11 +43,15 @@ backtrace, backtrace_symbols, backtrace_symbols_fd \- アプリケーション \fBvoid backtrace_symbols_fd(void *const\fP \fB*\fP\fIbuffer\fP\fB,\fP \fBint\fP \fIsize\fP\fB,\fP \fBint\fP \fIfd\fP\fB);\fP .SH 説明 -\fBbacktrace\fP() は、呼び出したプログラムのバックトレースを \fIbuffer\fP が指す配列に入れて返す。バックトレースは、プログラムで -現在動作中の関数呼び出しの並びである。 \fIbuffer\fP が指す配列の個々の要素は \fIvoid *\fP 型で、 -対応するスタックフレームからのリターンアドレスである。 \fIsize\fP 引き数は \fIbuffer\fP に格納できるアドレスの最大個数を指定する。 -バックトレースが \fIsize\fP より大きい場合、 \fIsize\fP 個の直近の関数呼び出しに対応するアドレスが返される。 -完全なバックトレースを取得するためには、確実に \fIbuffer\fP と \fIsize\fP が十分大きくなるようにすること。 +\fBbacktrace\fP() returns a backtrace for the calling program, in the array +pointed to by \fIbuffer\fP. A backtrace is the series of currently active +function calls for the program. Each item in the array pointed to by +\fIbuffer\fP is of type \fIvoid\ *\fP, and is the return address from the +corresponding stack frame. The \fIsize\fP argument specifies the maximum +number of addresses that can be stored in \fIbuffer\fP. If the backtrace is +larger than \fIsize\fP, then the addresses corresponding to the \fIsize\fP most +recent function calls are returned; to obtain the complete backtrace, make +sure that \fIbuffer\fP and \fIsize\fP are large enough. \fBbacktrace\fP() によって \fIbuffer\fP にアドレスの集合が得られたら、 \fBbacktrace_symbols\fP() によって、アドレス集合を、そのアドレスをシンボルで表した文字列の配列 に翻訳できる。 \fIsize\fP 引き数は \fIbuffer\fP @@ -166,6 +170,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBgcc\fP(1), \fBld\fP(1), \fBdlopen\fP(3), \fBmalloc\fP(3) .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/basename.3 b/release/man3/basename.3 index 8e8fea70..f507eac5 100644 --- a/release/man3/basename.3 +++ b/release/man3/basename.3 @@ -65,15 +65,17 @@ basename, dirname \- パス名を解析して各部分を取り出す 以下の一連の例 (SUSv2 から引用) は、 いろいろな path に対して \fBdirname\fP() と \fBbasename\fP() が返す文字列を表したものである。 .sp -.nf -\fBpath dirname basename\fP -"/usr/lib" "/usr" "lib" -"/usr/" "/" "usr" -"usr" "." "usr" -"/" "/" "/" -"." "." "." -".." "." ".." -.fi +.TS +lb lb lb +l l l l. +path dirname basename +/usr/lib /usr lib +/usr/ / usr +usr . usr +/ / / +. . . +.. . .. +.TE .SH 返り値 \fBdirname\fP() と \fBbasename\fP() は、いずれも NULL で終端された文字列へのポインタを返す。 (これらのポインタを \fBfree\fP(3) に渡さないこと。) @@ -115,6 +117,6 @@ printf("dirname=%s, basename=%s\en", dname, bname); .SH 関連項目 \fBbasename\fP(1), \fBdirname\fP(1) .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/bcmp.3 b/release/man3/bcmp.3 index d8119301..5ef043db 100644 --- a/release/man3/bcmp.3 +++ b/release/man3/bcmp.3 @@ -54,6 +54,6 @@ bcmp \- バイト列を比較する \fBmemcmp\fP(3), \fBstrcasecmp\fP(3), \fBstrcmp\fP(3), \fBstrcoll\fP(3), \fBstrncasecmp\fP(3), \fBstrncmp\fP(3) .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/bcopy.3 b/release/man3/bcopy.3 index 58039ee0..ed2ac740 100644 --- a/release/man3/bcopy.3 +++ b/release/man3/bcopy.3 @@ -55,6 +55,6 @@ bcopy \- バイト列をコピーする .SH 関連項目 \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBmemmove\fP(3), \fBstrcpy\fP(3), \fBstrncpy\fP(3) .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/bindresvport.3 b/release/man3/bindresvport.3 index 640be785..4faac68f 100644 --- a/release/man3/bindresvport.3 +++ b/release/man3/bindresvport.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH BINDRESVPORT 3 2008\-12\-03 "" "Linux Programmer's Manual" +.TH BINDRESVPORT 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 bindresvport \- ソケットを特権 IP ポートにバインドする .SH 書式 @@ -67,6 +67,14 @@ bindresvport \- ソケットを特権 IP ポートにバインドする .TP \fBEAFNOSUPPORT\fP (glibc 2.7 以前では \fBEPFNOSUPPORT\fP) \fIsin\fP が NULL 以外で、かつ \fIsin\->sin_family\fP が \fBAF_INET\fP でなかった。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +Before glibc 2.17, the \fBbindresvport\fP() function uses a static variable +that is not protected, so it is not thread\-safe. + +.\" commit f6da27e53695ad1cc0e2a9490358decbbfdff5e5 +Since glibc 2.17, the \fBbindresvport\fP() function uses a lock to protect +static variable, so it is thread\-safe. .SH 準拠 POSIX.1\-2001 にはない。 BSD, Solaris およびその他の多くのシステムに存在する。 .SH 注意 @@ -75,6 +83,6 @@ POSIX.1\-2001 にはない。 BSD, Solaris およびその他の多くのシス .SH 関連項目 \fBbind\fP(2), \fBgetsockname\fP(2) .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/bsd_signal.3 b/release/man3/bsd_signal.3 index 7e62c78f..82c587fc 100644 --- a/release/man3/bsd_signal.3 +++ b/release/man3/bsd_signal.3 @@ -64,6 +64,6 @@ bsd_signal \- BSD 方式のシグナル処理 .SH 関連項目 \fBsigaction\fP(2), \fBsignal\fP(2), \fBsysv_signal\fP(3), \fBsignal\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/bsearch.3 b/release/man3/bsearch.3 index 4361c9ec..7d4c28fe 100644 --- a/release/man3/bsearch.3 +++ b/release/man3/bsearch.3 @@ -49,9 +49,9 @@ bsearch \- ソートされた配列を二分木検索 (binary search) する によって与える。 ポインタ \fIkey\fP で参照されるオブジェクトと一致するメンバーが返される。 配列中の各々のメンバーのサイズは \fIsize\fP によって指定する。 .PP -配列の内容は比較関数 \fIcompar\fP に基づき、昇順にソートされていなけれ ばならない。 \fIcompar\fP ルーチンは二つの引数を取る関数で、一つ -目に \fIkey\fP へのポインタ、次に配列のメンバーへのポインタを取る。 この順に指定したとき、 \fIkey\fP が配列メンバーより小さいときには -負の整数を、大きいときには正の整数を、一致したときには 0 を、それぞれ \fIcompar\fP は返さなければならない。 +配列の内容は比較関数 \fIcompar\fP に基づき、昇順にソートされていなけれ ばならない。 \fIcompar\fP +ルーチンは二つの引き数を取る関数で、一つ 目に \fIkey\fP へのポインタ、次に配列のメンバーへのポインタを取る。 この順に指定したとき、 \fIkey\fP +が配列メンバーより小さいときには 負の整数を、大きいときには正の整数を、一致したときには 0 を、それぞれ \fIcompar\fP は返さなければならない。 .SH 返り値 \fBbsearch\fP() 関数は、配列のメンバーのうち、一致したものへのポインタを 返す。見つからなかったときは NULL を返す。 \fIkey\fP と一致したメンバーが 複数あるとき、そのうちのどのメンバーが返されるかはわからない。 @@ -108,6 +108,6 @@ main(int argc, char **argv) .SH 関連項目 \fBhsearch\fP(3), \fBlsearch\fP(3), \fBqsort\fP(3), \fBtsearch\fP(3) .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/bstring.3 b/release/man3/bstring.3 index 41274574..69613523 100644 --- a/release/man3/bstring.3 +++ b/release/man3/bstring.3 @@ -76,6 +76,6 @@ memmove, memset \- バイト列の操作を行なう \fBmemcmp\fP(3), \fBmemcpy\fP(3), \fBmemfrob\fP(3), \fBmemmem\fP(3), \fBmemmove\fP(3), \fBmemset\fP(3) .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/btowc.3 b/release/man3/btowc.3 index b71192fe..97d0eca0 100644 --- a/release/man3/btowc.3 +++ b/release/man3/btowc.3 @@ -43,6 +43,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBmbrtowc\fP(3), \fBmbtowc\fP(3), \fBwctob\fP(3) .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/btree.3 b/release/man3/btree.3 index 794849fe..5ffed866 100644 --- a/release/man3/btree.3 +++ b/release/man3/btree.3 @@ -168,6 +168,6 @@ Systems, Vol. 2, 1 (March 1977), 11\-26. \fIThe Art of Computer Programming Vol. 3: Sorting and Searching\fP, D.E. Knuth, 1968, pp 471\-480. .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/byteorder.3 b/release/man3/byteorder.3 index 15fa448d..8c18dcbe 100644 --- a/release/man3/byteorder.3 +++ b/release/man3/byteorder.3 @@ -72,6 +72,6 @@ POSIX.1\-2001. .SH 関連項目 \fBendian\fP(3), \fBgethostbyname\fP(3), \fBgetservent\fP(3) .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/bzero.3 b/release/man3/bzero.3 index 974c8cdd..1eb4f2a4 100644 --- a/release/man3/bzero.3 +++ b/release/man3/bzero.3 @@ -53,6 +53,6 @@ bzero \- 値 0 のバイトで埋める .SH 関連項目 \fBmemset\fP(3), \fBswab\fP(3) .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/cabs.3 b/release/man3/cabs.3 index 2d6ae78f..ebf19d93 100644 --- a/release/man3/cabs.3 +++ b/release/man3/cabs.3 @@ -33,6 +33,6 @@ C99. .SH 関連項目 \fBabs\fP(3), \fBcimag\fP(3), \fBhypot\fP(3), \fBcomplex\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/cacos.3 b/release/man3/cacos.3 index 3e82fb91..f412c991 100644 --- a/release/man3/cacos.3 +++ b/release/man3/cacos.3 @@ -71,6 +71,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBccos\fP(3), \fBclog\fP(3), \fBcomplex\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/cacosh.3 b/release/man3/cacosh.3 index ff49f090..0659deb7 100644 --- a/release/man3/cacosh.3 +++ b/release/man3/cacosh.3 @@ -69,6 +69,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBacosh\fP(3), \fBcabs\fP(3), \fBccosh\fP(3), \fBcimag\fP(3), \fBcomplex\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/canonicalize_file_name.3 b/release/man3/canonicalize_file_name.3 index 6bebd8d0..db589ca6 100644 --- a/release/man3/canonicalize_file_name.3 +++ b/release/man3/canonicalize_file_name.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CANONICALIZE_FILE_NAME 3 2013\-03\-10 GNU "Linux Programmer's Manual" +.TH CANONICALIZE_FILE_NAME 3 2013\-05\-11 GNU "Linux Programmer's Manual" .SH 名前 canonicalize_file_name \- 正規化された絶対パス名を返す .SH 書式 @@ -38,31 +38,27 @@ canonicalize_file_name \- 正規化された絶対パス名を返す .sp \fBchar *canonicalize_file_name(const char *\fP\fIpath\fP\fB);\fP .SH 説明 -The \fBcanonicalize_file_name\fP() function returns a null\-terminated string -containing the canonicalized absolute pathname corresponding to \fIpath\fP. In -the returned string, symbolic links are resolved, as are \fI.\fP and \fI..\fP -pathname components. Consecutive slash (\fI/\fP) characters are replaced by a -single slash. +\fBcanonicalize_file_name\fP() 関数は \fIpath\fP に対応する正規化された絶対パス名を示す NULL +終端された文字列を返す。返された文字列では、シンボリックリンクや、パス名に含まれる \fI.\fP や \fI..\fP は展開される。連続するスラッシュ +(\fI/\fP) 文字はスラッシュ一つに置換される。 -The returned string is dynamically allocated by \fBcanonicalize_file_name\fP() -and the caller should deallocate it with \fBfree\fP(3) when it is no longer -required. +返される文字列は \fBcanonicalize_file_name\fP() により動的に割り当てられる。呼び出し側は、必要なくなった際にはこの文字列を +\fBfree\fP(3) で解放すべきである。 \fIcanonicalize_file_name(path)\fP は以下と等価である。 realpath(path, NULL); -.SH 準拠 -この関数は GNU による拡張である。 .SH 返り値 -On success, \fBcanonicalize_file_name\fP() returns a null\-terminated string. -On error (e.g., a pathname component is unreadable or does not exist), -\fBcanonicalize_file_name\fP() returns NULL and sets \fIerrno\fP to indicate the -error. +成功すると、 \fBcanonicalize_file_name\fP() は NULL 終端された文字列を返す。エラーの場合 +(例えば、パス名の中に読み込めなかったり存在しないパスが含まれている場合など)、 \fBcanonicalize_file_name\fP() は NULL +を返し、 \fIerrno\fP にエラー内容を示す値を設定する。 .SH エラー \fBrealpath\fP(3) 参照。 +.SH 準拠 +この関数は GNU による拡張である。 .SH 関連項目 \fBreadlink\fP(2), \fBrealpath\fP(3) .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/carg.3 b/release/man3/carg.3 index 8c323b90..79e2b60d 100644 --- a/release/man3/carg.3 +++ b/release/man3/carg.3 @@ -54,6 +54,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcomplex\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/casin.3 b/release/man3/casin.3 index 95748b75..91fc7ad3 100644 --- a/release/man3/casin.3 +++ b/release/man3/casin.3 @@ -37,6 +37,6 @@ C99. .SH 関連項目 \fBclog\fP(3), \fBcsin\fP(3), \fBcomplex\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/casinh.3 b/release/man3/casinh.3 index e60ed3d5..083a4295 100644 --- a/release/man3/casinh.3 +++ b/release/man3/casinh.3 @@ -37,6 +37,6 @@ C99. .SH 関連項目 \fBasinh\fP(3), \fBcabs\fP(3), \fBcimag\fP(3), \fBcsinh\fP(3), \fBcomplex\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/catan.3 b/release/man3/catan.3 index 83523e6a..01dca0c8 100644 --- a/release/man3/catan.3 +++ b/release/man3/catan.3 @@ -71,6 +71,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBccos\fP(3), \fBclog\fP(3), \fBctan\fP(3), \fBcomplex\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/catanh.3 b/release/man3/catanh.3 index a8b2304e..3bb21338 100644 --- a/release/man3/catanh.3 +++ b/release/man3/catanh.3 @@ -69,6 +69,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBatanh\fP(3), \fBcabs\fP(3), \fBcimag\fP(3), \fBctanh\fP(3), \fBcomplex\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/catgets.3 b/release/man3/catgets.3 index 3df7fce5..265d6a58 100644 --- a/release/man3/catgets.3 +++ b/release/man3/catgets.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CATGETS 3 1998\-08\-09 "" "Linux Programmer's Manual" +.TH CATGETS 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 catgets \- メッセージカタログからメッセージを取り出す .SH 書式 @@ -39,11 +39,15 @@ catgets \- メッセージカタログからメッセージを取り出す \fB const char *\fP\fImessage\fP\fB);\fP .fi .SH 説明 -\fBcatgets\fP() は catalog で指定されたメッセージカタログから、 セット \fIset_number\fP のメッセージ -\fImessage_number\fP を読み取る。 \fIcatalog\fP は、 \fBcatopen\fP(3) の呼び出しによって得られたカタログ -ディスクリプタを指定する。 4番目の引数 \fImessage\fP は、指定のメッセージカタログが現在利用できない 場合に \fBcatgets\fP() -が返すデフォルトのメッセージを指す。 メッセージテキストは内部のバッファ領域に格納されており、 -保存や変更を行う場合にはアプリケーション側でコピーする必要がある。 返される文字列は常にヌル文字で終端される。 +\fBcatgets\fP() reads the message \fImessage_number\fP, in set \fIset_number\fP, +from the message catalog identified by \fIcatalog\fP, where \fIcatalog\fP is a +catalog descriptor returned from an earlier call to \fBcatopen\fP(3). The +fourth argument, \fImessage\fP, points to a default message string which will +be returned by \fBcatgets\fP() if the identified message catalog is not +currently available. The message\-text is contained in an internal buffer +area and should be copied by the application if it is to be saved or +modified. The return string is always terminated with a null byte +(\(aq\e0\(aq). .SH 返り値 .LP 成功した場合、 \fBcatgets\fP() は内部のバッファ領域へのポインタを返す。 ここにはヌル文字で終端されたメッセージ文字列が格納されている。 @@ -58,6 +62,6 @@ POSIX.1\-2001. .SH 関連項目 \fBcatopen\fP(3), \fBsetlocale\fP(3) .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/catopen.3 b/release/man3/catopen.3 index 78b563f8..0e174507 100644 --- a/release/man3/catopen.3 +++ b/release/man3/catopen.3 @@ -92,6 +92,6 @@ POSIX.1\-2001. 定数 \fBMCLoadBySet\fP と \fBMCLoadAll\fP に対応するソ .SH 関連項目 \fBcatgets\fP(3), \fBsetlocale\fP(3) .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/cbrt.3 b/release/man3/cbrt.3 index a043dec1..12639203 100644 --- a/release/man3/cbrt.3 +++ b/release/man3/cbrt.3 @@ -84,6 +84,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBpow\fP(3), \fBsqrt\fP(3) .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/ccos.3 b/release/man3/ccos.3 index 177c8bdf..1dab64c4 100644 --- a/release/man3/ccos.3 +++ b/release/man3/ccos.3 @@ -35,6 +35,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcacos\fP(3), \fBcsin\fP(3), \fBctan\fP(3), \fBcomplex\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/ccosh.3 b/release/man3/ccosh.3 index 374d70e9..20f48846 100644 --- a/release/man3/ccosh.3 +++ b/release/man3/ccosh.3 @@ -35,6 +35,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcacosh\fP(3), \fBcsinh\fP(3), \fBctanh\fP(3), \fBcomplex\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/ceil.3 b/release/man3/ceil.3 index 40635384..841caafa 100644 --- a/release/man3/ceil.3 +++ b/release/man3/ceil.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CEIL 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH CEIL 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 ceil, ceilf, ceill \- 引き数を下回らない最小の整数値 .SH 書式 @@ -68,6 +68,9 @@ or \fIcc\ \-std=c99\fP \fIx\fP が整数、+0、\-0、NaN、無限のいずれかの場合、 \fIx\fP そのものが返される。 .SH エラー エラーは発生しない。 POSIX.1\-2001 にはオーバーフローでの範囲エラー (range error) の 記載がある。「注意」の節を参照のこと。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBceil\fP(), \fBceilf\fP(), and \fBceill\fP() functions are thread\-safe. .SH 準拠 C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 注意 @@ -85,6 +88,6 @@ SUSv2 と POSIX.1\-2001 にはオーバーフローに関する記述があり \fBfloor\fP(3), \fBlrint\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), \fBround\fP(3), \fBtrunc\fP(3) .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/cerf.3 b/release/man3/cerf.3 index 20256deb..72b0cef2 100644 --- a/release/man3/cerf.3 +++ b/release/man3/cerf.3 @@ -40,6 +40,6 @@ cerf, cerff, cerfl, cerfc, cerfcf, cerfcl \- 複素数の誤差関数 .SH 関連項目 \fBerf\fP(3), \fBcomplex\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/cexp.3 b/release/man3/cexp.3 index 1c8e2cc5..c0aba290 100644 --- a/release/man3/cexp.3 +++ b/release/man3/cexp.3 @@ -37,6 +37,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcexp2\fP(3), \fBclog\fP(3), \fBcpow\fP(3), \fBcomplex\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/cexp2.3 b/release/man3/cexp2.3 index 67a682ae..88b1d7ad 100644 --- a/release/man3/cexp2.3 +++ b/release/man3/cexp2.3 @@ -32,6 +32,6 @@ cexp2, cexp2f, cexp2l \- 複素数の 2 の累乗 .SH 関連項目 \fBcabs\fP(3), \fBcexp\fP(3), \fBclog10\fP(3), \fBcomplex\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/cfree.3 b/release/man3/cfree.3 index 7e7faaf5..503ed872 100644 --- a/release/man3/cfree.3 +++ b/release/man3/cfree.3 @@ -86,6 +86,6 @@ Specification, Edition 2 (Intel386 バイナリ互換仕様、第 2 版) に準 .SH 関連項目 \fBmalloc\fP(3) .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/cimag.3 b/release/man3/cimag.3 index 863ddc28..5f86bfc3 100644 --- a/release/man3/cimag.3 +++ b/release/man3/cimag.3 @@ -9,7 +9,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CIMAG 3 2008\-08\-11 "" "Linux Programmer's Manual" +.TH CIMAG 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 cimag, cimagf, cimagl \- 複素数の虚部を取得する .SH 書式 @@ -32,6 +32,9 @@ cimag, cimagf, cimagl \- 複素数の虚部を取得する .fi .SH バージョン これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBcimag\fP(), \fBcimagf\fP(), and \fBcimagl\fP() functions are thread\-safe. .SH 準拠 C99. .SH 注意 @@ -39,6 +42,6 @@ gcc では __imag__ を使うこともできるが、 これは GNU による拡 .SH 関連項目 \fBcabs\fP(3), \fBcreal\fP(3), \fBcomplex\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/clearenv.3 b/release/man3/clearenv.3 index 64197ae6..1cda7433 100644 --- a/release/man3/clearenv.3 +++ b/release/man3/clearenv.3 @@ -72,6 +72,6 @@ DG/UX と Tru64 man ページには次のように記されている： \fIenvir .SH 関連項目 \fBgetenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), \fBenviron\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/clock.3 b/release/man3/clock.3 index 9922b244..cbd8fccc 100644 --- a/release/man3/clock.3 +++ b/release/man3/clock.3 @@ -65,6 +65,6 @@ C の標準規格ではプログラムの開始の時点ではどんな値が返 .SH 関連項目 \fBclock_gettime\fP(2), \fBgetrusage\fP(2), \fBtimes\fP(2) .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/clog.3 b/release/man3/clog.3 index 89771272..8629b3a8 100644 --- a/release/man3/clog.3 +++ b/release/man3/clog.3 @@ -40,6 +40,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcexp\fP(3), \fBclog10\fP(3), \fBclog2\fP(3), \fBcomplex\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/clog10.3 b/release/man3/clog10.3 index 31af2a49..195ccb52 100644 --- a/release/man3/clog10.3 +++ b/release/man3/clog10.3 @@ -36,6 +36,6 @@ clog10, clog10f, clog10l \- 底が 10 の複素数の対数 .SH 関連項目 \fBcabs\fP(3), \fBcexp\fP(3), \fBclog\fP(3), \fBclog2\fP(3), \fBcomplex\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/clog2.3 b/release/man3/clog2.3 index 0d748186..c0f5a24a 100644 --- a/release/man3/clog2.3 +++ b/release/man3/clog2.3 @@ -36,6 +36,6 @@ clog2, clog2f, clog2l \- 底が 2 の複素数の対数 .SH 関連項目 \fBcabs\fP(3), \fBcexp\fP(3), \fBclog\fP(3), \fBclog10\fP(3), \fBcomplex\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/closedir.3 b/release/man3/closedir.3 index 858c8bad..137fdfa0 100644 --- a/release/man3/closedir.3 +++ b/release/man3/closedir.3 @@ -62,6 +62,6 @@ SVr4, POSIX.1\-2001, 4.3BSD. \fBclose\fP(2), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3) .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/cmsg.3 b/release/man3/cmsg.3 index 1ee1dea8..85ebfadf 100644 --- a/release/man3/cmsg.3 +++ b/release/man3/cmsg.3 @@ -143,6 +143,6 @@ msg.msg_controllen = cmsg\->cmsg_len; .PP RFC\ 2292 .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/confstr.3 b/release/man3/confstr.3 index 7dc07b88..a0135d4f 100644 --- a/release/man3/confstr.3 +++ b/release/man3/confstr.3 @@ -103,6 +103,6 @@ confstr(_CS_PATH, pathbuf, n); .SH 関連項目 \fBsh\fP(1), \fBexec\fP(3), \fBsystem\fP(3) .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/conj.3 b/release/man3/conj.3 index f59b22c9..f1808e15 100644 --- a/release/man3/conj.3 +++ b/release/man3/conj.3 @@ -9,7 +9,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CONJ 3 2008\-08\-11 "" "Linux Programmer's Manual" +.TH CONJ 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 conj, conjf, conjl \- 複素共役を計算する .SH 書式 @@ -32,11 +32,14 @@ conj, conjf, conjl \- 複素共役を計算する .fi .SH バージョン これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBconj\fP(), \fBconjf\fP(), and \fBconjl\fP() functions are thread\-safe. .SH 準拠 C99. .SH 関連項目 \fBcabs\fP(3), \fBcsqrt\fP(3), \fBcomplex\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/copysign.3 b/release/man3/copysign.3 index 5dde70e5..dbf2b21f 100644 --- a/release/man3/copysign.3 +++ b/release/man3/copysign.3 @@ -82,6 +82,6 @@ C99, POSIX.1\-2001. この関数は IEC 559 で定義されている (また IE .SH 関連項目 \fBsignbit\fP(3) .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/cos.3 b/release/man3/cos.3 index bd046c49..358ee03a 100644 --- a/release/man3/cos.3 +++ b/release/man3/cos.3 @@ -90,6 +90,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠し \fBacos\fP(3), \fBasin\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBccos\fP(3), \fBsin\fP(3), \fBsincos\fP(3), \fBtan\fP(3) .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/cosh.3 b/release/man3/cosh.3 index 03386b35..bf006446 100644 --- a/release/man3/cosh.3 +++ b/release/man3/cosh.3 @@ -99,6 +99,6 @@ glibc バージョン 2.3.4 以前では、オーバーフローが発生した .SH 関連項目 \fBacosh\fP(3), \fBasinh\fP(3), \fBatanh\fP(3), \fBccos\fP(3), \fBsinh\fP(3), \fBtanh\fP(3) .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/cpow.3 b/release/man3/cpow.3 index b80f220f..d9c1eb5b 100644 --- a/release/man3/cpow.3 +++ b/release/man3/cpow.3 @@ -34,6 +34,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBpow\fP(3), \fBcomplex\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/cproj.3 b/release/man3/cproj.3 index b73d896b..22f62b76 100644 --- a/release/man3/cproj.3 +++ b/release/man3/cproj.3 @@ -36,6 +36,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcomplex\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/creal.3 b/release/man3/creal.3 index 124bde05..3e4d92e7 100644 --- a/release/man3/creal.3 +++ b/release/man3/creal.3 @@ -39,6 +39,6 @@ gcc では __real__ を使うこともできるが、 これは GNU による拡 .SH 関連項目 \fBcabs\fP(3), \fBcimag\fP(3), \fBcomplex\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/crypt.3 b/release/man3/crypt.3 index 047376ad..8d92db7a 100644 --- a/release/man3/crypt.3 +++ b/release/man3/crypt.3 @@ -38,7 +38,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CRYPT 3 2011\-09\-15 "" "Linux Programmer's Manual" +.TH CRYPT 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 crypt, crypt_r \- パスワードとデータの暗号化 .SH 書式 @@ -126,6 +126,11 @@ DES アルゴリズムにはいくつかの癖があり、それによってパ .\" Making encrypted data computed using crypt() publicly available has .\" to be considered insecure for the given reasons. \fBcrypt\fP() 関数が実装されていない。多分アメリカの輸出規制のために。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBcrypt\fP() function is not thread\-safe. +.LP +The \fBcrypt_r\fP() function is thread\-safe. .SH 準拠 \fBcrypt\fP(): SVr4, 4.3BSD, POSIX.1\-2001. \fBcrypt_r\fP() は GNU 拡張である。 .SH 注意 @@ -176,6 +181,6 @@ SHA\-512 | 86 characters .SH 関連項目 \fBlogin\fP(1), \fBpasswd\fP(1), \fBencrypt\fP(3), \fBgetpass\fP(3), \fBpasswd\fP(5) .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/csin.3 b/release/man3/csin.3 index 0c124c76..696aa39c 100644 --- a/release/man3/csin.3 +++ b/release/man3/csin.3 @@ -35,6 +35,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcasin\fP(3), \fBccos\fP(3), \fBctan\fP(3), \fBcomplex\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/csinh.3 b/release/man3/csinh.3 index a426ed76..26ac9b88 100644 --- a/release/man3/csinh.3 +++ b/release/man3/csinh.3 @@ -35,6 +35,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcasinh\fP(3), \fBccosh\fP(3), \fBctanh\fP(3), \fBcomplex\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/csqrt.3 b/release/man3/csqrt.3 index 1f954f4f..6e75ec34 100644 --- a/release/man3/csqrt.3 +++ b/release/man3/csqrt.3 @@ -33,6 +33,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcexp\fP(3), \fBcomplex\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/ctan.3 b/release/man3/ctan.3 index baac0750..212e65f0 100644 --- a/release/man3/ctan.3 +++ b/release/man3/ctan.3 @@ -35,6 +35,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcatan\fP(3), \fBccos\fP(3), \fBcsin\fP(3), \fBcomplex\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/ctanh.3 b/release/man3/ctanh.3 index 9a17d1b0..02843fa6 100644 --- a/release/man3/ctanh.3 +++ b/release/man3/ctanh.3 @@ -35,6 +35,6 @@ C99. .SH 関連項目 \fBcabs\fP(3), \fBcatanh\fP(3), \fBccosh\fP(3), \fBcsinh\fP(3), \fBcomplex\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/ctermid.3 b/release/man3/ctermid.3 index eaffd082..2eb4ebf8 100644 --- a/release/man3/ctermid.3 +++ b/release/man3/ctermid.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CTERMID 3 2007\-07\-26 GNU "Linux Programmer's Manual" +.TH CTERMID 3 2013\-07\-04 GNU "Linux Programmer's Manual" .SH 名前 ctermid \- 制御端末名の取得 .SH 書式 @@ -51,6 +51,10 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fIs\fP は端末パス名を保持するのに使用されるバッファへのポインタとなる。 シンボル定数 \fBL_ctermid\fP は返されるパス名の最大文字数である。 .SH 返り値 パス名へのポインタ。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBctermid\fP() function is thread\-safe with exceptions. It is not +thread\-safe if called with a NULL parameter. .SH 準拠 SVr4, POSIX.1\-2001. .SH バグ @@ -62,6 +66,6 @@ SVr4, POSIX.1\-2001. .SH 関連項目 \fBttyname\fP(3) .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/ctime.3 b/release/man3/ctime.3 index 31d11f0d..df2639c8 100644 --- a/release/man3/ctime.3 +++ b/release/man3/ctime.3 @@ -213,6 +213,6 @@ POSIX.1\-2004 によると、 \fBlocaltime\fP() はあたかも \fBtzset\fP(3) \fBdifftime\fP(3), \fBstrftime\fP(3), \fBstrptime\fP(3), \fBtimegm\fP(3), \fBtzset\fP(3), \fBtime\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/daemon.3 b/release/man3/daemon.3 index f3545cb4..7a76b895 100644 --- a/release/man3/daemon.3 +++ b/release/man3/daemon.3 @@ -73,6 +73,6 @@ POSIX.1\-2001 にはない。 同様の関数が BSD には見られる。 \fBda .SH 関連項目 \fBfork\fP(2), \fBsetsid\fP(2) .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/dbopen.3 b/release/man3/dbopen.3 index acc0037a..2cd779ec 100644 --- a/release/man3/dbopen.3 +++ b/release/man3/dbopen.3 @@ -302,6 +302,6 @@ typedef \fIDBT\fP は \*(lqdata base thang\*(rqの略語であるが、これが \fILIBTP: Portable, Modular Transactions for UNIX\fP, Margo Seltzer, Michael Olson, USENIX proceedings, Winter 1992. .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/des_crypt.3 b/release/man3/des_crypt.3 index 6511c6c3..5bd0dd19 100644 --- a/release/man3/des_crypt.3 +++ b/release/man3/des_crypt.3 @@ -80,6 +80,6 @@ Code Book) モードで暗号化する。 このモードでは (個々の) デ .SH 関連項目 \fBdes\fP(1), \fBcrypt\fP(3), \fBxcrypt\fP(3) .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/difftime.3 b/release/man3/difftime.3 index 8ee59cab..fa52e135 100644 --- a/release/man3/difftime.3 +++ b/release/man3/difftime.3 @@ -61,6 +61,6 @@ POSIX システムでは \fItime_t\fP は数値型なので、引き算の際に \fBdate\fP(1), \fBgettimeofday\fP(2), \fBtime\fP(2), \fBctime\fP(3), \fBgmtime\fP(3), \fBlocaltime\fP(3) .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/dirfd.3 b/release/man3/dirfd.3 index beb25021..413ec3d4 100644 --- a/release/man3/dirfd.3 +++ b/release/man3/dirfd.3 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH DIRFD 3 2010\-09\-26 Linux "Linux Programmer's Manual" +.TH DIRFD 3 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 dirfd \- ディレクトリストリームのファイルディスクリプタを取得する .SH 書式 @@ -62,7 +62,8 @@ _BSD_SOURCE || _SVID_SOURCE \fBfstat\fP(2) や \fBfchdir\fP(2) などでしか役に立たない。 このディスクリプタは \fBclosedir\fP(3) が呼ばれたときに自動的にクローズされる。 .SH 返り値 -成功すると、負でない値のファイルディスクリプタが返される。 エラーの場合は \-1 が返される。 +On success, a nonnegative file descriptor is returned. On error, \-1 is +returned, and \fIerrno\fP is set to indicate the cause of the error. .SH エラー .\" glibc 2.8 POSIX.1\-2008 では 2 つのエラーが規定されている。 現在の実装ではどちらのエラーも返されない。 @@ -82,6 +83,6 @@ POSIX.1\-2008. この関数は BSD 拡張であった。 4.3BSD\-Reno には存 \fBopen\fP(2), \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3) .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/div.3 b/release/man3/div.3 index f4c248db..fbea078c 100644 --- a/release/man3/div.3 +++ b/release/man3/div.3 @@ -91,6 +91,6 @@ SVr4, 4.3BSD, C89, C99. .SH 関連項目 \fBabs\fP(3), \fBremainder\fP(3) .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/dl_iterate_phdr.3 b/release/man3/dl_iterate_phdr.3 index 59bb0b42..30cd258a 100644 --- a/release/man3/dl_iterate_phdr.3 +++ b/release/man3/dl_iterate_phdr.3 @@ -36,9 +36,9 @@ dl_iterate_phdr \- 共有オブジェクトのリストを辿る \fB#include \fP \fBint dl_iterate_phdr(\fP - \fBint (*\fPcallback\fB) (struct dl_phdr_info *\fPinfo\fB,\fP - \fBsize_t\fP size\fB, void *\fPdata\fB),\fP - \fBvoid *\fPdata\fB);\fP +\fB int (*\fP\fIcallback\fP\fB) (struct dl_phdr_info *\fP\fIinfo\fP\fB,\fP +\fB size_t \fP\fIsize\fP\fB, void *\fP\fIdata\fP\fB,\fP +\fB void *\fP\fIdata\fP\fB;\fP .fi .SH 説明 \fBdl_iterate_phdr\fP() 関数を使うと、アプリケーションは実行時に どの共有オブジェクトをロードしたかを見つけることができる。 @@ -146,6 +146,6 @@ main(int argc, char *argv[]) オンラインのいろいろな場所で入手できる \fIExecutable and Linking Format Specification\fP .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/dlopen.3 b/release/man3/dlopen.3 index c99ef13f..dbb48f02 100644 --- a/release/man3/dlopen.3 +++ b/release/man3/dlopen.3 @@ -304,6 +304,6 @@ main(int argc, char **argv) ld.so info pages, gcc info pages, ld info pages .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/dprintf.3 b/release/man3/dprintf.3 index 07582d23..d933d74d 100644 --- a/release/man3/dprintf.3 +++ b/release/man3/dprintf.3 @@ -87,6 +87,6 @@ _GNU_SOURCE .SH 関連項目 \fBprintf\fP(3) .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/drand48.3 b/release/man3/drand48.3 index 62543868..4fea2bd4 100644 --- a/release/man3/drand48.3 +++ b/release/man3/drand48.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH DRAND48 3 2007\-07\-26 "" "Linux Programmer's Manual" +.TH DRAND48 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 \- 一様分布する疑似乱数を生成する関数 @@ -125,6 +125,12 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 配列の形をした引数の要素はそれぞれ、\fIparam[0\-2]\fP は \fIXi\fP を、 \fIparam[3\-5]\fP は \fIa\fP を、\fIparam[6]\fP は \fIc\fP を指定するもの である。 \fBlcong48\fP() が呼ばれた後で、 \fBsrand48\fP() か \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. .SH 準拠 SVr4, POSIX.1\-2001. .SH 注意 @@ -132,6 +138,6 @@ SVID 3 ではこれらの関数は時代遅れと宣言されている。 SVID 3 .SH 関連項目 \fBrand\fP(3), \fBrandom\fP(3) .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/drand48_r.3 b/release/man3/drand48_r.3 index feee9f36..eb62d743 100644 --- a/release/man3/drand48_r.3 +++ b/release/man3/drand48_r.3 @@ -95,6 +95,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH 関連項目 \fBdrand48\fP(3), \fBrand\fP(3), \fBrandom\fP(3) .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/dysize.3 b/release/man3/dysize.3 index 56c0b1e3..02d0564c 100644 --- a/release/man3/dysize.3 +++ b/release/man3/dysize.3 @@ -55,6 +55,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH 関連項目 \fBstrftime\fP(3) .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/ecvt.3 b/release/man3/ecvt.3 index c52577dc..241ea394 100644 --- a/release/man3/ecvt.3 +++ b/release/man3/ecvt.3 @@ -34,7 +34,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ECVT 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH ECVT 3 2013\-07\-04 "" "Linux Programmer's Manual" .SH 名前 ecvt, fcvt \- 浮動小数点数の文字列への変換 .SH 書式 @@ -81,6 +81,9 @@ _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEN .SH 返り値 関数 \fBecvt\fP() と \fBfcvt\fP() は \fInumber\fP の ASCII 表現を含む 静的な領域内の文字列へのポインタを返す。 この文字列は \fBecvt\fP() や \fBfcvt\fP() の呼び出しのたびに上書きされる。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +関数 \fBecvt\fP() と \fBfcvt\fP() はスレッドセーフではない。 .SH 準拠 SVr2。 POSIX.1\-2001 では「過去の名残 (LEGACY)」と位置付けられている。 POSIX.1\-2008 では \fBecvt\fP() と \fBfcvt\fP() の仕様が削除され、代わりに \fBsprintf\fP(3) の使用が推奨されている(しかし \fBsnprintf\fP(3) @@ -91,6 +94,6 @@ Linux libc4 と libc5 では \fIndigits\fP の型は \fIsize_t\fP となって .SH 関連項目 \fBecvt_r\fP(3), \fBgcvt\fP(3), \fBqecvt\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3) .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/ecvt_r.3 b/release/man3/ecvt_r.3 index 1e610cc7..dbe5df32 100644 --- a/release/man3/ecvt_r.3 +++ b/release/man3/ecvt_r.3 @@ -75,6 +75,6 @@ _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH 関連項目 \fBecvt\fP(3), \fBqecvt\fP(3), \fBsprintf\fP(3) .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/encrypt.3 b/release/man3/encrypt.3 index 16948422..e9294a2b 100644 --- a/release/man3/encrypt.3 +++ b/release/man3/encrypt.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ENCRYPT 3 2003\-04\-04 "" "Linux Programmer's Manual" +.TH ENCRYPT 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 encrypt, setkey, encrypt_r, setkey_r \- 64 ビットのメッセージを暗号化する .SH 書式 @@ -95,6 +95,11 @@ struct crypt_data { .TP \fBENOSYS\fP (例えば以前のアメリカ合衆国輸出規制などにより) この関数が提供されていない。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The functions \fBencrypt\fP() and \fBsetkey\fP() are not thread\-safe. +.LP +The functions \fBencrypt_r\fP() and \fBsetkey_r\fP() are thread\-safe. .SH 準拠 関数 \fBencrypt\fP() と \fBsetkey\fP() は SVr4, SUSv2, and POSIX.1\-2001 に準拠する。 関数 \fBencrypt_r\fP() と \fBsetkey_r\fP() は GNU 拡張である。 @@ -124,6 +129,6 @@ main(void) .\" .BR fcrypt (3) \fBcbc_crypt\fP(3), \fBcrypt\fP(3), \fBecb_crypt\fP(3) .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/end.3 b/release/man3/end.3 index b6e18142..486e4058 100644 --- a/release/man3/end.3 +++ b/release/man3/end.3 @@ -94,6 +94,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBobjdump\fP(1), \fBreadelf\fP(1), \fBsbrk\fP(2), \fBelf\fP(5) .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/endian.3 b/release/man3/endian.3 index 682eb0f5..e40ba0dd 100644 --- a/release/man3/endian.3 +++ b/release/man3/endian.3 @@ -143,6 +143,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBbyteorder\fP(3) .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/envz_add.3 b/release/man3/envz_add.3 index 7d7b2a48..22951e7d 100644 --- a/release/man3/envz_add.3 +++ b/release/man3/envz_add.3 @@ -21,16 +21,14 @@ envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip \- \fB#include \fP \fBerror_t envz_add(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB,\fP -.ti 20n -\fBconst char *\fP\fIname\fP\fB, const char *\fP\fIvalue\fP\fB);\fP +\fB const char *\fP\fIname\fP\fB, const char *\fP\fIvalue\fP\fB);\fP \fBchar *envz_entry(const char *\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB, const char *\fP\fIname\fP\fB);\fP \fBchar *envz_get(const char *\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB, const char *\fP\fIname\fP\fB);\fP \fBerror_t envz_merge(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB,\fP -.ti 20n -\fBconst char *\fP\fIenvz2\fP\fB, size_t \fP\fIenvz2_len\fP\fB, int \fP\fIoverride\fP\fB);\fP +\fB const char *\fP\fIenvz2\fP\fB, size_t \fP\fIenvz2_len\fP\fB, int \fP\fIoverride\fP\fB);\fP \fBvoid envz_remove(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB, const char *\fP\fIname\fP\fB);\fP @@ -94,6 +92,6 @@ main(int argc, char *argv[], char *envp[]) .SH 関連項目 \fBargz_add\fP(3) .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/erf.3 b/release/man3/erf.3 index 822b58bf..ceb4a7dd 100644 --- a/release/man3/erf.3 +++ b/release/man3/erf.3 @@ -105,6 +105,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠し .SH 関連項目 \fBcerf\fP(3), \fBerfc\fP(3), \fBexp\fP(3) .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/erfc.3 b/release/man3/erfc.3 index 32f9b19f..657f3bf3 100644 --- a/release/man3/erfc.3 +++ b/release/man3/erfc.3 @@ -103,6 +103,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠し .SH 関連項目 \fBcerf\fP(3), \fBerf\fP(3), \fBexp\fP(3) .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/err.3 b/release/man3/err.3 index 09593e23..f04346e5 100644 --- a/release/man3/err.3 +++ b/release/man3/err.3 @@ -123,6 +123,6 @@ if ((fd = open(block_device, O_RDONLY, 0)) == \-1) .SH 関連項目 \fBerror\fP(3), \fBexit\fP(3), \fBperror\fP(3), \fBprintf\fP(3), \fBstrerror\fP(3) .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/errno.3 b/release/man3/errno.3 index 4ad0a54e..c0d7dc8a 100644 --- a/release/man3/errno.3 +++ b/release/man3/errno.3 @@ -481,6 +481,6 @@ errno\fP のように) 定義するのが一般的であった。 \fBこのよ .SH 関連項目 \fBerr\fP(3), \fBerror\fP(3), \fBperror\fP(3), \fBstrerror\fP(3) .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/error.3 b/release/man3/error.3 index 16c380ea..1dcb430a 100644 --- a/release/man3/error.3 +++ b/release/man3/error.3 @@ -37,16 +37,16 @@ error_print_progname \- glibc のエラー書き出し関数 .nf \fB#include \fP -\fBvoid error(int \fP\fIstatus, \fP\fBint\fP\fI errnum, \fP\fBconst char *\fP\fIformat, \fP\fB...);\fP +\fBvoid error(int \fP\fIstatus\fP\fB, int \fP\fIerrnum\fP\fB, const char *\fP\fIformat\fP\fB, ...);\fP -\fBvoid error_at_line(int \fP\fIstatus, \fP\fBint \fP\fIerrnum, \fP\fBconst char *\fP\fIfilename, - \fP\fBunsigned int \fP\fIlinenum, \fP\fBconst char *\fP\fIformat, \fP\fB...);\fP +\fBvoid error_at_line(int \fP\fIstatus\fP\fB, int \fP\fIerrnum\fP\fB, const char *\fP\fIfilename\fP\fB,\fP +\fB unsigned int \fP\fIlinenum\fP\fB, const char *\fP\fIformat\fP\fB, ...);\fP \fBextern unsigned int \fP\fIerror_message_count\fP\fB;\fP \fBextern int \fP\fIerror_one_per_line\fP\fB;\fP -\fBextern void (* \fP\fIerror_print_progname\fP\fB) (void);\fP +\fBextern void (*\fP\fIerror_print_progname\fP\fB) (void);\fP .fi .SH 説明 \fBerror\fP() は汎用的なエラー書き出し関数である。 この関数は標準出力 (\fIstdout\fP) に書き出してから、標準エラー出力 @@ -83,6 +83,6 @@ error_print_progname \- glibc のエラー書き出し関数 \fBerr\fP(3), \fBerrno\fP(3), \fBexit\fP(3), \fBperror\fP(3), \fBprogram_invocation_name\fP(3), \fBstrerror\fP(3) .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/ether_aton.3 b/release/man3/ether_aton.3 index 1464b083..19f874c9 100644 --- a/release/man3/ether_aton.3 +++ b/release/man3/ether_aton.3 @@ -26,14 +26,14 @@ .\" Linux libc source code .\" FreeBSD 4.4 man pages .\" -.\" Minor additions, aeb, 2002-07-20 +.\" Minor additions, aeb, 2013-06-21 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ETHER_ATON 3 2002\-07\-20 GNU "Linux Programmer's Manual" +.TH ETHER_ATON 3 2013\-07\-04 GNU "Linux Programmer's Manual" .SH 名前 ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line, ether_ntoa_r, ether_aton_r \- Ethernet アドレスの操作用関数 @@ -92,6 +92,12 @@ struct ether_addr { } .fi .in +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBether_aton\fP() and \fBether_ntoa\fP() functions are not thread\-safe. +.LP +The \fBether_ntohost\fP(), \fBether_hostton\fP(), \fBether_line\fP(), +\fBether_ntoa_r\fP() and \fBether_aton_r\fP() functions are thread\-safe. .SH 準拠 4.3BSD, SunOS. .SH バグ @@ -99,6 +105,6 @@ glibc 2.2.5 での \fBether_line\fP() の実装はおかしい。 .SH 関連項目 \fBethers\fP(5) .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/euidaccess.3 b/release/man3/euidaccess.3 index 327fe49b..fb859b81 100644 --- a/release/man3/euidaccess.3 +++ b/release/man3/euidaccess.3 @@ -74,6 +74,6 @@ euidaccess, eaccess \- ファイルへのアクセス権を実効ユーザでチ \fBsetgid\fP(2), \fBsetuid\fP(2), \fBstat\fP(2), \fBcredentials\fP(7), \fBpath_resolution\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/exec.3 b/release/man3/exec.3 index b4c9f0fb..76cd6260 100644 --- a/release/man3/exec.3 +++ b/release/man3/exec.3 @@ -79,11 +79,14 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .PP これらの関数の最初の引き数は、実行されるファイルの名前である。 .PP -関数 \fBexecl\fP(), \fBexeclp\fP(), \fBexecle\fP() の \fIconst char *arg\fP とそれに続く省略部分は -\fIarg0\fP, \fIarg1\fP, \&..., \fIargn\fP とみなされる。 これらには、実行されるプログラムで利用可能な引き数のリストを指定する -(引き数のリストは NULL で終端された文字列へのポインタから構成される)。 慣習として、最初の引き数は、実行されるファイル名 -へのポインタにする。引き数のリストは必ず NULL で終わらなければならず、これらの関数は可変長引き数関数なので、 このポインタは \fI(char *) -NULL\fP とキャストしなければならない。 +The \fIconst char\ *arg\fP and subsequent ellipses in the \fBexecl\fP(), +\fBexeclp\fP(), and \fBexecle\fP() functions can be thought of as \fIarg0\fP, +\fIarg1\fP, \&..., \fIargn\fP. Together they describe a list of one or more +pointers to null\-terminated strings that represent the argument list +available to the executed program. The first argument, by convention, +should point to the filename associated with the file being executed. The +list of arguments \fImust\fP be terminated by a NULL pointer, and, since these +are variadic functions, this pointer must be cast \fI(char\ *) NULL\fP. .PP 関数 \fBexecv\fP(), \fBexecvp\fP(), \fBexecvpe\fP() は、利用可能な引き数リスト (NULL で終端された文字列への ポインタの配列) を新しいプログラムに渡す。 慣習として、最初の引き数は実行されるファイル名へ のポインタにする。ポインタの配列は必ず NULL @@ -137,6 +140,6 @@ Linux 以外のシステムには、 (環境変数 \fBPATH\fP が定義されて \fBsh\fP(1), \fBexecve\fP(2), \fBfork\fP(2), \fBptrace\fP(2), \fBfexecve\fP(3), \fBenviron\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/exit.3 b/release/man3/exit.3 index 08b649f7..b60c70d8 100644 --- a/release/man3/exit.3 +++ b/release/man3/exit.3 @@ -92,6 +92,6 @@ BSD は終了コードを標準化しようとしている; \fI\fP \fB_exit\fP(2), \fBsetpgid\fP(2), \fBwait\fP(2), \fBatexit\fP(3), \fBon_exit\fP(3), \fBtmpfile\fP(3) .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/exp.3 b/release/man3/exp.3 index 185208bd..d70f210d 100644 --- a/release/man3/exp.3 +++ b/release/man3/exp.3 @@ -97,6 +97,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBcbrt\fP(3), \fBcexp\fP(3), \fBexp10\fP(3), \fBexp2\fP(3), \fBsqrt\fP(3) .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/exp10.3 b/release/man3/exp10.3 index ec340bea..0fd26241 100644 --- a/release/man3/exp10.3 +++ b/release/man3/exp10.3 @@ -73,6 +73,6 @@ exp10, exp10f, exp10l \- 基数が 10 の指数関数 .SH 関連項目 \fBcbrt\fP(3), \fBexp\fP(3), \fBexp2\fP(3), \fBlog10\fP(3), \fBsqrt\fP(3) .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/exp2.3 b/release/man3/exp2.3 index 2f42f240..2c4a91a5 100644 --- a/release/man3/exp2.3 +++ b/release/man3/exp2.3 @@ -83,6 +83,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBcbrt\fP(3), \fBcexp2\fP(3), \fBexp\fP(3), \fBexp10\fP(3), \fBsqrt\fP(3) .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/expm1.3 b/release/man3/expm1.3 index c4800b1b..82ebdfd2 100644 --- a/release/man3/expm1.3 +++ b/release/man3/expm1.3 @@ -126,6 +126,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBexp\fP(3), \fBlog\fP(3), \fBlog1p\fP(3) .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/fabs.3 b/release/man3/fabs.3 index 33e73b08..7dec2722 100644 --- a/release/man3/fabs.3 +++ b/release/man3/fabs.3 @@ -80,6 +80,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBabs\fP(3), \fBcabs\fP(3), \fBceil\fP(3), \fBfloor\fP(3), \fBlabs\fP(3), \fBrint\fP(3) .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/fclose.3 b/release/man3/fclose.3 index c5e60d0d..05f68f81 100644 --- a/release/man3/fclose.3 +++ b/release/man3/fclose.3 @@ -80,6 +80,6 @@ C89, C99. .SH 関連項目 \fBclose\fP(2), \fBfcloseall\fP(3), \fBfflush\fP(3), \fBfopen\fP(3), \fBsetbuf\fP(3) .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/fcloseall.3 b/release/man3/fcloseall.3 index 572a95dc..e531ddd6 100644 --- a/release/man3/fcloseall.3 +++ b/release/man3/fcloseall.3 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FCLOSEALL 3 2006\-12\-27 GNU "Linux Programmer's Manual" +.TH FCLOSEALL 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 fcloseall \- 開いているすべてのストリームを閉じる .SH 書式 @@ -44,11 +44,15 @@ fcloseall \- 開いているすべてのストリームを閉じる 標準入出力 \fIstdin\fP, \fIstdout\fP, \fIstderr\fP も閉じられる。 .SH 返り値 この関数は、すべてのファイルが正常に閉じられた場合 0 を返す。 エラーの場合、 \fBEOF\fP を返す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBfcloseall\fP() function does not lock the streams, so it is not +thread\-safe. .SH 準拠 この関数は GNU 拡張である。 .SH 関連項目 \fBclose\fP(2), \fBfclose\fP(3), \fBfflush\fP(3), \fBfopen\fP(3), \fBsetbuf\fP(3) .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/fdim.3 b/release/man3/fdim.3 index 960c642a..94f23f56 100644 --- a/release/man3/fdim.3 +++ b/release/man3/fdim.3 @@ -67,6 +67,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfmax\fP(3) .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/fenv.3 b/release/man3/fenv.3 index e4fce481..bc53b3ab 100644 --- a/release/man3/fenv.3 +++ b/release/man3/fenv.3 @@ -133,10 +133,12 @@ C99 と POSIX.1\-2008 では \fBFLT_ROUNDS\fP という識別子が規定され \fBFLT_ROUNDS\fP の値には、 \fBfesetround\fP() で設定された現在の丸めモードが反映されるべきである (但し、「バグ」の節を参照)。 .SS 浮動小数点関連の環境 -浮動小数点関連の環境の全体は、 制御モードや状態フラグも含め、 \fIfenv_t\fP 型の内部オブジェクト一つで取り扱うことができる。 -デフォルトの環境は、 (\fIconst fenv_t *\fP 型の) \fBFE_DFL_ENV\fP で示されるものである。 -これはプログラムの開始時に構築される環境であり、 ISO C では、丸めモードを最も近い値への丸め (\fBFE_TONEAREST\fP) -に設定し、すべての例外をクリアし、不停止 (nonstop) (例外が起きても継続する) モードとするように規定されている。 +The entire floating\-point environment, including control modes and status +flags, can be handled as one opaque object, of type \fIfenv_t\fP. The default +environment is denoted by \fBFE_DFL_ENV\fP (of type \fIconst fenv_t\ *\fP). This +is the environment setup at program start and it is defined by ISO C to have +round to nearest, all exceptions cleared and a nonstop (continue on +exceptions) mode. .LP \fBfegetenv\fP() 関数は、現在の浮動小数点環境を、オブジェクト \fI*envp\fP に保存する。 .LP @@ -193,6 +195,6 @@ C99 の規定では、 \fBFLT_ROUNDS\fP の値には \fBfesetround\fP() .SH 関連項目 \fBmath_error\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/ferror.3 b/release/man3/ferror.3 index 189a6418..803fc7b4 100644 --- a/release/man3/ferror.3 +++ b/release/man3/ferror.3 @@ -46,7 +46,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FERROR 3 2008\-08\-29 "" "Linux Programmer's Manual" +.TH FERROR 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 clearerr, feof, ferror, fileno \- ストリームステータスのチェックとリセット .SH 書式 @@ -80,11 +80,15 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH エラー これらの関数は失敗すべきではなく、また、外部変数 \fIerrno\fP に値をセットしない。 (しかし、 \fBfileno\fP() 関数の場合で、引数が有効なストリームでなかった場合、 関数は \-1 を返し、 \fIerrno\fP に \fBEBADF\fP を設定しなければならない。) +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBclearerr\fP(), \fBfeof\fP(), \fBferror\fP(), and \fBfileno\fP() functions are +thread\-safe. .SH 準拠 関数 \fBclearerr\fP(), \fBfeof\fP(), \fBferror\fP() は C89 と C99 に準拠している。 .SH 関連項目 \fBopen\fP(2), \fBfdopen\fP(3), \fBstdio\fP(3), \fBunlocked_stdio\fP(3) .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/fexecve.3 b/release/man3/fexecve.3 index 95552c5c..3ff45962 100644 --- a/release/man3/fexecve.3 +++ b/release/man3/fexecve.3 @@ -81,6 +81,6 @@ Linux では、 \fBfexecve\fP() は \fBproc\fP(5) ファイルシステムを .SH 関連項目 \fBexecve\fP(2) .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/fflush.3 b/release/man3/fflush.3 index 4f60e344..66170df3 100644 --- a/release/man3/fflush.3 +++ b/release/man3/fflush.3 @@ -85,6 +85,6 @@ C89, C99, POSIX.1\-2001, POSIX.1\-2008. \fBfsync\fP(2), \fBsync\fP(2), \fBwrite\fP(2), \fBfclose\fP(3), \fBfopen\fP(3), \fBsetbuf\fP(3), \fBunlocked_stdio\fP(3) .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/ffs.3 b/release/man3/ffs.3 index 72fa9d12..e8148242 100644 --- a/release/man3/ffs.3 +++ b/release/man3/ffs.3 @@ -89,6 +89,6 @@ BSD システムでは \fI\fP にプロトタイプがある。 .SH 関連項目 \fBmemchr\fP(3) .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/fgetgrent.3 b/release/man3/fgetgrent.3 index 003e4c56..7d54e04b 100644 --- a/release/man3/fgetgrent.3 +++ b/release/man3/fgetgrent.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FGETGRENT 3 2008\-07\-10 GNU "Linux Programmer's Manual" +.TH FGETGRENT 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 fgetgrent \- グループファイルエントリの取り出し .SH 書式 @@ -67,8 +67,9 @@ struct group { .fi .in .SH 返り値 -\fBfgetgrent\fP() 関数は \fIgroup\fP 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL -を返す。 +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. .SH エラー .TP \fBENOMEM\fP @@ -79,6 +80,6 @@ SVr4. \fBendgrent\fP(3), \fBfgetgrent_r\fP(3), \fBfopen\fP(3), \fBgetgrent\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3), \fBputgrent\fP(3), \fBsetgrent\fP(3), \fBgroup\fP(5) .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/fgetpwent.3 b/release/man3/fgetpwent.3 index 191fd35d..7a64945a 100644 --- a/release/man3/fgetpwent.3 +++ b/release/man3/fgetpwent.3 @@ -35,7 +35,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FGETPWENT 3 2008\-07\-10 GNU "Linux Programmer's Manual" +.TH FGETPWENT 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 fgetpwent \- パスワードファイルエントリの取り出し .SH 書式 @@ -73,8 +73,9 @@ struct passwd { .fi .in .SH 返り値 -\fBfgetpwent\fP() 関数は、 \fIpasswd\fP 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL -を返す。 +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. .SH エラー .TP \fBENOMEM\fP @@ -89,6 +90,6 @@ SVr4. \fBendpwent\fP(3), \fBfgetpwent_r\fP(3), \fBfopen\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5) .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/fgetwc.3 b/release/man3/fgetwc.3 index cf08e677..98cc9ef1 100644 --- a/release/man3/fgetwc.3 +++ b/release/man3/fgetwc.3 @@ -20,7 +20,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FGETWC 3 1999\-07\-25 GNU "Linux Programmer's Manual" +.TH FGETWC 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 fgetwc, getwc \- ワイド文字を FILE ストリームから読み込む .SH 書式 @@ -42,7 +42,9 @@ fgetwc, getwc \- ワイド文字を FILE ストリームから読み込む .PP これらの処理を停止せずに行いたいときは、 \fBunlocked_stdio\fP(3) を参照のこと。 .SH 返り値 -\fBfgetwc\fP() 関数はストリームの次のワイド文字か、あるいは \fBWEOF\fP を返す。 +The \fBfgetwc\fP() function returns the next wide\-character from the stream, +or \fBWEOF\fP. In the event of an error, \fIerrno\fP is set to indicate the +cause. .SH エラー 通常のエラーに加えて、以下のエラーがある: .TP @@ -58,6 +60,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfgetws\fP(3), \fBfputwc\fP(3), \fBungetwc\fP(3), \fBunlocked_stdio\fP(3) .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/fgetws.3 b/release/man3/fgetws.3 index 302c3e8e..b38fb0ec 100644 --- a/release/man3/fgetws.3 +++ b/release/man3/fgetws.3 @@ -51,6 +51,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfgetwc\fP(3), \fBunlocked_stdio\fP(3) .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/finite.3 b/release/man3/finite.3 index 420462ab..24e7559f 100644 --- a/release/man3/finite.3 +++ b/release/man3/finite.3 @@ -106,6 +106,6 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 .SH 関連項目 \fBfpclassify\fP(3) .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/flockfile.3 b/release/man3/flockfile.3 index e33a3307..5ea3de9f 100644 --- a/release/man3/flockfile.3 +++ b/release/man3/flockfile.3 @@ -88,6 +88,6 @@ POSIX.1\-2001. .SH 関連項目 \fBunlocked_stdio\fP(3) .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/floor.3 b/release/man3/floor.3 index b72c3e25..376fae0d 100644 --- a/release/man3/floor.3 +++ b/release/man3/floor.3 @@ -81,6 +81,6 @@ SUSv2 と POSIX.1\-2001 にはオーバーフローに関する記述があり \fBceil\fP(3), \fBlrint\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), \fBround\fP(3), \fBtrunc\fP(3) .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/fma.3 b/release/man3/fma.3 index a230c0ff..f65e6f18 100644 --- a/release/man3/fma.3 +++ b/release/man3/fma.3 @@ -102,6 +102,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBremainder\fP(3), \fBremquo\fP(3) .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/fmax.3 b/release/man3/fmax.3 index 02adb67a..066cb9ca 100644 --- a/release/man3/fmax.3 +++ b/release/man3/fmax.3 @@ -54,6 +54,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfmin\fP(3) .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/fmemopen.3 b/release/man3/fmemopen.3 index 9ba8a9b7..2319d224 100644 --- a/release/man3/fmemopen.3 +++ b/release/man3/fmemopen.3 @@ -210,6 +210,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBfopen\fP(3), \fBfopencookie\fP(3) .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/fmin.3 b/release/man3/fmin.3 index 659ee549..5d134f85 100644 --- a/release/man3/fmin.3 +++ b/release/man3/fmin.3 @@ -54,6 +54,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfmax\fP(3) .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/fmod.3 b/release/man3/fmod.3 index bd20470c..2a50637c 100644 --- a/release/man3/fmod.3 +++ b/release/man3/fmod.3 @@ -101,6 +101,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBremainder\fP(3) .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/fmtmsg.3 b/release/man3/fmtmsg.3 index fa962d48..e718a31b 100644 --- a/release/man3/fmtmsg.3 +++ b/release/man3/fmtmsg.3 @@ -15,7 +15,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FMTMSG 3 2008\-06\-14 "" "Linux Programmer's Manual" +.TH FMTMSG 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 fmtmsg \- 整形されたエラーメッセージを表示する .SH 書式 @@ -42,10 +42,12 @@ fmtmsg \- 整形されたエラーメッセージを表示する \fItag\fP 引き数はより多くの情報を見つけるためのオンラインドキュメントへの参照である。 これは \fIlabel\fP 値とユニークな識別番号を含んでいるべきである。 .SS ダミー引き数 -各引き数にはダミーの値を入れることができる。 ダミーの \fIclassification\fP 値 \fBMM_NULLMC\fP (0L) -は出力を何も指定しない。そのため何も表示されない。 ダミーの \fIseverity\fP 値 \fBNO_SEV\fP (0) は重大度 (severity) -が与えられていないことを表す。 値 \fBMM_NULLLBL\fP, \fBMM_NULLTXT\fP, \fBMM_NULLACT\fP, \fBMM_NULLTAG\fP -は \fI((char *) 0)\fP と空文字列の別名であり、 \fBMM_NULLSEV\fP は \fBNO_SEV\fP の別名である。 +Each of the arguments can have a dummy value. The dummy classification +value \fBMM_NULLMC\fP (0L) does not specify any output, so nothing is printed. +The dummy severity value \fBNO_SEV\fP (0) says that no severity is supplied. +The values \fBMM_NULLLBL\fP, \fBMM_NULLTXT\fP, \fBMM_NULLACT\fP, \fBMM_NULLTAG\fP are +synonyms for \fI((char\ *)\ 0)\fP, the empty string, and \fBMM_NULLSEV\fP is a +synonym for \fBNO_SEV\fP. .SS "classification 引き数" \fIclassification\fP 引き数は 4 種類の情報を記述する値の和である。 .br @@ -152,6 +154,14 @@ severity\-keyword 部は \fBfmtmsg\fP() に使用されないが、存在しな この重大度のメッセージが \fBfmtmsg\fP() によって生成された場合に表示される文字列である。 .SH バージョン \fBfmtmsg\fP() は、バージョン 2.1 以降の glibc で提供されている。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +Before glibc 2.16, the \fBfmtmsg\fP() function uses a static variable that is +not protected, so it is not thread\-safe. + +.\" Modified in commit 7724defcf8873116fe4efab256596861eef21a94 +Since glibc 2.16, the \fBfmtmsg\fP() function uses a lock to protect the +static variable, so it is thread\-safe. .SH 準拠 関数 \fBfmtmsg\fP() と \fBaddseverity\fP(3) と環境変数 \fBMSGVERB\fP と \fBSEV_LEVEL\fP は System V に由来している。 関数 \fBfmtmsg\fP() と環境変数 \fBMSGVERB\fP は POSIX.1\-2001 に記述されている。 @@ -214,6 +224,6 @@ main(void) .SH 関連項目 \fBaddseverity\fP(3), \fBperror\fP(3) .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/fnmatch.3 b/release/man3/fnmatch.3 index f8b4e172..db8cd31f 100644 --- a/release/man3/fnmatch.3 +++ b/release/man3/fnmatch.3 @@ -75,6 +75,6 @@ POSIX.2. \fBFNM_FILE_NAME\fP, \fBFNM_LEADING_DIR\fP, \fBFNM_CASEFOLD\fP フラ .SH 関連項目 \fBsh\fP(1), \fBglob\fP(3), \fBscandir\fP(3), \fBwordexp\fP(3), \fBglob\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/fopen.3 b/release/man3/fopen.3 index 3e883783..79d98381 100644 --- a/release/man3/fopen.3 +++ b/release/man3/fopen.3 @@ -202,6 +202,6 @@ glibc の \fBfopen\fP() と \fBfreopen\fP() の実装では、 .SH 関連項目 \fBopen\fP(2), \fBfclose\fP(3), \fBfileno\fP(3), \fBfmemopen\fP(3), \fBfopencookie\fP(3) .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/fpathconf.3 b/release/man3/fpathconf.3 index a81bf15f..1685d3b5 100644 --- a/release/man3/fpathconf.3 +++ b/release/man3/fpathconf.3 @@ -115,6 +115,6 @@ POSIX.1\-2001. .SH 関連項目 \fBgetconf\fP(1), \fBopen\fP(2), \fBstatfs\fP(2), \fBsysconf\fP(3) .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/fpclassify.3 b/release/man3/fpclassify.3 index 0a42e5a4..d697e417 100644 --- a/release/man3/fpclassify.3 +++ b/release/man3/fpclassify.3 @@ -104,6 +104,6 @@ glibc 2.01 以前では、 \fBisinf\fP() は \fIx\fP が正の無限大か負 .SH 関連項目 \fBfinite\fP(3), \fBINFINITY\fP(3), \fBisgreater\fP(3), \fBsignbit\fP(3) .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/fpurge.3 b/release/man3/fpurge.3 index 535c5adf..484db8c9 100644 --- a/release/man3/fpurge.3 +++ b/release/man3/fpurge.3 @@ -65,6 +65,6 @@ fpurge, __fpurge \- ストリームを一掃 (purge) する .\" .BR fclean (3), \fBfflush\fP(3), \fBsetbuf\fP(3), \fBstdio_ext\fP(3) .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/fputwc.3 b/release/man3/fputwc.3 index 0e77a48b..b046ff54 100644 --- a/release/man3/fputwc.3 +++ b/release/man3/fputwc.3 @@ -18,7 +18,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH FPUTWC 3 1999\-07\-25 GNU "Linux Programmer's Manual" +.TH FPUTWC 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 fputwc, putwc \- ワイド文字を FILE ストリームに書き込む .SH 書式 @@ -41,7 +41,9 @@ fputwc, putwc \- ワイド文字を FILE ストリームに書き込む .PP これらの処理を停止せずに行いたいときは、 \fBunlocked_stdio\fP(3) を参照のこと。 .SH 返り値 -\fBfputwc\fP() 関数は、エラーが起きなければ \fIwc\fP を返す。エラーの場合には \fBWEOF\fP を返す。 +The \fBfputwc\fP() function returns \fIwc\fP if no error occurred, or \fBWEOF\fP to +indicate an error. In the event of an error, \fIerrno\fP is set to indicate +the cause. .SH エラー 通常のエラーに加えて、以下のエラーがある: .TP @@ -57,6 +59,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfgetwc\fP(3), \fBfputws\fP(3), \fBunlocked_stdio\fP(3) .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/fputws.3 b/release/man3/fputws.3 index 1aab580e..e5f7eb2b 100644 --- a/release/man3/fputws.3 +++ b/release/man3/fputws.3 @@ -44,6 +44,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfputwc\fP(3), \fBunlocked_stdio\fP(3) .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/fread.3 b/release/man3/fread.3 index fca6cacc..dece930d 100644 --- a/release/man3/fread.3 +++ b/release/man3/fread.3 @@ -80,6 +80,6 @@ C89, POSIX.1\-2001. .SH 関連項目 \fBread\fP(2), \fBwrite\fP(2), \fBfeof\fP(3), \fBferror\fP(3), \fBunlocked_stdio\fP(3) .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/frexp.3 b/release/man3/frexp.3 index f44feb7b..bfc75a5a 100644 --- a/release/man3/frexp.3 +++ b/release/man3/frexp.3 @@ -115,6 +115,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBldexp\fP(3), \fBmodf\fP(3) .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/fseek.3 b/release/man3/fseek.3 index 05a2f87f..deff82ff 100644 --- a/release/man3/fseek.3 +++ b/release/man3/fseek.3 @@ -104,6 +104,6 @@ C89, C99. .SH 関連項目 \fBlseek\fP(2), \fBfseeko\fP(3) .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/fseeko.3 b/release/man3/fseeko.3 index 2933fb42..d3f6e86b 100644 --- a/release/man3/fseeko.3 +++ b/release/man3/fseeko.3 @@ -66,6 +66,6 @@ SUSv2, POSIX.1\-2001. .SH 関連項目 \fBfseek\fP(3) .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/ftime.3 b/release/man3/ftime.3 index 1f843ee8..44d1b51b 100644 --- a/release/man3/ftime.3 +++ b/release/man3/ftime.3 @@ -77,6 +77,6 @@ glibc 2.1.1 から再び正常になった。 .SH 関連項目 \fBgettimeofday\fP(2), \fBtime\fP(2) .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/ftok.3 b/release/man3/ftok.3 index 8a91bf41..dfb28a79 100644 --- a/release/man3/ftok.3 +++ b/release/man3/ftok.3 @@ -69,6 +69,6 @@ libc4 と libc5 (および SunOS 4.x) では、 プロトタイプは以下の .SH 関連項目 \fBmsgget\fP(2), \fBsemget\fP(2), \fBshmget\fP(2), \fBstat\fP(2), \fBsvipc\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/fts.3 b/release/man3/fts.3 index 0e4a94de..57197d08 100644 --- a/release/man3/fts.3 +++ b/release/man3/fts.3 @@ -355,6 +355,6 @@ preorder でたどられたディレクトリでない場合や 何も含んで .SH 関連項目 \fBfind\fP(1), \fBchdir\fP(2), \fBstat\fP(2), \fBftw\fP(3), \fBqsort\fP(3) .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/ftw.3 b/release/man3/ftw.3 index c87d9856..4748ccdb 100644 --- a/release/man3/ftw.3 +++ b/release/man3/ftw.3 @@ -258,6 +258,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBstat\fP(2), \fBfts\fP(3), \fBreaddir\fP(3) .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/futimes.3 b/release/man3/futimes.3 index baf4b542..d2ab7f66 100644 --- a/release/man3/futimes.3 +++ b/release/man3/futimes.3 @@ -74,6 +74,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH 関連項目 \fButime\fP(2), \fButimensat\fP(2), \fBsymlink\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/fwide.3 b/release/man3/fwide.3 index fb06c5d1..89117e55 100644 --- a/release/man3/fwide.3 +++ b/release/man3/fwide.3 @@ -70,6 +70,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfprintf\fP(3), \fBfwprintf\fP(3) .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/gamma.3 b/release/man3/gamma.3 index 14c65d5c..7bc82b6c 100644 --- a/release/man3/gamma.3 +++ b/release/man3/gamma.3 @@ -74,6 +74,6 @@ Gamma(|\fIx\fP|) の符号が extern int \fIsigngam\fP に格納されていた .SH 関連項目 \fBlgamma\fP(3), \fBsigngam\fP(3), \fBtgamma\fP(3) .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/gcvt.3 b/release/man3/gcvt.3 index 5e542510..fc314e89 100644 --- a/release/man3/gcvt.3 +++ b/release/man3/gcvt.3 @@ -77,6 +77,6 @@ POSIX.1\-2001 では、 この関数は「過去の名残 (LEGACY)」と位置 .SH 関連項目 \fBecvt\fP(3), \fBfcvt\fP(3), \fBsprintf\fP(3) .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/get_nprocs_conf.3 b/release/man3/get_nprocs_conf.3 index c337fd7c..3c331a31 100644 --- a/release/man3/get_nprocs_conf.3 +++ b/release/man3/get_nprocs_conf.3 @@ -81,6 +81,6 @@ main(int argc, char *argv[]) .fi .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/getaddrinfo.3 b/release/man3/getaddrinfo.3 index 45ebb807..9afe5c0e 100644 --- a/release/man3/getaddrinfo.3 +++ b/release/man3/getaddrinfo.3 @@ -509,6 +509,6 @@ main(int argc, char *argv[]) \fBgetaddrinfo_a\fP(3), \fBgethostbyname\fP(3), \fBgetnameinfo\fP(3), \fBinet\fP(3), \fBgai.conf\fP(5), \fBhostname\fP(7), \fBip\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/getcontext.3 b/release/man3/getcontext.3 index a5bbc7a0..83856f7c 100644 --- a/release/man3/getcontext.3 +++ b/release/man3/getcontext.3 @@ -102,6 +102,6 @@ SUSv2, POSIX.1\-2001. POSIX.1\-2008 では、移植性の問題から \fBgetcon \fBsigaction\fP(2), \fBsigaltstack\fP(2), \fBsigprocmask\fP(2), \fBlongjmp\fP(3), \fBmakecontext\fP(3), \fBsigsetjmp\fP(3) .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/getcwd.3 b/release/man3/getcwd.3 index 9dd006bf..ae5e9d12 100644 --- a/release/man3/getcwd.3 +++ b/release/man3/getcwd.3 @@ -148,6 +148,6 @@ Linux では (2.1.92 以降)、 \fBgetcwd\fP() はシステムコールであ \fBchdir\fP(2), \fBfchdir\fP(2), \fBopen\fP(2), \fBunlink\fP(2), \fBfree\fP(3), \fBmalloc\fP(3) .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/getdate.3 b/release/man3/getdate.3 index d460f1ac..28a5d3f4 100644 --- a/release/man3/getdate.3 +++ b/release/man3/getdate.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETDATE 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH GETDATE 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 getdate, getdate_r \- 日付と時刻の文字列を要素別の時刻に変換する .SH 書式 @@ -134,6 +134,11 @@ time) に変換する。 要素別の時刻は \fItm\fP 構造体に格納され .TP \fBTZ\fP, \fBLC_TIME\fP \fBstrptime\fP(3) が用いる変数。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetdate\fP() function is not thread\-safe. +.LP +The \fBgetdate_r\fP() function is thread\-safe. .SH 準拠 POSIX.1\-2001. .SH 注意 @@ -227,6 +232,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBtime\fP(2), \fBlocaltime\fP(3), \fBsetlocale\fP(3), \fBstrftime\fP(3), \fBstrptime\fP(3) .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/getdirentries.3 b/release/man3/getdirentries.3 index fda5746f..d548e19a 100644 --- a/release/man3/getdirentries.3 +++ b/release/man3/getdirentries.3 @@ -57,6 +57,6 @@ POSIX.1\-2001 にはない。 BSD に存在し、他にもいくつかのシス .SH 関連項目 \fBlseek\fP(2), \fBopen\fP(2) .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/getdtablesize.3 b/release/man3/getdtablesize.3 index 9d88148e..a6f544c2 100644 --- a/release/man3/getdtablesize.3 +++ b/release/man3/getdtablesize.3 @@ -74,6 +74,6 @@ SVr4, 4.4BSD (\fBgetdtablesize\fP() 関数は 4.2BSD で最初に現われた) .SH 関連項目 \fBclose\fP(2), \fBdup\fP(2), \fBgetrlimit\fP(2), \fBopen\fP(2) .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/getenv.3 b/release/man3/getenv.3 index 4990d0ef..2156d040 100644 --- a/release/man3/getenv.3 +++ b/release/man3/getenv.3 @@ -1,6 +1,7 @@ .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) -.\" and Copyright (C) 2007 Michael Kerrisk +.\" and Copyright (C) 2007, 2012 Michael Kerrisk .\" +.\" %%%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 @@ -33,22 +35,50 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETENV 3 2008\-03\-17 GNU "Linux Programmer's Manual" +.TH GETENV 3 2012\-08\-14 GNU "Linux Programmer's Manual" .SH 名前 -getenv \- 環境変数を得る +getenv, secure_getenv \- 環境変数を得る .SH 書式 .nf \fB#include \fP .sp \fBchar *getenv(const char *\fP\fIname\fP\fB);\fP + +\fBchar *secure_getenv(const char *\fP\fIname\fP\fB);\fP .fi +.sp +.in -4n +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): +.in +.sp +\fBsecure_getenv\fP(): _GNU_SOURCE .SH 説明 関数 \fBgetenv\fP() は、環境リストから名前が \fIname\fP の環境変数を検索し、対応する \fIvalue\fP 文字列へのポインタを返す。 + +GNU 固有の \fBsecure_getenv\fP() 関数は \fBgetenv\fP() と同様だが、 "secure execution" +(「安全な実行」) が必要な場合には NULL を返す点が異なる。 "secure execution" が必要となるのは、 +呼び出し元プロセスにより実行されるプログラムがロードされる際に、 以下の条件のいずれか一つが成立する場合である。 +.IP * 3 +プロセスの実効ユーザ ID がプロセスの実ユーザ ID と一致しない場合、またはプロセスの実効グループ ID がプロセスの実グループ ID +と一致しない場合 (通常、この状況になるのは、 set\-user\-ID プログラムか set\-group\-ID プログラムを実行した場合である)。 +.IP * +実行ファイルで実効ケーパビリティビットがセットされている場合。 +.IP * +プロセスの許可ケーパビリティセットが空でない場合。 +.PP +Linux セキュリティモジュールにより要求された場合にも "secure execution" は必要となる。 + +\fBsecure_getenv\fP() 関数は、 set\-user\-ID プログラムや set\-group\-ID +プログラムが実行環境を偶然信用してしまった場合に起こり得る脆弱性を、 汎用ライブラリで回避するために使うことを意図して作られた。 .SH 返り値 関数 \fBgetenv\fP() は、環境における値 value へのポインタを返す。 \fIname\fP にマッチする環境変数が存在しないときには NULL を返す。 +.SH バージョン +\fBsecure_getenv\fP() は glibc 2.17 で初めて登場した。 .SH 準拠 -SVr4, POSIX.1\-2001, 4.3BSD, C89, C99. +\fBgetenv\fP(): SVr4, POSIX.1\-2001, 4.3BSD, C89, C99. + +\fBsecure_getenv\fP() は GNU による拡張である。 .SH 注意 環境リストの文字列は \fIname=value\fP という形式をしている。 @@ -58,9 +88,13 @@ SVr4, POSIX.1\-2001, 4.3BSD, C89, C99. \fBgetenv\fP() の実装はリエントラント (再入可能) であることを要求されていない。 \fBgetenv\fP() の返り値により参照される文字列は静的に割り当てられてもよく、 文字列の内容は後続の \fBgetenv\fP(), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3) の呼び出しにより変更されることがある。 + +\fBsecure_getenv\fP() の "secure execution" モードは、 カーネルからユーザ空間に渡される補助ベクトル +(auxiliary vector) の \fBAT_SECURE\fP フラグにより制御される。 .SH 関連項目 -\fBclearenv\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), \fBenviron\fP(7) +\fBclearenv\fP(3), \fBgetauxval\fP(3), \fBputenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), +\fBcapabilities\fP(7), \fBenviron\fP(7) .SH この文書について -この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部 +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man3/getfsent.3 b/release/man3/getfsent.3 index cf72db66..1ecdf42b 100644 --- a/release/man3/getfsent.3 +++ b/release/man3/getfsent.3 @@ -97,6 +97,6 @@ Linux ではブロックスペシャルデバイスを複数の場所にマウ .SH 関連項目 \fBgetmntent\fP(3), \fBfstab\fP(5) .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/getgrent.3 b/release/man3/getgrent.3 index 8abc7aa2..4714369c 100644 --- a/release/man3/getgrent.3 +++ b/release/man3/getgrent.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETGRENT 3 2010\-10\-21 "" "Linux Programmer's Manual" +.TH GETGRENT 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 getgrent, setgrent, endgrent \- グループファイルエントリの取得 .SH 書式 @@ -121,12 +121,17 @@ I/O エラー。 .TP \fI/etc/group\fP ローカルのグループ・データベースファイル +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetgrent()\fP function is not thread\-safe. +.LP +The \fBsetgrent()\fP and \fBendgrent()\fP functions are thread\-safe. .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. .SH 関連項目 \fBfgetgrent\fP(3), \fBgetgrent_r\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3) \fBgetgrouplist\fP(3), \fBputgrent\fP(3), \fBgroup\fP(5) .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/getgrent_r.3 b/release/man3/getgrent_r.3 index 24c938e0..a351305e 100644 --- a/release/man3/getgrent_r.3 +++ b/release/man3/getgrent_r.3 @@ -152,6 +152,6 @@ main(void) \fBfgetgrent\fP(3), \fBgetgrent\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3), \fBputgrent\fP(3), \fBgroup\fP(5) .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/getgrnam.3 b/release/man3/getgrnam.3 index bb8099b9..0447a691 100644 --- a/release/man3/getgrnam.3 +++ b/release/man3/getgrnam.3 @@ -35,7 +35,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETGRNAM 3 2012\-04\-23 "" "Linux Programmer's Manual" +.TH GETGRNAM 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 getgrnam, getgrnam_r, getgrgid, getgrgid_r \- グループファイルエントリの取り出し .SH 書式 @@ -143,6 +143,11 @@ I/O エラー。 .TP \fI/etc/group\fP ローカルのグループ・データベースファイル +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The functions \fBgetgrnam\fP() and \fBgetgrgid\fP() are not thread\-safe. +.LP +The functions \fBgetgrnam_r\fP() and \fBgetgrgid_r\fP() are thread\-safe. .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. .SH 注意 @@ -163,6 +168,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. \fBendgrent\fP(3), \fBfgetgrent\fP(3), \fBgetgrent\fP(3), \fBgetpwnam\fP(3), \fBsetgrent\fP(3), \fBgroup\fP(5) .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/getgrouplist.3 b/release/man3/getgrouplist.3 index 3d3d63a7..05f66500 100644 --- a/release/man3/getgrouplist.3 +++ b/release/man3/getgrouplist.3 @@ -149,6 +149,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBgetgroups\fP(2), \fBsetgroups\fP(2), \fBgetgrent\fP(3), \fBgroup\fP(5), \fBpasswd\fP(5) .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/gethostbyname.3 b/release/man3/gethostbyname.3 index fb81f876..47111f5b 100644 --- a/release/man3/gethostbyname.3 +++ b/release/man3/gethostbyname.3 @@ -229,7 +229,8 @@ POSIX.1\-2001 では、 \fBgethostbyname\fP(), \fBgethostbyaddr\fP(), \fBsethost \fIsize_t\fP 型ではなく \fIint\fP 型でなければならない。 POSIX.1\-2001 ではこれを \fIsocklen_t\fP としているが、これは OK。) \fBaccept\fP(2) も参照。 .LP -\fBgethostbyaddr\fP() の BSD のプロトタイプは、最初の引き数として \fIconst char *\fP を使う。 +The BSD prototype for \fBgethostbyaddr\fP() uses \fIconst char\ *\fP for the +first argument. .SS "System V/POSIX 拡張" .\" e.g., Linux, FreeBSD, UnixWare, HP-UX .\" e.g., FreeBSD, AIX @@ -261,6 +262,6 @@ NULL になる。 これらの関数は、成功した場合 0 を返し、失 \fBinet_pton\fP(3), \fBresolver\fP(3), \fBhosts\fP(5), \fBnsswitch.conf\fP(5), \fBhostname\fP(7), \fBnamed\fP(8) .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/gethostid.3 b/release/man3/gethostid.3 index 104a0528..7824be5d 100644 --- a/release/man3/gethostid.3 +++ b/release/man3/gethostid.3 @@ -92,6 +92,6 @@ glibc の実装では、ホスト ID を保存したファイルを オープン .SH 関連項目 \fBhostid\fP(1), \fBgethostbyname\fP(3) .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/getipnodebyname.3 b/release/man3/getipnodebyname.3 index 9da6a38e..4fef8d62 100644 --- a/release/man3/getipnodebyname.3 +++ b/release/man3/getipnodebyname.3 @@ -154,6 +154,6 @@ RFC\ 2553. .SH 関連項目 \fBgetaddrinfo\fP(3), \fBgetnameinfo\fP(3), \fBinet_ntop\fP(3), \fBinet_pton\fP(3) .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/getline.3 b/release/man3/getline.3 index 48cd7d8a..96c3a55f 100644 --- a/release/man3/getline.3 +++ b/release/man3/getline.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETLINE 3 2010\-06\-12 GNU "Linux Programmer's Manual" +.TH GETLINE 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 getline, getdelim \- 区切り文字までの文字列入力を読み込む .SH 書式 @@ -74,10 +74,14 @@ _GNU_SOURCE に指定することができる。 \fBgetline\fP() と同様に、ファイル終端に達するまでに入力行に区切り文字が見付からない場合は、 区切り文字をバッファに追加しない。 .SH 返り値 -成功した場合、 \fBgetline\fP() と \fBgetdelim\fP() は読み込んだ文字数を返す。 文字数には区切り文字は含まれるが、終端に使う -NULL バイトは含まれない。 この値によって、読み込んだ行に含まれる NULL バイトを操作することができる。 +On success, \fBgetline\fP() and \fBgetdelim\fP() return the number of characters +read, including the delimiter character, but not including the terminating +null byte (\(aq\e0\(aq). This value can be used to handle embedded null +bytes in the line read. -どちらの関数も、行の読み込みに失敗した場合には \-1 を返す (ファイルの終端に達した場合にも \-1 を返す)。 +Both functions return \-1 on failure to read a line (including end\-of\-file +condition). In the event of an error, \fIerrno\fP is set to indicate the +cause. .SH エラー .TP \fBEINVAL\fP @@ -117,6 +121,6 @@ main(void) .SH 関連項目 \fBread\fP(2), \fBfgets\fP(3), \fBfopen\fP(3), \fBfread\fP(3), \fBgets\fP(3), \fBscanf\fP(3) .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/getloadavg.3 b/release/man3/getloadavg.3 index 8eda3f31..c2976b95 100644 --- a/release/man3/getloadavg.3 +++ b/release/man3/getloadavg.3 @@ -65,6 +65,6 @@ POSIX.1\-2001 にはない。 BSD 系と Solaris に存在する。 .SH 関連項目 \fBuptime\fP(1), \fBproc\fP(5) .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/getlogin.3 b/release/man3/getlogin.3 index 9f5dc1dc..1a5870d0 100644 --- a/release/man3/getlogin.3 +++ b/release/man3/getlogin.3 @@ -30,7 +30,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETLOGIN 3 2008\-06\-29 GNU "Linux Programmer's Manual" +.TH GETLOGIN 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 getlogin, getlogin_r, cuserid \- ユーザー名を取得する .SH 書式 @@ -72,8 +72,9 @@ NULL ポインタの場合には、静的領域に置かれた文字列への たいていの目的では、ユーザーの特定には環境変数 \fBLOGNAME\fP を調べ るほうが便利である。LOGNAME 変数はユーザーが自由に設定できるので より柔軟な対応が可能になる。 .SH 返り値 -\fBgetlogin\fP() は成功した場合はユーザ名へのポインタを返し、失敗した場合は NULL を返す。 \fBgetlogin_r\fP() -は成功すると 0 を返し、失敗すると 0 以外を返す。 +\fBgetlogin\fP() returns a pointer to the username when successful, and NULL +on failure, with \fIerrno\fP set to indicate the cause of the error. +\fBgetlogin_r\fP() returns 0 when successful, and nonzero on failure. .SH エラー POSIX では以下のエラーが規定されている: .TP @@ -87,7 +88,8 @@ POSIX では以下のエラーが規定されている: 呼び出し元プロセスには制御端末がない。 .TP \fBERANGE\fP -(getlogin_r) (終端の NULL バイトも含めた) ユーザ名の長さが \fIbufsize\fP よりも長い。 +(getlogin_r) The length of the username, including the terminating null +byte (\(aq\e0\(aq), is larger than \fIbufsize\fP. .LP Linux/glibc には以下のエラーもある。 .TP @@ -106,6 +108,14 @@ passwd 構造体を割り当てるのに十分なメモリがない。 .TP \fI/var/run/utmp\fP (伝統的には \fI/etc/utmp\fP が使われている; libc の中には \fI/var/adm/utmp\fP を使うものもある) +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetlogin\fP() function is not thread\-safe. +.LP +The \fBgetlogin_r\fP() function is thread\-safe. +.LP +The \fBcuserid\fP() function is thread\-safe with exceptions. It is not +thread\-safe if called with a NULL parameter. .SH 準拠 \fBgetlogin\fP() と \fBgetlogin_r\fP() は POSIX.1\-2001 で規定されている。 @@ -131,6 +141,6 @@ glibc は POSIX 仕様には従っておらず、 \fI/dev/tty\fP ではなく \f .SH 関連項目 \fBgeteuid\fP(2), \fBgetuid\fP(2), \fButmp\fP(5) .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/getmntent.3 b/release/man3/getmntent.3 index 5ead49ee..d4364e60 100644 --- a/release/man3/getmntent.3 +++ b/release/man3/getmntent.3 @@ -66,8 +66,8 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .sp \fBgetmntent_r\fP(): _BSD_SOURCE || _SVID_SOURCE .SH 説明 -これらのルーチンは、ファイルシステムを記述したファイル \fI/etc/fstab\fP と、マウントされているファイルシステムを記述したファイル -\fI/etc/mtab\fP にアクセスするために用いられる。 +These routines are used to access the file system description file +\fI/etc/fstab\fP and the mounted file system description file \fIetc/mtab\fP. .PP \fBsetmntent\fP() 関数は、ファイルシステムの記述ファイル \fIfilename\fP をオープンして、 そのファイルポインタを返す。このファイルポインタは \fBgetmntent\fP() によって用いられる。引き数 \fItype\fP @@ -132,6 +132,6 @@ System V にも \fBgetmntent\fP() 関数はあるが、 呼び出し手順が .SH 関連項目 \fBfopen\fP(3), \fBfstab\fP(5), \fBmount\fP(8) .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/getnameinfo.3 b/release/man3/getnameinfo.3 index 52830ae4..747d8590 100644 --- a/release/man3/getnameinfo.3 +++ b/release/man3/getnameinfo.3 @@ -204,6 +204,6 @@ the freenix track: 2000 USENIX annual technical conference, June 2000 .UR http://www.usenix.org\:/publications\:/library\:/proceedings\:/usenix2000\:/freenix\:/metzprotocol.html .UE . .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/getnetent.3 b/release/man3/getnetent.3 index ea2a3f27..6792f101 100644 --- a/release/man3/getnetent.3 +++ b/release/man3/getnetent.3 @@ -108,6 +108,6 @@ struct netent { .br RFC\ 1101 .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/getnetent_r.3 b/release/man3/getnetent_r.3 index b865fb8b..dcb65fcb 100644 --- a/release/man3/getnetent_r.3 +++ b/release/man3/getnetent_r.3 @@ -113,6 +113,6 @@ _BSD_SOURCE || _SVID_SOURCE .SH 関連項目 \fBgetnetent\fP(3), \fBnetworks\fP(5) .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/getopt.3 b/release/man3/getopt.3 index 9ebab071..5963bfc6 100644 --- a/release/man3/getopt.3 +++ b/release/man3/getopt.3 @@ -344,6 +344,6 @@ main(int argc, char **argv) { .SH 関連項目 \fBgetsubopt\fP(3) .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/getpass.3 b/release/man3/getpass.3 index 05fd0457..7913c828 100644 --- a/release/man3/getpass.3 +++ b/release/man3/getpass.3 @@ -26,7 +26,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETPASS 3 2013\-03\-15 Linux "Linux Programmer's Manual" +.TH GETPASS 3 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 getpass \- パスワードを取得する .SH 書式 @@ -49,9 +49,10 @@ _BSD_SOURCE || (_XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) && !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600) -.TP 4 .fi -glibc 2.2.2 より前: なし +.TP 4 +Before glibc 2.2.2: +none .PD .RE .ad b @@ -77,6 +78,9 @@ echo をオフにし、一行 (「パスワード」) を読み込み、端末 .\" .BR getpass () .\" function appeared in Version 7 AT&T UNIX. \fI/dev/tty\fP +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetpass\fP() function is not thread\-safe. .SH 準拠 SUSv2 には存在するが、過去の名残 (LEGACY) と位置付けられている。 POSIX.1\-2001 で削除された。 .SH 注意 @@ -101,6 +105,6 @@ SUSv2 によれば、 \fBPASS_MAX\fP の値が 8 以下の場合は、この値 .SH 関連項目 \fBcrypt\fP(3) .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/getprotoent.3 b/release/man3/getprotoent.3 index b57dd4c8..3cb8fd8f 100644 --- a/release/man3/getprotoent.3 +++ b/release/man3/getprotoent.3 @@ -101,6 +101,6 @@ struct protoent { .SH 関連項目 \fBgetnetent\fP(3), \fBgetprotoent_r\fP(3), \fBgetservent\fP(3), \fBprotocols\fP(5) .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/getprotoent_r.3 b/release/man3/getprotoent_r.3 index 1b494769..c92753aa 100644 --- a/release/man3/getprotoent_r.3 +++ b/release/man3/getprotoent_r.3 @@ -202,6 +202,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBgetprotoent\fP(3), \fBprotocols\fP(5) .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/getpt.3 b/release/man3/getpt.3 index 7b23853a..d0dadff2 100644 --- a/release/man3/getpt.3 +++ b/release/man3/getpt.3 @@ -40,6 +40,6 @@ getpt \- 擬似端末マスタ (PTM) をオープンする \fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBptsname\fP(3), \fBunlockpt\fP(3), \fBptmx\fP(4), \fBpty\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/getpw.3 b/release/man3/getpw.3 index b83c218e..cb686485 100644 --- a/release/man3/getpw.3 +++ b/release/man3/getpw.3 @@ -95,6 +95,6 @@ SVr2 \fBendpwent\fP(3), \fBfgetpwent\fP(3), \fBgetpwent\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5) .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/getpwent.3 b/release/man3/getpwent.3 index b6d1ca4d..2878be63 100644 --- a/release/man3/getpwent.3 +++ b/release/man3/getpwent.3 @@ -35,7 +35,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETPWENT 3 2010\-10\-21 GNU "Linux Programmer's Manual" +.TH GETPWENT 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 getpwent, setpwent, endpwent \- パスワードファイルのエントリの取得 .SH 書式 @@ -118,6 +118,11 @@ I/O エラー。 .TP \fI/etc/passwd\fP ローカルのパスワード・データベースファイル +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetpwent()\fP function is not thread\-safe. +.LP +The \fBsetpwent()\fP and \fBendpwent()\fP functions are thread\-safe. .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. \fIpw_gecos\fP フィールドは POSIX では規定されていないが、 ほとんどの実装に存在する。 @@ -125,6 +130,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. \fIpw_gecos\fP フィールドは POSIX では規 \fBfgetpwent\fP(3), \fBgetpw\fP(3), \fBgetpwent_r\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBpasswd\fP(5) .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/getpwent_r.3 b/release/man3/getpwent_r.3 index 8076359a..e5a4f6b5 100644 --- a/release/man3/getpwent_r.3 +++ b/release/man3/getpwent_r.3 @@ -150,6 +150,6 @@ main(void) \fBfgetpwent\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBpasswd\fP(5) .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/getpwnam.3 b/release/man3/getpwnam.3 index 9f4c08b7..93dc6905 100644 --- a/release/man3/getpwnam.3 +++ b/release/man3/getpwnam.3 @@ -39,7 +39,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETPWNAM 3 2012\-04\-23 GNU "Linux Programmer's Manual" +.TH GETPWNAM 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 getpwnam, getpwnam_r, getpwuid, getpwuid_r \- パスワードファイルのエントリの取得 .SH 書式 @@ -150,6 +150,11 @@ I/O エラー。 .TP \fI/etc/passwd\fP ローカルのパスワード・データベースファイル +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The functions \fBgetpwnam\fP() and \fBgetpwuid\fP() are not thread_safe. +.LP +The functions \fBgetpwnam_r\fP() and \fBgetpwuid_r\fP() are thread\-safe. .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. \fIpw_gecos\fP フィールドは POSIX では規定されていないが、 ほとんどの実装に存在する。 @@ -228,6 +233,6 @@ main(int argc, char *argv[]) \fBendpwent\fP(3), \fBfgetpwent\fP(3), \fBgetgrnam\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3), \fBgetspnam\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5) .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/getrpcent.3 b/release/man3/getrpcent.3 index 3581985d..61128220 100644 --- a/release/man3/getrpcent.3 +++ b/release/man3/getrpcent.3 @@ -79,6 +79,6 @@ POSIX.1\-2001 にはない。 BSD 系、Solaris や他の多くのシステム .SH 関連項目 \fBgetrpcent_r\fP(3), \fBrpc\fP(5), \fBrpcinfo\fP(8), \fBypserv\fP(8) .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/getrpcent_r.3 b/release/man3/getrpcent_r.3 index aa249979..1faaad49 100644 --- a/release/man3/getrpcent_r.3 +++ b/release/man3/getrpcent_r.3 @@ -105,6 +105,6 @@ _BSD_SOURCE || _SVID_SOURCE .SH 関連項目 \fBgetrpcent\fP(3), \fBrpc\fP(5) .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/getrpcport.3 b/release/man3/getrpcport.3 index 6672d7be..b5d22d22 100644 --- a/release/man3/getrpcport.3 +++ b/release/man3/getrpcport.3 @@ -26,6 +26,6 @@ getrpcport \- RPC ポート番号を取得する .SH 準拠 POSIX.1\-2001 にはない。 BSD 系、Solaris や他の多くのシステムに存在する。 .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/gets.3 b/release/man3/gets.3 index bb20bc93..0edde3f1 100644 --- a/release/man3/gets.3 +++ b/release/man3/gets.3 @@ -99,6 +99,6 @@ glibc バージョン 2.16 以降では、機能検査マシン \fB_ISOC11_SOURC \fBputs\fP(3), \fBscanf\fP(3), \fBungetwc\fP(3), \fBunlocked_stdio\fP(3), \fBfeature_test_macros\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/getservent.3 b/release/man3/getservent.3 index d08d10c0..a0fa5189 100644 --- a/release/man3/getservent.3 +++ b/release/man3/getservent.3 @@ -110,6 +110,6 @@ struct servent { .SH 関連項目 \fBgetnetent\fP(3), \fBgetprotoent\fP(3), \fBgetservent_r\fP(3), \fBservices\fP(5) .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/getservent_r.3 b/release/man3/getservent_r.3 index 05b2316b..a605ba26 100644 --- a/release/man3/getservent_r.3 +++ b/release/man3/getservent_r.3 @@ -207,6 +207,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBgetservent\fP(3), \fBservices\fP(5) .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/getspnam.3 b/release/man3/getspnam.3 index 583cf173..40a869f9 100644 --- a/release/man3/getspnam.3 +++ b/release/man3/getspnam.3 @@ -10,7 +10,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETSPNAM 3 2013\-01\-22 GNU "Linux Programmer's Manual" +.TH GETSPNAM 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 getspnam, getspnam_r, getspent, getspent_r, setspent, endspent,fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf \- shadow @@ -150,8 +150,10 @@ struct spwd { .fi .in .SH 返り値 -ポインタを返す関数は、これ以上エントリがない場合や 処理中にエラーが発生した場合 NULL を返す。 \fIint\fP を返り値として持つ関数は、 -成功した場合 0 を返し、失敗した場合 \-1 を返す。 +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. .LP リエントラント版でない関数では、返り値が静的な領域を指しており、 引き続いてこれらの関数を呼び出した場合に上書きされる可能性がある。 .LP @@ -179,6 +181,6 @@ API が提供されている。 .SH 関連項目 \fBgetgrnam\fP(3), \fBgetpwnam\fP(3), \fBgetpwnam_r\fP(3), \fBshadow\fP(5) .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/getsubopt.3 b/release/man3/getsubopt.3 index 34d245c2..f68dc287 100644 --- a/release/man3/getsubopt.3 +++ b/release/man3/getsubopt.3 @@ -178,6 +178,6 @@ int main(int argc, char **argv) .SH 関連項目 \fBgetopt\fP(3) .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/getttyent.3 b/release/man3/getttyent.3 index 3b8a7457..114fedb2 100644 --- a/release/man3/getttyent.3 +++ b/release/man3/getttyent.3 @@ -9,7 +9,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETTTYENT 3 2002\-07\-18 GNU "Linux Programmer's Manual" +.TH GETTTYENT 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 getttyent, getttynam, setttyent, endttyent \- ttys ファイルのエントリを取得する .SH 書式 @@ -55,6 +55,16 @@ struct ttyent { #define TTY_ON 0x01 /* ログインを有効にする (ty_getty プログラムを開始する) */ #define TTY_SECURE 0x02 /* ユーザ ID 0 でのログインを許可する */ .fi +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetttyent\fP() returns a pointer to a static variable, so it is not +thread\-safe. +.LP +The \fBsetttyent\fP() and \fBendttyent\fP() use a static variable, so they are +not thread\-safe. +.LP +The \fBgetttynam\fP() calls thread\-unsafe function \fBgetttyent\fP() so it is +not thread\-safe. .SH 準拠 POSIX.1\-2001 にはない。 BSD 系に存在し、おそらく他のシステムにもあるだろう。 .SH 注意 @@ -62,6 +72,6 @@ Linux では、ファイル \fI/etc/ttys\fP と上で説明した関数は使わ .SH 関連項目 \fBttyname\fP(3), \fBttyslot\fP(3) .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/getumask.3 b/release/man3/getumask.3 index 74e5699d..211e6234 100644 --- a/release/man3/getumask.3 +++ b/release/man3/getumask.3 @@ -63,6 +63,6 @@ mode_t getumask(void) .SH 関連項目 \fBumask\fP(2) .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/getusershell.3 b/release/man3/getusershell.3 index 39757af8..dfc30463 100644 --- a/release/man3/getusershell.3 +++ b/release/man3/getusershell.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETUSERSHELL 3 2007\-07\-26 GNU "Linux Programmer's Manual" +.TH GETUSERSHELL 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 getusershell, setusershell, endusershell \- 許可されたユーザシェルを得る .SH 書式 @@ -71,11 +71,15 @@ _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) .nf /etc/shells .fi +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBgetusershell\fP(), \fBsetusershell\fP() and \fBendusershell\fP() functions +are not thread\-safe. .SH 準拠 4.3BSD. .SH 関連項目 \fBshells\fP(5) .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/getutent.3 b/release/man3/getutent.3 index d86b4208..20a8c3bb 100644 --- a/release/man3/getutent.3 +++ b/release/man3/getutent.3 @@ -33,7 +33,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH GETUTENT 3 2008\-06\-29 "" "Linux Programmer's Manual" +.TH GETUTENT 3 2013\-04\-19 "" "Linux Programmer's Manual" .SH 名前 getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- utmp ファイルのエントリにアクセスする @@ -91,6 +91,9 @@ getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- utmp \fBpututline\fP() は成功すると \fIut\fP を返す。失敗すると NULL を返す。 \fButmpname\fP() は、新しい名前の格納に成功すると 0 を返し、失敗すると \-1 を返す。 + +In the event of an error, these functions \fIerrno\fP set to indicate the +cause. .SH エラー .TP \fBENOMEM\fP @@ -211,6 +214,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBgetutmp\fP(3), \fButmp\fP(5) .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/getutmp.3 b/release/man3/getutmp.3 index 204a5d7d..446ed2c3 100644 --- a/release/man3/getutmp.3 +++ b/release/man3/getutmp.3 @@ -62,6 +62,6 @@ Linux では、これらの構造体は同じフィールドを持っており .SH 関連項目 \fBgetutent\fP(3), \fButmp\fP(5) .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/getw.3 b/release/man3/getw.3 index f3bc5904..c319b5fd 100644 --- a/release/man3/getw.3 +++ b/release/man3/getw.3 @@ -75,6 +75,6 @@ SVr4, SUSv2. POSIX.1\-2001 には存在しない。 .SH 関連項目 \fBferror\fP(3), \fBfread\fP(3), \fBfwrite\fP(3), \fBgetc\fP(3), \fBputc\fP(3) .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/getwchar.3 b/release/man3/getwchar.3 index 885f5d7b..6baf75a0 100644 --- a/release/man3/getwchar.3 +++ b/release/man3/getwchar.3 @@ -45,6 +45,6 @@ C99. .SH 関連項目 \fBfgetwc\fP(3), \fBunlocked_stdio\fP(3) .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/glob.3 b/release/man3/glob.3 index 4bbe5951..5747770d 100644 --- a/release/man3/glob.3 +++ b/release/man3/glob.3 @@ -196,6 +196,6 @@ execvp("ls", &globbuf.gl_pathv[0]); \fBls\fP(1), \fBsh\fP(1), \fBstat\fP(2), \fBexec\fP(3), \fBfnmatch\fP(3), \fBmalloc\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBwordexp\fP(3), \fBglob\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/gnu_get_libc_version.3 b/release/man3/gnu_get_libc_version.3 index 7c20b696..dececaed 100644 --- a/release/man3/gnu_get_libc_version.3 +++ b/release/man3/gnu_get_libc_version.3 @@ -75,6 +75,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBconfstr\fP(3) .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/grantpt.3 b/release/man3/grantpt.3 index 2d2873c5..091029d4 100644 --- a/release/man3/grantpt.3 +++ b/release/man3/grantpt.3 @@ -48,6 +48,6 @@ devpts では、このような補助バイナリを必要としない。 \fBopen\fP(2), \fBposix_openpt\fP(3), \fBptsname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4), \fBpty\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/gsignal.3 b/release/man3/gsignal.3 index da31331b..e96b3173 100644 --- a/release/man3/gsignal.3 +++ b/release/man3/gsignal.3 @@ -67,6 +67,6 @@ Linux ではこれらの関数を使用しないこと。 過去に間違いが .SH 関連項目 \fBkill\fP(2), \fBsignal\fP(2), \fBraise\fP(3) .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/hash.3 b/release/man3/hash.3 index 986e0dde..2f75395f 100644 --- a/release/man3/hash.3 +++ b/release/man3/hash.3 @@ -126,6 +126,6 @@ hash 関数が指定されると、 \fIhash_open\fP はデータベースが作 \fIA New Hash Package for UNIX\fP, Margo Seltzer, USENIX Proceedings, Winter 1991. .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/hsearch.3 b/release/man3/hsearch.3 index 5ef43198..2ea9640c 100644 --- a/release/man3/hsearch.3 +++ b/release/man3/hsearch.3 @@ -37,7 +37,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH HSEARCH 3 2011\-09\-10 GNU "Linux Programmer's Manual" +.TH HSEARCH 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 hcreate, hdestroy, hsearch, hcreate_r, hdestroy_r, hsearch_r \- ハッシュテーブルの管理 .SH 書式 @@ -110,12 +110,15 @@ typedef struct entry { \fBhsearch_r\fP() 関数が \fBhsearch\fP() と異なるのは、見つかった項目へのポインタを、 関数の結果としてではなく、 \fI*retval\fP に格納して返す点である。 .SH 返り値 -\fBhcreate\fP() と \fBhcreate_r\fP() は、成功した場合 0 以外の値を返し、 エラーの場合 0 を返す。 - -成功すると、 \fBhsearch\fP() は、ハッシュテーブル内のエントリへのポインタを返す。 エラーの場合、 \fBhsearch\fP() は NULL -を返す。 エラーとなるのは、 \fIaction\fP が \fBENTER\fP でハッシュテーブルがいっぱいの場合か、 \fIaction\fP が \fBFIND\fP -で \fIitem\fP がハッシュテーブル内に 見つからない場合である。 \fBhsearch_r\fP() は、成功すると 0 以外を返し、エラーの場合 0 -を返す。 +\fBhcreate\fP() and \fBhcreate_r\fP() return nonzero on success. They return 0 +on error, with \fIerrno\fP set to indicate the cause of the error. + +On success, \fBhsearch\fP() returns a pointer to an entry in the hash table. +\fBhsearch\fP() returns NULL on error, that is, if \fIaction\fP is \fBENTER\fP and +the hash table is full, or \fIaction\fP is \fBFIND\fP and \fIitem\fP cannot be found +in the hash table. \fBhsearch_r\fP() returns nonzero on success, and 0 on +error. In the event of an error, these two functions set \fIerrno\fP to +indicate the cause of the error. .SH エラー .LP \fBhcreate_r\fP() と \fBhdestroy_r\fP() は以下の理由で失敗する可能性がある。 @@ -132,6 +135,13 @@ typedef struct entry { \fIaction\fP が \fBFIND\fP で、 \fIkey\fP がテーブル内に見つからなかった。 .PP POSIX.1\-2001 が規定しているのは、エラー \fBENOMEM\fP だけである。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The functions \fBhcreate\fP(), \fBhsearch\fP(), and \fBhdestroy\fP() use a global +space for storing the table, so they are not thread\-safe. +.LP +The functions \fBhcreate_r\fP(), \fBhsearch_r\fP(), and \fBhdestroy_r\fP() are +thread\-safe. .SH 準拠 関数 \fBhcreate\fP(), \fBhsearch\fP(), \fBhdestroy\fP() は SVr4 から導入されたもので、POSIX.1\-2001 に記述されている。 関数 \fBhcreate_r\fP, \fBhsearch_r\fP, \fBhdestroy_r\fP は GNU の拡張である。 @@ -200,6 +210,6 @@ int main() .SH 関連項目 \fBbsearch\fP(3), \fBlsearch\fP(3), \fBmalloc\fP(3), \fBtsearch\fP(3) .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/hypot.3 b/release/man3/hypot.3 index c66eafab..d4a29937 100644 --- a/release/man3/hypot.3 +++ b/release/man3/hypot.3 @@ -115,6 +115,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠し .SH 関連項目 \fBcabs\fP(3), \fBsqrt\fP(3) .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/iconv.3 b/release/man3/iconv.3 index 992f72b1..e0df9eb2 100644 --- a/release/man3/iconv.3 +++ b/release/man3/iconv.3 @@ -111,6 +111,6 @@ POSIX.1\-2001. .SH 関連項目 \fBiconv_close\fP(3), \fBiconv_open\fP(3) .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/iconv_close.3 b/release/man3/iconv_close.3 index 06fa1601..7a74906c 100644 --- a/release/man3/iconv_close.3 +++ b/release/man3/iconv_close.3 @@ -37,6 +37,6 @@ UNIX98, POSIX.1\-2001. .SH 関連項目 \fBiconv\fP(3), \fBiconv_open\fP(3) .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/iconv_open.3 b/release/man3/iconv_open.3 index c5703685..569b6ed1 100644 --- a/release/man3/iconv_open.3 +++ b/release/man3/iconv_open.3 @@ -33,9 +33,11 @@ iconv_open \- 文字セット変換のためのディスクリプタを割り当 \fBiconv_open\fP() 関数は、文字エンコーディング \fIfromcode\fP から 文字エンコーディング \fItocode\fP へのバイト文字列変換に適した 変換ディスクリプタを割り当てる。 .PP -\fIfromcode\fP と \fItocode\fP に使うことのできる値と、 サポートされる組み合わせは、システムに依存する。 GNU C -ライブラリでは、使うことのできる値は \fBiconv \-\-list\fP コマンドでリストされ、 リストされたすべての値の組み合わせがサポートされる。 -さらに、 GNU C ライブラリと GNU libiconv ライブラリでは、 以下の接尾辞がサポートされている。 +The values permitted for \fIfromcode\fP and \fItocode\fP and the supported +combinations are system\-dependent. For the GNU C library, the permitted +values are listed by the \fIiconv \-\-list\fP command, and all combinations of +the listed values are supported. Furthermore the GNU C library and the GNU +libiconv library support the following two suffixes: .TP //TRANSLIT \fItocode\fP の後ろに文字列 "//TRANSLIT" が付いている場合、 翻訳 (transliteration) が有効になる。この場合、 @@ -65,6 +67,6 @@ UNIX98, POSIX.1\-2001. .SH 関連項目 \fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3) .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/if_nameindex.3 b/release/man3/if_nameindex.3 new file mode 100644 index 00000000..05576d07 --- /dev/null +++ b/release/man3/if_nameindex.3 @@ -0,0 +1,120 @@ +.\" Copyright (c) 2012 YOSHIFUJI Hideaki +.\" and Copyright (c) 2012 Michael Kerrisk +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of +.\" this manual under the conditions for verbatim copying, provided that +.\" the entire resulting derived work is distributed under the terms of +.\" a permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume +.\" no responsibility for errors or omissions, or for damages resulting +.\" from the use of the information contained herein. The author(s) may +.\" not have taken the same level of care in the production of this +.\" manual, which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH IF_NAMEINDEX 3 2012\-11\-21 GNU "Linux Programmer's Manual" +.SH 名前 +if_nameindex, if_freenameindex \- ネットワークインターフェースの名前とインデックスを取得する +.SH 書式 +.nf +\fB#include \fP +.sp +\fBstruct if_nameindex *if_nameindex(void);\fP +\fBvoid if_freenameindex(struct if_nameindex *\fP\fIptr\fP\fB);\fP +.fi +.SH 説明 +\fBif_nameindex\fP() 関数は \fIif_nameindex\fP 構造体の配列を返す。 +各構造体にはローカルシステムのネットワークインターフェースのいずれかの情報が入る。 \fIif_nameindex\fP +構造体には少なくとも以下のフィールドがある。 +.sp +.in +4n +.nf + unsigned int if_index; /* インターフェースのインデックス (1, 2, ...) */ + char *if_name; /* NULL 終端された名前 ("eth0" など) */ +.fi +.in +.PP +\fIif_index\fP フィールドにはインターフェースのインデックスが入る。 \fIifa_name\fP フィールドは NULL +終端されたインターフェース名を指す。 配列の最後は、 \fIif_index\fP が 0 で \fIifa_name\fP が NULL のエントリで示される。 +.PP +\fBif_nameindex\fP() が返すデータ構造体は動的に確保される。 必要なくなった際には \fBif_freenameindex\fP() +で解放すべきである。 +.SH 返り値 +成功した場合には \fBif_nameindex\fP() は配列へのポインタを返す。エラー時には NULL ポインタが返され、 \fIerrno\fP +が適切に設定される。 +.SH エラー +\fBif_nameindex\fP() が失敗した場合には以下の \fIerrno\fP が設定される。 +.TP +\fBENOBUFS\fP +利用可能なリソースが十分にない。 +.PP +\fBif_nameindex\fP() は、 \fBsocket\fP(2), \fBbind\fP(2), \fBioctl\fP(2), +\fBgetsockname\fP(2), \fBrecvmsg\fP(2), \fBsendto\fP(2), \fBmalloc\fP(3) +に対して規定されているエラーのいずれかで失敗する場合がある。 +.SH バージョン +\fBif_nameindex\fP() 関数は glibc 2.1 で初めて登場したが、 glibc 2.3.4 より前のバージョンの実装では IPv4 +アドレスを持つインターフェースのみをサポートしていた。 IPv4 アドレスを持たないインターフェースがサポートされているのは、 netlink +をサポートするカーネルにおいてのみである。 +.SH 準拠 +RFC\ 3493, POSIX.1\-2001. + +この関数は BSDi 初めて登場した。 +.SH 例 +以下のプログラムはこのページで説明した関数の使い方を示している。このプログラムが生成する出力は以下のようになる。 +.in +4n +.nf +$ \fB./a.out\fP\fI +1: lo +2: wlan0 +3: em1\fP +.fi +.in +.SS プログラムのソース +.nf +#include +#include +#include +#include + +int +main(int argc, char *argv[]) +{ + struct if_nameindex *if_ni, *i; + + if_ni = if_nameindex(); + if (if_ni == NULL) { + perror("if_nameindex"); + exit(EXIT_FAILURE); + } + + for (i = if_ni; ! (i\->if_index == 0 && i\->if_name == NULL); i++) + printf("%u: %s\en", i\->if_index, i\->if_name); + + if_freenameindex(if_ni); + + exit(EXIT_SUCCESS); +} +.fi +.SH 関連項目 +\fBgetsockopt\fP(2), \fBsetsockopt\fP(2), \fBgetifaddrs\fP(3), \fBif_indextoname\fP(3), +\fBif_nametoindex\fP(3), \fBifconfig\fP(8) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man3/if_nametoindex.3 b/release/man3/if_nametoindex.3 new file mode 100644 index 00000000..76a9e560 --- /dev/null +++ b/release/man3/if_nametoindex.3 @@ -0,0 +1,70 @@ +.\" Copyright (c) 2012 YOSHIFUJI Hideaki +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of +.\" this manual under the conditions for verbatim copying, provided that +.\" the entire resulting derived work is distributed under the terms of +.\" a permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume +.\" no responsibility for errors or omissions, or for damages resulting +.\" from the use of the information contained herein. The author(s) may +.\" not have taken the same level of care in the production of this +.\" manual, which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH IF_NAMETOINDEX 3 2012\-12\-14 GNU "Linux Programmer's Manual" +.SH 名前 +if_nametoindex, if_indextoname \- ネットワークインターフェースの名前とインデックスのマッピングを行う +.SH 書式 +.nf +\fB#include \fP +.sp +\fBunsigned int if_nametoindex(const char *\fP\fIifname\fP\fB);\fP +.sp +\fBchar *if_indextoname(unsigned int ifindex, char *\fP\fIifname\fP\fB);\fP +.fi +.SH 説明 +\fBif_nametoindex\fP() 関数は、 名前が \fIifname\fP のネットワークインターフェースのインデックスを返す。 + +\fBif_indextoname\fP() 関数は、 インターフェースのインデックスが \fIifindex\fP +に対応するネットワークインターフェースの名前を返す。 名前は \fIifname\fP が指すバッファに格納される。 バッファは少なくとも +\fBIF_NAMESIZE\fP バイトの領域が必要である。 +.SH 返り値 +成功した場合、 \fBif_nametoindex\fP() はネットワークインターフェースのインデックス番号を返す。エラーの場合、 0 を返し、 +\fIerrno\fP を適切に設定にする。 + +成功した場合には \fBif_indextoname\fP() は \fIifname\fP を返す。エラー時には NULL が返され、 \fIerrno\fP +が適切に設定される。 +.SH エラー +\fBif_indextoname\fP() は以下の \fIerrno\fP で失敗する場合がある。 +.TP +\fBENXIO\fP +インデックスに対応するインターフェースがない。 +.PP +\fBif_nametoindex\fP() と \fBif_indextoname\fP() は、 \fBsocket\fP(2) と \fBioctl\fP(2) +に対して規定されているエラーのいずれかで失敗する場合がある。 +.SH 準拠 +RFC\ 3493, POSIX.1\-2001. + +この関数は BSDi 初めて登場した。 +.SH 関連項目 +\fBgetifaddrs\fP(3), \fBif_nameindex\fP(3), \fBifconfig\fP(8) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man3/ilogb.3 b/release/man3/ilogb.3 index 314b3798..67ca618b 100644 --- a/release/man3/ilogb.3 +++ b/release/man3/ilogb.3 @@ -120,6 +120,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBlog\fP(3), \fBlogb\fP(3), \fBsignificand\fP(3) .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/index.3 b/release/man3/index.3 index 95339ba1..3b719fe0 100644 --- a/release/man3/index.3 +++ b/release/man3/index.3 @@ -60,6 +60,6 @@ index, rindex \- 文字列中の文字の位置を示す \fBmemchr\fP(3), \fBstrchr\fP(3), \fBstring\fP(3), \fBstrpbrk\fP(3), \fBstrrchr\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBstrtok\fP(3) .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/inet.3 b/release/man3/inet.3 index 3486d2aa..c3b2625a 100644 --- a/release/man3/inet.3 +++ b/release/man3/inet.3 @@ -200,6 +200,6 @@ main(int argc, char *argv[]) \fBgetnetent\fP(3), \fBinet_ntop\fP(3), \fBinet_pton\fP(3), \fBhosts\fP(5), \fBnetworks\fP(5) .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/inet_ntop.3 b/release/man3/inet_ntop.3 index 8024187a..1a3eb508 100644 --- a/release/man3/inet_ntop.3 +++ b/release/man3/inet_ntop.3 @@ -78,6 +78,6 @@ glibc 2.2 以降では \fIsocklen_t\fP となっている。 .SH 関連項目 \fBgetnameinfo\fP(3), \fBinet\fP(3), \fBinet_pton\fP(3) .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/inet_pton.3 b/release/man3/inet_pton.3 index cbc08b48..18f236bb 100644 --- a/release/man3/inet_pton.3 +++ b/release/man3/inet_pton.3 @@ -142,6 +142,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBgetaddrinfo\fP(3), \fBinet\fP(3), \fBinet_ntop\fP(3) .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/infnan.3 b/release/man3/infnan.3 index 9fe8777d..46695bd0 100644 --- a/release/man3/infnan.3 +++ b/release/man3/infnan.3 @@ -67,6 +67,6 @@ infnan \- 無限大と無効値 (NaN) を取扱う .SH 注意 この廃止された (obsolete) 関数は、 libc4 と libc5 で提供されていたが、 glibc2 では提供されていない。 .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/initgroups.3 b/release/man3/initgroups.3 index 0ca3eaa9..b0da3fbe 100644 --- a/release/man3/initgroups.3 +++ b/release/man3/initgroups.3 @@ -74,6 +74,6 @@ SVr4, 4.3BSD. .SH 関連項目 \fBgetgroups\fP(2), \fBsetgroups\fP(2), \fBcredentials\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/insque.3 b/release/man3/insque.3 index d95c939e..db8e9ff9 100644 --- a/release/man3/insque.3 +++ b/release/man3/insque.3 @@ -84,7 +84,7 @@ _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEN .SH 準拠 POSIX.1\-2001. .SH 注意 -伝統的に (SunOS, Linux libc 4,5 では) これらの関数の引数は \fIstruct qelem +伝統的に (SunOS, Linux libc 4,5 では) これらの関数の引き数は \fIstruct qelem *\fP型であり、これは以下のように定義されている。 .in +4n @@ -218,6 +218,6 @@ main(int argc, char *argv[]) } .fi .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/intro.3 b/release/man3/intro.3 index ae962766..a9ccc684 100644 --- a/release/man3/intro.3 +++ b/release/man3/intro.3 @@ -80,6 +80,6 @@ intro \- ライブラリ関数の紹介 \fBenviron\fP(7), \fBfeature_test_macros\fP(7), \fBlibc\fP(7), \fBmath_error\fP(7), \fBpath_resolution\fP(7), \fBpthreads\fP(7), \fBsignal\fP(7), \fBstandards\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/isalpha.3 b/release/man3/isalpha.3 index 90a7033b..10690a65 100644 --- a/release/man3/isalpha.3 +++ b/release/man3/isalpha.3 @@ -147,6 +147,6 @@ C99, 4.3BSD. C89 では、これらの関数のうち \fBisascii\fP() と \fBi \fBsetlocale\fP(3), \fBtoascii\fP(3), \fBtolower\fP(3), \fBtoupper\fP(3), \fBascii\fP(7), \fBlocale\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/isatty.3 b/release/man3/isatty.3 index a5cd435d..904d14d5 100644 --- a/release/man3/isatty.3 +++ b/release/man3/isatty.3 @@ -55,6 +55,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. .SH 関連項目 \fBfstat\fP(2), \fBttyname\fP(3) .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/isgreater.3 b/release/man3/isgreater.3 index 03a53fcc..56a7442c 100644 --- a/release/man3/isgreater.3 +++ b/release/man3/isgreater.3 @@ -90,6 +90,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfpclassify\fP(3), \fBisnan\fP(3) .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/iswalnum.3 b/release/man3/iswalnum.3 index c9aabc43..b6c4825a 100644 --- a/release/man3/iswalnum.3 +++ b/release/man3/iswalnum.3 @@ -56,6 +56,6 @@ C99. .SH 関連項目 \fBisalnum\fP(3), \fBiswctype\fP(3) .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/iswalpha.3 b/release/man3/iswalpha.3 index ca5d62af..9c9375a2 100644 --- a/release/man3/iswalpha.3 +++ b/release/man3/iswalpha.3 @@ -57,6 +57,6 @@ C99. .SH 関連項目 \fBisalpha\fP(3), \fBiswctype\fP(3) .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/iswblank.3 b/release/man3/iswblank.3 index 44beade1..1ca812ac 100644 --- a/release/man3/iswblank.3 +++ b/release/man3/iswblank.3 @@ -61,6 +61,6 @@ POSIX.1\-2001. .SH 関連項目 \fBisblank\fP(3), \fBiswctype\fP(3) .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/iswcntrl.3 b/release/man3/iswcntrl.3 index 897e9486..53f71dc8 100644 --- a/release/man3/iswcntrl.3 +++ b/release/man3/iswcntrl.3 @@ -45,6 +45,6 @@ C99. .SH 関連項目 \fBiscntrl\fP(3), \fBiswctype\fP(3) .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/iswctype.3 b/release/man3/iswctype.3 index a6121e23..7a6bae25 100644 --- a/release/man3/iswctype.3 +++ b/release/man3/iswctype.3 @@ -45,6 +45,6 @@ C99. \fBiswpunct\fP(3), \fBiswspace\fP(3), \fBiswupper\fP(3), \fBiswxdigit\fP(3), \fBwctype\fP(3) .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/iswdigit.3 b/release/man3/iswdigit.3 index ffc63334..f585269e 100644 --- a/release/man3/iswdigit.3 +++ b/release/man3/iswdigit.3 @@ -55,6 +55,6 @@ C99. .SH 関連項目 \fBisdigit\fP(3), \fBiswctype\fP(3) .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/iswgraph.3 b/release/man3/iswgraph.3 index 1d8cbef1..7c826870 100644 --- a/release/man3/iswgraph.3 +++ b/release/man3/iswgraph.3 @@ -53,6 +53,6 @@ C99. .SH 関連項目 \fBisgraph\fP(3), \fBiswctype\fP(3) .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/iswlower.3 b/release/man3/iswlower.3 index bb195482..33c479ce 100644 --- a/release/man3/iswlower.3 +++ b/release/man3/iswlower.3 @@ -60,6 +60,6 @@ case)・ タイトル文字 (title case) という 3 つの "case" が含まれ .SH 関連項目 \fBislower\fP(3), \fBiswctype\fP(3), \fBtowlower\fP(3) .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/iswprint.3 b/release/man3/iswprint.3 index a5ef7b41..983479eb 100644 --- a/release/man3/iswprint.3 +++ b/release/man3/iswprint.3 @@ -44,6 +44,6 @@ C99. .SH 関連項目 \fBisprint\fP(3), \fBiswctype\fP(3) .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/iswpunct.3 b/release/man3/iswpunct.3 index e943de0a..8435c4a5 100644 --- a/release/man3/iswpunct.3 +++ b/release/man3/iswpunct.3 @@ -54,6 +54,6 @@ C99. .SH 関連項目 \fBispunct\fP(3), \fBiswctype\fP(3) .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/iswspace.3 b/release/man3/iswspace.3 index ccedb465..d316bb99 100644 --- a/release/man3/iswspace.3 +++ b/release/man3/iswspace.3 @@ -51,6 +51,6 @@ C99. .SH 関連項目 \fBisspace\fP(3), \fBiswctype\fP(3) .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/iswupper.3 b/release/man3/iswupper.3 index df4e5679..deaadc8c 100644 --- a/release/man3/iswupper.3 +++ b/release/man3/iswupper.3 @@ -60,6 +60,6 @@ case)・ タイトル文字 (title case) という 3 つの "case" が含まれ .SH 関連項目 \fBisupper\fP(3), \fBiswctype\fP(3), \fBtowupper\fP(3) .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/iswxdigit.3 b/release/man3/iswxdigit.3 index 32ee088d..3d0ac207 100644 --- a/release/man3/iswxdigit.3 +++ b/release/man3/iswxdigit.3 @@ -53,6 +53,6 @@ C99. .SH 関連項目 \fBiswctype\fP(3), \fBisxdigit\fP(3) .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/j0.3 b/release/man3/j0.3 index 3fc4c4d8..4e0ff788 100644 --- a/release/man3/j0.3 +++ b/release/man3/j0.3 @@ -116,6 +116,6 @@ _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 600 .SH 関連項目 \fBy0\fP(3) .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/key_setsecret.3 b/release/man3/key_setsecret.3 index d2054fc4..0e7eb975 100644 --- a/release/man3/key_setsecret.3 +++ b/release/man3/key_setsecret.3 @@ -54,6 +54,6 @@ DES である。 .SH 関連項目 \fBcrypt\fP(3) .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/ldexp.3 b/release/man3/ldexp.3 index cd9a159b..02312308 100644 --- a/release/man3/ldexp.3 +++ b/release/man3/ldexp.3 @@ -95,6 +95,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBfrexp\fP(3), \fBmodf\fP(3), \fBscalbln\fP(3) .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/lgamma.3 b/release/man3/lgamma.3 index 102a4674..3f00596b 100644 --- a/release/man3/lgamma.3 +++ b/release/man3/lgamma.3 @@ -114,6 +114,6 @@ glibc 2.9 とそれ以前のバージョンでは、 極エラーが発生した .SH 関連項目 \fBtgamma\fP(3) .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/lio_listio.3 b/release/man3/lio_listio.3 index f3c871c1..f5a2c3ff 100644 --- a/release/man3/lio_listio.3 +++ b/release/man3/lio_listio.3 @@ -145,6 +145,6 @@ I/O 操作の実行中は制御ブロックを変更してはならない。デ \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBaio\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/lockf.3 b/release/man3/lockf.3 index ce40545e..a2ac8ee4 100644 --- a/release/man3/lockf.3 +++ b/release/man3/lockf.3 @@ -108,6 +108,6 @@ Linux カーネルソースの \fIDocumentation/filesystems\fP ディレクト \fImandatory\-locking.txt\fP (以前のカーネルでは、これらのファイルは \fIDocumentation\fP ディレクトリ直下にあり、 \fImandatory\-locking.txt\fP は \fImandatory.txt\fP という名前であった。) .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/log.3 b/release/man3/log.3 index 660e06fa..440e488b 100644 --- a/release/man3/log.3 +++ b/release/man3/log.3 @@ -101,6 +101,6 @@ glibc 2.5 以前では、 NaN に対して \fBlog\fP() をとると、間違っ .SH 関連項目 \fBcbrt\fP(3), \fBclog\fP(3), \fBlog10\fP(3), \fBlog1p\fP(3), \fBlog2\fP(3), \fBsqrt\fP(3) .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/log10.3 b/release/man3/log10.3 index f4300472..246692ad 100644 --- a/release/man3/log10.3 +++ b/release/man3/log10.3 @@ -82,6 +82,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBcbrt\fP(3), \fBclog10\fP(3), \fBexp10\fP(3), \fBlog\fP(3), \fBlog2\fP(3), \fBsqrt\fP(3) .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/log1p.3 b/release/man3/log1p.3 index 87260cb7..887f08cc 100644 --- a/release/man3/log1p.3 +++ b/release/man3/log1p.3 @@ -116,6 +116,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBexp\fP(3), \fBexpm1\fP(3), \fBlog\fP(3) .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/log2.3 b/release/man3/log2.3 index a2dea5ca..de685a7a 100644 --- a/release/man3/log2.3 +++ b/release/man3/log2.3 @@ -83,6 +83,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD にも準拠し .SH 関連項目 \fBcbrt\fP(3), \fBclog2\fP(3), \fBlog\fP(3), \fBlog10\fP(3), \fBsqrt\fP(3) .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/logb.3 b/release/man3/logb.3 index 71386232..cd957cfd 100644 --- a/release/man3/logb.3 +++ b/release/man3/logb.3 @@ -106,6 +106,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBilogb\fP(3), \fBlog\fP(3) .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/login.3 b/release/man3/login.3 index 66b62f91..de626ea2 100644 --- a/release/man3/login.3 +++ b/release/man3/login.3 @@ -73,6 +73,6 @@ POSIX.1\-2001 にはない。 BSD 系に存在する。 .SH 関連項目 \fBgetutent\fP(3), \fButmp\fP(5) .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/longjmp.3 b/release/man3/longjmp.3 index 3998e953..209ac862 100644 --- a/release/man3/longjmp.3 +++ b/release/man3/longjmp.3 @@ -84,6 +84,6 @@ POSIX では、 \fBlongjmp\fP() がシグナルコンテキスト (signal contex .SH 関連項目 \fBsetjmp\fP(3), \fBsigsetjmp\fP(3) .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/lrint.3 b/release/man3/lrint.3 index ada14196..4d3715d8 100644 --- a/release/man3/lrint.3 +++ b/release/man3/lrint.3 @@ -95,6 +95,6 @@ C99, POSIX.1\-2001. \fBceil\fP(3), \fBfloor\fP(3), \fBlround\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), \fBround\fP(3) .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/lround.3 b/release/man3/lround.3 index 3d8f795c..366c0390 100644 --- a/release/man3/lround.3 +++ b/release/man3/lround.3 @@ -97,6 +97,6 @@ C99, POSIX.1\-2001. \fBceil\fP(3), \fBfloor\fP(3), \fBlrint\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), \fBround\fP(3) .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/lsearch.3 b/release/man3/lsearch.3 index 4ab15bb2..299e27d5 100644 --- a/release/man3/lsearch.3 +++ b/release/man3/lsearch.3 @@ -60,6 +60,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. libc には libc\-4.6.27 以降で実装されて .SH 関連項目 \fBbsearch\fP(3), \fBhsearch\fP(3), \fBtsearch\fP(3) .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/lseek64.3 b/release/man3/lseek64.3 index 864dff78..4ec4d510 100644 --- a/release/man3/lseek64.3 +++ b/release/man3/lseek64.3 @@ -120,6 +120,6 @@ lseek64 \- ファイルの 64 ビットの読み書きオフセットの位置 .SH 関連項目 \fBllseek\fP(2), \fBlseek\fP(2) .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/makecontext.3 b/release/man3/makecontext.3 index 4bdf5cce..2073cffc 100644 --- a/release/man3/makecontext.3 +++ b/release/man3/makecontext.3 @@ -168,6 +168,6 @@ main(int argc, char *argv[]) \fBsigaction\fP(2), \fBsigaltstack\fP(2), \fBsigprocmask\fP(2), \fBgetcontext\fP(3), \fBsigsetjmp\fP(3) .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/makedev.3 b/release/man3/makedev.3 index dcf73125..ebc895a1 100644 --- a/release/man3/makedev.3 +++ b/release/man3/makedev.3 @@ -68,6 +68,6 @@ glibc 2.3.3 以降では、これらは GNU 固有の 3 つの関数 .SH 関連項目 \fBmknod\fP(2), \fBstat\fP(2) .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/malloc.3 b/release/man3/malloc.3 index b26277d9..81715716 100644 --- a/release/man3/malloc.3 +++ b/release/man3/malloc.3 @@ -143,6 +143,6 @@ Linux libc の新しいバージョン (5.4.23 より後) と glibc (2.x) には \fBmalloc_info\fP(3), \fBmalloc_trim\fP(3), \fBmalloc_usable_size\fP(3), \fBmallopt\fP(3), \fBmcheck\fP(3), \fBmtrace\fP(3), \fBposix_memalign\fP(3) .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/malloc_hook.3 b/release/man3/malloc_hook.3 index 48a612ad..160f4d3d 100644 --- a/release/man3/malloc_hook.3 +++ b/release/man3/malloc_hook.3 @@ -58,10 +58,8 @@ GNU C ライブラリでは、適切なフック関数 (hook function) を指定 .SH 注意 .\" https://bugzilla.redhat.com/show_bug.cgi?id=450187 .\" http://sourceware.org/bugzilla/show_bug.cgi?id=9957 -The use of these hook functions is not safe in multithreaded programs, and -they are now deprecated. Programmers should instead preempt calls to the -relevant functions by defining and exporting functions such as "malloc" and -"free". +マルチスレッドプログラムでは、 これらのフック関数の使用は安全ではなく、 今では非推奨である。 プログラマは、 "malloc" や "free" +のような関数を定義して公開して、 関連する関数を呼び出すようにすべきである。 .SH 例 これらの変数の使い方の簡単な例を以下に示す。 .sp @@ -114,6 +112,6 @@ my_malloc_hook(size_t size, const void *caller) .SH 関連項目 \fBmallinfo\fP(3), \fBmalloc\fP(3), \fBmcheck\fP(3), \fBmtrace\fP(3) .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/malloc_stats.3 b/release/man3/malloc_stats.3 index 144345d5..80b5bbb1 100644 --- a/release/man3/malloc_stats.3 +++ b/release/man3/malloc_stats.3 @@ -38,22 +38,18 @@ malloc_stats \- メモリ割り当ての統計を表示する .SH 説明 .\" .SH VERSIONS .\" Available already in glibc 2.0, possibly earlier -The \fBmalloc_stats\fP() function prints (on standard error) statistics about -memory allocated by \fBmalloc\fP(3) and related functions. For each arena -(allocation area), this function prints the total amount of memory allocated -and the total number of bytes consumed by in\-use allocations. (These two -values correspond to the \fIarena\fP and \fIuordblks\fP fields retrieved by -\fBmallinfo\fP(3).) In addition, the function prints the sum of these two -statistics for all arenas, and the maximum number of blocks and bytes that -were ever simultaneously allocated using \fBmmap\fP(2). +\fBmalloc_stats\fP() 関数は \fBmalloc\fP(3) や関連する関数により割り当てられたメモリに関する統計を (標準エラーに) +出力する。 各領域 (割り当てエリア) について、 この関数は割り当てられているメモリの総量と現在の割り当てが使用している総バイト数を出力する +(これらの二つの値は \fBmallinfo\fP(3) で取得できる \fIarena\fP と \fIuordblks\fP フィールドに対応している)。 +また、この関数は、 すべての領域のこれら二つの統計情報の合計値と、 \fBmmap\fP(2) +を使って同時に割り当てられたブロック数とバイト数の最大値を表示する。 .SH 準拠 この関数は GNU による拡張である。 .SH 注意 -More detailed information about memory allocations in the main arena can be -obtained using \fBmallinfo\fP(3). +\fBmallinfo\fP(3) を使用すると、 メイン領域のメモリ割り当てに関するより詳細な情報を取得できる。 .SH 関連項目 \fBmmap\fP(2), \fBmallinfo\fP(3), \fBmalloc\fP(3), \fBmalloc_info\fP(3), \fBmallopt\fP(3) .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/matherr.3 b/release/man3/matherr.3 index b6ea4429..0f12ddab 100644 --- a/release/man3/matherr.3 +++ b/release/man3/matherr.3 @@ -357,6 +357,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBfenv\fP(3), \fBmath_error\fP(7), \fBstandards\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/mblen.3 b/release/man3/mblen.3 index 14c6de03..e50c7919 100644 --- a/release/man3/mblen.3 +++ b/release/man3/mblen.3 @@ -18,7 +18,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MBLEN 3 1999\-07\-25 GNU "Linux Programmer's Manual" +.TH MBLEN 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 mblen \- 次のマルチバイト文字のバイト数を返す .SH 書式 @@ -45,6 +45,9 @@ mblen \- 次のマルチバイト文字のバイト数を返す .SH 返り値 \fBmblen\fP() 関数は \fIs\fP から始まるマルチバイト列を検査して ナルワイド文字以外を確認した場合にはそのバイト数を返す。 ナルワイド文字を確認した場合にはゼロを返す。不正なマルチバイト列に 遭遇した場合や完全なマルチバイト文字を解析できなかった場合には \-1 を返す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +\fBmblen\fP() 関数はスレッドセーフではない。 .SH 準拠 C99. .SH 注意 @@ -54,6 +57,6 @@ C99. .SH 関連項目 \fBmbrlen\fP(3) .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/mbrlen.3 b/release/man3/mbrlen.3 index a0c4acb6..140f47bb 100644 --- a/release/man3/mbrlen.3 +++ b/release/man3/mbrlen.3 @@ -18,7 +18,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MBRLEN 3 1999\-07\-25 GNU "Linux Programmer's Manual" +.TH MBRLEN 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 mbrlen \- 次のマルチバイト文字の長さをバイト数で返す .SH 書式 @@ -44,6 +44,10 @@ mbrlen \- 次のマルチバイト文字の長さをバイト数で返す ナルワイド文字が確認された場合にはゼロを返す。 不正なマルチバイト列に遭遇した場合には \fI(size_t)\ \-1\fP を返し \fIerrno\fP に \fBEILSEQ\fP を設定する。 完全なマルチバイト文字を解析できなかった場合には \fI(size_t)\ \-2\fP を返す。 これは \fIn\fP を増さなければならないことを意味する。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBmbrlen\fP() function is thread\-safe with exceptions. It is not +thread\-safe if called with a NULL \fIps\fP parameter. .SH 準拠 C99. .SH 注意 @@ -51,6 +55,6 @@ C99. .SH 関連項目 \fBmbrtowc\fP(3) .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/mbrtowc.3 b/release/man3/mbrtowc.3 index 26eb04ae..4e95ef55 100644 --- a/release/man3/mbrtowc.3 +++ b/release/man3/mbrtowc.3 @@ -19,7 +19,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MBRTOWC 3 2011\-09\-28 GNU "Linux Programmer's Manual" +.TH MBRTOWC 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 mbrtowc \- マルチバイト列をワイド文字に変換する .SH 書式 @@ -62,6 +62,10 @@ L\(aq\e0\(aq 以外のワイド文字を認識した場合には \fBmbrtowc\fP() から始まるマルチバイト列から解析したバイト数を返す。 L\(aq\e0\(aq ワイド文字を認識した場合には 0 を返す。 不正なマルチバイト列に遭遇した場合には \fI(size_t)\ \-1\fP を返し、 \fIerrno\fP に \fBEILSEQ\fP を設定する。完全なマルチバイト文字を 解析できなかった場合には \fI(size_t)\ \-2\fP を返し \fIn\fP を増加させる必要があることを示す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBmbrtowc\fP() function is thread\-safe with exceptions. It is not +thread\-safe if called with a NULL \fIps\fP parameter. .SH 準拠 C99. .SH 注意 @@ -69,6 +73,6 @@ C99. .SH 関連項目 \fBmbsrtowcs\fP(3) .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/mbsinit.3 b/release/man3/mbsinit.3 index ea8ec956..c05fbd46 100644 --- a/release/man3/mbsinit.3 +++ b/release/man3/mbsinit.3 @@ -63,6 +63,6 @@ C99. .SH 関連項目 \fBmbsrtowcs\fP(3), \fBwcsrtombs\fP(3) .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/mbsnrtowcs.3 b/release/man3/mbsnrtowcs.3 index a5d810ec..73c06bee 100644 --- a/release/man3/mbsnrtowcs.3 +++ b/release/man3/mbsnrtowcs.3 @@ -85,6 +85,6 @@ POSIX.1\-2008. .SH 関連項目 \fBiconv\fP(3), \fBmbsrtowcs\fP(3) .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/mbsrtowcs.3 b/release/man3/mbsrtowcs.3 index 855847f9..3d1310f8 100644 --- a/release/man3/mbsrtowcs.3 +++ b/release/man3/mbsrtowcs.3 @@ -65,6 +65,6 @@ C99. .SH 関連項目 \fBiconv\fP(3), \fBmbsnrtowcs\fP(3), \fBmbstowcs\fP(3) .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/mbstowcs.3 b/release/man3/mbstowcs.3 index 7aa67b79..acfafc94 100644 --- a/release/man3/mbstowcs.3 +++ b/release/man3/mbstowcs.3 @@ -58,6 +58,6 @@ C99. .SH 関連項目 \fBmbsrtowcs\fP(3), \fBwcstombs\fP(3) .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/mbtowc.3 b/release/man3/mbtowc.3 index b2975815..fc2279cb 100644 --- a/release/man3/mbtowc.3 +++ b/release/man3/mbtowc.3 @@ -58,6 +58,6 @@ C99. .SH 関連項目 \fBMB_CUR_MAX\fP(3), \fBmbrtowc\fP(3), \fBmbstowcs\fP(3) .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/memccpy.3 b/release/man3/memccpy.3 index 835daf4a..a68f278f 100644 --- a/release/man3/memccpy.3 +++ b/release/man3/memccpy.3 @@ -54,6 +54,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. .SH 関連項目 \fBbcopy\fP(3), \fBmemcpy\fP(3), \fBmemmove\fP(3), \fBstrcpy\fP(3), \fBstrncpy\fP(3) .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/memchr.3 b/release/man3/memchr.3 index 52319b64..cd54fea0 100644 --- a/release/man3/memchr.3 +++ b/release/man3/memchr.3 @@ -94,6 +94,6 @@ char *p = rawmemchr(s,\ \(aq\e0\(aq); \fBffs\fP(3), \fBindex\fP(3), \fBrindex\fP(3), \fBstrchr\fP(3), \fBstrpbrk\fP(3), \fBstrrchr\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBwmemchr\fP(3) .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/memcmp.3 b/release/man3/memcmp.3 index 6e5f8b1d..0a505ae7 100644 --- a/release/man3/memcmp.3 +++ b/release/man3/memcmp.3 @@ -48,15 +48,14 @@ char\fP として解釈される)。 \fBmemcmp\fP() 関数は、\fIs1\fP の最初の \fIn\fP バイトが \fIs2\fP の最初の \fIn\fP バイトよりも 小さいか、同じか、あるいは大きいかによってそれぞれ、負の整数、0、 正の整数を返す。 -For a nonzero return value, the sign is determined by the sign of the -difference between the first pair of bytes (interpreted as \fIunsigned char\fP) -that differ in \fIs1\fP and \fIs2\fP. +0 でない値の場合、 \fIs1\fP と \fIs2\fP で値が異なった最初のバイトの値の差で符号は決定される (バイトは \fIunsigned char\fP +で解釈される)。 .SH 準拠 SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. .SH 関連項目 \fBbcmp\fP(3), \fBstrcasecmp\fP(3), \fBstrcmp\fP(3), \fBstrcoll\fP(3), \fBstrncasecmp\fP(3), \fBstrncmp\fP(3), \fBwmemcmp\fP(3) .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/memcpy.3 b/release/man3/memcpy.3 index 8ef02a1b..bc0886b9 100644 --- a/release/man3/memcpy.3 +++ b/release/man3/memcpy.3 @@ -52,6 +52,6 @@ SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. \fBbcopy\fP(3), \fBmemccpy\fP(3), \fBmemmove\fP(3), \fBmempcpy\fP(3), \fBstrcpy\fP(3), \fBstrncpy\fP(3), \fBwmemcpy\fP(3) .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/memfrob.3 b/release/man3/memfrob.3 index 99ce5be0..0c08634e 100644 --- a/release/man3/memfrob.3 +++ b/release/man3/memfrob.3 @@ -56,6 +56,6 @@ memfrob \- メモリエリアの操作 (暗号化) .SH 関連項目 \fBstrfry\fP(3) .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/memmem.3 b/release/man3/memmem.3 index f2d727ea..3a622853 100644 --- a/release/man3/memmem.3 +++ b/release/man3/memmem.3 @@ -55,12 +55,13 @@ Linux のライブラリに関していうと、 libc 5.0.9 と それ以前の \fIneedle\fP と \fIhaystack\fP 引数が 入れ替わっており、 \fIneedle\fP が最初に出現する部分の最後を 示すポインタが返されていたのである。 -新旧両方の libc ライブラリが、 \fIneedle\fP が空の場合 (\fIhaystack\fP のかわりに) \fIhaystack\-1\fP\ が -返されるというバグを持っている。 そして、glibc 2.0 ではさらに悪くなっており、 \fIhaystack\fP の最後のバイトへのポインタを返す。 -これは glibc 2.1 で修正された。 +Both old and new libc's have the bug that if \fIneedle\fP is empty, +\fIhaystack\-1\fP (instead of \fIhaystack\fP) is returned. And glibc 2.0 makes it +worse, returning a pointer to the last byte of \fIhaystack\fP. This is fixed +in glibc 2.1. .SH 関連項目 \fBstrstr\fP(3) .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/memmove.3 b/release/man3/memmove.3 index 24cd7e6d..7353276f 100644 --- a/release/man3/memmove.3 +++ b/release/man3/memmove.3 @@ -53,6 +53,6 @@ SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. \fBbcopy\fP(3), \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBstrcpy\fP(3), \fBstrncpy\fP(3), \fBwmemmove\fP(3) .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/mempcpy.3 b/release/man3/mempcpy.3 index bd5f9fe5..186002bc 100644 --- a/release/man3/mempcpy.3 +++ b/release/man3/mempcpy.3 @@ -56,6 +56,6 @@ combine (void *o1, size_t s1, void *o2, size_t s2) .SH 関連項目 \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBmemmove\fP(3), \fBwmemcpy\fP(3) .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/memset.3 b/release/man3/memset.3 index e53a8f83..0d15d549 100644 --- a/release/man3/memset.3 +++ b/release/man3/memset.3 @@ -50,6 +50,6 @@ SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. .SH 関連項目 \fBbzero\fP(3), \fBswab\fP(3), \fBwmemset\fP(3) .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/mkdtemp.3 b/release/man3/mkdtemp.3 index 2084245d..db5d4bba 100644 --- a/release/man3/mkdtemp.3 +++ b/release/man3/mkdtemp.3 @@ -79,6 +79,6 @@ POSIX.1\-2008. この関数は BSD に存在する。 \fBmkdir\fP(2), \fBmkstemp\fP(3), \fBmktemp\fP(3), \fBtempnam\fP(3), \fBtmpfile\fP(3), \fBtmpnam\fP(3) .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/mkfifo.3 b/release/man3/mkfifo.3 index 765a15f9..a87ff022 100644 --- a/release/man3/mkfifo.3 +++ b/release/man3/mkfifo.3 @@ -59,8 +59,7 @@ FIFOスペシャルファイルをブロックせずに扱う方法について \fIpathname\fP の中のディレクトリの一つに対し検索(実行)許可がない。 .TP \fBEDQUOT\fP -The user's quota of disk blocks or inodes on the file system has been -exhausted. +ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。 .TP \fBEEXIST\fP \fIpathname\fP がすでに存在する。 これには \fIpathname\fP がシンボリックリンクである場合も含まれる @@ -88,6 +87,6 @@ POSIX.1\-2001. \fBmkfifo\fP(1), \fBclose\fP(2), \fBopen\fP(2), \fBread\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBwrite\fP(2), \fBmkfifoat\fP(3), \fBfifo\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/mkfifoat.3 b/release/man3/mkfifoat.3 index fb2cec71..7f53235f 100644 --- a/release/man3/mkfifoat.3 +++ b/release/man3/mkfifoat.3 @@ -89,6 +89,6 @@ POSIX.1\-2008. .SH 関連項目 \fBopenat\fP(2), \fBmkfifo\fP(3), \fBpath_resolution\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/mkstemp.3 b/release/man3/mkstemp.3 index 9be41b66..3261efc8 100644 --- a/release/man3/mkstemp.3 +++ b/release/man3/mkstemp.3 @@ -138,6 +138,6 @@ glibc2 では POSIX.1 に準拠し \fI\fP に含まれている。 .SH 関連項目 \fBmkdtemp\fP(3), \fBmktemp\fP(3), \fBtempnam\fP(3), \fBtmpfile\fP(3), \fBtmpnam\fP(3) .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/mktemp.3 b/release/man3/mktemp.3 index c261766f..5ecf4f0b 100644 --- a/release/man3/mktemp.3 +++ b/release/man3/mktemp.3 @@ -36,7 +36,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MKTEMP 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.TH MKTEMP 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 mktemp \- 他と重ならないテンポラリファイル名を作成する .SH 書式 @@ -73,7 +73,7 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOP .SH 返り値 関数 \fBmktemp\fP() は常に \fItemplate\fP を戻す。 一意な名前が作成された場合、 \fItemplate\fP の最後の 6 バイトに 他と重ならない名前 (それまでに出ていない名前) になるような値が格納される。 一意な名前が作成できなかった場合には、 \fItemplate\fP -には空文字列がセットされる。 +には空文字列がセットされ、 \fIerrno\fP にエラーを示す値がセットされる。 .SH エラー .TP \fBEINVAL\fP @@ -91,6 +91,6 @@ Single UNIX Specification に従って \fI\fP に含まれている。 .SH 関連項目 \fBmkstemp\fP(3), \fBtempnam\fP(3), \fBtmpfile\fP(3), \fBtmpnam\fP(3) .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/modf.3 b/release/man3/modf.3 index 8451656f..d36f6620 100644 --- a/release/man3/modf.3 +++ b/release/man3/modf.3 @@ -35,7 +35,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MODF 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH MODF 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 modf, modff, modfl \- 浮動小数点実数から、符号付き整数と小数部分を取り出す関数 .SH 書式 @@ -75,11 +75,14 @@ or \fIcc\ \-std=c99\fP \fIx\fP が正の無限大 (負の無限大) の場合、 +0 (\-0) が返され、 \fI*iptr\fP に正の無限大 (負の無限大) が設定される。 .SH エラー エラーは発生しない。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBmodf\fP(), \fBmodff\fP(), and \fBmodfl\fP() functions are thread\-safe. .SH 準拠 C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠している。 .SH 関連項目 \fBfrexp\fP(3), \fBldexp\fP(3) .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/mpool.3 b/release/man3/mpool.3 index 3c9a03e8..66d43944 100644 --- a/release/man3/mpool.3 +++ b/release/man3/mpool.3 @@ -129,6 +129,6 @@ POSIX.1\-2001 にはない。 BSD 系に存在する。 .SH 関連項目 \fBbtree\fP(3), \fBdbopen\fP(3), \fBhash\fP(3), \fBrecno\fP(3) .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/mq_close.3 b/release/man3/mq_close.3 index db3c1e1e..c6f55bc5 100644 --- a/release/man3/mq_close.3 +++ b/release/man3/mq_close.3 @@ -58,6 +58,6 @@ POSIX.1\-2001. \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_receive\fP(3), \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\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/mq_getattr.3 b/release/man3/mq_getattr.3 index 61e923b6..15def6d7 100644 --- a/release/man3/mq_getattr.3 +++ b/release/man3/mq_getattr.3 @@ -95,6 +95,6 @@ Linux では、 \fBmq_getattr\fP() と \fBmq_setattr\fP() はライブラリ \fBmq_close\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_receive\fP(3), \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\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/mq_notify.3 b/release/man3/mq_notify.3 index 9ef417c9..7c50acad 100644 --- a/release/man3/mq_notify.3 +++ b/release/man3/mq_notify.3 @@ -173,6 +173,6 @@ main(int argc, char *argv[]) \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_open\fP(3), \fBmq_receive\fP(3), \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\fP(7), \fBsigevent\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/mq_open.3 b/release/man3/mq_open.3 index d4510b90..cdc6a1a0 100644 --- a/release/man3/mq_open.3 +++ b/release/man3/mq_open.3 @@ -133,6 +133,6 @@ POSIX.1\-2001. \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_receive\fP(3), \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\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/mq_receive.3 b/release/man3/mq_receive.3 index 53c94fb7..b2260d51 100644 --- a/release/man3/mq_receive.3 +++ b/release/man3/mq_receive.3 @@ -115,6 +115,6 @@ Linux では、 \fBmq_timedreceive\fP() はシステムコールである。 \f \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\fP(7), \fBtime\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/mq_send.3 b/release/man3/mq_send.3 index 11efedc5..711bc4b1 100644 --- a/release/man3/mq_send.3 +++ b/release/man3/mq_send.3 @@ -118,6 +118,6 @@ Linux では、 \fBmq_timedsend\fP() はシステムコールである。 \fBmq \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_receive\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\fP(7), \fBtime\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/mq_unlink.3 b/release/man3/mq_unlink.3 index fd0a7079..ce666ec9 100644 --- a/release/man3/mq_unlink.3 +++ b/release/man3/mq_unlink.3 @@ -60,6 +60,6 @@ POSIX.1\-2001. \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_receive\fP(3), \fBmq_send\fP(3), \fBmq_overview\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/nan.3 b/release/man3/nan.3 index e332c2ad..a331d6b6 100644 --- a/release/man3/nan.3 +++ b/release/man3/nan.3 @@ -61,6 +61,6 @@ C99, POSIX.1\-2001. IEC 559 や推奨関数になっている IEEE 754/IEEE 854 .SH 関連項目 \fBisnan\fP(3), \fBstrtod\fP(3), \fBmath_error\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/netlink.3 b/release/man3/netlink.3 index 143d241c..2aa8859f 100644 --- a/release/man3/netlink.3 +++ b/release/man3/netlink.3 @@ -78,6 +78,6 @@ libnetlink に関しては .UR ftp://ftp.inr.ac.ru\:/ip\-routing\:/iproute2* .UE .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/nextafter.3 b/release/man3/nextafter.3 index d5eb4dc1..1252a3e3 100644 --- a/release/man3/nextafter.3 +++ b/release/man3/nextafter.3 @@ -113,6 +113,6 @@ glibc バージョン 2.5 以前では、アンダーフローが発生した際 .SH 関連項目 \fBnearbyint\fP(3) .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/nl_langinfo.3 b/release/man3/nl_langinfo.3 index 5381e51c..0e6f670b 100644 --- a/release/man3/nl_langinfo.3 +++ b/release/man3/nl_langinfo.3 @@ -111,6 +111,6 @@ main(int argc, char *argv[]) .br GNU C ライブラリ・リファレンスマニュアル .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/offsetof.3 b/release/man3/offsetof.3 index fbdf394b..10bfc282 100644 --- a/release/man3/offsetof.3 +++ b/release/man3/offsetof.3 @@ -89,6 +89,6 @@ main(void) } .fi .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/on_exit.3 b/release/man3/on_exit.3 index 07e37253..7e759ad4 100644 --- a/release/man3/on_exit.3 +++ b/release/man3/on_exit.3 @@ -66,6 +66,6 @@ return 命令による終了である。 関数 \fIfunction\fP には、直近 .SH 関連項目 \fB_exit\fP(2), \fBatexit\fP(3), \fBexit\fP(3) .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/opendir.3 b/release/man3/opendir.3 index 84fe71a0..18ff11c1 100644 --- a/release/man3/opendir.3 +++ b/release/man3/opendir.3 @@ -112,6 +112,6 @@ POSIX.1\-2008 で規定されている。 \fBopen\fP(2), \fBclosedir\fP(3), \fBdirfd\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3) .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/openpty.3 b/release/man3/openpty.3 index 9b0278e1..04a47e57 100644 --- a/release/man3/openpty.3 +++ b/release/man3/openpty.3 @@ -99,6 +99,6 @@ BSD 疑似端末ペアのオープンへと移行する。 .SH 関連項目 \fBfork\fP(2), \fBttyname\fP(3), \fBpty\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/perror.3 b/release/man3/perror.3 index 1166d484..0729e195 100644 --- a/release/man3/perror.3 +++ b/release/man3/perror.3 @@ -91,6 +91,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH 関連項目 \fBerr\fP(3), \fBerrno\fP(3), \fBerror\fP(3), \fBstrerror\fP(3) .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/popen.3 b/release/man3/popen.3 index 0e96a737..052ce53d 100644 --- a/release/man3/popen.3 +++ b/release/man3/popen.3 @@ -42,7 +42,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH POPEN 3 2010\-02\-03 GNU "Linux Programmer's Manual" +.TH POPEN 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 popen, pclose \- プロセスとの入力/出力用のパイプストリーム .SH 書式 @@ -96,7 +96,9 @@ NULL を返す。 .\" is not associated with a "popen()ed" command, if .\".I stream .\" already "pclose()d", or if -\fBpclose\fP() 関数は、 \fBwait4\fP(2) がエラーを返したり、何か他のエラーが見つかった場合、 \-1 を返す。 +The \fBpclose\fP() function returns \-1 if \fBwait4\fP(2) returns an error, or +some other error is detected. In the event of an error, these functions set +\fIerrnro\fP to indicate the cause of the error. .SH エラー \fBpopen\fP() 関数は、メモリアロケーションに失敗しても \fIerrno\fP をセットしない。 \fBpopen\fP() が中で呼び出す \fBfork\fP(2) や \fBpipe\fP(2) が失敗した場合には、 \fIerrno\fP が適切にセットされる。 引き数 \fItype\fP @@ -125,6 +127,6 @@ POSIX.1\-2001. \fBsh\fP(1), \fBfork\fP(2), \fBpipe\fP(2), \fBwait4\fP(2), \fBfclose\fP(3), \fBfflush\fP(3), \fBfopen\fP(3), \fBstdio\fP(3), \fBsystem\fP(3) .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/posix_fallocate.3 b/release/man3/posix_fallocate.3 index fc91db3a..4de34ffc 100644 --- a/release/man3/posix_fallocate.3 +++ b/release/man3/posix_fallocate.3 @@ -87,6 +87,6 @@ POSIX.1\-2008 では、 \fIlen\fP が 0 の場合、もしくは \fIoffset\fP .SH 関連項目 \fBfallocate\fP(1), \fBfallocate\fP(2), \fBlseek\fP(2), \fBposix_fadvise\fP(2) .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/posix_memalign.3 b/release/man3/posix_memalign.3 index 57b38199..551ad8c6 100644 --- a/release/man3/posix_memalign.3 +++ b/release/man3/posix_memalign.3 @@ -82,11 +82,12 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND .PD .SH 説明 .\" glibc does this: -関数 \fBposix_memalign\fP() は、 \fIsize\fP バイトのメモリを割り当て、割り当てられたメモリのアドレスを \fI*memptr\fP -に設定する。 割り当てられたメモリのアドレスは \fIalignment\fP の倍数になっているはずである。 \fIalignment\fP は 2 -のべき乗で、かつ \fIsizeof(void *)\fP の倍数でなければならない。 \fIsize\fP が 0 の場合、 -\fBposix_memalign\fP() は NULL か一意なポインタ値を返す。 このポインタ値は、後で \fBfree\fP(3) -に問題なく渡すことができる。 +The function \fBposix_memalign\fP() allocates \fIsize\fP bytes and places the +address of the allocated memory in \fI*memptr\fP. The address of the allocated +memory will be a multiple of \fIalignment\fP, which must be a power of two and +a multiple of \fIsizeof(void\ *)\fP. If \fIsize\fP is 0, then \fBposix_memalign\fP() +returns either NULL, or a unique pointer value that can later be +successfully passed to \fBfree\fP(3). .\" The behavior of memalign() for size==0 is as for posix_memalign() .\" but no standards govern this. @@ -114,7 +115,8 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND .SH エラー .TP \fBEINVAL\fP -\fIalignment\fP 引き数が 2 のべき乗でなかったか、 \fIsizeof(void *)\fP の倍数でなかった。 +The \fIalignment\fP argument was not a power of two, or was not a multiple of +\fIsizeof(void\ *)\fP. .TP \fBENOMEM\fP 割り当て要求を満たすのに十分なメモリがなかった。 @@ -177,6 +179,6 @@ glibc の \fBmalloc\fP(3) は常に 8 バイトにアラインメントされた .SH 関連項目 \fBbrk\fP(2), \fBgetpagesize\fP(2), \fBfree\fP(3), \fBmalloc\fP(3) .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/posix_openpt.3 b/release/man3/posix_openpt.3 index 2f24c020..c9e8a903 100644 --- a/release/man3/posix_openpt.3 +++ b/release/man3/posix_openpt.3 @@ -89,6 +89,6 @@ posix_openpt(int flags) \fBopen\fP(2), \fBgetpt\fP(3), \fBgrantpt\fP(3), \fBptsname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4), \fBpty\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/pow.3 b/release/man3/pow.3 index e3e0dfdf..2c01da34 100644 --- a/release/man3/pow.3 +++ b/release/man3/pow.3 @@ -181,6 +181,6 @@ glibc バージョン 2.3.2 以前では、 アンダーフローやアンダー .SH 関連項目 \fBcbrt\fP(3), \fBcpow\fP(3), \fBsqrt\fP(3) .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/pow10.3 b/release/man3/pow10.3 index 8e0c64e5..01521306 100644 --- a/release/man3/pow10.3 +++ b/release/man3/pow10.3 @@ -54,6 +54,6 @@ pow10, pow10f, pow10l \- 底が 10 の累乗関数 .SH 関連項目 \fBexp10\fP(3), \fBpow\fP(3) .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/printf.3 b/release/man3/printf.3 index e11662ac..6cd53466 100644 --- a/release/man3/printf.3 +++ b/release/man3/printf.3 @@ -303,20 +303,27 @@ NaN は文字列の先頭に `nan' をつけて表示するように規定され 関数を初期シフト状態で呼び出してマルチバイト文字列に変換し、 変換されたマルチバイト文字列を出力する。 .TP \fBs\fP -\fBl\fP 修飾子がない場合、 引き数は \fIconst char *\fP 型で文字型の配列へのポインタ (文字列へのポインタ) であることが -期待されている。配列中の文字は、終端の NULL バイト (\(aq\e0\(aq) が出てくるまで出力される (終端文字は出力されない)。 -精度が指定されていると、指定された字数以上は出力されない。 精度が指定された場合には、終端バイトが存在する必要はない。 -精度が指定されていなかったり、精度の値が配列の大きさより大きい場合には、 配列は終端の NULL バイトを含んでいなければならない。 - -\fBl\fP 修飾子が指定されている場合、 引き数は \fIconst wchar_t *\fP 型でワイド文字の配列へのポインタであることが期待されている。 -配列中のワイド文字は (1文字毎に \fBwcrtomb\fP(3) を呼び出して) マルチバイト文字に変換される (最初のワイド文字の変換の前に -\fBwcrtomb\fP() のシフト状態を初期状態に戻してから変換は行われる)。 マルチバイト文字への変換は、文字列を終端する NULL ワイド文字が -出てくるまで行われ、終端 NULL ワイド文字も含めて変換される。 結果のマルチバイト文字列は、終端の NULL バイトが出てくるまで 出力される -(終端の NULL バイトは出力されない)。 精度が指定された場合、指定されたバイト数以上には出力されない。 -但し、マルチバイト文字の一部分だけが出力されることはない。 精度は「バイト」数を指定するものであり、「ワイド文字」数や -「画面での位置」を指定するものではないことに注意。 精度が指定されていて、さらに出力が配列の末尾に達する前に出力バイト数が -精度の値を超える場合だけは、配列は NULL ワイド文字で終端されていなくてもよい。 それ以外の場合は、必ず配列は NULL -ワイド文字で終端されていなければならない。 +If no \fBl\fP modifier is present: The \fIconst char\ *\fP argument is expected to +be a pointer to an array of character type (pointer to a string). +Characters from the array are written up to (but not including) a +terminating null byte (\(aq\e0\(aq); if a precision is specified, no more +than the number specified are written. If a precision is given, no null +byte need be present; if the precision is not specified, or is greater than +the size of the array, the array must contain a terminating null byte. + +If an \fBl\fP modifier is present: The \fIconst wchar_t\ *\fP argument is expected +to be a pointer to an array of wide characters. Wide characters from the +array are converted to multibyte characters (each by a call to the +\fBwcrtomb\fP(3) function, with a conversion state starting in the initial +state before the first wide character), up to and including a terminating +null wide character. The resulting multibyte characters are written up to +(but not including) the terminating null byte. If a precision is specified, +no more bytes than the number specified are written, but no partial +multibyte characters are written. Note that the precision determines the +number of \fIbytes\fP written, not the number of \fIwide characters\fP or \fIscreen +positions\fP. The array must contain a terminating null wide character, +unless a precision is given and it is so small that the number of bytes +written exceeds it before the end of the array is reached. .TP \fBC\fP (C99 にはないが SUSv2 にはある) \fBlc\fP と同じ。使ってはならない。 @@ -325,10 +332,12 @@ NaN は文字列の先頭に `nan' をつけて表示するように規定され (C99 にはないが SUSv2 にはある) \fBls\fP と同じ。使ってはならない。 .TP \fBp\fP -\fIvoid *\fP ポインタ引き数を (\fB%#x\fP や \fB%#lx\fP のような) 16 進数で出力する。 +The \fIvoid\ *\fP pointer argument is printed in hexadecimal (as if by \fB%#x\fP +or \fB%#lx\fP). .TP \fBn\fP -これまでに出力された文字数を \fIint *\fP (または類似の型) のポインタ引き数が指す整数に保存する。 引き数の変換は行われない。 +The number of characters written so far is stored into the integer indicated +by the \fIint\ *\fP (or variant) pointer argument. No argument is converted. .TP \fBm\fP (glibc での拡張) \fIstrerror(errno)\fP の出力を表示する。引き数は必要ない。 @@ -465,8 +474,7 @@ fprintf(stdout, format, .PP 十分に大きな文字列領域を確保して、そこにメッセージを格納するには (glibc 2.0 と glibc 2.1 の両方で正しく動作するコード): .PP -If truncation occurs in glibc versions prior to 2.0.6, this is treated as an -error instead of being handled gracefully. +バージョン 2.0.6 より前の glibc で切り詰めが起こった場合、切り詰めは適切に処理されず、エラーとして扱われる。 .nf #include @@ -520,6 +528,6 @@ make_message(const char *fmt, ...) \fBprintf\fP(1), \fBasprintf\fP(3), \fBdprintf\fP(3), \fBscanf\fP(3), \fBsetlocale\fP(3), \fBwcrtomb\fP(3), \fBwprintf\fP(3), \fBlocale\fP(5) .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/profil.3 b/release/man3/profil.3 index 5236bfb5..ef091fba 100644 --- a/release/man3/profil.3 +++ b/release/man3/profil.3 @@ -34,11 +34,13 @@ .SH 名前 profil \- 実行時間プロファイル (profile) .SH 書式 +.nf \fB#include \fP .sp -\fBint profil(unsigned short *\fP\fIbuf\fP\fB, size_t \fP\fIbufsiz\fP\fB, size_t -\fP\fIoffset\fP\fB, unsigned int \fP\fIscale\fP\fB);\fP +\fBint profil(unsigned short *\fP\fIbuf\fP\fB, size_t \fP\fIbufsiz\fP\fB,\fP +\fB size_t \fP\fIoffset\fP\fB, unsigned int \fP\fIscale\fP\fB);\fP .sp +.fi .in -4n glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in @@ -62,6 +64,6 @@ SVr4 のコールに似ている (しかし POSIX.1\-2001 ではない)。 .SH 関連項目 \fBgprof\fP(1), \fBsetitimer\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2) .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/program_invocation_name.3 b/release/man3/program_invocation_name.3 index cac28a89..1141f4ac 100644 --- a/release/man3/program_invocation_name.3 +++ b/release/man3/program_invocation_name.3 @@ -54,6 +54,6 @@ Linux 独自のファイル \fI/proc/[number]/cmdline\fP でも同様の情報 .SH 関連項目 \fBproc\fP(5) .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/psignal.3 b/release/man3/psignal.3 index 6748452f..d52affc2 100644 --- a/release/man3/psignal.3 +++ b/release/man3/psignal.3 @@ -61,14 +61,11 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 文字列 \fIs\fP が NULL か空の場合、コロンとスペースは省略される。 \fIsig\fP が不正ならば、表示される メッセージは未知のシグナルを示す。 -The \fBpsiginfo\fP() function is like \fBpsignal\fP(), except that it displays -information about the signal described by \fIpinfo\fP, which should point to a -valid \fIsiginfo_t\fP structure. As well as the signal description, -\fBpsiginfo\fP() displays information about the origin of the signal, and -other information relevant to the signal (e.g., the relevant memory address -for hardware\-generated signals, the child process ID for \fBSIGCHLD\fP, and the -user ID and process ID of the sender, for signals set using \fBkill\fP(2) or -\fBsigqueue\fP(3)). +\fBpsiginfo\fP() 関数は \fBpsignal\fP() と同じだが、 \fIpinfo\fP に書かれたシグナルの情報を表示する点が異なる。 +\fIpinfo\fP は有効な \fIsiginfo_t\fP 構造体を指している必要がある。 \fBpsiginfo\fP() は、 シグナルの説明だけでなく、 +シグナルの送信元やそのシグナルに関連するその他の情報も表示する (例えば、ハードウェアが発生したシグナルの関連メモリアドレス、 \fBSIGCHLD\fP +の子プロセス ID、 \fIkill\fP(2) や \fBsigqueue\fP(3) を使って送信されたシグナルの送信元プロセスのユーザ ID とプロセス ID +など)。 配列 \fIsys_siglist\fP はシグナルを説明する文字列を保持しており、 配列へのアクセスにはシグナル番号を添え字として用いる事ができる。 .SH 返り値 @@ -82,14 +79,14 @@ POSIX.1\-2008, 4.3BSD. .IP * 3 .\" FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=12107 .\" Reportedly now fixed; check glibc 2.13 -In some circumstances, a trailing newline is not printed. +特定の状況で、末尾の改行が出力されない。 .IP * .\" FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=12108 .\" Reportedly now fixed; check glibc 2.13 -Additional details are not displayed for real\-time signals. +リアルタイムシグナルの場合に、追加の詳細情報が表示されない。 .SH 関連項目 \fBsigaction\fP(2), \fBperror\fP(3), \fBstrsignal\fP(3), \fBsignal\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_init.3 b/release/man3/pthread_attr_init.3 index 30714b7e..c5f583ad 100644 --- a/release/man3/pthread_attr_init.3 +++ b/release/man3/pthread_attr_init.3 @@ -291,6 +291,6 @@ main(int argc, char *argv[]) \fBpthread_attr_setstackaddr\fP(3), \fBpthread_attr_setstacksize\fP(3), \fBpthread_create\fP(3), \fBpthread_getattr_np\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_setaffinity_np.3 b/release/man3/pthread_attr_setaffinity_np.3 index 8672b068..4a3785e1 100644 --- a/release/man3/pthread_attr_setaffinity_np.3 +++ b/release/man3/pthread_attr_setaffinity_np.3 @@ -100,6 +100,6 @@ CPU 集合の操作や取得を行う際に利用できるマクロ群の説明 \fBsched_setaffinity\fP(2), \fBpthread_attr_init\fP(3), \fBpthread_setaffinity_np\fP(3), \fBcpuset\fP(7), \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_setdetachstate.3 b/release/man3/pthread_attr_setdetachstate.3 index 5b96ea12..5b43165a 100644 --- a/release/man3/pthread_attr_setdetachstate.3 +++ b/release/man3/pthread_attr_setdetachstate.3 @@ -91,6 +91,6 @@ detached 状態で作成されたスレッドのスレッド ID を指定して \fBpthread_attr_init\fP(3), \fBpthread_create\fP(3), \fBpthread_detach\fP(3), \fBpthread_join\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_setguardsize.3 b/release/man3/pthread_attr_setguardsize.3 index f002f6e2..f7dcda17 100644 --- a/release/man3/pthread_attr_setguardsize.3 +++ b/release/man3/pthread_attr_setguardsize.3 @@ -127,6 +127,6 @@ POSIX.1 で求められている通りの動作で、 \fBpthread_attr_setstack\fP(3), \fBpthread_attr_setstacksize\fP(3), \fBpthread_create\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_setschedparam.3 b/release/man3/pthread_attr_setschedparam.3 index e59786bb..166ab74f 100644 --- a/release/man3/pthread_attr_setschedparam.3 +++ b/release/man3/pthread_attr_setschedparam.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PTHREAD_ATTR_SETSCHEDPARAM 3 2012\-03\-15 Linux "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSCHEDPARAM 3 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 pthread_attr_setschedparam, pthread_attr_getschedparam \- スレッド属性オブジェクトのスケジューリングパラメータ属性の設定/取得を行う @@ -67,6 +67,11 @@ struct sched_param { 見て分かる通り、サポートされているスケジューリングパラメータは一つだけ である。各スケジューリングポリシーで許可されるスケジューリング優先度の 詳細については、\fBsched_setscheduler\fP(2) を参照のこと。 + +In order for the parameter setting made by \fBpthread_attr_setschedparam\fP() +to have effect when calling \fBpthread_create\fP(3), the caller must use +\fBpthread_attr_setinheritsched\fP(3) to set the inherit\-scheduler attribute +of the attributes object \fIattr\fP to \fBPTHREAD_EXPLICIT_SCHED\fP. .SH 返り値 成功すると、これらの関数は 0 を返す。 エラーの場合、0 以外のエラー番号を返す。 @@ -94,6 +99,6 @@ Linux でサポートされているスレッドのスケジューリングポ \fBpthread_attr_setschedpolicy\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_setschedpolicy.3 b/release/man3/pthread_attr_setschedpolicy.3 index 47f8e991..ec517ce2 100644 --- a/release/man3/pthread_attr_setschedpolicy.3 +++ b/release/man3/pthread_attr_setschedpolicy.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PTHREAD_ATTR_SETSCHEDPOLICY 3 2010\-02\-03 Linux "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSCHEDPOLICY 3 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 pthread_attr_setschedpolicy, pthread_attr_getschedpolicy \- スレッド属性 オブジェクトのスケジューリングポリシー属性の設定/取得を行う @@ -58,6 +58,11 @@ pthread_attr_setschedpolicy, pthread_attr_getschedpolicy \- スレッド属性 \fBpthread_attr_getschedpolicy\fP() は、 スレッド属性オブジェクト \fIattr\fP のスケジューリングポリシー属性を \fIpolicy\fP が指すバッファに入れて返す。 + +In order for the policy setting made by \fBpthread_attr_setschedpolicy\fP() to +have effect when calling \fBpthread_create\fP(3), the caller must use +\fBpthread_attr_setinheritsched\fP(3) to set the inherit\-scheduler attribute +of the attributes object \fIattr\fP to \fBPTHREAD_EXPLICIT_SCHED\fP. .SH 返り値 成功すると、これらの関数は 0 を返す。 エラーの場合、0 以外のエラー番号を返す。 @@ -84,6 +89,6 @@ POSIX.1\-2001. \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 6bee94fc..ea0fa84e 100644 --- a/release/man3/pthread_attr_setscope.3 +++ b/release/man3/pthread_attr_setscope.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PTHREAD_ATTR_SETSCOPE 3 2008\-10\-24 Linux "Linux Programmer's Manual" +.TH PTHREAD_ATTR_SETSCOPE 3 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 pthread_attr_setscope, pthread_attr_getscope \- スレッド属性オブジェクトの contention scope 属性の設定/取得を行う @@ -66,11 +66,15 @@ POSIX.1\-2001 では、これらのスレッドがシステム上の他のプロ された他のスレッドとどのようにリソースを取り合うかは、 規定されないままになっている。 .PP -POSIX.1\-2001 で求められているのは、スレッド実装がこれらの contention -scope のうち 1 つをサポートすることだけであるが、 -両方をサポートすることも認めている。 -Linux は \fBPTHREAD_SCOPE_SYSTEM\fP をサポートしているが、 -\fBPTHREAD_SCOPE_PROCESS\fP はサポートしていない。 +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. + +On systems that support multiple contention scopes, then, in order for the +parameter setting made by \fBpthread_attr_setscope\fP() to have effect when +calling \fBpthread_create\fP(3), the caller must use +\fBpthread_attr_setinheritsched\fP(3) to set the inherit\-scheduler attribute +of the attributes object \fIattr\fP to \fBPTHREAD_EXPLICIT_SCHED\fP. \fBpthread_attr_getscope\fP() は、 スレッド属性オブジェクト \fIattr\fP の contention scope 属性を @@ -105,6 +109,6 @@ POSIX.1\-2001 では、 contention scope 属性のデフォルト値は \fBpthread_attr_setinheritsched\fP(3), \fBpthread_attr_setschedparam\fP(3), \fBpthread_attr_setschedpolicy\fP(3), \fBpthread_create\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_setstack.3 b/release/man3/pthread_attr_setstack.3 index 85988985..caa67688 100644 --- a/release/man3/pthread_attr_setstack.3 +++ b/release/man3/pthread_attr_setstack.3 @@ -126,6 +126,6 @@ guard size の値は無視される。 \fBpthread_attr_setguardsize\fP(3), \fBpthread_attr_setstackaddr\fP(3), \fBpthread_attr_setstacksize\fP(3), \fBpthread_create\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_setstackaddr.3 b/release/man3/pthread_attr_setstackaddr.3 index 54e60f11..cbaaf688 100644 --- a/release/man3/pthread_attr_setstackaddr.3 +++ b/release/man3/pthread_attr_setstackaddr.3 @@ -86,6 +86,6 @@ POSIX.1\-2008 では、これらの関数の規定は削除されている。 \fBpthread_attr_init\fP(3), \fBpthread_attr_setstack\fP(3), \fBpthread_attr_setstacksize\fP(3), \fBpthread_create\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_setstacksize.3 b/release/man3/pthread_attr_setstacksize.3 index a8e95cef..fa0df13d 100644 --- a/release/man3/pthread_attr_setstacksize.3 +++ b/release/man3/pthread_attr_setstacksize.3 @@ -93,6 +93,6 @@ POSIX.1\-2001 では、割り当てらたスタックの大きさは \fBgetrlimit\fP(2), \fBpthread_attr_init\fP(3), \fBpthread_attr_setguardsize\fP(3), \fBpthread_attr_setstack\fP(3), \fBpthread_create\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_cancel.3 b/release/man3/pthread_cancel.3 index 1c695ebd..cd30014c 100644 --- a/release/man3/pthread_cancel.3 +++ b/release/man3/pthread_cancel.3 @@ -197,6 +197,6 @@ main(void) \fBpthread_join\fP(3), \fBpthread_key_create\fP(3), \fBpthread_setcancelstate\fP(3), \fBpthread_setcanceltype\fP(3), \fBpthread_testcancel\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_cleanup_push.3 b/release/man3/pthread_cleanup_push.3 index 7199f62b..8038c2ff 100644 --- a/release/man3/pthread_cleanup_push.3 +++ b/release/man3/pthread_cleanup_push.3 @@ -262,6 +262,6 @@ main(int argc, char *argv[]) \fBpthread_cancel\fP(3), \fBpthread_cleanup_push_defer_np\fP(3), \fBpthread_setcancelstate\fP(3), \fBpthread_testcancel\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_cleanup_push_defer_np.3 b/release/man3/pthread_cleanup_push_defer_np.3 index 35fc793e..17e002f5 100644 --- a/release/man3/pthread_cleanup_push_defer_np.3 +++ b/release/man3/pthread_cleanup_push_defer_np.3 @@ -101,6 +101,6 @@ pthread_cleanup_pop(execute); \fBpthread_cancel\fP(3), \fBpthread_cleanup_push\fP(3), \fBpthread_setcancelstate\fP(3), \fBpthread_testcancel\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_create.3 b/release/man3/pthread_create.3 index 363fc786..9adf0883 100644 --- a/release/man3/pthread_create.3 +++ b/release/man3/pthread_create.3 @@ -159,7 +159,7 @@ pthreads API の他のいろいろな関数の使用例を示している。 .in +4n .nf $\fB ulimit \-s\fP -8192 # The stack size limit is 8 MB (0x80000 bytes) +8192 # The stack size limit is 8 MB (0x800000 bytes) $\fB ./a.out hola salut servus\fP Thread 1: top of stack near 0xb7dd03b8; argv_string=hola Thread 2: top of stack near 0xb75cf3b8; argv_string=salut @@ -321,6 +321,6 @@ main(int argc, char *argv[]) \fBpthread_getattr_np\fP(3), \fBpthread_join\fP(3), \fBpthread_self\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_detach.3 b/release/man3/pthread_detach.3 index ee135a03..93e67d7f 100644 --- a/release/man3/pthread_detach.3 +++ b/release/man3/pthread_detach.3 @@ -86,6 +86,6 @@ detached 属性は、スレッドが終了した際のシステムの動作を \fBpthread_attr_setdetachstate\fP(3), \fBpthread_cancel\fP(3), \fBpthread_create\fP(3), \fBpthread_exit\fP(3), \fBpthread_join\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_equal.3 b/release/man3/pthread_equal.3 index 5787e5ae..5a7a91b9 100644 --- a/release/man3/pthread_equal.3 +++ b/release/man3/pthread_equal.3 @@ -56,6 +56,6 @@ POSIX.1\-2001. .SH 関連項目 \fBpthread_create\fP(3), \fBpthread_self\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_exit.3 b/release/man3/pthread_exit.3 index 173a54b0..00318244 100644 --- a/release/man3/pthread_exit.3 +++ b/release/man3/pthread_exit.3 @@ -92,6 +92,6 @@ POSIX.1\-2001. .SH 関連項目 \fBpthread_create\fP(3), \fBpthread_join\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_getattr_np.3 b/release/man3/pthread_getattr_np.3 index 1a0c0fca..4da0028c 100644 --- a/release/man3/pthread_getattr_np.3 +++ b/release/man3/pthread_getattr_np.3 @@ -342,6 +342,6 @@ main(int argc, char *argv[]) \fBpthread_attr_getstackaddr\fP(3), \fBpthread_attr_getstacksize\fP(3), \fBpthread_attr_init\fP(3), \fBpthread_create\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_getcpuclockid.3 b/release/man3/pthread_getcpuclockid.3 index d00ef736..70a01844 100644 --- a/release/man3/pthread_getcpuclockid.3 +++ b/release/man3/pthread_getcpuclockid.3 @@ -165,6 +165,6 @@ main(int argc, char *argv[]) \fBclock_gettime\fP(2), \fBclock_settime\fP(2), \fBtimer_create\fP(2), \fBclock_getcpuclockid\fP(3), \fBpthread_self\fP(3), \fBpthreads\fP(7), \fBtime\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_join.3 b/release/man3/pthread_join.3 index c2d20dcf..9233ebda 100644 --- a/release/man3/pthread_join.3 +++ b/release/man3/pthread_join.3 @@ -102,6 +102,6 @@ pthreads には、 \fIwaitpid(\-1,\ &status,\ 0)\fP、つまり \fBpthread_cancel\fP(3), \fBpthread_create\fP(3), \fBpthread_detach\fP(3), \fBpthread_exit\fP(3), \fBpthread_tryjoin_np\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_kill.3 b/release/man3/pthread_kill.3 index d217be15..53ced39c 100644 --- a/release/man3/pthread_kill.3 +++ b/release/man3/pthread_kill.3 @@ -69,6 +69,6 @@ POSIX.1\-2001. \fBkill\fP(2), \fBsigaction\fP(2), \fBsigpending\fP(2), \fBpthread_self\fP(3), \fBpthread_sigmask\fP(3), \fBraise\fP(3), \fBpthreads\fP(7), \fBsignal\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_kill_other_threads_np.3 b/release/man3/pthread_kill_other_threads_np.3 index e4794c43..c1249198 100644 --- a/release/man3/pthread_kill_other_threads_np.3 +++ b/release/man3/pthread_kill_other_threads_np.3 @@ -65,6 +65,6 @@ NPTL スレッド実装では、 \fBpthread_kill_other_threads_np\fP() は存在 \fBexecve\fP(2), \fBpthread_cancel\fP(3), \fBpthread_setcancelstate\fP(3), \fBpthread_setcanceltype\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_self.3 b/release/man3/pthread_self.3 index fb374900..4b0b7859 100644 --- a/release/man3/pthread_self.3 +++ b/release/man3/pthread_self.3 @@ -71,6 +71,6 @@ pthreads 関数以外でスレッド ID を利用しようとした場合、 .SH 関連項目 \fBpthread_create\fP(3), \fBpthread_equal\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_setaffinity_np.3 b/release/man3/pthread_setaffinity_np.3 index afc5c5f7..c4640cfc 100644 --- a/release/man3/pthread_setaffinity_np.3 +++ b/release/man3/pthread_setaffinity_np.3 @@ -178,6 +178,6 @@ main(int argc, char *argv[]) \fBpthread_attr_setaffinity_np\fP(3), \fBpthread_self\fP(3), \fBsched_getcpu\fP(3), \fBcpuset\fP(7), \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_setcancelstate.3 b/release/man3/pthread_setcancelstate.3 index 8baf4284..59dc90b5 100644 --- a/release/man3/pthread_setcancelstate.3 +++ b/release/man3/pthread_setcancelstate.3 @@ -142,6 +142,6 @@ NULL 以外の値を指定するようにすべきである。 \fBpthread_cancel\fP(3), \fBpthread_cleanup_push\fP(3), \fBpthread_testcancel\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_setconcurrency.3 b/release/man3/pthread_setconcurrency.3 index 5acaa38b..b8f5c625 100644 --- a/release/man3/pthread_setconcurrency.3 +++ b/release/man3/pthread_setconcurrency.3 @@ -92,6 +92,6 @@ LinuxThreads と NPTL のどちらも 1:1 スレッド実装であり、 .SH 関連項目 \fBpthread_attr_setscope\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_setname_np.3 b/release/man3/pthread_setname_np.3 index b0004184..dff9a25f 100644 --- a/release/man3/pthread_setname_np.3 +++ b/release/man3/pthread_setname_np.3 @@ -28,9 +28,9 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PTHREAD_SETNAME_NP 3 2013\-04\-02 Linux "Linux Programmer's Manual" +.TH PTHREAD_SETNAME_NP 3 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 -pthread_setname_np, pthread_getname_np \- スレッド名のの設定/取得を行う +pthread_setname_np, pthread_getname_np \- スレッド名の設定/取得を行う .SH 書式 .nf \fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */ @@ -46,16 +46,14 @@ 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. -The \fIthread\fP argument specifies the thread whose name is to be changed; -\fIname\fP specifies the new name. +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. -The \fBpthread_getname_np\fP() function can be used to retrieve the name of -the thread. The \fIthread\fP argument specifies the thread whose name is to be -retrieved. The buffer \fIname\fP is used to return the thread name; \fIlen\fP -specifies the number of bytes available in \fIname\fP. The buffer specified by -\fIname\fP should be at least 16 characters in length. The returned thread -name in the output buffer will be null terminated. +\fBpthread_getname_np\fP() 関数を使うと、 スレッド名を取得することができる。 \fIthread\fP +引き数は名前を取得するスレッドを指定する。 バッファ \fIname\fP はスレッド名を返すのに使用される。 \fIlen\fP には \fIname\fP +の大きさをバイトで指定する。 \fIname\fP で指定されたバッファの大きさは最低でも 16 文字とすべきである。 出力バッファに返されたスレッド名は +NULL 終端される。 .SH 返り値 成功すると、これらの関数は 0 を返す。 エラーの場合、0 以外のエラー番号を返す。 @@ -63,25 +61,23 @@ name in the output buffer will be null terminated. \fBpthread_setname_np\fP() は以下のエラーで失敗する場合がある。 .TP \fBERANGE\fP -The length of the string specified pointed to by \fIname\fP exceeds the allowed -limit. +\fIname\fP で指定された文字列の長さが、許可されている上限を超えている。 .PP \fBpthread_getname_np\fP() は以下のエラーで失敗する場合がある。 .TP \fBERANGE\fP -The buffer specified by \fIname\fP and \fIlen\fP is too small to hold the thread -name. +\fIname\fP と \fIlen\fP で指定されたバッファが、 スレッド名を格納するには短かすぎる。 .PP -If either of these functions fails to open \fI/proc/self/task/[tid]/comm\fP, -then the call may fail with one of the errors described in \fBopen\fP(2). +\fI/proc/self/task/[tid]/comm\fP のオープンに失敗した場合、 これらの関数は \fBopen\fP(2) +で説明されているエラーのいずれかで失敗する。 .SH バージョン これらの関数は glibc バージョン 2.12 で初めて登場した。 .SH 準拠 これらの関数は非標準の GNU による拡張である。 .SH 注意 -\fBpthread_setname_np\fP() internally writes to the thread specific comm file -under \fI/proc\fP filesystem: \fI/proc/self/task/[tid]/comm\fP. -\fBpthread_getname_np\fP() retrieves it from the same location. +\fBpthread_setname_np\fP() は内部で \fI/proc\fP ファイルシステムのスレッド固有の comm ファイル +(\fI/proc/self/task/[tid]/comm\fP) に書き込みを行う。 \fBpthread_getname_np\fP() +はこのファイルから読み出しを行う。 .SH 例 .PP 以下のプログラムは、 \fBpthread_setname_np\fP() と \fBpthread_getname_np\fP() @@ -171,6 +167,6 @@ main(int argc, char **argv) .nh \fBprctl\fP(2), \fBpthread_create\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_setschedparam.3 b/release/man3/pthread_setschedparam.3 index 1ea8f24e..5e319a84 100644 --- a/release/man3/pthread_setschedparam.3 +++ b/release/man3/pthread_setschedparam.3 @@ -398,6 +398,6 @@ main(int argc, char *argv[]) \fBpthread_create\fP(3), \fBpthread_self\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_setschedprio.3 b/release/man3/pthread_setschedprio.3 index f14803aa..89341921 100644 --- a/release/man3/pthread_setschedprio.3 +++ b/release/man3/pthread_setschedprio.3 @@ -86,6 +86,6 @@ POSIX.1\-2001. \fBpthread_create\fP(3), \fBpthread_self\fP(3), \fBpthread_setschedparam\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_sigmask.3 b/release/man3/pthread_sigmask.3 index 9e35e8dc..5ba9733c 100644 --- a/release/man3/pthread_sigmask.3 +++ b/release/man3/pthread_sigmask.3 @@ -133,6 +133,6 @@ main(int argc, char *argv[]) \fBsigaction\fP(2), \fBsigpending\fP(2), \fBsigprocmask\fP(2), \fBpthread_create\fP(3), \fBpthread_kill\fP(3), \fBsigsetops\fP(3), \fBpthreads\fP(7), \fBsignal\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_sigqueue.3 b/release/man3/pthread_sigqueue.3 index 3d5c51b5..adc86f62 100644 --- a/release/man3/pthread_sigqueue.3 +++ b/release/man3/pthread_sigqueue.3 @@ -79,6 +79,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBrt_tgsigqueueinfo\fP(2), \fBsigaction\fP(2), \fBpthread_sigmask\fP(3), \fBsigqueue\fP(3), \fBsigwait\fP(3), \fBpthreads\fP(7), \fBsignal\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_testcancel.3 b/release/man3/pthread_testcancel.3 index c164a9c1..bd3b29af 100644 --- a/release/man3/pthread_testcancel.3 +++ b/release/man3/pthread_testcancel.3 @@ -63,6 +63,6 @@ POSIX.1\-2001. \fBpthread_cancel\fP(3), \fBpthread_cleanup_push\fP(3), \fBpthread_setcancelstate\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_tryjoin_np.3 b/release/man3/pthread_tryjoin_np.3 index 4a136465..c4fd84b1 100644 --- a/release/man3/pthread_tryjoin_np.3 +++ b/release/man3/pthread_tryjoin_np.3 @@ -112,6 +112,6 @@ struct timespec { .SH 関連項目 \fBclock_gettime\fP(2), \fBpthread_exit\fP(3), \fBpthread_join\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_yield.3 b/release/man3/pthread_yield.3 index c46e98a4..408a9bc4 100644 --- a/release/man3/pthread_yield.3 +++ b/release/man3/pthread_yield.3 @@ -60,6 +60,6 @@ Linux では、この関数は \fBsched_yield\fP(2) を呼び出す形で実装 .SH 関連項目 \fBsched_setscheduler\fP(2), \fBsched_yield\fP(2), \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/ptsname.3 b/release/man3/ptsname.3 index 9919e3e8..da6d7568 100644 --- a/release/man3/ptsname.3 +++ b/release/man3/ptsname.3 @@ -9,7 +9,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PTSNAME 3 2008\-09\-03 "" "Linux Programmer's Manual" +.TH PTSNAME 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 ptsname, ptsname_r \- スレーブ擬似端末の名前を取得する .SH 書式 @@ -51,6 +51,11 @@ NULL で終端された文字列の形で \fIbuf\fP で指定されたバッフ (\fBptsname_r\fP() のみ) \fIbuf\fP が小さすぎる。 .SH バージョン \fBptsname\fP() は、バージョン 2.1 以降の glibc で提供されている。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBptsname\fP() function is not thread\-safe. +.LP +The \fBptsname_r\fP() function is thread\-safe. .SH 準拠 \fBptsname\fP() は UNIX 98 疑似端末仕様の一部である (\fBpts\fP(4) を参照のこと)。この関数は POSIX.1\-2001 で規定されている。 @@ -62,6 +67,6 @@ NULL で終端された文字列の形で \fIbuf\fP で指定されたバッフ \fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBttyname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4), \fBpty\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/putenv.3 b/release/man3/putenv.3 index 10cb04bc..77d682b4 100644 --- a/release/man3/putenv.3 +++ b/release/man3/putenv.3 @@ -38,7 +38,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PUTENV 3 2007\-07\-26 GNU "Linux Programmer's Manual" +.TH PUTENV 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 putenv \- 環境変数の変更または追加 .SH 書式 @@ -60,7 +60,8 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fIname\fP の値は \fIvalue\fP に変更される。 \fIstring\fP が指している文字列は環境の一部となるので、 文字列を変更すると環境も変更される。 .SH 返り値 -\fBputenv\fP() 関数は、成功した場合 0 を、 エラーが発生した場合 0 以外を返す。 +\fBputenv\fP() 関数は、成功すると 0 を返し、エラーの場合は 0 以外の値を返す。エラーが発生した場合、 \fIerrno\fP +に原因を示す値が設定される。 .SH エラー .TP \fBENOMEM\fP @@ -88,6 +89,6 @@ SUSv2 ではプロトタイプから \fIconst\fP が取り除かれており、 .SH 関連項目 \fBclearenv\fP(3), \fBgetenv\fP(3), \fBsetenv\fP(3), \fBunsetenv\fP(3), \fBenviron\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/putgrent.3 b/release/man3/putgrent.3 index 2eefd9e6..4f5aeac3 100644 --- a/release/man3/putgrent.3 +++ b/release/man3/putgrent.3 @@ -41,6 +41,6 @@ struct group { .SH 関連項目 \fBfgetgrent\fP(3), \fBgetgrent\fP(3), \fBgroup\fP(5) .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/putpwent.3 b/release/man3/putpwent.3 index d3d993f4..60f1a3fe 100644 --- a/release/man3/putpwent.3 +++ b/release/man3/putpwent.3 @@ -32,7 +32,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PUTPWENT 3 2007\-07\-26 GNU "Linux Programmer's Manual" +.TH PUTPWENT 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 putpwent \- パスワードファイルエントリの書き込み .SH 書式 @@ -68,7 +68,8 @@ struct passwd { .fi .in .SH 返り値 -\fBputpwent\fP() 関数は、成功した場合は 0 を、エラーが発生した場合は \-1 を返す。 +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. .SH エラー .TP \fBEINVAL\fP @@ -79,6 +80,6 @@ SVr4. \fBendpwent\fP(3), \fBfgetpwent\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBsetpwent\fP(3) .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/puts.3 b/release/man3/puts.3 index a780ec67..25cc3abd 100644 --- a/release/man3/puts.3 +++ b/release/man3/puts.3 @@ -77,6 +77,6 @@ C89, C99. \fBfseek\fP(3), \fBfwrite\fP(3), \fBgets\fP(3), \fBputwchar\fP(3), \fBscanf\fP(3), \fBunlocked_stdio\fP(3) .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/putwchar.3 b/release/man3/putwchar.3 index c4b01ac5..48a8351f 100644 --- a/release/man3/putwchar.3 +++ b/release/man3/putwchar.3 @@ -45,6 +45,6 @@ C99. .SH 関連項目 \fBfputwc\fP(3), \fBunlocked_stdio\fP(3) .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/qecvt.3 b/release/man3/qecvt.3 index 9e08cf75..650bd403 100644 --- a/release/man3/qecvt.3 +++ b/release/man3/qecvt.3 @@ -30,7 +30,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH QECVT 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.TH QECVT 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 qecvt, qfcvt, qgcvt \- 浮動小数点数の文字列への変換 .SH 書式 @@ -54,6 +54,11 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .SH 説明 関数 \fBqecvt\fP(), \fBqfcvt\fP(), \fBqgcvt\fP() は、それぞれ \fBecvt\fP(3), \fBfcvt\fP(3), \fBgcvt\fP(3) と同じである。 引き数 \fInumber\fP が \fIlong double\fP 型である点だけが異なる。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The functions \fBqecvt\fP() and \fBqfcvt\fP() are not thread\-safe. +.LP +関数 \fBqgcvt\fP() はスレッドセーフである。 .SH 準拠 SVr4. 多くの一般的な UNIX には実装されていないが、SunOS には実装されている。 libc4 と libc5 ではサポートされていないが、 glibc ではサポートされている。 @@ -62,6 +67,6 @@ SVr4. 多くの一般的な UNIX には実装されていないが、SunOS に .SH 関連項目 \fBecvt\fP(3), \fBecvt_r\fP(3), \fBgcvt\fP(3), \fBsprintf\fP(3) .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/qsort.3 b/release/man3/qsort.3 index 5a229e69..f27df11c 100644 --- a/release/man3/qsort.3 +++ b/release/man3/qsort.3 @@ -125,6 +125,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBsort\fP(1), \fBalphasort\fP(3), \fBstrcmp\fP(3), \fBversionsort\fP(3) .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/queue.3 b/release/man3/queue.3 index 117d6d58..bdba2dfe 100644 --- a/release/man3/queue.3 +++ b/release/man3/queue.3 @@ -346,6 +346,6 @@ while (head.cqh_first != (void *)&head) .SH 準拠 POSIX.1\-2001 にはない。 BSD 系に存在する。 queue 関数は 4.4BSD で初めて登場した。 .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/raise.3 b/release/man3/raise.3 index 47bdab48..2f8c2ef5 100644 --- a/release/man3/raise.3 +++ b/release/man3/raise.3 @@ -72,6 +72,6 @@ glibc バージョン 2.3.3 以降では、カーネルが \fBtgkill\fP(2) シ \fBgetpid\fP(2), \fBkill\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBpthread_kill\fP(3), \fBsignal\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/rand.3 b/release/man3/rand.3 index b173cd44..c999c5b2 100644 --- a/release/man3/rand.3 +++ b/release/man3/rand.3 @@ -71,7 +71,7 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .PP 種の値が与えられない場合には、 \fBrand\fP() 関数は 自動的に 1 を種とする。 .PP -\fBrand\fP() 関数はリ再入可能 (reentrant) ではない、つまりスレッド・セーフではない。 +\fBrand\fP() 関数は再入可能 (reentrant) ではない、つまりスレッド・セーフではない。 この関数には隠し状態があり、呼び出される度にこの隠し状態が変更されるからである。 ちょうどこの隠し状態が次の呼び出し時の乱数の種として使われるようなものである。 実際にはもう少し複雑かもしれないが。 @@ -156,6 +156,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBdrand48\fP(3), \fBrandom\fP(3) .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/random.3 b/release/man3/random.3 index 4a29a5d6..f32f7509 100644 --- a/release/man3/random.3 +++ b/release/man3/random.3 @@ -35,7 +35,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH RANDOM 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.TH RANDOM 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 random, srandom, initstate, setstate \- 乱数を生成する関数 .SH 書式 @@ -78,12 +78,21 @@ _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOP \fBinitstate\fP() または \fBsetstate\fP() が 次に呼び出されるまで、乱数の生成に使用される。 \fIstate\fP は \fBinitstate\fP() を用いて最初に初期化されているか、 以前に呼び出した \fBsetstate\fP() の結果でなければならない。 .SH 返り値 -\fBrandom\fP() 関数は 0 と \fBRAND_MAX\fP の間の値を返す。 \fBsrandom\fP() 関数は値を返さない。 -\fBinitstate\fP() 関数は直前の状態配列へのポインタを返す。 \fBsetstate\fP() 関数は直前の状態配列へのポインタを返し、 -エラーの場合は NULL を返す。 +The \fBrandom\fP() function returns a value between 0 and \fBRAND_MAX\fP. The +\fBsrandom\fP() function returns no value. + +The \fBinitstate\fP() function returns a pointer to the previous state array. +On error, \fIerrno\fP is set to indicate the cause. + +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. .SH エラー .TP \fBEINVAL\fP +\fBsetstate\fP() の引き数 \fIstate\fP が NULL であった。 +.TP +\fBEINVAL\fP \fBinitstate\fP() で8バイトよりも小さい状態配列を指定した。 .SH 準拠 4.3BSD, POSIX.1\-2001. @@ -102,9 +111,14 @@ T. Vetterling; New York: Cambridge University Press, 2007, 3rd ed.) より理論的な議論については Donald E. Knuth の \fIThe Art of Computer Programming\fP, volume 2 (Seminumerical Algorithms), 2nd ed.; Reading, Massachusetts: Addison\-Wesley Publishing Company, 1981 の第 3 章 (乱数) を見よ。ここでは、 たくさんの実用的な話題についても深く網羅されている。 +.SH バグ +.\" http://sourceware.org/bugzilla/show_bug.cgi?id=15380 +According to POSIX, \fBinitstate\fP() should return NULL on error. In the +glibc implementation, \fIerrno\fP is (as specified) set on error, but the +function does not return NULL. .SH 関連項目 \fBdrand48\fP(3), \fBrand\fP(3), \fBrandom_r\fP(3), \fBsrand\fP(3) .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/random_r.3 b/release/man3/random_r.3 index 0512f676..11a8223c 100644 --- a/release/man3/random_r.3 +++ b/release/man3/random_r.3 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH RANDOM_R 3 2008\-03\-07 GNU "Linux Programmer's Manual" +.TH RANDOM_R 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 random_r, srandom_r, initstate_r, setstate_r \- リエントラントな 乱数生成器 .SH 書式 @@ -72,7 +72,7 @@ _SVID_SOURCE || _BSD_SOURCE \fBsetstate_r\fP() 関数は \fBsetstate\fP(3) と同様だが、大域変数で管理される状態を変更するのではなく、 \fIbuf\fP が指すオブジェクト内の状態を変更する。 .SH 返り値 -これらの関数は、成功すると 0 を返し、 エラーの場合は \-1 を返す。 +これらの関数はすべて、成功すると 0 を返す。 エラーの場合、\-1 を返し、 \fIerrno\fP にエラーの原因を示す値がセットされる。 .SH エラー .TP \fBEINVAL\fP @@ -90,6 +90,6 @@ _SVID_SOURCE || _BSD_SOURCE .SH 関連項目 \fBdrand48\fP(3), \fBrand\fP(3), \fBrandom\fP(3) .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/rcmd.3 b/release/man3/rcmd.3 index 4eb02516..50a8fe8c 100644 --- a/release/man3/rcmd.3 +++ b/release/man3/rcmd.3 @@ -166,6 +166,6 @@ POSIX.1\-2001 にはない。 BSD 系、Solaris や他の多くのシステム \fBrlogin\fP(1), \fBrsh\fP(1), \fBintro\fP(2), \fBrexec\fP(3), \fBrexecd\fP(8), \fBrlogind\fP(8), \fBrshd\fP(8) .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/re_comp.3 b/release/man3/re_comp.3 index ecfd1ac2..d1d1ce7e 100644 --- a/release/man3/re_comp.3 +++ b/release/man3/re_comp.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH RE_COMP 3 1995\-07\-14 GNU "Linux Programmer's Manual" +.TH RE_COMP 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 re_comp, re_exec \- BSD の正規表現関数 .SH 書式 @@ -54,6 +54,9 @@ re_comp, re_exec \- BSD の正規表現関数 それ以外の場合は適切なエラーメッセージへのポインタを返す。 \fBre_exec\fP() は、一致した場合 1 を、失敗した場合 0 を返す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBre_comp\fP() and \fBre_exec\fP() functions are not thread\-safe. .SH 準拠 4.3BSD. .SH 注意 @@ -61,6 +64,6 @@ re_comp, re_exec \- BSD の正規表現関数 .SH 関連項目 \fBregcomp\fP(3), \fBregex\fP(7), GNU regex manual .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/readdir.3 b/release/man3/readdir.3 index 2207be1c..54662483 100644 --- a/release/man3/readdir.3 +++ b/release/man3/readdir.3 @@ -38,7 +38,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH READDIR 3 2013\-03\-24 "" "Linux Programmer's Manual" +.TH READDIR 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 readdir, readdir_r \- ディレクトリを読み込む .SH 書式 @@ -80,9 +80,11 @@ struct dirent { .fi .in .PP -\fIdirent\fP 構造体のフィールドで POSIX.1 で要求されているのは、 \fId_name\fP[] と (XSI 拡張での) \fId_ino\fP -だけである。 \fId_name\fP[] はその大きさも規定されておらず、 このフィールドには最大で \fBNAME_MAX\fP 個の文字と、それに続く終端の -NULL バイトが格納される。 他のフィールドは非標準であり、全てのシステムに存在するわけではない。 詳細については、下記の「注意」を参照のこと。 +The only fields in the \fIdirent\fP structure that are mandated by POSIX.1 are: +\fId_name\fP[], of unspecified size, with at most \fBNAME_MAX\fP characters +preceding the terminating null byte (\(aq\e0\(aq); and (as an XSI extension) +\fId_ino\fP. The other fields are unstandardized, and not present on all +systems; see NOTES below for some further details. .PP \fBreaddir\fP() によって返されるデータは、それ以降の同じストリームに対する \fBreaddir\fP() の呼び出しによって上書きされる可能性がある。 @@ -103,6 +105,11 @@ NULL バイトが格納される。 他のフィールドは非標準であり .TP \fBEBADF\fP ディレクトリストリームディスクリプタ \fIdirp\fP が無効である。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBreaddir\fP() function is not thread\-safe. +.LP +The \fBreaddir_r\fP() function is thread\-safe. .SH 準拠 SVr4, 4.3BSD, POSIX.1\-2001. .SH 注意 @@ -175,6 +182,6 @@ entryp = malloc(len); \fBoffsetof\fP(3), \fBopendir\fP(3), \fBrewinddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3) .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/realpath.3 b/release/man3/realpath.3 index 109bd08b..5ea08509 100644 --- a/release/man3/realpath.3 +++ b/release/man3/realpath.3 @@ -155,6 +155,6 @@ libc4 と libc5 の実装はバッファ・オーバーフローの可能性を \fBreadlink\fP(2), \fBcanonicalize_file_name\fP(3), \fBgetcwd\fP(3), \fBpathconf\fP(3), \fBsysconf\fP(3) .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/recno.3 b/release/man3/recno.3 index 18e3e0d4..51e056a2 100644 --- a/release/man3/recno.3 +++ b/release/man3/recno.3 @@ -150,6 +150,6 @@ recno アクセスメソッドのファイルに関連づけられる メタデ Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. .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/regex.3 b/release/man3/regex.3 index 2c07ad14..7037a985 100644 --- a/release/man3/regex.3 +++ b/release/man3/regex.3 @@ -1,7 +1,3 @@ -.de xx -.in \\n(INu+\\$1 -.ti -\\$1 -.. .\" Copyright (C), 1995, Graeme W. Wilford. (Wilf.) .\" .\" %%%LICENSE_START(VERBATIM) @@ -186,6 +182,6 @@ POSIX.1\-2001. .br glibc マニュアルのセクション \fIRegular Expression Matching\fP .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/remainder.3 b/release/man3/remainder.3 index ce18d6cb..8285ae48 100644 --- a/release/man3/remainder.3 +++ b/release/man3/remainder.3 @@ -142,6 +142,6 @@ _SVID_SOURCE || _BSD_SOURCE .SH 関連項目 \fBdiv\fP(3), \fBfmod\fP(3), \fBremquo\fP(3) .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/remove.3 b/release/man3/remove.3 index 0e52aca0..38e06d6a 100644 --- a/release/man3/remove.3 +++ b/release/man3/remove.3 @@ -68,6 +68,6 @@ NFS プロトコルに内在する問題により、まだ使用中のファイ \fBrm\fP(1), \fBunlink\fP(1), \fBlink\fP(2), \fBmknod\fP(2), \fBopen\fP(2), \fBrename\fP(2), \fBrmdir\fP(2), \fBunlink\fP(2), \fBmkfifo\fP(3), \fBsymlink\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/remquo.3 b/release/man3/remquo.3 index 57d64dd8..8dca8ad8 100644 --- a/release/man3/remquo.3 +++ b/release/man3/remquo.3 @@ -86,6 +86,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBfmod\fP(3), \fBlogb\fP(3), \fBremainder\fP(3) .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/resolver.3 b/release/man3/resolver.3 index 179b4f91..e8e9686f 100644 --- a/release/man3/resolver.3 +++ b/release/man3/resolver.3 @@ -133,8 +133,8 @@ dn_comp, dn_expand \- レゾルバ・ルーチン \fBRES_DEBUG\fP .\" See resolv/README. .\" Support for RES_DEBUG was made conditional in glibc 2.2. -Print debugging messages. This option is available only if glibc was built -with debugging enabled, which is not the default. +デバッグ情報を表示する。このオプションは、 glibc がデバッグを有効にしてコンパイルされている場合にのみ利用できる。 デフォルトでは glibc +のデバッグは有効になっていない。 .TP \fBRES_AAONLY\fP 権威付けされた (authoritative) 回答のみ受け入れる。 \fBres_send\fP() @@ -184,6 +184,6 @@ with debugging enabled, which is not the default. \fBgethostbyname\fP(3), \fBresolv.conf\fP(5), \fBresolver\fP(5), \fBhostname\fP(7), \fBnamed\fP(8) .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/rewinddir.3 b/release/man3/rewinddir.3 index 13c3244c..98223ea6 100644 --- a/release/man3/rewinddir.3 +++ b/release/man3/rewinddir.3 @@ -54,6 +54,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3) .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/rexec.3 b/release/man3/rexec.3 index 6f6a08d0..9f88ed59 100644 --- a/release/man3/rexec.3 +++ b/release/man3/rexec.3 @@ -36,14 +36,14 @@ .\" .\" Taken from FreeBSD 5.4; not checked against Linux reality (mtk) .\" -.\" 2007-12-08, mtk, Converted from mdoc to man macros +.\" 2013-06-21, mtk, Converted from mdoc to man macros .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH REXEC 3 2012\-04\-23 Linux "Linux Programmer's Manual" +.TH REXEC 3 2013\-07\-04 Linux "Linux Programmer's Manual" .SH 名前 rexec, rexec_af \- リモートコマンドへのストリームを返す .SH 書式 @@ -87,6 +87,9 @@ rexec, rexec_af \- リモートコマンドへのストリームを返す (\fBAF_UNSPEC\fP は実装側がプロトコルを選択することを意味する)。 .SH バージョン \fBrexec_af\fP() 関数は glibc バージョン 2.9 で追加された。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBrexec\fP() and \fBrexec_af\fP() functions are not thread\-safe. .SH 準拠 これらの関数は POSIX.1\-2001 にはない。\fBrexec\fP() 関数は 4.2BSD で始めて 登場し、BSD 系、Solaris や他の多くのシステムに存在する。\fBrexec_af\fP() @@ -99,6 +102,6 @@ rexec, rexec_af \- リモートコマンドへのストリームを返す .SH 関連項目 \fBrcmd\fP(3), \fBrexecd\fP(8) .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/rint.3 b/release/man3/rint.3 index 6e023900..c00206c1 100644 --- a/release/man3/rint.3 +++ b/release/man3/rint.3 @@ -104,6 +104,6 @@ SUSv2 と POSIX.1\-2001 にはオーバーフローに関する記述があり .SH 関連項目 \fBceil\fP(3), \fBfloor\fP(3), \fBlrint\fP(3), \fBround\fP(3), \fBtrunc\fP(3) .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/round.3 b/release/man3/round.3 index f629ae14..8ddd06b0 100644 --- a/release/man3/round.3 +++ b/release/man3/round.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ROUND 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH ROUND 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 round, roundf, roundl \- 最も近い整数値に丸める (2 つの整数の中間値の場合は 0 から遠い方に丸める) .SH 書式 @@ -70,6 +70,9 @@ or \fIcc\ \-std=c99\fP エラーは発生しない。 POSIX.1\-2001 にはオーバーフローでの範囲エラー (range error) の 記載がある。「注意」の節を参照のこと。 .SH バージョン これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBround\fP(), \fBroundf\fP(), and \fBroundl\fP() functions are thread\-safe. .SH 準拠 C99, POSIX.1\-2001. .SH 注意 @@ -85,6 +88,6 @@ IEEE\-754 規格の 32 ビットと 64 ビットの浮動小数では、 指数 \fBceil\fP(3), \fBfloor\fP(3), \fBlround\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), \fBtrunc\fP(3) .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/rpc.3 b/release/man3/rpc.3 index c0bbe643..6d3ec324 100644 --- a/release/man3/rpc.3 +++ b/release/man3/rpc.3 @@ -32,12 +32,12 @@ rpc \- 遠隔手続き呼び出し(RPC)のためのライブラリ・ルーテ .in +4n .nf -typedef int \fIbool_t\fP; +\fBtypedef int \fP\fIbool_t\fP\fB;\fP -typedef bool_t (*\fIxdrproc_t\fP) (XDR *, void *, ...); +\fBtypedef bool_t (*\fP\fIxdrproc_t\fP\fB) (XDR *, void *, ...);\fP -typedef bool_t (*\fIresultproc_t\fP) (caddr_t resp, - struct sockaddr_in *raddr); +\fBtypedef bool_t (*\fP\fIresultproc_t\fP\fB) (caddr_t \fP\fIresp\fP\fB,\fP +\fB struct sockaddr_in *\fP\fIraddr\fP\fB);\fP .fi .in .LP @@ -682,6 +682,6 @@ rpcgen Programming Guide \fIRPC: Remote Procedure Call Protocol Specification\fP, RFC\ 1050, Sun Microsystems, Inc., USC\-ISI. .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/rpmatch.3 b/release/man3/rpmatch.3 index 98095222..4cc6fcef 100644 --- a/release/man3/rpmatch.3 +++ b/release/man3/rpmatch.3 @@ -101,6 +101,6 @@ main(int argc, char *argv[]) \fBfgets\fP(3), \fBgetline\fP(3), \fBnl_langinfo\fP(3), \fBregcomp\fP(3), \fBsetlocale\fP(3) .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/rtime.3 b/release/man3/rtime.3 index 2df4efc0..f176a973 100644 --- a/release/man3/rtime.3 +++ b/release/man3/rtime.3 @@ -106,6 +106,6 @@ main(void) .\" .BR rdate (1), \fBntpdate\fP(1), \fBinetd\fP(8) .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/rtnetlink.3 b/release/man3/rtnetlink.3 index 247463c1..dd5cb05f 100644 --- a/release/man3/rtnetlink.3 +++ b/release/man3/rtnetlink.3 @@ -102,6 +102,6 @@ NETLINK_ROUTE);\fP .SH 関連項目 \fBnetlink\fP(3), \fBnetlink\fP(7), \fBrtnetlink\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/scalb.3 b/release/man3/scalb.3 index 50c20970..acc17493 100644 --- a/release/man3/scalb.3 +++ b/release/man3/scalb.3 @@ -124,6 +124,6 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 .SH 関連項目 \fBldexp\fP(3), \fBscalbln\fP(3) .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/scalbln.3 b/release/man3/scalbln.3 index a84f1988..3fe00bd5 100644 --- a/release/man3/scalbln.3 +++ b/release/man3/scalbln.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SCALBLN 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH SCALBLN 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- 浮動小数点数に基数の整数乗を掛ける @@ -115,6 +115,10 @@ or \fIcc\ \-std=c99\fP これらの関数は \fIerrno\fP を設定しない。 .SH バージョン これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBscalbn\fP(), \fBscalbnf\fP(), \fBscalbnl\fP(), \fBscalbln\fP(), \fBscalblnf\fP(), +and \fBscalblnl\fP() functions are thread\-safe. .SH 準拠 C99, POSIX.1\-2001. .SH 注意 @@ -128,6 +132,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBldexp\fP(3), \fBscalb\fP(3) .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/scandir.3 b/release/man3/scandir.3 index c0c7c28b..dbec3240 100644 --- a/release/man3/scandir.3 +++ b/release/man3/scandir.3 @@ -38,7 +38,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SCANDIR 3 2012\-04\-26 GNU "Linux Programmer's Manual" +.TH SCANDIR 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 scandir, alphasort, versionsort \- ディレクトリを走査する .SH 書式 @@ -73,7 +73,9 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBalphasort\fP() は \fBstrcoll\fP(3) を用いてディレクトリエントリをソートし、 \fBversionsort\fP() は文字列 \fI(*a)\->d_name\fP と \fI(*b)\->d_name\fP に対して \fBstrverscmp\fP(3) を用いる。 .SH 返り値 -関数 \fBscandir\fP() は選択されたエントリの数か、 (エラーが発生した場合) \-1 を返す。 +The \fBscandir\fP() function returns the number of directory entries +selected. On error, \-1 is returned, with \fIerrno\fP set to indicate the cause +of the error. .PP 関数 \fBalphasort\fP() と \fBversionsort\fP() は 1 番目の引き数が 2 番目の引き数に対して、 [小さい/等しい/大きい] かに応じて、0 より [小さい/等しい/大きい] 値を返す。 @@ -136,6 +138,6 @@ main(void) \fBrewinddir\fP(3), \fBscandirat\fP(3), \fBseekdir\fP(3), \fBstrcmp\fP(3), \fBstrcoll\fP(3), \fBstrverscmp\fP(3), \fBtelldir\fP(3) .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/scandirat.3 b/release/man3/scandirat.3 index d1956973..f2dd3c6e 100644 --- a/release/man3/scandirat.3 +++ b/release/man3/scandirat.3 @@ -82,6 +82,6 @@ scandirat \- ディレクトリのファイルディスクリプタからの相 .SH 関連項目 \fBopenat\fP(2), \fBscandir\fP(3), \fBpath_resolution\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/scanf.3 b/release/man3/scanf.3 index 5bdca137..47bc7e4a 100644 --- a/release/man3/scanf.3 +++ b/release/man3/scanf.3 @@ -132,7 +132,7 @@ An optional \(aqm\(aq character. This is used with string conversions (\fI%s\fP, \fI%c\fP, \fI%[\fP), and relieves the caller of the need to allocate a corresponding buffer to hold the input: instead, \fBscanf\fP() allocates a buffer of sufficient size, and assigns the address of this buffer to the -corresponding \fIpointer\fP argument, which should be a pointer to a \fIchar *\fP +corresponding \fIpointer\fP argument, which should be a pointer to a \fIchar\ *\fP variable (this variable does not need to be initialized before the call). The caller should subsequently \fBfree\fP(3) this buffer when it is no longer required. @@ -313,9 +313,8 @@ required. これらの関数の Linux 版は \fIGNU\fP \fIlibio\fP ライブラリーを元にしている。 より簡潔な説明には \fIGNU\fP \fIlibc (glibc\-1.08)\fP の \fIinfo\fP 文書に目を通すこと。 .SH 注意 -The GNU C library supported the dynamic allocation conversion specifier (as -a nonstandard extension) via the \fBa\fP character. This feature seems to be -present at least as far back as glibc 2.0. +GNU C ライブラリ (glibc) では、 \fBa\fP 文字による動的割り当て変換指定子 (dynamic allocation conversion +specifier) を (非標準の拡張として) サポートしている。この機能は少なくとも glibc 2.0 以降で存在しているようである。 .PP この修飾子は \fIgcc \-std=c99\fP や \fIgcc \-D_ISOC99_SOURCE\fP でコンパイルしたプログラムでは (\fB_GNU_SOURCE\fP も同時に指定していない場合) 利用できない。この場合、 \fBa\fP は (上述の通り) @@ -342,9 +341,8 @@ Linux 上でははっきりと定義された振る舞いをするかもしれ .PP \fBq\fP の使用方法は 4.4BSD と同じではない。 4.4BSD では \fBq\fP は \fBL\fP と同等に浮動小数の変換に使用される。 .SH 例 -To use the dynamic allocation conversion specifier, specify \fBm\fP as a length -modifier (thus \fB%ms\fP or \fB%m[\fP\fIrange\fP\fB]\fP). The caller must \fBfree\fP(3) -the returned string, as in the following example: +動的割り当て変換指定子を使用するには、長さ修飾子として \fBm\fP を指定する (つまり、全体としては \fB%ms\fP や +\fB%m[\fP\fIrange\fP\fB]\fP となる)。以下の例にあるように、呼び出し側は返された文字列を \fBfree\fP(3) しなければならない。 .in +4n .nf @@ -369,6 +367,6 @@ if (n == 1) { \fBgetc\fP(3), \fBprintf\fP(3) \fBsetlocale\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3), .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/sched_getcpu.3 b/release/man3/sched_getcpu.3 index 7bb63567..fac55431 100644 --- a/release/man3/sched_getcpu.3 +++ b/release/man3/sched_getcpu.3 @@ -39,7 +39,7 @@ sched_getcpu \- 呼び出したスレッドが実行されている CPU を知 .fi .sp .in -4n -Feature Test Macro Requirements for glibc (see \fBfeature_test_macros\fP(7)): +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .sp \fBsched_getcpu\fP(): @@ -47,12 +47,12 @@ Feature Test Macro Requirements for glibc (see \fBfeature_test_macros\fP(7)): .RS 4 .PD 0 .TP 4 -Since glibc 2.14: +glibc 2.14 以降: _GNU_SOURCE .TP 4 -Before glibc 2.14: +glibc 2.14 より前: _BSD_SOURCE || _SVID_SOURCE - /* _GNU_SOURCE also suffices */ + /* _GNU_SOURCE も定義される */ .PD .RE .ad b @@ -90,6 +90,6 @@ cpu = (s == \-1) ? s : c; .SH 関連項目 \fBgetcpu\fP(2) .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/seekdir.3 b/release/man3/seekdir.3 index ebe99ffb..18bb213c 100644 --- a/release/man3/seekdir.3 +++ b/release/man3/seekdir.3 @@ -63,6 +63,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBlseek\fP(2), \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3), \fBscandir\fP(3), \fBtelldir\fP(3) .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/sem_close.3 b/release/man3/sem_close.3 index 432ce7f1..21cdb284 100644 --- a/release/man3/sem_close.3 +++ b/release/man3/sem_close.3 @@ -56,6 +56,6 @@ POSIX.1\-2001. \fBsem_getvalue\fP(3), \fBsem_open\fP(3), \fBsem_post\fP(3), \fBsem_unlink\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_destroy.3 b/release/man3/sem_destroy.3 index 9d66aee5..73707dad 100644 --- a/release/man3/sem_destroy.3 +++ b/release/man3/sem_destroy.3 @@ -62,6 +62,6 @@ POSIX.1\-2001. .SH 関連項目 \fBsem_init\fP(3), \fBsem_post\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_getvalue.3 b/release/man3/sem_getvalue.3 index 2e8530b2..5308cf45 100644 --- a/release/man3/sem_getvalue.3 +++ b/release/man3/sem_getvalue.3 @@ -58,6 +58,6 @@ POSIX.1\-2001. .SH 関連項目 \fBsem_post\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_init.3 b/release/man3/sem_init.3 index 5e5b689d..c8780114 100644 --- a/release/man3/sem_init.3 +++ b/release/man3/sem_init.3 @@ -72,6 +72,6 @@ POSIX.1\-2001. .SH 関連項目 \fBsem_destroy\fP(3), \fBsem_post\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_open.3 b/release/man3/sem_open.3 index a3a4a46b..28bba599 100644 --- a/release/man3/sem_open.3 +++ b/release/man3/sem_open.3 @@ -100,6 +100,6 @@ POSIX.1\-2001. \fBsem_close\fP(3), \fBsem_getvalue\fP(3), \fBsem_post\fP(3), \fBsem_unlink\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_post.3 b/release/man3/sem_post.3 index 3659f831..503398b0 100644 --- a/release/man3/sem_post.3 +++ b/release/man3/sem_post.3 @@ -62,6 +62,6 @@ POSIX.1\-2001. .SH 関連項目 \fBsem_getvalue\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_unlink.3 b/release/man3/sem_unlink.3 index c8c8807d..d68c6e86 100644 --- a/release/man3/sem_unlink.3 +++ b/release/man3/sem_unlink.3 @@ -60,6 +60,6 @@ POSIX.1\-2001. \fBsem_getvalue\fP(3), \fBsem_open\fP(3), \fBsem_post\fP(3), \fBsem_wait\fP(3), \fBsem_overview\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/sem_wait.3 b/release/man3/sem_wait.3 index 6fc01ffc..02099fc7 100644 --- a/release/man3/sem_wait.3 +++ b/release/man3/sem_wait.3 @@ -207,6 +207,6 @@ main(int argc, char *argv[]) \fBclock_gettime\fP(2), \fBsem_getvalue\fP(3), \fBsem_post\fP(3), \fBsem_overview\fP(7), \fBtime\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/setaliasent.3 b/release/man3/setaliasent.3 index 1653e1b6..d2caaa7d 100644 --- a/release/man3/setaliasent.3 +++ b/release/man3/setaliasent.3 @@ -119,6 +119,6 @@ main(void) .\" newaliases, postalias \fBgetgrent\fP(3), \fBgetpwent\fP(3), \fBgetspent\fP(3), \fBaliases\fP(5) .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/setbuf.3 b/release/man3/setbuf.3 index 7043a356..df746a83 100644 --- a/release/man3/setbuf.3 +++ b/release/man3/setbuf.3 @@ -143,6 +143,6 @@ main(void) \fBfclose\fP(3), \fBfflush\fP(3), \fBfopen\fP(3), \fBfread\fP(3), \fBmalloc\fP(3), \fBprintf\fP(3), \fBputs\fP(3) .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/setenv.3 b/release/man3/setenv.3 index 913b8424..d29c3dcb 100644 --- a/release/man3/setenv.3 +++ b/release/man3/setenv.3 @@ -94,6 +94,6 @@ POSIX.1\-2001 では 「\fIname\fP に \(aq=\(aq 文字が含まれる場合、 .SH 関連項目 \fBclearenv\fP(3), \fBgetenv\fP(3), \fBputenv\fP(3), \fBenviron\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/setjmp.3 b/release/man3/setjmp.3 index b6cc669e..1826d166 100644 --- a/release/man3/setjmp.3 +++ b/release/man3/setjmp.3 @@ -77,6 +77,6 @@ System V の振る舞いに従うが、 \fB_BSD_SOURCE\fP 機能検査マクロ .SH 関連項目 \fBlongjmp\fP(3), \fBsiglongjmp\fP(3) .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/setlocale.3 b/release/man3/setlocale.3 index a1ecffb1..3a573971 100644 --- a/release/man3/setlocale.3 +++ b/release/man3/setlocale.3 @@ -117,6 +117,6 @@ Linux (というか glibc) は互換性のあるロケールとして \fB"C"\fP \fBnl_langinfo\fP(3), \fBrpmatch\fP(3), \fBstrcoll\fP(3), \fBstrftime\fP(3), \fBcharsets\fP(7), \fBlocale\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/setlogmask.3 b/release/man3/setlogmask.3 index a92fb785..d7293f83 100644 --- a/release/man3/setlogmask.3 +++ b/release/man3/setlogmask.3 @@ -45,10 +45,11 @@ setlogmask \- ログの優先度マスクを設定する \fBsetlogmask\fP() 関数は、呼び出し元のプロセスに対するログマスクを設定し、 変更前のマスクを返す。 \fImask\fP 引き数が 0 ならば、現在のログマスクは変更されない。 .LP -以下の8レベルの優先度が定義されている(優先度の高い順)： \fBLOG_EMERG\fP, \fBLOG_ALERT\fP, \fBLOG_CRIT\fP, -\fBLOG_ERR\fP, \fBLOG_WARNING\fP, \fBLOG_NOTICE\fP, \fBLOG_INFO\fP, \fBLOG_DEBUG\fP。 優先度 -\fIp\fP に対応するビット列は \fBLOG_MASK\fP(\fIp\fP) によって求められる。 優先度 \fIp\fP 以上のすべての優先度 (\fIp\fP を含む) -のマスクビットを 求めることができるマクロ \fBLOG_UPTO\fP(\fIp\fP) を使用できるシステムもある。 +The eight priorities are \fBLOG_EMERG\fP, \fBLOG_ALERT\fP, \fBLOG_CRIT\fP, +\fBLOG_ERR\fP, \fBLOG_WARNING\fP, \fBLOG_NOTICE\fP, \fBLOG_INFO\fP, and \fBLOG_DEBUG\fP. +The bit corresponding to a priority \fIp\fP is \fILOG_MASK(p)\fP. Some systems +also provide a macro \fILOG_UPTO(p)\fP for the mask of all priorities in the +above list up to and including \fIp\fP. .SH 返り値 変更前のログ優先度マスクの値を返す。 .SH エラー @@ -60,6 +61,6 @@ POSIX.1\-2001. POSIX.1\-2001 での説明には欠陥があることに注意 .SH 関連項目 \fBcloselog\fP(3), \fBopenlog\fP(3), \fBsyslog\fP(3) .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/setnetgrent.3 b/release/man3/setnetgrent.3 index 5597c621..7951dc3c 100644 --- a/release/man3/setnetgrent.3 +++ b/release/man3/setnetgrent.3 @@ -74,6 +74,6 @@ BSD の実装では \fBsetnetgrent\fP() は void を返す。 .SH 関連項目 \fBsethostent\fP(3), \fBsetprotoent\fP(3), \fBsetservent\fP(3) .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/shm_open.3 b/release/man3/shm_open.3 index 21483511..8833aafe 100644 --- a/release/man3/shm_open.3 +++ b/release/man3/shm_open.3 @@ -65,8 +65,8 @@ POSIX 共有メモリ・オブジェクトは、実際には、関係のない を指定する。 .TP 1.1i \fBO_RDONLY\fP -読み出しアクセス用にオブジェクトをオープンする。 このフラグを指定してオープンされた共有メモリ・オブジェクトは、 読み出し (\fBPROT_READ\fP) -アクセスでのみ \fBmmap\fP(2) することができる。 +Open the object for read access. A shared memory object opened in this way +can be \fBmmap\fP(2)ed only for read (\fBPROT_READ\fP) access. .TP \fBO_RDWR\fP 読み書きアクセス用にオブジェクトをオープンする。 @@ -157,6 +157,6 @@ Linux 2.4 における POSIX 共有メモリ・オブジェクトの実装は \fBclose\fP(2), \fBfchmod\fP(2), \fBfchown\fP(2), \fBfcntl\fP(2), \fBfstat\fP(2), \fBftruncate\fP(2), \fBmmap\fP(2), \fBopen\fP(2), \fBumask\fP(2), \fBshm_overview\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/siginterrupt.3 b/release/man3/siginterrupt.3 index 626947a2..92fecb67 100644 --- a/release/man3/siginterrupt.3 +++ b/release/man3/siginterrupt.3 @@ -33,7 +33,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGINTERRUPT 3 2011\-09\-09 "" "Linux Programmer's Manual" +.TH SIGINTERRUPT 3 2013\-04\-19 "" "Linux Programmer's Manual" .SH 名前 siginterrupt \- シグナルでシステム・コールに割り込むことを許す .SH 書式 @@ -65,7 +65,9 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND .PP \fIflag\fP 引き数が真 (1) でデータの転送が開始されていれば、 システム・コールは中断され、それまでに実際に転送されたデータ の量が返される。 .SH 返り値 -\fBsiginterrupt\fP() 関数は成功した場合 0 を返す。 シグナル番号 \fIsig\fP が不正な場合は \-1 を返す。 +The \fBsiginterrupt\fP() function returns 0 on success. It returns \-1 if the +signal number \fIsig\fP is invalid, with \fIerrno\fP set to indicate the cause of +the error. .SH エラー .TP \fBEINVAL\fP @@ -76,6 +78,6 @@ _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTEND .SH 関連項目 \fBsignal\fP(2) .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/signbit.3 b/release/man3/signbit.3 index 85173ca7..276472ae 100644 --- a/release/man3/signbit.3 +++ b/release/man3/signbit.3 @@ -13,7 +13,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGNBIT 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.TH SIGNBIT 3 2013\-07\-04 GNU "Linux Programmer's Manual" .SH 名前 signbit \- 浮動小数点実数の符号 (sign) を調べる .SH 書式 @@ -47,12 +47,15 @@ NaN と無限大には符号ビットがある。 \fBsignbit\fP() マクロは \fIx\fP の符号が負の場合 0 以外を返し、そうでない場合 0 を返す。 .SH エラー エラーは発生しない。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBsignbit\fP() macro is thread\-safe. .SH 準拠 C99, POSIX.1\-2001. この関数は IEC 559 で定義されている (また IEEE 754/IEEE 854 では付録で推奨関数として定義されている)。 .SH 関連項目 \fBcopysign\fP(3) .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/significand.3 b/release/man3/significand.3 index db09a6e6..cc802248 100644 --- a/release/man3/significand.3 +++ b/release/man3/significand.3 @@ -50,6 +50,6 @@ scalb(x, (double) \-ilogb(x)) .SH 関連項目 \fBilogb\fP(3), \fBscalb\fP(3) .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/sigpause.3 b/release/man3/sigpause.3 index 186d6300..127b7b4f 100644 --- a/release/man3/sigpause.3 +++ b/release/man3/sigpause.3 @@ -51,10 +51,13 @@ System V 版の \fBsigpause\fP() は POSIX.1\-2001 で標準化されている .SH 注意 .SS 歴史 .\" __xpg_sigpause: UNIX 95, spec 1170, SVID, SVr4, XPG -この関数の古典的な BSD 版は 4.2BSD で登場した。 この関数はプロセスのシグナルマスクを \fIsigmask\fP に設定する。 UNIX 95 -では BSD 版と互換性のない System V 版のこの関数が標準化された。 UNIX 95 版は、指定されたシグナル \fIsig\fP -をプロセスのシグナルマスクから削除するだけである。 同じ名前で互換性のない 2 つの関数があるという不幸な事態は、 \fB\%sigsuspend\fP(2) -関数によって解消された。 この関数は (\fIint\fP の代わりに) \fBsigset_t *\fP 引き数をとる。 +The classical BSD version of this function appeared in 4.2BSD. It sets the +process's signal mask to \fIsigmask\fP. UNIX 95 standardized the incompatible +System V version of this function, which removes only the specified signal +\fIsig\fP from the process's signal mask. The unfortunate situation with two +incompatible functions with the same name was solved by the +\fB\%sigsuspend\fP(2) function, that takes a \fIsigset_t\ *\fP argument (instead +of an \fIint\fP). .SS "Linux での注意" Linux では、このルーチンは Sparc (sparc64) アーキテクチャでのみ システムコールとなっている。 @@ -71,6 +74,6 @@ BSD 版を使う。 それ以外の場合には、System V 版を使用する。 \fBkill\fP(2), \fBsigaction\fP(2), \fBsigprocmask\fP(2), \fBsigsuspend\fP(2), \fBsigblock\fP(3), \fBsigvec\fP(3), \fBfeature_test_macros\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/sigqueue.3 b/release/man3/sigqueue.3 index d0c371f4..a666da0f 100644 --- a/release/man3/sigqueue.3 +++ b/release/man3/sigqueue.3 @@ -108,6 +108,6 @@ uinfo.si_value = val; /* argument supplied to sigqueue() */ \fBkill\fP(2), \fBrt_sigqueueinfo\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBpthread_sigqueue\fP(3), \fBsigwait\fP(3), \fBsignal\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/sigset.3 b/release/man3/sigset.3 index c6b2f9b6..6101b27a 100644 --- a/release/man3/sigset.3 +++ b/release/man3/sigset.3 @@ -132,6 +132,6 @@ glibc 2.5 以降で修正されている。 \fBkill\fP(2), \fBpause\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2), \fBraise\fP(3), \fBsigpause\fP(3), \fBsigvec\fP(3), \fBsignal\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/sigsetops.3 b/release/man3/sigsetops.3 index c276b7cb..9d8f64c7 100644 --- a/release/man3/sigsetops.3 +++ b/release/man3/sigsetops.3 @@ -33,7 +33,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH SIGSETOPS 3 2008\-09\-01 Linux "Linux Programmer's Manual" +.TH SIGSETOPS 3 2013\-04\-19 Linux "Linux Programmer's Manual" .SH 名前 sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX シグナル集合の操作 .SH 書式 @@ -80,8 +80,9 @@ _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE \fBsigemptyset\fP(), \fBsigfillset\fP(), \fBsigaddset\fP(), \fBsigdelset\fP() は成功すれば 0 を、エラーの場合は \-1 を返す。 .PP -\fBsigismember\fP() は \fIsignum\fP が \fIset\fP に含まれていれば 1 を返し、含まれていなければ 0 を返す。 -エラーの場合は \-1 を返す。 +\fBsigismember\fP() returns 1 if \fIsignum\fP is a member of \fIset\fP, 0 if +\fIsignum\fP is not a member, and \-1 on error. On error, these functions set +\fIerrno\fP to indicate the cause. .SH エラー .TP \fBEINVAL\fP @@ -109,6 +110,6 @@ POSIX.1\-2001. .SH 関連項目 \fBsigaction\fP(2), \fBsigpending\fP(2), \fBsigprocmask\fP(2), \fBsigsuspend\fP(2) .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/sigvec.3 b/release/man3/sigvec.3 index f08c68ed..8ed483a3 100644 --- a/release/man3/sigvec.3 +++ b/release/man3/sigvec.3 @@ -136,6 +136,6 @@ BSD と System V のどちらのシステムでも シグナルを待つため \fBkill\fP(2), \fBpause\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2), \fBraise\fP(3), \fBsigpause\fP(3), \fBsigset\fP(3), \fBsignal\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/sigwait.3 b/release/man3/sigwait.3 index 7cbfbd66..c97f6929 100644 --- a/release/man3/sigwait.3 +++ b/release/man3/sigwait.3 @@ -72,6 +72,6 @@ POSIX.1\-2001. \fBsigaction\fP(2), \fBsignalfd\fP(2), \fBsigpending\fP(2), \fBsigsuspend\fP(2), \fBsigwaitinfo\fP(2), \fBsigsetops\fP(3), \fBsignal\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/sin.3 b/release/man3/sin.3 index eacf09e1..32ddab6c 100644 --- a/release/man3/sin.3 +++ b/release/man3/sin.3 @@ -94,6 +94,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 \fBacos\fP(3), \fBasin\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcos\fP(3), \fBcsin\fP(3), \fBsincos\fP(3), \fBtan\fP(3) .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/sincos.3 b/release/man3/sincos.3 index 55b75bc5..471daf82 100644 --- a/release/man3/sincos.3 +++ b/release/man3/sincos.3 @@ -59,6 +59,6 @@ sincos, sincosf, sincosl \- 正弦と余弦を同時に計算する .SH 関連項目 \fBcos\fP(3), \fBsin\fP(3), \fBtan\fP(3) .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/sinh.3 b/release/man3/sinh.3 index 91d0a688..94025bd8 100644 --- a/release/man3/sinh.3 +++ b/release/man3/sinh.3 @@ -100,6 +100,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBacosh\fP(3), \fBasinh\fP(3), \fBatanh\fP(3), \fBcosh\fP(3), \fBcsinh\fP(3), \fBtanh\fP(3) .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/sleep.3 b/release/man3/sleep.3 index e0906d1e..dba935bb 100644 --- a/release/man3/sleep.3 +++ b/release/man3/sleep.3 @@ -52,6 +52,6 @@ POSIX.1\-2001. .SH 関連項目 \fBalarm\fP(2), \fBnanosleep\fP(2), \fBsignal\fP(2), \fBsignal\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/sockatmark.3 b/release/man3/sockatmark.3 index 43bd619a..5c9b62ee 100644 --- a/release/man3/sockatmark.3 +++ b/release/man3/sockatmark.3 @@ -107,6 +107,6 @@ glibc 2.4 より前のバージョンでは、 \fBsockatmark\fP() は動作し .SH 関連項目 \fBfcntl\fP(2), \fBrecv\fP(2), \fBsend\fP(2), \fBtcp\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/sqrt.3 b/release/man3/sqrt.3 index b068f0ea..ae8b0aa5 100644 --- a/release/man3/sqrt.3 +++ b/release/man3/sqrt.3 @@ -89,6 +89,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBcbrt\fP(3), \fBcsqrt\fP(3), \fBhypot\fP(3) .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/statvfs.3 b/release/man3/statvfs.3 index 3ce3c74b..36618273 100644 --- a/release/man3/statvfs.3 +++ b/release/man3/statvfs.3 @@ -137,6 +137,6 @@ Linux カーネルには、このライブラリコールをサポートする .SH 関連項目 \fBstatfs\fP(2) .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/stdarg.3 b/release/man3/stdarg.3 index 3c9f219c..0bbabc47 100644 --- a/release/man3/stdarg.3 +++ b/release/man3/stdarg.3 @@ -47,7 +47,7 @@ .\"******************************************************************* .TH STDARG 3 2013\-03\-15 "" "Linux Programmer's Manual" .SH 名前 -stdarg, va_start, va_arg, va_end, va_copy \- 個数・型が可変な引数リスト +stdarg, va_start, va_arg, va_end, va_copy \- 個数、型が可変な引数リスト .SH 書式 \fB#include \fP .sp @@ -92,11 +92,9 @@ stdarg, va_start, va_arg, va_end, va_copy \- 個数・型が可変な引数リ \fBva_end(\fP\fIap\fP\fB)\fP が呼び出された後、変数 \fIap\fP の値は不定となる。 \fBva_start\fP() と \fBva_end\fP() の組を何回も並べて使うことも可能である。 \fBva_end\fP() はマクロかもしれないし関数かもしれない。 .SS va_copy() -The \fBva_copy\fP() macro copies the (previously initialized) variable -argument list \fIsrc\fP to \fIdest\fP. The behavior is as if \fBva_start\fP() were -applied to \fIdest\fP with the same \fIlast\fP argument, followed by the same -number of \fBva_arg\fP() invocations that was used to reach the current state -of \fIsrc\fP. +\fBva_copy\fP() マクロは (初期化済みの) 可変長引き数リスト \fIsrc\fP を \fIdest\fP にコピーする。動作は、 \fIlast\fP +引き数に \fIdest\fP を渡して \fBva_start\fP() を \fIdest\fP に適用し、それから \fIsrc\fP +が現在の状態に達するまでに呼び出したのと同じ回数だけ \fBva_arg\fP() を呼び出す、のと同じことを行う。 .\" Proposal from clive@demon.net, 1997-02-28 すぐ分かる \fIva_list\fP の実装は、variadic な関数のスタックフレームのポインタである。 このような場合(ほとんどはそうである)、 @@ -205,6 +203,6 @@ foo(char *fmt, ...) } .fi .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/stdin.3 b/release/man3/stdin.3 index b55a4ef2..1709d26a 100644 --- a/release/man3/stdin.3 +++ b/release/man3/stdin.3 @@ -71,6 +71,6 @@ stdin, stdout, stderr \- 標準入出力ストリーム .SH 関連項目 \fBcsh\fP(1), \fBsh\fP(1), \fBopen\fP(2), \fBfopen\fP(3), \fBstdio\fP(3) .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/stdio.3 b/release/man3/stdio.3 index 0408d536..859a9100 100644 --- a/release/man3/stdio.3 +++ b/release/man3/stdio.3 @@ -167,6 +167,6 @@ vsscanf 書式付き入力変換 \fBclose\fP(2), \fBopen\fP(2), \fBread\fP(2), \fBwrite\fP(2), \fBstdout\fP(3), \fBunlocked_stdio\fP(3) .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/stdio_ext.3 b/release/man3/stdio_ext.3 index 571b3fd1..fc494889 100644 --- a/release/man3/stdio_ext.3 +++ b/release/man3/stdio_ext.3 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH STDIO_EXT 3 2001\-12\-16 "" "Linux Programmer's Manual" +.TH STDIO_EXT 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 __fbufsize, __flbf, __fpending, __fpurge, __freadable, __freading, __fsetlocking, __fwritable, __fwriting, _flushlbf \- 標準入出力ファイル構造体へのインタフェース @@ -95,9 +95,16 @@ Solaris では、 \fIFILE\fP 構造体の内部へポータブルなかたちで (当然ながら、端末への出力が強制的に行われることになるので、 キーボードからの入力を読みこむ前にこの関数を呼んだ方がいいだろう) .LP \fB__fpurge\fP() 関数は、ストリームのバッファの内容を廃棄する。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fB__fbufsize\fP(), \fB__fpending\fP(), \fB__fpurge\fP() and \fB__fsetlocking\fP() +functions do not lock the stream, so they are not thread\-safe. +.LP +The \fB__flbf\fP(), \fB__freadable\fP(), \fB__freading\fP(), \fB__fwritable\fP(), +\fB__fwriting\fP() and \fB_flushlbf\fP() functions are thread\-safe. .SH 関連項目 \fBflockfile\fP(3), \fBfpurge\fP(3) .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/stpcpy.3 b/release/man3/stpcpy.3 index 2e238c41..e878ccfa 100644 --- a/release/man3/stpcpy.3 +++ b/release/man3/stpcpy.3 @@ -93,6 +93,6 @@ main(void) \fBbcopy\fP(3), \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBmemmove\fP(3), \fBstpncpy\fP(3), \fBstrcpy\fP(3), \fBstring\fP(3), \fBwcpcpy\fP(3) .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/stpncpy.3 b/release/man3/stpncpy.3 index d8930a5e..7e33c542 100644 --- a/release/man3/stpncpy.3 +++ b/release/man3/stpncpy.3 @@ -60,6 +60,6 @@ NULL バイト (\(aq\e0\(aq) 文字が埋められる。 長さ \fIstrlen(src)\f .SH 関連項目 \fBstrncpy\fP(3), \fBwcpncpy\fP(3) .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/strcasecmp.3 b/release/man3/strcasecmp.3 index 69c073b2..3453ce67 100644 --- a/release/man3/strcasecmp.3 +++ b/release/man3/strcasecmp.3 @@ -58,6 +58,6 @@ strcasecmp, strncasecmp \- 二つの文字列を大文字小文字を区別せ \fBbcmp\fP(3), \fBmemcmp\fP(3), \fBstrcmp\fP(3), \fBstrcoll\fP(3), \fBstring\fP(3), \fBstrncmp\fP(3), \fBwcscasecmp\fP(3), \fBwcsncasecmp\fP(3) .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/strcat.3 b/release/man3/strcat.3 index 7877ce5b..780180d0 100644 --- a/release/man3/strcat.3 +++ b/release/man3/strcat.3 @@ -46,12 +46,11 @@ strcat, strncat \- 二つの文字列を連結する \fBchar *strncat(char *\fP\fIdest\fP\fB, const char *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP .fi .SH 説明 -The \fBstrcat\fP() function appends the \fIsrc\fP string to the \fIdest\fP string, -overwriting the terminating null byte (\(aq\e0\(aq) at the end of \fIdest\fP, -and then adds a terminating null byte. The strings may not overlap, and the -\fIdest\fP string must have enough space for the result. If \fIdest\fP is not -large enough, program behavior is unpredictable; \fIbuffer overruns are a -favorite avenue for attacking secure programs\fP. +\fBstrcat\fP() 関数は、\fIdest\fP 文字列の後に \fIsrc\fP 文字列を付け加える。 その際に、\fIdest\fP の最後にある終端の +NULL バイト (\(aq\e0\(aq) は上書きされ、新たに生成された文字列の末尾に終端の NULL バイトが付与される。 二つの文字列 +\fIsrc\fP と \fIdest\fP は重なってはならない。 また、文字列 \fIdest\fP は、連結後の結果を格納するのに 十分な大きさでなければならない。 +\fIdest\fP が十分な大きさでない場合、プログラムがどのような動作をするか分からない。 +バッファオーバーランはセキュアなプログラムを攻撃する際に好んで使われる方法である。 .PP \fBstrncat\fP() も同様だが、以下の点が異なる。 .IP * 3 @@ -90,26 +89,22 @@ strncat(char *dest, const char *src, size_t n) .SH 準拠 SVr4, 4.3BSD, C89, C99. .SH 注意 -Some systems (the BSDs, Solaris, and others) provide the following function: +いくつかのシステム (BSD、Solaris など) では以下の関数が提供されている。 size_t strlcat(char *dest, const char *src, size_t size); .\" https://lwn.net/Articles/506530/ -This function appends the null\-terminated string \fIsrc\fP to the string -\fIdest\fP, copying at most \fIsize\-strlen(dest)\-1\fP from \fIsrc\fP, and adds a null -terminator to the result, \fIunless\fP \fIsize\fP is less than \fIstrlen(dest)\fP. -This function fixes the buffer overrun problem of \fBstrcat\fP(), but the -caller must still handle the possibility of data loss if \fIsize\fP is too -small. The function returns the length of the string \fBstrlcat\fP() tried to -create; if the return value is greater than or equal to \fIsize\fP, data loss -occurred. If data loss matters, the caller \fImust\fP either check the -arguments before the call, or test the function return value. \fBstrlcat\fP() -is not present in glibc and is not standardized by POSIX, but is available -on Linux via the \fIlibbsd\fP library. +この関数は、 NULL 終端された文字列 \fIsrc\fP を文字列 \fIdest\fP に追加する。 具体例には、 \fIsize\fP が +\fIstrlen(dest)\fP より大きい場合には最大で \fIsize\-strlen(dest)\-1\fP バイトを \fIsrc\fP からコピーし、 +結果の末尾に終端の NULL バイトを追加する。 この関数では \fBstrcat\fP() のバッファオーバーランが発生するという問題が修正されているが、 +\fIsize\fP が小さすぎた場合にはデータが失われる問題には、 依然として呼び出し側で対処する必要がある。 この関数は \fBstrlcat\fP() +が作成しようとした文字列の長さを返す。 返り値が \fIsize\fP 以上の場合、 データロスが発生している。 データロスが問題となる場合は、 +呼び出し側で、 呼び出し前に引き数をチェックするか、 この関数の返り値を検査するかのいずれかをしなければならない。 \fBstrlcat\fP() は +glibc には存在せず、 POSIX による標準化もされていないが、 Linux では \fIlibbsd\fP ライブラリ経由で利用できる。 .SH 関連項目 \fBbcopy\fP(3), \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBstrcpy\fP(3), \fBstring\fP(3), \fBstrncpy\fP(3), \fBwcscat\fP(3), \fBwcsncat\fP(3) .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/strchr.3 b/release/man3/strchr.3 index 44a1e816..d0ac4261 100644 --- a/release/man3/strchr.3 +++ b/release/man3/strchr.3 @@ -78,6 +78,6 @@ NULL でなく、\fIs\fP の末尾のヌルバイトへのポインタを返す \fBstrpbrk\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBstrtok\fP(3), \fBwcschr\fP(3), \fBwcsrchr\fP(3) .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/strcmp.3 b/release/man3/strcmp.3 index ff720495..44fdebb2 100644 --- a/release/man3/strcmp.3 +++ b/release/man3/strcmp.3 @@ -49,8 +49,8 @@ strcmp, strncmp \- 二つの文字列を比べる \fBstrcmp\fP() 関数は二つの文字列 \fIs1\fP と \fIs2\fP を較べる。 この関数は、 \fIs1\fP が \fIs2\fP に較べて 1)小さい、2)等しい、3)大きい場合に、 ゼロよりも 1)小さい、2)等しい、3)大きい整数を返す。 .PP -\fBstrncmp\fP() 関数は、\fIs1\fP と \fIs2\fP の最初の \fIn\fP バイトだけを比較する -ことを除けば、strcmp()と同様である。 +The \fBstrncmp\fP() function is similar, except it compares the only first (at +most) \fIn\fP bytes of \fIs1\fP and \fIs2\fP. .SH 返り値 \fBstrcmp\fP() 関数と \fBstrncmp\fP() 関数は整数を返す。 この整数は、ゼロよりも、1)小さい、2)等しい、3)大きいのいずれかである。 それぞれは、\fIs1\fP（または、この文字列の最初の \fIn\fP バイト）が @@ -61,6 +61,6 @@ SVr4, 4.3BSD, C89, C99. \fBbcmp\fP(3), \fBmemcmp\fP(3), \fBstrcasecmp\fP(3), \fBstrcoll\fP(3), \fBstring\fP(3), \fBstrncasecmp\fP(3), \fBstrverscmp\fP(3), \fBwcscmp\fP(3), \fBwcsncmp\fP(3) .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/strcoll.3 b/release/man3/strcoll.3 index eaf58f02..374a83dd 100644 --- a/release/man3/strcoll.3 +++ b/release/man3/strcoll.3 @@ -51,11 +51,12 @@ strcoll \- 現在のロケールを使用して二つの文字列を比較する .SH 準拠 SVr4, 4.3BSD, C89, C99. .SH 注意 -\fI"POSIX"\fP および \fI"C"\fP ロケールにおいては、 \fBstrcoll\fP() は \fBstrcmp\fP(3) と等価である。 +In the \fIPOSIX\fP or \fI\&\& C"\fP locales \fBstrcoll\fP() is equivalent to +\fBstrcmp\fP(3). .SH 関連項目 \fBbcmp\fP(3), \fBmemcmp\fP(3), \fBsetlocale\fP(3), \fBstrcasecmp\fP(3), \fBstrcmp\fP(3), \fBstring\fP(3), \fBstrxfrm\fP(3) .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/strcpy.3 b/release/man3/strcpy.3 index f2e52058..c52e35c2 100644 --- a/release/man3/strcpy.3 +++ b/release/man3/strcpy.3 @@ -49,17 +49,15 @@ strcpy, strncpy \- 文字列をコピーする \fBchar *strncpy(char *\fP\fIdest\fP\fB, const char *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP .fi .SH 説明 -The \fBstrcpy\fP() function copies the string pointed to by \fIsrc\fP, including -the terminating null byte (\(aq\e0\(aq), to the buffer pointed to by -\fIdest\fP. The strings may not overlap, and the destination string \fIdest\fP -must be large enough to receive the copy. \fIBeware of buffer overruns!\fP -(See BUGS.) +\fBstrcpy\fP() 関数は \fIsrc\fP が指す文字列を末尾のヌルバイト (\(aq\e0\(aq) も含めて \fIdest\fP +が指すバッファにコピーする。 二つの文字列は重なってはならない。受け側の文字列 \fIdest\fP は コピーを受け取るのに十分な大きさでなければならない。 +\fIバッファオーバーランに気を付けること!\fP (「バグ」の節を参照) .PP \fBstrncpy\fP() 関数も同様だが、 \fIsrc\fP のうち最大でも \fIn\fP バイトしかコピーされない点が異なる。 \fB警告\fP: \fIsrc\fP の最初の \fIn\fP バイトの中にヌルバイトがない場合、 \fIdest\fP に格納される文字列はヌルで終端されないことになる。 .PP -If the length of \fIsrc\fP is less than \fIn\fP, \fBstrncpy\fP() writes additional -null bytes to \fIdest\fP to ensure that a total of \fIn\fP bytes are written. +\fIsrc\fP の長さが \fIn\fP よりも短い場合、 \fBstrncpy\fP() は \fIdest\fP に追加のヌルバイトを書き込み、全部で \fIn\fP +バイトが書き込まれるようにする。 .PP \fBstrncpy\fP() の簡単な実装は以下のような感じであろう: .in +4n @@ -87,15 +85,13 @@ SVr4, 4.3BSD, C89, C99. \fBstrncpy\fP() は効率的でなく間違いを起こしやすいと考えるプログラマもいるだろう。 プログラマが \fIdest\fP の大きさが \fIsrc\fP の長さよりも 大きいことを知っている (つまり、そのことをチェックするコードを 書いている) 場合は、 \fBstrcpy()\fP を使うことができる。 -One valid (and intended) use of \fBstrncpy\fP() is to copy a C string to a -fixed\-length buffer while ensuring both that the buffer is not overflowed -and that unused bytes in the target buffer are zeroed out (perhaps to -prevent information leaks if the buffer is to be written to media or -transmitted to another process via an interprocess communication technique). +\fBstrncpy\fP() の正しい (かつ意図された) 用途は、 C 文字列の固定長バッファへのコピーを、 バッファがオーバーフローしないことと、 +宛先バッファの未使用バイトが 0 で埋められることの両方を保証しつつ行うことである。 (宛先バッファを 0 で埋めるのは、 たいていの場合、 +バッファを媒体に書き込んだり、別のプロセスにプロセス間通信を用いて送信したりした場合に情報洩れを防ぐためである)。 -If there is no terminating null byte in the first \fIn\fP bytes of \fIsrc\fP, -\fBstrncpy\fP() produces an unterminated string in \fIdest\fP. You can force -termination using something like the following: +\fIsrc\fP の最初の \fIn\fP バイトに終端のヌルバイトがない場合、 \fBstrncpy\fP() +は \fIdest\fP に終端されていない文字列を生成する。以下のようにして +強制的に終端することができる。 .in +4n .nf @@ -105,10 +101,9 @@ if (n > 0) .fi .in .PP -(Of course, the above technique ignores the fact that information contained -in \fIsrc\fP is lost in the copying to \fIdest\fP.) +(もちろん、上記の方法では、 \fIsrc\fP に入っている情報が \fIdest\fP へのコピー時に失われるという事実は無視している。) -Some systems (the BSDs, Solaris, and others) provide the following function: +いくつかのシステム (BSD、Solaris など) では以下の関数が提供されている。 size_t strlcpy(char *dest, const char *src, size_t size); @@ -116,17 +111,14 @@ Some systems (the BSDs, Solaris, and others) provide the following function: .\" "strlcpy and strlcat - consistent, safe, string copy and concatenation" .\" 1999 USENIX Annual Technical Conference .\" https://lwn.net/Articles/506530/ -This function is similar to \fBstrncpy\fP(), but it copies at most \fIsize\-1\fP -bytes to \fIdest\fP, always adds a terminating null byte, and does not pad the -target with (further) null bytes. This function fixes some of the problems -of \fBstrcpy\fP() and \fBstrncpy\fP(), but the caller must still handle the -possibility of data loss if \fIsize\fP is too small. The return value of the -function is the length of \fIsrc\fP, which allows truncation to be easily -detected: if the return value is greater than or equal to \fIsize\fP, -truncation occurred. If loss of data matters, the caller \fImust\fP either -check the arguments before the call, or test the function return value. -\fBstrlcpy\fP() is not present in glibc and is not standardized by POSIX, but -is available on Linux via the \fIlibbsd\fP library. +この関数は \fBstrncpy\fP() と同様だが、 最大でも \fIsize\-1\fP バイトしか \fIdest\fP にコピーをせず、 末尾への終端の NULL +バイトの追加が必ず行われ、 宛先バッファ (の未使用部分) への NULL バイトの書き込みが行われない。 この関数では \fBstrcpy\fP() や +\fBstrncpy\fP() の持つ問題のいくつかが修正されているが、 \fIsize\fP が小さすぎた場合にはデータが失われる問題には、 +依然として呼び出し側で対処する必要がある。 この関数の返り値は \fIsrc\fP の長さである。 これにより、 +末尾の切り詰めが行われたかを簡単に検出することができる。 返り値が \fIsize\fP 以上の場合には、 末尾の切り詰めが発生している。 +データロスが問題となる場合は、 呼び出し側で、 呼び出し前に引き数をチェックするか、 この関数の返り値を検査するかのいずれかをしなければならない。 +\fBstrlcpy\fP() は glibc には存在せず、 POSIX による標準化もされていないが、 Linux では \fIlibbsd\fP +ライブラリ経由で利用できる。 .SH バグ \fBstrcpy\fP() の受け側の文字列が十分な大きさでない場合、何が起こるかわからない。 固定長文字列を溢れさせるのは、マシンの制御を掌中に収めるために クラッカーが好んで使うテクニックである。 @@ -137,6 +129,6 @@ is available on Linux via the \fIlibbsd\fP library. \fBbcopy\fP(3), \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBmemmove\fP(3), \fBstpcpy\fP(3), \fBstpncpy\fP(3), \fBstrdup\fP(3), \fBstring\fP(3), \fBwcscpy\fP(3), \fBwcsncpy\fP(3) .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/strdup.3 b/release/man3/strdup.3 index e2970ef2..c65cfecd 100644 --- a/release/man3/strdup.3 +++ b/release/man3/strdup.3 @@ -33,7 +33,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH STRDUP 3 2012\-05\-10 GNU "Linux Programmer's Manual" +.TH STRDUP 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 strdup, strndup, strdupa, strndupa \- 文字列を複製する .SH 書式 @@ -88,7 +88,9 @@ _GNU_SOURCE これらが使用できるのは GNU GCC ツール群を使う場合だけであり、 \fBalloca\fP(3) で説明されているのと同じ制限がある。 .SH 返り値 -\fBstrdup\fP() 関数は複製された文字列へのポインタ、または 十分なメモリが確保できなかった場合にはNULLを返す。 +On success, the \fBstrdup\fP() function returns a pointer to the duplicated +string. It returns NULL if insufficient memory was available, with \fIerrno\fP +set to indicate the cause of the error. .SH エラー .TP \fBENOMEM\fP @@ -101,6 +103,6 @@ POSIX.1\-2008 準拠である。 \fBstrdupa\fP(), \fBstrndupa\fP() は GNU 拡 \fBalloca\fP(3), \fBcalloc\fP(3), \fBfree\fP(3), \fBmalloc\fP(3), \fBrealloc\fP(3), \fBstring\fP(3), \fBwcsdup\fP(3) .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/strerror.3 b/release/man3/strerror.3 index 0a32cc71..61d6b93c 100644 --- a/release/man3/strerror.3 +++ b/release/man3/strerror.3 @@ -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/ に書かれている。 diff --git a/release/man3/strfmon.3 b/release/man3/strfmon.3 index 27d729cd..1627cb70 100644 --- a/release/man3/strfmon.3 +++ b/release/man3/strfmon.3 @@ -120,6 +120,6 @@ strfmon(buf, sizeof(buf), "[%^=*#6n] [%=*#6i]", .SH 関連項目 \fBsetlocale\fP(3), \fBsprintf\fP(3), \fBlocale\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/strfry.3 b/release/man3/strfry.3 index e18e054c..28237261 100644 --- a/release/man3/strfry.3 +++ b/release/man3/strfry.3 @@ -53,6 +53,6 @@ strfry \- 文字列をランダムに並べ変える .SH 関連項目 \fBmemfrob\fP(3), \fBstring\fP(3) .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/strftime.3 b/release/man3/strftime.3 index 5ae5c384..45ef6219 100644 --- a/release/man3/strftime.3 +++ b/release/man3/strftime.3 @@ -39,7 +39,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH STRFTIME 3 2012\-05\-10 GNU "Linux Programmer's Manual" +.TH STRFTIME 3 2013\-06\-28 GNU "Linux Programmer's Manual" .SH 名前 strftime \- 日付および時刻の文字列への変換 .SH 書式 @@ -146,7 +146,8 @@ ISO\ 8601 週単位表記の年 (week\-based year; 「注意」の節を参照) 午前・午後形式での時刻。 POSIX ロケールでは \fB%I:%M:%S %p\fP と等価である。(SU) .TP \fB%R\fP -24 時間表記での時刻、秒は表示しない (\fB%H:%M\fP)。 秒を含んだものは以下の \fB%T\fP を参照すること。(SU) +The time in 24\-hour notation (\fB%H:%M\fP). (SU) For a version including the +seconds, see \fB%T\fP below. .TP \fB%s\fP 紀元 (Epoch; 1970\-01\-01 00:00:00 +0000 (UTC)) からの秒数。 (TZ) @@ -158,7 +159,7 @@ ISO\ 8601 週単位表記の年 (week\-based year; 「注意」の節を参照) タブ文字 (SU) .TP \fB%T\fP -24 時間表記の時間 (\fB%H:%M:%S\fP) (SU) +The time in 24\-hour notation (\fB%H:%M:%S\fP). (SU) .TP \fB%u\fP 週の何番目の日 (10 進数表記) か。月曜日を 1 とする (1\-7)。 \fB%w\fP も参照。(SU) @@ -193,7 +194,7 @@ ISO\ 8601 形式での年の始めからの週番号 (「注意」の節を参 \fI+hhmm\fP や \fI\-hhmm\fP の形式のタイムゾーン (UTC へのオフセット時間)。(SU) .TP \fB%Z\fP -タイムゾーンまたはゾーン名または省略名。 +The timezone name or abbreviation. .TP \fB%+\fP .\" Nov 05 -- Not in Linux/glibc, but is in some BSDs (according to @@ -213,14 +214,18 @@ UNIX Specification) では \fB%Ec\fP, \fB%EC\fP, \fB%Ex\fP, \fB%EX\fP, \fB%Ey\fP .PP 要素別の時刻構造体 \fItm\fP の詳細は \fI\fP に定義されている。 \fBctime\fP(3) も参照すること。 .SH 返り値 -\fBstrftime\fP() 関数は文字列 \fIs\fP に格納されたバイト数を返す。このバイト -数に終端の NULL バイトは含まない。終端の NULL バイトを格納できるだけの -大きさを持った文字列を渡すこと。それ以外の場合は 0 を返し、文字列の内容 -は修正されない。 (libc 4.4.4 以降でこの挙動が適用されている。 libc -4.4.1 などの非常に古いバージョンの libc では 文字列が短か過ぎた場合には -\fImax\fP が返される。) +Provided that the result string, including the terminating null byte, does +not exceed \fImax\fP bytes, \fBstrftime\fP() returns the number of bytes +(excluding the terminating null byte) placed in the array \fIs\fP. If the +length of the result string (including the terminating null byte) would +exceed \fImax\fP bytes, then \fBstrftime\fP() returns 0, and the contents of the +array are undefined. (This behavior applies since at least libc 4.4.4; very +old versions of libc, such as libc 4.4.1, would return \fImax\fP if the array +was too small.) .LP -返り値 0 は必ずしもエラーを意味している訳ではないので注意すること。 例えば、多くのロケールでは \fB%p\fP は空文字列を返す。 +Note that the return value 0 does not necessarily indicate an error. For +example, in many locales \fB%p\fP yields an empty string. An empty \fIformat\fP +string will likewise yield an empty string. .SH 環境変数 環境変数 \fBTZ\fP と \fBLC_TIME\fP が使用される。 (訳注: \fBLC_ALL\fP が設定されている場合には \fBLC_TIME\fP よりもそちらが優先される。 \fBLC_TIME\fP も \fBLC_ALL\fP も設定されていない場合には \fBLANG\fP が使用される。) @@ -235,12 +240,19 @@ SUSv2 では、 \fB%S\fP は 00 から 61 の範囲をとると規定されて 考慮してのものである (実際には、このような状況はこれまで一度も 起こっていない)。 .SH 注意 .SS "ISO\ 8601 の週・曜日表記 (Week Dates)" -\fB%G\fP, \fB%g\fP, \fB%V\fP は、ISO\ 8601 標準により定義された週単位表記の年により 計算される値を出力する。 ISO\ 8601 -標準の週単位表記では、週は月曜日から開始され、 週番号は、年の最初の週が 01 となり、最後の週は 52 か 53 となる。 週 01 は、新しい年が -4 日以上含まれる最初の週である。 言い換えると、週 01 は、その年の木曜日を含む最初の週、 つまり 1 月 4 日を含む週ということである。 -新しい年のカレンダー上の最初の週に新しい年が 3 日以下しか含まれない場合、 ISO\ 8601 の週単位表記では、これらの日を前の年の週 53 -の一部とみなす。 例えば、2010 年 1 月 1 日は金曜日であり、 その週には 2010 年の日が 3 日しか含まれない。 したがって、ISO\ 8601 の週単位表記では、これらの日は 2009 年 (\fB%G\fP) の週 53 (\fB%V\fP) の一部となる。 ISO\ 8601 の 2010 -年の週 01 は 2010 年 1 月 4 日の月曜日から始まる。 +\fB%G\fP, \fB%g\fP, and \fB%V\fP yield values calculated from the week\-based year +defined by the ISO\ 8601 standard. In this system, weeks start on a Monday, +and are numbered from 01, for the first week, up to 52 or 53, for the last +week. Week 1 is the first week where four or more days fall within the new +year (or, synonymously, week 01 is: the first week of the year that contains +a Thursday; or, the week that has 4 January in it). When three of fewer +days of the first calendar week of the new year fall within that year, then +the ISO 8601 week\-based system counts those days as part of week 53 of the +preceding year. For example, 1 January 2010 is a Friday, meaning that just +three days of that calendar week fall in 2010. Thus, the ISO\ 8601 +week\-based system considers these days to be part of week 53 (\fB%V\fP) of the +year 2009 (\fB%G\fP); week 01 of ISO\ 8601 year 2010 starts on Monday, 4 +January 2010. .SS "glibc での注意" .\" HP-UX and Tru64 also have features like this. glibc では変換指定にいくつか拡張を行っている (これらの拡張は POSIX.1\-2001 には規定されていないが、 @@ -267,6 +279,11 @@ glibc では変換指定にいくつか拡張を行っている (これらの拡 オプションの10進数の幅指定子はフラグの後ろに置くことができる (フラグはなくてもよい)。フィールドの本来の大きさが指定された幅よりも 小さい場合、結果文字列の左側は指定された幅までパディングされる。 .SH バグ +If the output string would exceed \fImax\fP bytes, \fIerrno\fP is \fInot\fP set. +This makes it impossible to distinguish this error case from cases where the +\fIformat\fP string legitimately produces a zero\-length output string. +POSIX.1\-2001 does \fInot\fP specify any \fIerrno\fP settings for \fBstrftime\fP(). + \fBgcc\fP(1) のいくつかのバージョンにはおかしなところがあり、 \fB%c\fP の使用法について以下のような警告を出す: \fIwarning: `%c' yields only last 2 digits of year in some locales\fP (\fI警告:\fPいくつかのロケールでは\fI`%c'\fPは年の下2桁しか出力しない\fI)。\fP もちろんプログラマが \fB%c\fP @@ -346,6 +363,6 @@ main(int argc, char *argv[]) \fBdate\fP(1), \fBtime\fP(2), \fBctime\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3), \fBstrptime\fP(3) .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/string.3 b/release/man3/string.3 index af94f4bf..6a574054 100644 --- a/release/man3/string.3 +++ b/release/man3/string.3 @@ -100,6 +100,6 @@ strrchr, strsep, strspn, strstr, strtok, strxfrm, index, rindex \- 文字列を \fBstrncmp\fP(3), \fBstrncpy\fP(3), \fBstrpbrk\fP(3), \fBstrrchr\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBstrtok\fP(3), \fBstrxfrm\fP(3) .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/strlen.3 b/release/man3/strlen.3 index 9202b5cf..f3f6f5c4 100644 --- a/release/man3/strlen.3 +++ b/release/man3/strlen.3 @@ -50,6 +50,6 @@ SVr4, 4.3BSD, C89, C99. .SH 関連項目 \fBstring\fP(3), \fBstrnlen\fP(3), \fBwcslen\fP(3), \fBwcsnlen\fP(3) .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/strnlen.3 b/release/man3/strnlen.3 index 8d26899f..2a48d5d2 100644 --- a/release/man3/strnlen.3 +++ b/release/man3/strnlen.3 @@ -43,10 +43,10 @@ _GNU_SOURCE .ad .PD .SH 説明 -\fBstrnlen\fP() 関数は \fIs\fP が指す文字列の長さをバイト数で返す。 長さには -終端の NULL バイト (\(aq\e0\(aq) は含まない。 また長さは最大で -\fImaxlen\fP までであり、 \fBstrnlen\fP() は \fIs\fP の最初の \fImaxlen\fP バイト -のみを検査し \fIs+maxlen\fP より先を検査することはない。 +The \fBstrnlen\fP() function returns the number of bytes in the string pointed +to by \fIs\fP, excluding the terminating null byte (\(aq\e0\(aq), but at most +\fImaxlen\fP. In doing this, \fBstrnlen\fP() looks only at the first \fImaxlen\fP +bytes at \fIs\fP and never beyond \fIs+maxlen\fP. .SH 返り値 \fBstrnlen\fP() 関数は \fImaxlen\fP 以下ならば \fIstrlen(s)\fP と同じ値を返す。 \fIs\fP の指す文字列が最大 \fImaxlen\fP バイトまでに NULL バイト @@ -56,6 +56,6 @@ POSIX.1\-2008. .SH 関連項目 \fBstrlen\fP(3) .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/strpbrk.3 b/release/man3/strpbrk.3 index 75271638..3286b57e 100644 --- a/release/man3/strpbrk.3 +++ b/release/man3/strpbrk.3 @@ -54,6 +54,6 @@ SVr4, 4.3BSD, C89, C99. \fBindex\fP(3), \fBmemchr\fP(3), \fBrindex\fP(3), \fBstrchr\fP(3), \fBstring\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBstrtok\fP(3), \fBwcspbrk\fP(3) .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/strptime.3 b/release/man3/strptime.3 index e59299a7..44ba236e 100644 --- a/release/man3/strptime.3 +++ b/release/man3/strptime.3 @@ -296,6 +296,6 @@ main(void) .SH 関連項目 \fBtime\fP(2), \fBgetdate\fP(3), \fBscanf\fP(3), \fBsetlocale\fP(3), \fBstrftime\fP(3) .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/strsep.3 b/release/man3/strsep.3 index b41bcc53..399cce6d 100644 --- a/release/man3/strsep.3 +++ b/release/man3/strsep.3 @@ -74,6 +74,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBindex\fP(3), \fBmemchr\fP(3), \fBrindex\fP(3), \fBstrchr\fP(3), \fBstring\fP(3), \fBstrpbrk\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBstrtok\fP(3) .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/strsignal.3 b/release/man3/strsignal.3 index decb6ddc..742be0bb 100644 --- a/release/man3/strsignal.3 +++ b/release/man3/strsignal.3 @@ -75,6 +75,6 @@ POSIX.1\-2008. Solaris と BSD 系にも存在する。 .SH 関連項目 \fBpsignal\fP(3), \fBstrerror\fP(3) .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/strspn.3 b/release/man3/strspn.3 index bd814799..0d617162 100644 --- a/release/man3/strspn.3 +++ b/release/man3/strspn.3 @@ -64,6 +64,6 @@ SVr4, 4.3BSD, C89, C99. \fBstrpbrk\fP(3), \fBstrsep\fP(3), \fBstrstr\fP(3), \fBstrtok\fP(3), \fBwcscspn\fP(3), \fBwcsspn\fP(3) .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/strstr.3 b/release/man3/strstr.3 index f69cfb0f..e67d18e3 100644 --- a/release/man3/strstr.3 +++ b/release/man3/strstr.3 @@ -67,6 +67,6 @@ Linux libc の初期のバージョン(4.5.26 まで)は \fBstrstr\fP() 関数 \fBstring\fP(3), \fBstrpbrk\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrtok\fP(3), \fBwcsstr\fP(3) .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/strtod.3 b/release/man3/strtod.3 index e456cdf9..9508b29c 100644 --- a/release/man3/strtod.3 +++ b/release/man3/strtod.3 @@ -122,6 +122,6 @@ C89 では \fBstrtod\fP() が、C99 では残りの 2 つの関数が記述さ .SH 関連項目 \fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3) .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/strtoimax.3 b/release/man3/strtoimax.3 index b1fa0020..6f907b71 100644 --- a/release/man3/strtoimax.3 +++ b/release/man3/strtoimax.3 @@ -49,6 +49,6 @@ C99, POSIX.1\-2001. .SH 関連項目 \fBimaxabs\fP(3), \fBimaxdiv\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3), \fBwcstoimax\fP(3) .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/strtok.3 b/release/man3/strtok.3 index 7dafe2ec..2e615549 100644 --- a/release/man3/strtok.3 +++ b/release/man3/strtok.3 @@ -1,5 +1,6 @@ -.\" Copyright (C) 1996 Andries Brouwer (aeb@cwi.nl) -.\" and Copyright (C) 2005 Michael Kerrisk (mtk.manpages@gmail.com) +.\" Copyright (C) 2005, 2013 Michael Kerrisk (mtk.manpages@gmail.com) +.\" a few fragments from an earlier (1996) version by +.\" Andries Brouwer (aeb@cwi.nl) remain. .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this @@ -26,13 +27,14 @@ .\" Rewritten old page, 960210, aeb@cwi.nl .\" Updated, added strtok_r. 2000-02-13 Nicolás Lichtmaier .\" 2005-11-17, mtk: Substantial parts rewritten +.\" 2013-05-19, mtk: added much further detail on the operation of strtok() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH STRTOK 3 2012\-05\-10 GNU "Linux Programmer's Manual" +.TH STRTOK 3 2013\-05\-19 GNU "Linux Programmer's Manual" .SH 名前 strtok, strtok_r \- 文字列からトークンを取り出す .SH 書式 @@ -53,8 +55,10 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 _XOPEN_SOURCE || _POSIX_SOURCE .ad b .SH 説明 -\fBstrtok\fP() 関数は文字列を解析してトークンに分割する。 \fBstrtok\fP() を最初に呼び出す際には、解析対象の文字列を \fIstr\fP -に 指定する。同じ文字列の解析を行うその後の呼び出しでは、 \fIstr\fP には NULL を指定する。 +The \fBstrtok\fP() function breaks a string into a sequence of zero or more +nonempty tokens. On the first call to \fBstrtok\fP() the string to be parsed +should be specified in \fIstr\fP. In each subsequent call that should parse +the same string, \fIstr\fP must be NULL. \fIdelim\fP 引き数には、解析対象の文字列をトークンに区切るのに使用する バイト集合を指定する。同じ文字列を解析する一連の呼び出しにおいて、 @@ -64,14 +68,36 @@ _XOPEN_SOURCE || _POSIX_SOURCE された文字列へのポインタが返される。この文字列には区切りバイトは含まれ ない。これ以上トークンが見つからなかった場合には、NULL が返される。 -解析対象の文字列に 2 つ以上の区切りバイトが連続している場合には、 -一つの区切りバイトとみなされる。 文字列の先頭や末尾にある区切りバイトは -無視される。言い換えると、 \fBstrtok\fP() が返すトークンは必ず空でない -文字列となる。 +A sequence of calls to \fBstrtok\fP() that operate on the same string +maintains a pointer that determines the point from which to start searching +for the next token. The first call to \fBstrtok\fP() sets this pointer to +point to the first byte of the string. The start of the next token is +determined by scanning forward for the next nondelimiter byte in \fIstr\fP. If +such a byte is found, it is taken as the start of the next token. If no +such byte is found, then there are no more tokens, and \fBstrtok\fP() returns +NULL. (A string that is empty or that contains only delimiters will thus +cause \fBstrtok\fP() to return NULL on the first call.) -\fBstrtok_r\fP() 関数は \fBstrtok\fP() のリエントラント版である。 \fIsaveptr\fP 引き数は \fIchar *\fP -変数へのポインタであり、 同じ文字列の解析を行う \fBstrtok_r\fP() の呼び出し間で処理状況を保存するために \fBstrtok_r\fP() -内部で使用される。 +The end of each token is found by scanning forward until either the next +delimiter byte is found or until the terminating null byte (\(aq\e0\(aq) is +encountered. If a delimiter byte is found, it is overwritten with a null +byte to terminate the current token, and \fBstrtok\fP() saves a pointer to the +following byte; that pointer will be used as the starting point when +searching for the next token. In this case, \fBstrtok\fP() returns a pointer +to the start of the found token. + +From the above description, it follows that a sequence of two or more +contiguous delimiter bytes in the parsed string is considered to be a single +delimiter, and that delimiter bytes at the start or end of the string are +ignored. Put another way: the tokens returned by \fBstrtok\fP() are always +nonempty strings. Thus, for example, given the string "\fIaaa;;bbb,\fP", +successive calls to \fBstrtok\fP() that specify the delimiter string "\fI;,\fP" +would return the strings "\fIaaa\fP" and "\fIbbb\fP", and then a NULL pointer. + +The \fBstrtok_r\fP() function is a reentrant version \fBstrtok\fP(). The +\fIsaveptr\fP argument is a pointer to a \fIchar\ *\fP variable that is used +internally by \fBstrtok_r\fP() in order to maintain context between successive +calls that parse the same string. \fBstrtok_r\fP() を最初に呼び出す際には、 \fIstr\fP は解析対象の文字列を指していなければならず、 \fIsaveptr\fP の値は無視される。それ以降の呼び出しでは、 \fIstr\fP は NULL とし、 \fIsaveptr\fP @@ -80,6 +106,11 @@ _XOPEN_SOURCE || _POSIX_SOURCE \fBstrtok_r\fP() の呼び出し時に異なる \fIsaveptr\fP 引き数を指定することで、 異なる文字列の解析を同時に行うことができる。 .SH 返り値 \fBstrtok\fP() と \fBstrtok_r\fP() は次のトークンへのポインタか、 トークンがなければ NULL を返す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBstrtok\fP() function is not thread\-safe. +.LP +The \fBstrtok_r\fP() function is thread\-safe. .SH 準拠 .TP \fBstrtok\fP() @@ -164,6 +195,6 @@ main(int argc, char *argv[]) \fBindex\fP(3), \fBmemchr\fP(3), \fBrindex\fP(3), \fBstrchr\fP(3), \fBstring\fP(3), \fBstrpbrk\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBwcstok\fP(3) .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/strtol.3 b/release/man3/strtol.3 index 2314780b..0c493e5c 100644 --- a/release/man3/strtol.3 +++ b/release/man3/strtol.3 @@ -99,8 +99,8 @@ XOPEN_SOURCE\ >=\ 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE \fBLLONG_MAX\fP, \fBLLONG_MIN\fP) が返る可能性があるので、 プログラムは関数を呼び出す前に \fIerrno\fP を 0 に設定し、呼び出し後に \fIerrno\fP が 0 以外の値かどうかを確認しエラーが発生したかどうかを判断する 必要がある。 -According to POSIX.1\-2001, in locales other than the "C" and "POSIX", these -functions may accept other, implementation\-defined numeric strings. +POSIX.1\-2001 では、 "C" と "POSIX" +以外のロケールでは、これらの関数は、他の実装時に定義される数字を示す文字列を受け付けるとされている。 .LP BSD には、 .sp @@ -187,6 +187,6 @@ main(int argc, char *argv[]) .SH 関連項目 \fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBstrtod\fP(3), \fBstrtoul\fP(3) .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/strtoul.3 b/release/man3/strtoul.3 index 218d7011..77166065 100644 --- a/release/man3/strtoul.3 +++ b/release/man3/strtoul.3 @@ -122,6 +122,6 @@ BSD には、 .SH 関連項目 \fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3) .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/strverscmp.3 b/release/man3/strverscmp.3 index 5f9df8df..eb5f2978 100644 --- a/release/man3/strverscmp.3 +++ b/release/man3/strverscmp.3 @@ -65,6 +65,6 @@ strverscmp \- 2つのバージョン文字列を比較する .SH 関連項目 \fBrename\fP(1), \fBstrcasecmp\fP(3), \fBstrcmp\fP(3), \fBstrcoll\fP(3) .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/strxfrm.3 b/release/man3/strxfrm.3 index e644b381..f1e6852c 100644 --- a/release/man3/strxfrm.3 +++ b/release/man3/strxfrm.3 @@ -55,12 +55,12 @@ strxfrm \- 文字列の変換 .SH 準拠 SVr4, 4.3BSD, C89, C99. .SH 注意 -\fI"POSIX"\fP または \fI"C"\fP ロケールでは、関数 \fBstrxfrm\fP() は、 関数 \fBstrncpy\fP(3) -を使って文字列をコピーするのと同じである。 +In the \fIPOSIX\fP or \fIC\fP locales \fBstrxfrm\fP() is equivalent to copying the +string with \fBstrncpy\fP(3). .SH 関連項目 \fBbcmp\fP(3), \fBmemcmp\fP(3), \fBsetlocale\fP(3), \fBstrcasecmp\fP(3), \fBstrcmp\fP(3), \fBstrcoll\fP(3), \fBstring\fP(3) .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/swab.3 b/release/man3/swab.3 index 686303c1..553dc051 100644 --- a/release/man3/swab.3 +++ b/release/man3/swab.3 @@ -56,6 +56,6 @@ SVr4, 4.3BSD, POSIX.1\-2001. .SH 関連項目 \fBbstring\fP(3) .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/sysconf.3 b/release/man3/sysconf.3 index cde30911..6b60098f 100644 --- a/release/man3/sysconf.3 +++ b/release/man3/sysconf.3 @@ -94,11 +94,13 @@ POSIX では、アプリケーションがコンパイル時や実行時に、 \fBexec\fP(3) 関数群の引き数の最大長。 \fB_POSIX_ARG_MAX\fP (4096) 未満であってはならない。 .TP \fBCHILD_MAX\fP \- \fB_SC_CHILD_MAX\fP -ユーザID あたりの同時に存在できるプロセスの最大数。 \fB_POSIX_CHILD_MAX\fP (25) 未満であってはならない。 +The maximum number of simultaneous processes per user ID. Must not be less +than \fB_POSIX_CHILD_MAX\fP (25). .TP \fBHOST_NAME_MAX\fP \- \fB_SC_HOST_NAME_MAX\fP -\fBgethostname\fP(2) で返されるホスト名の最大長。末尾の NULL バイトは長さに含まれない。 -\fB_POSIX_HOST_NAME_MAX\fP (255) 未満であってはならない。 +Maximum length of a hostname, not including the terminating null byte, as +returned by \fBgethostname\fP(2). Must not be less than +\fB_POSIX_HOST_NAME_MAX\fP (255). .TP \fBLOGIN_NAME_MAX\fP \- \fB_SC_LOGIN_NAME_MAX\fP ログイン名の長さの最大値。末尾の NULL バイトも長さに含まれる。 \fB_POSIX_LOGIN_NAME_MAX\fP (9) 未満であってはならない。 @@ -208,6 +210,6 @@ POSIX.1\-2001. \fBbc\fP(1), \fBexpr\fP(1), \fBgetconf\fP(1), \fBlocale\fP(1), \fBfpathconf\fP(3), \fBpathconf\fP(3), \fBposixoptions\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/syslog.3 b/release/man3/syslog.3 index 2561f99a..4e34fe5e 100644 --- a/release/man3/syslog.3 +++ b/release/man3/syslog.3 @@ -223,6 +223,6 @@ UNIX の多くのバージョンで使用可能である。 .SH 関連項目 \fBlogger\fP(1), \fBsetlogmask\fP(3), \fBsyslog.conf\fP(5), \fBsyslogd\fP(8) .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/system.3 b/release/man3/system.3 index 4a6a7d0f..7094376c 100644 --- a/release/man3/system.3 +++ b/release/man3/system.3 @@ -94,6 +94,6 @@ POSIX.1\-2001 ではシェルが提供されているという標準に準拠し .SH 関連項目 \fBsh\fP(1), \fBsignal\fP(2), \fBwait\fP(2), \fBexec\fP(3) .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/sysv_signal.3 b/release/man3/sysv_signal.3 index 892dcead..b6a70cc3 100644 --- a/release/man3/sysv_signal.3 +++ b/release/man3/sysv_signal.3 @@ -62,6 +62,6 @@ sysv_signal \- System V 方式のシグナル処理 .SH 関連項目 \fBsigaction\fP(2), \fBsignal\fP(2), \fBbsd_signal\fP(3), \fBsignal\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/tan.3 b/release/man3/tan.3 index 911472fe..9bb86149 100644 --- a/release/man3/tan.3 +++ b/release/man3/tan.3 @@ -111,6 +111,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 \fBacos\fP(3), \fBasin\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcos\fP(3), \fBctan\fP(3), \fBsin\fP(3) .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/tanh.3 b/release/man3/tanh.3 index e6b45340..68cd09f6 100644 --- a/release/man3/tanh.3 +++ b/release/man3/tanh.3 @@ -91,6 +91,6 @@ C99, POSIX.1\-2001. \fIdouble\fP 版の関数は SVr4, 4.3BSD, C89 にも準拠 .SH 関連項目 \fBacosh\fP(3), \fBasinh\fP(3), \fBatanh\fP(3), \fBcosh\fP(3), \fBctanh\fP(3), \fBsinh\fP(3) .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/tcgetpgrp.3 b/release/man3/tcgetpgrp.3 index 9bca606b..e0b55700 100644 --- a/release/man3/tcgetpgrp.3 +++ b/release/man3/tcgetpgrp.3 @@ -80,6 +80,6 @@ POSIX.1\-2001. .SH 関連項目 \fBsetpgid\fP(2), \fBsetsid\fP(2), \fBcredentials\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/tcgetsid.3 b/release/man3/tcgetsid.3 index e8062c53..a772736f 100644 --- a/release/man3/tcgetsid.3 +++ b/release/man3/tcgetsid.3 @@ -58,6 +58,6 @@ POSIX.1\-2001. .SH 関連項目 \fBgetsid\fP(2) .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/telldir.3 b/release/man3/telldir.3 index 2df8837e..a50ca929 100644 --- a/release/man3/telldir.3 +++ b/release/man3/telldir.3 @@ -72,6 +72,6 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3), \fBscandir\fP(3), \fBseekdir\fP(3) .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/tempnam.3 b/release/man3/tempnam.3 index 8a337369..d9544948 100644 --- a/release/man3/tempnam.3 +++ b/release/man3/tempnam.3 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH TEMPNAM 3 2008\-08\-06 "" "Linux Programmer's Manual" +.TH TEMPNAM 3 2013\-04\-19 "" "Linux Programmer's Manual" .SH 名前 tempnam \- テンポラリファイルの名前を作成する .SH 書式 @@ -64,7 +64,9 @@ d) .PP \fBtempnam\fP() が返す文字列は \fBmalloc\fP(3) を使って確保される。そのため、 \fBfree\fP(3) で解放すべきである。 .SH 返り値 -\fBtempnam\fP() 関数は他と重ならないテンポラリファイル名へのポインタを返す。 他と重ならない名前が生成できなければ NULL を返す。 +On succes, the \fBtempnam\fP() function returns a pointer to a unique +temporary filename. It returns NULL if a unique name cannot be generated, +with \fIerrno\fP set to indicate the cause of the error. .SH エラー .TP \fBENOMEM\fP @@ -98,6 +100,6 @@ SUSv2 では \fBTMPDIR\fP に付いて言及されていない。 glibc は、 .SH 関連項目 \fBmkstemp\fP(3), \fBmktemp\fP(3), \fBtmpfile\fP(3), \fBtmpnam\fP(3) .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/termios.3 b/release/man3/termios.3 index 08fb966d..b1daf281 100644 --- a/release/man3/termios.3 +++ b/release/man3/termios.3 @@ -614,6 +614,6 @@ DU, Tru64 は \fIduration\fP ミリ秒のブレークを送信する。 FreeBSD, .SH 関連項目 \fBstty\fP(1), \fBconsole_ioctl\fP(4), \fBtty_ioctl\fP(4), \fBsetserial\fP(8) .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/tgamma.3 b/release/man3/tgamma.3 index 96574897..f0fcebd9 100644 --- a/release/man3/tgamma.3 +++ b/release/man3/tgamma.3 @@ -123,6 +123,6 @@ glibc バージョン 2.3.3 以前では、 引き数に +0 や \-0 を渡すと .SH 関連項目 \fBgamma\fP(3), \fBlgamma\fP(3) .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/timegm.3 b/release/man3/timegm.3 index 3dc1f744..1a9ab7f6 100644 --- a/release/man3/timegm.3 +++ b/release/man3/timegm.3 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH TIMEGM 3 2007\-07\-26 GNU "Linux Programmer's Manual" +.TH TIMEGM 3 2013\-07\-04 GNU "Linux Programmer's Manual" .SH 名前 timegm, timelocal \- gmtime と localtime の逆関数 .SH 書式 @@ -66,12 +66,15 @@ time_t my_timegm (struct tm *tm) char *tz; tz = getenv("TZ"); + if (tz) + tz = strdup(tz); setenv("TZ", "", 1); tzset(); ret = mktime(tm); - if (tz) + if (tz) { setenv("TZ", tz, 1); - else + free(tz); + } else unsetenv("TZ"); tzset(); return ret; @@ -81,6 +84,6 @@ time_t my_timegm (struct tm *tm) .SH 関連項目 \fBgmtime\fP(3), \fBlocaltime\fP(3), \fBmktime\fP(3), \fBtzset\fP(3) .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/timeradd.3 b/release/man3/timeradd.3 index 05c72a36..3d918ab5 100644 --- a/release/man3/timeradd.3 +++ b/release/man3/timeradd.3 @@ -100,6 +100,6 @@ POSIX.1\-2001 にはない。 ほとんどの BSD 由来のシステムには存 .SH 関連項目 \fBgettimeofday\fP(2), \fBtime\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/tmpfile.3 b/release/man3/tmpfile.3 index d4785ff7..9d761266 100644 --- a/release/man3/tmpfile.3 +++ b/release/man3/tmpfile.3 @@ -80,6 +80,6 @@ POSIX.1\-2001 では、 ストリームをオープンできなかった場合 .SH 関連項目 \fBexit\fP(3), \fBmkstemp\fP(3), \fBmktemp\fP(3), \fBtempnam\fP(3), \fBtmpnam\fP(3) .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/tmpnam.3 b/release/man3/tmpnam.3 index 11f32ed6..9a4e95a7 100644 --- a/release/man3/tmpnam.3 +++ b/release/man3/tmpnam.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH TMPNAM 3 2010\-09\-10 "" "Linux Programmer's Manual" +.TH TMPNAM 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 tmpnam, tmpnam_r \- 一時ファイルの名前を作成する .SH 書式 @@ -51,6 +51,12 @@ tmpnam, tmpnam_r \- 一時ファイルの名前を作成する \fBtmpnam\fP() 関数は一意な一時ファイル名へのポインタを返す。 一意なファイル名が作成できなかった場合は NULL を返す。 .SH エラー エラーは定義されていない。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBtmpnam\fP() function is thread\-safe with exceptions. It is not +thread\-safe if called with a NULL parameter. +.LP +The \fBtmpnam_r\fP() function is thread\-safe. .SH 準拠 SVr4, 4.3BSD, C89, C99, POSIX.1\-2001. POSIX.1\-2008 は \fBtmpnam\fP() を廃止予定としている。 @@ -88,6 +94,6 @@ tmpnam_r(char *s) .SH 関連項目 \fBmkstemp\fP(3), \fBmktemp\fP(3), \fBtempnam\fP(3), \fBtmpfile\fP(3) .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/toascii.3 b/release/man3/toascii.3 index e5bb1aca..fbea49dc 100644 --- a/release/man3/toascii.3 +++ b/release/man3/toascii.3 @@ -57,6 +57,6 @@ SVr4, BSD, POSIX.1\-2001. POSIX.1\-2008 は \fBtoascii\fP() を廃止予定と .SH 関連項目 \fBisascii\fP(3), \fBtolower\fP(3), \fBtoupper\fP(3) .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/toupper.3 b/release/man3/toupper.3 index 5c0adee2..30553c1e 100644 --- a/release/man3/toupper.3 +++ b/release/man3/toupper.3 @@ -58,6 +58,6 @@ C89, C99, 4.3BSD. .SH 関連項目 \fBisalpha\fP(3), \fBsetlocale\fP(3), \fBtowlower\fP(3), \fBtowupper\fP(3), \fBlocale\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/towctrans.3 b/release/man3/towctrans.3 index 9a7a4dd6..4d6acb21 100644 --- a/release/man3/towctrans.3 +++ b/release/man3/towctrans.3 @@ -41,6 +41,6 @@ C99. .SH 関連項目 \fBtowlower\fP(3), \fBtowupper\fP(3), \fBwctrans\fP(3) .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/towlower.3 b/release/man3/towlower.3 index 5c8ffab5..9578b122 100644 --- a/release/man3/towlower.3 +++ b/release/man3/towlower.3 @@ -43,6 +43,6 @@ case)・ タイトル文字 (title case) という 3 つの "case" が含まれ .SH 関連項目 \fBiswlower\fP(3), \fBtowctrans\fP(3), \fBtowupper\fP(3) .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/towupper.3 b/release/man3/towupper.3 index eb7b50cc..e9fbbb49 100644 --- a/release/man3/towupper.3 +++ b/release/man3/towupper.3 @@ -43,6 +43,6 @@ case)・ タイトル文字 (title case) という 3 つの "case" が含まれ .SH 関連項目 \fBiswupper\fP(3), \fBtowctrans\fP(3), \fBtowlower\fP(3) .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/trunc.3 b/release/man3/trunc.3 index c144de91..5cc1504b 100644 --- a/release/man3/trunc.3 +++ b/release/man3/trunc.3 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH TRUNC 3 2010\-09\-20 "" "Linux Programmer's Manual" +.TH TRUNC 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 trunc, truncf, truncl \- 0 に近い方の整数値に丸める .SH 書式 @@ -65,6 +65,9 @@ or \fIcc\ \-std=c99\fP エラーは発生しない。 .SH バージョン これらの関数は glibc バージョン 2.1 で初めて登場した。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBtrunc\fP(), \fBtruncf\fP(), and \fBtruncl\fP() functions are thread\-safe. .SH 準拠 C99, POSIX.1\-2001. .SH 注意 @@ -75,6 +78,6 @@ C99, POSIX.1\-2001. \fBceil\fP(3), \fBfloor\fP(3), \fBlrint\fP(3), \fBnearbyint\fP(3), \fBrint\fP(3), \fBround\fP(3) .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/tsearch.3 b/release/man3/tsearch.3 index fb46f904..2de98f43 100644 --- a/release/man3/tsearch.3 +++ b/release/man3/tsearch.3 @@ -57,7 +57,7 @@ tsearch, tfind, tdelete, twalk, tdestroy \- 二分木 (binary tree) の操作 \fBtsearch\fP(), \fBtfind\fP(), \fBtwalk\fP(), \fBtdelete\fP() は 二分木を操作する関数である。 これらの関数は Knuth (6.2.2) Algorithm T に基づいている。 木構造における各ノードの最初のフィールドは、対応するデータ・ アイテムへのポインタである。 (参照先のデータは、呼び出しプログラムで用意する。) \fIcompar\fP は比較ルーチンへのポインタである。 -比較ルーチンは、アイテムへのポインタ 2 つを引数に持つ。 比較ルーチンの返り値は、1 つ目のアイテムが 2 つ目のアイテムよりも +比較ルーチンは、アイテムへのポインタ 2 つを引き数に持つ。 比較ルーチンの返り値は、1 つ目のアイテムが 2 つ目のアイテムよりも 「小さい、等しい、大きい」によって、 「負、0、正」の整数値でなければならない。 .PP \fBtsearch\fP() は、木構造からアイテムを検索する関数である。 \fIkey\fP は、検索するアイテムへのポインタである。 \fIrootp\fP @@ -67,30 +67,23 @@ Knuth (6.2.2) Algorithm T に基づいている。 木構造における各ノ .PP \fBtfind\fP() は、 \fBtsearch\fP() に似ているが、 アイテムが見つからなかった場合 NULL を返す点が異なる。 .PP -\fBtdelete\fP() は木構造からアイテムを削除する。 引数は \fBtsearch\fP() と同じである。 +\fBtdelete\fP() は木構造からアイテムを削除する。 引き数は \fBtsearch\fP() と同じである。 .PP -\fBtwalk\fP() performs depth\-first, left\-to\-right traversal of a binary tree. -\fIroot\fP points to the starting node for the traversal. If that node is not -the root, then only part of the tree will be visited. \fBtwalk\fP() calls the -user function \fIaction\fP each time a node is visited (that is, three times -for an internal node, and once for a leaf). \fIaction\fP, in turn, takes three -arguments. The first argument is a pointer to the node being visited. The -structure of the node is unspecified, but it is possible to cast the pointer -to a pointer\-to\-pointer\-to\-element in order to access the element stored -within the node. The application must not modify the structure pointed to -by this argument. The second argument is an integer which takes one of the -values \fBpreorder\fP, \fBpostorder\fP, or \fBendorder\fP depending on whether this -is the first, second, or third visit to the internal node, or the value -\fBleaf\fP if this is the single visit to a leaf node. (These symbols are -defined in \fI\fP.) The third argument is the depth of the -node; the root node has depth zero. +\fBtwalk\fP() は、二分木を深さ優先 (depth\-first) で、 左から右にたどっていく関数である。 \fIroot\fP +は起点となるノードへのポインタである。 \fIroot\fP に根以外のノードを指定すると、部分木が対象となる。 \fBtwalk\fP() +は、ノードを訪れる度にユーザ関数 \fIaction\fP を呼び出す (内部ノードに対しては 3 回、葉に対しては 1 回呼び出しが行われる)。 +\fIaction\fP には以下の順に 3 つの引き数が与えられる。 最初の引き数は訪れたノードへのポインタである。 ノードの構造体は規定されていないが、 +ポインタを要素へのポインタのポインタにキャストし、 ノードに格納された要素にアクセスすることができる。 +アプリケーションは、この引き数が指す構造体を変更してはならない。 2 番目の引き数には、内部ノードの場合は訪問回数に応じて \fBpreorder\fP, +\fBpostorder\fP, \fBendorder\fP のいずれかの整数が、 葉を最初に訪れた場合は \fBleaf\fP の値が渡される (これらのシンボルは +\fI\fP で定義されている)。 3 番目の引き数はノードの深さで、根の場合は深さ 0 である。 .PP (より一般的には、\fBpreorder\fP, \fBpostorder\fP, \fBendorder\fP は \fBpreorder\fP, \fBinorder\fP, \fBpostorder\fP として知られている: それぞれ、子要素を辿る前・最初の子要素を辿った後かつ 2 番目の子要素を辿る前・ 子要素を辿った後ということを表している。 よって \fBpost\%order\fP という名前を選ぶのは少し紛らわしい。) .PP \fBtdestroy\fP() は \fIroot\fP が指す木構造全体を削除し、 \fBtsearch\fP() 関数で確保されたリソースを全て解放する。 -木構造の各ノードについて、関数 \fIfree_node\fP が呼び出される。 データへのポインタがこの関数の引数として渡される。 +木構造の各ノードについて、関数 \fIfree_node\fP が呼び出される。 データへのポインタがこの関数の引き数として渡される。 そのような動作が必要でなければ、 \fIfree_node\fP は何もしない関数へのポインタでなければならない。 .SH 返り値 \fBtsearch\fP() は、木構造に見つかったアイテムか、 新しく追加したアイテムへのポインタを返す。 @@ -103,11 +96,11 @@ node; the root node has depth zero. .SH 準拠 SVr4, POSIX.1\-2001. 関数 \fBtdestroy\fP() は GNU の拡張である。 .SH 注意 -\fBtwalk\fP() は根へのポインタを引数にとるが、 ほかの関数は根へのポインタへのポインタである。 +\fBtwalk\fP() は根へのポインタを引き数にとるが、 ほかの関数は根へのポインタへのポインタである。 .PP \fBtdelete\fP() は、削除したノードの使用していたメモリを解放するが、 ノードに対応するデータのメモリは、ユーザが解放しなければならない。 .PP -下のプログラム例は、ユーザ関数が "endorder" か "leaf" を引数にして 呼び出されて以降は、 \fBtwalk\fP() +下のプログラム例は、ユーザ関数が "endorder" か "leaf" を引き数にして 呼び出されて以降は、 \fBtwalk\fP() がそのノードを参照しないことを前提としている。 これは GNU ライブラリの実装では機能するが、System V のマニュアルには存在しない。 .SH 例 以下のプログラムは 12 個の乱数を二分木に挿入した後、 挿入した数を順番に出力する (挿入の際、重複した乱数は 1 つにまとめられる)。 @@ -187,6 +180,6 @@ main(void) .SH 関連項目 \fBbsearch\fP(3), \fBhsearch\fP(3), \fBlsearch\fP(3) \fBqsort\fP(3) .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/ttyname.3 b/release/man3/ttyname.3 index d344d3e6..dc965453 100644 --- a/release/man3/ttyname.3 +++ b/release/man3/ttyname.3 @@ -29,7 +29,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH TTYNAME 3 2012\-12\-21 Linux "Linux Programmer's Manual" +.TH TTYNAME 3 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 ttyname, ttyname_r \- 端末名を返す .SH 書式 @@ -58,11 +58,16 @@ ttyname, ttyname_r \- 端末名を返す .TP \fBERANGE\fP (\fBttyname_r\fP()) \fIbuflen\fP がパス名を格納するには短すぎる。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBttyname\fP() function is not thread\-safe. +.LP +The \fBttyname_r\fP() function is thread\-safe. .SH 準拠 4.2BSD, POSIX.1\-2001. .SH 関連項目 \fBfstat\fP(2), \fBctermid\fP(3), \fBisatty\fP(3) .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/ttyslot.3 b/release/man3/ttyslot.3 index eb5d864c..e620196c 100644 --- a/release/man3/ttyslot.3 +++ b/release/man3/ttyslot.3 @@ -30,7 +30,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH TTYSLOT 3 2010\-09\-20 GNU "Linux Programmer's Manual" +.TH TTYSLOT 3 2013\-06\-21 GNU "Linux Programmer's Manual" .SH 名前 ttyslot \- カレントユーザの端末のスロットをファイルから探す .SH 書式 @@ -82,6 +82,10 @@ UNIX V7 ではフォーマットが変更された: 2 文字目が \fBgetty\fP(8 成功した場合、この関数はスロット番号を返す。 エラーの場合 (例えば、ファイルディスクリプタ 0, 1, 2 の何れも データベースにある端末に関連づけられていない場合)、 UNIX V6, V7, BSD 系のシステムは 0 を返すが、 System V 系のシステムは \-1 を返す。 +.SH ATTRIBUTES +.SS "Multithreading (see pthreads(7))" +The \fBttyslot\fP() calls thread\-unsafe function \fBgetttyent\fP(), so it is not +thread\-safe. .SH 準拠 SUSv1。SUSv2 では「過去の名残 (LEGACY)」と位置付けられている。 POSIX.1\-2001 で削除された。 SUSv2 ではエラー時に \-1 を返すことが要求されている。 @@ -100,6 +104,6 @@ Minix には \fIfttyslot\fP(\fIfd\fP) もある。 .SH 関連項目 \fBgetttyent\fP(3), \fBttyname\fP(3), \fButmp\fP(5) .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/tzset.3 b/release/man3/tzset.3 index d6754798..2bffbbca 100644 --- a/release/man3/tzset.3 +++ b/release/man3/tzset.3 @@ -171,6 +171,6 @@ SVr4, POSIX.1\-2001, 4.3BSD. \fBdate\fP(1), \fBgettimeofday\fP(2), \fBtime\fP(2), \fBctime\fP(3), \fBgetenv\fP(3), \fBtzfile\fP(5) .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/ualarm.3 b/release/man3/ualarm.3 index f5401261..bb6f83ca 100644 --- a/release/man3/ualarm.3 +++ b/release/man3/ualarm.3 @@ -98,6 +98,6 @@ POSIX.1\-2001 では、 \fIusecs\fP 引き数が 0 の場合、何が起こる \fBalarm\fP(2), \fBgetitimer\fP(2), \fBnanosleep\fP(2), \fBselect\fP(2), \fBsetitimer\fP(2), \fBusleep\fP(3), \fBtime\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/ulimit.3 b/release/man3/ulimit.3 index aab846ee..818fd330 100644 --- a/release/man3/ulimit.3 +++ b/release/man3/ulimit.3 @@ -65,6 +65,6 @@ SVr4, POSIX.1\-2001. POSIX.1\-2008 は \fBulimit\fP() を廃止予定として .SH 関連項目 \fBbash\fP(1), \fBgetrlimit\fP(2), \fBsetrlimit\fP(2), \fBsysconf\fP(3) .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/undocumented.3 b/release/man3/undocumented.3 index 9082c3db..b97f6436 100644 --- a/release/man3/undocumented.3 +++ b/release/man3/undocumented.3 @@ -89,6 +89,6 @@ none \- ドキュメントがないライブラリ関数 \fByp_master\fP(3), \fByp_match\fP(3), \fByp_next\fP(3), \fByp_order\fP(3), \fBypprot_err\fP(3), \fByp_unbind\fP(3), \fByp_update\fP(3) .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/ungetwc.3 b/release/man3/ungetwc.3 index c49daf01..ea2bcca5 100644 --- a/release/man3/ungetwc.3 +++ b/release/man3/ungetwc.3 @@ -51,6 +51,6 @@ C99. .SH 関連項目 \fBfgetwc\fP(3) .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/unlocked_stdio.3 b/release/man3/unlocked_stdio.3 index 65c2b170..576b8042 100644 --- a/release/man3/unlocked_stdio.3 +++ b/release/man3/unlocked_stdio.3 @@ -117,6 +117,6 @@ _GNU_SOURCE .SH 関連項目 \fBflockfile\fP(3), \fBstdio\fP(3) .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/unlockpt.3 b/release/man3/unlockpt.3 index 8688b80d..fced3f1c 100644 --- a/release/man3/unlockpt.3 +++ b/release/man3/unlockpt.3 @@ -38,6 +38,6 @@ POSIX.1\-2001. .SH 関連項目 \fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBptsname\fP(3), \fBpts\fP(4), \fBpty\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/updwtmp.3 b/release/man3/updwtmp.3 index 79c58397..8319c6d9 100644 --- a/release/man3/updwtmp.3 +++ b/release/man3/updwtmp.3 @@ -71,6 +71,6 @@ glibc2 の下ではどちらの関数も利用可能である。 libc5 の下で .SH 関連項目 \fBgetutxent\fP(3), \fBwtmp\fP(5) .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/usleep.3 b/release/man3/usleep.3 index 3d26aa35..30817163 100644 --- a/release/man3/usleep.3 +++ b/release/man3/usleep.3 @@ -35,7 +35,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH USLEEP 3 2010\-12\-03 "" "Linux Programmer's Manual" +.TH USLEEP 3 2013\-04\-19 "" "Linux Programmer's Manual" .SH 名前 usleep \- マイクロ秒単位で実行を延期する .SH 書式 @@ -70,7 +70,8 @@ glibc 2.12 より前: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ && \fBusleep\fP() 関数は (少なくとも) \fIusec\fPマイクロ秒の間、 呼び出し元スレッドの実行を延期する。 システムの動作状況や呼び出しによる時間の消費やシステムタイマの粒度によって、 停止時間は設定した値よりも少し延ばされるかもしれない。 .SH 返り値 -成功すると 0、エラーの場合 \-1 を返す。 +The \fBusleep\fP() function returns 0 on success. On error, \-1 is returned, +with \fIerrno\fP set to indicate the cause of the error. .SH エラー .TP \fBEINTR\fP @@ -108,6 +109,6 @@ glibc 2.12 より前: _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ && \fBalarm\fP(2), \fBgetitimer\fP(2), \fBnanosleep\fP(2), \fBselect\fP(2), \fBsetitimer\fP(2), \fBsleep\fP(3), \fBualarm\fP(3), \fBtime\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/wcpcpy.3 b/release/man3/wcpcpy.3 index 794aa003..a69ac981 100644 --- a/release/man3/wcpcpy.3 +++ b/release/man3/wcpcpy.3 @@ -58,6 +58,6 @@ POSIX.1\-2008. .SH 関連項目 \fBstrcpy\fP(3), \fBwcscpy\fP(3) .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/wcpncpy.3 b/release/man3/wcpncpy.3 index 1de3e965..bda83831 100644 --- a/release/man3/wcpncpy.3 +++ b/release/man3/wcpncpy.3 @@ -55,12 +55,13 @@ _GNU_SOURCE .PP プログラマは、少なくとも \fIn\fP 個のワイド文字が入る領域を \fIdest\fP に確保しなければならない。 .SH 返り値 -\fBwcpncpy\fP() は、最後に書き込まれたワイド文字へのポインタ、 すなわち \fIdest + n \- 1\fP を返す。 +\fBwcpncpy\fP() returns a pointer to the last wide character written, that is, +\fIdest\fP+\fIn\fP\-\fI1"\fP. .SH 準拠 POSIX.1\-2008. .SH 関連項目 \fBstpncpy\fP(3), \fBwcsncpy\fP(3) .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/wcrtomb.3 b/release/man3/wcrtomb.3 index da58a055..45f826c7 100644 --- a/release/man3/wcrtomb.3 +++ b/release/man3/wcrtomb.3 @@ -59,6 +59,6 @@ C99. .SH 関連項目 \fBwcsrtombs\fP(3) .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/wcscasecmp.3 b/release/man3/wcscasecmp.3 index fc51a127..f04a8990 100644 --- a/release/man3/wcscasecmp.3 +++ b/release/man3/wcscasecmp.3 @@ -61,6 +61,6 @@ POSIX.1\-2008. この関数は POSIX.1\-2001 では規定されていないが .SH 関連項目 \fBstrcasecmp\fP(3), \fBwcscmp\fP(3) .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/wcscat.3 b/release/man3/wcscat.3 index d24feb65..4a6b8779 100644 --- a/release/man3/wcscat.3 +++ b/release/man3/wcscat.3 @@ -42,6 +42,6 @@ C99. .SH 関連項目 \fBstrcat\fP(3), \fBwcpcpy\fP(3), \fBwcscpy\fP(3), \fBwcsncat\fP(3) .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/wcschr.3 b/release/man3/wcschr.3 index f9240633..57f4593a 100644 --- a/release/man3/wcschr.3 +++ b/release/man3/wcschr.3 @@ -38,6 +38,6 @@ C99. .SH 関連項目 \fBstrchr\fP(3), \fBwcspbrk\fP(3), \fBwcsrchr\fP(3), \fBwcsstr\fP(3), \fBwmemchr\fP(3) .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/wcscmp.3 b/release/man3/wcscmp.3 index b8ded42b..719cba74 100644 --- a/release/man3/wcscmp.3 +++ b/release/man3/wcscmp.3 @@ -39,6 +39,6 @@ C99. .SH 関連項目 \fBstrcmp\fP(3), \fBwcscasecmp\fP(3), \fBwmemcmp\fP(3) .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/wcscpy.3 b/release/man3/wcscpy.3 index 81813f16..82363e33 100644 --- a/release/man3/wcscpy.3 +++ b/release/man3/wcscpy.3 @@ -41,6 +41,6 @@ C99. .SH 関連項目 \fBstrcpy\fP(3), \fBwcpcpy\fP(3), \fBwcscat\fP(3), \fBwcsdup\fP(3), \fBwmemcpy\fP(3) .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/wcscspn.3 b/release/man3/wcscspn.3 index dc9999d3..88978749 100644 --- a/release/man3/wcscspn.3 +++ b/release/man3/wcscspn.3 @@ -41,6 +41,6 @@ C99. .SH 関連項目 \fBstrcspn\fP(3), \fBwcspbrk\fP(3), \fBwcsspn\fP(3) .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/wcsdup.3 b/release/man3/wcsdup.3 index 9ba685f1..0d4306cc 100644 --- a/release/man3/wcsdup.3 +++ b/release/man3/wcsdup.3 @@ -17,7 +17,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH WCSDUP 3 2010\-09\-15 GNU "Linux Programmer's Manual" +.TH WCSDUP 3 2013\-04\-19 GNU "Linux Programmer's Manual" .SH 名前 wcsdup \- ワイド文字文字列を複製する .SH 書式 @@ -51,7 +51,9 @@ _GNU_SOURCE 新しいワイド文字文字列のためのメモリは \fBmalloc\fP(3) を使って割り当てられる。 この領域は \fBfree\fP(3) を使って解放すべきである。 .SH 返り値 -\fBwcsdup\fP() 関数は、新しいワイド文字文字列へのポインタを返す。 十分なメモリがなければ NULL を返す。 +On success, \fBwcsdup\fP() returns a pointer to the new wide\-character +string. On error, it returns \-1, with \fIerrno\fP set to indicate the cause of +the error. .SH エラー .TP \fBENOMEM\fP @@ -62,6 +64,6 @@ POSIX.1\-2008. この関数は POSIX.1\-2001 では規定されていないが .SH 関連項目 \fBstrdup\fP(3), \fBwcscpy\fP(3) .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/wcslen.3 b/release/man3/wcslen.3 index c63230e3..a6a11865 100644 --- a/release/man3/wcslen.3 +++ b/release/man3/wcslen.3 @@ -38,6 +38,6 @@ C99. .SH 関連項目 \fBstrlen\fP(3) .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/wcsncasecmp.3 b/release/man3/wcsncasecmp.3 index 429a8c7d..eb061bfd 100644 --- a/release/man3/wcsncasecmp.3 +++ b/release/man3/wcsncasecmp.3 @@ -62,6 +62,6 @@ POSIX.1\-2008. この関数は POSIX.1\-2001 では規定されていないが .SH 関連項目 \fBstrncasecmp\fP(3), \fBwcsncmp\fP(3) .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/wcsncat.3 b/release/man3/wcsncat.3 index c87ae97f..364580ae 100644 --- a/release/man3/wcsncat.3 +++ b/release/man3/wcsncat.3 @@ -42,6 +42,6 @@ C99. .SH 関連項目 \fBstrncat\fP(3), \fBwcscat\fP(3) .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/wcsncmp.3 b/release/man3/wcsncmp.3 index 27ab2c5c..10f3fc97 100644 --- a/release/man3/wcsncmp.3 +++ b/release/man3/wcsncmp.3 @@ -32,15 +32,18 @@ wcsncmp \- 2 つの固定長ワイド文字文字列を比較する が指すワイド文字文字列と \fIs2\fP が指すワイド文 字文字列を比較するが、最大でも先頭のワイド文字 \fIn\fP 個までしか比較 しない。またいずれかの文字列に NULL ワイド文字 (L\(aq\e0\(aq) が現れたら、 比較はその位置で終了する。 .SH 返り値 -\fBwcsncmp\fP() 関数は、\fIs1\fP と \fIs2\fP がそれぞれ指す文字列を \fIn\fP 文字に収まるように切り詰めたものが等しければ 0 -を返す。 この関数は、異なる文字が最初に現われた位置 \fIi\fP (\fIi\fP < \fIn\fP) において、その位置にある文字 \fIs1[i]\fP が -\fIs2[i]\fP より大きければ 正の値を返す。異なる文字が最初に現われた位置 \fIi\fP (\fIi\fP < \fIn\fP) -において、その位置にある文字 \fIs1[i]\fP が \fIs2[i]\fP より小さければ 負の値を返す。 +The \fBwcsncmp\fP() function returns zero if the wide\-character strings at +\fIs1\fP and \fIs2\fP, truncated to at most length \fIn\fP, are equal. It returns an +integer greater than zero if at the first differing position \fIi\fP (\fIi\fP +< \fIn\fP), the corresponding wide\-character \fIs1[i]\fP is greater than +\fIs2[i]\fP. It returns an integer less than zero if at the first differing +position \fIi\fP (i < \fIn\fP), the corresponding wide\-character \fIs1[i]\fP is +less than \fIs2[i]\fP. .SH 準拠 C99. .SH 関連項目 \fBstrncmp\fP(3), \fBwcsncasecmp\fP(3) .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/wcsncpy.3 b/release/man3/wcsncpy.3 index 8c4e625a..67c51de0 100644 --- a/release/man3/wcsncpy.3 +++ b/release/man3/wcsncpy.3 @@ -44,6 +44,6 @@ C99. .SH 関連項目 \fBstrncpy\fP(3) .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/wcsnlen.3 b/release/man3/wcsnlen.3 index 2b00fc0e..5515af57 100644 --- a/release/man3/wcsnlen.3 +++ b/release/man3/wcsnlen.3 @@ -61,6 +61,6 @@ POSIX.1\-2008. .SH 関連項目 \fBstrnlen\fP(3), \fBwcslen\fP(3) .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/wcsnrtombs.3 b/release/man3/wcsnrtombs.3 index f26653e0..ab817832 100644 --- a/release/man3/wcsnrtombs.3 +++ b/release/man3/wcsnrtombs.3 @@ -54,18 +54,22 @@ _GNU_SOURCE は更新される。実際の効果とし ては、この変換は以下の動作と同じになる: \fIwcrtomb(dest, *src, ps)\fP を呼び、成功が返ったら \fIdest\fP を書き込んだバイト数だけ増やし、\fI*src\fP を 1 増やす。 そして、wcrtomb が成功を返す限りこれを繰り返す。 変換が止まる理由は 3 つ考えられる: -.PP -1. (現在のロケールに基づいて)マルチバイト列で表現できないワイド文字に 出会った場合。この場合は、\fI*src\fP -は不正なワイド文字を指した状態になり、 \fI(size_t)\ \-1\fP が返され、\fIerrno\fP に \fBEILSEQ\fP が設定される。 -.PP -2. NULL ワイド文字 (L\(aq\e0\(aq) に出会わないで \fInwc\fP 個のワイド文字を -変換した場合か、長さの制限によって変換が止められた場合。 この場合には、\fI*src\fP は次に変換されるべきワイド文字を指した状態になり、 -\fIdest\fP に書き込まれたバイト数が返される。 -.PP -3. ワイド文字列が終端の L\(aq\e0\(aq (これには \fI*ps\fP を初期状態に戻すという副作用がある) -も含めて全て変換された場合。この場合には \fI*src\fP に NULL が設定され、 -\fIdest\fP に書き込まれたバイト数が返される -(終端の NULL バイト (\(aq\e0\(aq) は数えない)。 +.IP 1. 3 +A wide character has been encountered that can not be represented as a +multibyte sequence (according to the current locale). In this case \fI*src\fP +is left pointing to the invalid wide character, \fI(size_t)\ \-1\fP is returned, +and \fIerrno\fP is set to \fBEILSEQ\fP. +.IP 2. +\fInwc\fP wide characters have been converted without encountering a null wide +character (L\(aq\e0\(aq), or the length limit forces a stop. In this case +\fI*src\fP is left pointing to the next wide character to be converted, and the +number of bytes written to \fIdest\fP is returned. +.IP 3. +The wide\-character string has been completely converted, including the +terminating null wide character (which has the side effect of bringing back +\fI*ps\fP to the initial state). In this case \fI*src\fP is set to NULL, and the +number of bytes written to \fIdest\fP, excluding the terminating null byte +(\(aq\e0\(aq), is returned. .PP \fIdest\fP が NULL ならば \fIlen\fP は無視されて前述のように変換が行わ れるが、変換されたバイトデータはメモリに書き出されない点と、出力先の長 さの制限がない点が異なる。 @@ -86,6 +90,6 @@ POSIX.1\-2008. .SH 関連項目 \fBiconv\fP(3), \fBwcsrtombs\fP(3) .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/wcspbrk.3 b/release/man3/wcspbrk.3 index 4c67820d..034234cc 100644 --- a/release/man3/wcspbrk.3 +++ b/release/man3/wcspbrk.3 @@ -38,6 +38,6 @@ C99. .SH 関連項目 \fBstrpbrk\fP(3), \fBwcschr\fP(3), \fBwcscspn\fP(3) .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/wcsrchr.3 b/release/man3/wcsrchr.3 index a959f1bb..207f6164 100644 --- a/release/man3/wcsrchr.3 +++ b/release/man3/wcsrchr.3 @@ -38,6 +38,6 @@ C99. .SH 関連項目 \fBstrrchr\fP(3), \fBwcschr\fP(3) .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/wcsrtombs.3 b/release/man3/wcsrtombs.3 index 8157650c..ad6bac41 100644 --- a/release/man3/wcsrtombs.3 +++ b/release/man3/wcsrtombs.3 @@ -64,6 +64,6 @@ C99. .SH 関連項目 \fBiconv\fP(3), \fBwcsnrtombs\fP(3), \fBwcstombs\fP(3) .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/wcsspn.3 b/release/man3/wcsspn.3 index 3fe29566..39290c43 100644 --- a/release/man3/wcsspn.3 +++ b/release/man3/wcsspn.3 @@ -41,6 +41,6 @@ C99. .SH 関連項目 \fBstrspn\fP(3), \fBwcscspn\fP(3) .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/wcsstr.3 b/release/man3/wcsstr.3 index af631c02..ec4318d4 100644 --- a/release/man3/wcsstr.3 +++ b/release/man3/wcsstr.3 @@ -41,6 +41,6 @@ C99. .SH 関連項目 \fBstrstr\fP(3), \fBwcschr\fP(3) .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/wcstoimax.3 b/release/man3/wcstoimax.3 index 9e395bbd..aa0f7df1 100644 --- a/release/man3/wcstoimax.3 +++ b/release/man3/wcstoimax.3 @@ -49,6 +49,6 @@ C99. \fBimaxabs\fP(3), \fBimaxdiv\fP(3), \fBstrtoimax\fP(3), \fBstrtoumax\fP(3), \fBwcstol\fP(3), \fBwcstoul\fP(3) .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/wcstok.3 b/release/man3/wcstok.3 index 31fdb46e..7d000cf6 100644 --- a/release/man3/wcstok.3 +++ b/release/man3/wcstok.3 @@ -61,6 +61,6 @@ for (token = wcstok(wcs, " \et\en", &state); .SH 関連項目 \fBstrtok\fP(3), \fBwcschr\fP(3) .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/wcstombs.3 b/release/man3/wcstombs.3 index f201cce5..02c473c9 100644 --- a/release/man3/wcstombs.3 +++ b/release/man3/wcstombs.3 @@ -59,6 +59,6 @@ C99. .SH 関連項目 \fBmbstowcs\fP(3), \fBwcsrtombs\fP(3) .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/wcswidth.3 b/release/man3/wcswidth.3 index 2d00f676..d26e863a 100644 --- a/release/man3/wcswidth.3 +++ b/release/man3/wcswidth.3 @@ -40,6 +40,6 @@ POSIX.1\-2001. .SH 関連項目 \fBiswprint\fP(3), \fBwcwidth\fP(3) .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/wctob.3 b/release/man3/wctob.3 index a6a39e2a..67ecfd20 100644 --- a/release/man3/wctob.3 +++ b/release/man3/wctob.3 @@ -45,6 +45,6 @@ C99. .SH 関連項目 \fBbtowc\fP(3), \fBwcrtomb\fP(3), \fBwctomb\fP(3) .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/wctomb.3 b/release/man3/wctomb.3 index 115fa22a..81f4e890 100644 --- a/release/man3/wctomb.3 +++ b/release/man3/wctomb.3 @@ -53,6 +53,6 @@ C99. .SH 関連項目 \fBMB_CUR_MAX\fP(3), \fBwcrtomb\fP(3), \fBwcstombs\fP(3) .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/wctrans.3 b/release/man3/wctrans.3 index c235dd57..23dc85e8 100644 --- a/release/man3/wctrans.3 +++ b/release/man3/wctrans.3 @@ -39,7 +39,8 @@ wctrans \- ワイド文字変換マッピング "toupper" \- \fBtoupper\fP(3) のマッピングを実現する .fi .SH 返り値 -\fBwctrans\fP() 関数は、\fIname\fP が有効ならばマッピング記述子を返す。 有効でなければ \fI(wctrans_t) 0\fP を返す。 +The \fBwctrans\fP() function returns a mapping descriptor if the \fIname\fP is +valid. Otherwise it returns \fI(wctrans_t)\ 0\fP. .SH 準拠 C99. .SH 注意 @@ -47,6 +48,6 @@ C99. .SH 関連項目 \fBtowctrans\fP(3) .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/wctype.3 b/release/man3/wctype.3 index ad22f8c5..dd44b8c6 100644 --- a/release/man3/wctype.3 +++ b/release/man3/wctype.3 @@ -58,6 +58,6 @@ C99. .SH 関連項目 \fBiswctype\fP(3) .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/wcwidth.3 b/release/man3/wcwidth.3 index 7eab3304..7d35dd62 100644 --- a/release/man3/wcwidth.3 +++ b/release/man3/wcwidth.3 @@ -45,6 +45,6 @@ glibc 2.2.5 以前では以下のプロトタイプ宣言が使用されてい .SH 関連項目 \fBiswprint\fP(3), \fBwcswidth\fP(3), \fBfeature_test_macros\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/wmemchr.3 b/release/man3/wmemchr.3 index 0b829a3b..04cd04b0 100644 --- a/release/man3/wmemchr.3 +++ b/release/man3/wmemchr.3 @@ -38,6 +38,6 @@ C99. .SH 関連項目 \fBmemchr\fP(3), \fBwcschr\fP(3) .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/wmemcmp.3 b/release/man3/wmemcmp.3 index d78267e8..7f059432 100644 --- a/release/man3/wmemcmp.3 +++ b/release/man3/wmemcmp.3 @@ -39,6 +39,6 @@ C99. .SH 関連項目 \fBmemcmp\fP(3), \fBwcscmp\fP(3) .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/wmemcpy.3 b/release/man3/wmemcpy.3 index b97d0411..77ea76b3 100644 --- a/release/man3/wmemcpy.3 +++ b/release/man3/wmemcpy.3 @@ -41,6 +41,6 @@ C99. .SH 関連項目 \fBmemcpy\fP(3), \fBwcscpy\fP(3), \fBwmemmove\fP(3), \fBwmempcpy\fP(3) .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/wmemmove.3 b/release/man3/wmemmove.3 index 3cd56f83..2c2c67d6 100644 --- a/release/man3/wmemmove.3 +++ b/release/man3/wmemmove.3 @@ -39,6 +39,6 @@ C99. .SH 関連項目 \fBmemmove\fP(3), \fBwmemcpy\fP(3) .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/wmemset.3 b/release/man3/wmemset.3 index f322c130..df269dae 100644 --- a/release/man3/wmemset.3 +++ b/release/man3/wmemset.3 @@ -37,6 +37,6 @@ C99. .SH 関連項目 \fBmemset\fP(3) .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/wordexp.3 b/release/man3/wordexp.3 index f8af5726..1e57e3b8 100644 --- a/release/man3/wordexp.3 +++ b/release/man3/wordexp.3 @@ -42,12 +42,15 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参 .sp \fBwordexp\fP(), \fBwordfree\fP(): _XOPEN_SOURCE .SH 説明 -関数 \fBwordexp\fP() はシェルのように文字列 \fIs\fP を展開し、 \fIp\fP で指し示す構造体に結果を返す。 データ型 -\fIwordexp_t\fP は少なくともフィールド \fIwe_wordc\fP, \fIwe_wordv\fP, \fIwe_offs\fP を持つ構造体である。 -フィールド \fIwe_wordc\fP は \fIsize_t\fP であり、 \fIs\fP を展開した結果に単語がいくつあるかを表す。 フィールド -\fIwe_wordv\fP は \fIchar **\fP であり、見つかった単語の配列を指し示す。 \fIsize_t\fP 型のフィールド \fIwe_offs\fP -は、 \fIwe_wordv\fP 配列にある初期要素のうちいくつが NULL で埋められるべきかを表すのに使われたりする (\fIflags\fP -により決定される。下記を参照。)。 +The function \fBwordexp\fP() performs a shell\-like expansion of the string +\fIs\fP and returns the result in the structure pointed to by \fIp\fP. The data +type \fIwordexp_t\fP is a structure that at least has the fields \fIwe_wordc\fP, +\fIwe_wordv\fP, and \fIwe_offs\fP. The field \fIwe_wordc\fP is a \fIsize_t\fP that +gives the number of words in the expansion of \fIs\fP. The field \fIwe_wordv\fP +is a \fIchar\ **\fP that points to the array of words found. The field +\fIwe_offs\fP of type \fIsize_t\fP is sometimes (depending on \fIflags\fP, see below) +used to indicate the number of initial elements in the \fIwe_wordv\fP array +that should be filled with NULLs. .LP 関数 \fBwordfree\fP() は割り当てたメモリを再度解放する。 より正確にいうと、この関数はその引き数を解放するのではなく、 配列 \fIwe_wordv\fP とそれが指し示す文字列を解放する。 @@ -138,6 +141,6 @@ main(int argc, char **argv) .SH 関連項目 \fBfnmatch\fP(3), \fBglob\fP(3) .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/wprintf.3 b/release/man3/wprintf.3 index 4de11b65..666e1214 100644 --- a/release/man3/wprintf.3 +++ b/release/man3/wprintf.3 @@ -95,16 +95,26 @@ or \fIcc\ \-std=c99\fP (ワイド文字)引き数が出力される。 .TP \fBs\fP -もし \fBl\fP 修飾子が存在しない場合、 \fIconst\ char\ *\fP 引き数は初期状態より始まるマルチバイト文字列を含んだ char -型の配列へのポインタ(文字列へのポインタ)とみなされる。 配列の文字は(最初のバイト前に初期状態で変換を開始し、それぞれの文字を -\fBmbrtowc\fP(3) 関数によって)ワイド文字へと変換される。結果のワイド文字は終端の -ナルワイド文字の手前までが書き込まれる。精度(precision)が指定された 場合、指定された数字を超えるワイド文字は書き込まれない。精度は -書き込まれる \fIバイト\fP 数や \fI画面上の位置\fP ではなく \fIワイド文字\fP の数を指定することに注意すること。 -精度がない場合には配列の終端にナル文字を含む必要がある。 精度を指定する場合には、配列の最後に到着する前に変換されたワイド文字の -数がそれに到達するよう、精度は十分に小さな数でなければならない。 もし \fBl\fP 修飾子が存在する場合、 \fIconst\ wchar_t\ *\fP -引き数はワイド文字の配列へのポインタとみなされる。 配列のワイド文字列は終端のナルワイド文字の手間まで出力される。 -もし精度が指定された場合には指定された精度以上の文字は出力されない。 精度を指定しない場合には終端のナルワイド文字を含む必要がある。 -精度を指定する場合にはそれはワイド文字の配列の大きさよりも小さくな ければならない。 +If no \fBl\fP modifier is present: The \fIconst\ char\ *\fP argument is expected +to be a pointer to an array of character type (pointer to a string) +containing a multibyte character sequence beginning in the initial shift +state. Characters from the array are converted to wide characters (each by +a call to the \fBmbrtowc\fP(3) function with a conversion state starting in +the initial state before the first byte). The resulting wide characters are +written up to (but not including) the terminating null wide character +(L\(aq\e0\(aq). If a precision is specified, no more wide characters than +the number specified are written. Note that the precision determines the +number of \fIwide characters\fP written, not the number of \fIbytes\fP or \fIscreen +positions\fP. The array must contain a terminating null byte (\(aq\e0\(aq), +unless a precision is given and it is so small that the number of converted +wide characters reaches it before the end of the array is reached. If an +\fBl\fP modifier is present: The \fIconst\ wchar_t\ *\fP argument is expected to +be a pointer to an array of wide characters. Wide characters from the array +are written up to (but not including) a terminating null wide character. If +a precision is specified, no more than the number specified are written. +The array must contain a terminating null wide character, unless a precision +is given and it is smaller than or equal to the number of wide characters in +the array. .SH 返り値 これらの関数は書き込まれたワイド文字の文字数を返す。 \fBswprintf\fP() と \fBvswprintf\fP() 関数の場合は 終端のナルワイド文字は含まない。エラーが起こった場合は \-1 を返す。 @@ -124,6 +134,6 @@ C99. .\" .BR wscanf (3) \fBfprintf\fP(3), \fBfputwc\fP(3), \fBfwide\fP(3), \fBprintf\fP(3), \fBsnprintf\fP(3) .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/xcrypt.3 b/release/man3/xcrypt.3 index 727926d3..18176360 100644 --- a/release/man3/xcrypt.3 +++ b/release/man3/xcrypt.3 @@ -47,6 +47,6 @@ xencrypt, xdecrypt, passwd2des \- RFS パスワード暗号化 .SH 関連項目 \fBcbc_crypt\fP(3) .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/xdr.3 b/release/man3/xdr.3 index 16fbced6..48cb0b4e 100644 --- a/release/man3/xdr.3 +++ b/release/man3/xdr.3 @@ -25,9 +25,9 @@ xdr \- 外部データ表現(XDR)のためのライブラリ・ルーティン .in +4n .nf -typedef int \fIbool_t\fP; +\fBtypedef int \fP\fIbool_t\fP\fB;\fP -typedef bool_t (*\fIxdrproc_t\fP) (XDR *, void *,...); +\fBtypedef bool_t (*\fP\fIxdrproc_ti\fP\fB) (XDR *, void *,...);\fP .fi .in .LP @@ -116,9 +116,10 @@ C の \fI浮動小数点数 (float)\fP とその外部表現との変換を行 \fBlong *xdr_inline(XDR *\fP\fIxdrs\fP\fB, int \fP\fIlen\fP\fB);\fP .fi .IP -このマクロは XDR ストリーム \fIxdrs\fP に関連付けられた内部(inline)ルーティンを呼び出す。 -ルーティンはストリームのバッファーの連続する断片へのポインターを返す。 \fIlen\fP は要求するバッファーのバイト長である。 注意: ポインターは -\fIlong *\fP にキャストされる。 +A macro that invokes the inline routine associated with the XDR stream, +\fIxdrs\fP. The routine returns a pointer to a contiguous piece of the +stream's buffer; \fIlen\fP is the byte length of the desired buffer. Note: +pointer is cast to \fIlong\ *\fP. .IP 警告: \fBxdr_inline\fP() はバッファーの連続する断片を割り当てることができなかった場合には NULL (0)を返すかもしれない。 どの場合もその動作はストリームの実体によって変化するかもしれない。 これは効率化のために存在している。 @@ -323,6 +324,6 @@ eXternal Data Representation: Sun Technical Notes Inc., USC\-ISI. .RE .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/y0.3 b/release/man3/y0.3 index 32fb80cc..d2255c53 100644 --- a/release/man3/y0.3 +++ b/release/man3/y0.3 @@ -155,6 +155,6 @@ glibc バージョン 2.3.2 以前では、 領域エラーが発生した場合 .SH 関連項目 \fBj0\fP(3) .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/man4/console.4 b/release/man4/console.4 index 07773ba0..fdd922bb 100644 --- a/release/man4/console.4 +++ b/release/man4/console.4 @@ -18,16 +18,18 @@ .SH 名前 console \- コンソール端末 (console terminal) と仮想コンソール (virtual console) .SH 説明 -Linux システムは普通、\fI/dev/tty\fP\fIn\fP (n は 1 \(<= \fIn\fP \(<= 63) -と呼ばれる\fI仮想コンソール\fP (メジャーナンバー (major number) 4 マイナーナンバー (minor number) 1 から 63 -のキャラクターデバイス (character device)) を持つ。 現在のコンソールは \fI/dev/console\fP または -\fI/dev/tty0\fP (メジャー ナンバー 4 マイナーナンバー 0 のキャラクターデバイス) によっても扱える。 デバイスファイル (device -file) /dev/* は普通 MAKEDEV スクリプトまたは \fBmknod\fP(1) を使ってモード 0622、所有者 root.tty -として作成される。 +A Linux system has up to 63 \fIvirtual consoles\fP (character devices with +major number 4 and minor number 1 to 63), usually called \fI/dev/ttyn\fP with 1 +\(<= \fIn\fP \(<= 63. The current console is also addressed by +\fI/dev/console\fP or \fI/dev/tty0\fP, the character device with major number 4 +and minor number 0. The device files \fI/dev/*\fP are usually created using +the script MAKEDEV, or using \fBmknod\fP(1), usually with mode 0622 and owner +\fIroot.tty\fP. .LP -カーネル (kernel) バージョン 1.1.54 以前は、仮想コンソールの数はコンパイル時に (tty.h 中の : #define -NR_CONSOLES 8 によって) カーネルに埋め込まれていた。 そして、それを変更してコンパイルし直すことで仮想コンソールの数を変更できた。 -カーネルバージョン 1.1.54 以降では仮想コンソールが必要とされる時は すぐに動作中に作成される。 +Before kernel version 1.1.54 the number of virtual consoles was compiled +into the kernel (in \fItty.h\fP: #define NR_CONSOLES 8) and could be changed +by editing and recompiling. Since version 1.1.54 virtual consoles are +created on the fly, as soon as they are needed. .LP コンソール上でプロセスを開始する一般的な方法は: (a) コンソール上で \fBmingetty\fP(8) (または \fBagetty\fP(8)) をスタートさせることを (\fBinittab\fP(5) の中で) \fBinit\fP(8) に伝える。 (b) @@ -57,6 +59,6 @@ Alt キーを示す]。 (b) 現在割り当てられているコンソールを \fBcharsets\fP(7), \fBagetty\fP(8), \fBinit\fP(8), \fBmapscrn\fP(8), \fBmingetty\fP(8), \fBresizecons\fP(8), \fBsetfont\fP(8) .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/man4/console_codes.4 b/release/man4/console_codes.4 index cd11820c..a41096d8 100644 --- a/release/man4/console_codes.4 +++ b/release/man4/console_codes.4 @@ -475,19 +475,19 @@ XFree86 3.1.2A のような、ANSI カラーが実装された、より新しい Sequences\fP ドキュメントを参照されたい。 このドキュメントは、簡潔なものであるが、このマニュアルページより 遥かに長いものである。 年代順の概観としては、 .PP -.in +4n +.RS .UR http://invisible\-island.net\:/xterm\:/xterm.log.html .UE -.in +.RE .PP には xterm の変更の詳細がある。 .PP \fIvttest\fP は .PP -.in +4n +.RS .UR http://invisible\-island.net\:/vttest/ .UE -.in +.RE .PP で入手でき、これらのコントロールシーケンスの多くに関するデモを行う。 \fBxterm\fP(1) ソース配布パッケージには その他の機能を学ぶことが出来るサンプルスクリプトが入っている。 @@ -512,6 +512,6 @@ Linux "プライベートモード" シーケンスは ECMA\-48 のプライベ .SH 関連項目 \fBconsole\fP(4), \fBconsole_ioctl\fP(4), \fBcharsets\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/man4/console_ioctl.4 b/release/man4/console_ioctl.4 index adfb1c8b..42e81549 100644 --- a/release/man4/console_ioctl.4 +++ b/release/man4/console_ioctl.4 @@ -44,78 +44,109 @@ .\"******************************************************************* .TH CONSOLE_IOCTL 4 2009\-02\-28 Linux "Linux Programmer's Manual" .SH 名前 -console_ioctl \- コンソール端末と仮想コンソールの ioctl +console_ioctl \- ioctls for console terminal and virtual consoles .SH 説明 次のような Linux 固有の \fBioctl\fP(2) がサポートされている。 それぞれ3番目の引数が必要である、ここでは \fIargp\fP とする。 -.IP \fBKDGETLED\fP +.TP +\fBKDGETLED\fP LED の状態を取得する。 \fIargp\fP は \fIchar\fP のポインターである。 \fI*argp\fP の下位 3 ビットに以下のように LED の状態がセットされる。 - - LED_CAP 0x04 キャピタルロックが点灯 - LEC_NUM 0x02 ナンバーロックが点灯 - LED_SCR 0x01 スクロールロックが点灯 -.IP \fBKDSETLED\fP +.TS +l l l. +LED_CAP 0x04 caps lock led +LEC_NUM 0x02 num lock led +LED_SCR 0x01 scroll lock led +.TE +.TP +\fBKDSETLED\fP LEDを点灯させる。LEDは \fIargp\fP の下位 3 ビットに従い点灯される。 しかし、より高位のビットがセットされている時には、キャピタルロック、 ナンバーロック、スクロールロックのキーボード機能の状態を表示する LED は 通常状態に戻る。 .LP -カーネル 1.1.54 以前は、LED はそれぞれのキーボードフラグの状態を反映する だけで、KDGETLED/KDSETLED -もキーボードフラグを変更するだけであった。 カーネルl 1.1.54 からは LED に任意の表示をする事ができるようになったが、 -デフォルトではキーボードフラグを表示する。 次に示す 2 つの ioctl はキーボードフラグにアクセスするのに用いられる。 -.IP \fBKDGKBLED\fP +Before 1.1.54, the LEDs just reflected the state of the corresponding +keyboard flags, and KDGETLED/KDSETLED would also change the keyboard flags. +Since 1.1.54 the LEDs can be made to display arbitrary information, but by +default they display the keyboard flags. The following two ioctls are used +to access the keyboard flags. +.TP +\fBKDGKBLED\fP キャピタルロック、ナンバーロック、スクロールロックの(LED の表示では なく)キーボードフラグを得る。 \fIargp\fP はフラグの状態がセットされる文字変数を指す。 (0x7)でマスクして得られる下位 3 ビットが現在のフラグの状態を示し、 (0x70)でマスクして得られる次の 3 ビットがデフォルトのフラグの状態を 示す。(カーネル 1.1.54以降) -.IP \fBKDSKBLED\fP +.TP +\fBKDSKBLED\fP キャピタルロック、ナンバーロック、スクロールロックの(LED の表示ではなく) キーボードフラグをセットする。 \fIargp\fP がセットしたいフラグである。 (0x7)でマスクして得られる下位 3 ビットがフラグの状態で、(0x70)でマスクして 得られる次の 3 ビットがデフォルトのフラグの状態である。(カーネル 1.1.54以降) -.IP \fBKDGKBTYPE\fP +.TP +\fBKDGKBTYPE\fP キーボードの種類を得る。これは値 0x02 と定義されている KB_101を返す。 -.IP \fBKDADDIO\fP +.TP +\fBKDADDIO\fP I/Oポートを有効な物として加える。これは \fIioperm(arg,1,1)\fP と等価である。 -.IP \fBKDDELIO\fP +.TP +\fBKDDELIO\fP I/Oポートを有効な物から外す。これは \fIioperm(arg,1,0)\fP と等価である。 -.IP \fBKDENABIO\fP +.TP +\fBKDENABIO\fP ビデオボードへの I/O を可能にする。 これは \fIioperm(0x3b4, 0x3df\-0x3b4+1, 1)\fP と等価である。 -.IP \fBKDDISABIO\fP +.TP +\fBKDDISABIO\fP ビデオボードへの I/O を不可能にする。 これは \fIioperm(0x3b4, 0x3df\-0x3b4+1, 0)\fP と等価である。 -.IP \fBKDSETMODE\fP +.TP +\fBKDSETMODE\fP テキスト/グラフィクスモードを設定する。 \fIargp\fP は次のうちのどれか： - KD_TEXT 0x00 - KD_GRAPHICS 0x01 -.IP \fBKDGETMODE\fP +.TS +l l. +KD_TEXT 0x00 +KD_GRAPHICS 0x01 +.TE +.TP +\fBKDGETMODE\fP テキスト/グラフィクスモードを取得する。 \fIargp\fP が指す \fIlong\fP 型変数に 上述の値のどちらかがセットされる。 -.IP \fBKDMKTONE\fP +.TP +\fBKDMKTONE\fP 指定された長さのトーンを発生する。 \fIargp\fP の下位 16 ビットはクロックサイクルを単位にして周期を指定し、 上位 16 ビットが msec の単位で表した、(トーンを発生させる)時間を指定する。 トーンを発生させる時間がゼロのときは、サウンドはオフになる。 制御は直ちに戻る。 例えば、\fIargp\fP = (125<<16) + 0x637 とすれば、通常 ctrl\-G を押した時に 発生する音になる。 (カーネル 0.99pl1 以降;この機能は カーネル 2.1.49 から 2.1.50 ではバグのため動作しない) -.IP \fBKIOCSOUND\fP +.TP +\fBKIOCSOUND\fP 音の発生の開始や停止を行う。 \fIargp\fP の下位 16 ビットはクロックサイクルを単位として周期を示す。 (つまり \fIargp\fP = 1193180/周波数)。 \fIargp\fP = 0 の場合、サウンドはオフになる。 どちらの場合でも、ただちに制御は戻る。 -.IP \fBGIO_CMAP\fP +.TP +\fBGIO_CMAP\fP 現在のデフォルトのカラーマップをカーネルより取得する。 -.IP \fBPIO_CMAP\fP +.TP +\fBPIO_CMAP\fP デフォルトのテキストモードのカラーマップを変更する。 \fIargp\fP が指す 48 バイトの配列中には、16 の可能なスクリーンの色を、 赤、緑、青の順に 0 をオフ、255を最大強度とした値として納める。 デフォルトの色は順に、黒、濃い赤、濃い緑、茶、濃い青、濃い紫、濃いシアン、 明るい灰色、濃い灰色、明るい赤、明るい緑、黄、明るい青、明るい紫、 明るいシアン、白である。(カーネル 1.3.3以降) -.IP \fBGIO_FONT\fP +.TP +\fBGIO_FONT\fP 拡張された形式で 256 文字のスクリーンフォントを得る。 \fIargp\fP は 8192 バイトの配列を指す。 現在ロードされているフォントが 512 文字のフォントであるか、コンソールが テキストモードでない時には失敗し \fBEINVAL\fP のエラーコードを返す。 -.IP \fBGIO_FONTX\fP -スクリーンフォントとそれに関連した情報を取得する。 \fIargp\fP は構造体 consolefontdesc (\fBPIO_FONTX\fP -を参照のこと)を指す。 関数呼び出しのときには、\fIcharcount\fP には、\fIchardata\fP が指す -バッファにおさまる最大の文字数をセットしなければならない。 関数呼び出しから戻った時には \fIcharcount\fP と \fIcharheight\fP -には、 現在ロードされているフォントの該当するデータが収められている。 配列 \fIchardata\fP には、最初に \fIcharcount\fP -にいれた値によって フォントを収めるのに十分なスペースがあるとわかればフォントデータが収められる。 そうでない時には、バッファは変更されず、 -\fIerrno\fP に \fBENOMEM\fP が セットされる(カーネル 1.3.1 以降)。 -.IP \fBPIO_FONT\fP -256 文字のフォントをセットする。EGA/VGA キャラクタージェネレーター (character generator) にフォントをロードする。 -\fIargp\fP は、8192 バイト(一文字 32 バイト)のマップを指す。 マップのうち、最初の \fIN\fP のみが 8x\fIN\fP のフォントのために -用いられる(0 < \fIN\fP <= 32)。 この呼び出しをすると Unicode のマッピングが無効になる。 -.IP \fBPIO_FONTX\fP -スクリーンフォントと、それに関連するレンダリング情報をセットする。 \fIargp\fP は、以下の構造体を指す。 +.TP +\fBGIO_FONTX\fP +Gets screen font and associated information. \fIargp\fP points to a \fIstruct +consolefontdesc\fP (see \fBPIO_FONTX\fP). On call, the \fIcharcount\fP field should +be set to the maximum number of characters that would fit in the buffer +pointed to by \fIchardata\fP. On return, the \fIcharcount\fP and \fIcharheight\fP +are filled with the respective data for the currently loaded font, and the +\fIhardata\fP array contains the font data if the initial value of \fIcharcount\fP +indicated enough space was available; otherwise the buffer is untouched and +\fIerrno\fP is set to \fBENOMEM\fP. (Since 1.3.1.) +.TP +\fBPIO_FONT\fP +Sets 256\-character screen font. Load font into the EGA/VGA character +generator. \fIargp\fP points to a 8192 byte map, with 32 bytes per character. +Only the first \fIN\fP of them are used for an 8x\fIN\fP font (0 < \fIN\fP <= +32). This call also invalidates the Unicode mapping. +.TP +\fBPIO_FONTX\fP +Sets screen font and associated rendering information. \fIargp\fP + +points to a .in +4n .nf @@ -131,25 +162,32 @@ struct consolefontdesc { 必要ならスクリーンは適当にサイズ変更され、\fBSIGWINCH\fP が適切な プロセスに送られる。 このコールにより Unicode のマッピングが無効になる。 -.IP \fBPIO_FONTRESET\fP +.TP +\fBPIO_FONTRESET\fP スクリーンフォント、サイズ、 Unicode マッピングをブート時のデフォルト値に リセットする。\fIargp\fP は用いられないが、将来のバージョンの Linux との互換性を保つために NULL にセットすべきである。 -.IP \fBGIO_SCRNMAP\fP +.TP +\fBGIO_SCRNMAP\fP スクリーンマッピングをカーネルより取得する。\fIargp\fP はサイズ E_TABSZ の 領域を指す。その領域には各キャラクターを表示するのに用いられるフォントの 位置がロードされている。 この呼び出しは現在ロードされているフォントが 256 文字よりも多い時には 無意味な情報を返す事が多い。 -.IP \fBGIO_UNISCRNMAP\fP -フル Unicode スクリーンマッピングをカーネルより取得する。 \fIargp\fP はサイズ E_TABSZ*sizeof(unsigned -short) の領域を指す。 その領域には各キャラクターを示す Unicode がロードされている。 U+F000 に始まる Unicode -の特別な集合は、「フォント直接な(direct to font)」 マッピングを示すのに用いられる(カーネル 1.3.1 以降)。 -.IP \fBPIO_SCRNMAP\fP +.TP +\fBGIO_UNISCRNMAP\fP +Get full Unicode screen mapping from kernel. \fIargp\fP points to an area of +size \fIE_TABSZ*sizeof(unsigned\fPshort)\fI,\fP which is loaded with the Unicodes +each character represent. A special set of Unicodes, starting at U+F000, +are used to represent "direct to font" mappings. (Since 1.3.1.) +.TP +\fBPIO_SCRNMAP\fP 「ユーザー定義可能な(user definable)」(4番目の)テーブルをカーネルに ロードする。そのテーブルは各バイトをスクリーンシンボルにマッピングする。 \fIargp\fP はサイズE_TABSZの領域を指す。 -.IP \fBPIO_UNISCRNMAP\fP +.TP +\fBPIO_UNISCRNMAP\fP 「ユーザー定義可能な」(4番目の)テーブルをカーネルにロードする。 そのテーブルは各バイトをユニコードにマッピングし、その後、 現在ロードされているユニコードからフォントへのマップに従い スクリーンシンボルに変換される。 U+F000 に始まるユニコードは直接フォントシンボルにマッピングするのに 使える(カーネル 1.3.1 以降) -.IP \fBGIO_UNIMAP\fP +.TP +\fBGIO_UNIMAP\fP Unicode からフォントへのマッピングをカーネルから取得する。 \fIargp\fP は、 .in +4n @@ -173,11 +211,12 @@ struct unipair { .in (カーネル 1.1.92 以降) -.IP \fBPIO_UNIMAP\fP -Unicode からフォントへのマッピングをカーネルにセットする。 -\fIargp\fP は構造体 \fIstruct unimapdesc\fP へのポインターである。 -(カーネル 1.1.92 以降) -.IP \fBPIO_UNIMAPCLR\fP +.TP +\fBPIO_UNIMAP\fP +Put unicode\-to\-font mapping in kernel. \fIargp\fP points to a \fIstruct +unimapdesc\fP. (Since 1.1.92) +.TP +\fBPIO_UNIMAPCLR\fP テーブルをクリアし、その事をハシュアルゴリズムに伝える。 \fIargp\fPは .in +4n @@ -191,24 +230,35 @@ struct unimapinit { .in (カーネル 1.1.92 以降) -.IP \fBKDGKBMODE\fP +.TP +\fBKDGKBMODE\fP 現在のキーボードモードを取得する。\fIargp\fP の指す \fIlong\fP 型変数が、 次のうちのどれかに設定される。 - K_RAW 0x00 - K_XLATE 0x01 - K_MEDIUMRAW 0x02 - K_UNICODE 0x03 -.IP \fBKDSKBMODE\fP +.TS +l l. +K_RAW 0x00 +K_XLATE 0x01 +K_MEDIUMRAW 0x02 +K_UNICODE 0x03 +.TE +.TP +\fBKDSKBMODE\fP 現在のキーボードモードを設定する。 \fIargp\fP は上記の値のうちのどれかに等しい \fIlong\fP にする。 -.IP \fBKDGKBMETA\fP +.TP +\fBKDGKBMETA\fP メタキーハンドリングモード(meta key handling mode)を取得する。 \fIargp\fP が指す \fIlong\fP 型変数は、次のうちのどれかに設定される。 - K_METABIT 0x03 set high order bit - K_ESCPREFIX 0x04 escape prefix -.IP \fBKDSKBMETA\fP +.TS +l l l. +K_METABIT 0x03 set high order bit +K_ESCPREFIX 0x04 escape prefix +.TE +.TP +\fBKDSKBMETA\fP メタキーハンドリングモードを設定する。 \fIargp\fP は上記の値のどれかに等しい \fIlong\fP にする。 -.IP \fBKDGKBENT\fP +.TP +\fBKDGKBENT\fP キーコードをアクションコードに変換するキー変換表のエントリーの一つを 取得する。 \fIargp\fP は、 .in +4n @@ -225,9 +275,11 @@ struct kbentry { MAX_NR_KEYMAPS)、\fIkb_index\fP にはキーコード(0 <= \fIkb_index\fP < NR_KEYS)を設定する。 \fIkb_value\fP は対応するアクションコード、または、そのようなキーが ないときには K_HOLE、\fIkb_table\fP が無効な時には K_NOSUCHMAP に設定される。 -.IP \fBKDSKBENT\fP +.TP +\fBKDSKBENT\fP 変換テーブルのエントリーの一つを設定する。\fIargp\fP は 構造体 \fIstruct kbentry\fP へのポインターである。 -.IP \fBKDGKBSENT\fP +.TP +\fBKDGKBSENT\fP ファンクションキーの文字列を取得する。\fIargp\fP は 以下の構造体へのポインターである。 .in +4n @@ -241,9 +293,11 @@ struct kbsentry { \fIkb_func\fP 番目のファンクションキーのアクションコードに対応する (NULL で終端された) 文字列が \fIkb_string\fP に設定される。 -.IP \fBKDSKBSENT\fP +.TP +\fBKDSKBSENT\fP ファンクションキーの文字列のエントリーを設定する。\fIargp\fP は、 構造体 \fIstruct kbsentry\fP へのポインターである。 -.IP \fBKDGKBDIACR\fP +.TP +\fBKDGKBDIACR\fP カーネルのアクセントテーブル(accent table)を読み込む。\fIargp\fPは、 次の構造体へのポインターである。 .in +4n @@ -266,7 +320,8 @@ struct kbdiacr { }; .fi .in -.IP \fBKDGETKEYCODE\fP +.TP +\fBKDGETKEYCODE\fP カーネルの(スキャンコードからキーコードへ 変換する)キーコードテーブルエントリーを読み込む。 \fIargp\fP は、 .in +4n @@ -281,16 +336,22 @@ struct kbkeycode { へのポインターである。 \fIkeycode\fP は、\fIscancode\fP に対応した値に設定される。(ただし、89 <= \fIscancode\fP <= 255 のみについて。1 <= \fIscancode\fP <= 88 では \fIkeycode\fP == \fIscancode\fP である。) (カーネル 1.1.63 以降) -.IP \fBKDSETKEYCODE\fP +.TP +\fBKDSETKEYCODE\fP カーネルのキーコードテーブルエントリーを書き込む。\fIargp\fP は構造体 \fIstruct kbkeycode\fP へのポインターである。 (カーネル 1.1.63 以降) -.IP \fBKDSIGACCEPT\fP -この関数呼び出しは、特別な組合せでキーを押した時に発生するシグナル \fIargp\fP (1 <= \fIargp\fP <= NSIG) -を進んで受け付けるかどうかを示す。 (linux/drivers/char/keyboard.c の Spawn_console() を見よ。) -.IP \fBVT_OPENQRY\fP +.TP +\fBKDSIGACCEPT\fP +The calling process indicates its willingness to accept the signal \fIargp\fP +when it is generated by pressing an appropriate key combination. (1 <= +\fIargp\fP <= NSIG). (See \fIspawn_console\fP() in +\fIlinux/drivers/char/keyboard.c\fP.) +.TP +\fBVT_OPENQRY\fP 最初の空いている(まだオープンされていない)コンソールを返す。 \fIargp\fP の指す \fIint\fP 型の整数には、vt の番号がセットされる (1 <= \fI*argp\fP <= MAX_NR_CONSOLES)。 -.IP \fBVT_GETMODE\fP +.TP +\fBVT_GETMODE\fP アクティブな vt のモードを取得する。\fIargp\fPは、 .in +4n @@ -307,12 +368,17 @@ struct vt_mode { という構造体を指すポインタであり、アクティブな vt のモードが セットされる。 \fImode\fP は次のどれかに設定される： - VT_AUTO 自動vt切替え - VT_PROCESS プロセスコントロール切替え - VT_ACKACQ アクノリッジ切替え -.IP \fBVT_SETMODE\fP +.TS +l l. +VT_AUTO auto vt switching +VT_PROCESS process controls switching +VT_ACKACQ acknowledge switch +.TE +.TP +\fBVT_SETMODE\fP アクティブな vt のモードを設定する。\fIargp\fP は構造体 \fIstruct vt_mode\fP への ポインターである。 -.IP \fBVT_GETSTATE\fP +.TP +\fBVT_GETSTATE\fP グローバルな vt の状態の情報を取得する。\fIargp\fPは、 .in +4n @@ -327,15 +393,20 @@ struct vt_stat { へのポインターである。 使用されているそれぞれの vt につき \fIv_state\fP の対応するビットが セットされる。 (カーネルl 1.0 から 1.1.92 まで) -.IP \fBVT_RELDISP\fP +.TP +\fBVT_RELDISP\fP ディスプレーを解放する。 -.IP \fBVT_ACTIVATE\fP +.TP +\fBVT_ACTIVATE\fP \fIargp\fP (1 <= \fIargp\fP <= MAX_NR_CONSOLES)の vt に切替える。 -.IP \fBVT_WAITACTIVE\fP +.TP +\fBVT_WAITACTIVE\fP \fIargp\fPの vt がアクティブになるまで待つ。 -.IP \fBVT_DISALLOCATE\fP +.TP +\fBVT_DISALLOCATE\fP \fIargp\fP の vt に結びつけられたメモリーを解放する。 (カーネル 1.1.54 以降) -.IP \fBVT_RESIZE\fP +.TP +\fBVT_RESIZE\fP カーネルが認識するスクリーンサイズを設定する。\fIargp\fP は、 .in +4n @@ -349,7 +420,8 @@ struct vt_sizes { .in へのポインターである。 これはビデオモードを変更しない事に注意。 \fBresizecons\fP(8) を見よ(カーネル 1.1.54 以降)。 -.IP \fBVT_RESIZEX\fP +.TP +\fBVT_RESIZEX\fP カーネルが認識する各種のスクリーンパラメータを設定する。\fIargp\fP は、 以下の構造体へのポインターである。 .in +4n @@ -375,12 +447,15 @@ struct vt_consize { .PP 以下の ioctl がどのように動作をするかは、\fIargp\fP が指す構造体の 最初のバイト(ここでは \fIsubcode\fP と呼ぶ)に依存する。 これらの呼出しは、スーパーユーザーか現在の端末のオーナにのみ許される。 -.IP "\fBTIOCLINUX, subcode=0\fP" -スクリーンをダンプ(dump)する カーネル 1.1.92 以降でなくなった(1.1.92 以降では、代わりに /dev/vcsN または -/dev/vcsaN より読み込む)。 -.IP "\fBTIOCLINUX, subcode=1\fP" +.TP +\fBTIOCLINUX, subcode=0\fP +Dump the screen. Disappeared in 1.1.92. (With kernel 1.1.92 or later, read +from \fI/dev/vcsN\fP or \fI/dev/vcsaN\fP instead.) +.TP +\fBTIOCLINUX, subcode=1\fP タスク情報を取得する。カーネル 1.1.92 でなくなった。 -.IP "\fBTIOCLINUX, subcode=2\fP" +.TP +\fBTIOCLINUX, subcode=2\fP 選択を設定する。 \fIargp\fP が指すのは、 .in +4n .nf @@ -393,46 +468,59 @@ struct { .fi .in -であり、ここで \fIxs\fP と \fIys\fP は始めの桁と行で、\fIxe\fP と \fIye\fP は終りの桁と 行である。 (左上の隅が 桁=行=1 ) -\fIsel_mode\fP は 0 が文字毎の選択で、1は語毎の選択、2は行毎の選択を 意味する。 示されたスクリーン上の文字はハイライト表示され -devices/char/console.c の 静的配列 sel_buffer に保存される。 -.IP "\fBTIOCLINUX, subcode=3\fP" +\fIxs\fP and \fIys\fP are the starting column and row. \fIxe\fP and \fIye\fP are the +ending column and row. (Upper left corner is row=column=1.) \fIsel_mode\fP is +0 for character\-by\-character selection, 1 for word\-by\-word selection, or 2 +for line\-by\-line selection. The indicated screen characters are highlighted +and saved in the static array sel_buffer in \fIdevices/char/console.c\fP. +.TP +\fBTIOCLINUX, subcode=3\fP 選択したものをペーストする。 選択バッファ中の文字 が \fIfd\fP に書き出される。 -.IP "\fBTIOCLINUX, subcode=4\fP" +.TP +\fBTIOCLINUX, subcode=4\fP スクリーンをアンブランク(unblank)する。 -.IP "\fBTIOCLINUX, subcode=5\fP" +.TP +\fBTIOCLINUX, subcode=5\fP 語毎の選択のための「語」中の文字を規定している 256 ビットのルックアップ テーブルの内容を設定する(カーネル 1.1.32 以降)。 -.IP "\fBTIOCLINUX, subcode=6\fP" +.TP +\fBTIOCLINUX, subcode=6\fP \fIargp\fP は文字変数を指すポインタで、その内容がカーネル変数 \fIshift_state\fPの値に設定される(カーネル 1.1.32 以降)。 -.IP "\fBTIOCLINUX, subcode=7\fP" +.TP +\fBTIOCLINUX, subcode=7\fP \fIargp\fP は文字変数を指すポインタで、その内容がカーネル変数 \fIreport_mouse\fP の値に設定される(カーネル 1.1.33 以降)。 -.IP "\fBTIOCLINUX, subcode=8\fP" -スクリーン幅、スクリーン高さ、カーソル位置、全ての文字属性の組をダンプする (カーネル 1.1.67 から 1.1.91までのみ。 カーネル -1.1.92 以降では /dev/vcsa*より読み込む)。 -.IP "\fBTIOCLINUX, subcode=9\fP" -スクリーン幅、スクリーン高さ、カーソル位置、全ての文字属性の組を復元する (カーネル 1.1.67 から 1.1.91 までのみ。 カーネル -1.1.92 以降では /dev/vcsa* に書き込む)。 -.IP "\fBTIOCLINUX, subcode=10\fP" -新世代モニターのパワーセーブ機能を制御する。 VESA スクリーンブランキングモードが \fIargp\fP[1]に設定される。 -その値はスクリーンブランキングがどのように行われるかを示す。以下がその 値である。 - - \fI0\fP: スクリーンブランキングなし。 - - \fI1\fP:現在のビデオアダプターレジスタが保存されたあと、 -コントローラは垂直同期パルスをオフにするようプログラムされる。 -これにより モニターは「スタンバイ」モードにはいる。 -モニターに Off_Mode タイマが備わっておれば、 -最終的にはモニターが自分で電源を落す。 - - \fI2\fP:現在の設定を保存した後、垂直、水平同期パルスがオフになる。 -これによりモニターは「オフ」モードになる。 -モニターに Off_Mode タイマーがない時、または、blank_timer がタイムアウトしたら -すぐにモニターの電源を落したいときにこの選択肢を選ぶ。 -(注意：頻繁にモニターの電源を切るとモニターを痛める。) - -(カーネル 1.1.76 以降) +.TP +\fBTIOCLINUX, subcode=8\fP +Dump screen width and height, cursor position, and all the +character\-attribute pairs. (Kernels 1.1.67 through 1.1.91 only. With +kernel 1.1.92 or later, read from \fI/dev/vcsa*\fP instead.) +.TP +\fBTIOCLINUX, subcode=9\fP +Restore screen width and height, cursor position, and all the +character\-attribute pairs. (Kernels 1.1.67 through 1.1.91 only. With +kernel 1.1.92 or later, write to \fI/dev/vcsa*\fP instead.) +.TP +\fBTIOCLINUX, subcode=10\fP +Handles the Power Saving feature of the new generation of monitors. VESA +screen blanking mode is set to \fIargp[1]\fP, which governs what screen +blanking does: +.RS +.IP 0: 3 +Screen blanking is disabled. +.IP 1: +The current video adapter register settings are saved, then the controller +is programmed to turn off the vertical synchronization pulses. This puts +the monitor into "standby" mode. If your monitor has an Off_Mode timer, +then it will eventually power down by itself. +.IP 2: +The current settings are saved, then both the vertical and horizontal +synchronization pulses are turned off. This puts the monitor into "off" +mode. If your monitor has no Off_Mode timer, or if you want your monitor to +power down immediately when the blank_timer times out, then you choose this +option. (\fICaution:\fP Powering down frequently will damage the monitor.) +(Since 1.1.76.) +.RE .SH 返り値 -成功時には 0 が返される。エラーに対しては \-1 が返され、 \fIerrno\fP が設定される。 +On success, 0 is returned. On error, \-1 is returned, and \fIerrno\fP is set. .SH エラー \fIerrno\fP は次のような値をとる: .TP @@ -448,16 +536,21 @@ devices/char/console.c の 静的配列 sel_buffer に保存される。 \fBEPERM\fP 権限が不十分。 .SH 注意 -\fB警告\fP: このマニュアルページを Linux のコンソール ioctl を文書化したものと思わない事。 -これは、興味がある人がソースを読むことの代わりになるように用意した物である。 ioctl は文書化されない Linux の内部機能であって、警告なしに -変更されることがある。 (そして、このページはカーネル 1.1.94 のときの状況を記述した物で、それは 以前のバージョンと比べれば、多くの違いがある) - -ioctl はカーネルと、ある特定のよく知られたプログラムとの情報交換のために 導入される事が非常に多い(fdisk, hdparm, -setserial,tunelp, loadkeys, selection, setfont など)。そのため ioctl -の動作は、その特定のプログラムが 必要とした時には変更になる。 - -これらの ioctl を使ったプログラムは他のバージョンの UNIX との互換性が ないし、古いバージョンの Linux -では、走らない。さらに将来のバージョンの Linux では走らなくなるかも知れない。 +\fBWarning\fP: Do not regard this man page as documentation of the Linux +console ioctls. This is provided for the curious only, as an alternative to +reading the source. Ioctl's are undocumented Linux internals, liable to be +changed without warning. (And indeed, this page more or less describes the +situation as of kernel version 1.1.94; there are many minor and not\-so\-minor +differences with earlier versions.) + +Very often, ioctls are introduced for communication between the kernel and +one particular well\-known program (fdisk, hdparm, setserial, tunelp, +loadkeys, selection, setfont, etc.), and their behavior will be changed when +required by this particular program. + +Programs using these ioctls will not be portable to other versions of UNIX, +will not work on older versions of Linux, and will not work on future +versions of Linux. POSIX 機能を使いなさい。 .SH 関連項目 @@ -469,6 +562,6 @@ POSIX 機能を使いなさい。 \fI/usr/include/linux/kd.h\fP, \fI/usr/include/linux/vt.h\fP .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/man4/dsp56k.4 b/release/man4/dsp56k.4 index 7b13a0ca..cb161b19 100644 --- a/release/man4/dsp56k.4 +++ b/release/man4/dsp56k.4 @@ -92,6 +92,6 @@ dsp56k_binary\fP へのポインタでなければならない。 構造体の DSP56000/DSP56001 Digital Signal Processor User's Manual .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/man4/fd.4 b/release/man4/fd.4 index c4f11783..bab2342b 100644 --- a/release/man4/fd.4 +++ b/release/man4/fd.4 @@ -186,6 +186,6 @@ Apple II や Macintosh コンピュータで使用されている、 GCR (group \fBchown\fP(1), \fBfloppycontrol\fP(1), \fBgetfdprm\fP(1), \fBmknod\fP(1), \fBsuperformat\fP(1), \fBmount\fP(8), \fBsetfdprm\fP(8) .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/man4/full.4 b/release/man4/full.4 index c6370351..65c02970 100644 --- a/release/man4/full.4 +++ b/release/man4/full.4 @@ -52,6 +52,6 @@ full \- いつも full であるデバイス .SH 関連項目 \fBmknod\fP(1), \fBnull\fP(4), \fBzero\fP(4) .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/man4/hd.4 b/release/man4/hd.4 index 4e33f967..0f719ab9 100644 --- a/release/man4/hd.4 +++ b/release/man4/hd.4 @@ -83,6 +83,6 @@ chown root:disk /dev/hd* .SH 関連項目 \fBchown\fP(1), \fBmknod\fP(1), \fBsd\fP(4) \fBmount\fP(8), .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/man4/initrd.4 b/release/man4/initrd.4 index d5ca6a49..fb43c49c 100644 --- a/release/man4/initrd.4 +++ b/release/man4/initrd.4 @@ -256,6 +256,6 @@ loader) によって初期化 (例えば、ロード) される RAM ディス Linux カーネルソースの \fIinitrd.txt\fP、 LILO のドキュメント、LOADLIN のドキュメント、SYSLINUX のドキュメント .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/man4/intro.4 b/release/man4/intro.4 index 7a0a76aa..5e65f7d5 100644 --- a/release/man4/intro.4 +++ b/release/man4/intro.4 @@ -41,6 +41,6 @@ intro \- スペシャルファイルに関する序文 .SH 関連項目 \fBstandards\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/man4/lp.4 b/release/man4/lp.4 index 06e81fd8..60e3e46a 100644 --- a/release/man4/lp.4 +++ b/release/man4/lp.4 @@ -93,6 +93,6 @@ LP_PERRORP エラー信号、ローがアクティブ .SH 関連項目 \fBchmod\fP(1), \fBchown\fP(1), \fBmknod\fP(1), \fBlpcntl\fP(8), \fBtunelp\fP(8) .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/man4/mem.4 b/release/man4/mem.4 index b280dda2..e02bbce8 100644 --- a/release/man4/mem.4 +++ b/release/man4/mem.4 @@ -77,6 +77,6 @@ chown root:mem /dev/port .SH 関連項目 \fBchown\fP(1), \fBmknod\fP(1), \fBioperm\fP(2) .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/man4/mouse.4 b/release/man4/mouse.4 index 98ce864a..d26723c6 100644 --- a/release/man4/mouse.4 +++ b/release/man4/mouse.4 @@ -69,10 +69,10 @@ bit/s string データパケットの第 1 バイトは同期をとるのに利用できる。 .SS "マイクロソフト プロトコル(Microsoft Protocol)" -\fBマイクロソフト\fPプロトコルは、1200 bits/sec のスピードで、1 ス タートビット(1 start bit)、7 データビット(7 -data bits)、パリティな し、1 ストップビット(1 stop bit)である。 データは RxD に 3 -バイトのパケットとして送られる。\fIdx\fP と \fIdy\fP の動きは 2 の補数表示で送られ、左(右)のボタンが押された時には \fIlb\fP -(\fIrb\fP)がセットされる。 +The \fBMicrosoft\fP protocol uses 1 start bit, 7 data bits, no parity and one +stop bit at the speed of 1200 bits/sec. Data is sent to RxD in 3\-byte +packets. The \fIdx\fP and \fIdy\fP movements are sent as two's\-complement, \fIlb\fP +(\fIrb\fP) are set when the left (right) button is pressed: .TS center; r c c c c c c c. @@ -90,9 +90,11 @@ byte d6 d5 d4 d3 d2 d1 d0 パケットが送られる。真中のボタンが押されていると、4バイトのパケットが 送られる。第４バイトは 0x20 の値を持っている(あるいは、少なくとも 0x20 ビットがセットされている)。 但し、他のボタンが押されていない状態で、 真中のボタンが押されると、0,0,0,0x20 と伝えられる。 .SS "マウスシステムズ プロトコル(Mousesystems protocol)" -\fBマウスシステムズ\fPプロトコルは、1200 bits/secで、1 スタートビット、 8 データビット、パリティなし、2 ストップビットである。 -データは、RxD に 5 バイトのパケットとして送られる。\fIdx\fP は 2 つの 2 の補数の和として送られ、\fIdy\fP は 2 つの 2 -の補数の和の否定 として送られる。左(中、右)のボタンが押された時には\fIlb\fP (\fImb\fP, \fIrb\fP) がクリアされる。 +The \fBMousesystems\fP protocol uses 1 start bit, 8 data bits, no parity and +two stop bits at the speed of 1200 bits/sec. Data is sent to RxD in 5\-byte +packets. \fIdx\fP is sent as the sum of the two two's\-complement values, \fIdy\fP +is send as negated sum of the two two's\-complement values. \fIlb\fP (\fImb\fP, +\fIrb\fP) are cleared when the left (middle, right) button is pressed: .TS center; r c c c c c c c c. @@ -108,9 +110,11 @@ byte d7 d6 d5 d4 d3 d2 d1 d0 .SS "サン プロトコル(Sun protocol)" \fBサン\fP プロトコルは、上記の 5 バイト マウスシステムプロトコルの 3 バイト版です。後の 2 バイトは送られません。 .SS "MM プロトコル(MM protocol)" -\fBMM\fP プロトコルは 1200 bits/sec で 1 スタートビット、8 データビッ ト、奇数パリティ、 1 ストップビットを使う。データは -RxD に 3 バイトのパ ケットとして送られる。\fIdx\fP と \fIdy\fP は一つの符号つきの値として -送られ、サインビットは負の値を表す。左(中、右)のボタンが押された時には \fIlb\fP (\fImb\fP, \fIrb\fP)がセットされる。 +The \fBMM\fP protocol uses 1 start bit, 8 data bits, odd parity and one stop +bit at the speed of 1200 bits/sec. Data is sent to RxD in 3\-byte packets. +\fIdx\fP and \fIdy\fP are sent as single signed values, the sign bit indicating a +negative value. \fIlb\fP (\fImb\fP, \fIrb\fP) are set when the left (middle, right) +button is pressed: .TS center; r c c c c c c c c. @@ -126,6 +130,6 @@ byte d7 d6 d5 d4 d3 d2 d1 d0 .SH 関連項目 \fBttyS\fP(4), \fBgpm\fP(8) .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/man4/null.4 b/release/man4/null.4 index 8aa69230..fb3ffe5a 100644 --- a/release/man4/null.4 +++ b/release/man4/null.4 @@ -55,6 +55,6 @@ chown root:root /dev/null /dev/zero .SH 関連項目 \fBchown\fP(1), \fBmknod\fP(1), \fBfull\fP(4) .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/man4/pts.4 b/release/man4/pts.4 index ef96d415..dd810aeb 100644 --- a/release/man4/pts.4 +++ b/release/man4/pts.4 @@ -49,6 +49,6 @@ ptmx, pts \- 擬似端末のマスタとスレーブ .SH 関連項目 \fBgetpt\fP(3), \fBgrantpt\fP(3), \fBptsname\fP(3), \fBunlockpt\fP(3), \fBpty\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/man4/ram.4 b/release/man4/ram.4 index 1e07d830..222405f1 100644 --- a/release/man4/ram.4 +++ b/release/man4/ram.4 @@ -47,6 +47,6 @@ chown root:disk /dev/ram .SH 関連項目 \fBchown\fP(1), \fBmknod\fP(1), \fBmount\fP(8) .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/man4/random.4 b/release/man4/random.4 index d650c528..dc55eea7 100644 --- a/release/man4/random.4 +++ b/release/man4/random.4 @@ -47,10 +47,9 @@ random, urandom \- カーネル乱数ソースデバイス 形で入手できる資料はない、しかし、そのような攻撃は論理的に存在可能である。 もし、この事が心配なら、(\fI/dev/urandom\fP ではなく) \fI/dev/random\fP を利用すればいい。 .LP -Writing to \fI/dev/random\fP or \fI/dev/urandom\fP will update the entropy pool -with the data written, but this will not result in a higher entropy count. -This means that it will impact the contents read from both files, but it -will not make reads from \fI/dev/random\fP faster. +\fI/dev/random\fP や \fI/dev/urandom\fP に書き込みを行うと、 書き込まれたデータでエントロピー・プールが更新される。 しかし、 +エントロピー・カウントが増えるわけではない。 つまり、 \fI/dev/random\fP と \fI/dev/urandom\fP +の両方のファイルから読み出される内容に影響があるが、 \fI/dev/random\fP からの読み出しが早くなるわけではないということだ。 .SS 使い方 \fI/dev/random\fP と \fI/dev/urandom\fP のどちらを使うべきか迷った場合、たいていは \fI/dev/urandom\fP の方を使いたいと思っているはずだろう。 一般に、長期に渡って使われる GPG/SSL/SSH のキー以外の全てのものに \fI/dev/urandom\fP @@ -146,29 +145,25 @@ Linux 2.6: 読み込み専用のファイル \fIuuid\fP と \fIboot_id\fP は 6fd5a44b\-35f4\-4ad4\-a9b9\-6b9be13e1fe9 のような ランダムな文字列を保持している。 前者は読み込みの度に新たに生成され、 後者は 1 度だけ生成される。 .SS "ioctl(2) インタフェース" -The following \fBioctl\fP(2) requests are defined on file descriptors -connected to either \fI/dev/random\fP or \fI/dev/urandom\fP. All requests -performed will interact with the input entropy pool impacting both -\fI/dev/random\fP and \fI/dev/urandom\fP. The \fBCAP_SYS_ADMIN\fP capability is -required for all requests except \fBRNDGETENTCNT\fP. +以下の \fBioctl\fP(2) 要求が \fI/dev/random\fP や \fI/dev/urandom\fP +に接続されたファイルディスクリプタに対して定義されている。 実行されたすべての要求は、 \fI/dev/random\fP と \fI/dev/urandom\fP +に影響を与える入力エントロピー・プールとやり取りを行う。 \fBRNDGETENTCNT\fP 以外のすべての要求には \fBCAP_SYS_ADMIN\fP +ケーパビリティが必要である。 .TP \fBRNDGETENTCNT\fP -Retrieve the entropy count of the input pool, the contents will be the same -as the \fIentropy_avail\fP file under proc. The result will be stored in the -int pointed to by the argument. +入力エントロピー・プールのカウントを取得する。 取得される内容は proc の \fIentropy_avail\fP ファイルと同じである。 +結果は引き数が指す整数 (int) に格納される。 .TP \fBRNDADDTOENTCNT\fP -Increment or decrement the entropy count of the input pool by the value -pointed to by the argument. +入力エントロピー・プールのカウントを引き数が指す値だけ加算または減算する。 .TP \fBRNDGETPOOL\fP -Removed in Linux 2.6.9. +Linux 2.6.9 で削除された。 .TP \fBRNDADDENTROPY\fP -Add some additional entropy to the input pool, incrementing the entropy -count. This differs from writing to \fI/dev/random\fP or \fI/dev/urandom\fP, -which only adds some data but does not increment the entropy count. The -following structure is used: +入力プールに追加のエントロピーを追加し、エントロピー・カウントを増やす。 この要求は \fI/dev/random\fP や \fI/dev/urandom\fP +への書き込みとは異なる。 \fI/dev/random\fP や \fI/dev/urandom\fP への書き込みでは、 何らかのデータが追加されるだけで、 +エントロピー・カウントは増やされない。 以下の構造体が使用される。 .IP .nf struct rand_pool_info { @@ -178,13 +173,11 @@ following structure is used: }; .fi .IP -Here \fIentropy_count\fP is the value added to (or subtracted from) the entropy -count, and \fIbuf\fP is the buffer of size \fIbuf_size\fP which gets added to the -entropy pool. +\fIentropy_count\fP はエントロピー・カウントに加算 (または減算) する値である。 \fIbuf\fP は大きさが \fIbuf_size\fP +のバッファで、この内容がエントロピー・プールに追加される。 .TP \fBRNDZAPENTCNT\fP, \fBRNDCLEARPOOL\fP -Zero the entropy count of all pools and add some system data (such as wall -clock) to the pools. +すべてのプールのエントロピー・カウントを 0 にし、何らかのシステムデータ (現在の時刻など) をプールに追加する。 .SH ファイル /dev/random .br @@ -197,6 +190,6 @@ clock) to the pools. .br RFC\ 1750, "Randomness Recommendations for Security" .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/man4/rtc.4 b/release/man4/rtc.4 index 2e1b6fab..45dbabd8 100644 --- a/release/man4/rtc.4 +++ b/release/man4/rtc.4 @@ -194,6 +194,6 @@ RTC の中にはアラームフィールドに 「ワイルドカード」の値 Linux カーネルソース内の \fIDocumentation/rtc.txt\fP .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/man4/sd.4 b/release/man4/sd.4 index 1b601e8d..46eb6622 100644 --- a/release/man4/sd.4 +++ b/release/man4/sd.4 @@ -98,6 +98,6 @@ SCSI の \fBioctl\fP(2) 操作も同様にサポートされる。 \fBioctl\fP(2 .\".BR scsi (4) /dev/sd[a\-h][0\-8]: 個々のブロックパーティション .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/man4/sk98lin.4 b/release/man4/sk98lin.4 index bb14084b..0aca98a0 100644 --- a/release/man4/sk98lin.4 +++ b/release/man4/sk98lin.4 @@ -58,9 +58,11 @@ insmod を使ってドライバをロードする際、 ネットワークアダ \fI/proc/net/sk98lin\fP に作られる。 これらのファイルは \fIeth[x]\fP という名前であり、 \fIx\fP はインタフェースの番号である。 この番号はシステムによってポート毎に割り当てられたものである。 -ロードが完了すると、 \fBifconfig\fP(8) コマンドを使って、各 \fIeth[x]\fP インタフェースに希望する IP -アドレスを割り当てることができる。 これによりアダプタがイーサネットに接続され、 コンソールに状態メッセージが表示される。 このメッセージでは、 -"ethx: network connection up using port y" の後に 設定されたり検出された接続パラメータが表示される。 +If loading is finished, any desired IP address can be assigned to the +respective \fIeth[x]\fP interface using the \fBifconfig\fP(8) command. This +causes the adapter to connect to the Ethernet and to display a status +message on the console saying "ethx: network connection up using port y" +followed by the configured or detected connection parameters. \fBsk98lin\fP はラージフレーム (ジャンボフレームとも呼ばれる) もサポートする。 ジャンボフレームを使うと、大量のデータを転送する際に、 スループットを大幅に向上させることができる。 ラージフレームを有効にするには、 インタフェースの MTU (maximum transfer unit, @@ -312,6 +314,6 @@ RLMT モード \fICheckLocalPort\fP と \fICheckLinkState\fP は、1 .SH 関連項目 \fBinsmod\fP(8), \fBifconfig\fP(8), \fBmodprobe\fP(8) .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/man4/st.4 b/release/man4/st.4 index b373a07c..85c8f01b 100644 --- a/release/man4/st.4 +++ b/release/man4/st.4 @@ -138,8 +138,9 @@ kerneld や kmod によるドライバのデマンドロードに関しても当 ドライバにわたされる。 以下の定義は \fI/usr/include/linux/mtio.h\fP による。 .SS "MTIOCTOP \(em テープ操作の実行" .PP -この要求は \fI(struct mtop *)\fP 型の引数をとる。全てのドライブが全ての操作をサポートしているわけではない。 -ドライブが操作を拒否すると、ドライバは \fBEIO\fP エラーを返す。 +This request takes an argument of type \fI(struct mtop\ *)\fP. Not all drives +support all operations. The driver returns an \fBEIO\fP error if the drive +rejects an operation. .PP .in +4n .nf @@ -389,7 +390,7 @@ sense data) が用いられる。第 9\-16 ビットは注目すべきビット でなければ、 このパターンがマスク後の状態データバイトにマッチしなければならない。 .SS "MTIOCGET \(em ステータスの取得" .PP -このリクエストは \fI(struct mtget *)\fP という型の引数をとる。 +This request takes an argument of type \fI(struct mtget\ *)\fP. .PP .in +4n .nf @@ -459,10 +460,11 @@ SCSI\-1 テープ) および \fBMT_ISSCSI2\fP (汎用 SCSI\-2 テープ) のみ \fBMTSEEK\fP の後など) には \-1 にセットされる。 .SS "MTIOCPOS \(em テープ位置の取得" .PP -このリクエストは \fI(struct mtpos *)\fP 型の引数をとり、ドライブが保持している現在のテープブロック番号を報告する。 これは、 -\fBMTIOCGET\fP により返される \fImt_blkno\fP と同じではない。 ドライブは \fBREAD POSITION\fP コマンド -(デバイス固有アドレス) をサポートする SCSI\-2ドライブか、 Tandberg 互換の SCSI\-1 ドライブ (Tandberg, -Archive, Viper, Wangtek, ... ) でなければならない。 +This request takes an argument of type \fI(struct mtpos\ *)\fP and reports the +drive's notion of the current tape block number, which is not the same as +\fImt_blkno\fP returned by \fBMTIOCGET\fP. This drive must be a SCSI\-2 drive that +supports the \fBREAD POSITION\fP command (device\-specific address) or a +Tandberg\-compatible SCSI\-1 drive (Tandberg, Archive Viper, Wangtek, ... ). .PP .in +4n .nf @@ -560,6 +562,6 @@ SENSE コードが自動的にテキストに変換されて、 いくつかの Linux カーネルソースの \fIdrivers/scsi/README.st\fP や \fIDocumentation/scsi/st.txt\fP (カーネル 2.6 以降) の各ファイルには、 ドライバに関するより新しい情報や、 その設定可能な範囲に関する内容が含まれている。 .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/man4/tty.4 b/release/man4/tty.4 index 5a275b6f..da97e6da 100644 --- a/release/man4/tty.4 +++ b/release/man4/tty.4 @@ -55,6 +55,6 @@ root.tty となっている。 プロセスの制御端末が存在する場合 \fBchown\fP(1), \fBmknod\fP(1), \fBioctl\fP(2), \fBtermios\fP(3), \fBconsole\fP(4), \fBtty_ioctl\fP(4), \fBttyS\fP(4), \fBagetty\fP(8), \fBmingetty\fP(8) .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/man4/ttyS.4 b/release/man4/ttyS.4 index c06e2e54..eb0a1cad 100644 --- a/release/man4/ttyS.4 +++ b/release/man4/ttyS.4 @@ -53,6 +53,6 @@ chown root:tty /dev/ttyS[0\-3] \fBchown\fP(1), \fBmknod\fP(1), \fBtty\fP(4), \fBagetty\fP(8), \fBmingetty\fP(8), \fBsetserial\fP(8) .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/man4/tty_ioctl.4 b/release/man4/tty_ioctl.4 index 106055c3..76c1c59a 100644 --- a/release/man4/tty_ioctl.4 +++ b/release/man4/tty_ioctl.4 @@ -45,15 +45,16 @@ tty_ioctl \- 端末とシリアルラインの ioctl (入出力制御) .br 排出 (drain) を行うための出力バッファの使用を許可し、 処理していない入力を破棄して、 現在のシリアルポートの設定を変更する。 .LP -以下の 4 つの ioctl は \fBTCGETS\fP, \fBTCSETS\fP, \fBTCSETSW\fP, \fBTCSETSF\fP と似ている。 ただし、 -\fIstruct termios *\fP の代わりに \fIstruct termio *\fP を取る。 -.TP +The following four ioctls are just like \fBTCGETS\fP, \fBTCSETS\fP, \fBTCSETSW\fP, +\fBTCSETSF\fP, except that they take a \fIstruct termio\ *\fP instead of a +\fIstruct termios\ *\fP. +.IP \fBTCGETA struct termio *\fP\fIargp\fP -.TP +.IP \fBTCSETA const struct termio *\fP\fIargp\fP -.TP +.IP \fBTCSETAW const struct termio *\fP\fIargp\fP -.TP +.IP \fBTCSETAF const struct termio *\fP\fIargp\fP .SS "termios 構造体のロック" 端末の \fItermios\fP 構造体はロックすることが可能である。 このロック自体は \fItermios\fP 構造体であり、 0 @@ -326,6 +327,6 @@ main(void) .\" TIOCGSERIAL, TIOCSSERIAL (see above) \fBioctl\fP(2), \fBtermios\fP(3), \fBconsole_ioctl\fP(4), \fBpty\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/man4/vcs.4 b/release/man4/vcs.4 index afe6bd41..9e06da95 100644 --- a/release/man4/vcs.4 +++ b/release/man4/vcs.4 @@ -73,10 +73,19 @@ Linux で 利用可能である)。 値は \fBioctl\fP(2) の 3 番目の引き .SH バージョン Linux カーネルバージョン 1.1.92 で導入された。 .SH 例 -vt3 のスクリーンダンプを実行するには、端末を vt1 に切替えて \fIcat /dev/vcs3 >foo\fP とタイプすればよい。 -気を付けて欲しいのは、この出力は改行文字 (newline character) を 含んでいないという事である。 従って、\fIfold \-w 81 -/dev/vcs3 | lpr\fP や (ぞっとするが) \fIsetterm \-dump 3 \-file /proc/self/fd/1\fP のような -何らかの処理が必要になるかもしれない。 +You may do a screendump on vt3 by switching to vt1 and typing + + cat /dev/vcs3 >foo + +Note that the output does not contain newline characters, so some processing +may be required, like in + + old \-w 81 /dev/vcs3 | lpr + +or (horrors) + + xetterm \-dump 3 \-file /proc/self/fd/1 + .LP \fI/dev/vcsa0\fP デバイスを使うことで、 ブライユ点字をサポートすることができる。 @@ -133,6 +142,6 @@ main(void) .SH 関連項目 \fBconsole\fP(4), \fBtty\fP(4), \fBttyS\fP(4), \fBgpm\fP(8) .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/man4/wavelan.4 b/release/man4/wavelan.4 index 6e1abf71..f69fc139 100644 --- a/release/man4/wavelan.4 +++ b/release/man4/wavelan.4 @@ -87,6 +87,6 @@ wavelan カードを検出する時にどこのベースアドレスをサーチ \fBwavelan_cs\fP(4), \fBifconfig\fP(8), \fBinsmod\fP(8), \fBiwconfig\fP(8), \fBiwpriv\fP(8), \fBiwspy\fP(8) .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/man5/acct.5 b/release/man5/acct.5 index de1fa678..0ecd7e05 100644 --- a/release/man5/acct.5 +++ b/release/man5/acct.5 @@ -141,6 +141,6 @@ struct acct_v3 { .SH 関連項目 \fBlastcomm\fP(1), \fBacct\fP(2), \fBaccton\fP(8), \fBsa\fP(8) .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/man5/charmap.5 b/release/man5/charmap.5 index b5285166..d5d86bac 100644 --- a/release/man5/charmap.5 +++ b/release/man5/charmap.5 @@ -93,6 +93,6 @@ POSIX.2. \fBlocale\fP(1), \fBlocaledef\fP(1), \fBlocaleconv\fP(3), \fBsetlocale\fP(3), \fBlocale\fP(5) .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/man5/core.5 b/release/man5/core.5 index 8986c68f..595b320f 100644 --- a/release/man5/core.5 +++ b/release/man5/core.5 @@ -27,7 +27,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH CORE 5 2013\-02\-25 Linux "Linux Programmer's Manual" +.TH CORE 5 2013\-06\-08 Linux "Linux Programmer's Manual" .SH 名前 core \- コアダンプファイル .SH 説明 @@ -66,11 +66,10 @@ GID) と異なる場合 (但し、 \fBprctl\fP(2) \fBPR_SET_DUMPABLE\fP 操作 \fI/proc/sys/fs/suid_dumpable\fP ファイルの説明も参照のこと)。 .IP * .\" commit 046d662f481830e652ac34cd112249adde16452a -(Since Linux 3.7) The kernel was configured without the \fBCONFIG_COREDUMP\fP -option. +(Linux 3.7 以降) カーネルの設定で \fBCONFIG_COREDUMP\fP オプションが有効になっていない。 .PP -In addition, a core dump may exclude part of the address space of the -process if the \fBmadvise\fP(2) \fBMADV_DONTDUMP\fP flag was employed. +上記に加えて、 \fBmadvise\fP(2) の \fBMADV_DONTDUMP\fP +フラグが使用されている場合、プロセスのアドレス空間の一部がコアダンプから除外される場合がある。 .SS コアダンプファイルの名前 デフォルトでは、コアダンプファイルの名前は \fIcore\fP となるが、コアダンプファイルの名前を決めるのに使われるテンプレートを \fI/proc/sys/kernel/core_pattern\fP ファイルに定義することで、ファイル名を変更することができる @@ -125,9 +124,9 @@ process if the \fBmadvise\fP(2) \fBMADV_DONTDUMP\fP flag was employed. という形式の名前になり、ファイル名にプロセス ID が含まれる。 .\" 9520628e8ceb69fa9a4aee6b57f22675d9e1b709 -Since Linux 3.6, if \fI/proc/sys/fs/suid_dumpable\fP is set to 2 ("suidsafe"), -the pattern must be either an absolute pathname (starting with a leading -\(aq/\(aq character) or a pipe, as defined below. +Linux 3.6 以降では、\fI/proc/sys/fs/suid_dumpable\fP が 2 ("suidsafe") +に設定されている場合、テンプレートは、絶対パス名 (先頭に \(aq/\(aq 文字があるパス名) かパイプ (以下で説明) +のどちらかでなければならない。 .SS コアダンプのプログラムへのパイプ カーネル 2.6.19 以降では、Linux は \fI/proc/sys/kernel/core_pattern\fP ファイルの別の構文をサポートしている。 このファイルの最初の文字がパイプ記号 (\fB|\fP) であれば、 @@ -203,6 +202,7 @@ $\fB ./some_program\fP .SH 注意 \fBgdb\fP(1) の \fIgcore\fP コマンドを使用すると、実行中のプロセスのコアダンプを取得できる。 +.\" Changed with commit 6409324b385f3f63a03645b4422e3be67348d922 .\" Always including the PID in the name of the core file made .\" sense for LinuxThreads, where each thread had a unique PID, .\" but doesn't seem to serve any purpose with NPTL, where all the @@ -211,11 +211,14 @@ $\fB ./some_program\fP .\" LinuxThreads continue appending the PID (the kernel has no easy .\" way of telling which threading implementation the user-space .\" application is using). -- mtk, April 2006 -マルチスレッドプロセス (より正確には、 \fBclone\fP(2) の \fBCLONE_VM\fP で生成された別プロセスとメモリを共有しているプロセス) -がコアダンプを生成する場合、 コアファイル名にプロセス ID が必ず付加される。 ただし、 -\fI/proc/sys/kernel/core_pattern\fP の %p 指定によりコアファイル名のどこか他の場所にプロセス ID が -すでに含まれている場合は、プロセス ID が末尾に付加されない。 (この機能がまず役に立つのは LinuxThreads 実装を利用している場合である。 -LinuxThreads 実装では、プロセス内の個々のスレッドは異なるプロセス ID を持つ。) +In Linux versions up to and including 2.6.27, if a multithreaded process +(or, more precisely, a process that shares its memory with another process +by being created with the \fBCLONE_VM\fP flag of \fBclone\fP(2)) dumps core, then +the process ID is always appended to the core filename, unless the process +ID was already included elsewhere in the filename via a %p specification in +\fI/proc/sys/kernel/core_pattern\fP. (This is primarily useful when employing +the obsolete LinuxThreads implementation, where each thread of a process has +a different PID.) .SH 例 以下のプログラムは \fI/proc/sys/kernel/core_pattern\fP ファイルのパイプ構文の使用例を示している。 以下のシェルのセッションはこのプログラムの使用例を示すものである (コンパイルして \fIcore_pattern_pipe_test\fP @@ -299,6 +302,6 @@ main(int argc, char *argv[]) \fBbash\fP(1), \fBgdb\fP(1), \fBgetrlimit\fP(2), \fBmmap\fP(2), \fBprctl\fP(2), \fBsigaction\fP(2), \fBelf\fP(5), \fBproc\fP(5), \fBpthreads\fP(7), \fBsignal\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/man5/elf.5 b/release/man5/elf.5 index efded5ba..740cea1d 100644 --- a/release/man5/elf.5 +++ b/release/man5/elf.5 @@ -18,8 +18,10 @@ .\"ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\"FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\"DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\"OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\"HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\"LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\"OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\"SUCH DAMAGE. .\" %%%LICENSE_END .\" @@ -187,7 +189,7 @@ typedef struct { .PD 0 \fBEI_VERSION\fP .\" .Bl -tag -width "EV_CURRENT" -compact -The seventh byte is the version number of the ELF specification: +第 7 バイトは ELF 仕様のバージョン番号である: .RS 12 .TP 14 \fBEV_NONE\fP @@ -201,10 +203,8 @@ The seventh byte is the version number of the ELF specification: .TP \fBEI_OSABI\fP .\" .Bl -tag -width "ELFOSABI_STANDALONE" -compact -The eighth byte identifies the operating system and ABI to which the object -is targeted. Some fields in other ELF structures have flags and values that -have platform\-specific meanings; the interpretation of those fields is -determined by the value of this byte. E.g.: +第 8 バイトはオブジェクトのターゲットとなるオペレーティングシステムと ABI を示す。他の ELF +構造体のフィールドには、プラットフォーム固有の意味を持つフラグや値を持つものもある。これらのフィールドの解釈は、このバイトの値によって決定される。以下に例を挙げる。 .RS 12 .TP 20 .PD 0 @@ -275,11 +275,9 @@ ARM アーキテクチャ ABI. .RE .TP \fBEI_ABIVERSION\fP -The ninth byte identifies the version of the ABI to which the object is -targeted. This field is used to distinguish among incompatible versions of -an ABI. The interpretation of this version number is dependent on the ABI -identified by the \fBEI_OSABI\fP field. Applications conforming to this -specification use the value 0. +第 9 バイトはオブジェクトがターゲットとしている ABI のバージョンを示す。 このフィールドは互換性のない ABI +のバージョンを区別するために使われる。 このバージョン番号の解釈は、 \fBEI_OSABI\fP フィールドで識別される ABI に依存する。 +この仕様に準拠するアプリケーションでは、値 0 を使う。 .TP \fBEI_PAD\fP .\" As reported by Yuri Kozlov and confirmed by Mike Frysinger, EI_BRAND is @@ -1360,6 +1358,6 @@ AMD64 ABI Draft, \fISystem V Application Binary Interface AMD64 Architecture Processor Supplement\fP. .PP .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/man5/filesystems.5 b/release/man5/filesystems.5 index 75e37a13..f9ff2a56 100644 --- a/release/man5/filesystems.5 +++ b/release/man5/filesystems.5 @@ -151,6 +151,6 @@ Manager が使っている。 .SH 関連項目 \fBproc\fP(5), \fBfsck\fP(8), \fBmkfs\fP(8), \fBmount\fP(8) .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/man5/ftpusers.5 b/release/man5/ftpusers.5 index 9bdb4896..d3320a05 100644 --- a/release/man5/ftpusers.5 +++ b/release/man5/ftpusers.5 @@ -40,6 +40,6 @@ University FTP サーバーデーモン (wuftpd) と Professional FTP デーモ .SH 関連項目 \fBpasswd\fP(5), \fBproftpd\fP(8), \fBwuftpd\fP(8) .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/man5/group.5 b/release/man5/group.5 index cba71866..373d0cfe 100644 --- a/release/man5/group.5 +++ b/release/man5/group.5 @@ -60,6 +60,6 @@ group_name:password:GID:user_list .SH 関連項目 \fBlogin\fP(1), \fBnewgrp\fP(1), \fBgetgrent\fP(3), \fBgetgrnam\fP(3), \fBpasswd\fP(5) .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/man5/host.conf.5 b/release/man5/host.conf.5 index 62d8d15d..819bd70a 100644 --- a/release/man5/host.conf.5 +++ b/release/man5/host.conf.5 @@ -117,6 +117,6 @@ syslog 機能を通じた警告を発しない。 このオプションを \fIwa .SH 関連項目 \fBgethostbyname\fP(3), \fBhostname\fP(7), \fBnamed\fP(8), \fBresolv+\fP(8) .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/man5/hosts.5 b/release/man5/hosts.5 index 9383f36a..f6f261cd 100644 --- a/release/man5/hosts.5 +++ b/release/man5/hosts.5 @@ -93,6 +93,6 @@ Information Control Center (NIC) によって 管理される公式ホストデ .\" for the Debian GNU/Linux system. Internet RFC\ 952 .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/man5/hosts.equiv.5 b/release/man5/hosts.equiv.5 index 7270fd6f..638e06aa 100644 --- a/release/man5/hosts.equiv.5 +++ b/release/man5/hosts.equiv.5 @@ -12,8 +12,9 @@ .SH 名前 /etc/hosts.equiv \- 「信頼された」\fBr\fP コマンドによるシステムへの アクセスを許可するホストおよびユーザのリスト .SH 説明 -\fBhosts.equiv\fP ファイルは \fBr\fP\-コマンド (\fBrlogin\fP, \fBrsh\fP, \fBrcp\fP など) -によるパスワードなしでの利用を 許可/拒否するホスト/ユーザを設定する。 +The \fBhosts.equiv\fP file allows or denies hosts and users to use the +\fBr\fP\-commands (e.g., \fBrlogin\fP, \fBrsh\fP or \fBrcp\fP) without supplying a +password. .PP このファイルでは以下の書式を用いる。 .TP @@ -47,6 +48,6 @@ netgroup を指定することもでき、その場合は @ 記号を前につ .SH 関連項目 \fBrhosts\fP(5), \fBrlogind\fP(8), \fBrshd\fP(8) .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/man5/intro.5 b/release/man5/intro.5 index 6b7791d5..eed5e45e 100644 --- a/release/man5/intro.5 +++ b/release/man5/intro.5 @@ -40,6 +40,6 @@ intro \- ファイルフォーマットの紹介 .SH 関連項目 \fBstandards\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/man5/issue.5 b/release/man5/issue.5 index fa84e373..ca044cb8 100644 --- a/release/man5/issue.5 +++ b/release/man5/issue.5 @@ -41,6 +41,6 @@ issue \- ログイン前に表示されるメッセージとシステム情報 .SH 関連項目 \fBmotd\fP(5), \fBagetty\fP(8), \fBmingetty\fP(8) .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/man5/locale.5 b/release/man5/locale.5 index 03ad3d3d..d81ec54a 100644 --- a/release/man5/locale.5 +++ b/release/man5/locale.5 @@ -325,6 +325,6 @@ POSIX.2, ISO/IEC 14652. \fBlocale\fP(1), \fBlocaledef\fP(1) \fBlocaleconv\fP(3), \fBsetlocale\fP(3), \fBcharmap\fP(5), .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/man5/motd.5 b/release/man5/motd.5 index 8e3e74f3..596b1198 100644 --- a/release/man5/motd.5 +++ b/release/man5/motd.5 @@ -42,6 +42,6 @@ motd \- 今日のお知らせ(message of the day) .SH 関連項目 \fBlogin\fP(1), \fBissue\fP(5) .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/man5/networks.5 b/release/man5/networks.5 index 3d1c1deb..096d9575 100644 --- a/release/man5/networks.5 +++ b/release/man5/networks.5 @@ -72,6 +72,6 @@ DARPA ネットワークとその分かりやすい名前を記載したファ \fBgetnetbyaddr\fP(3), \fBgetnetbyname\fP(3), \fBgetnetent\fP(3), \fBnetstat\fP(8), \fBroute\fP(8) .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/man5/nologin.5 b/release/man5/nologin.5 index 91b2fced..667a6d92 100644 --- a/release/man5/nologin.5 +++ b/release/man5/nologin.5 @@ -41,6 +41,6 @@ nologin \- 非特権ユーザのログインを禁止する .SH 関連項目 \fBlogin\fP(1), \fBshutdown\fP(8) .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/man5/nscd.conf.5 b/release/man5/nscd.conf.5 index 05319089..a387d06e 100644 --- a/release/man5/nscd.conf.5 +++ b/release/man5/nscd.conf.5 @@ -123,16 +123,14 @@ \fBmax\-db\-size\fP \fIservice\fP \fIbytes\fP .RS -The maximum allowable size, in bytes, of the database files for the -\fIservice\fP. The default is 33554432. +\fIservice\fP のデータベースファイルの最大許容サイズ (バイト単位)。 デフォルト値は 33554432 である。 .RE \fBauto\-propagate\fP \fIservice\fP \fI\fP .RS -When set to \fIno\fP for \fIpasswd\fP or \fIgroup\fP service, then the \fI.byname\fP -requests are not added to \fIpasswd.byuid\fP or \fIgroup.bygid\fP cache. This can -help with tables containing multiple records for the same ID. The default -is yes. This option is valid only for services \fIpasswd\fP and \fIgroup\fP. +サービス \fIpasswd\fP か \fIgroup\fP で \fIno\fP に設定すると、 \fI.byname\fP 要求は \fIpasswd.byuid\fP や +\fIgroup.bygid\fP のキャッシュに追加されない。 このオプションは、 同じ ID を持つレコードが複数あるテーブルの場合に役に立つ。 +デフォルトは yes である。 このオプションはサービス \fIpasswd\fP と \fIgroup\fP でのみ有効である。 .RE .SH 関連項目 .\" .SH AUTHOR @@ -140,6 +138,6 @@ is yes. This option is valid only for services \fIpasswd\fP and \fIgroup\fP. .\" was written by Thorsten Kukuk and Ulrich Drepper. \fBnscd\fP(8) .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/man5/nsswitch.conf.5 b/release/man5/nsswitch.conf.5 index 36a500f7..4a0dbc79 100644 --- a/release/man5/nsswitch.conf.5 +++ b/release/man5/nsswitch.conf.5 @@ -57,7 +57,7 @@ GNU C ライブラリでは以下のデータベースを扱うことができ ホスト名とホスト番号。 \fBgethostbyname\fP(3) や関連する関数が使用する。 .TP \fBinitgroups\fP -Supplementary group access list, used by \fBgetgrouplist\fP(3) function. +補助グループアクセスリスト。 \fBgetgrouplist\fP(3) 関数が使用する。 .TP \fBnetgroup\fP ネットワークワイドに用いられるホストやユーザーのリスト。アクセス制限に利用 @@ -194,11 +194,9 @@ STATUS と ACTION はそれぞれ以下の値を取る。 .RS 4 .TP 12 \fBreturn\fP -Return a result now. Do not call any further lookup functions. However, -for compatibility reasons, if this is the selected action for the \fBgroup\fP -database and the \fBnotfound\fP status, and the configuration file does not -contain the \fBinitgroups\fP line, the next lookup function is always called, -without affecting the search result. +結果をすぐに返す。 これ以上検索処理は呼び出されない。 ただし、互換性のため、 選択されたアクションが \fBgroup\fP データベースに対するもので、 +ステータスが \fBnotfound\fP であった場合で、 設定ファイルに \fBinitgroups\fP +の行が含まれていない場合には、次の検索処理は常に呼び出される (検索結果への影響はない)。 .TP \fBcontinue\fP 次の検索処理を呼び出す。 @@ -278,6 +276,6 @@ Solaris 2 の C ライブラリで使った機構が基になっている。 .SH 関連項目 \fBgetent\fP(1), \fBnss\fP(5) .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/man5/passwd.5 b/release/man5/passwd.5 index 088604b9..c8ba0f1f 100644 --- a/release/man5/passwd.5 +++ b/release/man5/passwd.5 @@ -133,6 +133,6 @@ gcos 欄は $IDENT カード用の情報を 隠しておくための場所なん \fBlogin\fP(1), \fBpasswd\fP(1), \fBsu\fP(1), \fBgetpwent\fP(3), \fBgetpwnam\fP(3), \fBcrypt\fP(3), \fBgroup\fP(5), \fBshadow\fP(5) .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/man5/proc.5 b/release/man5/proc.5 index 96e30bd5..f81e342d 100644 --- a/release/man5/proc.5 +++ b/release/man5/proc.5 @@ -64,7 +64,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH PROC 5 2013\-04\-17 Linux "Linux Programmer's Manual" +.TH PROC 5 2013\-06\-27 Linux "Linux Programmer's Manual" .SH 名前 proc \- プロセスの情報を含む擬似ファイルシステム .SH 説明 @@ -180,11 +180,33 @@ Linux 2.0 以前では、 \fI/proc/[pid]/exe\fP は実行されたバイナリ \fI\-inum\fP オプションをつけて \fBfind\fP(1) を使うと、 このファイルの所在を探すことができる。 .TP -\fI/proc/[pid]/fd\fP +\fI/proc/[pid]/fd/\fP プロセスがオープンしたファイル各々に対するエントリを含むサブディレクトリ。 ファイルディスクリプタがファイル名で、 実際のファイルへのシンボリックリンクになっている。 したがって 0 は標準入力、1 は標準出力、2 は標準エラー出力、などとなる。 -.\" The following was still true as at kernel 2.6.13 +For file descriptors for pipes and sockets, the entries will be symbolic +links whose content is the file type with the inode. A \fBreadlink\fP(2) call +on this file returns a string in the format: + + type:[inode] + +For example, \fIsocket:[2248868]\fP will be a socket and its inode is 2248868. +For sockets, that inode can be used to find more information in one of the +files under \fI/proc/net/\fP. + +For file descriptors that have no corresponding inode (e.g., file +descriptors produced by \fBepoll_create\fP(2), \fBeventfd\fP(2), +\fBinotify_init\fP(2), \fBsignalfd\fP(2), and \fBtimerfd\fP(2)), the entry will be a +symbolic link with contents of the form + + anon_inode: + +In some cases, the \fIfile\-type\fP is surrounded by square brackets. + +For example, an epoll file descriptor will have a symbolic link whose +content is the string \fIanon_inode:[eventpoll]\fP. + +.\"The following was still true as at kernel 2.6.13 マルチスレッドプロセスでは、メインスレッドがすでに終了している場合、 このディレクトリの内容は参照できない (スレッドの終了は通常 \fBpthread_exit\fP(3) を呼び出しにより行われる)。 @@ -252,7 +274,7 @@ including Linux 2.6.35, this file is protected to allow reading only by the real UID of the process. Since Linux 2.6.36, this file is readable by all users on the system. .TP -\fI/proc/[pid]/map_files/\fP (since kernel 3.3) +\fI/proc/[pid]/map_files/\fP (kernel 3.3 以降) .\" commit 640708a2cff7f81e246243b0073c66e6ece7e53e This subdirectory contains entries corresponding to memory\-mapped files (see \fBmmap\fP(2)). Entries are named by memory region start and end address pair @@ -291,7 +313,7 @@ A file containing the currently mapped memory regions and their access permissions. See \fBmmap\fP(2) for some further information about memory mappings. -The format of the file is: +ファイルのフォーマットは以下のとおり: .in -7n .nf @@ -346,7 +368,7 @@ There are additional helpful pseudo\-paths: \fI[stack]\fP The initial process's (also known as the main thread's) stack. .TP -\fI[stack:]\fP (since Linux 3.4) +\fI[stack:]\fP (Linux 3.4 以降) .\" commit b76437579d1344b612cf1851ae610c636cec7db0 A thread's stack (where the \fI\fP is a thread ID). It corresponds to the \fI/proc/[pid]/task/[tid]/\fP path. @@ -689,7 +711,6 @@ disk sleep)、 Z はゾンビ状態 (zombie)、 T はトレースされている \fIminflt\fP %lu (10) プロセスが引き起こしたマイナーフォールト (minor fault、ディスクから メモリページへのロードを必要としないフォールト) の回数。 .TP -.\" field 11 \fIcminflt\fP %lu (11) (そのプロセスが終了を待っている) 子プロセスが引き起こしたマイナーフォールトの回数。 .TP @@ -750,7 +771,6 @@ Linux 2.6 より前では、このプロセスに割り当てられたスケジ (20) このプロセスのスレッド数 (Linux 2.6 以降)。 カーネル 2.6 より前では、このフィールドは削除されたフィールドの 場所埋めとして 0 にハードコードされていた。 .TP -.\" field 21 \fIitrealvalue\fP %ld (21) インターバルタイマによって、次に \fBSIGALRM\fP がプロセスへ送られるまでの時間 (単位 jiffies)。 カーネル 2.6.17 以降では、このフィールドはメンテナンスされなくなり、 0 にハードコードされている。 @@ -787,7 +807,6 @@ is expressed in clock ticks (divide by \fIsysconf(_SC_CLK_TCK)\fP). \fIkstkeip\fP %lu (30) 現在の EIP (インストラクションポインタ) の値。 .TP -.\" field 31 \fIsignal\fP %lu (31) 処理待ちのシグナルのビットマップ。 10 進数で表示される。このフィールドは廃止予定である。リアルタイム・シグナルに関する情報は表示されないからである。代わりに @@ -829,7 +848,6 @@ is expressed in clock ticks (divide by \fIsysconf(_SC_CLK_TCK)\fP). (40) リアルタイム・スケジューリングの優先度。 リアルタイム・ポリシーの元でスケジューリングされるプロセスでは 1 から 99 の範囲の値となり、 リアルタイム以外のスケジューリングポリシーのプロセスでは 0 となる (\fBsched_setscheduler\fP(2) 参照)。 .TP -.\" field 41 \fIpolicy\fP %u (Linux 2.5.19 以降; Linux 2.6.22 より前は %lu) (41) スケジューリング・ポリシー (\fBsched_setscheduler\fP(2) 参照)。 値は、 \fIlinux/sched.h\fP の SCHED_* 定数を使ってデコードすればよい。 @@ -1906,8 +1924,8 @@ BSD\-style process accounting が有効になっている場合、 これら 3 (単位は秒)。 デフォルトの値は、4, 2, 30 である。 つまり、空き領域が 2% 以下になるとログ記録を一時停止し、 空き領域が 4% 以上となったときに再開する。 空き領域についての情報は 30 秒間有効である点に注意すること。 .TP -\fI/proc/sys/kernel/cap_last_cap\fP (since Linux 3.2) -See \fBcapabilities\fP(7). +\fI/proc/sys/kernel/cap_last_cap\fP (Linux 3.2 以降) +\fBcapabilities\fP(7) 参照。 .TP \fI/proc/sys/kernel/cap\-bound\fP (Linux 2.2 to 2.6.24 以降) \fI/proc/sys/kernel/cap\-bound\fP このファイルにはカーネルの \fIcapability bounding set\fP (符号付き @@ -2004,7 +2022,7 @@ is built with the \fBCONFIG_MODULES\fP option enabled. \fI/proc/sys/kernel/msgmax\fP このファイルは、System V メッセージキューに書き込まれる 1 つのメッセージの 最大バイト数を、システム全体で制限する。 .TP -\fI/proc/sys/kernel/msgmni\fP (since Linux 2.4) +\fI/proc/sys/kernel/msgmni\fP (Linux 2.4 以降) This file defines the system\-wide limit on the number of message queue identifiers. .TP @@ -2080,8 +2098,8 @@ real\-time (queued) signal の 最大数を調整するのに使用される。 \fI/proc/sys/kernel/rtsig\-nr\fP (2.6.7 までのカーネルにのみ存在する) このファイルは現在キューに入っている POSIX real\-time signal の数を表す。 .TP -\fI/proc/sys/kernel/sched_rr_timeslice_ms\fP (since Linux 3.9) -See \fBsched_rr_get_interval\fP(2). +\fI/proc/sys/kernel/sched_rr_timeslice_ms\fP (Linux 3.9 以降) +\fBsched_rr_get_interval\fP(2) 参照。 .TP \fI/proc/sys/kernel/sem\fP (Linux 2.4 以降) このファイルには System V IPC セマフォを制限する 4 つの値が書かれている。 これらのフィールドは次の順番に並んでいる: @@ -2101,7 +2119,7 @@ See \fBsched_rr_get_interval\fP(2). \fIinclude/scsi/sg.h\fP を編集して \fBSG_BIG_BUFF\fP の値を変えれば変更できる。 ただし、この値を変更する理由はないだろう。 .TP -\fI/proc/sys/kernel/shm_rmid_forced\fP (since Linux 3.1) +\fI/proc/sys/kernel/shm_rmid_forced\fP (Linux 3.1 以降) .\" commit b34a6b1da371ed8af1221459a18c67970f7e3d53 .\" See also Documentation/sysctl/kernel.txt If this file is set to 1, all System V shared memory segments will be marked @@ -2135,7 +2153,7 @@ semantics of the applications using System V shared memory on your system. を取得または設定できる。 現在は 1GB までの共有メモリセグメントが カーネルでサポートされている。 この値のデフォルトは \fBSHMMAX\fP である。 .TP -\fI/proc/sys/kernel/shmmni\fP (since Linux 2.4) +\fI/proc/sys/kernel/shmmni\fP (Linux 2.4 以降) このファイルは、システム全体で作成可能な System V 共有メモリセグメント数を指定する。 .TP \fI/proc/sys/kernel/sysrq\fP @@ -2384,6 +2402,6 @@ kill されるだけかもしれない。 この場合には、カーネルパ Linux カーネルのソースファイル: \fIDocumentation/filesystems/proc.txt\fP, \fIDocumentation/sysctl/vm.txt\fP .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/man5/protocols.5 b/release/man5/protocols.5 index 9311f897..fda9833e 100644 --- a/release/man5/protocols.5 +++ b/release/man5/protocols.5 @@ -74,6 +74,6 @@ Numbers Authority) によって指定される。 .UR http://www.iana.org\:/assignments\:/protocol\-numbers .UE .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/man5/resolv.conf.5 b/release/man5/resolv.conf.5 index 57259381..f62f2b5b 100644 --- a/release/man5/resolv.conf.5 +++ b/release/man5/resolv.conf.5 @@ -43,16 +43,13 @@ resolv.conf \- レゾルバ設定ファイル この状態を変更するための設定オプションには、以下のようなものがある。 .TP \fBnameserver\fP ネームサーバの IP アドレス -Internet address of a name server that the resolver should query, either an -IPv4 address (in dot notation), or an IPv6 address in colon (and possibly -dot) notation as per RFC 2373. Up to \fBMAXNS\fP (currently 3, see -\fI\fP) name servers may be listed, one per keyword. If -there are multiple servers, the resolver library queries them in the order -listed. If no \fBnameserver\fP entries are present, the default is to use the -name server on the local machine. (The algorithm used is to try a name -server, and if the query times out, try the next, until out of name servers, -then repeat trying all the name servers until a maximum number of retries -are made.) +レゾルバが問い合わせをするネームサーバのインターネットアドレス。 アドレスには IPv4 アドレスか IPv6 アドレスを指定する。 IPv4 +アドレスはドット表記で、 IPv6 アドレスは RFC 2373 で定められたコロン表記 (おそらくドット表記も可) で指定する。 このキーワード 1 +つごとに 1 台づつ、 \fBMAXNS\fP 台 (現状では 3 台、\fI\fP を参照) +までのネームサーバをリストできる。 複数のサーバが指定された場合、レゾルバライブラリは リストされた順に問い合わせを行う。 \fBnameserver\fP +エントリがない場合、 デフォルトではローカルマシン上のネームサーバが使われる。 (ここで使われるアルゴリズムは以下のようなものである。 +はじめにネームサーバに問い合わせを試みる。 この問い合わせがタイムアウトになった場合、 次のネームサーバに問い合わせを試みる。 +これをネームサーバがなくなるまで続ける。 それでも応答がない場合は、リトライ最大回数に達するまで 全てのネームサーバに問い合わせを繰り返す。) .TP \fBdomain\fP ローカルドメイン名 このドメインにある名前の問い合わせのほとんどに、 このローカルドメインにおける短い名前を使用することができる。 \fBdomain\fP @@ -101,8 +98,8 @@ options により、レゾルバの内部変数を変更することができる .TP \fBdebug\fP .\" Since glibc 2.2? -sets \fBRES_DEBUG\fP in \fI_res.options\fP (effective only if glibc was built with -debug support; see \fBresolver\fP(3)). +\fBRES_DEBUG\fP を \fI_res.options\fP にセットする (glibc +がデバッグを有効にしてコンパイルされている場合にのみ有効である; \fBresolver\fP(3) を参照)。 .TP \fBndots:\fP\fIn\fP .\" Since glibc 2.2 @@ -164,12 +161,10 @@ glibc は IPv6 と IPv4 の検索を順番に実行するようになる (名前解決処理が若干遅くなるというデメリットがある)。 .TP \fBsingle\-request\-reopen\fP (glibc 2.9 以降) -The resolver uses the same socket for the A and AAAA requests. Some -hardware mistakenly sends back only one reply. When that happens the client -system will sit and wait for the second reply. Turning this option on -changes this behavior so that if two requests from the same port are not -handled correctly it will close the socket and open a new one before sending -the second request. +リゾルバは同じソケットを使って A レコードと AAAA レコードの検索要求を行う。 +いくつかのハードウェアは実装が間違っており、応答を一つしか返さない。 この状況になると、クライアントシステムは 2 番目の応答を待ち続けてしまう。 +このオプションを有効にすると、この動作が変更され、 同じポートからの 2 つの検索要求が正しく処理されなかった場合、 2 +番目の検索要求を送信する前にソケットをクローズし 新しいソケットをオープンするようになる。 .RE .LP \fIdomain\fP と \fIsearch\fP キーワードは、互いに排他的である。 これらのキーワードが 2 つ以上記述されている場合、 @@ -192,6 +187,6 @@ the second request. .br BIND のネームサーバオペレーションガイド .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/man5/rpc.5 b/release/man5/rpc.5 index 4db1dd16..9bec5fa7 100644 --- a/release/man5/rpc.5 +++ b/release/man5/rpc.5 @@ -33,40 +33,39 @@ RPC プログラム番号 .LP 以下に、 Sun RPC のソースパッケージからとってきた \fI/etc/rpc\fP ファイルの例を示す。 .nf -.ta 1.5i +0.5i +1.0i +1.0i -# +\f(CW# # rpc 88/08/01 4.0 RPCSRC; from 1.12 88/02/07 SMI # -portmapper 100000 portmap sunrpc -rstatd 100001 rstat rstat_svc rup perfmeter -rusersd 100002 rusers -nfs 100003 nfsprog -ypserv 100004 ypprog -mountd 100005 mount showmount -ypbind 100007 -walld 100008 rwall shutdown -yppasswdd 100009 yppasswd -etherstatd 100010 etherstat -rquotad 100011 rquotaprog quota rquota -sprayd 100012 spray -3270_mapper 100013 -rje_mapper 100014 -selection_svc 100015 selnsvc -database_svc 100016 -rexd 100017 rex -alis 100018 -sched 100019 -llockmgr 100020 -nlockmgr 100021 -x25.inr 100022 -statmon 100023 -status 100024 -bootparam 100026 -ypupdated 100028 ypupdate -keyserv 100029 keyserver -tfsd 100037 -nsed 100038 -nsemntd 100039 +portmapper 100000 portmap sunrpc +rstatd 100001 rstat rstat_svc rup perfmeter +rusersd 100002 rusers +nfs 100003 nfsprog +ypserv 100004 ypprog +mountd 100005 mount showmount +ypbind 100007 +walld 100008 rwall shutdown +yppasswdd 100009 yppasswd +etherstatd 100010 etherstat +rquotad 100011 rquotaprog quota rquota +sprayd 100012 spray +3270_mapper 100013 +rje_mapper 100014 +selection_svc 100015 selnsvc +database_svc 100016 +rexd 100017 rex +alis 100018 +sched 100019 +llockmgr 100020 +nlockmgr 100021 +x25.inr 100022 +statmon 100023 +status 100024 +bootparam 100026 +ypupdated 100028 ypupdate +keyserv 100029 keyserver +tfsd 100037 +nsed 100038 +nsemntd 100039\fP .fi .DT .SH ファイル @@ -76,6 +75,6 @@ RPC プログラム番号データベース .SH 関連項目 \fBgetrpcent\fP(3) .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/man5/securetty.5 b/release/man5/securetty.5 index ea03be04..2e02d6c2 100644 --- a/release/man5/securetty.5 +++ b/release/man5/securetty.5 @@ -40,6 +40,6 @@ suite を使用している場合は、 \fBlogin.defs\fP(5) を参照するこ .SH 関連項目 \fBlogin\fP(1), \fBlogin.defs\fP(5) .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/man5/services.5 b/release/man5/services.5 index fcd8c504..5e94b19e 100644 --- a/release/man5/services.5 +++ b/release/man5/services.5 @@ -112,8 +112,7 @@ services \- インターネット ネットワークサービス リスト .RS .nf .sp -.ta 3i -netstat 15/tcp +\f(CWnetstat 15/tcp qotd 17/tcp quote msp 18/tcp # message send protocol msp 18/udp # message send protocol @@ -121,7 +120,7 @@ chargen 19/tcp ttytst source chargen 19/udp ttytst source ftp 21/tcp # 22 \- unassigned -telnet 23/tcp +telnet 23/tcp\fP .fi .RE .SH ファイル @@ -155,6 +154,6 @@ telnet 23/tcp ポート番号の割り当てを定めている RFC (最新版は RFC\ 1700、別名 STD0002) .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/man5/shells.5 b/release/man5/shells.5 index eca08b8a..3ae18269 100644 --- a/release/man5/shells.5 +++ b/release/man5/shells.5 @@ -54,6 +54,6 @@ shells \- ログインシェルとして有効なファイルのパス名 .SH 関連項目 \fBchsh\fP(1), \fBgetusershell\fP(3) .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/man5/slabinfo.5 b/release/man5/slabinfo.5 index 203dad60..094d4ffa 100644 --- a/release/man5/slabinfo.5 +++ b/release/man5/slabinfo.5 @@ -106,6 +106,6 @@ echo "\fIcache_name limit batchcount\fP" > /proc/slabinfo Linux 2.6.16 以降では、 \fI/proc/slabinfo\fP ファイルは、カーネル設定オプション \fBCONFIG_SLAB\fP を有効にした場合のみ存在する。 .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/man5/termcap.5 b/release/man5/termcap.5 index 4f05d4b9..3ba0e3c6 100644 --- a/release/man5/termcap.5 +++ b/release/man5/termcap.5 @@ -442,6 +442,6 @@ x 垂直線 (|) .SH 関連項目 \fBncurses\fP(3), \fBtermcap\fP(3), \fBterminfo\fP(5) .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/man5/ttytype.5 b/release/man5/ttytype.5 index 3c743e42..4f6d20d3 100644 --- a/release/man5/ttytype.5 +++ b/release/man5/ttytype.5 @@ -58,6 +58,6 @@ vt320 ttys0 .SH 関連項目 \fBtermcap\fP(5), \fBterminfo\fP(5), \fBagetty\fP(8), \fBmingetty\fP(8) .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/man5/tzfile.5 b/release/man5/tzfile.5 index dbd741a5..ca123216 100644 --- a/release/man5/tzfile.5 +++ b/release/man5/tzfile.5 @@ -110,6 +110,6 @@ UTC/local インジケータはそれぞれ 1 バイトの値として格納さ glibc ソースコードの \fItimezone/tzfile.h\fP .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/man5/utmp.5 b/release/man5/utmp.5 index 4db4213f..ead693f5 100644 --- a/release/man5/utmp.5 +++ b/release/man5/utmp.5 @@ -228,6 +228,6 @@ utmp 構造体は libc5 から libc6 で変更された。そのため昔の lib \fBgetutent\fP(3), \fBgetutmp\fP(3), \fBlogin\fP(3), \fBlogout\fP(3), \fBlogwtmp\fP(3), \fBupdwtmp\fP(3), \fBinit\fP(8) .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/man6/intro.6 b/release/man6/intro.6 index bd0ef926..15df6758 100644 --- a/release/man6/intro.6 +++ b/release/man6/intro.6 @@ -37,6 +37,6 @@ intro \- ゲームプログラムの紹介 .SS 著者と著作権 著者と著作権に関しては各マニュアルページのソースのヘッダを参照すること。 これらはページごとに異なる可能性があることに注意してほしい。 .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/man7/aio.7 b/release/man7/aio.7 index 2d3df2ae..bcdcb86d 100644 --- a/release/man7/aio.7 +++ b/release/man7/aio.7 @@ -418,6 +418,6 @@ main(int argc, char *argv[]) .UR http://www.squid\-cache.org\:/~adrian\:/Reprint\-Pulavarty\-OLS2003.pdf .UE .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/man7/armscii-8.7 b/release/man7/armscii-8.7 index 491d0ee9..a1f86702 100644 --- a/release/man7/armscii-8.7 +++ b/release/man7/armscii-8.7 @@ -142,6 +142,6 @@ _ \fBascii\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/man7/ascii.7 b/release/man7/ascii.7 index 46a5f8c8..fb75cf12 100644 --- a/release/man7/ascii.7 +++ b/release/man7/ascii.7 @@ -192,6 +192,6 @@ ASCII 規格は米国規格協会 \fBiso_8859\-4\fP(7), \fBiso_8859\-5\fP(7), \fBiso_8859\-6\fP(7), \fBiso_8859\-7\fP(7), \fBiso_8859\-8\fP(7), \fBiso_8859\-9\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/man7/boot.7 b/release/man7/boot.7 index 8ae4abc9..10d21ecf 100644 --- a/release/man7/boot.7 +++ b/release/man7/boot.7 @@ -126,6 +126,6 @@ Linux で \fI/etc/init.d\fP) に配置される。これらのスクリプト .SH 関連項目 \fBinittab\fP(5), \fBbootparam\fP(7), \fBinit\fP(8), \fBrunlevel\fP(8), \fBshutdown\fP(8) .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/man7/charsets.7 b/release/man7/charsets.7 index 0e6a8531..d15463bb 100644 --- a/release/man7/charsets.7 +++ b/release/man7/charsets.7 @@ -351,6 +351,6 @@ ESC ) xx, ESC * xx, ESC + xx はそれぞれ ESC \- xx, ESC . xx, ESC / xx と \fBconsole\fP(4), \fBconsole_codes\fP(4), \fBconsole_ioctl\fP(4), \fBascii\fP(7), \fBiso_8859\-1\fP(7), \fBunicode\fP(7), \fButf\-8\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/man7/complex.7 b/release/man7/complex.7 index 5d9c33a1..7a274c5b 100644 --- a/release/man7/complex.7 +++ b/release/man7/complex.7 @@ -56,6 +56,6 @@ main(void) \fBclog2\fP(3), \fBconj\fP(3), \fBcpow\fP(3), \fBcproj\fP(3), \fBcreal\fP(3), \fBcsin\fP(3), \fBcsinh\fP(3), \fBcsqrt\fP(3), \fBctan\fP(3), \fBctanh\fP(3) .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/man7/cp1251.7 b/release/man7/cp1251.7 index 9b610f79..20b8c7c5 100644 --- a/release/man7/cp1251.7 +++ b/release/man7/cp1251.7 @@ -177,6 +177,6 @@ CP\ 1251 は Windows キリル文字としても知られている。 .SH 関連項目 \fBascii\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/man7/epoll.7 b/release/man7/epoll.7 index 2fe6d014..bf852205 100644 --- a/release/man7/epoll.7 +++ b/release/man7/epoll.7 @@ -308,6 +308,6 @@ file handle" とも 呼ばれ、オープンされたファイルのカーネル .SH 関連項目 \fBepoll_create\fP(2), \fBepoll_create1\fP(2), \fBepoll_ctl\fP(2), \fBepoll_wait\fP(2) .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/man7/feature_test_macros.7 b/release/man7/feature_test_macros.7 index 50acc1f7..e032458a 100644 --- a/release/man7/feature_test_macros.7 +++ b/release/man7/feature_test_macros.7 @@ -401,6 +401,6 @@ main(int argc, char *argv[]) \fI/usr/include/features.h\fP .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/man7/futex.7 b/release/man7/futex.7 index 902f29e8..b0f15f3f 100644 --- a/release/man7/futex.7 +++ b/release/man7/futex.7 @@ -85,6 +85,6 @@ of the Ottawa Linux Symposium 2002), futex の使用例ライブラリ, futex\-* .UR ftp://ftp.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/ .UE . .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/man7/hier.7 b/release/man7/hier.7 index 53363b80..b53453a5 100644 --- a/release/man7/hier.7 +++ b/release/man7/hier.7 @@ -383,6 +383,6 @@ The Filesystem Hierarchy Standard, Version 2.2 The Filesystem Hierarchy Standard .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/man7/inotify.7 b/release/man7/inotify.7 index acbb16bd..26ea586b 100644 --- a/release/man7/inotify.7 +++ b/release/man7/inotify.7 @@ -28,7 +28,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH INOTIFY 7 2013\-02\-25 Linux "Linux Programmer's Manual" +.TH INOTIFY 7 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 inotify \- ファイルシステムイベントを監視する .SH 説明 @@ -88,9 +88,11 @@ struct inotify_event { アプリケーションで関連づけることができる。 他のイベント種別の場合には、 \fIcookie\fP は 0 に設定する。 -\fIname\fP フィールドは監視しているディレクトリ内のファイルに対して イベントが返される場合のためにだけ存在する。 -監視するディレクトリからのファイルの相対パス名を表す。 このパス名は NULL で終端され、 その後の読み込みで適切なアドレス境界に調整するために、 -さらに NULL バイトが含まれる場合もある。 +The \fIname\fP field is present only when an event is returned for a file +inside a watched directory; it identifies the file pathname relative to the +watched directory. This pathname is null\-terminated, and may include +further null bytes (\(aq\e0\(aq) to align subsequent reads to a suitable +address boundary. \fIlen\fP フィールドは NULL バイトを含む \fIname\fP の全てのバイト数を表す。 よって、 \fIinotify_event\fP 構造体のサイズは @@ -279,6 +281,6 @@ inotify API では影響が受けるファイルをファイル名で特定す Linux カーネルソース内の \fIDocumentation/filesystems/inotify.txt\fP .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/man7/intro.7 b/release/man7/intro.7 index e4c56173..84a0d393 100644 --- a/release/man7/intro.7 +++ b/release/man7/intro.7 @@ -42,6 +42,6 @@ intro \- 概要、慣習やその他の説明 .SH 関連項目 \fBstandards\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/man7/iso_8859-1.7 b/release/man7/iso_8859-1.7 index 7f84edd2..bc1eefe0 100644 --- a/release/man7/iso_8859-1.7 +++ b/release/man7/iso_8859-1.7 @@ -177,6 +177,6 @@ _ .SH 関連項目 \fBascii\fP(7), \fBiso_8859\-15\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/man7/iso_8859-10.7 b/release/man7/iso_8859-10.7 index ccf33aed..9e972089 100644 --- a/release/man7/iso_8859-10.7 +++ b/release/man7/iso_8859-10.7 @@ -167,6 +167,6 @@ ISO 8859\-10 は Latin\-6 としても知られている。 .SH 関連項目 \fBascii\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/man7/iso_8859-11.7 b/release/man7/iso_8859-11.7 index 5c5c3030..021c5cf6 100644 --- a/release/man7/iso_8859-11.7 +++ b/release/man7/iso_8859-11.7 @@ -161,6 +161,6 @@ ISO 8859\-11 は TIS (タイ工業規格) 620\-2253 (一般には TIS\-620 と .SH 関連項目 \fBascii\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/man7/iso_8859-13.7 b/release/man7/iso_8859-13.7 index 9058f154..6eb13b69 100644 --- a/release/man7/iso_8859-13.7 +++ b/release/man7/iso_8859-13.7 @@ -166,6 +166,6 @@ ISO 8859\-13 は Latin\-7 としても知られている。 .SH 関連項目 \fBascii\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/man7/iso_8859-14.7 b/release/man7/iso_8859-14.7 index 5fed6003..e4db5a01 100644 --- a/release/man7/iso_8859-14.7 +++ b/release/man7/iso_8859-14.7 @@ -164,6 +164,6 @@ ISO 8859\-14 は Latin\-8 としても知られている。 .SH 関連項目 \fBascii\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/man7/iso_8859-15.7 b/release/man7/iso_8859-15.7 index e529d49c..2de7629e 100644 --- a/release/man7/iso_8859-15.7 +++ b/release/man7/iso_8859-15.7 @@ -175,6 +175,6 @@ _ .SH 関連項目 \fBascii\fP(7), \fBiso_8859\-1\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/man7/iso_8859-16.7 b/release/man7/iso_8859-16.7 index ef00c52f..a6ae7fe3 100644 --- a/release/man7/iso_8859-16.7 +++ b/release/man7/iso_8859-16.7 @@ -177,6 +177,6 @@ _ .UR http://bucovina.chem.tue.nl\:/fonturi\:/index\-en.html .UE . .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/man7/iso_8859-2.7 b/release/man7/iso_8859-2.7 index 395ab073..c49abb23 100644 --- a/release/man7/iso_8859-2.7 +++ b/release/man7/iso_8859-2.7 @@ -88,7 +88,7 @@ _ 252 170 AA Ş LATIN CAPITAL LETTER S WITH CEDILLA 253 171 AB Ť LATIN CAPITAL LETTER T WITH CARON 254 172 AC Ź LATIN CAPITAL LETTER Z WITH ACUTE -255 173 AD ­\[shc] SOFT HYPHEN +255 173 AD ­ SOFT HYPHEN 256 174 AE Ž LATIN CAPITAL LETTER Z WITH CARON 257 175 AF Ż LATIN CAPITAL LETTER Z WITH DOT ABOVE 260 176 B0 ° DEGREE SIGN @@ -179,6 +179,6 @@ _ .UR http://sizif.mf.uni\-lj.si\:/linux\:/cee\:/iso8859\-2.html .UE . .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/man7/iso_8859-3.7 b/release/man7/iso_8859-3.7 index 4b9e7b05..91f94441 100644 --- a/release/man7/iso_8859-3.7 +++ b/release/man7/iso_8859-3.7 @@ -160,6 +160,6 @@ ISO 8859\-3 は Latin\-3 としても知られている。 .SH 関連項目 \fBascii\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/man7/iso_8859-4.7 b/release/man7/iso_8859-4.7 index ba9a0246..3c723ced 100644 --- a/release/man7/iso_8859-4.7 +++ b/release/man7/iso_8859-4.7 @@ -162,6 +162,6 @@ _ .SH 関連項目 \fBascii\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/man7/iso_8859-5.7 b/release/man7/iso_8859-5.7 index b17efab5..83fb170a 100644 --- a/release/man7/iso_8859-5.7 +++ b/release/man7/iso_8859-5.7 @@ -166,6 +166,6 @@ T} .SH 関連項目 \fBascii\fP(7), \fBkoi8\-r\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/man7/iso_8859-6.7 b/release/man7/iso_8859-6.7 index 98fd14b0..817560ed 100644 --- a/release/man7/iso_8859-6.7 +++ b/release/man7/iso_8859-6.7 @@ -120,6 +120,6 @@ ISO 8859\-6 では、関連する多くの言語 (ウルドゥー語ヤペルシ .SH 関連項目 \fBascii\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/man7/iso_8859-7.7 b/release/man7/iso_8859-7.7 index 58b48c76..6dd069c3 100644 --- a/release/man7/iso_8859-7.7 +++ b/release/man7/iso_8859-7.7 @@ -169,6 +169,6 @@ ISO 8859\-7 は以前は ELOT\-928 や ECMA\-118:1986 とも呼ばれていた .SH 関連項目 \fBascii\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/man7/iso_8859-8.7 b/release/man7/iso_8859-8.7 index 37257b8f..cb223365 100644 --- a/release/man7/iso_8859-8.7 +++ b/release/man7/iso_8859-8.7 @@ -132,6 +132,6 @@ ISO 8859\-8 は ISO\-IR\-138 としても知られている。 .SH 関連項目 \fBascii\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/man7/iso_8859-9.7 b/release/man7/iso_8859-9.7 index 946c0254..86329779 100644 --- a/release/man7/iso_8859-9.7 +++ b/release/man7/iso_8859-9.7 @@ -163,6 +163,6 @@ _ .SH 関連項目 \fBascii\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/man7/koi8-r.7 b/release/man7/koi8-r.7 index 0e45ee51..c3a33bb2 100644 --- a/release/man7/koi8-r.7 +++ b/release/man7/koi8-r.7 @@ -202,6 +202,6 @@ RFC\ 1489, .UR http://koi8.pp.ru/ .UE .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/man7/koi8-u.7 b/release/man7/koi8-u.7 index 313e2462..5186dab0 100644 --- a/release/man7/koi8-u.7 +++ b/release/man7/koi8-u.7 @@ -190,6 +190,6 @@ A4, A6, A7, AD, B4, B6, B7, BD である。 .SH 関連項目 \fBascii\fP(7), \fBkoi8\-r\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/man7/libc.7 b/release/man7/libc.7 index b727b353..2943e916 100644 --- a/release/man7/libc.7 +++ b/release/man7/libc.7 @@ -83,6 +83,6 @@ Linux libc の活動の元々の動機とは裏腹に、glibc 2.0 がリリー .SH 関連項目 \fBsyscalls\fP(2), \fBfeature_test_macros\fP(7), \fBman\-pages\fP(7), \fBstandards\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/man7/locale.7 b/release/man7/locale.7 index 2b3c655b..1d015ad3 100644 --- a/release/man7/locale.7 +++ b/release/man7/locale.7 @@ -154,6 +154,6 @@ GNU gettext 関数ファミリーは LI18NUX2000 で規定されている。 \fBngettext\fP(3), \fBnl_langinfo\fP(3), \fBrpmatch\fP(3), \fBsetlocale\fP(3), \fBstrcoll\fP(3), \fBstrfmon\fP(3), \fBstrftime\fP(3), \fBstrxfrm\fP(3) .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/man7/mailaddr.7 b/release/man7/mailaddr.7 index d0201aca..1b2776d6 100644 --- a/release/man7/mailaddr.7 +++ b/release/man7/mailaddr.7 @@ -100,6 +100,6 @@ mailaddr \- メール・アドレスの説明 RFC\ 2822 (Internet Message Format) .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/man7/man-pages.7 b/release/man7/man-pages.7 index f1e4ed7a..c7cb9b67 100644 --- a/release/man7/man-pages.7 +++ b/release/man7/man-pages.7 @@ -32,19 +32,17 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH MAN\-PAGES 7 2013\-02\-24 Linux "Linux Programmer's Manual" +.TH MAN\-PAGES 7 2013\-06\-21 Linux "Linux Programmer's Manual" .SH 名前 man\-pages \- Linux の man ページを書く際の決まり事 .SH 書式 \fBman\fP [\fIsection\fP] \fItitle\fP .SH 説明 -This page describes the conventions that should be employed when writing man -pages for the Linux \fIman\-pages\fP project, which documents the user\-space API -provided by the Linux kernel and the GNU C library. The project thus -provides most of the pages in Section 2, as well as many of the pages that -appear in Sections 3, 4, 5, and 7 of the man pages on a Linux system. The -conventions described on this page may also be useful for authors writing -man pages for other projects. +このページでは、 Linux \fIman\-pages\fP プロジェクトのマニュアルページを書く際に 従うべき決まり事について説明する。 Linux +\fIman\-pages\fP プロジェクトは Linux カーネルおよび GNU C ライブラリが提供するユーザ空間 API +のドキュメント作成を行っている。Linux システムのマニュアルページのセクション 2 のページのほとんどと、セクション 3, 4, 5, 7 +の多くのページが、このプロジェクトにより提供されている。このページで説明されている決まり事は、他のプロジェクトの +マニュアルページを書く作者にも役立つことだろう。 .SS マニュアルページのセクション .PP マニュアルのセクションは、習慣的に以下のような定義が用いられている: @@ -142,22 +140,23 @@ Programmer's Manual\fP を使うこと)。 .\" SECURITY, .\" AUTHORS sections are discouraged .\" AUTHORS [Discouraged] -\fB名前\fP -\fB書式\fP -設定 [通常はセクション 4 のみ] -\fB説明\fP -オプション [通常はセクション 1, 8 のみ] -終了ステータス [通常はセクション 1, 8 のみ] -返り値 [通常はセクション 2, 3 のみ] -エラー [たいていはセクション 2, 3 のみ] -環境変数 -ファイル -バージョン [通常はセクション 2, 3 のみ] -準拠 -注意/備考 -バグ -例 -\fB関連項目\fP +\fBNAME\fP +\fBSYNOPSIS\fP +CONFIGURATION [Normally only in Section 4] +\fBDESCRIPTION\fP +OPTIONS [Normally only in Sections 1, 8] +EXIT STATUS [Normally only in Sections 1, 8] +RETURN VALUE [Normally only in Sections 2, 3] +ERRORS [Typically only in Sections 2, 3] +ENVIRONMENT +FILES +ATTRIBUTES [Normally only in Sections 2, 3] +VERSIONS [Normally only in Sections 2, 3] +CONFORMING TO +NOTES +BUGS +EXAMPLE +\fBSEE ALSO\fP .fi .in @@ -169,11 +168,8 @@ Programmer's Manual\fP を使うこと)。 以下のリストでは、上記のセクションのそれぞれの内容について 詳しく説明する。 .TP 14 \fB名前 (NAME)\fP -The name of this manual page. See \fBman\fP(7) for important details of the -line(s) that should follow the \fB.SH NAME\fP command. All words in this line -(including the word immediately following the "\e\-") should be in lowercase, -except where English or technical terminological convention dictates -otherwise. +マニュアルページの名前。 \fB.SH NAME\fP コマンドの後に続ける行の重要な情報については \fBman\fP(7) を参照。この行のすべての単語は +("\e\-" の直後の単語も含め) 小文字にすべきである。但し、英語や技術用語の慣例として別の記載をする場合はこの限りではない。 .TP \fB書式 (SYNOPSIS)\fP コマンドや関数のインターフェースを簡潔に記述する。 コマンドに対しては、コマンドや引き数 (オプション) の文法を書く。 @@ -252,6 +248,26 @@ otherwise. 多くのプログラムではデフォルトのインストール先は \fI/usr/local\fP である。したがってベースとなるマニュアルページでも \fI/usr/local\fP が使われていることが多いだろう。 .TP +\fBATTRIBUTES\fP +A summary of various attributes of the function(s) documented on this page, +broken into subsections. The following subsections are defined: +.sp +.RS +.TP +\fBMultithreading (see pthreads(7))\fP +This subsection notes attributes relating to multithreaded applications: +.RS +.IP * 3 +Whether the function is thread\-safe. +.IP * +Whether the function is a cancellation point. +.IP * +Whether the function is async\-cancel\-safe. +.RE +.IP +Details of these attributes can be found in \fBpthreads\fP(7). +.RE +.TP \fBバージョン (VERSIONS)\fP システムコールやライブラリ関数が登場したり、動作の重要な変更が行われた、 Linux カーネルや glibc のバージョンについての簡潔な概要。 一般に、全ての新しいインターフェイスは、マニュアルページに 「バージョン」の節を設けるべきである。 @@ -294,11 +310,8 @@ otherwise. 関連するマニュアルページを、コンマ区切りのリストで、 セクション番号順に、セクション内ではアルファベット順で記載する。 可能なら関連する他の文書も書く。 慣習では、このセクションは最後に置く。 リストの末尾にピリオドを置かないこと。 .IP -Where the SEE ALSO list contains many long manual page names, to improve the -visual result of the output, it may be useful to employ the \fI.ad l\fP (don't -right justify) and \fI.nh\fP (don't hyphenate) directives. Hyphenation of -individual page names can be prevented by preceding words with the string -"\e%". +関連項目のリストに長いマニュアルページ名が多く含まれる場合には、出力を見やすくするために \fI.ad l\fP (右揃えをしない) や \fI.nh\fP +(ハイフンによる折り返しをしない) を活用するとよい。個々のページ名のハイフンによる折り返しは、単語の前に "\e%" を付けることで防ぐことができる。 .SS フォントの慣習 .PP 関数に対しては、引き数には常にイタリック体を用いる。 「たとえ書式 (SYNOPSIS) セクションであっても、このルールに従う」 @@ -352,11 +365,9 @@ man 7 man\-pages (相互参照にセクション番号を含めておくと、 \fBman2html\fP といったツールがページ間のハイパーリンクを適切に生成できる。) .SS "綴り (spelling)" リリース 2.59 からだが、 \fIman\-pages\fP はアメリカ英語の綴りの慣習に従っている。 新しいページやパッチは全てこの慣習に従って下さい。 -.SS Capitalization -In subsection ("SS") headings capitalize the first word in heading, but -otherwise use lower case, except where English usage (e.g., proper nouns) or -programming language requirements (e.g., identifier names) dictate -otherwise. +.SS 大文字表記 +サブセクション ("SS") 見出しでは、最初の単語だけ先頭文字を大文字にし、残りの単語は小文字にすること。但し、英語の用法 (例えば、固有名詞) +やプログラミング言語の要件 (例えば、識別子の名前) などで別の表記をする場合はこの限りではない。 .SS サンプルプログラムとシェルのセッション マニュアルページには、システムコールやライブラリ関数の使い方を示す サンプルプログラムを含めることができる。 その際には、以下の点に留意すべきである。 .TP 3 @@ -398,6 +409,6 @@ TAB 文字を使うのは避けること。) \fBman\fP(1), \fBman2html\fP(1), \fBgroff\fP(7), \fBgroff_man\fP(7), \fBman\fP(7), \fBmdoc\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/man7/man.7 b/release/man7/man.7 index 0a866647..d6154146 100644 --- a/release/man7/man.7 +++ b/release/man7/man.7 @@ -332,6 +332,6 @@ Sun のマクロである \fBTX\fP は定義されていない。 \fBwhatis\fP(1), \fBgroff_man\fP(7), \fBgroff_www\fP(7), \fBman\-pages\fP(7), \fBmdoc\fP(7), \fBmdoc.samples\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/man7/mdoc.7 b/release/man7/mdoc.7 index 7c9c8a0a..f242e601 100644 --- a/release/man7/mdoc.7 +++ b/release/man7/mdoc.7 @@ -402,6 +402,6 @@ UR マクロ (URI/URL ハイパーテキスト参照の開始), UE マクロ ( .Sh この文書について この man ページは Linux .Em man-pages -プロジェクトのリリース 3.51 の +プロジェクトのリリース 3.52 の 一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。 diff --git a/release/man7/mdoc.samples.7 b/release/man7/mdoc.samples.7 index f004a2a0..75733f52 100644 --- a/release/man7/mdoc.samples.7 +++ b/release/man7/mdoc.samples.7 @@ -2795,6 +2795,6 @@ nroff 使用時に、(最初のヘッダとフッタ以外の) 改ページ時 .Sh この文書について この man ページは Linux .Em man-pages -プロジェクトのリリース 3.51 の +プロジェクトのリリース 3.52 の 一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。 diff --git a/release/man7/numa.7 b/release/man7/numa.7 new file mode 100644 index 00000000..c5ad6692 --- /dev/null +++ b/release/man7/numa.7 @@ -0,0 +1,146 @@ +.\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk +.\" +.\" and Copyright 2003,2004 Andi Kleen, SuSE Labs. +.\" numa_maps material Copyright (c) 2005 Silicon Graphics Incorporated. +.\" Christoph Lameter, . +.\" +.\" %%%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. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH NUMA 7 2012\-08\-05 Linux "Linux Programmer's Manual" +.SH 名前 +numa \- 非対称型メモリアーキテクチャの概要 +.SH 説明 +非対称型メモリアクセス (Non\-Uniform Memory Access; NUMA) は、 +メモリが複数のメモリノードに分割されているマルチプロセッサシステム +のことである。メモリノードへのアクセス時間は、アクセス元の CPU と +アクセス先のノードの相対的な位置関係に依存する +(これに対し、対称型マルチプロセッサシステムでは、どの CPU から +どのメモリへのアクセス時間も同じである)。 +通常は、 NUMA システムの各 CPU にはローカルのメモリノードがあり、 +そのメモリノードには、他の CPU のローカルノードや全ての CPU で +共有されるバス上のメモリよりも早くアクセスすることができる。 +.SS "NUMA システムコール" +Linux カーネルには、次に示す NUMA 関連のシステムコールが実装されている: +\fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBmigrate_pages\fP(2), +\fBmove_pages\fP(2), \fBset_mempolicy\fP(2). +ただし、アプリケーションは通常は \fIlibnuma\fP が提供するインターフェース +を使用すべきである。下記の「ライブラリによるサポート」を参照。 +.SS "/proc/[number]/numa_maps (Linux 2.6.14 以降)" +.\" See also Changelog-2.6.14 +このファイルは、プロセスの NUMA メモリポリシーと割り当てに関する +情報を表示する。 + +各行に、そのプロセスが使用しているメモリ領域に関する情報が表示される。その他の情報 \(em +そのメモリ領域に適用されているメモリポリシーや、そのページがどのノード上に割り当てられているか、など \(em もあわせて表示される。 + +\fInuma_maps\fP は読み出し専用のファイルである。 \fI/proc//numa_maps\fP から読み出しが行われると、 +カーネルはそのプロセスの仮想アドレス空間をスキャンし、 メモリの使用状況を報告する。 +プロセスのメモリ領域の情報が 1 行に 1 領域で表示される。 + +各行の最初のフィールドはメモリ領域の開始アドレスを示す。 このフィールドは \fI/proc//maps\fP +ファイルの内容と対応している。 \fI/proc//maps\fP +には、メモリ領域の末尾のアドレスや、アクセス許可や共有といった他の情報も含まれる。 + +2 番目のフィールドは、 そのメモリ領域に現在適用されているメモリポリシーを示す。 適用されているポリシーは、 +必ずしもそのプロセスがこのメモリ領域に対して設定したポリシーとは限らない点に注意すること。 +特に、 +プロセスがその領域に対して「デフォルト」ポリシーを設定した場合、その領域に適用されるポリシーはプロセスのポリシーとなり、それが「デフォルト」ポリシーとなる場合もあればそうでない場合もある。 + +行の残りの部分には、そのメモリ領域に割り当てられたページに関する情報が入る。以下に詳細を示す。 +.TP +\fIN=\fP +\fI\fP に割り当てられているページ数。 \fI\fP には、 +そのプロセスが現在マッピングしているページだけが含まれる。 ページの移動やメモリの再利用により、 このメモリ領域に関連付けられているが、 +一時的にマッピングされていないページが存在する場合がある。 プロセスがそれらのページを参照しようとした後には、 これらのページは再び現れる可能性がある。 +メモリ領域が共有メモリやファイルマッピングの場合には、 そのメモリ領域内に別のページを他のプロセスがマッピングしている場合もある。 +.TP +\fIfile=\fP +そのメモリ領域に関連付けられているファイル。 ファイルがプライベート (非公開) でマッピングされている場合、 書き込みアクセスがあると、 +このメモリ領域に書き込み時コピー (Copy\-On\-Write) ページが生成されることがある。 これらのページは無名ページ (anonymous +page) として表示される。 +.TP +\fIheap\fP +ヒープに使用されているメモリ範囲。 +.TP +\fIstack\fP +スタックに使用されているメモリ範囲。 +.TP +\fIhuge\fP +ヒュージメモリの範囲。表示されるページ数は、 +通常の大きさのページではなく、ヒュージページの数である。 +.TP +\fIanon=\fP +メモリ範囲内の無名ページ (anonymous page) の数。 +.TP +\fIdirty=\fP +dirty (変更された) ページの数。 +.TP +\fImapped=\fP +マッピングされているページ数。 \fIdirty\fP および \fIanon\fP のページ数と異なる値の場合に表示される。 +.TP +\fImapmax=\fP +スキャン中に検出した mapcount (一つのページをマッピングしているプロセス数) の最大値。 この値は、 +そのメモリ領域でどの程度の共有が行われているかの指標として使うことができる。 +.TP +\fIswapcache=\fP +スワップデバイスに対応するエントリーが存在するページ数。 +.TP +\fIactive=\fP +アクティブリストに入っているページ数。 このフィールドが表示されるのは、 +値がこのメモリ領域のページ数と異なる場合だけである。このフィールドが表示されるということは、 このメモリ領域に、まもなくスワッパ (swapper) +によりこの領域から削除される可能性がある inactive なページが存在することを意味する。 +.TP +\fIwriteback=\fP +現在ディスクに書き出されているページ数。 +.SH 準拠 +NUMA インターフェースについて規定している標準はない。 +.SH 注意 +Linux の NUMA システムコールと \fI/proc\fP インターフェースは、カーネルが +設定オプション \fBCONFIG_NUMA\fP を有効にして作成されている場合のみ、利用 +可能である。 +.SS ライブラリによるサポート +システムコールの定義を得るには \fI\-lnuma\fP でリンクすること。 +\fIlibnuma\fP と必要なヘッダファイル \fI\fP は +\fInumactl\fP パッケージで提供されている。 + +ただし、アプリケーションはこれらのシステムコールを直接利用すべきでない。 +推奨される方法は、\fInumactl\fP パッケージの \fBnuma\fP(3) の関数群が提供する +高レベルインターフェースの利用である。 \fInumactl\fP パッケージは +.UR ftp://oss.sgi.com\:/www\:/projects\:/libnuma\:/download/ +.UE +で入手できる。 +このパッケージが収録されている Linux ディストリビューションもある。 +ディストリビューションによっては、開発用のライブラリとヘッダファイルは +別パッケージ \fInumactl\-devel\fP で提供されている。 +.SH 関連項目 +\fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBmove_pages\fP(2), \fBset_mempolicy\fP(2), +\fBnuma\fP(3), \fBcpuset\fP(7), \fBnumactl\fP(8) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。 diff --git a/release/man7/operator.7 b/release/man7/operator.7 index 3d7df842..39fc22e7 100644 --- a/release/man7/operator.7 +++ b/release/man7/operator.7 @@ -68,6 +68,6 @@ operator \- C 言語の演算子の優先順位と評価の順序 .fi .\" .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/man7/path_resolution.7 b/release/man7/path_resolution.7 index 5cafbbba..2dbc382c 100644 --- a/release/man7/path_resolution.7 +++ b/release/man7/path_resolution.7 @@ -142,6 +142,6 @@ Linux では、スーパーユーザ権限が複数のケーパビリティに .SH 関連項目 \fBreadlink\fP(2), \fBcapabilities\fP(7), \fBcredentials\fP(7), \fBsymlink\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/man7/posixoptions.7 b/release/man7/posixoptions.7 index b740b9b5..037005c1 100644 --- a/release/man7/posixoptions.7 +++ b/release/man7/posixoptions.7 @@ -724,6 +724,6 @@ POSIX トレーシング (tracing) が使用可能である。 以下の関数 .SH 関連項目 \fBsysconf\fP(3), \fBstandards\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/man7/standards.7 b/release/man7/standards.7 index 43b04efb..4f6433c5 100644 --- a/release/man7/standards.7 +++ b/release/man7/standards.7 @@ -194,6 +194,6 @@ POSIX.1\-2008 にも準拠していると考えてよい。 .SH 関連項目 \fBfeature_test_macros\fP(7), \fBlibc\fP(7), \fBposixoptions\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/man7/suffixes.7 b/release/man7/suffixes.7 index 9006afc7..35bf146b 100644 --- a/release/man7/suffixes.7 +++ b/release/man7/suffixes.7 @@ -281,6 +281,6 @@ Suffix File type .SH 関連項目 \fBfile\fP(1), \fBmake\fP(1) .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/man7/unicode.7 b/release/man7/unicode.7 index e0f3d890..5188b540 100644 --- a/release/man7/unicode.7 +++ b/release/man7/unicode.7 @@ -240,6 +240,6 @@ GUI アプリケーション (HTML ビューア・ワードプロセッサ) で .SH 関連項目 \fBsetlocale\fP(3), \fBcharsets\fP(7), \fButf\-8\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/man7/units.7 b/release/man7/units.7 index 2a3e660b..f8843f28 100644 --- a/release/man7/units.7 +++ b/release/man7/units.7 @@ -115,6 +115,6 @@ hda: 120064896 sectors (61473 MB) w/2048KiB Cache MB はメガバイトで、KiB はキビバイトである。 .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/man7/utf-8.7 b/release/man7/utf-8.7 index 3621bbc7..6728412b 100644 --- a/release/man7/utf-8.7 +++ b/release/man7/utf-8.7 @@ -204,6 +204,6 @@ ISO/IEC 10646\-1:2000, Unicode 3.1, RFC\ 3629, Plan 9. .SH 関連項目 \fBnl_langinfo\fP(3), \fBsetlocale\fP(3), \fBcharsets\fP(7), \fBunicode\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/man8/intro.8 b/release/man8/intro.8 index e0928965..8b523e45 100644 --- a/release/man8/intro.8 +++ b/release/man8/intro.8 @@ -44,6 +44,6 @@ intro \- 管理コマンドと特権コマンドの説明 .SS 著者と著作権 著者と著作権に関しては各マニュアルページのソースのヘッダを参照すること。 これらはページごとに異なる可能性があることに注意してほしい。 .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/man8/ld.so.8 b/release/man8/ld.so.8 index dd0172d8..fb60ad77 100644 --- a/release/man8/ld.so.8 +++ b/release/man8/ld.so.8 @@ -28,14 +28,11 @@ Linux のバイナリは、コンパイルの時に \fBld\fP(1) に対して \f バイナリを扱う。 このフォーマットは多くの人が最近何年も使っている。 それ以外の点では両方とも同じように動作し、 同じサポートファイルとプログラム \fBldd\fP(1), \fBldconfig\fP(8), \fI/etc/ld.so.conf\fP を使用する。 .LP -When resolving library dependencies, the dynamic linker first inspects each -dependency string to see if it contains a slash (this can occur if a library -pathname containing slashes was specified at link time). If a slash is -found, then the dependency string is interpreted as a (relative or absolute) -pathname, and the library is loaded using that pathname. +ライブラリの依存関係を解決する際、動的リンカは、最初に、依存関係の各文字列がスラッシュを含んでいるかをチェックする +(この状況になるのは、リンク時にスラッシュを含むライブラリのパス名が指定された場合である)。スラッシュが見つかった場合、その依存関係の文字列はパス名 +(相対パス、絶対パスのどちらも可) として解釈され、そのパス名を使ってそのライブラリはロードされる。 .LP -If a library dependency does not contain a slash, then it is searched for in -the following order: +ライブラリの依存関係にスラッシュが含まれない場合、以下の順序で検索される。 .IP o 3 (ELF のみ) バイナリの動的セクション属性 DT_RPATH が存在し、 DT_RUNPATH 属性が存在しない場合は、 DT_RPATH で指定されたディレクトリを使用する。 DT_RPATH の使用は推奨されない。 @@ -136,14 +133,11 @@ mmx, mtrr, pat, pbe, pge, pn, pse36, sep, ss, sse, sse2, tm set\-user\-ID/set\-group\-ID されたプログラムでは無視される。 .TP \fBLD_PRELOAD\fP -A list of additional, user\-specified, ELF shared libraries to be loaded -before all others. The items of the list can be separated by spaces or -colons. This can be used to selectively override functions in other shared -libraries. The libraries are searched for using the rules given under -DESCRIPTION. For set\-user\-ID/set\-group\-ID ELF binaries, preload pathnames -containing slashes are ignored, and libraries in the standard search -directories are loaded only if the set\-user\-ID permission bit is enabled on -the library file. +追加でユーザが指定する ELF +共有ライブラリのリスト。指定されたライブラリは、すべてのライブラリより前にロードされる。リストの区切りはスペースとコロンである。他の共有ライブラリにある関数を選択的に置き換えるために用いることができる。指定されたライブラリは「説明」の節で述べたルールを基いて検索される。 +set\-user\-ID/set\-group\-ID された ELF +バイナリでは、スラッシュを含んだパス名のライブラリは無視され、標準の検索ディレクトリのライブラリはそのライブラリファイルの set\-user\-ID +許可ビットが有効になっている場合のみロードされる。 .TP \fBLD_TRACE_LOADED_OBJECTS\fP (ELF のみ) 空文字列でない場合、 プログラムを普通に実行するのではなく、 \fBldd\fP(1) @@ -278,6 +272,6 @@ Linux 1.1.52 以降と libc5 以降で使用可能である。 .\" In the above, (libc5) stands for David Engel's ld.so/ld-linux.so. \fBldd\fP(1), \fBsln\fP(1), \fBgetauxval\fP(3), \fBrtld\-audit\fP(7), \fBldconfig\fP(8) .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/man8/ldconfig.8 b/release/man8/ldconfig.8 index 73d52be4..1f2cdc5c 100644 --- a/release/man8/ldconfig.8 +++ b/release/man8/ldconfig.8 @@ -101,6 +101,6 @@ C ライブラリを参考にする。 .SH 関連項目 \fBldd\fP(1), \fBld.so\fP(8) .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/man8/nscd.8 b/release/man8/nscd.8 index ee8a5903..54035f32 100644 --- a/release/man8/nscd.8 +++ b/release/man8/nscd.8 @@ -59,6 +59,6 @@ nscd は \fBpasswd\fP(5), \fBgroup\fP(5), \fBhosts\fP(5) データベースへ .\" was written by Thorsten Kukuk and Ulrich Drepper. \fBnscd.conf\fP(5), \fBnsswitch.conf\fP(5) .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/man8/sync.8 b/release/man8/sync.8 index ad0e2b28..a4bef09a 100644 --- a/release/man8/sync.8 +++ b/release/man8/sync.8 @@ -55,6 +55,6 @@ Linux では、 \fBsync\fP は (まだ書き込まれていない) ダーティ .SH 関連項目 \fBsync\fP(2), \fBhalt\fP(8), \fBreboot\fP(8), \fBupdate\fP(8) .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/man8/tzselect.8 b/release/man8/tzselect.8 index 7794711b..56e3c65a 100644 --- a/release/man8/tzselect.8 +++ b/release/man8/tzselect.8 @@ -41,6 +41,6 @@ Posix 互換の \fIawk\fP プログラム (デフォルトは \fBawk\fP)。 .\" @(#)tzselect.8 1.3 \fBtzfile\fP(5), \fBzdump\fP(8), \fBzic\fP(8) .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/man8/zdump.8 b/release/man8/zdump.8 index 6655a5cd..15fb6071 100644 --- a/release/man8/zdump.8 +++ b/release/man8/zdump.8 @@ -38,6 +38,6 @@ highest possible time value preceded by the time value one day before it. .\" @(#)zdump.8 7.3 \fBtzfile\fP(5), \fBzic\fP(8) .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/man8/zic.8 b/release/man8/zic.8 index 1ebd3052..28353ee8 100644 --- a/release/man8/zic.8 +++ b/release/man8/zic.8 @@ -262,6 +262,6 @@ Leap 1974 Dec 31 23:59:60 + S .\" @(#)zic.8 7.19 \fBtzfile\fP(5), \fBzdump\fP(8) .SH この文書について -この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部 +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man\-pages/ に書かれている。