Enum DropBreakdown 

#[non_exhaustive]
pub enum DropBreakdown {
    AfPacket {
        freezes: u64,
    },
    Xdp {
        rx_dropped: u64,
        rx_invalid_descs: u64,
        rx_ring_full: u64,
        rx_fill_ring_empty_descs: u64,
        tx_invalid_descs: u64,
        tx_ring_empty_descs: u64,
    },
}

Per-source breakdown of where packets were dropped (issue #39).

The flat CaptureStats::drops (and the windowed drop_rate) answer how many packets were lost; this answers why. A silent drop is a monitoring blind spot, and the two backends fail in operationally distinct ways that a single aggregate counter hides:

• AF_PACKET (TPACKET_V3) reports one kernel ring-overflow counter (tp_drops, surfaced as CaptureStats::drops) plus a ring-freeze count.
• AF_XDP (XDP_STATISTICS) separates several causes. netring keeps them un-collapsed here: a full RX ring means a slow consumer; an empty fill ring means slow refill; invalid descriptors point at a driver / descriptor-management fault, not backpressure at all. Folding these into one number erases the root-cause signal.

Delivered per source on CaptureTelemetry::detail. The unified drops deliberately counts only the queue-pressure sources (rx_dropped + rx_ring_full + rx_fill_ring_empty_descs) so the windowed drop rate stays a “consumer can’t keep up” signal; rx_invalid_descs and the TX counters are visible only here.

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.

AfPacket

AF_PACKET (TPACKET_V3) drop accounting.

Fields

freezes: u64

Ring-buffer freeze events (tp_freeze_q_cnt): the kernel ran out of usable blocks. Tracks with drops under backpressure. (Also surfaced flat as CaptureTelemetry::freezes.)

Xdp

AF_XDP (XDP_STATISTICS) drop accounting — every source kept distinct rather than summed.

Fields

rx_dropped: u64

RX descriptors the kernel dropped (generic RX drop counter).

rx_invalid_descs: u64

RX descriptors the kernel rejected as invalid — a driver or descriptor-management fault, not backpressure. Excluded from the unified drops so it can’t masquerade as a slow consumer.

rx_ring_full: u64

RX drops because the RX ring was full (slow consumer).

rx_fill_ring_empty_descs: u64

RX drops because the fill ring was empty mid-batch (slow refill).

tx_invalid_descs: u64

TX descriptors the kernel rejected as invalid (bad addr / len).

tx_ring_empty_descs: u64

TX kicks issued while the TX ring was empty (no-ops).

Implementations

impl DropBreakdown

pub fn total_rx_drops(&self) -> u64

Total dropped-descriptor count across every RX source in this breakdown, in u64 (no u32 saturation).

For AF_PACKET this is 0 — AF_PACKET’s drop total lives in CaptureStats::drops, and this variant only adds the freeze count. For AF_XDP it sums all RX drop causes, including rx_invalid_descs — the honest “data you didn’t see” figure, which is wider than the queue-pressure drops surfaced flat.

Trait Implementations

impl Clone for DropBreakdown

fn clone(&self) -> DropBreakdown

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DropBreakdown

impl Debug for DropBreakdown

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

Formats the value using the given formatter.

impl Eq for DropBreakdown

impl From<XdpStats> for DropBreakdown

fn from(s: XdpStats) -> Self

Converts to this type from the input type.

impl PartialEq for DropBreakdown

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DropBreakdown