Struct gimli::read::Unit

pub struct Unit<R, Offset = <R as Reader>::Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset,  {
    pub header: UnitHeader<R, Offset>,
    pub abbreviations: Abbreviations,
    pub name: Option<R>,
    pub comp_dir: Option<R>,
    pub low_pc: u64,
    pub str_offsets_base: DebugStrOffsetsBase<Offset>,
    pub addr_base: DebugAddrBase<Offset>,
    pub loclists_base: DebugLocListsBase<Offset>,
    pub rnglists_base: DebugRngListsBase<Offset>,
    pub line_program: Option<IncompleteLineProgram<R, Offset>>,
    pub dwo_id: Option<DwoId>,
}

All of the commonly used information for a unit in the .debug_info or .debug_types sections.

Fields

header: UnitHeader<R, Offset>

The header of the unit.

abbreviations: Abbreviations

The parsed abbreviations for the unit.

name: Option<R>

The DW_AT_name attribute of the unit.

comp_dir: Option<R>

The DW_AT_comp_dir attribute of the unit.

low_pc: u64

The DW_AT_low_pc attribute of the unit. Defaults to 0.

str_offsets_base: DebugStrOffsetsBase<Offset>

The DW_AT_str_offsets_base attribute of the unit. Defaults to 0.

addr_base: DebugAddrBase<Offset>

The DW_AT_addr_base attribute of the unit. Defaults to 0.

loclists_base: DebugLocListsBase<Offset>

The DW_AT_loclists_base attribute of the unit. Defaults to 0.

rnglists_base: DebugRngListsBase<Offset>

The DW_AT_rnglists_base attribute of the unit. Defaults to 0.

line_program: Option<IncompleteLineProgram<R, Offset>>

The line number program of the unit.

dwo_id: Option<DwoId>

The DWO ID of a skeleton unit or split compilation unit.

Implementations

impl<R: Reader> Unit<R>

pub fn new(dwarf: &Dwarf<R>, header: UnitHeader<R>) -> Result<Self>

Construct a new Unit from the given unit header.

pub fn encoding(&self) -> Encoding

Return the encoding parameters for this unit.

pub fn entry(
    &self,
    offset: UnitOffset<R::Offset>
) -> Result<DebuggingInformationEntry<'_, '_, R>>

Read the DebuggingInformationEntry at the given offset.

pub fn entries(&self) -> EntriesCursor<'_, '_, R>

Navigate this unit’s DebuggingInformationEntrys.

pub fn entries_at_offset(
    &self,
    offset: UnitOffset<R::Offset>
) -> Result<EntriesCursor<'_, '_, R>>

Navigate this unit’s DebuggingInformationEntrys starting at the given offset.

pub fn entries_tree(
    &self,
    offset: Option<UnitOffset<R::Offset>>
) -> Result<EntriesTree<'_, '_, R>>

Navigate this unit’s DebuggingInformationEntrys as a tree starting at the given offset.

pub fn entries_raw(
    &self,
    offset: Option<UnitOffset<R::Offset>>
) -> Result<EntriesRaw<'_, '_, R>>

Read the raw data that defines the Debugging Information Entries.

pub fn copy_relocated_attributes(&mut self, other: &Unit<R>)

Copy attributes that are subject to relocation from another unit. This is intended to be used to copy attributes from a skeleton compilation unit to the corresponding split compilation unit.

Trait Implementations

impl<R: Debug, Offset: Debug> Debug for Unit<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

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

Formats the value using the given formatter.