Struct Limits

#[repr(C)]
pub struct Limits {
    pub heap_memory_size: usize,
    pub heap_address_space_size: usize,
    pub stack_size: usize,
    pub globals_size: usize,
    pub signal_stack_size: usize,
}

Runtime limits for the various memories that back a Lucet instance.

Each value is specified in bytes, and must be evenly divisible by the host page size (4K).

Fields

heap_memory_size: usize

Max size of the heap, which can be backed by real memory. (default 1M)

heap_address_space_size: usize

Size of total virtual memory. (default 8G)

stack_size: usize

Size of the guest stack. (default 128K)

globals_size: usize

Size of the globals region in bytes; each global uses 8 bytes. (default 4K)

signal_stack_size: usize

Size of the signal stack in bytes. (default SIGSTKSZ for release builds, at least 12K for debug builds; minimum MINSIGSTKSZ)

This difference is to account for the greatly increased stack size usage in the signal handler when running without optimizations.

Note that debug vs. release mode is determined by cfg(debug_assertions), so if you are specifically enabling debug assertions in your release builds, the default signal stack may be larger.

Implementations

impl Limits

pub const fn default() -> Limits

impl Limits

pub fn total_memory_size(&self) -> usize

pub fn validate(&self) -> Result<(), Error>

Validate that the limits are aligned to page sizes, and that the stack is not empty.

Trait Implementations

impl Clone for Limits

fn clone(&self) -> Limits

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Limits

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

Formats the value using the given formatter.

impl From<&Limits> for lucet_alloc_limits

fn from(limits: &Limits) -> lucet_alloc_limits

Converts to this type from the input type.

impl From<&lucet_alloc_limits> for Limits

fn from(limits: &lucet_alloc_limits) -> Limits

Converts to this type from the input type.

impl From<Limits> for lucet_alloc_limits

fn from(limits: Limits) -> lucet_alloc_limits

Converts to this type from the input type.

impl From<lucet_alloc_limits> for Limits

fn from(limits: lucet_alloc_limits) -> Limits

Converts to this type from the input type.