iob_addfile(3)

💖 iob_addfile(3) — Library Functions Manual 💖

okay bestie, welcome to the iob_addfile(3) page, we're in the Library Functions Manual section and honestly this one is short and sweet, which is iconic of it. let's go ✨

🌸 NAME 🌸

iob_addfile — add file region to I/O batch

🦋 SYNTAX 🦋

#include <libowfat/iob.h>

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

💅 DESCRIPTION 💅

so the whole vibe of iob_addfile is: it schedules n bytes from the file descriptor fd, starting at offset off, to be written with the I/O batch b. that's it. that's the function. she's booked in, she'll get sent later 🎀

⚠️ do NOT close fd before iob_send indicates it's done. like, for real. not a drill. that's the one rule and she's strict about it 💀

and if you're sitting there thinking "girl, I want that file descriptor to be closed automatically by iob_reset" — then you want iob_addfile_close instead. use that one. slay 🌈

⭐ RETURN VALUE ⭐

• returns 1 on success 🫶
• returns 0 on failure 😭

👑 SEE ALSO 👑

• iob_reset(3)
• iob_send(3)
• iob_addbuf(3)
• iob_addfile_close(3)

okay that's the whole page, no cap 💜 it's from the Library Functions Manual and the footer is literally just the page title again — iob_addfile(3) — so consider this your little sign-off, mwah, go schedule your file regions responsibly 🧚💖