Skip to main content

ntpsec_rs_core/
ntp_refclock.rs

1// ──── ntp_refclock.rs ───────────────────────────────────────────────────────
2// Forensic reconstruction of include/ntp_refclock.h, ntpd/ntp_refclock.c
3//
4// Reference clock base infrastructure: clock driver registration, I/O
5// handling, and sample processing.
6// =============================================================================
7
8use crate::ntp_types::*;
9
10/// Reference clock type identifier.
11pub type RefClockId = u32;
12
13/// Reference clock unit number (127.127.X.Y).
14pub type RefClockUnit = u32;
15
16/// A reference clock sample.
17#[derive(Debug, Clone, Copy)]
18pub struct RefClockSample {
19    pub offset: f64,
20    pub delay: f64,
21    pub dispersion: f64,
22    pub time: NtpTs64,
23    pub leap: LeapIndicator,
24}
25
26/// Reference clock driver interface.
27pub trait RefClockDriver: std::fmt::Debug {
28    fn name(&self) -> &'static str;
29    fn type_id(&self) -> RefClockId;
30    fn poll(&mut self) -> Option<RefClockSample>;
31    fn timeout(&self) -> u32;
32}
33
34/// Reference clock registry.
35#[derive(Debug, Default)]
36pub struct RefClockRegistry {
37    drivers: Vec<Box<dyn RefClockDriver + Send>>,
38}
39
40impl RefClockRegistry {
41    pub fn new() -> Self {
42        Self {
43            drivers: Vec::new(),
44        }
45    }
46
47    pub fn register(&mut self, driver: Box<dyn RefClockDriver + Send>) {
48        self.drivers.push(driver);
49    }
50
51    pub fn drivers(&self) -> &[Box<dyn RefClockDriver + Send>] {
52        &self.drivers
53    }
54}