HP-UX Reference (11i v1 05/09) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

361

362

363

364

365

366

367

368

369

370

sigsetops(3C) sigsetops(3C)

NAME

sigemptyset(), sigﬁllset(), sigaddset(), sigdelset(), sigismember( ) - initialize, manipulate, and test signal

sets

SYNOPSIS

#include <signal.h>

int sigemptyset(sigset_t *set);

int sigfillset(sigset_t *set);

int sigaddset(sigset_t *set, int signo);

int sigdelset(sigset_t *set, int signo);

int sigismember(const sigset_t *set, int signo);

DESCRIPTION

sigemptyset()

initializes the signal set pointed to by set, to exclude all signals supported by HP-UX.

sigfillset() initializes the signal set pointed to by set, to include all signals supported by HP-UX.

Applications must call either sigemptyset()

or sigfillset() at least once for each object of type

sigset_t before using that object for anything else, including cases where the object is returned from a

function (for example, the oset argument to sigprocmask()

— see sigprocmask(2)).

sigaddset() adds the signal speciﬁed by signo to the signal set pointed to by set.

sigdelset() deletes the signal speciﬁed by signo from the signal set pointed to by set.

sigismember() tests whether the signal speciﬁed by signo is a member of the signal set pointed to by

set.

RETURN VALUE

Upon successful completion,

sigismember()

returns a value of 1 if the speciﬁed signal is a member of

the speciﬁed set, or a value of

0 if it is not. The other functions return a value of

0 upon successful comple-

tion. For all of the above functions, if an error is detected, a value of

-1 is returned and errno is set to

indicate the error.

ERRORS

sigaddset() , sigdelset() , and sigismember()

fail if the following is true:

[EINVAL] The value of the signo argument is out of range.

WARNINGS

The above functions do not detect a bad address passed in for the set argument. A segmentation fault is the

most likely result.

AUTHOR

sigfillset() , sigemptyset(), sigaddset()

, sigdelset() , and sigismember() are

derived from the IEEE Standard POSIX 1003.1-1988.