Struct WasiModule

pub struct WasiModule(/* private fields */);

A WasiModule is a module instance for the WASI specification.

Implementations

impl WasiModule

pub fn create( args: Option<Vec<&str>>, envs: Option<Vec<&str>>, preopens: Option<Vec<&str>>, ) -> WasmEdgeResult<Self>

Creates a WASI host module which contains the WASI host functions, and initializes it with the given parameters.

Arguments

• args - The commandline arguments. The first argument is the program name.

• envs - The environment variables in the format ENV_VAR_NAME=VALUE.

• preopens - The directories to pre-open. The required format is GUEST_PATH:HOST_PATH.

Error

If fail to create a host module, then an error is returned.

pub fn name(&self) -> &str

Returns the name of the module instance.

pub fn init_wasi( &mut self, args: Option<Vec<&str>>, envs: Option<Vec<&str>>, preopens: Option<Vec<&str>>, )

Initializes the WASI host module with the given parameters.

Arguments

• args - The commandline arguments. The first argument is the program name.

• envs - The environment variables in the format ENV_VAR_NAME=VALUE.

• preopens - The directories to pre-open. The required format is GUEST_PATH:HOST_PATH.

pub fn exit_code(&self) -> u32

Returns the WASI exit code.

The WASI exit code can be accessed after running the “_start” function of a wasm32-wasi program.

pub fn get_native_handler(&self, fd: i32) -> WasmEdgeResult<u64>

Returns the native handler from the mapped FD/Handler.

Argument

• fd - The WASI mapped Fd.

Error

If fail to get the native handler, then an error is returned.

Trait Implementations

impl AsMut<Instance> for WasiModule

fn as_mut(&mut self) -> &mut Instance

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Instance> for WasiModule

fn as_ref(&self) -> &Instance

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for WasiModule

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.