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

sigpending(2) OSS System Calls Reference Manual
NAME
sigpending - Examines pending signals
LIBRARY
G-series native OSS processes: system library
H-series and J-series OSS processes: implicit libraries
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
SYNOPSIS
#include <signal.h>
int sigpending(
sigset_t *set);
PARAMETERS
set Points to an object of type sigset_t that returns the set of signals that are blocked
from delivery and pending to the calling process.
DESCRIPTION
The sigpending( ) function stores the set of signals that are blocked from delivery and pending to
the calling process in the object pointed to by the set parameter.
Because signals can arrive asynchronously, no assumption should be made about the current set
of pending signals, based on the value returned by this function in set.
Use From a Threaded Application
The thread-aware sigpending( ) 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
because the calling thread’s signal mask is preventing their delivery. The blocked signals are
stored in the structure pointed to by the set parameter.
Use From the Guardian Environment
If called from a TNS or accelerated Guardian process, the actions of this function are undefined
and errno is set to [ENOTOSS].
NOTES
To use the sigpending( ) functionality in a threaded application that uses the Standard POSIX
Threads library, see spt_sigpending(2).
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks to make the function thread-aware in a multi-threaded application:
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit threaded applications.
To use this function in a 32-bit threaded application on systems running H06.24 or later RVUs or
J06.13 or later RVUs, perform the same tasks (described above) used to make the function
thread-aware in a multi-threaded application on systems running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit threaded application on systems running H06.24 or later RVUs or
J06.13 or later RVUs, you must perform all of the following tasks to make the function thread-
aware in a multi-threaded application:
7−102 Hewlett-Packard Company 527186-023