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 whose action is either to execute a
signal-catching function or terminate the process. The sig-
nal must not be one that is not acknowledged by the calling
process. The pause() function does not affect the action
taken when a signal is received.
The pause() function, which suspends the calling process
until the request is completed, is redefined so that only
the calling thread is suspended.
NOTES
The pause() function is not supported for multi-threaded
applications.
AES Support Level: Full use
RETURN VALUES
When the received signal causes the calling process to end,
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
process resumes execution from the point of suspension, and
the pause() function returns a value of -1 and sets errno to
the value [EINTR].
ERRORS
If the pause() function fails, errno may be set to the fol-
lowing value:
[EINTR] The signal is caught by the calling process and
control is returned from the signal-catching func-
tion.
RELATED INFORMATION
Functions: alarm(3), kill(2), sigaction(2), sigvec(2),
wait(2)
Acknowledgement and Disclaimer