Manual Pages  — PTHREAD_KILL

pthread_kill – send a signal to a specified thread

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO STANDARDS

POSIX Threads Library (libpthread, -lpthread)

#include <pthread.h>

#include <signal.h>

int
pthread_kill(pthread_t thread, int sig);

The pthread_kill() function sends a signal, specified by sig, to a thread, specified by thread. If sig is 0, error checking is performed, but no signal is actually sent.

If successful, pthread_kill() returns 0. Otherwise, an error number is returned.

The pthread_kill() function will fail if:

[ESRCH]
	thread is an invalid thread ID.
[EINVAL]
	sig is an invalid or unsupported signal number.

The pthread_kill() function conforms to IEEE Std 1003.1-96 ("POSIX.1")