thr_kill(3thread)

thr_kill -- send a signal to a sibling thread

Synopsis

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

   int thr_kill(thread_t tid, int sig)

Description

thr_kill sends the signal sig to the sibling thread tid.

If tid is blocking signal sig, the signal will become pending for tid.

thr_kill is the thread analog of kill(2).

Parameters

tid: thread ID of the thread to receive the signal
sig: signal number of the signal to be sent

tid parameter

tid 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 parameter

sig is the signal number of the signal to be sent and is either 0 or a value from the list given in signal(5).

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 tid.

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

Return values

thr_kill returns zero for success and an error number for failure.

Errors

If any of the following conditions occurs, thr_kill returns the corresponding value:

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

References

Intro(3thread), kill(2), signal(5), sigwait(2), thr_sigsetmask(3thread)