gimpsignal3LIBGIMPBASE LibrarygimpsignalPortable signal handling.Synopsis
void (*GimpSignalHandlerFunc) (gint signum);
GimpSignalHandlerFunc gimp_signal_private (gint signum,
GimpSignalHandlerFunc handler,
gint flags);
Description
Portable signal handling.
DetailsGimpSignalHandlerFunc ()GimpSignalHandlerFuncvoid (*GimpSignalHandlerFunc) (gint signum);
A prototype for signal handler functions. Note that each function which
takes or returns a variable of this type also accepts or may return
special values defined by your system's signal.h header file (like
SIG_DFL or SIG_IGN).
signum :The number of the signal. Useful if different signals are handled
by a single handler.
gimp_signal_private ()gimp_signal_privateGimpSignalHandlerFunc gimp_signal_private (gint signum,
GimpSignalHandlerFunc handler,
gint flags);
This function furnishes a workalike for signal(2) but
which internally invokes sigaction(2) after certain
sa_flags are set; these primarily to ensure restarting
of interrupted system calls. See sigaction(2) It is a
aid to transition and not new development: that effort
should employ sigaction directly. [gosgood 18.04.2000]
Cause handler to be run when signum is delivered. We
use sigaction(2) rather than signal(2) so that we can control the
signal handler's environment completely via flags: some signal(2)
implementations differ in their sematics, so we need to nail down
exactly what we want. [austin 06.04.2000]signum : Selects signal to be handled see man 5 signal (or man 7 signal)
handler : Handler that maps to signum. Invoked by O/S.
Handler gets signal that caused invocation. Corresponds
to the sa_handler field of the sigaction struct.
flags : Preferences. OR'ed SA_<xxx>. See man sigaction. Corresponds
to the sa_flags field of the sigaction struct.
Returns : A reference to the signal handling function which was
active before the call to gimp_signal_private().
See Also
signal(2), signal(5 or 7), sigaction(2).