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)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004