Enum DPlusError 

#[non_exhaustive]
pub enum DPlusError {
    UnknownPacketLength {
        got: usize,
    },
    DsvtMagicMissing {
        got: [u8; 4],
    },
    StreamIdZero,
    InvalidShortControlByte {
        byte: u8,
    },
    AuthChunkTruncated {
        offset: usize,
        need: usize,
        have: usize,
    },
    AuthChunkFlagsInvalid {
        offset: usize,
        byte: u8,
    },
    AuthChunkTypeInvalid {
        offset: usize,
        byte: u8,
    },
    AuthChunkUndersized {
        offset: usize,
        claimed: usize,
    },
    CallsignFieldInvalid {
        field: CallsignField,
    },
    EncodeBufferTooSmall {
        need: usize,
        have: usize,
    },
}

Errors returned by the DPlus codec functions.

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.

UnknownPacketLength

DPlus packet length is not one of the known sizes.

Valid non-DSVT lengths: 3 (poll), 5 (LINK1/UNLINK ACK), 8 (LINK2 reply), 28 (LINK2 / echo). Valid DSVT lengths: 29 (voice data), 32 (voice EOT), 58 (voice header).

Fields

got: usize

Observed length.

DsvtMagicMissing

Packet expected to be DSVT-framed but the magic at [2..6] is wrong.

Fields

got: [u8; 4]

The 4 bytes at offsets 2..6.

StreamIdZero

Stream id at offsets [14..16] is zero (reserved per D-STAR spec).

InvalidShortControlByte

The 5-byte non-DSVT packet has an unknown control byte at offset 4.

Valid values: 0x00 (UNLINK), 0x01 (LINK1).

Fields

byte: u8

The rejected byte.

AuthChunkTruncated

DPlus auth chunk truncated at offset {offset}: needed {need} bytes, have {have}.

Fields

offset: usize

Byte offset where truncation occurred.

need: usize

Bytes needed to complete the chunk.

have: usize

Bytes actually present.

AuthChunkFlagsInvalid

Auth chunk flag byte [1] failed validation — (b1 & 0xC0) != 0xC0.

Fields

offset: usize

Byte offset of the chunk header.

byte: u8

The rejected flag byte.

AuthChunkTypeInvalid

Auth chunk type byte [2] is not 0x01.

Fields

offset: usize

Byte offset of the chunk header.

byte: u8

The rejected type byte.

AuthChunkUndersized

Auth chunk length {claimed} is smaller than the 8-byte chunk header.

Fields

offset: usize

Byte offset of the chunk header.

claimed: usize

The too-small length value.

CallsignFieldInvalid

Reserved for callsign parsing errors on received packets.

Currently unused — the lenient RX path uses Callsign::from_wire_bytes which stores bytes verbatim and cannot fail. This variant exists so that if a future strict mode rejects non-printable wire callsigns at the codec level, the error type already carries the right shape without a breaking API change (the enum is #[non_exhaustive]).

Fields

field: CallsignField

Which callsign field.

EncodeBufferTooSmall

An encoder was called with an undersized output buffer.

This is a programming error inside crate::session::client::SessionCore — it should never fire in production because the core sizes its own scratch buffers. Propagated as a variant rather than swallowed so callers can still surface the fault.

Fields

need: usize

How many bytes the encoder needed.

have: usize

How many bytes the buffer actually held.

Trait Implementations

impl Clone for DPlusError

fn clone(&self) -> DPlusError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DPlusError

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

Formats the value using the given formatter.

impl Display for DPlusError

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

Formats the value using the given formatter.

impl Error for DPlusError

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<DPlusError> for ProtocolError

fn from(source: DPlusError) -> Self

Converts to this type from the input type.

impl From<EncodeError> for DPlusError

fn from(value: EncodeError) -> Self

Converts to this type from the input type.

impl PartialEq for DPlusError

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

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

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

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

impl Eq for DPlusError

impl StructuralPartialEq for DPlusError