Trait wasmer_wasix::runtime::Runtime

pub trait Runtime
where
    Self: Debug,
{
    // Required methods
    fn networking(&self) -> &DynVirtualNetworking;
    fn task_manager(&self) -> &Arc<dyn VirtualTaskManager>;
    fn source(&self) -> Arc<dyn Source + Send + Sync>;

    // Provided methods
    fn package_loader(&self) -> Arc<dyn PackageLoader + Send + Sync> { ... }
    fn module_cache(&self) -> Arc<dyn ModuleCache + Send + Sync> { ... }
    fn engine(&self) -> Engine { ... }
    fn engine_with_suggested_opts(
        &self,
        suggested_opts: &SuggestedCompilerOptimizations,
    ) -> Result<Engine, CompileError> { ... }
    fn new_store(&self) -> Store { ... }
    fn http_client(&self) -> Option<&DynHttpClient> { ... }
    fn tty(&self) -> Option<&(dyn TtyBridge + Send + Sync)> { ... }
    fn load_command_module(
        &self,
        cmd: &BinaryPackageCommand,
    ) -> BoxFuture<'_, Result<Module, SpawnError>> { ... }
    fn load_command_module_sync(
        &self,
        cmd: &BinaryPackageCommand,
    ) -> Result<Module, SpawnError> { ... }
    fn load_module<'a>(
        &'a self,
        wasm: &'a [u8],
    ) -> BoxFuture<'a, Result<Module, SpawnError>> { ... }
    fn load_module_sync(&self, wasm: &[u8]) -> Result<Module, SpawnError> { ... }
    fn on_taint(&self, _reason: TaintReason) { ... }
    fn read_only_journals<'a>(
        &'a self,
    ) -> Box<dyn Iterator<Item = Arc<DynReadableJournal>> + 'a> { ... }
    fn writable_journals<'a>(
        &'a self,
    ) -> Box<dyn Iterator<Item = Arc<DynJournal>> + 'a> { ... }
    fn active_journal(&self) -> Option<&DynJournal> { ... }
}

Runtime components used when running WebAssembly programs.

Think of this as the “System” in “WebAssembly Systems Interface”.

Required Methods

fn networking(&self) -> &DynVirtualNetworking

Provides access to all the networking related functions such as sockets.

fn task_manager(&self) -> &Arc<dyn VirtualTaskManager>

Retrieve the active VirtualTaskManager.

fn source(&self) -> Arc<dyn Source + Send + Sync>

The package registry.

Provided Methods

fn package_loader(&self) -> Arc<dyn PackageLoader + Send + Sync>

A package loader.

fn module_cache(&self) -> Arc<dyn ModuleCache + Send + Sync>

A cache for compiled modules.

fn engine(&self) -> Engine

Get a [wasmer::Engine] for module compilation.

fn engine_with_suggested_opts( &self, suggested_opts: &SuggestedCompilerOptimizations, ) -> Result<Engine, CompileError>

fn new_store(&self) -> Store

Create a new wasmer::Store.

fn http_client(&self) -> Option<&DynHttpClient>

Get a custom HTTP client

fn tty(&self) -> Option<&(dyn TtyBridge + Send + Sync)>

Get access to the TTY used by the environment.

fn load_command_module( &self, cmd: &BinaryPackageCommand, ) -> BoxFuture<'_, Result<Module, SpawnError>>

Load the module for a command.

NOTE: This always be preferred over Self::load_module to avoid re-hashing the module!

fn load_command_module_sync( &self, cmd: &BinaryPackageCommand, ) -> Result<Module, SpawnError>

Sync version of Self::load_command_module.

fn load_module<'a>( &'a self, wasm: &'a [u8], ) -> BoxFuture<'a, Result<Module, SpawnError>>

Load a a Webassembly module, trying to use a pre-compiled version if possible.

fn load_module_sync(&self, wasm: &[u8]) -> Result<Module, SpawnError>

Load a a Webassembly module, trying to use a pre-compiled version if possible.

Non-async version of Self::load_module.

fn on_taint(&self, _reason: TaintReason)

Callback thats invokes whenever the instance is tainted, tainting can occur for multiple reasons however the most common is a panic within the process

fn read_only_journals<'a>( &'a self, ) -> Box<dyn Iterator<Item = Arc<DynReadableJournal>> + 'a>

The list of all read-only journals which will be used to restore the state of the runtime at a particular point in time

fn writable_journals<'a>( &'a self, ) -> Box<dyn Iterator<Item = Arc<DynJournal>> + 'a>

The list of writable journals which will be appended to

fn active_journal(&self) -> Option<&DynJournal>

The snapshot capturer takes and restores snapshots of the WASM process at specific points in time by reading and writing log entries

Implementors

impl Runtime for OverriddenRuntime

impl Runtime for PluggableRuntime