Struct symbolic_debuginfo::pe::PeObject

pub struct PeObject<'d> { /* fields omitted */ }

Portable Executable, an extension of COFF used on Windows.

This file format is used to carry program code. Debug information is usually moved to a separate container, PdbObject. The PE file contains a reference to the PDB and vice versa to verify that the files belong together.

While in rare instances, PE files might contain debug information, this case is not supported.

Methods

impl<'d> PeObject<'d>

pub fn test(data: &[u8]) -> bool

Tests whether the buffer could contain an PE object.

pub fn parse(data: &'d [u8]) -> Result<Self, PeError>

Tries to parse a PE object from the given slice.

pub fn file_format(&self) -> FileFormat

The container file format, which is always FileFormat::Pe.

pub fn code_id(&self) -> Option<CodeId>

The code identifier of this object.

The code identifier consists of the time_date_stamp field id the COFF header, followed by the size_of_image field in the optional header. If the optional PE header is not present, this identifier is None.

pub fn debug_id(&self) -> DebugId

The debug information identifier of this PE.

Since debug information is stored in an external [PdbObject], this identifier actually refers to the PDB. While strictly the filename of the PDB would also be necessary fully resolve it, in most instances the GUID and age contained in this identifier are sufficient.

pub fn debug_file_name(&self) -> Option<Cow<str>>

The name of the referenced PDB file.

pub fn arch(&self) -> Arch

The CPU architecture of this object, as specified in the COFF header.

pub fn kind(&self) -> ObjectKind

The kind of this object, as specified in the PE header.

pub fn load_address(&self) -> u64

The address at which the image prefers to be loaded into memory.

ELF files store all internal addresses as if it was loaded at that address. When the image is actually loaded, that spot might already be taken by other images and so it must be relocated to a new address. During load time, the loader rewrites all addresses in the program code to match the new load address so that there is no runtime overhead when executing the code.

Addresses used in symbols or debug_session have already been rebased relative to that load address, so that the caller only has to deal with addresses relative to the actual start of the image.

pub fn has_symbols(&self) -> bool

Determines whether this object exposes a public symbol table.

Important traits for PeSymbolIterator<'d, 'o>

impl<'d, 'o> Iterator for PeSymbolIterator<'d, 'o> type Item = Symbol<'d>;

pub fn symbols(&self) -> PeSymbolIterator<'d, '_>

Returns an iterator over symbols in the public symbol table.

pub fn symbol_map(&self) -> SymbolMap<'d>

Returns an ordered map of symbols in the symbol table.

pub fn has_debug_info(&self) -> bool

Determines whether this object contains debug information.

This is always false, as debug information is not supported for PE files.

pub fn debug_session(&self) -> Result<PeDebugSession<'d>, PeError>

Constructs a no-op debugging session.

pub fn has_unwind_info(&self) -> bool

Determines whether this object contains stack unwinding information.

pub fn data(&self) -> &'d [u8]

Returns the raw data of the PE file.

pub fn sections(&self) -> &[SectionTable]

A list of the sections in this PE binary, used to resolve virtual addresses.

pub fn exception_data(&self) -> Option<&ExceptionData>

Returns exception data containing unwind information.

Trait Implementations

impl<'d> ObjectLike for PeObject<'d>

type Error = PeError

Errors thrown when reading information from this object.

type Session = PeDebugSession<'d>

A session that allows optimized access to debugging information.

fn file_format(&self) -> FileFormat

The container format of this file.

fn code_id(&self) -> Option<CodeId>

The code identifier of this object.

fn debug_id(&self) -> DebugId

The debug information identifier of this object.

fn debug_file_name(&self) -> Option<Cow<str>>

The filename of the debug companion file.

fn arch(&self) -> Arch

The CPU architecture of this object.

fn kind(&self) -> ObjectKind

The kind of this object.

fn load_address(&self) -> u64

The address at which the image prefers to be loaded into memory.

fn has_symbols(&self) -> bool

Determines whether this object exposes a public symbol table.

fn symbols(&self) -> DynIterator<Symbol>

Returns an iterator over symbols in the public symbol table.

fn symbol_map(&self) -> SymbolMap

Returns an ordered map of symbols in the symbol table.

fn has_debug_info(&self) -> bool

Determines whether this object contains debug information.

fn debug_session(&self) -> Result<Self::Session, Self::Error>

Constructs a debugging session.

fn has_unwind_info(&self) -> bool

Determines whether this object contains stack unwinding information.

impl<'_> Debug for PeObject<'_>

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

Formats the value using the given formatter.

impl<'slf, 'd: 'slf> AsSelf<'slf> for PeObject<'d>

type Ref = PeObject<'slf>

The Self type with 'slf lifetimes, returned by as_self.

fn as_self(&'slf self) -> &Self::Ref

Returns a reference to self with downcasted lifetime.