Crate wasmer_vm

Runtime library support for Wasmer.

Re-exports

• pub use crate::memory::initialize_memory_with_data;

Modules

• libcalls
  Runtime library calls.

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 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.
• 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.
• WaiterError
  Error that can occur during wait/notify calls.

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 Definitions

• TrapHandlerFn
  Function which may handle custom signals while processing traps.
• VMTrampoline

Unions

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