pthread_kill(3) 					     Library Functions Manual						   pthread_kill(3)

NAME

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

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

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

       int   pthread_kill(
			   pthread_t   thread,
			   int	       sig);

STANDARDS

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

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

PARAMETERS

       Thread to receive a signal request.  A signal request.

DESCRIPTION

       This  routine sends a signal to the specified target thread thread.  Any signal defined to stop, continue, or terminate will stop or termi-
       nate 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

       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

       None

RELATED INFORMATION

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																   pthread_kill(3)