mac_wol_set(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’€ mac_wol_set(9) β€” the Wake-on-LAN glow-up, bestie πŸ’€

Okay so this page lives in the Kernel API Manual and it's called mac_wol_set(9), and honestly? It's giving "let your NIC wake up from its nap" energy. Come sit with me, we're doing this together. 🫢


✨ NAME ✨

mac_wol_set β€” configure the Wake-on-Lan parameters

Like literally the whole job: you're setting the WoL params. That's it. That's the function. πŸ’…


✨ SYNOPSIS ✨

int mac_wol_set (struct phylink_config *config , u32 wolopts , const u8
*sopass );

Three args, one int back. Look at her go. πŸ‘‘


✨ ARGUMENTS ✨

  • config β€” a pointer to a struct phylink_config. This is the main character of the whole phylink universe, iykyk.
  • wolopts β€” a bitmask of WAKE_* flags for the Wake-On-Lan modes you want enabled. Bitmask means you can stack 'em, bestie. 🌈
  • sopass β€” the SecureOn(tm) password. And listen, this one is only meaningful for WAKE_MAGICSECURE β€” for anything else it's just vibing there being irrelevant. πŸ™ˆ

✨ DESCRIPTION ✨

So what does it actually do? It enables the Wake-on-Lan options you specified at the MAC. πŸŽ€

And here's the little detail that's lowkey important: any options that the PHY can handle will have been removed from wolopts already before this reaches you. So the leftovers are the MAC's problem. Noted. ✍️

Also β€” and this is the iconic part β€” the mere presence of this method enables phylink-managed WoL support. You don't even have to do anything special. Just existing is enough. Main character energy fr fr. πŸ’…βœ¨


✨ RETURN ✨

0 on success. πŸŽ‰

That's the only value documented here, so don't come for me asking about the others. 😭


✨ SEE ALSO ✨

The whole friend group, in the order they appear β€” and yes, we're listing every single one because we don't do "etc." in this house:

Kernel file ./include/linux/phylink.h struct phylink_link_state(9), struct phylink_config(9), struct phylink_mac_ops(9), mac_get_caps(9), mac_select_pcs(9), mac_prepare(9), mac_config(9), mac_finish(9), mac_link_down(9), mac_link_up(9), mac_disable_tx_lpi(9), mac_enable_tx_lpi(9), struct phylink_pcs(9), struct phylink_pcs_ops(9), pcs_validate(9), pcs_inband_caps(9), pcs_enable(9), pcs_disable(9), pcs_get_state(9), pcs_config(9), pcs_an_restart(9), pcs_link_up(9), pcs_disable_eee(9), pcs_enable_eee(9), pcs_pre_init(9), phylink_get_link_timer_ns(9), phylink_mac_implements_lpi(9)

Whole squad. Go say hi. πŸ¦‹πŸŒΈ


Quick vibe check: sopass is only doing real work when WAKE_MAGICSECURE is in play β€” don't forget or your SecureOn(tm) password is just decorative. πŸŽ€

Okay that's the page!! This one came from ./include/linux, dated October 2026, and it's filed under mac_wol_set(9). Bye bestie, go wake some LANs πŸ’œβœ¨

πŸ“¦ where this page comes from