Struct gimli::read::UninitializedUnwindContext

pub struct UninitializedUnwindContext<R: Reader>(_);

Common context needed when evaluating the call frame unwinding information.

To avoid re-allocating the context multiple times when evaluating multiple CFI programs, it can be reused. At first, a context is uninitialized (UninitializedUnwindContext). It can be initialized by providing the CommonInformationEntry for the CFI program about to be evaluated and calling UninitializedUnwindContext::initialize. The result is a &mut UnwindContext which borrows the uninitialized context, and can be used to evaluate and run a FrameDescriptionEntry’s CFI program.

use gimli::{UninitializedUnwindContext, UnwindTable};

// An uninitialized context.
let mut ctx = UninitializedUnwindContext::new();

// Initialize the context by evaluating the CIE's initial instruction program,
// and generate the unwind table.
let mut table = some_fde.rows(&eh_frame, &bases, &mut ctx)?;
while let Some(row) = table.next_row()? {
    // Do stuff with each row...
}

Implementations

impl<R: Reader> UninitializedUnwindContext<R>

pub fn new() -> UninitializedUnwindContext<R>

Construct a new call frame unwinding context.

impl<R: Reader> UninitializedUnwindContext<R>

Signal Safe Methods

These methods are guaranteed not to allocate, acquire locks, or perform any other signal-unsafe operations.

pub fn initialize<Section: UnwindSection<R>>(
    &mut self,
    section: &Section,
    bases: &BaseAddresses,
    cie: &CommonInformationEntry<R>
) -> Result<&mut UnwindContext<R>>

Run the CIE’s initial instructions, creating and return an UnwindContext.

Trait Implementations

impl<R: Clone + Reader> Clone for UninitializedUnwindContext<R>

fn clone(&self) -> UninitializedUnwindContext<R>

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<R: Reader> Default for UninitializedUnwindContext<R>

fn default() -> Self

Returns the “default value” for a type.