Manual Pages for UNIX Operating System command usage for man pthread_kill

Standard C Library Functions                     pthread_kill(3C)



NAME
     pthread_kill - send a signal to a thread

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

     int pthread_kill(pthread_t thread, int sig);


DESCRIPTION
     The pthread_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 pthread_kill().  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
     pthread_kill() function fails, no signal is sent.

ERRORS
     The  pthread_kill() 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.


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















SunOS 5.11          Last change: 23 Mar 2005                    1






Standard C Library Functions                     pthread_kill(3C)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     kill(1), pthread_self(3C),  pthread_sigmask(3C),  raise(3C),
     attributes(5), standards(5)









































SunOS 5.11          Last change: 23 Mar 2005                    2