Struct symbolic::debuginfo::wasm::WasmObject

pub struct WasmObject<'data> { /* fields omitted */ }

Wasm object container (.wasm), used for executables and debug companions on web and wasi.

This can only parse binary wasm file and not wast files.

Implementations

impl<'data> WasmObject<'data>

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

Tests whether the buffer could contain a WASM object.

pub fn parse(data: &'data [u8]) -> Result<WasmObject<'data>, WasmError>

Tries to parse a WASM from the given slice.

pub fn file_format(&self) -> FileFormat

The container file format, which currently is always FileFormat::Wasm.

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

The code identifier of this object.

Wasm does not yet provide code IDs.

pub fn debug_id(&self) -> DebugId

The debug information identifier of a WASM file.

Wasm does not yet provide debug IDs.

pub fn arch(&self) -> Arch

The CPU architecture of this object.

pub fn kind(&self) -> ObjectKind

The kind of this object.

pub fn load_address(&self) -> u64

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

This is always 0 as this does not really apply to WASM.

pub fn has_symbols(&self) -> bool

Determines whether this object exposes a public symbol table.

pub fn symbols(&self) -> WasmSymbolIterator<'data, '_>

Returns an iterator over symbols in the public symbol table.

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

Returns an ordered map of symbols in the symbol table.

pub fn has_debug_info(&self) -> bool

Determines whether this object contains debug information.

pub fn debug_session(&self) -> Result<DwarfDebugSession<'data>, DwarfError>

Constructs a debugging session.

pub fn has_unwind_info(&self) -> bool

Determines whether this object contains stack unwinding information.

pub fn has_sources(&self) -> bool

Determines whether this object contains embedded source.

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

Returns the raw data of the WASM file.

pub fn code_offset(&self) -> u64

Returns the offset of the code section.

Trait Implementations

impl<'slf, 'd> AsSelf<'slf> for WasmObject<'d> where
    'd: 'slf, 

type Ref = WasmObject<'slf>

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

pub fn as_self(&'slf self) -> &'slf <WasmObject<'d> as AsSelf<'slf>>::Ref

Returns a reference to self with downcasted lifetime.

impl<'_> Debug for WasmObject<'_>

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

Formats the value using the given formatter.

impl<'d> Dwarf<'d> for WasmObject<'d>

pub fn endianity(&self) -> RunTimeEndian

Returns whether the file was compiled for a big-endian or little-endian machine.

pub fn raw_section(&self, section_name: &str) -> Option<DwarfSection<'d>>

Returns information and raw data of a section.

pub fn section(&self, name: &str) -> Option<DwarfSection<'data>>

Returns information and data of a section.

pub fn has_section(&self, name: &str) -> bool

Determines whether the specified section exists.

impl<'data, 'object> ObjectLike<'data, 'object> for WasmObject<'data> where
    'data: 'object, 

type Error = DwarfError

Errors thrown when reading information from this object.

type Session = DwarfDebugSession<'data>

A session that allows optimized access to debugging information.

type SymbolIterator = WasmSymbolIterator<'data, 'object>

The iterator over the symbols in the public symbol table.

pub fn file_format(&self) -> FileFormat

The container format of this file.

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

The code identifier of this object.

pub fn debug_id(&self) -> DebugId

The debug information identifier of this object.

pub fn arch(&self) -> Arch

The CPU architecture of this object.

pub fn kind(&self) -> ObjectKind

The kind of this object.

pub fn load_address(&self) -> u64

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

pub fn has_symbols(&self) -> bool

Determines whether this object exposes a public symbol table.

pub fn symbols(
    &'object self
) -> <WasmObject<'data> as ObjectLike<'data, 'object>>::SymbolIterator

Returns an iterator over symbols in the public symbol table.

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

Returns an ordered map of symbols in the symbol table.

pub fn has_debug_info(&self) -> bool

Determines whether this object contains debug information.

pub fn debug_session(
    &self
) -> Result<<WasmObject<'data> as ObjectLike<'data, 'object>>::Session, <WasmObject<'data> as ObjectLike<'data, 'object>>::Error>

Constructs a debugging session.

pub fn has_unwind_info(&self) -> bool

Determines whether this object contains stack unwinding information.

pub fn has_sources(&self) -> bool

Determines whether this object contains embedded sources.