RAISE(3C) Standard C Library Functions RAISE(3C)


NAME


raise - send a signal to the executing thread

SYNOPSIS


#include <signal.h>

int raise(int sig);


DESCRIPTION


The raise() function sends the signal sig to the executing thread. If a
signal handler is called, the raise function does not return until after
the signal handler returns.


The effect of the raise function is equivalent to calling:

pthread_kill(pthread_self(), sig);


See the pthread_kill(3C) manual page for a detailed list of failure
conditions and the signal.h(3HEAD) manual page for a list of signals.

RETURN VALUES


Upon successful completion, 0 is returned. Otherwise, -1 is returned and
errno is set to indicate the error.

ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


pthread_kill(3C), pthread_self(3C), signal.h(3HEAD), attributes(5),
standards(5)


March 23, 2005 RAISE(3C)