NAME    [Toc]    [Back]

       pause - Suspends a process until it receives a signal

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int pause(
               void );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       pause():  POSIX.1, XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

DESCRIPTION    [Toc]    [Back]

       The pause() function suspends the calling process until it
       receives a signal whose action is either to execute a signal-catching
  function or terminate the process.  The signal
 must be one that is acknowledged by the  calling  process.
  The  pause()  function  does  not affect the action
       taken when a signal is received.

       The pause() function suspends the calling process by  suspending
  the calling thread. Other threads in the process,
       if any, are not suspended.

RETURN VALUES    [Toc]    [Back]

       When the received signal causes  the  calling  process  to
       terminate, the pause() function does not return.

       When  the signal is caught by the calling process and control
 is returned from the  signal-catching  function,  the
       calling thread resumes execution from the point of suspension.
 At that point, the pause() function returns a  value
       of -1 and sets errno to indicate the error.

ERRORS    [Toc]    [Back]

       The  pause()  function  sets errno to the specified values
       for the following conditions: The signal has  been  caught
       by  the calling process and control has been returned from
       the signal-catching function.

SEE ALSO    [Toc]    [Back]

       Functions: kill(2), sigaction(2), sigvec(2), wait(2)

       Routines: alarm(3)

       Standards: standards(5)



                                                         pause(3)