SIGSET(3) | Linux Programmer's Manual | SIGSET(3) |
NAME
sigset, sighold, sigrelse, sigignore - System V signal APISYNOPSIS
#include <signal.h>Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
_XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
DESCRIPTION
These functions are provided in glibc as a compatibility interface for programs that make use of the historical System V signal API. This API is obsolete: new applications should use the POSIX signal API ( sigaction(2), sigprocmask(2), etc.)- SIG_DFL
- Reset the disposition of sig to the default.
- SIG_IGN
- Ignore sig.
- SIG_HOLD
- Add sig to the process's signal mask, but leave the disposition of sig unchanged.
If disp specifies the address of a signal handler, then sig is added to the process's signal mask during execution of the handler.
If disp was specified as a value other than SIG_HOLD, then sig is removed from the process's signal mask.
The dispositions for SIGKILL and SIGSTOP cannot be changed.
The sighold() function adds sig to the calling process's signal mask.
The sigrelse() function removes sig from the calling process's signal mask.
The sigignore() function sets the disposition of sig to SIG_IGN.
RETURN VALUE
On success, sigset() returns SIG_HOLD if sig was blocked before the call, or the signal's previous disposition if it was not blocked before the call. On error, sigset() returns -1, with errno set to indicate the error. (But see BUGS below.)ERRORS
For sigset() see the ERRORS under sigaction(2) and sigprocmask(2).CONFORMING TO
SVr4, POSIX.1-2001. These functions are obsolete: do not use them in new programs. POSIX.1-2008 marks sighold(), sigignore(), sigpause(), sigrelse(), and sigset() as obsolete, recommending the use of sigaction(2), sigprocmask(2), pthread_sigmask(3), and sigsuspend(2) instead.NOTES
These functions appeared in glibc version 2.1.BUGS
In versions of glibc before 2.2, sigset() did not unblock sig if disp was specified as a value other than SIG_HOLD.SEE ALSO
kill(2), pause(2), sigaction(2), signal(2), sigprocmask(2), raise(3), sigpause(3), sigvec(3), signal(7)COLOPHON
This page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.2010-09-20 | Linux |