Content-type: text/html Man page of pthread_kill

pthread_kill

Section: Standard C Library Functions (3C)
Updated: 23 Mar 2005
Index Return to Main Contents
 

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(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-LevelMT-Safe

 

SEE ALSO

kill(1), pthread_self(3C), pthread_sigmask(3C), raise(3C), attributes(5), standards(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:21 GMT, October 02, 2010