Struct Config

pub struct Config {
    pub wasmtime: WasmtimeConfig,
    pub module_config: ModuleConfig,
}

Configuration for wasmtime::Config and generated modules for a session of fuzzing.

This configuration guides what modules are generated, how wasmtime configuration is generated, and is typically itself generated through a call to Arbitrary which allows for a form of “swarm testing”.

Fields

wasmtime: WasmtimeConfig

Configuration related to the wasmtime::Config.

module_config: ModuleConfig

Configuration related to generated modules.

Implementations

impl Config

pub fn set_differential_config(&mut self)

Indicates that this configuration is being used for differential execution.

The purpose of this function is to update the configuration which was generated to be compatible with execution in multiple engines. The goal is to produce the exact same result in all engines so we need to paper over things like nan differences and memory/table behavior differences.

pub fn generate( &self, input: &mut Unstructured<'_>, default_fuel: Option<u32>, ) -> Result<Module>

Uses this configuration and the supplied source of data to generate a wasm module.

If a default_fuel is provided, the resulting module will be configured to ensure termination; as doing so will add an additional global to the module, the pooling allocator, if configured, will also have its globals limit updated.

pub fn make_wast_test_compliant(&mut self, test: &WastTest) -> WastConfig

Updates this configuration to be able to run the test specified.

This primarily updates self.module_config to ensure that it enables all features and proposals necessary to execute the test specified. This will additionally update limits in the pooling allocator to be able to execute all tests.

pub fn to_wasmtime(&self) -> Config

Converts this to a wasmtime::Config object

pub fn to_store(&self) -> Store<StoreLimits>

Convenience function for generating a Store<T> using this configuration.

pub fn configure_store(&self, store: &mut Store<StoreLimits>)

Configures a store based on this configuration.

pub fn generate_timeout(&mut self, u: &mut Unstructured<'_>) -> Result<Timeout>

Generates an arbitrary method of timing out an instance, ensuring that this configuration supports the returned timeout.

pub fn compile(&self, engine: &Engine, wasm: &[u8]) -> Result<Module>

Compiles the wasm within the engine provided.

This notably will use Module::{serialize,deserialize_file} to round-trip if configured in the fuzzer.

pub fn enable_async(&mut self, u: &mut Unstructured<'_>) -> Result<()>

Updates this configuration to forcibly enable async support. Only useful in fuzzers which do async calls.

Trait Implementations

impl<'a> Arbitrary<'a> for Config

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.