sigpause(3) [osf1 man page]

sigpause(3)						     Library Functions Manual						       sigpause(3)

NAME

       sigpause - Provides a compatibility interface to the sigsuspend function

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <signal.h>

       int sigpause (
	       int signal_mask );

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       sigpause():  XSH4.2

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Specifies which signals to block.

DESCRIPTION

       The  sigpause()	function  call	blocks the signals specified by the signal_mask parameter and then suspends execution of the process until
       delivery of a signal whose action is either to execute a signal-catching function or to end the process.  Signal of value i is  blocked	if
       the i-th bit of the mask is set.  Only signals with values 1 to 31 can be blocked with the sigpause() function. In addition, the sigpause()
       function does not allow the SIGKILL, SIGSTOP, or SIGCONT signals to be blocked.	If a program attempts to block one of these  signals,  the
       sigpause() function gives no indication of the error.

       The  sigpause()	function  sets	the  signal mask and waits for an unblocked signal as one atomic operation. This means that signals cannot
       occur between the operations of setting the mask and waiting for a signal.

       The sigpause() function is provided for compatibility with older UNIX systems; its function is a subset of the sigsuspend() function.

NOTES

       [Tru64 UNIX]  When compiled in the X/Open UNIX environment, calls to the sigpause() function are internally renamed by prepending _E to the
       function name. When you are debugging a module that includes the sigpause() function and for which _XOPEN_SOURCE_EXTENDED has been defined,
       use _Esigpause to refer to the sigpause() call.	See standards(5) for information on when the _XOPEN_SOURCE_EXTENDED macro is defined.

RETURN VALUES

       Upon successful completion, sigpause() returns 0 (zero).  Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS

       The sigpause() function sets errno to the specified values for the following conditions: The signal_mask parameter  refers  to  an  illegal
       signal number.  [Tru64 UNIX]  A signal was caught by the calling process.

RELATED INFORMATION

       Functions: pause(3), sigaction(2), sigblock(2), sigprocmask(2), sigsuspend(2), sigvec(2)

       Standards: standards(5) delim off

																       sigpause(3)

Check Out this Related Man Page

sigblock(3UCB)					     SunOS/BSD Compatibility Library Functions					    sigblock(3UCB)

NAME

       sigblock, sigmask, sigpause, sigsetmask - block signals

SYNOPSIS

       /usr/ucb/cc [ flag ... ] file ...
       #include <signal.h>

       int sigblock(mask)
       int mask;

       int sigmask(signum)
       int signum;

       int sigpause(mask)
       int mask;

       int sigsetmask(mask)
       int mask;

DESCRIPTION

       sigblock()  adds  the  signals  specified  in mask to the set of signals currently being blocked from delivery.	Signals are blocked if the
       appropriate bit in mask is a 1; the macro sigmask is provided to construct the mask for a given signum.	sigblock()  returns  the  previous
       mask. The previous mask may be restored using sigsetmask().

       sigpause()  assigns  mask  to  the  set	of  masked  signals  and then waits for a signal to arrive; on return the set of masked signals is
       restored. mask is usually 0 to indicate that no signals are now to be blocked. sigpause() always terminates by being interrupted, returning
       -1 and setting errno to EINTR.

       sigsetmask()  sets the current signal mask (those signals that are blocked from delivery).  Signals are blocked if the corresponding bit in
       mask is a 1; the macro sigmask is provided to construct the mask for a given signum.

       In normal usage, a signal is blocked using sigblock(). To begin a critical section, variables modified on the occurrence of the signal  are
       examined  to determine that there is no work to be done, and the process pauses awaiting work by using sigpause() with the mask returned by
       sigblock().

       It is not possible to block SIGKILL, SIGSTOP, or  SIGCONT, this restriction is silently imposed by the system.

RETURN VALUES

       sigblock() and sigsetmask() return the previous set of masked signals. sigpause() returns -1 and sets errno to EINTR.

SEE ALSO

       cc(1B), kill(2), sigaction(2), signal(3UCB), sigvec(3UCB)

NOTES

       Use of these interfaces should be restricted to only applications written on BSD platforms.  Use of these interfaces with any of the system
       libraries or in multi-thread applications is unsupported.

SunOS 5.11							    30 Oct 2007 						    sigblock(3UCB)

Linux and UNIX Man Pages

sigpause(3) [osf1 man page]

Check Out this Related Man Page