sigpause(2) — DG/UX 4.30



     sigpause(2)                DG/UX 4.30                 sigpause(2)



     NAME
          sigpause - Clear a blocked signal and suspend the process
          until a signal is caught.

     SYNOPSIS
          #include <sys/signal.h>

          int     sigpause (signal_number)
          int     signal_number;

     PARAMETERS
          signal_number  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.

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


          EINVAL         <Signal_number> is an illegal signal number
                         or a signal that cannot be unblocked.


          EINTR          A signal interrupted the sigpause operation

     SEE ALSO
          The related system calls:  kill, pause, signal, sigset,
          sighold, sigrelse, sigignore, berk_sigpause

     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)         Page 1
Museum
