man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

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
Committed
MT-Level
MT-Safe
Standard

See also

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