ice_sync_phy_timer_eth56g(9)

📦 version 7.3.1, in nixpkgs unstable

💖 ice_sync_phy_timer_eth56g — bestie edition 💖

okay so this is a page from the Kernel API Manual, and it's literally about ice_sync_phy_timer_eth56g — the little function that makes the PHY timer and the PHC timer finally agree on what time it is. no cap, it's a whole vibe. 🕐✨

🌸 NAME 🌸

ice_sync_phy_timer_eth56g — synchronize the PHY timer with the PHC timer. that's it, that's the whole job, and she does it flawlessly. 💅

🦋 SYNOPSIS 🦋

int ice_sync_phy_timer_eth56g (struct ice_hw *hw , u8 port );

🎀 ARGUMENTS 🎀

  • hw — pointer to the HW struct. yes, the whole hardware situation, handed to you. iconic.
  • port — the PHY port we're synchronizing. which one? this one. 🫶

✨ DESCRIPTION ✨

okay so picture this: you've got two clocks, the PHY timer and the PHC timer, and they're not matching, which is giving lowercase energy. so this function performs an adjustment to make sure the PHY and PHC timers are in sync. periodt. 💀

how? the way that it does it is by issuing an ICE_PTP_READ_TIME command, which triggers a simultaneous read of the PHY timer and the PHC timer — like a little photoshoot where both clocks say cheese at the exact same moment 📸. then we take the difference and use it to calculate an appropriate 2s complement addition to add to the PHY timer, so that it reads the same value as the primary PHC timer. and that's the whole glow-up. the PHY timer now matches. slay. 👑

🌈 RETURN 🌈

  • 0 — success. we love to see it. 🎉
  • -EBUSY — failed to acquire PTP semaphore. someone else is holding the lock, bestie, not our moment. 😭
  • other — PHY read/write failed. yeah... something went wrong in the read/write department. 💀

👑 SEE ALSO 👑

the kernel file lives at ./drivers/net/ethernet/intel/ice/ice_ptp_hw.c — go read it, it's giving main character energy.

and now, the friend group, in all its glory (no cap, every single one of these is literally on the list):

🫶 friendly reminder: if you get -EBUSY, the PTP semaphore is busy — not you, bestie. try again later. 💜

okay bye, this page came from ./drivers/net/ethernet/intel/ice and it's dated October 2026, and it was literally a whole moment. mwah. 💋🎀✨

📦 where this page comes from