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

System Functions (s and S) spt_pause(2)
NAME
spt_pause - Suspends a thread until a signal is received.
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/sysnn/zsptdll
SYNOPSIS
#include <spthread.h>
int spt_pause(void)
DESCRIPTION
This function suspends the calling thread until it receives a signal whose action is either to exe-
cute a signal-catching function or to terminate the process. The
spt_pause() function does not
affect the action taken when the signal is received.
To catch externally-generated signals (such as SIGINT, SIGQUIT, SIGALRM, and SIGCHLD) at
the thread level, you must export the SPT_THREAD_AWARE_SIGNAL envronmental variable
to the value 1. By default, SPT_THREAD_AWARE_SIGNAL is disabled.
RETURN VALUES
When the received signal cause the calling process to terminate, the spt_pause() function does
not return a value. When the signal is caught by the calling thread and control is returned from
the signal- catching function, the calling thread resumes execution from the point of suspension,
the spt_pause() function returns the value -1, and spt_pause() function sets errno to the value
[EINTR].
ERRORS
If the following condition occurs, the spt_pause() function sets errno to this value:
[EINTR] The signal was caught by the calling thread and control was returned from the
signal-catching fucntion.
RELATED INFORMATION
Functions: pause(2), pthread_kill(2), pthread_sigmask(2), sigsuspend(2) spt_sigaction(2),
spt_signal(2), spt_sigsuspend(2).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this
reference page conform to the following industry standards:
• IEEE Std 1003.1c-1995, POSIX System Application Program Interface
The use of the header file spthread.h is an HP exception to the POSIX standard.
527186-007 Hewlett-Packard Company 7−211