pause(2)                            CLIX                            pause(2)



  NAME

    pause - Suspends a process until a signal is received

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    int pause(
      void

  DESCRIPTION

    The pause() function suspends the calling process until it receives a
    signal.  The signal must not be one that is currently set to be ignored by
    the calling process.  This function does not affect the action taken when
    a signal is received.

  EXAMPLES

    To suspend a process until a SIGCLD or other signal is received:

    signal(SIGCLD, sigcld_handler);
    pause();


  RETURN VALUES

    If the received signal causes the calling process to terminate, pause()
    will not return.

    If the signal is caught by the calling process and control is returned
    from the signal-catching function, the calling process resumes execution
    from the point of suspension; pause() returns a value of -1 and sets
    global variable errno to the value EINTR.

  ERRORS

    The pause 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

    Functions: alarm(2), kill(2), killpg(2), sigaction(2), signal(2), wait(2),
    waitpid(2)





  2/94 - Intergraph Corporation                                              1