io_timeouted(3)

💖 io_timeouted(3) — like, the timeout check-in page 💖

okay bestie, so this is a page from the Library Functions Manual and it's all about io_timeouted(3), one lil function that goes and finds your overdue file descriptors for you. she's giving hall monitor energy but in a cute way 🎀

✨ NAME ✨

io_timeouted — return a file descriptor over deadline 🕐

🌸 SYNTAX 🌸

#include <libowfat/io.h>

int64 io_timeouted();

literally that's it. one include, one call, no arguments, we love a low-maintenance icon 👑

🦋 DESCRIPTION 🦋

so here's the tea ☕ io_timeouted returns the next file descriptor that is past it's deadline. like, the one that's late, the one that ghosted its own timer, that one 📅

and if no descriptors are past their deadlines? she returns -1. no drama, just -1 💀

okay this next part MATTERS, bestie, don't skip it 🙈

after io_timeouted() has returned -1, you should wait a second before calling it again. like, actually pause. breathe. touch some grass 🌱

why tho? because checking for connections past their deadline involves walking through the whole data structure 🚶♀️ and that can thrash the CPU cache needlessly. no cap. it's giving expensive. so treat it as an expensive operation — because it literally is one 💸

💅 SEE ALSO 💅

• io_wait(3)
• io_timeout(3)

go read those too, they're the besties of this page fr fr 🫶

and that's the whole vibe, my love 💜 this was io_timeouted(3) from the Library Functions Manual — that's the footer, that's the sign-off, and yes she really does appear on both the top and the bottom of the page because she's the main character of her own manpage ✨ periodt 💖