ice_cpi_phy_lock(9)

💅 ice_cpi_phy_lock(9) — like, the per-PHY lock for CPI transaction serialization, bestie

okay so this is a page from the Kernel API Manual (ice_cpi_phy_lock(9), if we're being formal) and honestly? it's short, it's sweet, and it's giving "tiny function, big responsibility." let's get into it 🎀

---

✨ NAME ✨

ice_cpi_phy_lock — get per-PHY lock for CPI transaction serialization

like, it hands you the lock so your CPI transactions don't all talk over each other. polite king behavior 👑

---

🌸 SYNOPSIS 🌸

struct mutex * ice_cpi_phy_lock (struct ice_hw *hw , u8 phy );

that's it. that's the whole vibe. you give it a hw and a phy, it gives you back a struct mutex *. slay ✨

---

🦋 ARGUMENTS 🦋

• hw — pointer to the HW struct. yes bestie, the hardware one. the main character of the whole driver 🙈
• phy — the PHY index. it's a u8, so keep it cute and keep it in range 💜

---

👑 RETURN 👑

pointer to PHY mutex, or NULL when context is unavailable.

⚠️ heads up: NULL is a real possibility here, so fr fr check it before you dereference. don't be that girl 💀

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/net/ethernet/intel/ice/ice_cpi.c — that's the whole squad's home base 🏠

then the friend group, in order:

• ice_cpi_get_dest_dev(9)
• ice_cpi_write_phy(9)
• ice_cpi_read_phy(9)
• ice_cpi_wait_req0_ack0(9)
• ice_cpi_wait_ack(9)
• ice_cpi_req0(9)
• ice_cpi_exec_cmd(9)
• ice_cpi_exec(9)
• ice_cpi_set_cmd(9)
• ice_cpi_ena_dis_clk_ref(9)

go read them too, iykyk 🫶

---

and that's the whole page, bestie — no cap, that's genuinely all of it 🌈

mwah 💋 this little love letter lives in ./drivers/net/ethernet/intel/ice, dated October 2026, and yes the tag at the bottom still says ice_cpi_phy_lock(9) — periodt. 🎀✨