ssignal(3)                 DG/UX 4.30                  ssignal(3)



     NAME
          ssignal, gsignal - software signals

     SYNOPSIS
          #include <signal.h>

          int (*ssignal (sig, action))()
          int sig, (*action)();

          int gsignal (sig)
          int sig;

     DESCRIPTION
          Ssignal and gsignal implement a software facility similar to
          signal(2).  This facility is used by the standard C library
          to let users indicate the disposition of error conditions.
          Users may also use it for their own purposes.

          Software signals made available to users are associated with
          integers in the inclusive range 1 through 15. A call to
          ssignal associates a procedure, action, with the software
          signal sig; sig is raised by a call to gsignal.  Raising a
          software signal triggers the action established for that
          signal.

          The first argument to ssignal is a number identifying the
          type of signal for which an action is to be established. The
          second argument defines the action; it is either the name of
          a user-defined action function or one of the manifest
          constants SIGDFL (default) or SIGIGN (ignore).  Ssignal
          returns the action previously established for that signal
          type; if no action has been established or the signal number
          is illegal, ssignal returns SIGDFL.

          Gsignal raises the signal identified by its argument, sig:

               If an action function has been established for sig,
               then that action is reset to SIGDFL and the action
               function is entered with argument sig.  Gsignal returns
               the value returned to it by the action function.

               If the action for sig is SIGIGN, gsignal returns the
               value 1 and takes no other action.

               If the action for sig is SIGDFL, gsignal returns the
               value 0 and takes no other action.

               If sig has an illegal value or no action was ever
               specified for sig, gsignal returns the value 0 and
               takes no other action.

     SEE ALSO



     Licensed material--property of copyright holder(s)         Page 1

     ssignal(3)                 DG/UX 4.30                  ssignal(3)



          signal(2).






















































     Licensed material--property of copyright holder(s)         Page 2