| PTHREAD_KILL(3C) | Standard C Library Functions | PTHREAD_KILL(3C) |
pthread_kill - send a signal to a thread
cc -mt [ flag... ] file... -lpthread [ library... ] #include <signal.h> #include <pthread.h> int pthread_kill(pthread_t thread, int sig);
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.
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.
The pthread_kill() function will fail if:
ESRCH
EINVAL
See attributes(7) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Interface Stability | Standard |
| MT-Level | MT-Safe |
kill(1), pthread_self(3C), pthread_sigmask(3C), raise(3C), attributes(7), standards(7)
| March 23, 2005 | OmniOS |