NNG_DURATION(5)

💖 NNG_DURATION — relative time in milliseconds, bestie 💖

okay so real quick, before we get into it: this is page NNG_DURATION(5) from the NNG Reference Manual, and yes she's a whole vibe. let's go 🦋

---

✨ NAME ✨

nng_duration — literally just a relative time in milliseconds, no cap ⏱️

---

🌸 SYNOPSIS 🌸

#include <nng/nng.h>

typedef int32_t nng_duration;

#define NNG_DURATION_INFINITE (-1)
#define NNG_DURATION_DEFAULT  (-2)
#define NNG_DURATION_ZERO     (0)

like. it's an int32_t. that's the whole thing. gorgeous. 💅

---

🎀 DESCRIPTION 🎀

so an nng_duration is a relative time, measured in milliseconds. that's it, that's the girl. she's most often hanging out with timers and timeouts, because obviously, that's her main character era. 👑

and then there's a couple of special values that got set aside that carry ✨special meanings✨ — think of them as the VIP section of the duration type:

• NNG_DURATION_DEFAULT — this one's like "idk, use the context-specific default, whatever that is". she's the "you pick" friend. 🙈
• NNG_DURATION_INFINITE — effectively an infinite duration. used most often to disable timeouts entirely. she does not do deadlines, she does not do clocks, she is forever. 💀
• NNG_DURATION_ZERO — a zero-length duration. this one's for performing a single polling operation, i.e. "check once and move on, don't wait around for anybody." 🫶

also lowkey important: the value of NNG_DURATION_INFINITE is (-1), the value of NNG_DURATION_DEFAULT is (-2), and NNG_DURATION_ZERO is (0). they are negative and zero on purpose, bestie. not a typo. iconic behaviour honestly.

---

🦋 SEE ALSO 🦋

• nng_options(5)
• nng(7)

go read those too, iykwim 🌈

---

and that's the page!! this was NNG_DURATION(5) from the NNG Reference Manual, dated 2026-06-30. slay, periodt, go set a timeout responsibly 💜🎀✨