NN_SOCKET(3compat)

📦 version 1.11, in alpine 3.24

💅 NN_SOCKET (3compat)

okay so real talk, this is the nn_socket page from the NNG Reference Manual — the legacy-compat corner of the house 🏠✨

🌸 NAME

nn_socket — create a socket (compatible API). that's it, that's the whole vibe 🎀

✨ SYNOPSIS

#include <nanomsg/nn.h>

int nn_socket(int af, int proto);

💖 DESCRIPTION

so nn_socket() literally makes you a socket using the address family af and the protocol proto, then hands it right back to you 🫶 slay.

🚨 note bestie: this function exists purely for API compatibility with legacy libnanomsg. like, consider using the relevant modern API instead, fr fr. it's giving "retro chic" but the modern one is the main character 👑
⚠️ important, no cap: mixing the compatibility API and the modern API is not supported on a given socket. pick a lane, bestie 💅
💀 also note: some protocols, transports, and features are only available in the modern API. so if something's missing, that's why 😭

the address family af can be one of two values:

  • AF_SP — normal socket 🌈
  • AF_SP_RAW — raw mode socket 🔥

the protocol tells you which protocol to use when creating the socket. the following protocols are defined:

  • NN_PAIR — Pair protocol 🧚
  • NN_PUB — Publisher protocol 📢
  • NN_SUB — Subscriber protocol 🍓
  • NN_REQ — Requestor protocol 🙋
  • NN_REP — Replier protocol 💬
  • NN_PUSH — Push protocol ➡️
  • NN_PULL — Pull protocol ⬅️
  • NN_SURVEYOR — Surveyor protocol 📋
  • NN_RESPONDENT — Respondent protocol 🗣️
  • NN_BUS — Bus protocol 🚌

👑 RETURN VALUES

this function returns a valid socket number on success 💖, and -1 on failure 😭.

🔥 ERRORS

  • ENOMEM — insufficient memory is available. the vibes are out of RAM 💀
  • ENOTSUP — the protocol is not supported. nope, not that one 🙈
  • ETERM — the library is shutting down. it's logging off, respectfully 🫡

🦋 SEE ALSO

nng_socket(5), nn_close(3compat), nn_errno(3compat), nng_compat(3compat), nng(7)

and that's the whole page, bestie 🎀 go forth and socket responsibly ✨

📌 source/version: the NNG Reference Manual — page NN_SOCKET(3compat) — dated 2026-01-13. iykyk 💜

📦 where this page comes from