Next: Signal and Sigaction, Previous: Basic Signal Handling, Up: Signal Actions
The sigaction
function has the same basic effect as
signal
: to specify how a signal should be handled by the process.
However, sigaction
offers more control, at the expense of more
complexity. In particular, sigaction
allows you to specify
additional flags to control when the signal is generated and how the
handler is invoked.
The sigaction
function is declared in signal.h.
Structures of type
struct sigaction
are used in thesigaction
function to specify all the information about how to handle a particular signal. This structure contains at least the following members:
sighandler_t sa_handler
- This is used in the same way as the action argument to the
signal
function. The value can beSIG_DFL
,SIG_IGN
, or a function pointer. See Basic Signal Handling.sigset_t sa_mask
- This specifies a set of signals to be blocked while the handler runs. Blocking is explained in Blocking for Handler. Note that the signal that was delivered is automatically blocked by default before its handler is started; this is true regardless of the value in
sa_mask
. If you want that signal not to be blocked within its handler, you must write code in the handler to unblock it.int sa_flags
- This specifies various flags which can affect the behavior of the signal. These are described in more detail in Flags for Sigaction.
The action argument is used to set up a new action for the signal signum, while the old-action argument is used to return information about the action previously associated with this symbol. (In other words, old-action has the same purpose as the
signal
function’s return value—you can check to see what the old action in effect for the signal was, and restore it later if you want.)Either action or old-action can be a null pointer. If old-action is a null pointer, this simply suppresses the return of information about the old action. If action is a null pointer, the action associated with the signal signum is unchanged; this allows you to inquire about how a signal is being handled without changing that handling.
The return value from
sigaction
is zero if it succeeds, and-1
on failure. The followingerrno
error conditions are defined for this function:
EINVAL
- The signum argument is not valid, or you are trying to trap or ignore
SIGKILL
orSIGSTOP
.