Crate 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;

Modules

• artifact_builders 🔒
  Generic Artifact abstraction for Wasmer Engines.
• compiler 🔒
  This module mainly outputs the Compiler trait that custom compilers will need to implement.
• engine 🔒
  The Wasmer Engine.
• lib 🔒
• object
  Object creator for Wasm Compilations.
• serialize
• traits 🔒
  Generic Artifact abstraction for Wasmer Engines.
• translator 🔒
  This module defines the parser and translator from wasmparser to a common structure ModuleInfo.
• types
  Types for compilation.

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
  Make a [WasmError] out of a [BinaryReaderError].
• 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.