sigpause(2)                    DG/UX 5.4R3.00                    sigpause(2)


NAME
       sigpause - clear a blocked signal and suspend process until a signal
       is caught

SYNOPSIS
       #include <sys/signal.h>

       int  sigpause (signalnumber)
       int  signalnumber;

   where:
       signalnumber  The signal whose blocked state is to be cleared

DESCRIPTION
       Sigpause removes the specified signal from the set of signals blocked
       from presentation and then suspends the caller until a signal is
       caught.

       This function is exactly equivalent to the system call sigrelse
       followed by pause.

ACCESS CONTROL
       None.

RETURN VALUE
       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINVAL    signalnumber is an illegal signal number or a signal that
                 cannot be unblocked.

       EINTR     A signal interrupted the sigpause operation

SEE ALSO
       berksigpause(2), kill(2), pause(2), sighold(2), sigignore(2),
       signal(2), sigrelse(2), sigset(2).

STANDARDS
       When using m88kbcs as the Software Development Environment target,
       the sigpause function will be emulated using BCS system calls.  Since
       this is an emulation requiring several BCS system calls, a slight
       performance degradation may be noticed in comparison to using
       sigpause in /lib/libc.a.












Licensed material--property of copyright holder(s)                         1