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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

401

402

403

404

405

406

407

408

409

410

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 com-

pletion. 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()

were

derived from the IEEE Standard POSIX 1003.1-1988 .