Struct FailureDumpRingbuf 

#[non_exhaustive]
pub struct FailureDumpRingbuf {
    pub capacity: u64,
    pub consumer_pos: u64,
    pub producer_pos: u64,
    pub pending_pos: u64,
    pub pending_bytes: u64,
}

Ringbuf occupancy snapshot read from struct bpf_ringbuf at the freeze instant.

Capacity, consumer/producer positions, and the in-flight reservation frontier (pending_pos) are all that’s readable without walking the records. Pending bytes (= producer_pos - consumer_pos, computed with unsigned wraparound) is the operator-visible indicator: low values = consumer keeping up; values approaching capacity = consumer stuck or kernel producer overrunning. A non-zero gap between producer_pos and pending_pos means a producer is mid-reserve and the consumer can’t advance past pending_pos.

Read via crate::monitor::btf_offsets::BpfRingbufOffsets; rendered in render_ringbuf_state.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

capacity: u64

Ring data area capacity in bytes (= mask + 1). Always a power of two; matches the map’s declared max_entries.

consumer_pos: u64

Consumer position. Byte index of the next record userspace will read. Monotonically advances; the kernel never writes here.

producer_pos: u64

Producer position. Byte index past the last reserved record. Monotonically advances; updated by the kernel on each bpf_ringbuf_reserve.

pending_pos: u64

Pending position. Byte index of the oldest in-flight (still being filled) reservation. Records below pending_pos are committed and visible to the consumer; records between pending_pos and producer_pos are reserved but not yet committed.

pending_bytes: u64

Pending bytes (= producer_pos.wrapping_sub(consumer_pos)). 0 = consumer caught up; capacity = ring full / consumer stalled. Computed with unsigned wraparound to match the kernel’s dispatch-path arithmetic.

Trait Implementations

impl Clone for FailureDumpRingbuf

fn clone(&self) -> FailureDumpRingbuf

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FailureDumpRingbuf

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

Formats the value using the given formatter.

impl Default for FailureDumpRingbuf

fn default() -> FailureDumpRingbuf

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FailureDumpRingbuf

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FailureDumpRingbuf

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

where __S: Serializer,

Serialize this value into the given Serde serializer.