Query: pthread_kill
OS: osf1
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
pthread_kill(3) Library Functions Manual pthread_kill(3)NAMEpthread_kill - Delivers a signal to a specified thread. (This routine is available only on a UNIX system.)LIBRARYDECthreads POSIX 1003.1c Library (libpthread.so)SYNOPSIS#include <pthread.h> #include <signal.h> int pthread_kill( pthread_t thread, int sig);STANDARDSInterfaces documented on this reference page conform to industry standards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program InterfacePARAMETERSThread to receive a signal request. A signal request.DESCRIPTIONThis 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 VALUESIf 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.ERRORSNoneRELATED INFORMATIONManuals: Guide to DECthreads and Programmer's Guide delim off pthread_kill(3)