NNG_LISTENER_CREATE(3)

💖 NAME 💖

okay so bestie, nng_listener_create — it makes you a listener ✨ that's the whole vibe

---

🌸 SYNOPSIS 🌸

#include <nng/nng.h>

int nng_listener_create(nng_listener *listenerp, nng_socket s, const char *url);

---

🎀 DESCRIPTION 🎀

so nng_listener_create() literally hands you a brand new, freshly initialized nng_listener object 🦋 — it's tied to the socket s, it's all set up to listen at the address you gave it in url, and it drops a pointer to that listener right where listenerp points. periodt.

what are listeners for, you ask? 👑 they accept connections that remote dialers start. when a connection comes in, that generally means a pipe gets created and attached to socket s. and here's the iconic part: unlike dialers, listeners can generally make, like, so many pipes — and they can all be open at the same time. main character energy fr fr 🌈

✨ tip ✨ it's comfy to think of listeners as "the servers", but ngl — the listener/dialer thing is orthogonal to whatever server-or-client status a given protocol has. like, a req socket might have dialers, but it might also have listeners. it could even have some of each at the same time 💅 the vibes are flexible, iykyk.

so the listener is not started yet — not even a little. but you can keep configuring it with the nng_listener_setopt() family of functions 🫶

once it's fully configured and cute, you start it with nng_listener_start(). 🚀

💜 tip — if you don't need any specific configuration at all, maybe just use the simpler nng_listen() function instead? it's giving low-effort, high-reward 🍓

---

⭐ RETURN VALUES ⭐

• 0 — slay, success 💖
• non-zero — not slay, something went wrong 😭

---

💀 ERRORS 💀

• NNG_EADDRINVAL — the url you gave was invalid. not it. 🙈
• NNG_ECLOSED — socket s is not open. bestie she's closed 💀
• NNG_ENOMEM — not enough memory available. the brain cell is empty 😭

---

🦋 SEE ALSO 🦋

• nng_dialer_create(3)
• nng_listen(3)
• nng_listener_close(3)
• nng_listener_getopt(3)
• nng_listener_setopt(3)
• nng_listener_start(3)
• nng_strerror(3)
• nng_listener(5)
• nng(7)

---

and that's the whole page, bestie 🎀 this was the NNG_LISTENER_CREATE(3) page from the NNG Reference Manual, dated 2026-06-30 — go build something iconic with it ✨💅👑