Struct gimli::read::CompilationUnitHeader

pub struct CompilationUnitHeader<R, Offset = <R as Reader>::Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset,  { /* fields omitted */ }

The header of a compilation unit's debugging information.

Implementations

impl<R, Offset> CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

pub fn new(
    header: UnitHeader<R, Offset>,
    offset: DebugInfoOffset<Offset>
) -> Self

Construct a new CompilationUnitHeader.

pub fn header(self) -> UnitHeader<R, Offset>

Return the UnitHeader containing common unit header fields.

pub fn size_of_header(format: Format) -> usize

Return the serialized size of the compilation unit header for the given DWARF format.

pub fn offset(&self) -> DebugInfoOffset<R::Offset>

Get the offset of this compilation unit within the .debug_info section.

pub fn unit_length(&self) -> R::Offset

Get the length of the debugging info for this compilation unit, not including the byte length of the encoded length itself.

pub fn length_including_self(&self) -> R::Offset

Get the length of the debugging info for this compilation unit, including the byte length of the encoded length itself.

pub fn encoding(&self) -> Encoding

Return the encoding parameters for this unit.

pub fn version(&self) -> u16

Get the DWARF version of the debugging info for this compilation unit.

pub fn debug_abbrev_offset(&self) -> DebugAbbrevOffset<R::Offset>

The offset into the .debug_abbrev section for this compilation unit's debugging information entries' abbreviations.

pub fn address_size(&self) -> u8

The size of addresses (in bytes) in this type-unit.

pub fn format(&self) -> Format

Whether this type unit is encoded in 64- or 32-bit DWARF.

pub fn header_size(&self) -> R::Offset

The serialized size of the header for this compilation unit.

pub fn entry<'me, 'abbrev>(
    &'me self,
    abbreviations: &'abbrev Abbreviations,
    offset: UnitOffset<R::Offset>
) -> Result<DebuggingInformationEntry<'abbrev, 'me, R>>

Read the DebuggingInformationEntry at the given offset.

pub fn entries<'me, 'abbrev>(
    &'me self,
    abbreviations: &'abbrev Abbreviations
) -> EntriesCursor<'abbrev, 'me, R>

Navigate this compilation unit's DebuggingInformationEntrys.

pub fn entries_at_offset<'me, 'abbrev>(
    &'me self,
    abbreviations: &'abbrev Abbreviations,
    offset: UnitOffset<R::Offset>
) -> Result<EntriesCursor<'abbrev, 'me, R>>

Navigate this compilation unit's DebuggingInformationEntrys starting at the given offset.

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

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

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

Read the raw data that defines the Debugging Information Entries.

pub fn abbreviations(
    &self,
    debug_abbrev: &DebugAbbrev<R>
) -> Result<Abbreviations>

Parse this compilation unit's abbreviations.

use gimli::DebugAbbrev;

let unit = get_some_unit();

let debug_abbrev = DebugAbbrev::new(read_debug_abbrev_section_somehow(), LittleEndian);
let abbrevs_for_unit = unit.abbreviations(&debug_abbrev).unwrap();

Trait Implementations

impl<R: Clone, Offset: Clone> Clone for CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

fn clone(&self) -> CompilationUnitHeader<R, Offset>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R: Copy, Offset: Copy> Copy for CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

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

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

Formats the value using the given formatter.

impl<R: Eq, Offset: Eq> Eq for CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

impl<R: PartialEq, Offset: PartialEq> PartialEq<CompilationUnitHeader<R, Offset>> for CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

fn eq(&self, other: &CompilationUnitHeader<R, Offset>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &CompilationUnitHeader<R, Offset>) -> bool

This method tests for !=.

impl<R, Offset> StructuralEq for CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset, 

impl<R, Offset> StructuralPartialEq for CompilationUnitHeader<R, Offset> where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset,