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 */
}
Expand description

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§

source§

impl CrashReport

source

pub const EMPTY: Self = _

An empty table with every field set to None.

Trait Implementations§

source§

impl Debug for CrashReport

source§

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

Formats the value using the given formatter. Read more
source§

impl Decodable for CrashReport

source§

fn new_empty() -> Self

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

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. Read more
source§

impl Encodable for CrashReport

source§

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. Read more
source§

impl Layout for CrashReport

source§

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.
source§

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. Read more
source§

impl PartialEq<CrashReport> for CrashReport

source§

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

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

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.
source§

impl StructuralPartialEq for CrashReport

source§

impl TopLevel for CrashReport

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

const: unstable · source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> LayoutObject for Twhere T: Layout,

§

fn inline_align(&self, context: &Context) -> usize

See Layout::inline_align.
§

fn inline_size(&self, context: &Context) -> usize

See Layout::inline_size.
§

impl<T> Pointable for T

§

const ALIGN: usize = mem::align_of::<T>()

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
const: unstable · source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more