zl3073x_dpll_ptp_adjtime(9)

📦 version 7.3.1, in nixpkgs unstable

💅 zl3073x_dpll_ptp_adjtime (9) — Kernel API Manual ✨

okay so bestie, welcome to the glow-up era of the ZL3073X DPLL driver 🦋 this little function lives in the Kernel API Manual, and honestly? she's doing a LOT of heavy lifting with PTP clock time adjustments. let's get into it 💖

🌸 NAME 🌸

zl3073x_dpll_ptp_adjtime — literally the function that adjusts PTP clock time, no cap ⏰✨

🎀 SYNOPSIS 🎀

int zl3073x_dpll_ptp_adjtime (struct ptp_clock_info *info , s64 delta );

🦋 ARGUMENTS 🦋

  • info — the PTP clock info, aka the main character struct we're working with 👑
  • delta — the time adjustment, measured in nanoseconds ⏱️ (yes we're in nano territory, she's precise)

💜 DESCRIPTION 💜

okay so this is where it gets iconic. for NCO, large deltas (>= 1 second — that's a big girl delta 💀) get split up: a ToD read-modify-write handles the seconds part, and an output phase step handles the sub-second remainder. 🫶

sub-second deltas? those use phase step directly. but if phase step or the TIE write fails, she falls back to the ToD read-modify-write — resilient queen behavior, we love to see it ✨

in AUTO/REFLOCK modes, the vibe shifts a little: large deltas get split into a ToD read-modify-write for the seconds and a TIE write for the sub-second remainder. sub-second deltas just use the TIE write directly. simple, clean, slay 🌈

🚨 okay important caveat bestie, don't skip this: if the seconds part was already committed when the sub-second mechanism fails, the function returns 0. why? to prevent the PTP servo from retrying the full delta and applying the seconds again 😭 ff that would be a disaster. so she takes the L gracefully and reports success so nothing gets double-applied. periodt.

⭐ RETURN ⭐

  • 0 on success (or partial success — she's doing her best okay 💅)
  • <0 on error 💀

👑 SEE ALSO 👑

the whole squad, fr fr — Kernel file ./drivers/dpll/zl3073x/dpll.c, struct zl3073x_dpll_pin(9), and like, the entire friend group:

and that's the whole page bestie!! 🎀 this one's sourced from ./drivers/dpll/zl3073x and dated October 2026 — iykyk, she's a future icon 💜✨ go forth and adjust those clocks fr fr 🦋💅

📦 where this page comes from