summaryrefslogtreecommitdiffstats
path: root/newlib/libc/signal/raise.c
diff options
context:
space:
mode:
authorChristopher Faylor <me@cgf.cx>2000-02-17 19:39:52 +0000
committerChristopher Faylor <me@cgf.cx>2000-02-17 19:39:52 +0000
commit8a0efa53e44919bcf5ccb1d3353618a82afdf8bc (patch)
tree68c3dbf3f2c6fd5d49777def9914d77b5cd4589d /newlib/libc/signal/raise.c
parent1fd5e000ace55b323124c7e556a7a864b972a5c4 (diff)
downloadcygnal-8a0efa53e44919bcf5ccb1d3353618a82afdf8bc.tar.gz
cygnal-8a0efa53e44919bcf5ccb1d3353618a82afdf8bc.tar.bz2
cygnal-8a0efa53e44919bcf5ccb1d3353618a82afdf8bc.zip
import newlib-2000-02-17 snapshot
Diffstat (limited to 'newlib/libc/signal/raise.c')
-rw-r--r--newlib/libc/signal/raise.c80
1 files changed, 80 insertions, 0 deletions
diff --git a/newlib/libc/signal/raise.c b/newlib/libc/signal/raise.c
new file mode 100644
index 000000000..bc47864e8
--- /dev/null
+++ b/newlib/libc/signal/raise.c
@@ -0,0 +1,80 @@
+/* Embedded systems may want the simulated signals if no other form exists,
+ but UNIX versions will want to use the host facilities.
+ Define SIMULATED_SIGNALS when you want to use the simulated versions.
+*/
+
+/*
+FUNCTION
+<<raise>>---send a signal
+
+INDEX
+ raise
+INDEX
+ _raise_r
+
+ANSI_SYNOPSIS
+ #include <signal.h>
+ int raise(int <[sig]>);
+
+ int _raise_r(void *<[reent]>, int <[sig]>);
+
+TRAD_SYNOPSIS
+ #include <signal.h>
+ int raise(<[sig]>)
+ int <[sig]>;
+
+ int _raise_r(<[reent]>, <[sig]>)
+ char *<[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>>.
+*/
+
+#ifndef SIGNAL_PROVIDED
+
+int _dummy_raise;
+
+#else
+
+#include <reent.h>
+#include <signal.h>
+
+#ifndef _REENT_ONLY
+
+int
+_DEFUN (raise, (sig),
+ int sig)
+{
+ return _raise_r (_REENT, sig);
+}
+
+#endif
+
+int
+_DEFUN (_raise_r, (reent, sig),
+ struct _reent *reent _AND
+ int sig)
+{
+ return _kill_r (reent, _getpid_r (reent), sig);
+}
+
+#endif /* SIGNAL_PROVIDED */