PTHREAD_KILL(3) Linux Programmer's Manual PTHREAD_KILL(3)
pthread_kill - send a signal to a thread
int pthread_kill(pthread_t thread, int sig);
Compile and link with -pthread.
The pthread_kill() function sends the signal sig to thread, a thread in the same process
as the caller. The signal is asynchronously directed to thread.
If sig is 0, then no signal is sent, but error checking is still performed; this can be
used to check for the existence of a thread ID.
On success, pthread_kill() returns 0; on error, it returns an error number, and no signal
EINVAL An invalid signal was specified.
ESRCH No thread with the ID thread could be found.
Signal dispositions are process-wide: if a signal handler is installed, the handler will
be invoked in the thread thread, but if the disposition of the signal is "stop", "con-
tinue", or "terminate", this action will affect the whole process.
kill(2), sigaction(2), sigpending(2), pthread_self(3), pthread_sigmask(3), raise(3),
This page is part of release 3.55 of the Linux man-pages project. A description of the
project, and information about reporting bugs, can be found at
Linux 2012-08-19 PTHREAD_KILL(3)