Struct wasmedge_sys::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 DIR1:DIR2.

Error

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

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 DIR1:DIR2.

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.

pub fn as_ptr(&self) -> *const WasmEdge_ModuleInstanceContext

Provides a raw pointer to the inner module instance context.

Trait Implementations

impl AsImport for WasiModule

fn name(&self) -> &str

Returns the name of the module instance.

fn add_func(&mut self, name: impl AsRef<str>, func: Function)

Imports a host function instance.

fn add_table(&mut self, name: impl AsRef<str>, table: Table)

Imports a table instance.

fn add_memory(&mut self, name: impl AsRef<str>, memory: Memory)

Imports a memory instance.

fn add_global(&mut self, name: impl AsRef<str>, global: Global)

Imports a global instance.

impl AsInstance for WasiModule

fn func_len(&self) -> u32

Returns the length of the exported function instances in this module instance.

fn func_names(&self) -> Option<Vec<String>>

Returns the names of the exported function instances in this module instance.

fn table_len(&self) -> u32

Returns the length of the exported table instances in this module instance.

fn table_names(&self) -> Option<Vec<String>>

Returns the names of the exported table instances in this module instance.

fn mem_len(&self) -> u32

Returns the length of the exported memory instances in this module instance.

fn mem_names(&self) -> Option<Vec<String>>

Returns the names of all exported memory instances in this module instance.

fn global_len(&self) -> u32

Returns the length of the exported global instances in this module instance.

fn global_names(&self) -> Option<Vec<String>>

Returns the names of the exported global instances in this module instance.

fn get_func(&self, name: impl AsRef<str>) -> WasmEdgeResult<Function>

Returns the exported function instance by name.

fn get_table(&self, name: impl AsRef<str>) -> WasmEdgeResult<Table>

Returns the exported table instance by name.

fn get_memory(&self, name: impl AsRef<str>) -> WasmEdgeResult<Memory>

Returns the exported memory instance by name.

fn get_global(&self, name: impl AsRef<str>) -> WasmEdgeResult<Global>

Returns the exported global instance by name.

impl Clone for WasiModule

fn clone(&self) -> WasiModule

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WasiModule

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

Formats the value using the given formatter.

impl Drop for WasiModule

fn drop(&mut self)

Executes the destructor for this type.