PathEvent in quiche

PathEvent in quiche - Rust

pub enum PathEvent {
    New(SocketAddr, SocketAddr),
    Validated(SocketAddr, SocketAddr),
    FailedValidation(SocketAddr, SocketAddr),
    Closed(SocketAddr, SocketAddr),
    ReusedSourceConnectionId(u64, (SocketAddr, SocketAddr), (SocketAddr, SocketAddr)),
    PeerMigrated(SocketAddr, SocketAddr),
}

Expand description

A path-specific event.

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.

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

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.

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

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.

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.

Source §

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

1.0.0 · Source§

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

Source §