Enum EvaluationResult

pub enum EvaluationResult<R: Reader> {
    Complete,
    RequiresMemory {
        address: u64,
        size: u8,
        space: Option<u64>,
        base_type: UnitOffset<R::Offset>,
    },
    RequiresRegister {
        register: Register,
        base_type: UnitOffset<R::Offset>,
    },
    RequiresFrameBase,
    RequiresTls(u64),
    RequiresCallFrameCfa,
    RequiresAtLocation(DieReference<R::Offset>),
    RequiresEntryValue(Expression<R>),
    RequiresParameterRef(UnitOffset<R::Offset>),
    RequiresRelocatedAddress(u64),
    RequiresIndexedAddress {
        index: DebugAddrIndex<R::Offset>,
        relocate: bool,
    },
    RequiresBaseType(UnitOffset<R::Offset>),
}

The state of an Evaluation after evaluating a DWARF expression. The evaluation is either Complete, or it requires more data to continue, as described by the variant.

Variants

Complete

The Evaluation is complete, and Evaluation::result() can be called.

RequiresMemory

The Evaluation needs a value from memory to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_memory.

Fields

address: u64

The address of the value required.

size: u8

The size of the value required. This is guaranteed to be at most the word size of the target architecture.

space: Option<u64>

If not None, a target-specific address space value.

base_type: UnitOffset<R::Offset>

The DIE of the base type or 0 to indicate the generic type

RequiresRegister

The Evaluation needs a value from a register to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_register.

Fields

register: Register

The register number.

base_type: UnitOffset<R::Offset>

The DIE of the base type or 0 to indicate the generic type

RequiresFrameBase

The Evaluation needs the frame base address to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_frame_base. The frame base address is the address produced by the location description in the DW_AT_frame_base attribute of the current function.

RequiresTls(u64)

The Evaluation needs a value from TLS to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_tls.

RequiresCallFrameCfa

The Evaluation needs the CFA to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_call_frame_cfa.

RequiresAtLocation(DieReference<R::Offset>)

The Evaluation needs the DWARF expression at the given location to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_at_location.

RequiresEntryValue(Expression<R>)

The Evaluation needs the value produced by evaluating a DWARF expression at the entry point of the current subprogram. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_entry_value.

RequiresParameterRef(UnitOffset<R::Offset>)

The Evaluation needs the value of the parameter at the given location in the current function’s caller. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_parameter_ref.

RequiresRelocatedAddress(u64)

The Evaluation needs an address to be relocated to proceed further. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_relocated_address.

RequiresIndexedAddress

The Evaluation needs an address from the .debug_addr section. This address may also need to be relocated. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_indexed_address.

Fields

index: DebugAddrIndex<R::Offset>

The index of the address in the .debug_addr section, relative to the DW_AT_addr_base of the compilation unit.

relocate: bool

Whether the address also needs to be relocated.

RequiresBaseType(UnitOffset<R::Offset>)

The Evaluation needs the ValueType for the base type DIE at the give unit offset. Once the caller determines what value to provide it should resume the Evaluation by calling Evaluation::resume_with_base_type.

Trait Implementations

impl<R: Debug + Reader> Debug for EvaluationResult<R>

where R::Offset: Debug,

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

Formats the value using the given formatter.

impl<R: PartialEq + Reader> PartialEq for EvaluationResult<R>

where R::Offset: PartialEq,

fn eq(&self, other: &EvaluationResult<R>) -> 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<R: Reader> StructuralPartialEq for EvaluationResult<R>