STRUCT PTP_CLOCK_REQUEST(9)

💖 NAME 💖

okay so bestie, this page is struct ptp_clock_request(9) from the Kernel API Manual, and it's literally here to request PTP clock event. that's the whole name vibe 🫶

✨ SYNOPSIS ✨

here's the struct in all her glory — keep every character exactly as written, she's precise 💅

       struct ptp_clock_request {
           enum {
             PTP_CLK_REQ_EXTTS,
             PTP_CLK_REQ_PEROUT,
             PTP_CLK_REQ_PPS,
           } type;
           union {
             struct ptp_extts_request extts;
             struct ptp_perout_request perout;
           };
        };

so yeah: there's a type enum, and an anonymous union holding extts and perout. iconic structure behavior, no cap ✨

🫶 Members 🫶

let's meet the members, bestie:

• type — the type of the request. the enum options are:
  • PTP_CLK_REQ_EXTTS — configure external trigger timestamping.
  • PTP_CLK_REQ_PEROUT — configure periodic output signal (e.g. PPS).
  • PTP_CLK_REQ_PPS — trigger internal PPS event for input into kernel PPS subsystem.
• {unnamed_union} — anonymous. that's it, she's unnamed and unbothered 💅
• extts — describes configuration for external trigger timestamping. this is only valid when event == PTP_CLK_REQ_EXTTS.
• perout — describes configuration for periodic output. this is only valid when event == PTP_CLK_REQ_PEROUT.

🎀 SEE ALSO 🌈

the kernel file ./include/linux/ptp_clock_kernel.h is the home base, and here's the whole related squad — every single one, fr fr:

• struct ptp_system_timestamp(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)

okay that's the whole page bestie 💖 source/version is ./include/linux, dated October 2026, and the page tag is struct ptp_clock_request(9) 🎀✨