idpf_ptp_adj_dev_clk_fine(9)

💅 idpf_ptp_adj_dev_clk_fine — the kernel API manual, but make it make sense

okay so bestie, welcome to the idpf_ptp_adj_dev_clk_fine(9) page ✨ this is one of those kernel API manual moments and honestly it's giving "small function, big responsibilities." grab a lil snack 🍓 and let's get into it.

---

🌸 NAME 🌸

idpf_ptp_adj_dev_clk_fine — the one that sends the virtchnl adj time message 🎀

---

🦋 SYNOPSIS 🦋

int idpf_ptp_adj_dev_clk_fine (struct idpf_adapter *adapter , u64 incval
);

like, that's the whole vibe. one function, two args, returns an int. no cap. 💅

---

✨ ARGUMENTS ✨

• adapter — the driver specific private structure 🫶 this is your little home base, the driver's own private struct, and you gotta pass it in.
• incval — the source timer increment value per clock cycle ⏱️ literally the value per clock cycle that the source timer increments by. it's a u64, so it's a big girl number.

---

💖 DESCRIPTION 💖

So what does this icon actually do? It sends a virtchnl adj fine message to adjust the frequency of the clock by incval. that's it, that's the whole job 🔥 remember: adjust the frequency of the clock, by incval. not the time, not the offset, the frequency. periodt.

The virtchnl part is the message it's sending, and it's specifically the adj fine one — the fine-grained one 🎀

---

🌈 RETURN 🌈

• 0 on success 🎉 slay.
• -errno otherwise 💀 so any negative errno value means something went sideways and you should go read the error. not me finding out the hard way 🙈

---

👑 SEE ALSO 👑

okay this is the little friend group, all the PTP besties 🧚 and yes every single one is listed, i'm not skipping anyone:

• Kernel file ./drivers/net/ethernet/intel/idpf/idpf_virtchnl_ptp.c — that's where this lives, go look at the source if you want the real tea ☕
• idpf_ptp_get_caps(9)
• idpf_ptp_get_dev_clk_time(9)
• idpf_ptp_get_cross_time(9)
• idpf_ptp_set_dev_clk_time(9)
• idpf_ptp_adj_dev_clk_time(9)
• idpf_ptp_get_vport_tstamps_caps(9)
• idpf_ptp_update_tstamp_tracker(9)
• idpf_ptp_get_tstamp_value(9)
• idpf_ptp_get_tx_tstamp_async_handler(9)
• idpf_ptp_get_tx_tstamp(9)

---

💜 lowkey important reminder bestie: incval adjusts the clock's frequency, and the return is 0 on success or -errno otherwise. that's the whole contract, no guessing, iykyk.

---

and that's the page!! 🎀 this lil writeup lives under ./drivers/net/ethernet/intel/idpf, and the version/date stamp on the original was October 2026, with the header/footer naming idpf_ptp_adj_dev_clk_fine(9) — so yeah, October 2026 idpf hive, we salute you 🫶✨ go adjust some clocks, you absolute main character. 💅🌟