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.

SEE ALSO

sigaction(2), sigprocmask(2)

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.