Enum SessionEvent 

pub enum SessionEvent {
    Ended {
        peer: NodeId,
        epoch: u64,
    },
    Established {
        peer: NodeId,
        epoch: u64,
    },
}

Something happened to the session with a peer.

These are two distinct events and neither substitutes for the other, because a real endpoint learns them separately and can act on only one.

An ending is synchronous and knowable: the operating system closes the handle and the next read or write fails, so a protocol learns at the moment of failure that its last writes may be gone. It cannot act on that, the peer being unreachable.

An establishment is what can be acted on. It happens when the link manages to reconnect — a deployed link keeps trying on its own — so it arrives at a moment the layers above neither choose nor control.

This is a domain concept, not a simulator one: a simulated network and an adapter over TCP or QUIC report the same thing, because it is what a real endpoint learns.

Variants

Ended

The session with peer has ended. An unknown suffix of what was in flight may be lost.

epoch is the one that ended, not a prediction of the next: at the moment of failure the next epoch is not a fact, and may never become one.

Fields

peer: NodeId

epoch: u64

Established

A session with peer is in force at epoch. The peer can be reached again.

This is the event on which anything must be resent, and the only one on which a resend can succeed.

Fields

peer: NodeId

epoch: u64

Implementations

impl SessionEvent

pub fn peer(&self) -> NodeId

pub fn epoch(&self) -> u64

Trait Implementations

impl Clone for SessionEvent

fn clone(&self) -> SessionEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SessionEvent

impl Debug for SessionEvent

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

Formats the value using the given formatter.

impl Eq for SessionEvent

impl Hash for SessionEvent

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SessionEvent

fn cmp(&self, other: &SessionEvent) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for SessionEvent

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for SessionEvent

fn partial_cmp(&self, other: &SessionEvent) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for SessionEvent