ice_cpi_wait_ack(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ice_cpi_wait_ack(9) — Kernel API Manual, bestie edition ✨

okay so you found yourself in the ice_cpi_wait_ack(9) page, welcome, come sit with me 🫶 this one's a little kernel helper from the Kernel API Manual and honestly it's giving "patient bestie waiting for a text back" energy, because that's literally what it does: it waits for a bit to flip. no cap.

✨ NAME ✨

ice_cpi_wait_ack — Waits for the PHY.ACK bit to be asserted/deasserted

like, that's it. that's the whole gig. it waits. iconic behaviour honestly 👑

🌸 SYNOPSIS 🌸

int ice_cpi_wait_ack (struct ice_hw *hw , u8 phy , bool asserted , u32
*data );

yes the line break in the middle of u32 *data is exactly how the original is laid out, we do not fix, we do not editorialise, we copy verbatim 💅

🎀 ARGUMENTS 🎀

  • hw — pointer to the HW struct. the main character of the whole operation fr fr
  • phy — phy index of port the CPI action is taken on. gotta know which port we're doing this on 💖
  • asserted — desired state of PHY.ACK bit. are we waiting for it to go up or go down? that's the vibe check 🌈
  • data — pointer to the user data where PHY.data is stored. this is where the good stuff gets parked 🍓

🦋 DESCRIPTION 🦋

so what actually happens: this function checks if the PHY.ACK bit is asserted or deasserted, depending on the phase of the CPI handshake. it's phase-aware, it's context-sensitive, it's lowkey doing the most (affectionate) ✨

and if the 'asserted' state is required, the PHY command data is stored in the 'data' storage. so not only is it watching the bit, it's also tucking the payload away for you. multi-tasking queen 👑

🔥 RETURN 🔥

  • 0 on success 🎉
  • negative on error 😭

that's the whole return contract, no surprises, no plot twists.

💜 SEE ALSO 💜

the kernel file lives right here, go read the source bestie, it's free:

./drivers/net/ethernet/intel/ice/ice_cpi.c

and the whole CPI friend group, all of them, in order:

ngl, ice_cpi_wait_req0_ack0 and this function are basically siblings, if you're here you probably wanna peek at that one too 🧚

that's the page!! source is ./drivers/net/ethernet/intel/ice, dated October 2026, and it's signed off as ice_cpi_wait_ack(9) on the way out — stay hydrated, go assert some bits, ily 💖✨🎀

📦 where this page comes from