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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

421

422

423

424

425

426

427

428

429

430

sigsetmask(2) sigsetmask(2)

(TO BE OBSOLETED)

NAME

sigsetmask() - set current signal mask

SYNOPSIS

#include <signal.h>

long sigsetmask(long mask);

DESCRIPTION

sigsetmask() sets the current signal mask (those signals that are blocked from delivery). Signal i is

blocked if the i-th bit in mask, as speciﬁed with the macro

sigmask(i),isa1.

It is not possible to mask signals that cannot be ignored, as documented in signal(5); this restriction is

silently imposed by the system.

sigblock() can be used to add elements to the set of blocked signals.

RETURN VALUE

The previous set of masked signals is returned.

EXAMPLES

The following call to sigsetmask() causes only the SIGUSR1 and SIGUSR2 signals to be blocked:

long oldmask;

oldmask = sigsetmask (sigmask (SIGUSR1) | sigmask (SIGUSR2));

WARNINGS

Do not use sigsetmask() in conjunction with the facilities described under sigset(3C).

Obsolescent Interfaces

sigsetmask() is to be obsoleted at a future date.

APPLICATION USAGE

Threads Considerations

Since each thread maintains its own blocked signal mask, sigsetmask() modiﬁes only the calling

thread’s blocked signal mask.

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

LWP (Lightweight Processes) Considerations

sigsetmask() modiﬁes only the calling LWP’s blocked signal mask.

LP64 Programs

sigsetmask() accepts and returns long (64 bit) values. However, as for ILP32 programs, sigset-

mask()

supports signals numbered 1 through 32. The upper 32 bits of the mask argument are ignored.

Also, the upper 32 bits of the returned mask have no meaning.

AUTHOR

sigsetmask() was developed by the University of California, Berkeley.