GSource that will be dispatched upon delivery of the UNIX
signum. In GLib versions before 2.36, only
SIGTERM can be monitored. In GLib 2.36,
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
For example, an effective use of this function is to handle
cleanly; flushing any outstanding files, and then calling
g_main_loop_quit (). It is not safe to do any of this a regular
UNIX signal handler; your handler may be invoked while
another library function is running, causing reentrancy if you
attempt to use it from the handler. None of the GLib/GObject API
is safe against this kind of reentrancy.
The interaction of this source when combined with native UNIX
sigprocmask() is not defined.
The source will not initially be associated with any
and must be added to one with
g_source_attach() before it will be executed.
A newly created
|The caller of the function takes ownership of the data, and is responsible for freeing it.|