Open System Services System Calls Reference Manual (G06.25+, H06.03+)

sigaction(2) OSS System Calls Reference Manual
NAME
sigaction - Specifies the action to take upon delivery of a signal
LIBRARY
G-series native OSS processes: system library
H-series OSS processes: implicit libraries
SYNOPSIS
[ #include <spthread.h> ]
#include <signal.h>
int sigaction(
int signal,
const struct sigaction *action,
struct sigaction *o_action );
PARAMETERS
signal Specifies the signal. The signal names are defined in the signal.h header file.
The range of valid signals depends on the requested action.
action Points to a sigaction structure that describes the action to be taken upon receipt
of the signal identified by the signal parameter.
o_action Points to a sigaction structure that returns the signal action data in effect before
the call was made. For the signal action in effect at the time of the sigaction()
call to be returned, the o_action parameter must not be a null pointer.
DESCRIPTION
The sigaction() function allows the calling process to change or examine the action to be taken
when a specific signal is delivered to the calling process.
Associated with every signal is a signal-dependent default action. The sigaction() function can
change this action by causing the receiving process to
• Ignore the delivery of a specific signal
• Restore the default action for a specific signal
• Invoke a signal-catching function (that is, "catch" the signal) in response to the delivery
of a specific signal
See the signal(4) reference page for the defined signal names and details about the cause and
default action of each defined signal.
Unless you are writing a standard POSIX threads application, omit the spthread.h header file.
Use From the Guardian Environment
If called from a TNS or accelerated Guardian process, the actions of this function are undefined
and errno is set to [ENOTOSS].
Specifying the Signal
The signal parameter specifies the signal. All values defined for signals in the signal.h header file
are valid if the corresponding action is to restore the default action. All signals can be caught or
ignored except the SIGKILL, SIGSTOP, and SIGABEND signals; these signals can neither be
caught nor ignored.
7−60 Hewlett-Packard Company 527186-003