Struct ConnectionMembership 

pub struct ConnectionMembership { /* private fields */ }

One connection’s membership binding (ACCESS-006 R1, R6): the gate, the connection’s id and the verified subject from its one Connect, or the exact reason it has none.

Dropped with the connection’s state on every teardown path, releasing the bindings it held.

Implementations

impl ConnectionMembership

pub fn bind( gate: Option<Arc<MembershipGate>>, pid: u64, session: Option<&dyn LysSession>, ) -> Self

Binds connection pid at Connect: the subject is the admitted Lys session’s holder, or none. Without a gate nothing is protected.

pub fn gate(&self) -> Option<&Arc<MembershipGate>>

The gate, when one is bound.

pub fn holder(&self) -> Result<&MembershipSubject, MembershipRefusal>

The verified subject, or why there is none.

Errors

MembershipRefusal::HolderUnverified without a gate or a holder; the subject’s own refusal otherwise.

pub fn admit_connect(&self) -> Result<Option<u64>, MembershipRefusal>

Scoped guest admission for this connection’s holder at Connect.

Errors

As for MembershipGate::admit_connect; the holder’s own refusal.

pub fn check( &self, channel: &str, action: MembershipAction, ) -> Result<Decided, MembershipRefusal>

Decides action on channel for this connection.

Errors

As for MembershipGate::check; a protected channel on a connection with no verified subject refuses with that subject’s cause.

pub fn release( &self, channel: &str, action: MembershipAction, ) -> Result<Decided, MembershipRefusal>

Self::check at a final data-release seam.

Errors

As for Self::check.

pub fn release_conversation( &self, conversation: u64, ) -> Result<Decided, MembershipRefusal>

Self::release for a participant conversation, on the channel the mapping places it under; an unmapped conversation is not protected.

Errors

As for Self::check.

impl ConnectionMembership

pub fn release_check( &self, channel: &str, action: MembershipAction, ) -> Option<ReleaseCheck>

The final release check a queued delivery owner carries for action on the protected channel (ACCESS-006 R3): None when the channel is not protected or the connection has no verified subject (its admission was already refused, so no such owner exists).

Trait Implementations

impl Debug for ConnectionMembership

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

Formats the value using the given formatter.

impl Default for ConnectionMembership

fn default() -> Self

Returns the “default value” for a type.

impl Drop for ConnectionMembership

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.