MLD(4)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 MLD 💖

okay bestie, welcome to the mld page — that's Multicast Listener Discovery Protocol, and no, it's not about finding your people at a party (though honestly? same energy). it's a real networking thing and it's lowkey iconic. let's get into it 🦋

✨ SYNOPSIS ✨

first things first, here's the vibe — you gotta pull in all these headers:

#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/in.h>
#include <netinet/in_systm.h>
#include <netinet/ip6.h>
#include <netinet/icmp6.h>
#include <netinet6/mld6.h>

and then the little summoning ritual:

int
socket(AF_INET6, SOCK_RAW, IPPROTO_ICMPV6);

slay. that's it. that's the whole spell 🎀

🌸 DESCRIPTION 🌸

so MLD is a control plane protocol — the backstage manager of the internet, fr fr — used by IPv6 hosts and routers to propagate multicast group membership information. basically: "hey, who's in this group? is anybody still listening? should we keep sending stuff?" that kinda thing.

ngl, normally you don't touch this protocol directly. it's not for you, bestie, it's for the kernel itself 💅 — it hops in whenever user applications ask for multicast membership. that's the kernel's job, and it does it beautifully, no cap.

but wait — there's a plot twist. multicast routing protocol daemons may open a raw socket and directly interact with mld to receive membership reports. main character energy only 🔥

as of FreeBSD 8.0, MLD version 2 is implemented. and bestie, this is a big deal because:

  • it adds support for Source-Specific Multicast (SSM) — meaning applications can tell upstream multicast routers "um actually I only want streams from these particular sources, thanks" 🙈
  • and the retransmission of state-change reports adds some robustness to the protocol. resilient queen 👑

💅 SYSCTL VARIABLES 💅

these are the lil knobs and dials, the settings you can peek at and poke. one at a time, gorgeous:

  • net.inet6.mld.ifinfo — an opaque read-only variable that exposes the per-link MLDv2 status to ifmcstat(8). that's it. that's the whole job. it's giving mysterious, it's giving "I don't explain myself" ✨
  • net.inet6.mld.gsrdelay — this one specifies the time threshold, in seconds, for processing Group-and-Source Specific Queries (GSR). now listen, because this part matters: GSR query processing requires maintaining state on the host, which means it may cause memory to be allocated, and therefore it's a potential attack point for Denial-of-Service (DoS) 😭. so if more than one GSR query is received within this threshold, it gets dropped — to mitigate the potential for DoS. protective king 🛡️
  • net.inet6.mld.v1enable — if this variable is non-zero, then MLDv1 membership queries (and host reports) will be processed by this host, and backwards compatibility will be enabled until the v1 'Older Version Querier Present' timer expires. this sysctl is normally enabled by default. so like, it's on unless you turn it off. respect the defaults bestie 🫶

👀 SEE ALSO 👀

go read these next, they're all connected, iykyk:

📜 HISTORY 📜

the mld manual page appeared in FreeBSD 8.0. a legend was born 💫

and that's the whole page, bestie!! 🎀✨ you ate that. go forth and multicast responsibly 💖

signing off from the Debian side of things — this lil slice of manpage wisdom is dated April 8, 2013, and it lives under the name MLD(4) 🌈💜

📦 where this page comes from