debian man page for pthread_kill

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 performed; 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 dispo-
       sition 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_sigmask(3), raise(3), pthreads(7), signal(7)

COLOPHON
       This  page is part of release 3.44 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)