eff raise[send a signal]

Contents|Index|Previous|Next

raise
[send a signal]

SYNOPSIS 
#include <signal.h> 
int raise(int sig); 

int _raise_r(void *reent, int sig); 

DESCRIPTION
raise sends the signal sig (one of the macros from sys/signal.h). This interrupts your program’s normal flow of execution, and allows a signal handler (if you’ve defined one, using signal) to take control.

The alternate function, _raise_r, is a reentrant version. The extra argument, reent, is a pointer to a reentrancy structure.

RETURNS
The result is
0 if sig was successfully raised, 1 otherwise. However, the return value (since it depends on the normal flow of execution) may not be visible, unless the signal handler for sig terminates with a return or unless SIG_IGN is in effect for this signal.

COMPLIANCE
ANSI C requires
raise, but allows the full set of signal numbers to vary from one implementation to another.

Required OS subroutines: getpid, kill.

0