NANOMSG(7)

✨ NANOMSG ✨

okay bestie, sit DOWN because we're talking about nanomsg — the scalability protocols library, manual page 7, version 1.2.2, and it's giving absolute legend behavior 💅

---

🎀 SYNOPSIS 🎀

like, how do you even link this thing? here's the vibe:

cc [flags] files -lnanomsg [libraries]

yes queen, just slap -lnanomsg on there and go 🦋

---

🌸 DESCRIPTION 🌸

so the nanomsg library exports a whole squad of functions, and I'm about to introduce you to every single one because nobody gets left out in this group chat 💖

🫶 Functions exported by nanomsg

Create an SP socket

• nn_socket(3)

Close an SP socket

• nn_close(3)

Set a socket option

• nn_setsockopt(3)

Retrieve a socket option

• nn_getsockopt(3)

Add a local endpoint to the socket

• nn_bind(3)

Add a remote endpoint to the socket

• nn_connect(3)

Remove an endpoint from the socket

• nn_shutdown(3)

Send a message

• nn_send(3)

Receive a message

• nn_recv(3)

Fine-grained alternative to nn_send

• nn_sendmsg(3)

Fine-grained alternative to nn_recv

• nn_recvmsg(3)

Allocation of messages

• nn_allocmsg(3)
• nn_reallocmsg(3)
• nn_freemsg(3)

Manipulation of message control data

• nn_cmsg(3)

Multiplexing

• nn_poll(3)

Retrieve the current errno

• nn_errno(3)

Convert an error number into human-readable string

• nn_strerror(3)

Query the names and values of nanomsg symbols

• nn_symbol(3)

Query properties of nanomsg symbols

• nn_symbol_info(3)

Query statistics on a socket

• nn_get_statistic(3)

Start a device

• nn_device(3)

Notify all sockets about process termination

• nn_term(3)

Environment variables that influence nanomsg work

• nn_env(7)

---

🌈 Scalability protocols provided by nanomsg

these are the personalities of nanomsg, no cap:

One-to-one protocol

• nn_pair(7)

Request/reply protocol

• nn_reqrep(7)

Publish/subscribe protocol

• nn_pubsub(7)

Survey protocol

• nn_survey(7)

Pipeline protocol

• nn_pipeline(7)

Message bus protocol

• nn_bus(7)

---

🦋 Transport mechanisms provided by nanomsg

how the messages actually travel, iconic behavior honestly:

In-process transport

• nn_inproc(7)

Inter-process transport

• nn_ipc(7)

TCP transport

• nn_tcp(7)

WebSocket transport

• nn_ws(7)

---

👑 The tool installed with the library

nanocat

• nanocat(1)

---

💜 AUTHORS 💜

the masterminds, the main characters, the ones who ATE and left no crumbs:

• Garrett D’Amore <garrett@damore.org>
• Martin Sustrik <sustrik@250bpm.com>

---

and that's the whole page bestie, go forth and multiplex responsibly 🧚✨

signing off from nanomsg 1.2.2, dated 2026-01-16 — periodt 💅🎀