bond_change_active_slave(9)

✨ bond_change_active_slave(9) ✨

Okay bestie, welcome to the Kernel API Manual — today’s main character is bond_change_active_slave(9), and she is literally here to swap in a new active slave. 🫶💅

🌸 NAME 🌸

bond_change_active_slave — change the active slave into the specified one. Periodt. 👑

🦋 SYNOPSIS 🦋

void bond_change_active_slave (struct bonding *bond , struct slave
       *new_active );

🎀 ARGUMENTS 🎀

• bond — our bonding struct. The whole vibe container, ngl. ✨
• new_active — the new slave to make the active one. She’s getting the crown. 👑

💖 DESCRIPTION 💖

So here’s the tea: set the new slave to the bond’s settings, and unset them on the old curr_active_slave. Setting include flags, mc-list, promiscuity, allmulti, etc. — she’s doing the whole settings glow-up. 🧹✨

And if new’s link state is BOND_LINK_BACK, we’ll set it to BOND_LINK_UP, because it is apparently the best available slave we have — even though its updelay hasn’t timed out yet. No cap, she’s getting promoted anyway. 💅🔥

⚠️ Caller must hold RTNL. This is not a drill, bestie — hold RTNL. 😭🔒

🌈 SEE ALSO 🌈

Kernel file ./drivers/net/bonding/bond_main.c, plus these absolute legends:

• bond_dev_queue_xmit(9)
• bond_vlan_rx_add_vid(9)
• bond_vlan_rx_kill_vid(9)
• bond_ipsec_dev(9)
• bond_ipsec_add_sa(9)
• bond_ipsec_del_sa(9)
• bond_ipsec_offload_ok(9)
• bond_advance_esn_state(9)
• bond_xfrm_update_stats(9)
• bond_set_dev_addr(9)
• bond_choose_primary_or_current(9)
• bond_find_best_slave(9)
• bond_select_active_slave(9)
• bond_xmit_hash(9)
• bond_xmit_hash_xdp(9)
• bond_get_slave_by_id(9)
• bond_rr_gen_slave_id(9)
• bond_sk_hash_l34(9)

Mwah 💋 — this page’s source/version home is ./drivers/net/bonding, and it’s dated October 2026. Stay bonded, bestie. 🫶💜