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

FreeBSD Manual Pages

  
 
  

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

NAME
       tickit_watch_process  -	invoke	a callback when	a child	process	termi-
       nates

SYNOPSIS
       #include	<tickit.h>

       typedef struct {
	 pid_t pid;
	 int wstatus;
       } TickitProcessWatchInfo;

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

       void *tickit_watch_process(Tickit *t, pid_t pid,	TickitBindFlags	flags,
	   TickitCallbackFn *fn, void *user);

       Link with -ltickit.

DESCRIPTION
       tickit_watch_process() registers	a callback function to be  invoked  by
       the  toplevel  event loop when a	child process terminates. A registered
       callback	will be	invoked	by a running call to tickit_run(3).  The  info
       pointer	will  point to a structure containing the process PID and exit
       status.

       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
       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_process() returns an opaque	identifier pointer.

SEE ALSO
       tickit_new_stdio(3),	tickit_watch_io(3),	tickit_watch_timer_af-
       ter_msec(3),   tickit_watch_timer_at_epoch(3),	tickit_watch_later(3),
       tickit_watch_signal(3), tickit_watch_cancel(3), tickit(7)

						       TICKIT_WATCH_PROCESS(3)

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

home | help