Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (n - r) pause(3)
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent |
compiler command option.
• Compile the application using the -Wlp64 compiler command option. |
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll). |
For detailed information about writing multi-threaded and 64-bit applications for the Open Sys- |
tem Services environment, see the Open System Services Programmer’s Guide.
RETURN VALUES
When the received signal causes the calling process to terminate, neither the pause( ) function
nor the thread-aware pause( ) function returns a value.
When a pause( ) function error condition occurs, the value -1 is returned and errno is set to indi-
cate the error.
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 or thread and control is returned from
the signal-catching function.
When the signal is caught by the calling process or thread and control is returned
from the signal-catching function, the calling process or thread resumes execu-
tion from the point of suspension and sets errno to this value.
[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.
This value is not returned by the thread-aware pause( ) function.
RELATED INFORMATION
Functions: alarm(3), kill(2), sigaction(2), signal(3), spt_pause(2), wait(2).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification.
The following are HP extensions to the XPG4 Version 2 specification:
• The pause( ) function can return the errno value [ENOTOSS].
The use of this function with the POSIX User Thread Model library conforms to the following
industry standards:
• IEEE Std 1003.1-2004, POSIX System Application Program Interface
This function does not conform to the async-signal safe requirement of the POSIX.1 standard.
527187-017 Hewlett-Packard Company 5−51