*** UNIX MANUAL PAGE BROWSER ***

pthread_kill(3) Library Functions Manual pthread_kill(3) NAME pthread_kill - Delivers a signal to a specified thread. (This routine is for DIGITAL UNIX systems only.) LIBRARY DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS #include <pthread.h> int pthread_kill( pthread_t thread, int sig); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program Interface PARAMETERS Thread to receive a signal request. A signal request. If sig is zero, error checking is performed, but no signal is sent. DESCRIPTION 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 If an error condition occurs, this routine returns an integer value in- dicating the type of error. Possible return values are as follows: Successful completion. The value of sig is invalid or unsupported sig- nal 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)