Query: sigpause
OS: centos
Section: 3
Links: centos man pages all man pages forum categories
Format:Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
SIGPAUSE(3) Linux Programmer's Manual SIGPAUSE(3)NAMEsigpause - atomically release blocked signals and wait for interruptSYNOPSIS#include <signal.h> int sigpause(int sigmask); /* BSD */ int sigpause(int sig); /* System V / UNIX 95 */DESCRIPTIONDon't use this function. Use sigsuspend(2) instead. The function sigpause() is designed to wait for some signal. It changes the process's signal mask (set of blocked signals), and then waits for a signal to arrive. Upon arrival of a signal, the original signal mask is restored.RETURN VALUEIf sigpause() returns, it was interrupted by a signal and the return value is -1 with errno set to EINTR.CONFORMING TOThe System V version of sigpause() is standardized in POSIX.1-2001.NOTESHistory The classical BSD version of this function appeared in 4.2BSD. It sets the process's signal mask to sigmask. UNIX 95 standardized the incompatible System V version of this function, which removes only the specified signal sig from the process's signal mask. The unfortu- nate situation with two incompatible functions with the same name was solved by the sigsuspend(2) function, that takes a sigset_t * argu- ment (instead of an int). Linux notes On Linux, this routine is a system call only on the Sparc (sparc64) architecture. Libc4 and libc5 know only about the BSD version. Glibc uses the BSD version if the _BSD_SOURCE feature test macro is defined and none of _POSIX_SOURCE, _POSIX_C_SOURCE, _XOPEN_SOURCE, _GNU_SOURCE, or _SVID_SOURCE is defined. Otherwise, the System V version is used.SEE ALSOkill(2), sigaction(2), sigprocmask(2), sigsuspend(2), sigblock(3), sigvec(3), feature_test_macros(7)COLOPHONThis 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/. Linux 2010-09-12 SIGPAUSE(3)