Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought



     SIGSET(S)                 UNIX System V                 SIGSET(S)



     Name
          sigset - manipulate signal sets

     Syntax
          #include <signal.h>

          int sigemptyset (set)
          sigset_t *set;

          int sigfillset (set)
          sigset_t *set;

          int sigaddset (set)
          sigset_t *set;
          int signo;

          int sigdelset (set)
          sigset_t *set;
          int signo;

          int sigismember (set)
          sigset_t *set
          int signo;

     Description
          The sigsetops primitives manipulate sets of signals.  The
          operate on data objects addressable by the application, not
          on any set of signals known to the system, such as the set
          blocked from delivery to a process or the set pending for a
          process (see signal(S).)

          The sigemptyset() function initializes the signal set
          pointed to by the argument set, such that all signals are
          excluded.

          The sigfillset() function initializes the signal set pointed
          to by the argument set, such that all signals are included.

          Applications call either sigemptyset() or sigfullset() at
          least once for each object of type sigset_t prior to any use
          of that object.  If such an object is not initialized in
          this way, but is nonetheless supplied as an argument to any
          of the sigaddset(), sigdelset(), sigismember(), sigaction(),
          sigprocmask(), sigpending(), or sigsuspend() functions, the
          result is undefined.

          The sigaddset() and sigdelset() functions respectively add
          and delete the individual signal specified by the value of
          the argument signo from the signal set pointed to by the
          argument set.

          The sigismember() function tests whether the signal
          specified by the value of the argument signo is a member of
          the set pointed to by the argument set .

     Return Value
          Upon successful completion, the sigismember() function
          retains a value of one if the specified signal is a member
          of the specified set, or a value of zero if it is not.  Upon
          successful completion, the other functions return a value of
          zero.  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.

     See Also
          sigaction(S), signal(S)

     Diagnostics
          For each of the following conditions, if the condition is
          detected, the sigaddset(), sigdelset(), and sigismember()
          functions return a -1 and set errno to the corresponding
          value:

          [EINVAL]  The value of the signal argument is an invalid or
                    unsupported signal number.

     Standards Conformance
          sigset is conformant with:
          AT&T SVID Issue 2, Select Code 307-127.

                                             (printed 6/20/89)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026