PTHREAD_KILL(3C) Standard C Library Functions PTHREAD_KILL(3C)
pthread_kill - send a signal to a thread
cc -mt [ flag... ] file... -lpthread [ library... ]
#include <signal.h>
#include <pthread.h>
int pthread_kill(pthread_t thread, int sig);
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.
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.
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.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
kill(1), pthread_self(3C), pthread_sigmask(3C), raise(3C),
attributes(7), standards(7)
March 23, 2005 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)