Skip to main content

ExchangeControls

Struct ExchangeControls 

Source
pub struct ExchangeControls { /* private fields */ }
Expand description

A payload-free SHM table with a fixed number of records per caller lane. Its kind and capacity belong to the protocol that opts into the table.

Implementations§

Source§

impl ExchangeControls

Source

pub fn open( segment: Arc<LinkSegment>, kind: u8, slots_per_lane: u32, ) -> Result<Self>

Open the control table in the Link’s exact namespace and access scope. The kind must be distinct from all other resources in that namespace.

Source

pub fn reserve( self: &Arc<Self>, caller: &Joined, runner: usize, runner_epoch: u64, ) -> Result<Option<ExchangeControl>>

Reserve in the caller’s own lane. A full table leaves dispatch to the protocol. Hold the returned lease until the reply is delivered or the caller stops waiting. None means all records are in use.

Source

pub fn state( &self, ticket: ExchangeControlTicket, ) -> Result<ExchangeControlState>

Read the latest control state. A reclaimed or released ticket is stale. For the Runner, caller-side staleness also ends the wait. For the caller, Runner retirement alone cannot prove failure: drain committed replies after producer recovery before abandoning a stale exchange.

To await a change, drive the local inbox receiver and recheck after Received::Capacity or a directory change. The bell carries no result.

Source

pub fn caller_state( &self, ticket: ExchangeControlTicket, ) -> Result<ExchangeControlState>

Read the caller’s terminal record even after the Runner’s lane has been retired. An unchanged pending record still requires inbox recovery.

Source

pub fn fail( &self, runner: &Joined, ticket: ExchangeControlTicket, ) -> Result<bool>

Record a permanent failure to publish a reply that has never been committed. A transient full inbox does not fail an exchange. Runner death is not a failure publication: a reply may already be committed. Recover the dead producer and drain its committed replies.

Unlink this resource once all participants have stopped.

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> 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, 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, !>

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