HP-UX Reference (11i v2 07/12) - 2 System Calls (vol 5)

sigpending(2) sigpending(2)

NAME

sigpending() - examine pending signals

SYNOPSIS

#include <signal.h>

int sigpending(sigset_t *set);

DESCRIPTION

sigpending() stores the set of signals that are blocked from delivery and are pending to the calling

thread, at the location pointed to by set.

RETURN VALUE

Upon successful completion,

sigpending() returns 0. Otherwise -1 is returned and

errno is set to

indicate the error.

ERRORS

sigpending() fails if the following condition is encountered:

[EFAULT] set points to an invalid address. The reliable detection of this error is implementation-

dependent.

APPLICATION USAGE

Threads Considerations

The set of signals returned by sigpending() is the union of the signals pending on the process and cal-

ling thread. A signal may be pending on the process if all threads block the signal.

The set of signals returned by sigpending() is only advisory. Since other threads may be executing at

the time of the call, a signal pending on the process may be delivered to a thread after this system call

returns.

For more information regarding signals and threads, refer to signal(5).

LWP (Lightweight Processes) Considerations

The set of signals returned by sigpending() is the union of the signals pending on the process and cal-

ling LWP.

AUTHOR

sigpending() was derived from the IEEE POSIX 1003.1-1988 Standard.