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>.