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(7) 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(7),
standards(7)

March 23, 2005 RAISE(3C)