thr_kill(THREAD)
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(S).
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(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 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(THREAD),
kill(S),
signal(M),
sigwait(S),
thr_sigsetmask(THREAD)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 01 June 2005