Create a #GSource that will be dispatched upon delivery of the UNIX
signal signum. In GLib versions before 2.36, only SIGHUP, SIGINT,
SIGTERM can be monitored. In GLib 2.36, SIGUSR1 and SIGUSR2
were added. In GLib 2.54, SIGWINCH was added.
Note that unlike the UNIX default, all sources which have created a
watch will be dispatched, regardless of which underlying thread
invoked glib.global.unixSignalSourceNew.
For example, an effective use of this function is to handle SIGTERM
cleanly; flushing any outstanding files, and then calling
glib.main_loop.MainLoop.quit. It is not safe to do any of this from a regular
UNIX signal handler; such a handler may be invoked while malloc() or
another library function is running, causing reentrancy issues if the
handler attempts to use those functions. None of the GLib/GObject
API is safe against this kind of reentrancy.
The interaction of this source when combined with native UNIX
functions like sigprocmask() is not defined.
The source will not initially be associated with any #GMainContext
and must be added to one with glib.source.Source.attach before it will be
executed.
Create a #GSource that will be dispatched upon delivery of the UNIX signal signum. In GLib versions before 2.36, only SIGHUP, SIGINT, SIGTERM can be monitored. In GLib 2.36, SIGUSR1 and SIGUSR2 were added. In GLib 2.54, SIGWINCH was added.
Note that unlike the UNIX default, all sources which have created a watch will be dispatched, regardless of which underlying thread invoked glib.global.unixSignalSourceNew.
For example, an effective use of this function is to handle SIGTERM cleanly; flushing any outstanding files, and then calling glib.main_loop.MainLoop.quit. It is not safe to do any of this from a regular UNIX signal handler; such a handler may be invoked while malloc() or another library function is running, causing reentrancy issues if the handler attempts to use those functions. None of the GLib/GObject API is safe against this kind of reentrancy.
The interaction of this source when combined with native UNIX functions like sigprocmask() is not defined.
The source will not initially be associated with any #GMainContext and must be added to one with glib.source.Source.attach before it will be executed.