Struct NtpClient 

pub struct NtpClient;

SNTP client for network-based time synchronization.

Queries an NTP server via UDP and returns the estimated clock offset. This is intentionally simple (single-packet, no association state) and is suitable for one-shot synchronization of distributed camera systems where NTP precision (≈ 1–50 ms) is adequate.

Example

use oximedia_align::temporal::{NtpClient, NtpConfig};

let config = NtpConfig {
    server: "pool.ntp.org".to_string(),
    port: 123,
    timeout_ms: 3_000,
};
// In production; requires network access:
// let delta = NtpClient::query_offset(&config).unwrap();
// println!("Clock offset: {} ms", delta.offset_ms);

Implementations

impl NtpClient

pub fn query_offset(config: &NtpConfig) -> AlignResult<TimeDelta>

Query an NTP server and compute the clock offset for the local clock.

Makes a single SNTP request (Mode 3 / Client) and parses the 48-byte NTP response packet to extract the four timestamps required for the RFC 4330 §5 offset formula.

Errors

Returns AlignError::SyncError if:

• The server address cannot be resolved.
• The UDP socket cannot be bound or the send/receive fails.
• The response is shorter than 48 bytes or has an invalid leap/mode.