ice_dpll_txclk_work(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ice_dpll_txclk_work — the kernel API manual, bestie edition 🎀

okay so this is ice_dpll_txclk_work(9) from the Kernel API Manual and honestly? she's a little worker bee with main character energy. let's get into it 🐝✨

✨ NAME ✨

ice_dpll_txclk_work — applies a pending TX reference clock change 💖

like, the switch you asked for earlier? yeah, this is the part that actually goes and does it. no cap.

🦋 SYNOPSIS 🦋

void ice_dpll_txclk_work (struct work_struct *work );

that's it. one argument. she's lowkey minimalist about it. 💅

🌸 ARGUMENTS 🌸

  • work — a work_struct that's embedded in struct ice_dplls. that's the whole thing, that's the vibe check. it's not some random work struct, it lives inside the ice_dplls struct, iykyk 🫶

👑 DESCRIPTION 👑

okay so picture this: earlier, somebody queued up a TX reference clock switch request through the DPLL TXCLK pin set callback. this worker? it's the one who actually executes that outstanding request. she shows up, she does the job, she leaves ✨

and here's the important part — she performs only the operational part of the switch. that means she issues the necessary firmware commands to request a new TX reference clock selection (think: triggering an AN restart 🔁). that's her whole contribution.

what she does NOT do is verify whether the requested clock was ultimately accepted by the hardware. nope, not her job, not her problem, she's just the messenger fr fr 💀

all the heavy lifting verification stuff happens later, after link-up, over in ice_txclk_update_and_notify. that's where you get:

  • hardware verification ✅
  • software state reconciliation ✅
  • pin state notification ✅
  • TXC DPLL lock-status updates ✅

so like… don't @ her about hardware confirmation. she literally doesn't do that. 🙈

🔥 CONTEXT 🔥

  • Runs in process context on pf->dplls.wq and may sleep 😴 — yes bestie, she can sleep, it's fine, she's allowed
  • Serializes access to shared TXCLK state using pf->dplls.lock 🔒 — no racing, no chaos, we stay locked and loaded

🧚 SEE ALSO 🧚

okay this list is long long, so buckle up buttercup 🌈 everything here is in the kernel file ./drivers/net/ethernet/intel/ice/ice_dpll.c, plus the enum and all the friends:

see? told you it was a whole friend group 😭💜

and that's the tea, bestie 🍓 this little page came from ./drivers/net/ethernet/intel/ice and it's dated October 2026 — remember it fondly, she ate and left no crumbs 👑✨💅

📦 where this page comes from