Struct wasihost::wasi_snapshot_preview1::WasiHost

pub struct WasiHost<S: StringRepresentation> { /* fields omitted */ }

Host functions for WASI.

Methods

impl<S: StringRepresentation> WasiHost<S>

pub fn new(
    arguments: impl IntoIterator<Item = impl Into<S>>,
    environment: impl IntoIterator<Item = impl Into<S>>,
    fd_initialzer: impl WasiFdInitializer<S>
) -> Arc<Self>

Creates a new WASI host.

pub fn run_file(
    self: Arc<Self>,
    wasm_file: impl AsRef<Path>
) -> Result<exitcode, Box<dyn Error>>

Runs a WASM file on this WASI host.

pub fn run_binary(
    self: Arc<Self>,
    wasm_binary: &[u8]
) -> Result<exitcode, Box<dyn Error>>

Runs a WASM binary from memory on this WASI host.

Trait Implementations

impl<S: Debug + StringRepresentation> Debug for WasiHost<S>

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

Formats the value using the given formatter.

impl<S: StringRepresentation> WasiImports for WasiHost<S>

type StringRepresentation = S

String representation in the high-level APIs.

fn args_get(&self) -> WasiResult<&[S]>

Gets the command-line parameters.

fn environ_get(&self) -> WasiResult<&[S]>

Gets the environment. Is is common convention that each string is of the form key=value.

fn clock_res_get(&self, id: Clockid) -> WasiResult<Timestamp>

Return the resolution of a clock. Implementations are required to provide a non-zero value for supported clocks. For unsupported clocks, return Err(Errno::Inval).

fn clock_time_get(
    &self,
    id: Clockid,
    precision: Timestamp
) -> WasiResult<Timestamp>

Return the time value of a clock.

fn fd_advise(
    &self,
    fd: Fd,
    offset: Filesize,
    len: Filesize,
    advice: Advice
) -> WasiResult<()>

Provide file advisory information on a file descriptor.

fn fd_allocate(&self, fd: Fd, offset: Filesize, len: Filesize) -> WasiResult<()>

Force the allocation of space in a file.

fn fd_close(&self, fd: Fd) -> WasiResult<()>

Close a file descriptor.

fn fd_datasync(&self, fd: Fd) -> WasiResult<()>

Synchronize the data of a file to disk.

fn fd_fdstat_get(&self, fd: Fd) -> WasiResult<Fdstat>

Get the attributes of a file descriptor.

fn fd_fdstat_set_flags(&self, fd: Fd, flags: Fdflags) -> WasiResult<()>

Adjust the flags associated with a file descriptor.

fn fd_fdstat_set_rights(
    &self,
    fd: Fd,
    fs_rights_base: Rights,
    fs_rights_inheriting: Rights
) -> WasiResult<()>

Adjust the rights associated with a file descriptor. This can only be used to remove rights, and returns Err(Errno::Notcapable) if called in a way that would attempt to add rights.

fn fd_filestat_get(&self, fd: Fd) -> WasiResult<Filestat>

Return the attributes of an open file.

fn fd_filestat_set_size(&self, fd: Fd, size: Filesize) -> WasiResult<()>

Adjust the size of an open file. If this increases the file's size, the extra bytes are filled with zeros.

fn fd_filestat_set_times(
    &self,
    fd: Fd,
    atim: Timestamp,
    mtim: Timestamp,
    fst_flags: Fstflags
) -> WasiResult<()>

Adjust the timestamps of an open file or directory.

fn fd_pread(
    &self,
    fd: Fd,
    iovs: &mut [IoSliceMut],
    offset: Filesize
) -> WasiResult<Size>

Read from a file descriptor, without using and updating the file descriptor's offset.

fn fd_prestat_get(&self, fd: Fd) -> WasiResult<Prestat>

Return a description of the given preopened file descriptor.

fn fd_prestat_dir_name(&self, fd: Fd) -> WasiResult<S>

Return the directory name of the given preopened file descriptor.

fn fd_pwrite(
    &self,
    fd: Fd,
    bufs: &[IoSlice],
    offset: Filesize
) -> WasiResult<Size>

Write to a file descriptor, without using and updating the file descriptor's offset.

fn fd_read(&self, fd: Fd, iovs: &mut [IoSliceMut]) -> WasiResult<Size>

Read from a file descriptor.

fn fd_readdir(
    &self,
    fd: Fd,
    cookie: Dircookie
) -> WasiResult<Option<(Dirent, S)>>

Read one directory entry from a directory.

fn fd_renumber(&self, fd: Fd, to: Fd) -> WasiResult<()>

