PTHREAD_KILLSection: Linux Programmer's Manual (3)
Index Return to Main Contents
NAMEpthread_kill - send a signal to a thread
#include <signal.h> int pthread_kill(pthread_t thread, int sig);
DESCRIPTIONThe pthread_kill() function sends the signal sig to thread, another thread in the same process as the caller. The signal is asynchronously directed to thread.
RETURN VALUEOn success, pthread_kill() returns 0; on error, it returns an error number, and no signal is sent.
- No thread with the ID thread could be found.
- An invalid signal was specified.
NOTESSignal 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", "continue", or "terminate", this action will affect the whole process.
SEE ALSOkill(2) sigaction(2), sigpending(2), pthread_self(3), pthread_sigmask(3), raise(3), pthreads(7), signal(7)
COLOPHONThis page is part of release 3.21 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.