SIGSET(3)

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

This interface is made obsolete by sigaction(2) and sigprocmask(2).

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.

April 30, 2010 | NetBSD 9.5