pub struct ClockCapabilities {
pub os: &'static str,
pub arch: &'static str,
pub can_read: bool,
pub can_discipline: bool,
pub discipline_requirement: &'static str,
pub slew_resolution_ppm: Option<f64>,
pub max_slew_ppm: f64,
pub batch_receive: bool,
pub mono_resolution_ns: Option<f64>,
}Expand description
What this machine can actually do, probed without perturbing the clock.
Deliberately separates reading from disciplining: reading needs no privilege anywhere, disciplining needs it everywhere, and a daemon that cannot tell the difference reports “working” while silently never correcting anything. The smoke rigs assert on these fields.
Fields§
§os: &'static str§arch: &'static str§can_read: boolWall and monotonic clocks readable.
can_discipline: boolWhether this process holds what disciplining requires. Probed by inspecting privileges, never by attempting an adjustment — a probe that moves the clock to find out whether it may is not a probe.
discipline_requirement: &'static strWhat disciplining needs here, for the operator who has false above.
slew_resolution_ppm: Option<f64>Granularity of the platform’s frequency-adjustment knob, in ppm.
None where the platform exposes no frequency knob at all.
max_slew_ppm: f64Ceiling the platform imposes on frequency adjustment, in ppm.
batch_receive: boolWhether receives are batched (one syscall for many datagrams).
mono_resolution_ns: Option<f64>Measured granularity of a monotonic clock read, nanoseconds.