THR_KILL(3C) Standard C Library Functions THR_KILL(3C)

thr_kill - send a signal to a thread

cc -mt [ flag... ] file... [ library... ]
#include <signal.h>
#include <thread.h>
int thr_kill(thread_t thread, int sig);

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.

Upon successful completion, thr_kill() returns 0. Otherwise, an error number is returned. In the event of failure, no signal is sent.

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.

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level Async-Signal-Safe

kill(2), sigaction(2), raise(3C), thr_self(3C), signal.h(3HEAD), attributes(7), standards(7)

March 23, 2005 OmniOS