ksz_switch_macaddr_get(9)

💖 ksz_switch_macaddr_get(9) 💖

okay so bestie, welcome to the Kernel API Manual ✨ — yes we're in the kernel API manual era, it's giving "I read source code for fun" and honestly? iconic. this one's all about programming a switch's MAC address register, and it's lowkey important so let's get into it 🫶

---

✨ NAME ✨

ksz_switch_macaddr_get — bestie this one programs the switch's MAC address register 💅 periodt, that's the whole job.

---

🌸 SYNOPSIS 🌸

int ksz_switch_macaddr_get (struct dsa_switch *ds , int port , struct
       netlink_ext_ack *extack );

---

🎀 ARGUMENTS 🎀

• ds — your DSA switch instance 💖 like, the switch in question, the main character.
• port — the port number 🌈 just the number of the port we're talking about.
• extack — the netlink extended acknowledgment ✨ yes it's a whole thing, it carries the extra ack info.

---

🦋 DESCRIPTION 🦋

so what does this actually do? it programs the switch's MAC address register with the MAC address of the requesting user port 💫 that's it, that's the vibe.

and here's the slay part: this single address gets used by the switch for multiple features — think HSR self-address filtering and WoL 👑 iykyk, one address serving multiple looks, very efficient of her.

other user ports can totally share ownership of this address as long as their MAC address is the same 🤝 sharing is caring, but only if you match, no cap.

🚨 warning bestie, listen: the MAC addresses of user ports must not change while they have ownership of the switch MAC address. like, don't. seriously. don't do it 🙈

---

💀 RETURN 💀

• 0 on success 🎉 slay
• or other error codes on failure 😭 not slay, but that's how it goes

---

🌟 SEE ALSO 🌟

first up, the kernel file herself:

• Kernel file ./drivers/net/dsa/microchip/ksz_common.c 💖

and the whole friend group 🫶:

• ksz_phylink_mac_disable_tx_lpi(9)
• ksz_phylink_mac_enable_tx_lpi(9)
• ksz_update_port_member(9)
• ksz_parent_mdio_read(9)
• ksz_parent_mdio_write(9)
• ksz_phy_addr_to_port(9)
• ksz_irq_phy_setup(9)
• ksz_irq_phy_free(9)
• ksz_parse_dt_phy_config(9)
• ksz_mdio_register(9)
• ksz_handle_wake_reason(9)
• ksz_is_port_mac_global_usable(9)
• ksz_get_wol(9)
• ksz_set_wol(9)
• ksz_wol_pre_shutdown(9)
• ksz_switch_shutdown(9)
• ksz_drive_strength_to_reg(9)
• ksz_drive_strength_error(9)
• ksz_drive_strength_write(9)

---

and that's the page bestie 💜 this little gem lives in ./drivers/net/dsa/microchip, dated October 2026, and it's brought to you by the one and only ksz_switch_macaddr_get(9) 🧚 go program that register, you got this 💅✨