Struct UninitializedSandbox

pub struct UninitializedSandbox { /* private fields */ }

A preliminary Sandbox, not yet ready to execute guest code.

Prior to initializing a full-fledged Sandbox, you must create one of these UninitializedSandboxes with the new function, register all the host-implemented functions you need to be available to the guest, then call evolve to transform your UninitializedSandbox into an initialized Sandbox.

Implementations

impl UninitializedSandbox

pub fn new( guest_binary: GuestBinary, cfg: Option<SandboxConfiguration>, sandbox_run_options: Option<SandboxRunOptions>, host_print_writer: Option<&dyn HostFunction1<'_, String, i32>>, ) -> Result<Self>

Create a new sandbox configured to run the binary at path bin_path.

The instrument attribute is used to generate tracing spans and also to emit an error should the Result be an error. The skip attribute is used to skip the guest binary from being printed in the tracing span. The name attribute is used to name the tracing span. The err attribute is used to emit an error should the Result be an error, it uses the std::fmt::Debug trait to print the error.

Trait Implementations

impl Debug for UninitializedSandbox

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

Formats the value using the given formatter.

impl EvolvableSandbox<UninitializedSandbox, MultiUseSandbox, Noop<UninitializedSandbox, MultiUseSandbox>> for UninitializedSandbox

fn evolve( self, _: Noop<UninitializedSandbox, MultiUseSandbox>, ) -> Result<MultiUseSandbox>

Evolve self to a MultiUseSandbox without any additional metadata.

impl Sandbox for UninitializedSandbox

fn check_stack_guard(&self) -> Result<bool>

Check to ensure the current stack cookie matches the one that was selected when the stack was constructed.

impl UninitializedSandbox for UninitializedSandbox

fn get_uninitialized_sandbox(&self) -> &UninitializedSandbox

fn get_uninitialized_sandbox_mut(&mut self) -> &mut UninitializedSandbox

fn is_running_in_process(&self) -> bool