NAME

       tickit_watch_timer_at_* - invoke a callback at a fixed future time

SYNOPSIS

       #include <tickit.h>

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

       void *tickit_watch_timer_at_epoch(Tickit *t, time_t at,
           TickitBindFlags flags, TickitCallbackFn *fn, void *user);
       void *tickit_watch_timer_at_tv(Tickit *t, const struct timeval *at,
           TickitBindFlags flags, TickitCallbackFn *fn, void *user);

       Link with -ltickit.

DESCRIPTION

       The  tickit_watch_timer_at_*()  family  of  functions  register  a callback function to be
       invoked by the toplevel event loop at a fixed time in the future.  A  registered  callback
       will  be invoked by a running call to tickit_run(3). The callback function will be invoked
       once, and then destroyed afterwards. Each function returns an opaque pointer  value  which
       serves to identify this instance. The info pointer will be NULL.

       When   invoked,   the   callback   function  is  always  passed  both  TICKIT_EV_FIRE  and
       TICKIT_EV_UNBIND flags to its flags argument. If the callback had been registered with the
       TICKIT_BIND_DESTROY  flag, then it will also be invoked with the TICKIT_EV_DESTROY flag if
       it has not yet been invoked by the time the toplevel instance is destroyed.

       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_timer_at_epoch()  and  tickit_watch_timer_at_tv() return an opaque identifier
       pointer.

SEE ALSO

       tickit_new_stdio(3),       tickit_watch_timer_after_msec(3),        tickit_watch_later(3),
       tickit_watch_signal(3), tickit_watch_process(3), tickit_watch_cancel(3), tickit(7)

                                                                   TICKIT_WATCH_TIMER_AT_EPOCH(3)