Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-137
SIGACTION_SUPPLANT_ Procedure
•
UCONTEXT
A pointer to a structure of type UCONTEXT_T. It contains information
regarding the process context when the signal occurred. You can pass this
pointer to the HIST_INIT_ procedure to get diagnostic information.
•
SIG_DFL
Causes default signal handling to be installed for all signals.
•
SIG_ABORT
Causes the process to be abnormally terminated when a signal occurs.
•
SIG_DEBUG
Causes the process to enter debug mode when a signal occurs.
•
If the signal was generated as a nondeferrable signal, the signal handler should
not execute a simple return; otherwise, process termination results. You must exit
the signal handler using either the SIGLONGJMP_ or LONGJMP_ procedure; the
effect is the same for either procedure, because the signal mask is set to block all
signals regardless of whether the original mask is restored.
For a deferrable signal, the signal handler can simply return, causing process
execution to resume where it was preempted by the signal.
Example
SIGSAVE_DEF ( buffer );
error := SIGACTION_SUPPLANT_ ( handler, buffer, length );
IF error <> 0 THEN
errnoval := ERRNO_GET_;
Related Programming Manual
For programming information about the SIGACTION_SUPPLANT_ procedure, see the
Guardian Programmer’s Guide.
Note. This action is similar to calling ARMTRAP(-1,-1) for a TNS process.
Note. The SIG_ABORT and SIG_DEBUG options are HP extensions to the POSIX.1
standard.