名称
pthread_kill() ― スレッドへのシグナル送信
構文
#include <signal.h>
int pthread_kill(
pthread_t thread,
int sig
);
パラメータ
| thread | | シグナルが送信されるスレッド。 |
| sig | | thread に送信されるシグナル。 |
説明
pthread_kill() 関数は、シグナルを thread に送信するように要求します。 シグナルは、呼び出しプロセス中の thread へ非同期に送られます。 シグナルは、指定スレッドのコンテキストで扱われます。
たとえばシグナルの動作が終了または停止の場合、この動作はプロセス全体に適用されます。
sig が 0 である場合、エラーのチェックは行なわれますが、シグナルは送られません。
戻り値
正常終了すると pthread_kill() は 0 を返します。
それ以外の場合、エラーの内容を表すエラー番号を返します (errno 変数は使用しません)。
エラー
以下の現象が発生した場合、 pthread_kill() 関数は、該当するエラー番号を返します。
| [EINVAL] | | sig が、無効またはサポートされていないシグナル番号の場合。 |
| [ESRCH] | | thread に対応するスレッドが見つからない場合。 |
著者
pthread_kill() は、IEEE POSIX P1003.1c 標準から派生しました。
標準準拠
pthread_kill(): POSIX 1003.1c.