Struct WasmObject

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

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 parse(data: &'data [u8]) -> Result<Self, WasmError>

Tries to parse a WASM from the given slice.

impl<'data> WasmObject<'data>

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

Tests whether the buffer could contain a WASM object.

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 is_malformed(&self) -> bool

Determines whether this object is malformed and was only partially parsed

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: 'slf> AsSelf<'slf> for WasmObject<'d>

type Ref = WasmObject<'slf>

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

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

Returns a reference to self with downcasted lifetime.

impl Debug for WasmObject<'_>

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

Formats the value using the given formatter.

impl<'data> Dwarf<'data> for WasmObject<'data>

fn endianity(&self) -> Endian

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

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

Returns information and raw data of a section.

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

Returns information and data of a section.

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

Determines whether the specified section exists.

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

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.

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 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(&'object self) -> Self::SymbolIterator

Returns an iterator over symbols in the public symbol table.

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

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.

fn has_sources(&self) -> bool

Determines whether this object contains embedded sources.

fn is_malformed(&self) -> bool

Determines whether this object is malformed and was only partially parsed