NNG_LISTENER_START(3)

📦
version 1.12.0 · 4 versions
, in ubuntu stonking

✨ NNG_LISTENER_START(3) ✨

okay so bestie, this is a page from the NNG Reference Manual (that's the nng manual, section 3) and it's literally all about starting a listener. no cap. let's get into it 🫶

🌸 NAME 🌸

nng_listener_start — start a listener, babe. that's the whole job. 💅

✨ SYNOPSIS ✨

#include <nng/nng.h>

int nng_listener_start(nng_listener l, int flags);

💖 DESCRIPTION 💖

okay so nng_listener_start() starts the listener l. that's it. it's giving wake up bestie, it's time to work. ⭐

the way this works is: it makes the listener bind to the address it was created with, and then it starts accepting connections from remote dialers. every single new connection that shows up? yeah, it turns into an nng_pipe object, and that pipe gets attached to the listener's socket. iconic behavior honestly. 🦋

now the flags argument… bestie, it's ignored. like, fully ignored. it's just sitting there, reserved for future use. don't worry about it, she's not doing anything rn. 🙈

⚠️ big note: once a listener has started, it is generally not possible to change its configuration. so like, get her right before you hit start, okay? no take-backs after that. 💀

🔥 RETURN VALUES 🔥

this function returns 0 on success, and non-zero otherwise. that's the vibe check: 0 = slay, anything else = not slay. ✨

😭 ERRORS 😭

  • NNG_ECLOSED — the parameter l does not refer to an open listener. she's closed, bestie. the door is shut. 🚪
  • NNG_ESTATE — the listener l is already started. girl, she's already running. why are you starting her again? 👑

👑 SEE ALSO 👑

and that's the whole page, periodt. mwah 💋 this was from the NNG Reference Manual, dated 2026-06-30. go start that listener, bestie, you got this. 🎀🌈

📦 where this page comes from