pthread_kill(PTHREAD)

pthread_kill -- send a signal to a sibling thread

Synopsis

   cc [options] -Kthread file
   
   #include <signal.h>
   

   int pthread_kill(pthread_t *thread, int (*sig);

Description

pthread_kill sends the signal sig to the sibling thread thread. If thread is blocking signal sig, the signal will become pending for thread. pthread_kill is the thread analog of kill(S).

The thread parameter is the thread ID of the sibling thread which is to receive the signal. A thread cannot send a signal to a thread in another process (a non-sibling thread).

sig is the signal number of the signal to be sent and is either 0 or a value from the list given in signal(M). If sig is 0 (the null signal), error checking is performed but no signal is actually sent; this can be used to check the validity of thread.

To maintain integrity of the Threads Library implementation, threads cannot send SIGLWP or SIGWAITING.

Return values

pthread_kill returns zero on success. Otherwise, an error number is returned and no signal is sent.

Diagnostics

pthread_kill returns the following value if the corresponding condition is detected:

EINVAL: sig is not a valid signal number or is either SIGLWP or SIGWAITING.
ESRCH: thread cannot be found in the current process.

Standards Compliance

The Single UNIX Specification, Version 2; The Open Group.

References

Intro(PTHREAD), kill(S), pthread_self(PTHREAD), pthread_sigmask(PTHREAD), signal(M), sigwait(S)