NNG_PUB(7)

✨ NNG_PUB(7) — the pub protocol, bestie edition ✨

okay so this is nng_pub, straight out of the NNG Reference Manual 💅 (yes the manual page is literally called NNG_PUB(7), we're fancy like that)

---

🎀 NAME 🎀

nng_pub — the publisher protocol, aka the one who does all the talking 📢

---

🌸 SYNOPSIS 🌸

#include <nng/protocol/pubsub0/pub.h>

that's it, that's the whole vibe. go forth and publish 💖

---

🦋 DESCRIPTION 🦋

so pub is literally one half of the publisher/subscriber pattern — a dynamic duo, main character energy fr fr 👑

in this pattern, a publisher sends data, which gets broadcast to all subscribers. meanwhile the subscribing apps only see the data they actually subscribed to. so they're getting the filtered feed, not the firehose, periodt ✨

the pub protocol is the publisher side, and the sub protocol is the subscriber side. two halves of one iconic whole 🫶

Note 📌 In this implementation, the publisher delivers all messages to all subscribers. The subscribers maintain their own subscriptions, and filter them locally. Thus, this pattern should not be used in an attempt to reduce bandwidth consumption. not me exposing that we broadcast everything anyway 😭 it's giving "everyone gets the text, you just choose whether to read it" 💀

the topics that subscribers subscribe to is just the first part of the message body. so like, applications should construct their messages accordingly — build them with that in mind, bestie 🧚

🔥 Socket Operations 🔥

the nng_pub0_open() function(s) create a publisher socket. this socket may be used to send messages, but it is unable to receive them. and if you try to receive anyway? you get NNG_ENOTSUP 🙈 it literally cannot and will not, sorry babe

⭐ Protocol Versions ⭐

only version 0 of this protocol is supported. (at the time of writing, no other versions of this protocol have been defined.) so v0 or nothing, iykyk 💅

🌈 Protocol Options 🌈

the pub protocol has no protocol-specific options. zero. none. clean slate, no notes 🎀

💜 Protocol Headers 💜

the pub protocol has no protocol-specific headers. also none. the bare-faced, no-makeup look of protocols honestly 🦋

---

👑 SEE ALSO 👑

• nng_pub_open(3)
• nng_sub(7)
• nng(7)

---

and that's the whole page, bestie!! mwah 💋 this one's from the NNG Reference Manual, dated 2026-06-30 — go slay some messages ✨💖