Enum SessionErrorCode 

#[repr(u64)]
pub enum SessionErrorCode {
    NoError = 0,
    InternalError = 1,
    Unauthorized = 2,
    ProtocolViolation = 3,
    InvalidRequestId = 4,
    DuplicateTrackAlias = 5,
    KeyValueFormattingError = 6,
    InvalidRequiredRequestId = 7,
    InvalidPath = 8,
    MalformedPath = 9,
    GoawayTimeout = 16,
    ControlMessageTimeout = 17,
    DataStreamTimeout = 18,
    AuthTokenCacheOverflow = 19,
    DuplicateAuthTokenAlias = 20,
    VersionNegotiationFailed = 21,
    MalformedAuthToken = 22,
    UnknownAuthTokenAlias = 23,
    ExpiredAuthToken = 24,
    InvalidAuthority = 25,
    MalformedAuthority = 26,
}

Session Termination Error Codes (draft-17, Section 14.5.1).

The registry table is in Section 14.5.1; the per-code descriptions carried on the variants below are the ones given in Section 3.5 of the draft.

The table’s last row reserves 0x7f * N + 0x9D for greasing (Section 13). Greasing code points are not a contiguous range and carry no semantics a decoder can act on, so they get no variants and from_u64 rejects them like any other unassigned value.

Variants

NoError = 0

NO_ERROR — The session is being terminated without an error.

InternalError = 1

INTERNAL_ERROR — An implementation specific error occurred.

Unauthorized = 2

UNAUTHORIZED — The client is not authorized to establish a session.

ProtocolViolation = 3

PROTOCOL_VIOLATION — The remote endpoint performed an action that was disallowed by the specification.

InvalidRequestId = 4

INVALID_REQUEST_ID — The endpoint received a Request ID with an incorrect least significant bit for the sender, or a duplicate Request ID. See Section 9.1.

DuplicateTrackAlias = 5

DUPLICATE_TRACK_ALIAS — The endpoint attempted to use a Track Alias that was already in use.

KeyValueFormattingError = 6

KEY_VALUE_FORMATTING_ERROR — The key-value pair has a formatting error.

InvalidRequiredRequestId = 7

INVALID_REQUIRED_REQUEST_ID — The endpoint received a Required Request ID Delta that results in an invalid Request ID. See Section 9.2.

InvalidPath = 8

INVALID_PATH — The PATH parameter was used by a server, on a WebTransport session, or the server does not support the path.

MalformedPath = 9

MALFORMED_PATH — The PATH parameter does not conform to the rules in Section 9.4.1.2.

GoawayTimeout = 16

GOAWAY_TIMEOUT — The session was closed because the peer took too long to close the session in response to a GOAWAY (Section 9.5) message. See session migration (Section 3.6).

ControlMessageTimeout = 17

CONTROL_MESSAGE_TIMEOUT — The session was closed because the peer took too long to respond to a control message.

DataStreamTimeout = 18

DATA_STREAM_TIMEOUT — The session was closed because the peer took too long to send data expected on an open Data Stream (see Section 10). This includes fields of a stream header or an object header within a data stream. If an endpoint times out waiting for a new object header on an open subgroup stream, it MAY send a STOP_SENDING on that stream or terminate the subscription.

AuthTokenCacheOverflow = 19

AUTH_TOKEN_CACHE_OVERFLOW — The Session limit Section 9.4.1.3 of the size of all registered Authorization tokens has been exceeded.

DuplicateAuthTokenAlias = 20

DUPLICATE_AUTH_TOKEN_ALIAS — Authorization Token attempted to register an Alias that was in use (see Section 9.3.2).

VersionNegotiationFailed = 21

VERSION_NEGOTIATION_FAILED — The client didn’t offer a version supported by the server.

MalformedAuthToken = 22

MALFORMED_AUTH_TOKEN — Invalid Auth Token serialization during registration (see Section 9.3.2).

UnknownAuthTokenAlias = 23

UNKNOWN_AUTH_TOKEN_ALIAS — No registered token found for the provided Alias (see Section 9.3.2).

ExpiredAuthToken = 24

EXPIRED_AUTH_TOKEN — Authorization token has expired (Section 9.3.2).

InvalidAuthority = 25

INVALID_AUTHORITY — The specified AUTHORITY does not correspond to this server or cannot be used in this context.

MalformedAuthority = 26

MALFORMED_AUTHORITY — The AUTHORITY value is syntactically invalid.

Implementations

impl SessionErrorCode

pub const ALL: &[SessionErrorCode]

Every Session Error Code draft-17 assigns, in ascending wire order.

This is the set Self::from_u64 accepts, written out so that it can be enumerated: nothing can iterate an enum’s variants, so a caller that wants the registry has to be handed it. Writing it down is also what lets a test state its claims about the registry itself rather than about the range some sweep happens to reach — that this is the set from_u64 answers to, and that none of it lands in the range the draft reserves for greasing.

pub fn from_u64(v: u64) -> Option<Self>

Convert a raw u64 to a SessionErrorCode, if valid.

Returns None for any code draft-17 does not define, including the greasing range. Unknown codes arrive on the wire routinely and are not an error for the decoder.

pub fn as_u64(self) -> u64

Return the raw u64 value of this error code.

Trait Implementations

impl Clone for SessionErrorCode

fn clone(&self) -> SessionErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SessionErrorCode

impl Debug for SessionErrorCode

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

Formats the value using the given formatter.

impl Eq for SessionErrorCode

impl PartialEq for SessionErrorCode

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SessionErrorCode