sigsuspend(2)                       CLIX                       sigsuspend(2)



  NAME

    sigsuspend - Changes the set of blocked signals and waits for a signal

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    #include <signal.h>

    int sigsuspend(
      sigset *signal_mask );

  PARAMETERS

    signal_mask   Points to the set of signals to replace the process' signal
                  mask.

  DESCRIPTION

    The sigsuspend() function replaces the signal mask of the process with the
    set of signals to which the signal_mask parameter points, and then
    suspends execution of the process until delivery of a signal whose action
    is either to execute a signal-catching function or to terminate the
    process.  The sigsuspend() function does not allow those signals that
    cannot be ignored to be blocked.  (See the sigaction() function.)  If a
    program attempts to block one of these signals, sigsuspend() gives no
    indication of the error.

    If delivery of a signal causes the process to terminate, sigsuspend() does
    not return.  If delivery of a signal causes a signal-catching function to
    execute, sigsuspend() returns after the signal-catching function returns,
    with the signal mask restored to the set that existed prior to calling
    sigsuspend().

  RETURN VALUES

    Since sigsuspend() suspends process execution indefinitely, there is no
    successful completion return value.  A value of -1 is returned and errno
    is set to indicate the error.

  ERRORS

    The sigsuspend() function fails if the following is true:

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

  RELATED INFORMATION



  2/94 - Intergraph Corporation                                              1

  sigsuspend(2)                       CLIX                       sigsuspend(2)



    Functions:  pause(2), sigprocmask(2), sigaction(2), signal(2)





















































  2                                              Intergraph Corporation - 2/94