huschi.net

PTHREAD_KILL(3)            Linux Programmer's Manual           PTHREAD_KILL(3)

NAME
       pthread_kill - send a signal to a thread
SYNOPSIS
       #include <signal.h>
       int pthread_kill(pthread_t thread, int sig);
       Compile and link with -pthread.
DESCRIPTION
       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 per-
       formed; this can be used to check for the existence of a thread ID.
RETURN VALUE
       On success, pthread_kill() returns 0; on error,  it  returns  an  error
       number, and no signal is sent.
ERRORS
       EINVAL An invalid signal was specified.
       ESRCH  No thread with the ID thread could be found.
CONFORMING TO
       POSIX.1-2001.
NOTES
       Signal dispositions are process-wide: if a signal handler is installed,
       the handler will be invoked in the thread thread, but if  the  disposi-
       tion  of  the signal is "stop", "continue", or "terminate", this action
       will affect the whole process.
SEE ALSO
       kill(2),  sigaction(2),  sigpending(2),  pthread_self(3),  pthread_sig-
       mask(3), raise(3), pthreads(7), signal(7)
COLOPHON
       This  page  is  part of release 3.53 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/.

Linux                             2012-08-19                   PTHREAD_KILL(3)