pthread_kill —
send a signal to a specified thread
POSIX Threads Library (libpthread, -lpthread)
#include <pthread.h>
#include <signal.h>
int
pthread_kill(pthread_t
thread, int
sig);
The pthread_kill() function sends a signal, specified by
sig, to a thread, specified by
thread. The signal will be handled in the context of
thread, but the signal action may alter the process as a
whole. If sig is 0, error checking is performed, but no
signal is actually sent.
If successful, pthread_kill() returns 0. Otherwise, an
error number is returned.
pthread_kill() shall fail if:
- [
EINVAL]
- sig is an invalid or unsupported signal number.
- [
ESRCH]
- thread is an invalid thread ID.
The function conforms to IEEE Std 1003.1-2001
(“POSIX.1”).