NNG_PULL(7)

📦
version 1.12.0 · 4 versions
, in ubuntu stonking

💅 nng_pull — the pull protocol, explained by your fave ✨

okay bestie, come sit with me, we're talking nng_pull from the NNG Reference Manual and honestly? it's giving main character energy for load balancers. 🫶

🌈 SYNOPSIS 🌈

#include <nng/protocol/pipeline0/pull.h>

🦋 DESCRIPTION 🦋

so. the pull protocol is one half of a pipeline pattern. the other half? that's the push protocol. they're a duo, they're inseparable, they're the brangelina of messaging patterns. 💖

here's the vibe: in the pipeline pattern, pushers distribute messages to pullers. every single message a pusher sends goes to one of its peer pullers — picked round-robin style from the set of connected peers that are available for receiving. and the way that just naturally spreads the work around?? obsessed. that's literally why this pattern is so useful in load-balancing scenarios. 👑

🔥 Socket Operations 🔥

the nng_pull0_open() functions create a puller socket. this socket may be used to receive messages, but it is unable to send them. no cap.

try to send anyway? you get NNG_ENOTSUP straight to the face. 💀

when it comes to receiving, the pull protocol just accepts messages as they arrive from peers. and bestie, listen — if two peers both have a message ready, the order in which those messages get handled is undefined. so don't come for me when the ordering isn't what you expected. it's not a bug, it's just... not defined. 🙈

✨ 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 like, version 0 or nothing, periodt. 💅

🎀 Protocol Options 🎀

the pull protocol has no protocol-specific options. clean. minimal. iconic. ✨

🌸 Protocol Headers 🌸

the pull protocol has no protocol-specific headers. nothing extra, she's lowkey effortless. 🦋

👑 SEE ALSO 👑

and that's the whole page, bestie!! written up as part of the NNG Reference Manual, dated 2026-06-30. go forth and pull those messages, you've got this 🫶💖✨⭐

📦 where this page comes from