NAME    [Toc]    [Back]

     pthread_kill -- send a signal to a specified thread

LIBRARY    [Toc]    [Back]

     Reentrant C Library (libc_r, -lc_r)

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]

     The pthread_kill() function 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]

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


FreeBSD 5.2.1			April 27, 2000			 FreeBSD 5.2.1