PTHREAD_KILL(3C) Standard C Library Functions PTHREAD_KILL(3C)


NAME


pthread_kill - send a signal to a thread

SYNOPSIS


cc -mt [ flag... ] file... -lpthread [ library... ]
#include <signal.h>
#include <pthread.h>

int pthread_kill(pthread_t thread, int sig);


DESCRIPTION


The pthread_kill() function sends the sig signal to the thread designated
by thread. The thread argument must be a member of the same process as
the calling thread. The sig argument must be one of the signals listed
in signal.h(3HEAD), with the exception of SIGCANCEL being reserved and
off limits to pthread_kill(). If sig is 0, a validity check is performed
for the existence of the target thread; no signal is sent.

RETURN VALUES


Upon successful completion, the function returns a value of 0. Otherwise
the function returns an error number. If the pthread_kill() function
fails, no signal is sent.

ERRORS


The pthread_kill() function will fail if:

ESRCH
No thread could be found corresponding to that specified by the
given thread ID.


EINVAL
The value of the sig argument is an invalid or unsupported
signal number.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


kill(1), pthread_self(3C), pthread_sigmask(3C), raise(3C), attributes(7),
standards(7)


illumos March 23, 2005 PTHREAD_KILL(3C)