Enum Diagnostic 

#[non_exhaustive]
pub enum Diagnostic {
    HeaderCrcMismatch {
        protocol: ProtocolKind,
        computed: u16,
        on_wire: u16,
        my_call: Callsign,
    },
    HeaderFlagsNonZero {
        protocol: ProtocolKind,
        flag1: u8,
        flag2: u8,
        flag3: u8,
    },
    CallsignNonPrintable {
        protocol: ProtocolKind,
        field: CallsignField,
        offset_in_field: u8,
        byte: u8,
    },
    StreamIdSwitchWithoutEot {
        protocol: ProtocolKind,
        previous: StreamId,
        new: StreamId,
        elapsed_since_last_frame: Duration,
    },
    VoiceSeqOutOfRange {
        protocol: ProtocolKind,
        stream_id: StreamId,
        got: u8,
    },
    VoiceEotBitMismatch {
        protocol: ProtocolKind,
        packet_len: usize,
        seq_byte: u8,
    },
    VoiceEotTrailerMismatch {
        protocol: ProtocolKind,
        observed: [u8; 6],
    },
    DuplicateLink1Ack {
        peer: SocketAddr,
    },
    UnknownLink2Reply {
        reply: [u8; 4],
    },
    AuthHostSkipped {
        offset: usize,
        reason: AuthHostSkipReason,
    },
    AuthChunkTrailingBytes {
        offset: usize,
        bytes: usize,
    },
}

One observable malformation detected by a lenient parser.

Lenient parsing rule: the codec must NEVER reject a packet solely because of a recoverable malformation. Every malformation becomes a Diagnostic and the packet still parses with whatever content was extractable. Strict-mode is implemented in the consumer’s DiagnosticSink, never in the parser.

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.

HeaderCrcMismatch

Header CRC does not match recomputed CRC.

Fields

protocol: ProtocolKind

Originating protocol.

computed: u16

CRC computed from the wire bytes.

on_wire: u16

CRC carried in bytes 39-40 of the header.

my_call: Callsign

MY callsign from the header (for log correlation).

HeaderFlagsNonZero

Header carries non-zero flag bytes (the DSVT-embedded form is supposed to zero them — see HeaderData.cpp:665-667).

Fields

protocol: ProtocolKind

Originating protocol.

flag1: u8

Observed flag1.

flag2: u8

Observed flag2.

flag3: u8

Observed flag3.

CallsignNonPrintable

Callsign field contains a byte outside ASCII printable range.

Fields

protocol: ProtocolKind

Originating protocol.

field: CallsignField

Which callsign field (rpt2 / rpt1 / ur / my / suffix).

offset_in_field: u8

Byte offset within the 8-byte (or 4-byte for suffix) field.

byte: u8

The non-printable byte observed.

StreamIdSwitchWithoutEot

Stream id flipped mid-stream without an EOT in between.

Fields

protocol: ProtocolKind

Originating protocol.

previous: StreamId

Previous stream id (now abandoned).

new: StreamId

New stream id (just observed).

elapsed_since_last_frame: Duration

How long since the last frame on previous.

VoiceSeqOutOfRange

Voice data sequence number outside 0..21.

Fields

protocol: ProtocolKind

Originating protocol.

stream_id: StreamId

The stream the seq belongs to.

got: u8

The out-of-range seq value (0x40 bit stripped).

VoiceEotBitMismatch

Voice data with bit 0x40 set on a non-EOT-length packet, or EOT-length packet without bit 0x40 set.

Fields

protocol: ProtocolKind

Originating protocol.

packet_len: usize

Total packet length (including DPlus prefix where applicable).

seq_byte: u8

Observed seq byte.

VoiceEotTrailerMismatch

EOT trailer pattern doesn’t match 0x55 0x55 0x55 0x55 0xC8 0x7A. xlxd writes a different trailer; reflectors talking to xlxd may emit either form.

Fields

protocol: ProtocolKind

Originating protocol.

observed: [u8; 6]

Last 6 bytes of the EOT packet as observed.

DuplicateLink1Ack

LINK1 ACK arrived after LINK2 was already sent.

Fields

peer: SocketAddr

The peer that sent the duplicate.

UnknownLink2Reply

8-byte LINK2 reply at offsets [4..8] is neither OKRW nor BUSY.

Fields

reply: [u8; 4]

The 4-byte tag (typically interpreted as ASCII).

AuthHostSkipped

Auth response chunk had a record dropped per the lenient filter.

Fields

offset: usize

Byte offset of the dropped record.

reason: AuthHostSkipReason

Why it was dropped.

AuthChunkTrailingBytes

Auth chunk had trailing bytes that don’t form a complete record.

Fields

offset: usize

Byte offset where the trailing bytes started.

bytes: usize

How many trailing bytes there were.

Trait Implementations

impl Clone for Diagnostic

fn clone(&self) -> Diagnostic

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Diagnostic

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

Formats the value using the given formatter.

impl PartialEq for Diagnostic

fn eq(&self, other: &Diagnostic) -> 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 Diagnostic

impl StructuralPartialEq for Diagnostic