Struct symbolic::minidump::processor::ProcessState

pub struct ProcessState<'a> { /* fields omitted */ }

Snapshot of the state of a processes during its crash. The object can be obtained by processing Minidump or Microdump files.

Implementations

impl<'a> ProcessState<'a>

pub fn from_minidump(
    buffer: &ByteView<'a>,
    frame_infos: Option<&BTreeMap<CodeModuleId, CfiCache<'_>>>
) -> Result<ProcessState<'a>, ProcessMinidumpError>

Processes a minidump supplied via raw binary data.

Returns a ProcessState that contains information about the crashed process. The parameter frame_infos expects a map of Breakpad symbols containing STACK CFI and STACK WIN records to allow stackwalking with omitted frame pointers.

pub fn requesting_thread(&self) -> i32

The index of the thread that requested a dump be written in the threads vector.

If a dump was produced as a result of a crash, this will point to the thread that crashed. If the dump was produced as by user code without crashing, and the dump contains extended Breakpad information, this will point to the thread that requested the dump. If the dump was not produced as a result of an exception and no extended Breakpad information is present, this field will be set to -1, indicating that the dump thread is not available.

pub fn timestamp(&self) -> u64

The time-date stamp of the minidump.

pub fn crashed(&self) -> bool

True if the process crashed, false if the dump was produced outside of an exception handler.

pub fn crash_address(&self) -> u64

If the process crashed, and if crash_reason implicates memory, the memory address that caused the crash.

For data access errors, this will be the data address that caused the fault. For code errors, this will be the address of the instruction that caused the fault.

pub fn crash_reason(&self) -> String

If the process crashed, the type of crash.

OS- and possibly CPU-specific. For example, “EXCEPTION_ACCESS_VIOLATION” (Windows), “EXC_BAD_ACCESS / KERN_INVALID_ADDRESS” (Mac OS X), “SIGSEGV” (other Unix).

pub fn assertion(&self) -> String

If there was an assertion that was hit, a textual representation of that assertion, possibly including the file and line at which it occurred.

pub fn system_info(&self) -> &SystemInfo

Returns OS and CPU information.

pub fn threads(&self) -> &[&CallStack]

Returns a list of CallStacks in the minidump.

pub fn modules(&self) -> Vec<&CodeModule, Global>

Returns the full list of loaded CodeModules.

pub fn referenced_modules(&self) -> BTreeSet<&CodeModule>

Returns a list of all CodeModules referenced in one of the CallStacks.

Trait Implementations

impl<'a> Debug for ProcessState<'a>

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

Formats the value using the given formatter.

impl<'a> Drop for ProcessState<'a>

pub fn drop(&mut self)

Executes the destructor for this type.