br_multicast_list_adjacent(9)

💅 br_multicast_list_adjacent(9)

okay so you're in the Kernel API Manual, section 9, and today's main character is br_multicast_list_adjacent(9). bestie, this one is gonna make so much sense, i promise 🫶

---

✨ NAME ✨

br_multicast_list_adjacent — literally just returns snooped multicast addresses, no cap 🦋

---

🌸 SYNOPSIS 🌸

int br_multicast_list_adjacent (struct net_device *dev , struct
list_head *br_ip_list );

look at that signature. gorgeous. iconic. the way that int is just sitting there ready to hand you a count 💖

---

🎀 ARGUMENTS 🎀

• dev — the bridge port adjacent to which to retrieve addresses. yes, "adjacent to which", we're being fancy today. it's the port whose neighbours we're snooping around 👀
• br_ip_list — the list where we stash all the found, snooped multicast IP addresses. it's the lil basket you're handing us 🧺✨

---

🦋 DESCRIPTION 🦋

So here's the vibe: this function creates a list of IP addresses (as struct br_ip_list) that the multicast snooping feature sensed on all bridge ports of dev's bridge device — but with one very important exclusion: it skips the addresses coming from dev itself. like, we're nosy but we're not that nosy 🙈

Then it returns the number of items it added to br_ip_list. nice and countable, we love a return value with a job 🔥

---

💀 NOTES 💀

okay bestie, listen up, these are the ones that bite if you ignore them:

• br_ip_list needs to be initialized by the caller — that's you, you're the caller, do the init 🫡
• br_ip_list might contain duplicates in the end, so it needs to be taken care of by the caller. yes, dedupe responsibilty is yours, not ours 💅
• br_ip_list needs to be freed by the caller. please, please free it. do not leave it hanging 😭

fr fr, all three of those are on you. we just fill the list, we don't babysit it.

---

🌈 SEE ALSO 🌈

• Kernel file ./net/bridge/br_multicast.c — the source, the lore, the origin story 📜
• br_multicast_has_querier_anywhere(9)
• br_multicast_has_querier_adjacent(9)
• br_multicast_has_router_adjacent(9)

the whole multicast bestie squad, iykyk 👑

---

and that's the page!! sign-off time: this little masterpiece lives in ./net/bridge, dated October 2026, and it's part of the Kernel API Manual — stan forever, periodt 💜⭐