Struct FailureDumpStackTrace 

#[non_exhaustive]
pub struct FailureDumpStackTrace {
    pub n_buckets: u32,
    pub entries: Vec<FailureDumpStackTraceEntry>,
    pub truncated: bool,
    pub buckets_unreadable: u32,
}

Per-bucket summary of populated stack traces in a STACK_TRACE map.

Each entry is one populated bucket whose pointer was non-null at the freeze instant. nr is the number of trace samples (PCs) in the bucket; pcs carries the actual u64 PC values when readable (build-id stacks render the raw bytes hex since the per-entry shape is struct bpf_stack_build_id, not a u64). The dump caps per-bucket entries at MAX_STACK_TRACE_PCS to bound memory.

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.

n_buckets: u32

bpf_stack_map.n_buckets — the rounded-up power-of-two slot count. Iteration upper bound; differs from max_entries which the kernel rounds.

entries: Vec<FailureDumpStackTraceEntry>

One entry per non-null bucket pointer. Sorted by bucket id.

truncated: bool

True when any populated bucket was truncated at MAX_STACK_TRACE_PCS PCs.

buckets_unreadable: u32

Count of buckets whose pointer slot or bucket struct could not be translated to a guest physical address at capture time (an unmapped page in the bucket array or a dangling bucket KVA). These buckets are absent from entries entirely. 0 when every non-null bucket was readable. Without this count entries.len() undercounts the live buckets and the gap reads as “fewer stacks present” rather than “stacks present but unreadable”.

Trait Implementations

impl Clone for FailureDumpStackTrace

fn clone(&self) -> FailureDumpStackTrace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FailureDumpStackTrace

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

Formats the value using the given formatter.

impl Default for FailureDumpStackTrace

fn default() -> FailureDumpStackTrace

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FailureDumpStackTrace

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FailureDumpStackTrace

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

where __S: Serializer,

Serialize this value into the given Serde serializer.