pub struct StackFrame {
    pub id: i64,
    pub function_name: String,
    pub source_location: Option<SourceLocation>,
    pub registers: DebugRegisters,
    pub pc: RegisterValue,
    pub frame_base: Option<u64>,
    pub is_inlined: bool,
    pub static_variables: Option<VariableCache>,
    pub local_variables: Option<VariableCache>,
}
Expand description

A full stack frame with all its information contained.

Fields§

§id: i64

The stackframe ID.

§function_name: String

The name of the function this stackframe belongs to.

§source_location: Option<SourceLocation>

The source location the function this stackframe belongs to originates.

§registers: DebugRegisters

The current register state represented in this stackframe.

§pc: RegisterValue

The program counter / address of the current instruction when this stack frame was created

§frame_base: Option<u64>

The DWARF debug info defines a DW_AT_frame_base attribute which can be used to calculate the memory location of variables in a stack frame. The rustc compiler, has a compile flag, -C force-frame-pointers, which when set to on, will usually result in this being a pointer to the register value of the platform frame pointer. However, some isa’s (e.g. RISCV) uses a default of -C force-frame-pointers off and will then use the stack pointer as the frame base address. We store the frame_base of the relevant non-inlined parent function, to ensure correct calculation of the Variable::memory_location values.

§is_inlined: bool

Indicate if this stack frame belongs to an inlined function.

§static_variables: Option<VariableCache>

A cache of ‘static’ scoped variables for this stackframe

§local_variables: Option<VariableCache>

A cache of ‘local’ scoped variables for this stafckframe, with a Variable for each in-scope variable.

  • Complex variables and pointers will have additional children.
    • This structure is recursive until a base type is encountered.

Trait Implementations§

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

Auto Trait Implementations§

Blanket Implementations§

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
Converts self into T using Into<T>. Read more
Causes self to use its Binary implementation when Debug-formatted.
Causes self to use its Display implementation when Debug-formatted.
Causes self to use its LowerExp implementation when Debug-formatted.
Causes self to use its LowerHex implementation when Debug-formatted.
Causes self to use its Octal implementation when Debug-formatted.
Causes self to use its Pointer implementation when Debug-formatted.
Causes self to use its UpperExp implementation when Debug-formatted.
Causes self to use its UpperHex implementation when Debug-formatted.
Formats each item in a sequence. Read more

Returns the argument unchanged.

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

Calls U::from(self).

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

Pipes by value. This is generally the method you want to use. Read more
Borrows self and passes that borrow into the pipe function. Read more
Mutably borrows self and passes that borrow into the pipe function. Read more
Borrows self, then passes self.borrow() into the pipe function. Read more
Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Borrows self, then passes self.as_ref() into the pipe function.
Mutably borrows self, then passes self.as_mut() into the pipe function.
Borrows self, then passes self.deref() into the pipe function.
Mutably borrows self, then passes self.deref_mut() into the pipe function.
Immutable access to a value. Read more
Mutable access to a value. Read more
Immutable access to the Borrow<B> of a value. Read more
Mutable access to the BorrowMut<B> of a value. Read more
Immutable access to the AsRef<R> view of a value. Read more
Mutable access to the AsMut<R> view of a value. Read more
Immutable access to the Deref::Target of a value. Read more
Mutable access to the Deref::Target of a value. Read more
Calls .tap() only in debug builds, and is erased in release builds.
Calls .tap_mut() only in debug builds, and is erased in release builds.
Calls .tap_borrow() only in debug builds, and is erased in release builds.
Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
Calls .tap_ref() only in debug builds, and is erased in release builds.
Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
Calls .tap_deref() only in debug builds, and is erased in release builds.
Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Converts the given value to a String. Read more
Attempts to convert self into T using TryInto<T>. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more