batadv_send_roam_adv(9)

📦 version 7.3.1, in nixpkgs unstable

💅 batadv_send_roam_adv — the "hey bestie, she lives here now" broadcast

okay so real talk, this is a page from the Kernel API Manual, and the function is batadv_send_roam_adv(9). It's a void function, so like… it doesn't hand you anything back. It just does the thing. And the thing is very gossipy. 🐝

✨ SYNOPSIS ✨

void batadv_send_roam_adv (struct batadv_priv *bat_priv , u8 *client ,
unsigned short vid , struct batadv_orig_node *orig_node );

literally four arguments, no return value, no drama (well, some drama — it's a roaming announcement, gossip is the whole point 💅).

🎀 ARGUMENTS 🎀

  • bat_priv — the bat priv, aka the whole vibe container: it's the struct holding all the mesh interface information. your main character data structure. 👑
  • client — mac address of the roaming client. the little wanderer in question. 🦋
  • vid — the VLAN identifier. yes, VLANs matter even when your fave is out here moving between nodes. 🌈
  • orig_node — the message destination. this is who gets the text. 📲

💖 DESCRIPTION 💖

okay so picture it: a client just packed up and moved to a new node, and the node she used to live at is still out here forwarding her mail to the old address. embarrassing. 😭

So this function sends a ROAMING_ADV message to the node which was previously serving this client. Why? To inform that node that from now on, all traffic destined for this particular roamed client has to be forwarded to the sender of the roaming message. That's it. That's the whole errand. no cap. ✨

it's giving "change of address card, but for the mesh." the old node gets told, the old node updates, the traffic follows her. slay. 🫶

ngl this one's a void — it sends the message and that's the whole job. no return value to check, no error code to babysit.

🌸 SEE ALSO 🌸

so this function lives in the Kernel file ./net/batman-adv/translation-table.c, and it has a lot of neighbours. like, an entire group chat. here's the full roster, in order, no one left out (i would never 🙈):

and that's the whole page, bestie. no notes. 💜

this one shipped out of ./net/batman-adv in October 2026 — so when you're reading it, just know the mesh was already out here roaming with main character energy. bye!! 🎀✨🦋

📦 where this page comes from