Enum minidump::UnifiedMemoryInfoList

pub enum UnifiedMemoryInfoList<'a> {
    Maps(MinidumpLinuxMaps<'a>),
    Info(MinidumpMemoryInfoList<'a>),
}

Provides a unified interface for getting metadata about the process’s mapped memory regions at the time of the crash.

Currently this is one of MinidumpMemoryInfoList, available in Windows minidumps, or MinidumpLinuxMaps, available in Linux minidumps.

This allows you to e.g. check whether an address was executable or not without worrying about which platform the crash occured on. If you need to do more specific analysis, you can get the native formats with UnifiedMemoryInfoList::info and UnifiedMemoryInfoList::maps.

Currently an enum because there is no situation where you can have both, but this may change if the format evolves. Prefer using this type’s methods over pattern matching.

Variants

Maps(MinidumpLinuxMaps<'a>)

Info(MinidumpMemoryInfoList<'a>)

Implementations

impl<'a> UnifiedMemoryInfoList<'a>

pub fn new(
    info: Option<MinidumpMemoryInfoList<'a>>,
    maps: Option<MinidumpLinuxMaps<'a>>
) -> Option<Self>

Take two potential memory info sources and create an interface that unifies them.

Under normal circumstances a minidump should only contain one of these. If both are provided, one will be arbitrarily preferred to attempt to make progress.

pub fn memory_info_at_address(
    &self,
    address: u64
) -> Option<UnifiedMemoryInfo<'_>>

Return a MinidumpMemory containing memory at address, if one exists.

pub fn iter(&self) -> impl Iterator<Item = UnifiedMemoryInfo<'_>>

Iterate over the memory regions in the order contained in the minidump.

pub fn by_addr(&self) -> impl Iterator<Item = UnifiedMemoryInfo<'_>>

Iterate over the memory regions in order by memory address.

pub fn print<T: Write>(&self, f: &mut T) -> Result<()>

Write a human-readable description of this MinidumpMemoryList to f.

This is very verbose, it is the format used by minidump_dump.

pub fn maps(&self) -> Option<&MinidumpLinuxMaps<'a>>

Get the MinidumpLinuxMaps contained inside, if it exists.

Potentially useful for doing a more refined analysis in specific places.

pub fn info(&self) -> Option<&MinidumpMemoryInfoList<'a>>

Get the MinidumpMemoryInfoList contained inside, if it exists.

Potentially useful for doing a more refined analysis in specific places.

Trait Implementations

impl<'a> Clone for UnifiedMemoryInfoList<'a>

fn clone(&self) -> UnifiedMemoryInfoList<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for UnifiedMemoryInfoList<'a>

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

Formats the value using the given formatter.

impl<'a> Default for UnifiedMemoryInfoList<'a>

fn default() -> Self

Returns the “default value” for a type.