home | help
thr_kill(3C)							    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);

     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 sig-
     nal.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 num-
     ber 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  desig-
		     nated by thread ID.

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

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

     kill(2),  sigaction(2),  raise(3C),  signal.h(3HEAD), thr_self(3C), attrib-
     utes(5), standards(5)

				   23 Mar 2005			    thr_kill(3C)

home | help