pthread_kill(3)pthread_kill(3)NAMEpthread_kill - Delivers a signal to a specified thread. (This routine
is available only on a UNIX system.)
SYNOPSIS
#include <pthread.h> #include <signal.h>
int pthread_kill(
pthread_t thread,
int sig );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
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.
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
indicating 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
SEE ALSO
Manuals: Guide to DECthreads and Programmer's Guide
pthread_kill(3)
