Guardian Procedure Calls Reference Manual

SIGACTION_SUPPLANT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
NOTE: This procedure can be called only from native processes.
The SIGACTION_SUPPLANT_ procedure allows a subsystem (such as a shared run-time library) to
take over signal handling temporarily. Before exiting, the same subsystem calls the
SIGACTION_RESTORE_ restore to restore the signal-handling state established by the process
before entering the subsystem.
Syntax for C Programmers
#include <tdmsig.h>
int SIGACTION_SUPPLANT_ ( void (* handler) /* function pointer */
( int /* signal number */
,siginfo_t * /* (unused) */
,void * /* uContext pointer */
)
,sig_save_template *signal-buffer
,short length );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.HTDMSIG
error := SIGACTION_SUPPLANT_ ( handler ! i
,signal-buffer ! o
,length); ! i
Parameters
handler
input
PROCADDR:value
specifies the action to be invoked when a signal occurs. For details, see the SIGACTION_INIT_
procedure Handler Considerations (page 1364).
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.
1368 Guardian Procedure Calls (S)