Struct PhcClock 

pub struct PhcClock { /* private fields */ }

PTP Hardware Clock (PHC) accessed via /dev/ptpN.

This provides direct access to the NIC’s hardware clock through the Linux PTP subsystem. The PHC can be read with nanosecond precision and disciplined independently of the system clock.

The internal Mutex ensures that read-modify-write operations like step() are atomic with respect to concurrent callers.

Implementations

impl PhcClock

pub fn open(device: &str) -> Result<Self, ClockError>

Open a PTP hardware clock device.

device should be a path like /dev/ptp0. The device must exist and be readable by the current process.

pub fn read_time(&self) -> Result<PtpTimestamp, ClockError>

Read the PHC time as a PtpTimestamp.

Uses clock_gettime with the dynamic clockid derived from the PHC file descriptor.

pub fn device_path(&self) -> &str

Get the device path this clock was opened from.

pub fn as_raw_fd(&self) -> c_int

Get the raw file descriptor (for advanced ioctl operations).

pub fn clockid(&self) -> clockid_t

Get the dynamic clockid for this PHC.

Trait Implementations

impl Clock for PhcClock

fn now(&self) -> Result<NtpTimestamp, ClockError>

Read current time from this clock.

fn step(&self, offset: NtpDuration) -> Result<(), ClockError>

Apply a step adjustment (instant offset). Requires privilege.

fn adjust_frequency(&self, ppm: f64) -> Result<(), ClockError>

Apply a slew adjustment (frequency change in PPM). Requires privilege.

fn frequency_offset(&self) -> Result<f64, ClockError>

Read current frequency offset in PPM.

fn resolution(&self) -> NtpDuration

Get clock resolution as a duration.

fn max_frequency_adjustment(&self) -> f64

Maximum allowed frequency adjustment in PPM.

fn is_adjustable(&self) -> bool

Whether this clock supports discipline (has CAP_SYS_TIME or equivalent).

impl Debug for PhcClock

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.