NNG_SOCKET_PAIR(3supp)

📦 version 1.11, in alpine 3.24

💅 NNG_SOCKET_PAIR (3supp) — from the NNG Reference Manual, bestie ✨

🌸 NAME 🌸

nng_socket_pair — the glow-up that makes you a connected pair of BSD sockets 💖

🎀 SYNOPSIS 🎀

#include <nng/nng.h>

int nng_socket_pair(int fds[2]);

🦋 DESCRIPTION 🦋

okay so picture this: nng_socket_pair() literally creates a pair of connected BSD sockets for you, no cap. They come back to you in the fds array, and — this is the important part — they're suitable for use with the socket transport. slay 💅

On POSIX platforms this is just a thin wrapper around the standard socketpair() function, using the AF_UNIX family and the SOCK_STREAM socket type. iconic behavior honestly 🫶

📌 Note: rn, only POSIX platforms that implement socketpair() are supported with this function. so like… vibe check your platform first, okay? 😭
💡 Tip: this function is lowkey perfect for creating a shared connection between a parent process and a child process on UNIX platforms — and the way that it does it without requiring a shared filesystem or a TCP connection?? obsessed. 🔥

⭐ RETURN VALUES ⭐

This function returns 0 on success, and non-zero otherwise. that's it, that's the whole vibe ✨

💀 ERRORS 💀

  • NNG_ENOMEM — insufficient memory exists. not enough room bestie, it's giving full closet 😭
  • NNG_ENOTSUP — this platform does not support socket pairs. rude of it, honestly 🙈

👑 SEE ALSO 👑

go read those, iykyk 💜

mwah, that's the page — brought to you by the NNG Reference Manual, dated 2026-01-13, and yes the footer still says NNG_SOCKET_PAIR(3supp) bc we keep it accurate around here 🎀✨

📦 where this page comes from