THR_KILL(3C)THR_KILL(3C)NAMEthr_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 desig‐
nated by thread ID.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌───────────────┬───────────────────┐
│ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├───────────────┼───────────────────┤
│MT-Level │ Async-Signal-Safe │
└───────────────┴───────────────────┘
SEE ALSOkill(2), sigaction(2), raise(3C), signal.h(3HEAD), thr_self(3C),
attributes(5), standards(5)
Mar 23, 2005 THR_KILL(3C)