pause(3)pause(3)NAMEpause - Suspends a process until it receives a signal
SYNOPSIS
#include <unistd.h>
int pause(
void );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards 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
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 sus‐
pended.
RETURN VALUES
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
The pause() function sets errno to the specified values for the follow‐
ing conditions: The signal has been caught by the calling process and
control has been returned from the signal-catching function.
SEE ALSO
Functions: kill(2), sigaction(2), sigvec(2), wait(2)
Routines: alarm(3)
Standards: standards(5)pause(3)