Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

pthread_kill-向线程发送信号

语法

#include <signal.h>

int pthread_kill(pthread_t thread, int sig);

编译并链接-pthread。

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

pthread_kill()：

_POSIX_C_SOURCE >>= 199506L || _XOPEN_SOURCE>= 500

说明

pthread_kill()函数将信号sig发送到线程，该线程与调用方的进程相同。该信号异步地定向到线程。

如果sig为0，则不发送信号，但仍执行错误检查。

返回值

成功时，pthread_kill()返回0；否则，返回0。如果出错，则返回错误号，并且不发送信号。

错误说明

EINVAL

指定了无效的信号。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008。

备注

信号的处理是整个过程的：如果安装了信号处理程序，则将在线程线程中调用该处理程序，但是如果信号的处理是"停止"，"继续"或"终止"，则此操作将影响整个过程。

pthread_kill()的glibc实现在尝试发送NPTL线程实现内部使用的任何实时信号时给出错误(EINVAL)。有关详细信息，请参见nptl(7)。

POSIX.1-2008建议，如果实现在其生存期结束后检测到线程ID的使用，则pthread_kill()应该返回错误ESRCH。在可以检测到无效线程ID的情况下，glibc实现返回此错误。但也请注意，POSIX表示尝试使用其生命周期已结束的线程ID会产生未定义的行为，并且尝试在调用pthread_kill()中使用无效的线程ID可能会导致分段错误。

另外参见

kill(2)，sigaction(2)，sigpending(2)，pthread_self(3)，pthread_sigmask(3)，raise(3)，pthreads(7)，signal(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。