PTHREAD_KILL(3C) Standard C Library Functions PTHREAD_KILL(3C)
NAME
pthread_kill - send a signal to a thread
SYNOPSIS
cc -mt [
flag... ]
file... -lpthread [
library... ]
#include <signal.h>
#include <pthread.h>
int pthread_kill(
pthread_t thread,
int sig);
DESCRIPTION
The
pthread_kill() function sends the
sig signal to the thread
designated by thread. The
thread argument must be a member of the
same process as the calling thread. The
sig argument must be one of
the signals listed in
signal.h(3HEAD), with the exception of
SIGCANCEL being reserved and off limits to
pthread_kill(). If
sig is
0, a validity check is performed for the existence of the target
thread; no signal is sent.
RETURN VALUES
Upon successful completion, the function returns a value of
0.
Otherwise the function returns an error number. If the
pthread_kill() function fails, no signal is sent.
ERRORS
The
pthread_kill() function will fail if:
ESRCH No thread could be found corresponding to that specified by
the given thread
ID. EINVAL The value of the
sig argument is an invalid or unsupported
signal number.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
kill(1),
pthread_self(3C),
pthread_sigmask(3C),
raise(3C),
attributes(7),
standards(7) March 23, 2005 PTHREAD_KILL(3C)
