Enum DataItem 

pub enum DataItem {
    Status {
        code: StatusCode,
        text: String,
    },
    Ipv4ConnectionPoint {
        flags: ConnectionPointFlags,
        addr: Ipv4Addr,
        port: Option<u16>,
    },
    Ipv6ConnectionPoint {
        flags: ConnectionPointFlags,
        addr: Ipv6Addr,
        port: Option<u16>,
    },
    PeerType {
        flags: PeerFlags,
        description: String,
    },
    HeartbeatInterval(Duration),
    ExtensionsSupported(Vec<ExtensionId>),
    MacAddress(MacAddress),
    Ipv4Address {
        add: bool,
        addr: Ipv4Addr,
    },
    Ipv6Address {
        add: bool,
        addr: Ipv6Addr,
    },
    Ipv4AttachedSubnet {
        add: bool,
        subnet: Ipv4Net,
    },
    Ipv6AttachedSubnet {
        add: bool,
        subnet: Ipv6Net,
    },
    MaxDataRateReceive(u64),
    MaxDataRateTransmit(u64),
    CurrentDataRateReceive(u64),
    CurrentDataRateTransmit(u64),
    Latency(Duration),
    Resources(u8),
    RelativeLinkQualityReceive(u8),
    RelativeLinkQualityTransmit(u8),
    Mtu(u16),
    Unknown(RawDataItem),
}

Typed DLEP Data Item. Unknown preserves forward compatibility: the decoder never fails on an unrecognized type_id and extension code paths can introspect the raw bytes.

Variants

Status

Fields

code: StatusCode

text: String

Ipv4ConnectionPoint

Fields

flags: ConnectionPointFlags

addr: Ipv4Addr

port: Option<u16>

Ipv6ConnectionPoint

Fields

flags: ConnectionPointFlags

addr: Ipv6Addr

port: Option<u16>

PeerType

Fields

flags: PeerFlags

description: String

HeartbeatInterval(Duration)

ExtensionsSupported(Vec<ExtensionId>)

MacAddress(MacAddress)

Ipv4Address

Fields

add: bool

addr: Ipv4Addr

Ipv6Address

Fields

add: bool

addr: Ipv6Addr

Ipv4AttachedSubnet

Fields

add: bool

subnet: Ipv4Net

Ipv6AttachedSubnet

Fields

add: bool

subnet: Ipv6Net

MaxDataRateReceive(u64)

MaxDataRateTransmit(u64)

CurrentDataRateReceive(u64)

CurrentDataRateTransmit(u64)

Latency(Duration)

Resources(u8)

RelativeLinkQualityReceive(u8)

RelativeLinkQualityTransmit(u8)

Mtu(u16)

Unknown(RawDataItem)

Implementations

impl DataItem

pub fn encode(&self, out: &mut BytesMut) -> Result<(), CodecError>

Encode this typed Data Item — including its 4-byte TLV header — onto out. Writes directly into the caller’s buffer; on error out is restored to its starting length so the caller can recover.

Returns an error for values that cannot be expressed on the wire:

• Resources / RelativeLinkQuality{Receive,Transmit} outside 0..=100 (per RFC 8175 §13.17–§13.19)
• HeartbeatInterval whose milliseconds exceed u32::MAX
• Latency whose microseconds exceed u64::MAX

Ipv4AttachedSubnet / Ipv6AttachedSubnet always emit the network address (host bits truncated to the prefix), per RFC 8175 §13.10–§13.11. decode symmetrically truncates non-canonical input, so a peer that puts host bits on the wire is normalized in memory rather than silently re-canonicalized on the next encode.

pub fn decode(raw: RawDataItem) -> Result<Self, CodecError>

Lift a parsed RawDataItem into a typed DataItem. Unknown type ids fall through to DataItem::Unknown for negotiated extension dispatch. The session layer rejects unclaimed items under RFC 8175 §12.1. Length errors and value-range errors are reported here.

Ipv4AttachedSubnet / Ipv6AttachedSubnet are normalized to network form here — host bits in non-canonical wire input are zeroed so the in-memory representation matches what encode would produce, and equality comparisons across peer-sent subnets are stable.

impl DataItem

pub fn type_id(&self) -> DataItemType

Trait Implementations

impl Clone for DataItem

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataItem

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

Formats the value using the given formatter.