Skip to main content

TimerBackend

Enum TimerBackend 

Source
#[non_exhaustive]
pub enum TimerBackend { SleepSlice, Condvar, }
Expand description

Which primitive the process-wide release thread waits on.

Descriptive, not a knob: the wheel picks the best available backend and records what it got. MOQTAP_RELEASE_TIMER overrides it only to diagnose a host.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

SleepSlice

One dedicated OS thread sleeping in SLICE-bounded std::thread::sleep steps and parking on an untimed Condvar when no deadline is armed. The backend on every platform, and sub-millisecond on all of them: measured p50 lateness 0.11-0.17 ms, p95 0.52-0.57 ms on Windows 11.

§

Condvar

std::sync::Condvar::wait_timeout, reachable only by setting MOQTAP_RELEASE_TIMER=condvar. Precise on Unix, where it is backed by a CLOCK_MONOTONIC hrtimer; on Windows it is bounded below by the ~15.6 ms system tick (measured p50 lateness 12.26 ms for a 3 ms deadline) and is the forced-diagnosis backend rather than a fallback.

Implementations§

Source§

impl TimerBackend

Source

pub const fn is_high_resolution(self) -> bool

Whether this backend can resolve delays below the ~15.6 ms Windows system tick.

SleepSlice => true on every platform. Condvar => cfg!(unix) — platform-dependent, because it is the good primitive on Unix and the degraded one on Windows, and the type says so rather than the reader having to know.

Source

pub const fn as_str(self) -> &'static str

A stable, lowercase, machine-readable name for reports: "sleep-slice" / "condvar".

Trait Implementations§

Source§

impl Clone for TimerBackend

Source§

fn clone(&self) -> TimerBackend

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for TimerBackend

Source§

impl Debug for TimerBackend

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for TimerBackend

Source§

impl PartialEq for TimerBackend

Source§

fn eq(&self, other: &TimerBackend) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for TimerBackend

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more