Struct fidl_fuchsia_feedback::CrashReport

pub struct CrashReport {
    pub program_name: Option<String>,
    pub specific_report: Option<SpecificCrashReport>,
    pub annotations: Option<Vec<Annotation>>,
    pub attachments: Option<Vec<Attachment>>,
    pub event_id: Option<String>,
    pub program_uptime: Option<i64>,
    pub crash_signature: Option<String>,
    pub is_fatal: Option<bool>,
    /* private fields */
}

Represents a crash report.

Fields

program_name: Option<String>

The name of the program that crashed, e.g., the process or component’s name.

specific_report: Option<SpecificCrashReport>

The specific report that depends on the type of crashes.

This field should be set if additional information about the crashing program needs to be sent, e.g., a minidump.

annotations: Option<Vec<Annotation>>

A vector of key-value string pairs representing arbitrary data that should be attached to a crash report.

Keys should be unique as only the latest value for a given key in the vector will be considered.

attachments: Option<Vec<Attachment>>

A vector of key-value string-to-VMO pairs representing arbitrary data that should be attached to a crash report.

Keys should be unique as only the latest value for a given key in the vector will be considered.

event_id: Option<String>

A text ID that the crash server can use to group multiple crash reports related to the same event.

Unlike the crash signature, crash reports sharing the same ID correspond to different crashes, but can be considered as belonging to the same event, e.g., a crash in a low-level server causing a crash in a high-level UI widget.

program_uptime: Option<i64>

How long the program was running before it crashed.

crash_signature: Option<String>

A text signature that the crash server can use to track the same crash over time, e.g., “kernel-panic” or “oom”. This signature will take precedence over any automated signature derived from the rest of the data.

Unlike the event ID, crash reports sharing the same signature correspond to the same crash, but happening over multiple events, e.g., a null pointer exception in a server whenever asked the same request.

Must match [a-z][a-z-]* i.e. only lowercase letters and hyphens or this will result in a ZX_ERR_INVALID_ARGS epitaph.

is_fatal: Option<bool>

Indicates whether the crash report is for the atypical stop of a running process, component, or the system itself.

Examples of events that result in fatal crash reports are:

• an ELF process crashing
• the system rebooting because it ran out of memory.
• the system rebooting because a critical component crashed.
• the system rebooting because the device was too hot.

Examples of events that result in non-fatal crash reports are:

• an uncaught exception in a Dart program with many execution contexts. The runtime may chose to terminate that specific execution context and file a crash report for it instead of the whole program.
• a component detecting a fatal event (like an OOM) may occur soon, but isn’t guaranteed to occur.

This field is primarily used for grouping crashes by fatal, not fatal, and unknown, each corresponding to the field being set to true, set to false, or not set respectively.

Implementations

impl CrashReport

pub const EMPTY: Self = _

An empty table with every field set to None.

Trait Implementations

impl Debug for CrashReport

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

Formats the value using the given formatter.

impl Decodable for CrashReport

fn new_empty() -> Self

Creates a new value of this type with an “empty” representation.

fn decode(&mut self, decoder: &mut Decoder<'_>, offset: usize) -> Result<()>

Decodes an object of this type from the decoder’s buffers into self. Callers must ensure that offset is a multiple of Layout::inline_align, and that decoder.buf has room for reading Layout::inline_size bytes at offset.

impl Encodable for CrashReport

fn encode( &mut self, encoder: &mut Encoder<'_, '_>, offset: usize, recursion_depth: usize ) -> Result<()>

Encode the object into the buffer. Any handles stored in the object are swapped for Handle::INVALID. Callers must ensure that offset is a multiple of Layout::inline_align, and that encoder.buf has room for writing Layout::inline_size bytes at offset.

impl Layout for CrashReport

fn inline_align(_context: &Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: &Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for the type’s alignment. Must be a multiple of inline_align.

fn supports_simple_copy() -> boolwhere Self: Sized,

Returns true iff the type can be encoded or decoded via simple copy.

impl PartialEq<CrashReport> for CrashReport

fn eq(&self, other: &CrashReport) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CrashReport

impl TopLevel for CrashReport