Struct PinnedEndpoint 

pub struct PinnedEndpoint<'a> { /* private fields */ }

Pinned snapshot of a virtual endpoint’s target. Captures the registry generation at pin time; one Acquire load on is_still_valid() detects rebinds.

Implementations

impl<'a> PinnedEndpoint<'a>

pub fn id(&self) -> EndpointId

Endpoint id this pin was captured for.

pub fn pinned_generation(&self) -> u64

Generation captured at pin time.

pub fn is_still_valid(&self) -> bool

One Acquire load on the registry’s generation counter. Returns true while the pin is current; false if any bind / unbind has happened on ANY endpoint in the registry since pin time.

The coarse-grained check is intentional: a registry-wide generation is one atomic load per check, vs per-endpoint generations which require lookup + dereference. Callers that pin many endpoints in a tight loop trade some false-positive re-acquires for a much cheaper validity check.

pub fn as_local(&self) -> Option<&Arc<LocaleAdaptiveRing>>

Returns Some(&Arc<LocaleAdaptiveRing>) when the captured target is local, None otherwise. The Arc is borrowed from the pinned target snapshot and lives for the pin’s lifetime.

pub fn as_remote(&self) -> Option<&RemoteEndpoint>

Returns Some(&RemoteEndpoint) when the captured target is remote, None otherwise.