io_timeout(3)

✨ NAME ✨

io_timeout — set a time limit on a descriptor ⏰💅

🎀 SYNTAX 🎀

#include <libowfat/io.h>

void io_timeout(int64 fd,tai6464 deadline);

🦋 DESCRIPTION 🦋

okay so listen, bestie 🫶 the io library is out here keeping track of an optional "timeout" for every single descriptor. and a timeout isn't like, a countdown in seconds or whatever — it's a very specific moment in time, and it lives in a tai6464 variable. so fancy, so precise, we love that for us ✨

io_timeout(d,t) just sets the timeout for descriptor d to t. that's it. that's the whole job. queen behavior, honestly 👑

and here's the part where she has no return value — she always succeeds, no cap. the space to store that timeout was already allocated as part of the descriptor, so there's literally nothing that can go wrong here. 💀

also! if d is not the number of a descriptor, this function just has no effect. no error, no drama, just nothing. it's giving unbothered 🌸

but wait, there's a catch bestie 😭 — setting a timeout does not magically notify you when it happens. you have to call io_timeouted to actually get notified about timeouts, just like you're calling io_canread or io_canwrite for read and write notification. same energy, different function. iykyk 💫

👑 SEE ALSO 👑

• io_waituntil(3)
• io_timeouted(3)

and that's the whole page, bestie, you ate it up 🍓✨ that was io_timeout(3) coming to you straight from the Library Functions Manual — mwah, xoxo, go set some deadlines 💖🎀🦋