ice_dpll_sw_esync_get(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ice_dpll_sw_esync_get(9) — like, the Kernel API Manual, but make it make sense 🎀

okay bestie, gather round, because we're about to talk about a kernel callback from the Kernel API Manual and honestly? she's lowkey iconic. this is ice_dpll_sw_esync_get(9) and she does exactly one thing but she does it well. ✨

🌸 NAME 🌸

ice_dpll_sw_esync_get — the callback that gets the embedded sync on the SW pin. that's it. that's the whole vibe. 🦋

🫶 SYNOPSIS 🫶

int ice_dpll_sw_esync_get (const struct dpll_pin *pin , void *pin_priv ,
const struct dpll_device *dpll , void *dpll_priv , struct dpll_pin_esync
*esync , struct netlink_ext_ack *extack );

like, yes, that's a lot of arguments. we don't gatekeep. 💅

✨ ARGUMENTS ✨

  • pin — pointer to a pin 🎀 she's the main character here
  • pin_priv — the private data pointer that got passed along when the pin was registered
  • dpll — the registered dpll pointer, aka the one that's already in the system
  • dpll_priv — private data pointer passed on dpll registration, same energy as pin_priv but for the dpll
  • esync — on success, this one holds the embedded sync frequency and its properties. bestie comes through with the goods 🔥
  • extack — for the error reporting, because sometimes things go wrong and we need receipts

💖 DESCRIPTION 💖

so this is a Dpll subsystem callback. it's literally the handler for getting the embedded sync frequency value of the SW pin. no cap, that's the whole job description. she shows up, she gets the frequency value, she leaves. 🌈

🧚 CONTEXT 🧚

she calls a function which acquires and releases pf->dplls.lock. so yeah, there's a lock in play — just so you know what she's doing while you're out here living your life. 🔒

⭐ RETURN ⭐

  • 0 — success 🎉 slay
  • negative — error 😭 it's giving "not today"

🦋 SEE ALSO 🦋

okay this section is long — the ice dpll family is huge and everyone's invited to the group chat. no one gets left out. 💜

okay that's the whole page, you ate that fr fr 💅✨

and finally, the little sign-off: this iconic piece of documentation lives over at ./drivers/net/ethernet/intel/ice, and she's dated October 2026. periodt. 👑🎀

📦 where this page comes from