mii_adv_to_linkmode_adv_t(9)

📦 version 7.3.1, in nixpkgs unstable

💅 mii_adv_to_linkmode_adv_t — kernel API manual, but make it make sense

okay so bestie, welcome to the mii_adv_to_linkmode_adv_t(9) page. yes that's the whole name. the NAME section literally gives you the function name and then dips — no little summary, no nothing. iconic of it honestly. 🎀

✨ SYNOPSIS ✨

void mii_adv_to_linkmode_adv_t (unsigned long *advertising , u32 adv );

that's the whole signature, no cap. returns void, so don't go looking for a return value, it's not coming. 🦋

🌸 ARGUMENTS 🌸

  • advertising — pointer to the destination link mode. this is where the translated stuff lands, so pls make sure it points somewhere real. 🫶
  • adv — the value of the MII_ADVERTISE register. raw bits, coming in hot, about to get translated.

💖 DESCRIPTION 💖

so what does this little guy do? it's a small helper function — lowercase s small — that translates MII_ADVERTISE bits into linkmode advertisement settings. that's the whole job. it takes the register bits and rehomes them into linkmode-speak. 🔥

and the important bit, literally: it clears the old value of advertising. so whatever was chilling in that destination before? gone. wiped. not me accidentally assuming it'd merge with what's already there 💀 — it does not merge, it clears first. so don't pass it a buffer you were still emotionally attached to.

👑 SEE ALSO 👑

the kernel file itself lives at ./include/linux/mii.h — go say hi. 🌈

and here's the whole friend group, all of them (9) pages, all of them part of this saga:

that's twenty-two whole cross-references, bestie, we are thorough here. 💜

lowkey reminder: mii_adv_mod_linkmode_adv_t(9) is a different function from this one. the _to_ one clears, the _mod_ one modifies. don't mix them up, that's how you get bugs. 🙈

and that's the page!! source dir was ./include/linux, dated October 2026, and it's the mii_adv_to_linkmode_adv_t(9) manual — slay, go translate some register bits, you've got this ⭐🧚💅

📦 where this page comes from