pthread_kill()

Send a signal to a thread

#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.

In order to send the signal, the calling process must have the PROCMGR_AID_SIGNAL ability enabled. For more information, see procmgr_ability() .

Returns:

EOK

Success.

EAGAIN

Insufficient system resources are available to deliver the signal.

EINVAL

Invalid signal number sig.

EPERM

The calling process doesn't have the required permission; see procmgr_ability() .

ESRCH

Invalid thread ID thread.

Classification:

POSIX 1003.1 THR