116 lines
4.1 KiB
Rust
116 lines
4.1 KiB
Rust
//! Runtime library support for Wasmtime.
|
|
|
|
#![deny(missing_docs, trivial_numeric_casts, unused_extern_crates)]
|
|
#![warn(unused_import_braces)]
|
|
#![cfg_attr(feature = "clippy", plugin(clippy(conf_file = "../../clippy.toml")))]
|
|
#![cfg_attr(
|
|
feature = "cargo-clippy",
|
|
allow(clippy::new_without_default, clippy::new_without_default)
|
|
)]
|
|
#![cfg_attr(
|
|
feature = "cargo-clippy",
|
|
warn(
|
|
clippy::float_arithmetic,
|
|
clippy::mut_mut,
|
|
clippy::nonminimal_bool,
|
|
clippy::map_unwrap_or,
|
|
clippy::clippy::print_stdout,
|
|
clippy::unicode_not_nfc,
|
|
clippy::use_self
|
|
)
|
|
)]
|
|
|
|
use anyhow::Error;
|
|
|
|
mod export;
|
|
mod externref;
|
|
mod imports;
|
|
mod instance;
|
|
mod jit_int;
|
|
mod memory;
|
|
mod mmap;
|
|
mod table;
|
|
mod traphandlers;
|
|
mod vmcontext;
|
|
|
|
pub mod debug_builtins;
|
|
pub mod libcalls;
|
|
|
|
pub use crate::export::*;
|
|
pub use crate::externref::*;
|
|
pub use crate::imports::Imports;
|
|
pub use crate::instance::{
|
|
InstanceAllocationRequest, InstanceAllocator, InstanceHandle, InstanceLimits,
|
|
InstantiationError, LinkError, ModuleLimits, OnDemandInstanceAllocator,
|
|
PoolingAllocationStrategy, PoolingInstanceAllocator, StorePtr,
|
|
};
|
|
pub use crate::jit_int::GdbJitImageRegistration;
|
|
pub use crate::memory::{Memory, RuntimeLinearMemory, RuntimeMemoryCreator};
|
|
pub use crate::mmap::Mmap;
|
|
pub use crate::table::{Table, TableElement};
|
|
pub use crate::traphandlers::{
|
|
catch_traps, init_traps, raise_lib_trap, raise_user_trap, resume_panic, tls_eager_initialize,
|
|
SignalHandler, TlsRestore, Trap,
|
|
};
|
|
pub use crate::vmcontext::{
|
|
VMCallerCheckedAnyfunc, VMContext, VMFunctionBody, VMFunctionImport, VMGlobalDefinition,
|
|
VMGlobalImport, VMInterrupts, VMInvokeArgument, VMMemoryDefinition, VMMemoryImport,
|
|
VMSharedSignatureIndex, VMTableDefinition, VMTableImport, VMTrampoline, ValRaw,
|
|
};
|
|
|
|
/// Version number of this crate.
|
|
pub const VERSION: &str = env!("CARGO_PKG_VERSION");
|
|
|
|
/// Dynamic runtime functionality needed by this crate throughout the execution
|
|
/// of a wasm instance.
|
|
///
|
|
/// This trait is used to store a raw pointer trait object within each
|
|
/// `VMContext`. This raw pointer trait object points back to the
|
|
/// `wasmtime::Store` internally but is type-erased so this `wasmtime_runtime`
|
|
/// crate doesn't need the entire `wasmtime` crate to build.
|
|
///
|
|
/// Note that this is an extra-unsafe trait because no heed is paid to the
|
|
/// lifetime of this store or the Send/Sync-ness of this store. All of that must
|
|
/// be respected by embedders (e.g. the `wasmtime::Store` structure). The theory
|
|
/// is that `wasmtime::Store` handles all this correctly.
|
|
pub unsafe trait Store {
|
|
/// Returns the raw pointer in memory where this store's shared
|
|
/// `VMInterrupts` structure is located.
|
|
///
|
|
/// Used to configure `VMContext` initialization and store the right pointer
|
|
/// in the `VMContext`.
|
|
fn vminterrupts(&self) -> *mut VMInterrupts;
|
|
|
|
/// Returns the externref management structures necessary for this store.
|
|
///
|
|
/// The first element returned is the table in which externrefs are stored
|
|
/// throughout wasm execution, and the second element is how to look up
|
|
/// module information for gc requests.
|
|
fn externref_activations_table(
|
|
&mut self,
|
|
) -> (&mut VMExternRefActivationsTable, &dyn ModuleInfoLookup);
|
|
|
|
/// Callback invoked to allow the store's resource limiter to reject a memory grow operation.
|
|
fn memory_growing(
|
|
&mut self,
|
|
current: usize,
|
|
desired: usize,
|
|
maximum: Option<usize>,
|
|
) -> Result<bool, Error>;
|
|
/// Callback invoked to notify the store's resource limiter that a memory grow operation has
|
|
/// failed.
|
|
fn memory_grow_failed(&mut self, error: &Error);
|
|
/// Callback invoked to allow the store's resource limiter to reject a table grow operation.
|
|
fn table_growing(
|
|
&mut self,
|
|
current: u32,
|
|
desired: u32,
|
|
maximum: Option<u32>,
|
|
) -> Result<bool, Error>;
|
|
|
|
/// Callback invoked whenever fuel runs out by a wasm instance. If an error
|
|
/// is returned that's raised as a trap. Otherwise wasm execution will
|
|
/// continue as normal.
|
|
fn out_of_gas(&mut self) -> Result<(), Error>;
|
|
}
|