Trait symbolic::debuginfo::ObjectLike

source ·

pub trait ObjectLike<'data, 'object> {
    type Error;
    type Session: for<'session> DebugSession<'session, Error = Self::Error>;
    type SymbolIterator: Iterator<Item = Symbol<'data>>;

Show 14 methods    // Required methods
    fn file_format(&self) -> FileFormat;
    fn code_id(&self) -> Option<CodeId>;
    fn debug_id(&self) -> DebugId;
    fn arch(&self) -> Arch;
    fn kind(&self) -> ObjectKind;
    fn load_address(&self) -> u64;
    fn has_symbols(&self) -> bool;
    fn symbols(&'object self) -> Self::SymbolIterator;
    fn symbol_map(&self) -> SymbolMap<'data>;
    fn has_debug_info(&self) -> bool;
    fn debug_session(&'object self) -> Result<Self::Session, Self::Error>;
    fn has_unwind_info(&self) -> bool;
    fn has_sources(&self) -> bool;
    fn is_malformed(&self) -> bool;
}

Expand description

An object containing debug information.

Required Associated Types§

source

type Error

Errors thrown when reading information from this object.

source

type Session: for<'session> DebugSession<'session, Error = Self::Error>

A session that allows optimized access to debugging information.

source

type SymbolIterator: Iterator<Item = Symbol<'data>>

The iterator over the symbols in the public symbol table.

Required Methods§

source

fn file_format(&self) -> FileFormat

The container format of this file.

source

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

The code identifier of this object.

The identifier can be None if it cannot be determined from the object file, for instance, because the identifier was stripped in the build process.

source

fn debug_id(&self) -> DebugId

The debug information identifier of this object.

source

fn arch(&self) -> Arch

The CPU architecture of this object.

source

fn load_address(&self) -> u64

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

source

fn has_symbols(&self) -> bool

Determines whether this object exposes a public symbol table.

source

fn symbols(&'object self) -> Self::SymbolIterator

Returns an iterator over symbols in the public symbol table.

source

fn symbol_map(&self) -> SymbolMap<'data>

Returns an ordered map of symbols in the symbol table.

source

fn has_debug_info(&self) -> bool

Determines whether this object contains debug information.

source

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

Constructs a debugging session.

A debugging session loads certain information from the object file and creates caches for efficient access to various records in the debug information. Since this can be quite a costly process, try to reuse the debugging session as long as possible.

Constructing this session will also work if the object does not contain debugging information, in which case the session will be a no-op. This can be checked via has_debug_info.

source