RAISE(3) NEWLIB RAISE(3)NAME
8.1 `raise'--send a signal
SYNOPSIS
#include <signal.h>
int raise(int SIG);
int _raise_r(void *REENT, int SIG);
DESCRIPTION
Send 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. How‐
ever, the return value (since it depends on the normal flow of execu‐
tion) may not be visible, unless the signal handler for SIG terminates
with a `return' or unless `SIG_IGN' is in effect for this signal.
PORTABILITY
ANSI C requires `raise', but allows the full set of signal numbers to
vary from one implementation to another.
Required OS subroutines: `getpid', `kill'.
SEE ALSOraise is part of the library. The full documentation for is maintained
as a Texinfo manual. If info and are properly installed at your site,
the command
info
will give you access to the complete manual.
NEWLIB April 2010 RAISE(3)