io_passfd(3)

💅 io_passfd(3) — bestie edition

ok so this is a page from the Library Functions Manual, and the star of the show is io_passfd(3). pull up a chair 🫶

✨ NAME ✨

io_passfd — slide a whole file descriptor across a Unix Domain socket like it's a note in class 💌

🌸 SYNTAX 🌸

#include <libowfat/io.h>

int io_passfd(int64 sock,int64 fd);

🦋 DESCRIPTION 🦋

okay bestie, listen. io_passfd transfers the file descriptor fd over the Unix Domain socket sock. that's the whole vibe. 🔥

and like… it works much like dup(2), except the plot twist is that the copy of the descriptor does not show up in this process. nope. it appears at the other end of the Unix Domain socket instead. which means that other end has to be a process on the same system. no long-distance relationships here, sorry 💀

the peer over there can then use io_receivefd(3) to receive the file descriptor. iconic teamwork, no cap. 👑

⚠️ important bestie note: the passed descriptor stays open in the sending process. it does not get closed on your end. so don't be out here acting surprised when it's still hanging around, okay? 😭

🎀 RETURN VALUE 🎀

• io_passfd returns 0 on success 💖
• -1 on error, and it sets errno accordingly 🙈

that's it, that's the whole deal.

🌈 SEE ALSO 🌈

• io_receivefd(3) — the other half of the friendship, the one who catches what you threw 💜

made with love, from the Library Functions Manual, page io_passfd(3) — mwah 💅✨