ice_get_cgu_state(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ice_get_cgu_state — get the state of the DPLL

okay so this is a page from the Kernel API Manual and it's genuinely iconic — we're clocking in with ice_get_cgu_state, the little function that goes "hey bestie, what's the DPLL up to rn?" 🕰️✨

✨ NAME ✨

ice_get_cgu_state — get the state of the DPLL 🎀

🦋 SYNOPSIS 🦋

int ice_get_cgu_state (struct ice_hw *hw , u8 dpll_idx , enum
dpll_lock_status last_dpll_state , u8 *pin , u8 *ref_state , u8
*eec_mode , s64 *phase_offset , enum dpll_lock_status *dpll_state );

like, it returns an int, and yes it takes a whole friend group of arguments. no cap. 💀

🌸 ARGUMENTS 🌸

  • hw — pointer to the hw struct. the main character, honestly. 👑
  • dpll_idx — Index of internal DPLL unit. it's a u8, so like, small but mighty.
  • last_dpll_state — last known state of DPLL, typed as enum dpll_lock_status. the "as previously seen on TV" of states. 📺
  • pin — pointer to a buffer for returning currently active pin. yes it's a buffer, we're filling it in. 🫶
  • ref_state — reference clock state. u8 pointer, very demure.
  • eec_mode — eec mode of the DPLL. also u8 *. it's giving configuration.
  • phase_offset — pointer to a buffer for returning phase offset, s64 * so it can be big and/or negative, we don't judge. 😌
  • dpll_state — state of the DPLL (output), typed enum dpll_lock_status *. this one's the answer key, lowkey. 🔥

🧚 DESCRIPTION 🧚

This function will read the state of the DPLL(dpll_idx). 📖

and here's the slay part — for any of the non-null ones, it'll retrieve the currently active pin, ref_state, eec_mode and phase_offset respectively. so like, if you pass a pointer, you get the tea back in it. if you pass NULL, no tea for you, and that's fine too. ✨

⭐ RETURN ⭐

state of the DPLL. that's it, that's the return. and the function's declared return type is int. both facts are true, bestie, don't come for me. 💖

🌈 SEE ALSO 🌈

First up, the kernel file itself: ./drivers/net/ethernet/intel/ice/ice_ptp_hw.c — that's the whole neighbourhood, iykyk.

and then... the guest list. it is LONG. like, this function knows everyone. no cap. 🎀

lowkey that's the whole friend list and every single one of them is invited. don't skip any, bestie 🫶

okay that's the page!! 🎀 sourced straight from ./drivers/net/ethernet/intel/ice, dated October 2026 — and that's the actual manual/version + date info, not me being cute. bye bestie, go read your DPLL state 💜🎀✨

📦 where this page comes from