Struct gimli::read::CfiEntriesIter

[+] Show declaration

pub struct CfiEntriesIter<'bases, Section, R> where
    R: Reader,
    Section: UnwindSection<R>,  { /* fields omitted */ }

[−] Expand description

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)
}

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: Clone, R: Clone> Clone for CfiEntriesIter<'bases, Section, R> where
    R: Reader,
    Section: UnwindSection<R>, [+]

[+] Show hidden undocumented items

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: Debug, R: Debug> Debug for CfiEntriesIter<'bases, Section, R> where
    R: Reader,
    Section: UnwindSection<R>, [+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[−]

Formats the value using the given formatter.