Struct gimli::read::CfiEntriesIter

pub struct CfiEntriesIter<'bases, Section, R>
where
    R: Reader,
    Section: UnwindSection<R>,
{
    section: Section,
    bases: &'bases BaseAddresses,
    input: R,
}

An iterator over CIE and FDE entries in a .debug_frame or .eh_frame section.

Some pointers may be encoded relative to various base addresses. Use the BaseAddresses parameter to provide them. By default, none are provided. If a relative pointer is encountered for a base address that is unknown, an Err will be returned and iteration will abort.

Can be used with FallibleIterator.

use gimli::{BaseAddresses, EhFrame, EndianSlice, NativeEndian, UnwindSection};

let eh_frame = EhFrame::new(read_eh_frame_somehow(), NativeEndian);

// Provide base addresses for relative pointers.
let bases = BaseAddresses::default()
    .set_eh_frame_hdr(address_of_eh_frame_hdr_section_in_memory)
    .set_eh_frame(address_of_eh_frame_section_in_memory)
    .set_text(address_of_text_section_in_memory)
    .set_got(address_of_got_section_in_memory);

let mut entries = eh_frame.entries(&bases);

while let Some(entry) = entries.next()? {
    do_stuff_with(entry)
}

Fields

section: Section

bases: &'bases BaseAddresses

input: R

Implementations

impl<'bases, Section, R> CfiEntriesIter<'bases, Section, R>

where R: Reader, Section: UnwindSection<R>,

pub fn next(&mut self) -> Result<Option<CieOrFde<'bases, Section, R>>>

Advance the iterator to the next entry.

Trait Implementations

impl<'bases, Section, R> Clone for CfiEntriesIter<'bases, Section, R>

where R: Reader + Clone, Section: UnwindSection<R> + Clone,

fn clone(&self) -> CfiEntriesIter<'bases, Section, R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'bases, Section, R> Debug for CfiEntriesIter<'bases, Section, R>

where R: Reader + Debug, Section: UnwindSection<R> + Debug,

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

Formats the value using the given formatter.