NAME    [Toc]    [Back]

     pthread_kill - send a signal to a specified thread

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>
     #include <signal.h>

     int
     pthread_kill(pthread_t thread, int sig);

DESCRIPTION    [Toc]    [Back]

     The pthread_kill() function sends  a  signal,  specified  by
sig, to a
     thread, specified by thread.  If sig is 0, error checking is
performed,
     but no signal is actually sent.

RETURN VALUES    [Toc]    [Back]

     If successful, pthread_kill() returns 0.  Otherwise, an  error number is
     returned.

ERRORS    [Toc]    [Back]

     pthread_kill() will fail if:

     [ESRCH]       thread is an invalid thread ID.

     [EINVAL]       sig  is an invalid or unsupported signal number.

SEE ALSO    [Toc]    [Back]

     kill(2), pthread_self(3), raise(3)

STANDARDS    [Toc]    [Back]

     pthread_kill() conforms to ISO/IEC 9945-1:1996 (``POSIX'')

OpenBSD     3.6                          April      27,      2000