ice_init_phy_user_cfg(9)

📦 version 7.3.1, in nixpkgs unstable

ice_init_phy_user_cfg ✨

okay so before we even get into it — this page is straight out of the Kernel API Manual, and it's giving "small function, big responsibilities" energy. it's a <pink>(9) manpage, so yeah, kernel-internal, section 9, bestie. let's go 🫶

🌸 NAME 🌸

ice_init_phy_user_cfg — initialize the PHY user configuration

like, literally what it says on the tin. it sets up the user's PHY config from scratch. iconic behavior tbh 👑

✨ SYNOPSIS ✨

int ice_init_phy_user_cfg (struct ice_port_info *pi );

one function, one arg, returns an int. short and sweet, we love a minimal signature 💅

🎀 ARGUMENTS 🎀

  • pi — the port info structure. that's your port-info baddie right there, she carries everything. don't lose her 🌸

🦋 DESCRIPTION 🦋

okay so here's the tea. ice_init_phy_user_cfg initializes the current user PHY configuration — and it resets three-ish things to their defaults:

  • speed
  • FEC
  • FC requested mode

all of them get set to default. clean slate, fresh start, main character energy 🔥

now — where do those defaults even come from? they come from the get PHY capabilities topology with media. so the important part: call this function when media is first available. that's the vibe check you gotta pass. if you call it when media is not available? an error is returned. no media, no config, periodt 💀

also, the PHY initialization completed state gets set right here. so this is the moment the "we're initialized" flag goes up 🚩

what's it all for? these configurations are used when setting PHY configuration. and heads up — the user PHY configuration gets updated on set PHY configuration. so this init and that set are lowkey a matched set, iykyk.

return values, because we always check our returns:

  • 0 on success 🎉
  • negative on failure 😭

fr fr, check the return. don't just yolo it.

💜 SEE ALSO 💜

the kernel file this lives in:

  • ./drivers/net/ethernet/intel/ice/ice_main.c

and now the friend group — literally the whole ice extended universe. grab a snack, this is a long list 🍓:

and that's the whole page! 🧚 this one came from ./drivers/net/ethernet/intel/ice and it's dated October 2026 — ty bestie, mwah 💖🎀

📦 where this page comes from