Enum ClockError 

pub enum ClockError {
    Unavailable(String),
    NotSynced(String),
    InvalidSampleRate(u32),
    ConversionOverflow,
    Core(AudioError),
    Io(Error),
}

Errors returned by clock-source operations.

These cover the two concerns of this crate:

• Clock availability / sync — whether a usable time reference exists at all (PTP daemon reachable, NTP synced). Represented by ClockError::Unavailable and ClockError::NotSynced.
• Conversion integrity — sample-rate validation and the checked arithmetic that guards crate::ClockSource::sample_to_ptp / crate::ClockSource::ptp_to_sample against overflow. Represented by ClockError::InvalidSampleRate, ClockError::ConversionOverflow, and the core-delegated ClockError::Core.

Variants

Unavailable(String)

No clock source is available on this host (e.g. no PTP daemon running, no PTP-capable NIC).

NotSynced(String)

The clock exists but has not yet synchronised (e.g. NTP still converging, PTP master not yet locked).

InvalidSampleRate(u32)

The provided sample rate is not a positive, supported value.

ConversionOverflow

A sample-index ↔ timestamp conversion would overflow i64.

This indicates an anchor or sample index absurdly far from the clock’s reference point; callers should re-anchor closer to the working range.

Core(AudioError)

A validation failure delegated to the shared core types.

Io(Error)

A raw I/O error from the operating system (e.g. reading a PTP device).

Trait Implementations

impl Debug for ClockError

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

Formats the value using the given formatter.

impl Display for ClockError

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

Formats the value using the given formatter.

impl Error for ClockError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<AudioError> for ClockError

fn from(source: AudioError) -> Self

Converts to this type from the input type.

impl From<Error> for ClockError

fn from(source: Error) -> Self

Converts to this type from the input type.