Struct Discipline 

pub struct Discipline { /* private fields */ }

Implementations

impl Discipline

pub fn new(cfg: DisciplineConfig) -> Self

pub fn freq_ppm(&self) -> f64

Current commanded frequency correction, ppm.

pub fn poll_log2(&self) -> i8

pub fn on_estimate( &mut self, offset: f64, freq_ppm_meas: Option<f64>, offset_sd: f64, ) -> Plan

Feed the latest combined estimate.

• offset — seconds to add to the local clock, now.
• freq_ppm_meas — residual frequency error from the regression (ppm, positive = local slow), if trusted.
• offset_sd — residual noise of the estimate.

pub fn on_estimate_with_leap( &mut self, offset: f64, freq_ppm_meas: Option<f64>, offset_sd: f64, leap_pending: bool, ) -> Plan

As Discipline::on_estimate, told whether the source has announced a leap second for the current UTC day.

pub fn retry_interval_s(&self) -> f64

How long to wait before trying again when an exchange yields nothing — lost, or rejected because the server was not yet usable.

This is the iburst spacing while the burst budget lasts, not the poll interval. A server that has only just started answers its first requests with the unsynchronised leap indicator, which a client must refuse; if that refusal then costs a full poll interval, a cold start is delayed by 16 seconds before the first usable sample. Measured against chrony under clknetsim, that single wait was most of an 8x convergence gap.

Nothing is consumed here: a failed exchange must not spend burst budget, or a few early losses would silently end the burst.

Trait Implementations

impl Clone for Discipline

fn clone(&self) -> Discipline

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Discipline

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

Formats the value using the given formatter.