NNG_MSG_GET_PIPE(3)

✨ nng_msg_get_pipe(3) — NNG Reference Manual ✨

okay bestie, welcome to another episode of NNG Reference Manual, the show where we explain Unix networking functions but make it cute 💖 today's main character is nng_msg_get_pipe, and she is iconic.

---

🌸 NAME 🌸

nng_msg_get_pipe — get pipe for message 🎀

---

🦋 SYNOPSIS 🦋

#include <nng/nng.h>

nng_pipe nng_msg_get_pipe(nng_msg *msg);

like, that's it. one function. one argument. she's lowkey effortless 💅

---

👑 DESCRIPTION 👑

so basically, nng_msg_get_pipe() returns the nng_pipe object that's associated with the message msg. that's the whole vibe ✨

and the meaning of that pipe depends on which direction the message is going, which is kind of giving duality ngl:

• when you're receiving, this is the pipe the message was actually received from 📥
• when you're transmitting, this would be the pipe the message should be delivered to, if you need a specific peer 🎯

Note: not all protocols support overriding the destination pipe. so don't just assume you can boss the message around, bestie 😭 some protocols are like "no. we choose the route."

the most usual use case for this (and honestly the one you'll be obsessed with) is getting info about the peer a message came from 🫶 like, you can behave differently for different peers — for example, a higher level of authentication for peers chillin' on an untrusted network 🔥 and for exactly that situation, the nng_pipe_getopt() function is your girl. she's useful here. periodt.

---

💜 RETURN VALUES 💜

the function hands you back the pipe associated with this message, and that value will be a positive value 🎀

if the pipe comes back non-positive, that's the signal that no specific pipe is associated with the message. no pipe, no vibe, just a shrug 🙈

---

💀 ERRORS 💀

None. literally zero errors. she doesn't even have a bad day. slay 💅

---

🌈 SEE ALSO 🌈

• nng_msg_alloc(3)
• nng_msg_set_pipe(3)
• nng_pipe_getopt(3)
• nng(7)

---

and that's the whole page, bestie!! no cap, it's giving short-but-essential 💖

this has been nng_msg_get_pipe(3) from the NNG Reference Manual, dated 2026-06-30 🌸 stay hydrated, read your man pages, and go get that pipe 🫶✨