Enum PathEvent 

#[non_exhaustive]
pub enum PathEvent {
    New(SocketAddr, SocketAddr),
    Validated(SocketAddr, SocketAddr),
    FailedValidation(SocketAddr, SocketAddr),
    Closed(SocketAddr, SocketAddr),
    ReusedSourceConnectionId(u64, (SocketAddr, SocketAddr), (SocketAddr, SocketAddr)),
    PeerMigrated(SocketAddr, SocketAddr),
    PmtuUpdated {
        local: SocketAddr,
        peer: SocketAddr,
        pmtu: usize,
    },
}

A path-specific event.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

New(SocketAddr, SocketAddr)

A new network path (local address, peer address) has been seen on a received packet. Note that this event is only triggered for servers, as the client is responsible from initiating new paths. The application may then probe this new path, if desired.

Validated(SocketAddr, SocketAddr)

The related network path between local SocketAddr and peer SocketAddr has been validated.

FailedValidation(SocketAddr, SocketAddr)

The related network path between local SocketAddr and peer SocketAddr failed to be validated. This network path will not be used anymore, unless the application requests probing this path again.

Closed(SocketAddr, SocketAddr)

The related network path between local SocketAddr and peer SocketAddr has been closed and is now unusable on this connection.

ReusedSourceConnectionId(u64, (SocketAddr, SocketAddr), (SocketAddr, SocketAddr))

The stack observes that the Source Connection ID with the given sequence number, initially used by the peer over the first pair of SocketAddrs, is now reused over the second pair of SocketAddrs.

PeerMigrated(SocketAddr, SocketAddr)

The connection observed that the peer migrated over the network path denoted by the pair of SocketAddr, i.e., non-probing packets have been received on this network path. This is a server side only event.

Note that this event is only raised if the path has been validated.

PmtuUpdated

The validated PMTU available for normal application traffic changed on the network path between local and peer.

This event is generated only while PMTUD is enabled. It reports the largest successfully probed size, falling back to QUIC’s minimum packet size while no larger size is validated. Unvalidated probe sizes and the initial minimum set when the path is created are not reported.

Fields

local: SocketAddr

The path’s local address.

peer: SocketAddr

The path’s peer address.

pmtu: usize

The current validated PMTU limit for normal application traffic.

Trait Implementations

impl Clone for PathEvent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathEvent

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

Formats the value using the given formatter.

impl Eq for PathEvent

impl PartialEq for PathEvent

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PathEvent