NAME

       tickit_watch_signal - invoke a callback when a POSIX signal is raised

SYNOPSIS

       #include <tickit.h>

       typedef int TickitCallbackFn(Tickit *t, TickitEventflags flags,
           void *info, void *user);

       void *tickit_watch_signal(Tickit *t, int signum, TickitBindFlags flags,
           TickitCallbackFn *fn, void *user);

       Link with -ltickit.

DESCRIPTION

       tickit_watch_signal() registers a callback function to be invoked by the toplevel event loop when a POSIX
       signal  is  received  by  the  process.  A  registered  callback  will  be  invoked  by a running call to
       tickit_run(3). The callback function may be invoked more than once, if the signal  is  received  multiple
       times. The info pointer will be NULL.

       Multiple  registrations  may be made for the same signal number; when that signal is received all of them
       will be invoked in the order they exist in the queue. If registered with the TICKIT_BIND_FIRST flag,  the
       callback  will be inserted at the start of the queue, coming before others. If not, it is appended at the
       end.

       If cancelled by tickit_watch_cancel(3) the callback function is invoked with  just  the  TICKIT_EV_UNBIND
       flag if it had been registered with TICKIT_BIND_UNBIND.

RETURN VALUE

       tickit_watch_signal() returns an opaque identifier pointer.

SEE ALSO

       tickit_new_stdio(3),                 tickit_watch_io(3),                tickit_watch_timer_after_msec(3),
       tickit_watch_timer_at_epoch(3), tickit_watch_later(3),  tickit_watch_process(3),  tickit_watch_cancel(3),
       tickit(7)

                                                                                          TICKIT_WATCH_SIGNAL(3)