io_receivefd(3)

io_receivefd 💌

okay bestie, so this one's from the Library Functions Manual — yes we're reading man pages for fun now, it's giving study date energy 🎀

✨ NAME ✨

io_receivefd — receive a file descriptor over a Unix Domain socket 🫶

like, somebody slid a whole fd into your DMs. except the DMs are a Unix Domain socket. iykyk.

🌸 SYNTAX 🌸

#include <libowfat/io.h>

int64 io_receivefd(int64 sock);

💖 DESCRIPTION 💖

so io_receivefd receives a file descriptor from the Unix Domain socket called sock. the way that a file descriptor can just... travel through a socket... iconic behavior honestly 💅

and if you wanna be the one doing the sending? that's a whole other function, bestie — you send a descriptor using io_passfd(3). it's giving pen pals. it's giving "here, hold this fd for me" 🦋

heads up: io_receivefd returns -1 on error, or the file descriptor if it worked. that's the whole vibe check — -1 means we're in our flop era, anything else is your new fd ✨

okay and now the messy part 🙈 the underlying Unix API is lowkey extra and can send more than one descriptor at the time. this function? it expects only one descriptor. so if more than one got sent, it will return the first one and just... not address the rest. no cap, that's the behavior. so don't come crying to me about the other fds, they're still in the socket's inbox 💀

🎀 SEE ALSO 🎀

• io_passfd(3) — the sender half of this situationship 💞

that's the whole page, bestie!! go forth and receive your file descriptors responsibly 🌈

— from the Library Functions Manual, filed under io_receivefd(3), mwah 💋