Atomically replace a file descriptor by renumbering another file descriptor. Due to the strong focus on thread safety, this environment does not provide a mechanism to duplicate or renumber a file descriptor to an arbitrary number, like dup2(). This would be prone to race conditions, as an actual file descriptor with the same number could be allocated by a different thread at the same time.

fn fd_seek(
    &self,
    fd: Fd,
    offset: Filedelta,
    whence: Whence
) -> WasiResult<Filesize>

Move the offset of a file descriptor.

fn fd_sync(&self, fd: Fd) -> WasiResult<()>

Synchronize the data and metadata of a file to disk.

fn fd_tell(&self, fd: Fd) -> WasiResult<Filesize>

Return the current offset of a file descriptor.

fn fd_write(&self, fd: Fd, bufs: &[IoSlice]) -> WasiResult<Size>

Write to a file descriptor.

fn path_create_directory(
    &self,
    fd: Fd,
    path: &<S as Deref>::Target
) -> WasiResult<()>

Create a directory.

fn path_filestat_get(
    &self,
    fd: Fd,
    flags: Lookupflags,
    path: &<S as Deref>::Target
) -> WasiResult<Filestat>

Return the attributes of a file or directory.

fn path_filestat_set_times(
    &self,
    fd: Fd,
    flags: Lookupflags,
    path: &<S as Deref>::Target,
    atim: Timestamp,
    mtim: Timestamp,
    fst_flags: Fstflags
) -> WasiResult<()>

Adjust the timestamps of a file or directory.

fn path_open(
    &self,
    fd: Fd,
    dirflags: Lookupflags,
    path: &<S as Deref>::Target,
    oflags: Oflags,
    fs_rights_base: Rights,
    fs_rights_inheriting: Rights,
    fdflags: Fdflags
) -> WasiResult<Fd>

Open a file or directory. The returned file descriptor is not guaranteed to be the lowest-numbered file descriptor not currently open; it is randomized to prevent applications from depending on making assumptions about indexes, since this is error-prone in multi-threaded contexts. The returned file descriptor is guaranteed to be less than 2^31.

fn path_link(
    &self,
    old_fd: Fd,
    old_flags: Lookupflags,
    old_path: &<S as Deref>::Target,
    new_fd: Fd,
    new_path: &<S as Deref>::Target
) -> WasiResult<()>

Create a hard link.

fn path_readlink(&self, fd: Fd, path: &<S as Deref>::Target) -> WasiResult<S>

Read the contents of a symbolic link.

fn path_remove_directory(
    &self,
    fd: Fd,
    path: &<S as Deref>::Target
) -> WasiResult<()>

Remove a directory. Return Err(Errno::Notempty) if the directory is not empty.

fn path_rename(
    &self,
    fd: Fd,
    old_path: &<S as Deref>::Target,
    new_fd: Fd,
    new_path: &<S as Deref>::Target
) -> WasiResult<()>

Rename a file or directory.

fn path_symlink(
    &self,
    old_path: &<S as Deref>::Target,
    fd: Fd,
    new_path: &<S as Deref>::Target
) -> WasiResult<()>

Create a symbolic link.

fn path_unlink_file(
    &self,
    fd: Fd,
    path: &<S as Deref>::Target
) -> WasiResult<()>

Unlink a file. Return Err(Errno::Isdir) if the path refers to a directory.

fn poll_oneoff(&self, _subscriptions: &[Subscription]) -> WasiResult<Vec<Event>>

Concurrently poll for the occurrence of a set of events.

fn proc_exit(&self, c: Exitcode) -> Result<Infallible, Exitcode>

Terminate the process normally. An exit code of 0 indicates successful termination of the program. The meanings of other values is dependent on the environment.

fn proc_raise(&self, _: Signal) -> WasiResult<()>

Send a signal to the process of the calling thread.

fn random_get(&self, buf: &mut [u8]) -> WasiResult<()>

Write high-quality random data into a buffer. This function blocks when the implementation is unable to immediately provide sufficient high-quality random data. This function may execute slowly, so when large mounts of random data are required, it's advisable to use this function to seed a pseudo-random number generator, rather than to provide the random data directly.

fn sched_yield(&self) -> WasiResult<()>

Temporarily yield execution of the calling thread.

fn sock_recv(
    &self,
    fd: Fd,
    ri_data: &mut [IoSliceMut],
    ri_flags: Riflags
) -> WasiResult<(Size, Roflags)>

Receive a message from a socket.

fn sock_send(
    &self,
    fd: Fd,
    si_data: &[IoSlice],
    si_flags: Siflags
) -> WasiResult<Size>

Send a message on a socket.

fn sock_shutdown(&self, fd: Fd, how: Sdflags) -> WasiResult<()>

Shut down socket send and receive channels.