Enum Frame

pub enum Frame {
    InstructionPointer(u64),
    ReturnAddress(u64),
    AdjustedReturnAddress(u64),
    RelativeAddressFromInstructionPointer(LibraryHandle, u32),
    RelativeAddressFromReturnAddress(LibraryHandle, u32),
    RelativeAddressFromAdjustedReturnAddress(LibraryHandle, u32),
    Label(StringHandle),
}

A part of the information about a single stack frame.

Variants

InstructionPointer(u64)

A code address taken from the instruction pointer.

This code address will be resolved to a library-relative address using the library mappings on the process which were specified using Profile::add_lib_mapping.

ReturnAddress(u64)

A code address taken from a return address

This code address will be resolved to a library-relative address using the library mappings on the process which were specified using Profile::add_lib_mapping.

AdjustedReturnAddress(u64)

A code address taken from a return address, but adjusted so that it points into the previous instruction. Usually this is “return address minus one byte”, but some unwinders subtract 2 or 4 bytes if they know more about the architecture-dependent instruction size.

When you call a function with a call instruction, the return address is set up in such a way that, once the called function returns, the CPU continues executing after the call instruction. That means that the return address points to the instruction after the call instruction. But for stack unwinding, you’re interested in the call instruction itself. The call instruction and the instruction after often have very different symbol information (different line numbers, or even different inline stacks).

This code address will be resolved to a library-relative address using the library mappings on the process which were specified using Profile::add_lib_mapping.

RelativeAddressFromInstructionPointer(LibraryHandle, u32)

A relative address taken from the instruction pointer which has already been resolved to a LibraryHandle.

RelativeAddressFromReturnAddress(LibraryHandle, u32)

A relative address taken from a return address which has already been resolved to a LibraryHandle.

RelativeAddressFromAdjustedReturnAddress(LibraryHandle, u32)

A relative address taken from an adjusted return address which has already been resolved to a LibraryHandle.

Label(StringHandle)

A string, containing an index returned by Profile::intern_string.

Trait Implementations

impl Clone for Frame

fn clone(&self) -> Frame

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Frame

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

Formats the value using the given formatter.

impl Ord for Frame

fn cmp(&self, other: &Frame) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Frame

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for Frame

fn partial_cmp(&self, other: &Frame) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Frame

impl StructuralPartialEq for Frame