Skip to main content

ProgressListener

Struct ProgressListener 

Source
pub struct ProgressListener { /* private fields */ }
Available on crate feature std only.
Expand description

A registered wake-up from Trunk::listen — the event_listener::EventListener a ServedEgress adapter waits on, so a blocked request need not busy-poll. See The reader-wake primitive.

Releases this Trunk’s bounded waiter slot when dropped (via the _slot field’s own Drop, see this module’s internal WaiterSlot) — whether this listener was woken, timed out, or is simply discarded — so a caller that gives up does not leak a slot forever.

Implementations§

Source§

impl ProgressListener

Source

pub fn wait_deadline(self, deadline: Instant) -> bool

Block the calling thread until woken or deadline passes, whichever comes first — true if woken, false on timeout. Composes with crate::egress::AwaitPolicy’s deadline: convert AwaitPolicy::deadline (a Timestamp) to the std::time::Instant your caller already anchors its Timestamps to (see Timestamp::from_instant’s inverse — the caller holds the base Instant it built its Timestamps from) and pass that here, so this call can never park past the caller’s own bound.

Deliberately no unbounded wait() is exposed here — only this deadline-bound form and the Future impl below (whose bound is whatever timeout the caller’s own executor wraps it in, exactly the hls_runtime::server “caller-driven wait loop” shape) — matching this crate’s crate::egress::AwaitPolicy philosophy that a wait on remote-triggerable input must never be able to park forever.

Trait Implementations§

Source§

impl Future for ProgressListener

Source§

type Output = ()

The type of value produced on completion.
Source§

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available. Read more

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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<F> IntoFuture for F
where F: Future,

Source§

type Output = <F as Future>::Output

The output that the future will produce on completion.
Source§

type IntoFuture = F

Which kind of future are we turning this into?
Source§

fn into_future(self) -> <F as IntoFuture>::IntoFuture

Creates a future from a value. Read more
Source§

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

Source§

type Error = Infallible

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.