ksz_set_wol(9)

💖 ksz_set_wol(9) 💖

okay so bestie, we're in the kernel API manual and this page is literally called ksz_set_wol(9) — it's giving "Wake-on-LAN but make it DSA". let's get into it 🫶

---

✨ NAME ✨

ksz_set_wol — Set Wake-on-LAN settings for a specified port. that's it, that's the whole vibe. 🔥

---

🌈 SYNOPSIS 🌈

int ksz_set_wol (struct dsa_switch *ds , int port , struct
       ethtool_wolinfo *wol );

---

🎀 ARGUMENTS 🎀

• ds — The dsa_switch structure. your main character struct, ngl 💅
• port — The port number. which port are we waking up bestie
• wol — Pointer to ethtool Wake-on-LAN settings structure. this is where the WoL tea lives ☕

---

🦋 DESCRIPTION 🦋

okay so this function configures Wake-on-LAN (WoL) settings for a specified port. it's literally doing a whole routine, watch:

1. it validates the provided WoL options ✅
2. it checks if PME is enabled and supported 👀
3. it clears any previous wake reasons 🧹 (out with the old)
4. it sets the Magic Packet flag in the port's PME control register — but only if specified ✨

no cap, it's a little pipeline of self-care for your NIC 🧚

---

💜 RETURN 💜

• 0 on success 😌
• or other error codes on failure 😭 (things happen)

---

⭐ SEE ALSO ⭐

Kernel file ./drivers/net/dsa/microchip/ksz_common.c — that's the source house, go visit 🏠

and the whole friend group, in order:

• 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_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)

---

💡 reminder bestie: every one of these is in the same directory and listed on the page — don't skip any, they're all invited to the function party 🎉

---

🌸 that's the whole page! written up in ./drivers/net/dsa/microchip, dated October 2026, and the manual name on the tin is ksz_set_wol(9). periodt. go wake something up responsibly, ily 💖🎀✨