POSIX Signal Handling

Synopsis


#include <libxfce4util/libxfce4util.h>

void                (*XfcePosixSignalHandler)           (gint signal,
                                                         gpointer user_data);
gboolean            xfce_posix_signal_handler_init      (GError **error);
void                xfce_posix_signal_handler_restore_handler
                                                        (gint signal);
gboolean            xfce_posix_signal_handler_set_handler
                                                        (gint signal,
                                                         XfcePosixSignalHandler handler,
                                                         gpointer user_data,
                                                         GError **error);
void                xfce_posix_signal_handler_shutdown  (void);

Description

Details

XfcePosixSignalHandler ()

void                (*XfcePosixSignalHandler)           (gint signal,
                                                         gpointer user_data);

`signal` :
`user_data` :

xfce_posix_signal_handler_init ()

gboolean            xfce_posix_signal_handler_init      (GError **error);

Initializes the POSIX signal handler system. Must be called before setting any POSIX signal handlers.

`error` :	Location of a GError to store any possible errors.
Returns :	`TRUE` on success, `FALSE` on failure, in which case `error` will be set.

xfce_posix_signal_handler_restore_handler ()

void                xfce_posix_signal_handler_restore_handler
                                                        (gint signal);

Restores the default handler for signal.

signal :

xfce_posix_signal_handler_set_handler ()

gboolean            xfce_posix_signal_handler_set_handler
                                                        (gint signal,
                                                         XfcePosixSignalHandler handler,
                                                         gpointer user_data,
                                                         GError **error);

Sets handler to be called whenever signal is caught by the application. The user_data parameter will be passed as an argument to handler.

`signal` :
`handler` :	A callback function.
`user_data` :	Arbitrary data that will be passed to `handler`.
`error` :	Location of a GError to store any possible errors.
Returns :	`TRUE` on success, `FALSE` otherwise, in which case `error` will be set.

xfce_posix_signal_handler_shutdown ()

void                xfce_posix_signal_handler_shutdown  (void);

Frees all memory associated with the POSIX signal handling system and restores all default signal handlers.

			libxfce4util Reference Manual
Top \| Description