[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_kill()

Send a signal to a thread

Synopsis:

#include <signal.h>

int pthread_kill( pthread_t thread,
                  int sig );

Arguments:

thread
The ID of the thread that you want to send the signal to, which you can get when you call pthread_create() or pthread_self().
sig
The signal that you want to send, or 0 if you just want to check for errors.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_kill() function sends the signal sig to the thread thread. The target thread and calling thread must be in the same process. If sig is zero, error checking is performed but no signal is sent.

Returns:

EOK
Success.
EAGAIN
Insufficient system resources are available to deliver the signal.
ESRCH
Invalid thread ID thread.
EINVAL
Invalid signal number sig.

Classification:

POSIX 1003.1 THR

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

kill(), ThreadDestroy()


[Previous] [Contents] [Index] [Next]