sigsetmask(2)                                                 sigsetmask(2)
                               TO BE OBSOLETED



 NAME    [Toc]    [Back]
      sigsetmask - set current signal mask

 SYNOPSIS    [Toc]    [Back]
      #include <signal.h>

      long sigsetmask(long mask);

 DESCRIPTION    [Toc]    [Back]
      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 specified with the macro sigmask(i), is a 1.

      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    [Toc]    [Back]
      The previous set of masked signals is returned.

 EXAMPLES    [Toc]    [Back]
      The following call to sigsetmask() causes only the SIGUSR1 and SIGUSR2
      signals to be blocked:

           long oldmask;

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

 WARNINGS    [Toc]    [Back]
      Do not use sigsetmask() in conjunction with the facilities described
      under sigset(3C).

    Obsolescent Interfaces    [Toc]    [Back]
      sigsetmask() is to be obsoleted at a future date.

 APPLICATION USAGE    [Toc]    [Back]
    Threads Considerations
      Since each thread maintains its own blocked signal mask, sigsetmask()
      modifies only the calling thread's blocked signal mask.

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

    LWP (Lightweight Processes) Considerations    [Toc]    [Back]
      sigsetmask() modifies only the calling LWP's blocked signal mask.

    LP64 Programs    [Toc]    [Back]
      sigsetmask() accepts and returns long (64 bit) values.  However, as
      for ILP32 programs, sigsetmask() supports signals numbered 1 through



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 sigsetmask(2)                                                 sigsetmask(2)
                               TO BE OBSOLETED



      32.  The upper 32 bits of the mask argument are ignored.  Also, the
      upper 32 bits of the returned mask have no meaning.

 AUTHOR    [Toc]    [Back]
      sigsetmask() was developed by the University of California, Berkeley.

 SEE ALSO    [Toc]    [Back]
      kill(2), sigblock(2), sigpause(3C), sigprocmask(2), sigvector(2).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003