.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH PTHREAD_KILL 3 2012\-08\-19 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 2012 Akihiro MOTOKI
+.\" all rights reserved.
+.\" Translated 2012-05-04, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH PTHREAD_KILL 3 2014\-05\-13 Linux "Linux Programmer's Manual"
.SH 名前
pthread_kill \- スレッドにシグナルを送信する
.SH 書式
.fi
.sp
\fI\-pthread\fP を付けてコンパイルとリンクを行う。
+.sp
+.in -4n
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
+.in
+.sp
+.ad l
+\fBpthread_kill\fP():
+.RS 4
+_POSIX_C_SOURCE\ >=\ 199506L || _XOPEN_SOURCE\ >=\ 500
+.RE
+.ad b
.SH 説明
\fBpthread_kill\fP() 関数は、呼び出したスレッドと同じプロセスの
スレッド \fIthread\fP にシグナル \fIsig\fP を送信する。
シグナルは非同期に \fIthread\fP へ直接送られる。
-\fIsig\fP が 0 の場合、シグナルは送信されないが、
-エラーチェックだけは実行される。
-これを使うと、スレッド ID が存在するかの確認を行うことができる。
+\fIsig\fP が 0 の場合、シグナルは送信されないが、エラーチェックだけは実行される。
.SH 返り値
成功すると、 \fBpthread_kill\fP() は 0 を返す。
エラーの場合、エラー番号を返し、シグナルの送信は行わない。
.TP
\fBEINVAL\fP
無効なシグナルが指定された。
-.TP
-\fBESRCH\fP
-ID が \fIthread\fP のスレッドが見つからなかった。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBpthread_kill\fP() 関数はスレッドセーフである。
.SH 準拠
-POSIX.1\-2001.
+POSIX.1\-2008.
.SH 注意
シグナルの配送はプロセス全体で行われる。
シグナルハンドラが設定されている場合、
そのハンドラがスレッド \fIthread\fP で起動されるが、
シグナルの配送が "stop", "continue", "terminate" のいずれかの場合、
シグナルに対するアクションはプロセス全体に影響がある。
+
+POSIX.1\-2008 では、 スレッドが終了した後にそのスレッド ID が使用されたことを検出した場合に、 \fBpthread_kill\fP()
+はエラー \fBESRCH\fP を返すことを推奨されている。 glibc の実装では、無効なスレッド ID を検出できる場合にはこのエラーを返す。 しかし、
+POSIX では、 終了したスレッド ID を使おうとした場合の動作は不定であり、 \fBpthread_kill\fP() で無効なスレッド ID
+を使おうとした場合には、 例えば、 セグメンテーションフォールトになる可能性もある点に注意すること。
.SH 関連項目
\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.67 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
