Struct UninitializedSandbox 

pub struct UninitializedSandbox { /* private fields */ }

A preliminary sandbox that represents allocated memory and registered host functions, but has not yet created the underlying virtual machine.

This struct holds the configuration and setup needed for a sandbox without actually creating the VM. It allows you to:

• Set up memory layout and load guest binary data
• Register host functions that will be available to the guest
• Configure sandbox settings before VM creation

The virtual machine is not created until you call evolve to transform this into an initialized MultiUseSandbox.

Implementations

impl UninitializedSandbox

pub fn new<'a, 'b>( env: impl Into<GuestEnvironment<'a, 'b>>, cfg: Option<SandboxConfiguration>, ) -> Result<Self>

Creates a new uninitialized sandbox for the given guest environment.

The guest binary can be provided as either a file path or memory buffer. An optional configuration can customize memory sizes and sandbox settings. After creation, register host functions using register before calling evolve to complete initialization and create the VM.

pub fn evolve(self) -> Result<MultiUseSandbox>

Creates and initializes the virtual machine, transforming this into a ready-to-use sandbox.

This method consumes the UninitializedSandbox and performs the final initialization steps to create the underlying virtual machine. Once evolved, the resulting MultiUseSandbox can execute guest code and handle function calls.

pub fn shared_mem_size(&self) -> usize

Returns the total size of the sandbox shared memory region in bytes.

This is useful for placing file mappings at guest physical addresses that don’t overlap the primary shared memory slot.

pub fn set_max_guest_log_level(&mut self, log_level: LevelFilter)

Sets the maximum log level for guest code execution.

If not set, the log level is determined by the RUST_LOG environment variable, defaulting to LevelFilter::Error if unset.

pub fn register(&mut self, fn_id: u32, host_func: HostFn) -> Result<()>

Registers a host function under fn_id that the guest can call via the OutBAction::CallFunction outb port. The closure receives the raw Request.payload bytes from the guest and returns the raw response payload bytes.

Trait Implementations

impl Debug for UninitializedSandbox

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

Formats the value using the given formatter.

impl Registerable for UninitializedSandbox

fn register_host_function(&mut self, fn_id: u32, func: HostFn) -> Result<()>

Register func to be invoked by the guest under the given fn_id. Overwrites any prior entry for that id.