ssignal(3)
_________________________________________________________________
ssignal, gsignal Subroutine
software signals
_________________________________________________________________
SYNTAX
#include <signal.h>
int (*ssignal (sig, action))()
int sig, (*action)();
int gsignal (sig)
int sig;
DESCRIPTION
Ssignal and gsignal implement a software facility similar to
signal(2). This facility is used by the standard C library to
let users indicate the disposition of error conditions. Users may
also use it for their own purposes.
Software signals made available to users are associated with
integers in the inclusive range 1 through 15. A call to ssignal
associates a procedure, action, with the software signal sig; sig
is raised by a call to gsignal. Raising a software signal
triggers the action established for that signal.
The first argument to ssignal is a number identifying the type of
signal for which an action is to be established. The second
argument defines the action; it is either the name of a user-
defined action function or one of the manifest constants SIGDFL
(default) or SIGIGN (ignore). Ssignal returns the action
previously established for that signal type; if no action has
been established or the signal number is illegal, ssignal returns
SIGDFL.
Gsignal raises the signal identified by its argument, sig:
If an action function has been established for sig, then
that action is reset to SIGDFL and the action function is
entered with argument sig. Gsignal returns the value
returned to it by the action function.
If the action for sig is SIGIGN, gsignal returns the value
1 and takes no other action.
If the action for sig is SIGDFL, gsignal returns the value
0 and takes no other action.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
ssignal(3)
If sig has an illegal value or no action was ever specified
for sig, gsignal returns the value 0 and takes no other
action.
SEE ALSO
signal(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)