Enum TransportProfileError 

pub enum TransportProfileError {
    VarIntRange {
        field: &'static str,
        value: u64,
    },
    KeepAliveNotBelowIdle {
        keep_alive: Duration,
        idle: Duration,
    },
    MtuInverted {
        min: u16,
        initial: u16,
    },
    MtuBelowFloor {
        field: &'static str,
        value: u16,
        floor: u16,
    },
    TimeThreshold(f32),
}

Why a TransportProfile cannot be honoured.

No Eq: TransportProfileError::TimeThreshold carries an f32, and the one value that most wants reporting — NaN — is not equal to itself. PartialEq is what an f32 admits, and it is enough for a test to compare a returned error against an expected one.

Deliberately not #[non_exhaustive]: tests/transport_exhaustive.rs builds one profile per variant, calls TransportProfile::validate, and matches what comes back with no _ arm — a match a crate outside this one can only write while the attribute is absent. A sixth variant fails that build until a profile someone could actually write is shown to reach it, which is the check worth having: not that the variant exists, but that it is a refusal an author can trip over and therefore fix. The attribute would replace all of that with a wildcard arm that silently accepts anything.

Variants

VarIntRange

A value above 2^62 - 1, which is the largest number QUIC’s variable length integer encoding can carry.

Caught here rather than at connect time, where quinn returns it without naming a field and the leg carries on with a default the author never asked for.

Fields

field: &'static str

The profile field holding the oversized value, spelled as the field is, and dotted for a field inside AckFrequency.

value: u64

The value that does not fit.

KeepAliveNotBelowIdle

A keep-alive interval at or above the idle timeout.

Such a keep-alive cannot prevent the timeout it exists to prevent: the connection has already been closed by the time the packet that would have saved it is due.

Fields

keep_alive: Duration

The configured keep-alive interval.

idle: Duration

The idle timeout it fails to stay below.

MtuInverted

A minimum MTU above the initial MTU.

The minimum is the floor MTU discovery may fall back to and the initial is where it starts, so a floor above the start describes a range with nothing in it.

Fields

min: u16

The configured minimum MTU.

initial: u16

The initial MTU it exceeds.

MtuBelowFloor

An MTU below the 1200 bytes QUIC guarantees.

quinn’s initial_mtu and min_mtu setters both raise a smaller value to 1200 without a word, so a profile modelling a constrained path at 900 bytes validates, applies, reports applied, and runs at 1200. Refused here, naming the field, because a configured value that is quietly replaced is the failure this crate exists to make impossible.

Fields

field: &'static str

Which of initial_mtu or min_mtu holds the value.

value: u16

The value that would have been raised.

floor: u16

The floor it is below, which is always 1200.

TimeThreshold(f32)

A loss-detection time threshold that is not a usable multiplier.

It multiplies the round-trip estimate, so at or below 1.0 it declares a packet lost before an acknowledgement for it could have arrived, and a non-finite value is not a multiplier at all.

Trait Implementations

impl Clone for TransportProfileError

fn clone(&self) -> TransportProfileError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransportProfileError

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

Formats the value using the given formatter.

impl Display for TransportProfileError

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

Formats the value using the given formatter.

impl Error for TransportProfileError

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<TransportProfileError> for ControlError

fn from(source: TransportProfileError) -> Self

Converts to this type from the input type.

impl PartialEq for TransportProfileError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TransportProfileError