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).