Standard C Library Functions                     pthreadkill(3C)



NAME
     pthreadkill - send a signal to a thread

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

     int pthreadkill(pthreadt thread, int sig);


DESCRIPTION
     The pthreadkill() 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 pthreadkill().  If sig is 0, a
     validity check is performed for the existence of the  target
     thread; no signal is sent.

RETURN VALUES
     Upon successful completion, the function returns a value  of
     0.  Otherwise  the  function returns an error number. If the
     pthreadkill() function fails, no signal is sent.

ERORS
     The  pthreadkill() function will fail if:

     ESRCH     No thread could be  found  corresponding  to  that
               specified by the given thread  ID.


     EINVAL    The value of the sig argument  is  an  invalid  or
               unsupported signal number.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:















SunOS 5.11          Last change: 23 Mar 2005                    1






Standard C Library Functions                     pthreadkill(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     kill(1), pthreadself(3C),  pthreadsigmask(3C),  raise(3C),
     attributes(5), standards(5)











































SunOS 5.11          Last change: 23 Mar 2005                    2