i40e_aq_set_...register_ext(9)

📦 version 7.3.1, in nixpkgs unstable

💅 i40e_aq_set_phy_register_ext(9) — bestie edition 🌸

okay so this is a page from the Kernel API Manual, section 9, and it's about one very specific little function. her name is i40e_aq_set_phy_register_ext and she's giving "I write to the external PHY register" main character energy. no cap. ✨

🎀 NAME 🎀

i40e_aq_set_phy_register_ext — literally just here to write the external PHY register. that's it, that's the whole job. 💅

🦋 SYNOPSIS 🦋

int i40e_aq_set_phy_register_ext (struct i40e_hw *hw , u8 phy_select ,
u8 dev_addr , bool page_change , bool set_mdio , u8 mdio_num , u32
reg_addr , u32 reg_val , struct i40e_asq_cmd_details *cmd_details );

look at all those args. she has a LOT going on and honestly? respect. 👑

✨ ARGUMENTS ✨

  • hw — pointer to the hw struct. your home base, your main character struct, the whole vibe. 🏠
  • phy_select — selects which phy should be accessed. picking favorites, basically, but for hardware. 💁‍♀️
  • dev_addr — the PHY device address. where your device lives, iykyk. 📍
  • page_change — flag that says whether the phy page should be updated. true means yes bestie we're flipping pages, false means we're staying put. 📖
  • set_mdio — use the MDIO I/F number specified by mdio_num. like, "use THIS one," not whatever default. 🎯
  • mdio_num — the MDIO I/F number itself. the actual number. the digits. 🔢
  • reg_addr — PHY register address. where the register is chillin'. 🏡
  • reg_val — the new register value. the fresh content we're writing in there. 🔥
  • cmd_details — pointer to command details structure or NULL. optional, like a little accessory. can be NULL, no pressure. 🫶

💜 DESCRIPTION 💜

Write the external PHY register.

that's the whole description. short, sweet, iconic, ate. 🌈

⭐ NOTE ⭐

in common cases the MDIO I/F number should not be changed — that's literally why you may use the simple wrapper i40e_aq_set_phy_register instead. she's the low-effort version of this function and sometimes that's exactly what you need, ngl. 🧚

reminder bestie: don't be out here changing mdio_num for no reason. common cases = leave it alone. 💀

🌸 SEE ALSO 🌸

also go look at the Kernel file ./drivers/net/ethernet/intel/i40e/i40e_common.c — that's where the actual sauce lives. 🍓

and here's the entire friend group, all section 9, all invited to the group chat:

like, that's the whole tl;dr of the i40e universe. obsessed. 💖

and that's the page, bestie! brought to you by ./drivers/net/ethernet/intel/i40e, vintage October 2026, filed under i40e_aq_set_...register_ext(9) — take care of her, she's iconic. 🫶✨💅

📦 where this page comes from