Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-134
SIGACTION_SUPPLANT_ Procedure
FE_EFAULT The address in signal-buffer is out of bounds.
FE_EINVAL SIG_IGN or SIG_ERR is passed to
the handler.
FE_ERANGE length is less than the minimum required.
Use the ERRNO_GET_ procedure to obtain the value of
errno in a
Guardian process.
handler input
PROCADDR:value
specifies the action to be invoked when a signal occurs. Its value can be:
•
The address of a native procedure to perform the signal handling
•
SIG_DFL to accept the default action
•
SIG_ABORT to abnormally terminate the process
•
SIG_DEBUG to enter debug mode
See Handler Considerations
on page 14-136 for details.
signal-buffer output
INT .EXT:ref:*
returns the address of a buffer in which the previous signal-handling state is saved.
The buffer is allocated using the SIGSAVE_DEF_ DEFINE.
length input
INT:value
specifies the size in bytes of the buffer indicated by
signal-buffer.
General Considerations
•
POSIX.1 compliance
This procedure is an extension to the POSIX.1 standard. A similar same effect can
be achieved while maintaining compliance with the POSIX.1 standard by calling
the SIGPROCMASK_ procedure and the SIGACTION_ procedure for each signal.
However, SIGACTION_SUPPLANT_ also establishes a state in which a deferrable
signal can be blocked but the same signal will invoke the handler if generated as
nondeferrable.
•
Calling considerations