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

  
 
  

home | help
TICKIT_WATCH_LATER(3)	    Library Functions Manual	   TICKIT_WATCH_LATER(3)

NAME
     tickit_watch_later - invoke a callback at the next round of IO events

SYNOPSIS
     #include <tickit.h>

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

     void *tickit_watch_later(Tickit *t, TickitBindFlags flags,
	 TickitCallbackFn *fn, void *user);

     Link with -ltickit.

DESCRIPTION
     tickit_watch_later()  registers  a  callback  function to be invoked by the
     toplevel event loop as it processes the next round of IO events.  A  regis-
     tered  callback  will  be	invoked  by a running call to tickit_run(3). The
     callback function will be invoked once, and then destroyed afterwards.  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  registered  with  the	TICKIT_BIND_FIRST flag, the callback will be in-
     serted at the start of the queue, coming before others. If not, it  is  ap-
     pended 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_later() 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_signal(3),
     tickit_watch_process(3), tickit_watch_cancel(3), tickit(7)

							   TICKIT_WATCH_LATER(3)

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

home | help