pthread_kill()

send a signal to a thread 

Function


SYNOPSIS

#include <pthread.h>

int pthread_kill(pthread_t thread, int sig);


DESCRIPTION

The pthread_kill() function is used to request that a signal be delivered to the specified thread. As with kill(), if sig is zero, error checking is performed but no signal is actually sent.


PARAMETERS

thread 

Is the thread to which the signal is to be delivered.

sig 

Is the signal to deliver, or zero to check for existence of the specified thread.


RETURN VALUES

On success, pthread_kill() returns 0. On error, one of the following values is returned:

EINVAL 

sig does not specify a valid signal number.

ESRCH 

thread does not specify a currently running thread in the process.


CONFORMANCE

POSIX P1003.1 (1996)


MULTITHREAD SAFETY LEVEL

MT-safe.


PORTING ISSUES

None.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
kill(), pthread_create()


PTC MKS Toolkit 10.2 Documentation Build 28.