Struct SandboxConfiguration

#[repr(C)]
pub struct SandboxConfiguration { /* private fields */ }

The complete set of configuration needed to create a Sandbox

Implementations

impl SandboxConfiguration

pub const DEFAULT_INPUT_SIZE: usize = 16_384usize

The default size of input data

pub const MIN_INPUT_SIZE: usize = 8_192usize

The minimum size of input data

pub const DEFAULT_OUTPUT_SIZE: usize = 16_384usize

The default size of output data

pub const MIN_OUTPUT_SIZE: usize = 8_192usize

The minimum size of output data

pub const DEFAULT_HOST_FUNCTION_DEFINITION_SIZE: usize = 4_096usize

The default size of host function definitionsSET Host function definitions has its own page in memory, in order to be READ-ONLY from a guest’s perspective.

pub const MIN_HOST_FUNCTION_DEFINITION_SIZE: usize = 4_096usize

The minimum size of host function definitions

pub const DEFAULT_INTERRUPT_RETRY_DELAY: Duration

The default interrupt retry delay

pub const INTERRUPT_VCPU_SIGRTMIN_OFFSET: u8 = 0u8

The default signal offset from SIGRTMIN used to determine the signal number for interrupting

pub fn set_host_function_definition_size( &mut self, host_function_definition_size: usize, )

Set the size of the memory buffer that is made available for serialising host function definitions the minimum value is MIN_HOST_FUNCTION_DEFINITION_SIZE

pub fn set_input_data_size(&mut self, input_data_size: usize)

Set the size of the memory buffer that is made available for input to the guest the minimum value is MIN_INPUT_SIZE

pub fn set_output_data_size(&mut self, output_data_size: usize)

Set the size of the memory buffer that is made available for output from the guest the minimum value is MIN_OUTPUT_SIZE

pub fn set_stack_size(&mut self, stack_size: u64)

Set the stack size to use in the guest sandbox. If set to 0, the stack size will be determined from the PE file header

pub fn set_heap_size(&mut self, heap_size: u64)

Set the heap size to use in the guest sandbox. If set to 0, the heap size will be determined from the PE file header

pub fn set_interrupt_retry_delay(&mut self, delay: Duration)

Sets the interrupt retry delay

pub fn get_interrupt_retry_delay(&self) -> Duration

Get the delay between retries for interrupts

pub fn get_interrupt_vcpu_sigrtmin_offset(&self) -> u8

Get the signal offset from SIGRTMIN used to determine the signal number for interrupting the VCPU thread

pub fn set_interrupt_vcpu_sigrtmin_offset(&mut self, offset: u8) -> Result<()>

Sets the offset from SIGRTMIN to determine the real-time signal used for interrupting the VCPU thread.

The final signal number is computed as SIGRTMIN + offset, and it must fall within the valid range of real-time signals supported by the host system.

Returns Ok(()) if the offset is valid, or an error if it exceeds the maximum real-time signal number.

Trait Implementations

impl Clone for SandboxConfiguration

fn clone(&self) -> SandboxConfiguration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SandboxConfiguration

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

Formats the value using the given formatter.

impl Default for SandboxConfiguration

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SandboxConfiguration

fn eq(&self, other: &SandboxConfiguration) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SandboxConfiguration

impl Eq for SandboxConfiguration

impl StructuralPartialEq for SandboxConfiguration