sigpending(2)                                          sigpending(2)


       NAME
             sigpending - examine signals that are blocked and pending

       SYNOPSIS
             #include <signal.h>
             int sigpending(sigset_t *set);

       DESCRIPTION
             The sigpending function retrieves those signals that have been
             sent to the calling process but are being blocked from
             delivery by the calling process's signal mask.  The signals
             are stored in the space pointed to by the argument set.

          Return Values
             On success, sigpending returns 0.  On failure, sigpending
             returns -1 and sets errno to identify the error.

          Errors
             In the following conditions, sigpending fails and sets errno
             to:

             EFAULT         The set argument points outside the process's
                            allocated address space.

       REFERENCES
             sigaction(2), sigprocmask(2), sigsetops(3C)

       NOTICES
          Considerations for Threads Programming
             The set returned is the union of

                   Signals pending to the calling thread but blocked by
                   that thread's signal mask.

                   Signals pending to the process but blocked by every
                   currently running thread in the process.

             In general, the status from sigpending is only advisory.  A
             signal pending to the containing process might be delivered to
             a sibling thread (if any become eligible) after the return of
             this system call.  See signal(5) for further details.

          Considerations for Lightweight Processes
             In terms of LWPs, the set returned is the union of




                           Copyright 1994 Novell, Inc.               Page 1

      sigpending(2)                                          sigpending(2)


                  Signals pending to the calling LWP but blocked by that
                  LWP's signal mask.

                  Signals pending to the process but blocked by every LWP
                  contained in the process.











































                          Copyright 1994 Novell, Inc.               Page 2