STRUCT PTP_SYSTEM_TIMESTAMP(9)

💖 struct ptp_system_timestamp(9) 💖

okay so bestie, welcome to the Kernel API Manual — today's main character is struct ptp_system_timestamp, and trust me, she is that girl. this whole page is about one lil struct whose whole job is holding onto the system time that lines up with a PHC timestamp. no cap. let's get into it 🎀

✨ NAME ✨

struct ptp_system_timestamp — literally the system time corresponding to a PHC timestamp 🕰️✨

🌸 SYNOPSIS 🌸

here's the whole glow-up, verbatim, don't touch the formatting pls:

struct ptp_system_timestamp {
    struct system_time_snapshot pre_sts;
    struct system_time_snapshot post_sts;
    clockid_t clockid;
 };

🦋 Members 🦋

the squad, one by one:

• pre_sts — the system time snapshot from before capturing PHC. she's the "before" pic 📸
• post_sts — the system time snapshot from after capturing PHC. the "after" pic, obviously 💅
• clockid — the clock-base used for capturing the system timestamps. the vibe check of which clock we're on ⏰

👑 SEE ALSO 👑

go read the kernel file ./include/linux/ptp_clock_kernel.h first (iykyk), and then the whole friend group:

• struct ptp_clock_request(9)
• struct ptp_clock_info(9)
• struct ptp_clock_event(9)
• scaled_ppm_to_ppb(9)
• diff_by_scaled_ppm(9)
• adjust_by_scaled_ppm(9)
• ptp_clock_register(9)
• ptp_clock_unregister(9)
• ptp_clock_event(9)
• ptp_clock_index(9)
• ptp_clock_index_by_of_node(9)
• ptp_clock_index_by_dev(9)
• ptp_find_pin(9)
• ptp_find_pin_unlocked(9)
• ptp_schedule_worker(9)
• ptp_cancel_worker_sync(9)
• ptp_get_vclocks_index(9)
• ptp_convert_timestamp(9)

fr fr, ptp_clock_event(9) is in there twice — that's not me being messy, that's exactly how the original lists it. copying it faithfully is the assignment 💖

and that's the whole page, bestie 🫶 sourced from ./include/linux, dated October 2026, filed under struct ptp_system_timestamp(9) — slay, iconic, periodt 💅✨🌈