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

System Functions (s and S) spt_sigpending(2)
NAME
spt_sigpending - Examines signals that are blocked and pending
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series and J series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
int spt_sigpending(sigset_t *set);
PARAMETERS
set Specifies the set of signals that are blocked and pending.
DESCRIPTION
The spt_sigpending(2) function retrieves the signals that have been sent to the calling thread but
have been blocked from delivery. These signals are pending to the calling thread, the calling
thread’s signal mask is preventing their delivery. The blocked signals are stored in the structure
pointed to by the set parameter. Because signals can arrive asynchronously, do not make
assumptions about the current set of pending signals based on the value returned by this function
in set.
NOTES
To use this function in a threaded application that uses the Standard POSIX Threads library on
systems running J06.10 or later RVUs or H06.21 or later RVUs, you must perform all of the fol-
lowing tasks:
• Include the spthread.h header file in the application.
• Compile the application using the _SPT_MODEL_ feature test macro or equivalent
compiler command option in addition to any other feature test macros in use.
• Link the application to the zsptdll library (/G/system/zdllnnn/zsptdll).
RETURN VALUES
Upon successful completion, the spt_sigpending(2) function returns a value of 0 (zero). Other-
wise -1 is returned and errno is set to indicate the error.
ERRORS
If this conditions occurs, the spt_sigpending(2) function sets errno to the corresponding value:
[EFAULT] The set argument points to an invalid address.
RELATED INFORMATION
Functions: pthread_kill(2), pthread_sigmask(2), sigpending(2), spt_pause(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-023 Hewlett-Packard Company 7−419