NNG_SOCKET_PROTO_NAME(3)

✨ NNG_SOCKET_PROTO_NAME ✨

okay bestie, gather round, because we're talking about nng_socket_proto_name(3) from the NNG Reference Manual 💜 — it's short, it's sweet, and it's lowkey one of the most useful little utilities in the whole library, no cap.

---

🌸 NAME 🌸

nng_socket_proto_name — obtain the socket protocol name 💅

---

🦋 SYNOPSIS 🦋

#include <nng/nng.h>

int nng_socket_proto_name(nng_socket s, const char **name);
int nng_socket_peer_name(nng_socket s, const char **name);

---

🎀 DESCRIPTION 🎀

so here's the tea ☕ — these two functions go and store the protocol name of either the socket s, or its natural peer, right into name. that's it. that's the whole job. main character energy, honestly. ✨

📌 Note — the string value you get back from these functions is statically stored as part of the program text. so like… do NOT free it and do NOT modify it, bestie 😭 it's not yours to touch, it lives there now, it's iconic, leave it be. 🙈

💡 Tip — in new code, you should be using these functions instead of the NNG_OPT_PROTONAME and NNG_OPT_PEERNAME options. like, the options are still there, but this is the moment. the glow-up. use the functions. 🫶

---

⭐ RETURN VALUES ⭐

they return zero on success 🎉 — or an error if the socket is invalid, which is giving "we don't know her" 💀

---

💀 ERRORS 💀

• NNG_ECLOSED — parameter s does not refer to an open socket. so either you closed it, or it was never real to begin with 🫠

---

🌈 SEE ALSO 🌈

• nng_socket(5)
• nng(7)

---

and that's the whole page, bestie! 🎀 this was the NNG Reference Manual edition of NNG_SOCKET_PROTO_NAME(3), dated 2026-06-30 ⭐ go forth and get those protocol names, you absolute icon 👑💖