iob_addfile_close(3)

💖 iob_addfile_close — from the libowfat crew, section 3 of the Library Functions Manual 💖

okay bestie, buckle up, we're doing a syscall-adjacent glow-up 🦋

✨ NAME ✨

iob_addfile_close — add a file region to your I/O batch 🎀

✨ SYNTAX ✨

#include <libowfat/iob.h>

int iob_addfile_close(io_batch* b,int64 fd,uint64 off,uint64 n);

✨ DESCRIPTION ✨

so basically iob_addfile_close is the queen who schedules n bytes from the file descriptor fd, starting at offset off, to be written with the I/O batch b. she's putting it on the calendar, not doing it right this second. main character scheduling energy 👑

🚨 IMPORTANT, NO CAP: you may not close fd before iob_send indicates it is done. do NOT do it. the vibe check will fail and you will be sad 😭

also, heads up: iob_reset will call io_close(fd). so the cleanup is handled, but like… on iob_reset's terms, iykyk 💅

✨ RETURN VALUE ✨

• 1 — success, slay, we ate ✨
• 0 — failure. and in the failure case, the file descriptor has been closed already. so like, don't double-close it, that's a whole thing 💀

✨ SEE ALSO ✨

• iob_reset(3)
• iob_send(3)
• iob_addbuf(3)
• iob_addfile(3)

go read them, they're all part of the same little friend group 🫶

and that's the whole page, bestie!! this one lives in the Library Functions Manual, section 3, and the footer at the bottom is just iob_addfile_close(3) echoing the name back at you like a little mirror selfie 🪞 — no version number, no date, just vibes and a (3). stay batched, stay unclosed-until-iob_send-says-so, and drink some water 🍓🧚💜