SIGSET(3) |
Library Functions Manual |
SIGSET(3) |
NAME
sigset — manipulate signal dispositions
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <signal.h>
void (*
sigset(int sig, void (*disp)(int)))(int);
DESCRIPTION
The sigset() function manipulates the disposition of the signal sig. The new disposition is given in disp.
If disp is one of SIG_DFL, SIG_IGN, or the address of a handler function, the disposition of sig is changed accordingly, and sig is removed from the process' signal mask. Also, if disp is the address of a handler function, sig will be added to the process' signal mask during execution of the handler.
If disp is equal to SIG_HOLD, sig is added to the calling process' signal mask and the disposition of sig remains unchanged.
RETURN VALUES
If successful, the sigset() function returns SIG_HOLD if sig had been blocked, and the previous disposition of sig if it had not been blocked. Otherwise SIG_ERR is returned and errno is set to indicate the error.
ERRORS
The
sigset() function will fail if:
-
[EINVAL]
-
The argument sig is not a valid signal number; or an attempt is made to ignore a signal that cannot be ignored, such as SIGKILL or SIGSTOP.
STANDARDS
The sigset() function conforms to IEEE Std 1003.1-2001 (“POSIX.1”). It was however marked as obsolete in the IEEE Std 1003.1-2008 (“POSIX.1”) revision of the standard.