Manual Pages for UNIX Operating System command usage for man thr_kill

Standard C Library Functions                         thr_kill(3C)



NAME
     thr_kill - send a signal to a thread

SYNOPSIS
     cc -mt [ flag... ] file... [ library... ]
     #include 
     #include 

     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(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


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



SunOS 5.11          Last change: 23 Mar 2005                    1