System Calls                                             pause(2)



NAME
     pause - suspend process until signal

SYNOPSIS
     #include 

     int pause(void);


DESCRIPTION
     The pause() function suspends the calling process  until  it
     receives  a  signal.  The  signal  must  be  one that is not
     currently set to be ignored by the calling process.


     If the signal causes termination  of  the  calling  process,
     pause() does not return.


     If the signal is caught by the calling process  and  control
     is   returned   from   the   signal-catching  function  (see
     signal(3C)), the calling process resumes execution from  the
     point of suspension.

RETURN VALUES
     Since pause() suspends thread  execution indefinitely unless
     interrupted  by  a signal, there is no successful completion
     return value.  If interrupted, it returns -1 and sets  errno
     to indicate the error.

ERORS
     The pause() function will fail if:

     EINTR    A signal is caught by the calling process and  con-
              trol is returned from the signal-catching function.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:















SunOS 5.11          Last change: 28 Dec 1996                    1






System Calls                                             pause(2)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Async-Signal-Safe           
    


SEE ALSO
     alarm(2),  kill(2),  signal(3C),  wait(3C),   attributes(5),
     standards(5)











































SunOS 5.11          Last change: 28 Dec 1996                    2