NAME    [Toc]    [Back]

       pthread_kill  -  Delivers  a signal to a specified thread.
       (This routine is available only on a UNIX system.)

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h> #include <signal.h>

       int pthread_kill(
               pthread_t thread,
               int sig );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       Thread to receive a signal request.  A signal request.

DESCRIPTION    [Toc]    [Back]

       This routine sends a signal to the specified target thread
       thread. Any signal defined to stop, continue, or terminate
       will stop or terminate the process, even though it can  be
       handled by the thread. For example, SIGTERM terminates all
       threads in the process, even though it can be  handled  by
       the target thread.

       Specifying  a sig argument of zero (0) causes this routine
       to validate the thread argument but  not  to  deliver  any
       signal.

       The  name  of  the "kill" routine is sometimes misleading,
       because many signals do not terminate a thread.

       The various signals are as follows: SIGHUP, SIGPIPE, SIGTTIN
  SIGINT, SIGALRM, SIGTTOU SIGQUIT, SIGTERM, SIGIO SIGTRAP,
 SIGUSR1, SIGXCPU SIGABRT,  SIGSYS,  SIGXFSZ  SIGEMT,
       SIGURG,  SIGVTALRM SIGFPE, SIGSTOP, SIGPROF SIGKILL, SIGTSTP,
 SIGINFO SIGBUS, SIGCONT,  SIGUSR1  SIGSEGV,  SIGCHLD,
       SIGUSR2

       If  this  routine does not execute successfully, no signal
       is sent.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return values are as follows: Successful completion.   The
       value  of sig is invalid or unsupported signal value.  The
       value of thread does not specify an existing thread.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Manuals: Guide to DECthreads and Programmer's Guide



                                                  pthread_kill(3)