TICKIT_WATCH_PROCESS(3)

💅 TICKIT_WATCH_PROCESS(3) 💅

okay bestie, so this is a page from the Library Functions Manual and it's literally called tickit_watch_process and it is SO useful, lemme tell you everything 🫶

✨ NAME ✨

tickit_watch_process — invoke a callback when a child process terminates

like. it watches your kid process. and when the kid process ✨departs this mortal coil✨ it runs your function. no cap.

🌸 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.

not me dropping the exact struct and typedef up there — copy them character for character, bestie, do NOT freestyle this part 🙈

🦋 DESCRIPTION 🦋

tickit_watch_process() registers a callback function that the toplevel event loop will invoke when a child process terminates. so like, you hand over a function, and the moment that process is done-done, the loop calls it. iconic behaviour, honestly.

A registered callback gets invoked by a running call to tickit_run(3). and the info pointer? it points to a structure holding the process PID and the exit status. so you get the receipts. 📋✨

If you registered with the TICKIT_BIND_FIRST flag, your callback gets inserted at the start of the queue — coming before the others, main character energy, front of the line 👑. If you didn't use that flag, it just gets appended at the end. lowkey humbling but fine.

If the whole thing gets cancelled by tickit_watch_cancel(3), the callback function is invoked with just the TICKIT_EV_UNBIND flag — but only if it had been registered with TICKIT_BIND_UNBIND. that's the deal, that's the contract, no notes. 💀

🌈 RETURN VALUE 🌈

tickit_watch_process() returns an opaque identifier pointer. it's giving "here's a little token, don't ask what's inside" 🎀

🎀 SEE ALSO 🎀

• tickit_new_stdio(3)
• tickit_watch_io(3)
• tickit_watch_timer_after_msec(3)
• tickit_watch_timer_at_epoch(3)
• tickit_watch_later(3)
• tickit_watch_signal(3)
• tickit_watch_cancel(3)
• tickit(7)

and that's the whole page, bestie!! 💖 this was TICKIT_WATCH_PROCESS(3) from the Library Functions Manual — go forth and watch those processes, you absolute legend ⭐🦋💜