sigsuspend(2)                                                 sigsuspend(2)




 NAME
      sigsuspend - wait for a signal

 SYNOPSIS
      #include <signal.h>

      int sigsuspend(const sigset_t *sigmask);

 DESCRIPTION
      The sigsuspend() function replaces the  process' current signal mask
      with the set of signals pointed to by sigmask and then suspends the
      process until delivery of a signal whose action is either to execute a
      signal-catching function or to terminate the process.

      If the action is to terminate the process then sigsuspend() will never
      return. If the action is to execute  a  signal-catching function, then
      sigsuspend() will  return after the signal-catching function returns,
      with the signal mask restored to the set that existed prior to the
      sigsuspend() call.

      It is not possible to block signals that cannot be ignored. This is
      enforced by the system without causing an error to be indicated.

 RETURN VALUE
      Since sigsuspend() suspends process execution indefinitely, there is
      no successful completion return value. If a return occurs, -1 is
      returned and errno is set to indicate the error.

 ERRORS
      The sigsuspend() function will fail if:

           [EINTR]                  A signal is caught by the calling
                                    process and control is returned from the
                                    signal-catching function.

 SEE ALSO
      pause(), sigaction(), sigaddset(), sigdelset(), sigemptyset(),
      sigfillset(), <signal.h>.

 CHANGE HISTORY
      First released in Issue 3.

      Entry included for alignment with the POSIX.1-1988 standard.

 Issue 4
      The following change is incorporated  for  alignment with the ISO
      POSIX-1 standard:

           o  The type of the argument sigmask is changed from sigset_t* to
              type constsigset_t*.




 Hewlett-Packard Company            - 1 -    HP-UX Release 10.20:  July 1996






 sigsuspend(2)                                                 sigsuspend(2)




      Another change is incorporated as follows:

           o  The term "signal  handler" is changed to "signal-catching
              function."















































                                    - 2 -         Formatted:  April 25, 2001









 sigsuspend(2)                                                 sigsuspend(2)




                                 HP-UX EXTENSIONS



 ERRORS
           [EFAULT]       sigmask points to an invalid address.  The
                          reliable detection of this error is implementation
                          dependent.

 AUTHOR
      sigsuspend() was derived from the IEEE POSIX 1003.1-1988 Standard.

 SEE ALSO
      sigaction(2), sigpending(2), sigprocmask(2), sigsetops(3C), signal(5).

 STANDARDS CONFORMANCE
      sigsuspend(): AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1





































 Hewlett-Packard Company            - 1 -    HP-UX Release 10.20:  July 1996