diff options
Diffstat (limited to 'newlib/libc/signal/signal.c')
| -rw-r--r-- | newlib/libc/signal/signal.c | 32 |
1 files changed, 6 insertions, 26 deletions
diff --git a/newlib/libc/signal/signal.c b/newlib/libc/signal/signal.c index 20e919e74..bfb85e66a 100644 --- a/newlib/libc/signal/signal.c +++ b/newlib/libc/signal/signal.c @@ -6,21 +6,12 @@ INDEX signal INDEX _signal_r -INDEX - raise -INDEX - _raise_r ANSI_SYNOPSIS #include <signal.h> - void ( * signal(int <[sig]>, void(*<[func]>)(int)) )(int); - - void ( * _signal_r(void *<[reent]>, - int <[sig]>, void(*<[func]>)(int)) )(int); + void (*signal(int <[sig]>, void(*<[func]>)(int))) (int); - int raise (int <[sig]>); - - int _raise_r (void *<[reent]>, int <[sig]>); + void (*_signal_r(void *<[reent]>, int <[sig]>, void(*<[func]>)(int))) (int); TRAD_SYNOPSIS #include <signal.h> @@ -33,15 +24,8 @@ TRAD_SYNOPSIS int <[sig]>; char ( * <[func]> )(); - int raise (<[sig]>)() - int <[sig]>; - - int _raise_r (<[reent]>, <[sig]>)() - char *<[reent]>; - int <[sig]>; - DESCRIPTION -<<signal, raise>> provide a simple signal/raise implementation for embedded +<<signal>> provides a simple signal-handling implementation for embedded targets. <<signal>> allows you to request changed treatment for a particular @@ -52,7 +36,7 @@ that identifies a subroutine in your program as the handler for this signal. Some of the execution environment for signal handlers is unpredictable; notably, the only library function required to work -correctly from within a signal handler is @code{signal} itself, and +correctly from within a signal handler is <<signal>> itself, and only when used to redefine the handler for the current signal value. Static storage is likewise unreliable for signal handlers, with one @@ -66,13 +50,9 @@ where it was when the signal was raised (whether by your program itself, or by an external event). Signal handlers can also use functions such as <<exit>> and <<abort>> to avoid returning. -<<raise>> sends the signal sig to the executing program. It returns zero if -successful, non-zero if unsuccessful. - -The alternate functions <<_signal_r, _raise_r>> are the reentrant versions. +The alternate function <<_signal_r>> is the reentrant version. The extra argument <[reent]> is a pointer to a reentrancy structure. - @c FIXME: do we have setjmp.h and assoc fns? RETURNS @@ -83,7 +63,7 @@ Otherwise, the result is the previous handler (a function pointer or one of the predefined macros). PORTABILITY -ANSI C requires <<raise>>, <<signal>>. +ANSI C requires <<signal>>. No supporting OS subroutines are required to link with <<signal>>, but it will not have any useful effects, except for software generated signals, |