NNG_SOCKADDR_IN(5)

💖 nng_sockaddr_in(5) 💖

okay bestie, welcome to the NNG Reference Manual, page for nng_sockaddr_in — yes that's the manual section 5, and yes we're gonna make IPv4 addresses make sense together 🫶

---

✨ NAME ✨

nng_sockaddr_in — IPv4 socket address 🌸

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

enum sockaddr_family {
    NNG_AF_INET = 3,
};

typedef struct {
    uint16_t sa_family;
    uint16_t sa_port;
    uint32_t sa_addr;
} nng_sockaddr_in;

like. look at her. three little fields. iconic 👑

---

✨ DESCRIPTION ✨

so an nng_sockaddr_in is the flavor of nng_sockaddr that's used to represent TCP (and sometimes UDP) addresses — that means it holds both the Internet Protocol (IP) address and the port number. two for one, we love a multitasker 💅

this structure is the one for IPv4 addresses, periodt. there's a whole different structure for IPv6 addresses, and that one is nng_sockaddr_in6. do not mix them up, bestie, i'm begging 🙈

here's every member, no gatekeeping:

• sa_family — this field will always have the value NNG_AF_INET. always always. it's committed 💜
• sa_port — this field holds the TCP or UDP port number, in network byte-order. and listen: a zero value here is used when no specific port number is indicated.
• sa_addr — this field holds the IP address in network-byte order.

Tip 🎀 the sa_port and sa_addr fields are in network-byte order to facilitate their use with system APIs such as inet_ntop(). most platforms use some form of BSD-derived network API, which uses network-byte order in the various structures (such as sockaddr_in). so it's not weird, it's on purpose, iykyk ✨

Important ⚠️ this field appears similar to BSD sockaddr_in, BUT it is not the same, and they may not be used interchangeably. i know they look like twins. they are not twins. do not swap them. this is the warning, this is the moment 😭

---

✨ SEE ALSO ✨

• nng_sockaddr(5)
• nng_sockaddr_in6(5)
• nng_tcp(7)
• nng(7)

go read those next, we're building a whole ✨ecosystem✨ 🦋

---

and that's the page!! mwah 💖 this one's from the NNG fam, dated 2026-06-30, and it's literally titled NNG_SOCKADDR_IN(5) at the bottom of the original — so consider yourself signed off on, angel 🌈⭐