Manpage of RAISE
RAISE
Section: NEWLIB (3)
Updated: 2005 Feb 23
Index
Return to Main Contents
NAME
7.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.
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.
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 ALSO
raise
is part of the
libc
library.
The full documentation for
libc
is maintained as a Texinfo manual. If
info
and
libc
are properly installed at your site, the command
-
info libc
will give you access to the complete manual.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURNS
-
- PORTABILITY
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 21:25:29 GMT, May 16, 2005
www.fiveanddime.net