Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

pause(3) OSS Library Calls Reference Manual
NAME
pause - Suspends a process until a signal is received
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series native Guardian processes: implicit libraries
H-series OSS processes: implicit libraries
SYNOPSIS
#include <unistd.h>
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 to terminate the process. The
pause( ) function does not
affect the action taken when the signal is received.
The pause() function is not supported for multithreaded applications.
Use From the Guardian Environment
If called from a TNS or accelerated Guardian process, the value -1 is returned and errno is set to
[ENOTOSS].
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 process resumes execution from the point of suspension. The pause() func-
tion returns the value -1 and sets errno to the value [EINTR].
ERRORS
If any of the following conditions occurs, the pause() function sets errno to the corresponding
value:
[EINTR] The signal is caught by the calling process and control is returned from the
signal-catching function.
[ENOTOSS] The calling process was not an OSS process or a native Guardian process. This
function cannot be used in the Guardian environment by a TNS or accelerated
process.
RELATED INFORMATION
Functions: alarm(3), kill(2), sigaction(2), signal(3), wait(2).
STANDARDS CONFORMANCE
The following are HP extensions to the XPG4 Version 2 specification:
• The pause() function can return the errno value [ENOTOSS].
5−32 Hewlett-Packard Company 527187-007