NAME

       stCatchSigs,  stInterruptAction,  stQuitAction,  stTermAction,  stCleanup, stExit - signal
       handling

SYNOPSIS

       #include <config.h>
       #include <sttk.h>

       void stCatchSigs (void);

       Sfunc_t(*stInterruptAction)();

       Sfunc_t(*stQuitAction)();

       Sfunc_t(*stTermAction)();

       void stCleanup (void);

       void stExit (int exitCode);

DESCRIPTION

       stCatchSigs activates a number of interrupt handlers, defined internally in the ShapeTools
       toolkit  library.  Interrupt handlers are defined for the signals SIGINT, SIGQUIT, SIGFPE,
       SIGBUS, SIGSEGV, and SIGTERM.  All interrupt handlers, except the one  for  SIGINT,  cause
       program  termination after having done some cleanup work. The cleanup consists of removing
       all temporary files by calling stRmRegisteredFiles(3).

       Some of the signal handlers are capable to execute functions defined by  the  application,
       while handling the interrupt. This mechanism is activated by assigning a functions address
       to the appropriate variable. The following is a complete List.

       Signal  Variable

       SIGINT  stInterruptAction

       SIGQUIT
               stQuitAction

       SIGTERM
               stTermAction

       stCleanup calls stRmRegisteredFiles(3) to remove all temporary files and the AtFS function
       af_cleanup(3) that orders AtFS's affairs.

       stExit  does  the  same  as stCleanup and additionally end the program execution returning
       exitCode.

SEE ALSO

       signal (3), stRmRegisteredFiles(3), af_cleanup(3).