THR_KILL(3C) Standard C Library Functions THR_KILL(3C)
NAME
thr_kill - send a signal to a thread
SYNOPSIS
cc -mt [
flag... ]
file... [
library... ]
#include <signal.h>
#include <thread.h>
int thr_kill(
thread_t thread,
int sig);
DESCRIPTION
The
thr_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
thr_kill(). If
sig is
0, a validity check
is done for the existence of the target thread; no signal is sent.
RETURN VALUES
Upon successful completion,
thr_kill() returns
0. Otherwise, an
error number is returned. In the event of failure, no signal is sent.
ERRORS
The
thr_kill() function will fail if:
EINVAL The
sig argument value is not zero and is an invalid or an
unsupported signal number.
ESRCH No thread was found that corresponded to the thread
designated by
thread ID.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------+
|MT-Level | Async-Signal-Safe |
+---------------+-------------------+
SEE ALSO
kill(2),
sigaction(2),
raise(3C),
thr_self(3C),
signal.h(3HEAD),
attributes(7),
standards(7) March 23, 2005 THR_KILL(3C)
