pub struct Dwarf<R> {
Show 13 fields pub debug_abbrev: DebugAbbrev<R>, pub debug_addr: DebugAddr<R>, pub debug_aranges: DebugAranges<R>, pub debug_info: DebugInfo<R>, pub debug_line: DebugLine<R>, pub debug_line_str: DebugLineStr<R>, pub debug_str: DebugStr<R>, pub debug_str_offsets: DebugStrOffsets<R>, pub debug_types: DebugTypes<R>, pub locations: LocationLists<R>, pub ranges: RangeLists<R>, pub file_type: DwarfFileType, pub sup: Option<Arc<Dwarf<R>>>,
}
Expand description

All of the commonly used DWARF sections, and other common information.

Fields

debug_abbrev: DebugAbbrev<R>

The .debug_abbrev section.

debug_addr: DebugAddr<R>

The .debug_addr section.

debug_aranges: DebugAranges<R>

The .debug_aranges section.

debug_info: DebugInfo<R>

The .debug_info section.

debug_line: DebugLine<R>

The .debug_line section.

debug_line_str: DebugLineStr<R>

The .debug_line_str section.

debug_str: DebugStr<R>

The .debug_str section.

debug_str_offsets: DebugStrOffsets<R>

The .debug_str_offsets section.

debug_types: DebugTypes<R>

The .debug_types section.

locations: LocationLists<R>

The location lists in the .debug_loc and .debug_loclists sections.

ranges: RangeLists<R>

The range lists in the .debug_ranges and .debug_rnglists sections.

file_type: DwarfFileType

The type of this file.

sup: Option<Arc<Dwarf<R>>>

The DWARF sections for a supplementary object file.

Implementations

Try to load the DWARF sections using the given loader function.

section loads a DWARF section from the object file. It should return an empty section if the section does not exist.

section may either directly return a Reader instance (such as EndianSlice), or it may return some other type and then convert that type into a Reader using Dwarf::borrow.

After loading, the user should set the file_type field and call load_sup if required.

Load the DWARF sections from the supplementary object file.

section operates the same as for load.

Sets self.sup, replacing any previous value.

Create a Dwarf structure that references the data in self.

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

Example Usage

It can be useful to load DWARF sections into owned data structures, such as Vec. However, we do not implement the Reader trait for Vec, because it would be very inefficient, but this trait is required for all of the methods that parse the DWARF data. So we first load the DWARF sections into Vecs, and then use borrow to create Readers that reference the data.

// Read the DWARF sections into `Vec`s with whatever object loader you're using.
let mut owned_dwarf: gimli::Dwarf<Vec<u8>> = gimli::Dwarf::load(loader)?;
owned_dwarf.load_sup(sup_loader)?;
// Create references to the DWARF sections.
let dwarf = owned_dwarf.borrow(|section| {
    gimli::EndianSlice::new(&section, gimli::LittleEndian)
});

Return a reference to the DWARF sections for supplementary object file.

Iterate the unit headers in the .debug_info section.

Can be used with FallibleIterator.

Construct a new Unit from the given unit header.

Iterate the type-unit headers in the .debug_types section.

Can be used with FallibleIterator.

Parse the abbreviations for a compilation unit.

Return the string offset at the given index.

Return the string at the given offset in .debug_str.

Return the string at the given offset in .debug_line_str.

Return an attribute value as a string slice.

If the attribute value is one of:

  • an inline DW_FORM_string string
  • a DW_FORM_strp reference to an offset into the .debug_str section
  • a DW_FORM_strp_sup reference to an offset into a supplementary object file
  • a DW_FORM_line_strp reference to an offset into the .debug_line_str section
  • a DW_FORM_strx index into the .debug_str_offsets entries for the unit

then return the attribute’s string value. Returns an error if the attribute value does not have a string form, or if a string form has an invalid value.

Return the address at the given index.

Try to return an attribute value as an address.

If the attribute value is one of:

  • a DW_FORM_addr
  • a DW_FORM_addrx index into the .debug_addr entries for the unit

then return the address. Returns None for other forms.

Return the range list offset for the given raw offset.

This handles adding DW_AT_GNU_ranges_base if required.

Return the range list offset at the given index.

Iterate over the RangeListEntrys starting at the given offset.

Iterate over the RawRngListEntryies starting at the given offset.

Try to return an attribute value as a range list offset.

If the attribute value is one of:

  • a DW_FORM_sec_offset reference to the .debug_ranges or .debug_rnglists sections
  • a DW_FORM_rnglistx index into the .debug_rnglists entries for the unit

then return the range list offset of the range list. Returns None for other forms.

Try to return an attribute value as a range list entry iterator.

If the attribute value is one of:

  • a DW_FORM_sec_offset reference to the .debug_ranges or .debug_rnglists sections
  • a DW_FORM_rnglistx index into the .debug_rnglists entries for the unit

then return an iterator over the entries in the range list. Returns None for other forms.

Return an iterator for the address ranges of a DebuggingInformationEntry.

This uses DW_AT_low_pc, DW_AT_high_pc and DW_AT_ranges.

Return an iterator for the address ranges of a Unit.

This uses DW_AT_low_pc, DW_AT_high_pc and DW_AT_ranges of the root DebuggingInformationEntry.

Return the location list offset at the given index.

Iterate over the LocationListEntrys starting at the given offset.

Iterate over the raw LocationListEntrys starting at the given offset.

Try to return an attribute value as a location list offset.

If the attribute value is one of:

  • a DW_FORM_sec_offset reference to the .debug_loc or .debug_loclists sections
  • a DW_FORM_loclistx index into the .debug_loclists entries for the unit

then return the location list offset of the location list. Returns None for other forms.

Try to return an attribute value as a location list entry iterator.

If the attribute value is one of:

  • a DW_FORM_sec_offset reference to the .debug_loc or .debug_loclists sections
  • a DW_FORM_loclistx index into the .debug_loclists entries for the unit

then return an iterator over the entries in the location list. Returns None for other forms.

Call Reader::lookup_offset_id for each section, and return the first match.

The first element of the tuple is true for supplementary sections.

Returns a string representation of the given error.

This uses information from the DWARF sections to provide more information in some cases.

Trait Implementations

Formats the value using the given formatter. Read more

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

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.

Performs the conversion.

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.