io_socketpair(3)

💖 io_socketpair — create a pair of sockets 💖

okay bestie, so this is io_socketpair from the <libowfat/io.h> era of your life (page 3 of the Library Functions Manual, she's fancy) and she is here to hand you two sockets that are already besties with each other. no cap.

✨ SYNTAX ✨

#include <libowfat/io.h>

int io_socketpair(int64 pfd[2]);

🌸 DESCRIPTION 🌸

okay so here's the tea: io_socketpair creates a brand new UNIX socket pair and writes both descriptors to d. that's it, that's the job. 💅

and the way this socket pair works?? it's giving pipe energy, but make it bidirectional — meaning both descriptors are for reading and writing. so they can talk back and forth, mutual, no one-sided situationships here. it's giving healthy communication for once 😭🫶

now for the important part, the vibe check on return values:

• io_socketpair returns 1 to indicate success ✨ iconic, ate, no notes.
• if something goes wrong, it returns 0 and sets errno to indicate the error 😔 in that case it frees any memory that it allocated for the new socketpair, and it leaves d alone. like, it cleans up after itself and does NOT touch your stuff. respectful king behavior honestly.

lowkey crucial: 0 means failure and errno has the lore. don't be out here ignoring that, bestie.

👀 SEE ALSO 👀

the girlies you should also be reading:

• io_readfile(3)
• io_createfile(3)
• io_pipe(3)

k that's the whole page, you're literally a socket pair expert now 🎀 stay hydrated, close your file descriptors, and remember — this was io_socketpair(3) from the Library Functions Manual, mwah 💋💖✨🦋