Struct wasi_common::old::snapshot_0::WasiCtxBuilder

pub struct WasiCtxBuilder { /* fields omitted */ }

A builder allowing customizable construction of WasiCtx instances.

Methods

impl WasiCtxBuilder

pub fn new() -> Self

Builder for a new WasiCtx.

pub fn args<S: AsRef<[u8]>>(self, args: impl IntoIterator<Item = S>) -> Self

Add arguments to the command-line arguments list.

Arguments must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn arg<S: AsRef<[u8]>>(self, arg: S) -> Self

Add an argument to the command-line arguments list.

Arguments must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn inherit_args(self) -> Self

Inherit the command-line arguments from the host process.

If any arguments from the host process contain invalid UTF-8, WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn inherit_stdio(self) -> Self

Inherit the stdin, stdout, and stderr streams from the host process.

pub fn inherit_env(self) -> Self

Inherit the environment variables from the host process.

If any environment variables from the host process contain invalid Unicode (UTF-16 for Windows, UTF-8 for other platforms), WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn env<S: AsRef<[u8]>>(self, k: S, v: S) -> Self

Add an entry to the environment.

Environment variable keys and values must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn envs<S: AsRef<[u8]>, T: Borrow<(S, S)>>(
    self,
    envs: impl IntoIterator<Item = T>
) -> Self

Add entries to the environment.

Environment variable keys and values must be valid UTF-8 with no NUL bytes, or else WasiCtxBuilder::build() will fail with Error::EILSEQ.

pub fn stdin(self, file: File) -> Self

Provide a File to use as stdin

pub fn stdout(self, file: File) -> Self

Provide a File to use as stdout

pub fn stderr(self, file: File) -> Self

Provide a File to use as stderr

pub fn preopened_dir<P: AsRef<Path>>(self, dir: File, guest_path: P) -> Self

Add a preopened directory.

pub fn build(self) -> Result<WasiCtx>

Build a WasiCtx, consuming this WasiCtxBuilder.

If any of the arguments or environment variables in this builder cannot be converted into CStrings, either due to NUL bytes or Unicode conversions, this returns Error::EILSEQ.