Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
TICKIT_WAT...ER_AT_EPOCH(3) Library Functions Manual TICKIT_WAT...ER_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 *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 func-
     tion  to  be  invoked by the toplevel event loop at a fixed time in the fu-
     ture.  A  registered  callback  will  be  invoked	by  a  running	call  to
     tickit_run(3).  The  callback  function  will be invoked once, and then de-
     stroyed 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_WAT...ER_AT_EPOCH(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tickit_watch_timer_at_epoch&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help