Crate wasmer_vm

source ·
Expand description

Runtime library support for Wasmer.

Re-exports§

  • pub use crate::memory::initialize_memory_with_data;

Modules§

  • export 🔒
  • extern_ref 🔒
  • function_env 🔒
  • global 🔒
  • imports 🔒
  • instance 🔒
    An Instance contains all the runtime state used by execution of a WebAssembly module (except its callstack and register state). An VMInstance is a wrapper around Instance that manages how it is allocated and deallocated.
  • libcalls
    Runtime library calls.
  • memory 🔒
    Memory management for linear memories.
  • mmap 🔒
    Low-level abstraction for allocating and managing zero-filled pages of memory.
  • probestack 🔒
    This section defines the PROBESTACK intrinsic which is used in the implementation of “stack probes” on certain platforms.
  • sig_registry 🔒
    Implement a registry of function signatures, for fast indirect call signature checking.
  • store 🔒
  • table 🔒
    Memory management for tables.
  • threadconditions 🔒
  • trap 🔒
    This is the module that facilitates the usage of Traps in Wasmer Runtime
  • vmcontext 🔒
    This file declares VMContext and several related structs which contain fields that compiled wasm code accesses directly.

Structs§

  • FunctionBodyPtr
    A safe wrapper around VMFunctionBody.
  • Imports
    Resolved import pointers.
  • InstanceAllocator
    This is an intermediate type that manages the raw allocation and metadata when creating an Instance.
  • InternalStoreHandle
    Internal handle to an object owned by the current context.
  • Mmap
    A simple struct consisting of a page-aligned pointer to page-aligned and initially-zeroed memory and a length.
  • NotifyLocation
    A location in memory for a Waiter
  • SectionBodyPtr
    Pointers to section data.
  • SignatureRegistry
    WebAssembly requires that the caller and callee signatures in an indirect call must match. To implement this efficiently, keep a registry of all signatures, shared by all instances, so that call sites can just do an index comparison.
  • StoreHandle
    Handle to an object managed by a context.
  • StoreId
    Unique ID to identify a context.
  • StoreObjects
    Set of objects managed by a context.
  • TargetSharedSignatureIndex
    Target specific type for shared signature index.
  • VMBuiltinFunctionIndex
    An index type for builtin functions.
  • VMCallerCheckedAnyfunc
    The VM caller-checked “anyfunc” record, for caller-side signature checking. It consists of the actual function pointer and a signature id to be checked by the caller.
  • VMConfig
    Configuration for the runtime VM Currently only the stack size is configurable
  • VMContext
    The VM “context”, which is pointed to by the vmctx arg in the compiler. This has information about globals, memories, tables, and other runtime state associated with the current instance.
  • VMDynamicFunctionContext
    The VMDynamicFunctionContext is the context that dynamic functions will receive when called (rather than vmctx). A dynamic function is a function for which we don’t know the signature until runtime.
  • VMExternObj
    Underlying object referenced by a VMExternRef.
  • VMExternRef
    Represents an opaque reference to any data within WebAssembly.
  • VMFuncRef
    A function reference. A single word that points to metadata about a function.
  • VMFunction
    A function export value.
  • VMFunctionBody
    A placeholder byte-sized type which is just used to provide some amount of type safety when dealing with pointers to JIT-compiled function bodies. Note that it’s deliberately not Copy, as we shouldn’t be carelessly copying function body bytes around.
  • VMFunctionEnvironment
    Underlying FunctionEnvironment used by a VMFunction.
  • VMFunctionImport
    An imported function.
  • VMGlobal
    A Global instance
  • VMGlobalDefinition
    The storage for a WebAssembly global defined within the instance.
  • VMGlobalImport
    The fields compiled code needs to access to utilize a WebAssembly global variable imported from another instance.
  • VMInstance
    A handle holding an Instance of a WebAssembly module.
  • VMMemory
    Represents linear memory that can be either owned or shared
  • VMMemoryDefinition
    The fields compiled code needs to access to utilize a WebAssembly linear memory defined within the instance, namely the start address and the size in bytes.
  • VMMemoryImport
    The fields compiled code needs to access to utilize a WebAssembly linear memory imported from another instance.
  • VMOffsets
    This class computes offsets to fields within VMContext and other related structs that JIT code accesses directly.
  • VMOwnedMemory
    A linear memory instance.
  • VMSharedMemory
    A shared linear memory instance.
  • VMSharedSignatureIndex
    An index into the shared signature registry, usable for checking signatures at indirect calls.
  • VMTable
    A table instance.
  • VMTableDefinition
    The fields compiled code needs to access to utilize a WebAssembly table defined within the instance.
  • VMTableImport
    The fields compiled code needs to access to utilize a WebAssembly table imported from another instance.

Enums§

  • LibCall
    The name of a runtime library routine.
  • MaybeInstanceOwned
    Data used by the generated code is generally located inline within the VMContext for items defined in an instance. Host-defined objects are allocated separately and owned directly by the context.
  • MemoryError
    Error type describing things that can go wrong when operating on Wasm Memories.
  • MemoryStyle
    Implementation styles for WebAssembly linear memory.
  • MmapType
    The type of mmap to create
  • TableElement
    A reference stored in a table. Can be either an externref or a funcref.
  • TableStyle
    Implementation styles for WebAssembly tables.
  • Trap
    Stores trace message with backtrace.
  • TrapCode
    A trap code describing the reason for a trap.
  • VMExtern
    The value of an export passed from one instance to another.
  • VMFunctionKind
    A function kind is a calling convention into and out of wasm code.

Constants§

  • VERSION
    Version number of this crate.

Statics§

  • PROBESTACK
    The probestack based on the Rust probestack

Traits§

  • LinearMemory
    Represents memory that is used by the WebAsssembly module

Functions§

  • catch_traps⚠
    Catches any wasm traps that happen within the execution of closure, returning them as a Result.
  • init_traps
    This function is required to be called before any WebAssembly is entered. This will configure global state such as signal handlers to prepare the process to receive wasm traps.
  • on_host_stack
    When executing on the Wasm stack, temporarily switch back to the host stack to perform an operation that should not be constrainted by the Wasm stack limits.
  • raise_lib_trap⚠
    Raises a trap from inside library code immediately.
  • raise_user_trap⚠
    Raises a user-defined trap immediately.
  • resume_panic⚠
    Carries a Rust panic across wasm code and resumes the panic on the other side.
  • set_stack_size
    Default stack size is 1MB.
  • wasmer_call_trampoline⚠
    Call the wasm function pointed to by callee.

Type Aliases§

Unions§

  • VMFunctionContext
    Union representing the first parameter passed when calling a function.