Enum FailureDumpReportAny 

#[non_exhaustive]
pub enum FailureDumpReportAny {
    Single(Box<FailureDumpReport>),
    Dual(Box<DualFailureDumpReport>),
    Degraded(Box<DegradedFailureDumpReport>),
}

Either-or wrapper that owns a parsed FailureDumpReport, DualFailureDumpReport, or DegradedFailureDumpReport. Lets a consumer hold and render a failure-dump file without prematurely committing to one schema — the discriminant lives in the JSON’s schema field, not in the type the consumer holds.

Centralises the schema-tag dispatch logic that previously lived inline at every read site (the auto-repro tail renderer, the failure-dump-e2e test, any future consumer that wants to inspect any shape). Use Self::from_json to parse an arbitrary failure-dump JSON blob; the Display impl forwards to the underlying report’s existing Display so the rendered output is indistinguishable from holding the unwrapped report directly.

non_exhaustive so a future fourth schema can be added without breaking external pattern matches.

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.

Single(Box<FailureDumpReport>)

Single-snapshot report, schema="single". Emitted by the primary VM’s freeze coordinator when an error-class SCX exit fires.

Dual(Box<DualFailureDumpReport>)

Dual-snapshot wrapper, schema="dual". Emitted by the auto-repro VM when the dual-snapshot path is enabled. Carries optional early + required late snapshots plus jiffies metadata for the early-trigger condition.

Boxed to keep FailureDumpReportAny’s on-stack size bounded — DualFailureDumpReport carries the early+late snapshots inline and is roughly 2x the size of FailureDumpReport.

Degraded(Box<DegradedFailureDumpReport>)

Degraded report, schema="degraded". Emitted when an error-class trigger fires but the dump path aborts before a full single/dual report can be captured — today only the vCPU rendezvous-timeout path produces this shape. Carries partial vCPU register data + trigger-state diagnostics instead of the full map / scx-walker output.

Boxed for size parity with the other variants.

Implementations

impl FailureDumpReportAny

pub fn from_json(json: &str) -> Option<Self>

Parse a failure-dump JSON blob, choosing the variant by the schema field. Returns None on any of:

• the blob does not parse as JSON
• the schema field is absent (degraded variant requires an explicit discriminant; the previous “absent ⇒ single” fallback would silently mis-route a richer wrapper as a lossy single shape)
• the schema field carries an unknown value
• the typed deserialisation under the chosen schema fails

Trait Implementations

impl Display for FailureDumpReportAny

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

Formats the value using the given formatter.