Crate linera_wasmer_compiler

The wasmer-compiler crate provides the necessary abstractions to create a compiler.

It provides an universal way of parsing a module via wasmparser, while giving the responsibility of compiling specific function WebAssembly bodies to the Compiler implementation.

Re-exports

pub use frame_info::FRAME_INFO;

pub use frame_info::FRAME_INFO;

pub use wasmparser;

Macros

wasm_unsupported

Return an Err(WasmError::Unsupported(msg)) where msg the string built by calling format! on the arguments to this macro.

Structs

Artifact

A compiled wasm module, ready to be instantiated.

ArtifactBuild

A compiled wasm module, ready to be instantiated.

ArtifactBuildFromArchive

A compiled wasm module that was loaded from a serialized archive.

BaseTunables

Tunable parameters for WebAssembly compilation. This is the reference implementation of the Tunables trait, used by default.

CodeMemory

Memory manager for executable code.

Engine

A WebAssembly Universal Engine.

EngineBuilder

The Builder contents of Engine

EngineInner

The inner contents of Engine

FRAME_INFO

This is a global cache of backtrace frame information for all active

Features

Controls which experimental features will be enabled. Features usually have a corresponding WebAssembly proposal.

FunctionBodyData

Contains function data: bytecode and its offset in the module.

FunctionExtent

Represents a continuous region of executable memory starting with a function entry point.

GlobalFrameInfoRegistration

An RAII structure used to unregister a module’s frame information when the module is destroyed.

MiddlewareBinaryReader

A Middleware binary reader of the WebAssembly structures and types.

MiddlewareReaderState

The state of the binary reader. Exposed to middlewares to push their outputs.

ModuleEnvironment

The result of translating via ModuleEnvironment. Function bodies are not yet translated, and data initializers have not yet been copied out of the original buffer. The function bodies will be translated by a specific compiler backend.

ModuleFromArchive

Module loaded from an archive. Since CompileModuleInfo is part of the public interface of this crate and has to be mutable, it has to be deserialized completely.

ModuleTranslationState

Contains information decoded from the Wasm module that must be referenced during each Wasm function’s translation.

Enums

CompiledFunctionFrameInfoVariant

The variant of the compiled function frame info which can be an owned type

FrameInfosVariant

The variant of the frame information which can be an owned type or the explicit framed map

InstantiationError

An error while instantiating a module.

LinkError

The WebAssembly.LinkError object indicates an error during module instantiation (besides traps from the start function).

Constants

VERSION

Version number of this crate.

Traits

ArtifactCreate

An Artifact is the product that the Engine implementation produce and use.

Compiler

An implementation of a Compiler from parsed WebAssembly module to Compiled native code.

CompilerConfig

The compiler configuration options.

FunctionBinaryReader

Trait for iterating over the operators of a Wasm Function

FunctionMiddleware

A function middleware specialized for a single function.

ModuleMiddleware

A shared builder for function middlewares.

ModuleMiddlewareChain

Trait for generating middleware chains from “prototype” (generator) chains.

Tunables

An engine delegates the creation of memories, tables, and globals to a foreign implementor of this trait.

Upcastable

Trait needed to get downcasting of Engines to work.

Functions

from_binaryreadererror_wasmerror

get_libcall_trampoline

Returns the address of a trampoline in the libcall trampolines section.

get_trace_and_trapcode

Given a Trap, this function returns the Wasm trace and the trap code.

libcall_trampoline_len

Returns the length of a libcall trampoline.

link_module

Links a module, patching the allocated functions with the required relocations and jump tables.

make_libcall_trampolines

Creates a custom section containing the libcall trampolines.

register_frame_info

Registers a new compiled module’s frame information.

resolve_imports

This function allows to match all imports of a ModuleInfo with concrete definitions provided by a Resolver.

translate_module

Translate a sequence of bytes forming a valid Wasm binary into a parsed ModuleInfo ModuleTranslationState.

wpheaptype_to_type

Converts a wasmparser heap type to a Wasm Type.

wptype_to_type

Helper function translating wasmparser types to Wasm Type.

Type Aliases

Addend

Addend to add to the symbol value.

CodeOffset

Offset in bytes from the beginning of the function.