Enum ConnectionError 

pub enum ConnectionError {
    Endpoint(EndpointError),
    Codec(CodecError),
    Transport(TransportError),
    VarInt(VarIntError),
    NoControlStream,
    UnexpectedEnd,
    StreamFinished,
    InvalidAddress(String),
    TlsConfig(String),
    DataStreamState(&'static str),
    ExtensionsOnNonNormalStatus {
        object_id: u64,
        extensions_len: usize,
        status: ObjectStatus,
    },
}

Errors from the connection layer.

Variants

Endpoint(EndpointError)

Endpoint state machine error.

Codec(CodecError)

Wire codec error.

Transport(TransportError)

Transport-level error.

VarInt(VarIntError)

Variable-length integer decoding error.

NoControlStream

Control stream was not opened.

UnexpectedEnd

Stream ended before a complete message was read.

StreamFinished

Stream was finished by the peer.

InvalidAddress(String)

Invalid server address string.

TlsConfig(String)

TLS configuration error.

DataStreamState(&'static str)

Data stream used out of order (e.g. object before header).

ExtensionsOnNonNormalStatus

An Object arrived carrying extension headers on a status that is not Normal.

Draft-15 Section 10.2.1.2: “Any Object with status Normal can have extension headers. If an endpoint receives extension headers on Objects with status that is not Normal, it MUST close the session with a PROTOCOL_VIOLATION.”

The codec decodes such an Object rather than refusing it — the frame is well formed, and a tool that reports non-conforming traffic has to be able to read it. Being an endpoint rather than an observer is what turns it into an error, so it is raised here, on the receive path, and not in the decoder.

Connection::close_for_data_stream performs the close the sentence above requires. It is a separate call because the reader that raises this holds no connection, and because a deliberately permissive caller should be able to read a violating stream and report it without tearing the session down.

Fields

object_id: u64

The Object ID the extension headers arrived on.

extensions_len: usize

Length in bytes of the extension-header block.

status: ObjectStatus

The Object’s status, resolved through the encoding’s elision rule.

Spelled out in full because the glob import of moqtap_codec::types brings a different ObjectStatus into this module.

Trait Implementations

impl Debug for ConnectionError

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

Formats the value using the given formatter.

impl Display for ConnectionError

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

Formats the value using the given formatter.

impl Error for ConnectionError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<CodecError> for ConnectionError

fn from(source: CodecError) -> Self

Converts to this type from the input type.

impl From<DialError> for ConnectionError

fn from(e: DialError) -> Self

Preserves the variants this error had when the dial was inlined here, so a caller matching on InvalidAddress or TlsConfig sees no change.

impl From<EndpointError> for ConnectionError

fn from(source: EndpointError) -> Self

Converts to this type from the input type.

impl From<TransportError> for ConnectionError

fn from(source: TransportError) -> Self

Converts to this type from the input type.

impl From<VarIntError> for ConnectionError

fn from(source: VarIntError) -> Self

Converts to this type from the input type.