ksz_is_port...lobal_usable(9)

💅 ksz_is_port_mac_global_usable (kernel API manual, bestie edition) 🦋

okay so this is a page from the Kernel API Manual — the ksz_is_port...lobal_usable(9) one, yes the title is doing the whole dramatic ellipsis thing, we love a mysterious queen ✨

---

🌸 NAME 🌸

ksz_is_port_mac_global_usable — literally checks whether the MAC address sitting on a given port can be used as a global address. that's it, that's the vibe check 🔥

---

✨ SYNOPSIS ✨

bool ksz_is_port_mac_global_usable (struct dsa_switch *ds , int port );

like, you hand it a switch and a port number and it comes back with a bool. no cap, that's the whole signature 💅

---

🎀 ARGUMENTS 🎀

• ds — a pointer to the DSA switch structure. yes, the struct dsa_switch *, the main character of this whole operation 👑
• port — the port number where the MAC address is gonna get checked. just the port number, nothing extra 🫶

---

💖 DESCRIPTION 💖

so this function goes and examines the MAC address that's been set on the specified port, and then it determines whether that address can be used as a global address for the switch. lowkey obsessed with how clean that is — one look at the MAC, one verdict, done 🌈

---

⭐ RETURN ⭐

• true — yup, the port's MAC address can be used as a global address. slay 💫
• false — nope, it cannot. close enough, moving on 🙈

---

🔥 SEE ALSO 🔥

the kernel file where the magic lives: ./drivers/net/dsa/microchip/ksz_common.c 📁

and the whole friend group of related functions, in the order the page says them, fr fr:

• 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_get_wol(9)
• ksz_set_wol(9)
• ksz_wol_pre_shutdown(9)
• ksz_switch_macaddr_get(9)
• ksz_switch_shutdown(9)
• ksz_drive_strength_to_reg(9)
• ksz_drive_strength_error(9)
• ksz_drive_strength_write(9)

---

cute little sign-off besties 💜 this page is filed under ./drivers/net/dsa/microchip, dated October 2026, and it answers to the header ksz_is_port...lobal_usable(9). iykyk 🧚 go check your MAC addresses, mwah 🍓