Struct framehop::aarch64::UnwinderAarch64

pub struct UnwinderAarch64<D, P = MayAllocateDuringUnwind>(/* private fields */);

The unwinder for the Aarch64 CPU architecture. Use the Unwinder trait for unwinding.

Type arguments:

• D: The type for unwind section data in the modules. See Module.
• P: The AllocationPolicy.

Implementations

impl<D, P> UnwinderAarch64<D, P>

pub fn new() -> Self

Create an unwinder for a process.

Trait Implementations

impl<D, P> Clone for UnwinderAarch64<D, P>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<D, P> Default for UnwinderAarch64<D, P>

fn default() -> Self

Returns the “default value” for a type.

impl<D: Deref<Target = [u8]>, P: AllocationPolicy> Unwinder for UnwinderAarch64<D, P>

type UnwindRegs = UnwindRegsAarch64

The unwind registers type for the targeted CPU architecture.

type Cache = CacheAarch64<P>

The unwind cache for the targeted CPU architecture. This is an associated type because the cache stores unwind rules, whose concrete type depends on the CPU arch, and because the cache can support different allocation policies.

type Module = Module<D>

The module type. This is an associated type because the concrete type varies depending on the type you use to give the module access to the unwind section data.

fn add_module(&mut self, module: Module<D>)

Add a module that’s loaded in the profiled process. This is how you provide unwind information and address ranges.

fn remove_module(&mut self, module_address_range_start: u64)

Remove a module that was added before using add_module, keyed by the start address of that module’s address range. If no match is found, the call is ignored. This should be called whenever a module is unloaded from the process.

fn max_known_code_address(&self) -> u64

Returns the highest code address that is known in this process based on the module address ranges. Returns 0 if no modules have been added.

fn unwind_frame<F>( &self, address: FrameAddress, regs: &mut UnwindRegsAarch64, cache: &mut CacheAarch64<P>, read_stack: &mut F ) -> Result<Option<u64>, Error>

where F: FnMut(u64) -> Result<u64, ()>,

Unwind a single frame, to recover return address and caller register values. This is the main entry point for unwinding.

fn iter_frames<'u, 'c, 'r, F>( &'u self, pc: u64, regs: Self::UnwindRegs, cache: &'c mut Self::Cache, read_stack: &'r mut F ) -> UnwindIterator<'u, 'c, 'r, Self, F>

where F: FnMut(u64) -> Result<u64, ()>,

Return an iterator that unwinds frame by frame until the end of the stack is found.