TICKIT_WATCH_TIMER_AT_EPOCH(3)

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 *user);

    void *tickit_timer_at_epoch(Tickit *t, time_t at,
        TickitBindFlags flags, TickitCallbackFn *fn, void *user);
    void *tickit_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.

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.

RETURN VALUE
tickit_timer_at_epoch() and tickit_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_cancel(3), tickit(7)