pub struct DebugInfo<R> { /* private fields */ }
Expand description

The DebugInfo struct represents the DWARF debugging information found in the .debug_info section.

Implementations

Construct a new DebugInfo instance from the data in the .debug_info section.

It is the caller’s responsibility to read the .debug_info section and present it as a &[u8] slice. That means using some ELF loader on Linux, a Mach-O loader on OSX, etc.

use gimli::{DebugInfo, LittleEndian};

let debug_info = DebugInfo::new(read_debug_info_section_somehow(), LittleEndian);

Iterate the units in this .debug_info section.

use gimli::{DebugInfo, LittleEndian};

let debug_info = DebugInfo::new(read_debug_info_section_somehow(), LittleEndian);

let mut iter = debug_info.units();
while let Some(unit) = iter.next().unwrap() {
    println!("unit's length is {}", unit.unit_length());
}

Can be used with FallibleIterator.

Get the UnitHeader located at offset from this .debug_info section.

Create a DebugInfo section that references the data in self.

This is useful when R implements Reader but T does not.

Example Usage
// Read the DWARF section into a `Vec` with whatever object loader you're using.
let owned_section: gimli::DebugInfo<Vec<u8>> = load_section();
// Create a reference to the DWARF section.
let section = owned_section.borrow(|section| {
    gimli::EndianSlice::new(&section, gimli::LittleEndian)
});

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Returns the “default value” for a type. Read more

Performs the conversion.

Returns the section id for this type.

Returns the Reader for this section.

Returns the ELF section name for this type.

Returns the ELF section name (if any) for this type when used in a dwo file. Read more

Try to load the section using the given loader function.

Returns the subrange of the section that is the contribution of a unit in a .dwp file. Read more

Returns the Reader for this section.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.