Struct Module

pub struct Module {
    pub header: Header,
    pub sections: Vec<Section>,
}

A WebAssembly module.

Fields

header: Header

sections: Vec<Section>

Implementations

impl Module

pub fn show(&self, verbose: bool) -> Result<(), WSError>

Print the structure of a module to the standard output, mainly for debugging purposes.

Set verbose to true in order to also print details about signature data.

pub fn split<P>(self, predicate: P) -> Result<Module, WSError>

where P: FnMut(&Section) -> bool,

Prepare a module for partial verification.

The predicate should return true if a section is part of a set that can be verified, and false if the section can be ignored during verification.

It is highly recommended to always include the standard sections in the signed set.

pub fn detach_signature(self) -> Result<(Module, Vec<u8>), WSError>

Detach the signature from a signed module.

This function returns the module without the embedded signature, as well as the detached signature as a byte string.

pub fn attach_signature( self, detached_signature: &[u8], ) -> Result<Module, WSError>

Embed a detached signature into a module. This function returns the module with embedded signature.

impl Module

pub fn deserialize(reader: &mut impl Read) -> Result<Self, WSError>

Deserialize a WebAssembly module from the given reader.

pub fn deserialize_from_file(file: impl AsRef<Path>) -> Result<Self, WSError>

Deserialize a WebAssembly module from the given file.

pub fn serialize(&self, writer: &mut impl Write) -> Result<(), WSError>

Serialize a WebAssembly module to the given writer.

pub fn serialize_to_file(&self, file: impl AsRef<Path>) -> Result<(), WSError>

Serialize a WebAssembly module to the given file.

pub fn init_from_reader<T: Read>( reader: &mut T, ) -> Result<ModuleStreamReader<'_, T>, WSError>

Parse the module’s header. This function must be called before stream().

pub fn iterate<T: Read>( module_stream: ModuleStreamReader<'_, T>, ) -> Result<SectionsIterator<'_, T>, WSError>

Return an iterator over the sections of a WebAssembly module.

The module is read in a streaming fashion, and doesn’t have to be fully loaded into memory.

Trait Implementations

impl Clone for Module

fn clone(&self) -> Module

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Module

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

Formats the value using the given formatter.

impl Default for Module

fn default() -> Module

Returns the “default value” for a type.