Struct lunatic::ProcessConfig

pub struct ProcessConfig(_);

Process configurations determine permissions of processes.

The functions spawn_config & spawn_link_config can be used to create processes with a specific configuration.

Implementations

impl ProcessConfig

pub fn new() -> Result<Self, LunaticError>

Create a new process configuration with all permissions denied.

There is no memory or fuel limit set on the newly created configuration, they are not inherited from parent.

pub fn id(&self) -> i64

Returns the id of the configuration resource or -1 in case it’s an inherited configuration.

pub fn set_max_memory(&mut self, max_memory: u64)

Sets the maximum amount of memory in bytes that can be used by a process.

If a process tries to allocate more memory with memory.grow, the instruction is going to return -1.

pub fn get_max_memory(&self) -> u64

Returns the maximum amount of memory in bytes.

pub fn set_max_fuel(&mut self, max_fuel: u64)

Sets the maximum amount of fuel available to the process.

One unit of fuel is approximately 100k wasm instructions. If a process runs out of fuel it will trap.

pub fn get_max_fuel(&self) -> u64

Returns the maximum amount of fuel.

pub fn set_can_compile_modules(&mut self, can: bool)

Sets the ability of a process to compile WebAssembly modules.

pub fn can_compile_modules(&self) -> bool

Returns true if processes can compile WebAssembly modules.

pub fn set_can_create_configs(&mut self, can: bool)

Sets the ability of a process to create their own sub-configuration.

This setting can be dangerous. If a process is missing a permission, but has the possibility to create new configurations, it can spawn sub-processes using a new config that has the permission enabled.

pub fn can_create_configs(&self) -> bool

Returns true if processes can create their own configurations.

pub fn set_can_spawn_processes(&mut self, can: bool)

Sets the ability of a process to spawn sub-processes.

pub fn can_spawn_processes(&self) -> bool

Returns true if processes can spawn sub-processes.

pub fn add_environment_variable(&mut self, key: &str, value: &str)

Adds environment variable.

pub fn add_command_line_argument(&mut self, argument: &str)

Adds command line argument.

pub fn preopen_dir(&self, dir: &str)

Mark a directory as pre-opened.

Trait Implementations

impl Debug for ProcessConfig

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

Formats the value using the given formatter.