Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Arc<Error>),
    MoqNet(Error),
    Directive(Arc<ParseError>),
    SetSubscriber(Arc<TryInitError>),
    Logcat(Arc<Error>),
    NoBackend(&'static str),
    QlogUnsupported,
    ConnectFailed,
    ConnectTimeout(Duration),
    Connect(ConnectError),
    TransportRace {
        quic: Arc<Error>,
        websocket: Arc<Error>,
    },
    MtlsUnsupported,
    InvalidStatusCode,
    Reconnect(String),
    Tls(Arc<Error>),
    Quinn(Arc<Error>),
    WebSocket(Arc<Error>),
    Tcp(Arc<Error>),
    Unix(Arc<Error>),
}

Errors produced while configuring or establishing native MoQ connections.

Backend-specific failures live in per-backend error types (crate::tls::Error, the per-backend Error types, etc.). They’re wrapped in Arc here so the aggregate stays Clone even though the underlying transport/IO errors are not.

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.

Io(Arc<Error>)

Reading or writing a socket, certificate, or key file failed.

MoqNet(Error)

The MoQ session itself failed, after the transport was established.

Directive(Arc<ParseError>)

The log filter string (ex. RUST_LOG) isn’t a valid tracing directive.

SetSubscriber(Arc<TryInitError>)

Logging was initialized twice, or something else already claimed the global subscriber.

Logcat(Arc<Error>)

Logging couldn’t attach to Android’s logcat.

NoBackend(&'static str)

No backend feature is compiled in that can serve this URL. The string names the features to enable.

QlogUnsupported

A qlog directory was configured but this build can’t capture traces.

ConnectFailed

Every backend we tried gave up without reporting why.

ConnectTimeout(Duration)

The dial and handshake together outlived the connect timeout.

Not every transport bounds its own dial: QUIC gives up on its own, but a peer that completes the TCP handshake and then never speaks leaves the WebSocket fallback (and the MoQ handshake that follows either transport) pending with nothing to time it out. This deadline turns that into an error the caller can retry instead of a wait that never ends.

Connect(ConnectError)

The server rejected the connection with an auth status. See crate::ConnectError.

TransportRace

Both halves of the QUIC/WebSocket race failed, so neither error alone tells the story.

Fields

quic: Arc<Error>

Why the QUIC attempt failed.

websocket: Arc<Error>

Why the WebSocket attempt failed.

MtlsUnsupported

A client certificate was configured, but this QUIC backend can’t do mTLS.

InvalidStatusCode

The server’s WebTransport response carried a status outside the valid HTTP range.

Reconnect(String)

Reconnecting gave up, usually after the backoff timeout expired. The string has the details.

Tls(Arc<Error>)

Loading certificates or building the TLS config failed.

Quinn(Arc<Error>)

The Quinn backend failed.

WebSocket(Arc<Error>)

The WebSocket fallback transport failed.

Tcp(Arc<Error>)

The TCP (qmux) transport failed.

Unix(Arc<Error>)

The Unix socket transport failed.

Implementations

impl Error

pub fn connect_error(&self) -> Option<ConnectError>

The auth rejection behind this error, digging through backend and race variants.

pub fn is_auth(&self) -> bool

True if the server rejected us for auth reasons, so retrying won’t help without new credentials.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<ConnectError> for Error

fn from(source: ConnectError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature quinn only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature websocket only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature tcp only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on Unix and crate feature uds only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(err: ParseError) -> Self

Converts to this type from the input type.