NAME

pause - suspend the thread until signal is received

 SYNOPSIS

#include <unistd.h>

int pause(void);

 DESCRIPTION

The pause() function suspends the calling thread until delivery of a signal whose action is either to execute a signal-catching function or to terminate the process.

If the action is to terminate the process, pause() will not return.

If the action is to execute a signal-catching function, pause() will return after the signal-catching function returns.

 RETURN VALUE

Since pause() suspends thread execution indefinitely unless interrupted by a signal, there is no successful completion return value. A value of -1 is returned and errno is set 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.

 EXAMPLES

None.

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

sigsuspend(), <unistd.h>.

DERIVATION

Derived from Issue 1 of the SVID.