unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

pause(2)                         System Calls                         pause(2)



NAME
       pause - suspend process until signal

SYNOPSIS
       #include <unistd.h>

       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  inter-
       rupted by a signal, there is no successful completion return value.  If
       interrupted, it returns -1 and sets errno to indicate the error.

ERRORS
       The pause() function will fail if:

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



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE Interface  StabilityStan-
       dard MT-LevelAsync-Signal-Safe


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



SunOS 5.10                        28 Dec 1996                         pause(2)