hns_xgmac_disable(9)

📦 version 7.3.1, in nixpkgs unstable

💅 hns_xgmac_disable(9) — from the Kernel API Manual, bestie 🎀

okay so real talk, this one's from the Kernel API Manual, page hns_xgmac_disable(9), and it does exactly one thing but it does it flawlessly. it's giving "quiet luxury" — no return value, no drama, just vibes and a port going night-night 😴✨

✨ NAME ✨

hns_xgmac_disable — disable xgmac port 💤

like... that's it. that's the whole job. it disables the xgmac port. iconic, honestly. no notes. 👑

🌸 SYNOPSIS 🌸

void hns_xgmac_disable (void *mac_drv , enum mac_commom_mode mode );

yes bestie, that spacing is exactly how it's written, don't come for me 🫶 and yes it returns void — it's a void girlie, it gives nothing back and it doesn't need to. main character energy fr fr 💅

⚠️ tiny heads up: the enum is spelled mac_commom_mode — with the double m. that's not a typo I made, that's a typo the kernel made, and we respect it. copy it exactly or your build will simply pass away 😭

🦋 ARGUMENTS 🦋

  • mac_drv — the mac driver. that's your pointer to the driver, your little handle on the whole situation, void * so it can be literally anything and the compiler just has to trust you. 🫡
  • mode — the mode of the mac port. it's an enum mac_commom_mode, so it's a whole mood, and you gotta tell the function which mode you're in. pick wisely, bestie. 🎀

💖 SEE ALSO 💖

okay this is the part where the page just name-drops its entire friend group and honestly? obsessed. 💜

the kernel file this lives in:

./drivers/net/ethernet/hisilicon/hns/hns_dsaf_xgmac.c

and the whole crew, no cap:

like that's a whole squad. and yeah, hns_xgmac_enable(9) is right there in the list — the yin to this yang, the on to this off, the un-disabling to this disabling 🌈 iykyk.

🧚 bestie reminder: this page is short because the function is short. don't go inventing extra flags or return codes in your head, there are none, and I will not be making any up for you. what you see is what you get. periodt. 💀

and that's the page!! 🌸 source/version line says ./drivers/net/ethernet/hisilic... (yeah it's truncated in the original, not my fault, don't @ me 🙈) and it's dated October 2026, which is so far in the future that honestly, slay, time traveller queen. that's the whole hns_xgmac_disable(9) moment, mwah 💋🫶✨

📦 where this page comes from