1 //! Generate a Wasm module and the configuration for generating it.
2 
3 use arbitrary::{Arbitrary, Unstructured};
4 use std::sync::atomic::{AtomicUsize, Ordering::Relaxed};
5 
6 /// Default module-level configuration for fuzzing Wasmtime.
7 ///
8 /// Internally this uses `wasm-smith`'s own `Config` but we further refine
9 /// the defaults here as well.
10 #[derive(Debug, Clone)]
11 #[expect(missing_docs, reason = "self-describing fields")]
12 pub struct ModuleConfig {
13     pub config: wasm_smith::Config,
14 
15     // These knobs aren't exposed in `wasm-smith` at this time but are exposed
16     // in our `*.wast` testing so keep knobs here so they can be read during
17     // config-to-`wasmtime::Config` translation.
18     pub function_references_enabled: bool,
19     pub component_model_async: bool,
20     pub component_model_async_builtins: bool,
21     pub component_model_async_stackful: bool,
22     pub component_model_threading: bool,
23     pub component_model_error_context: bool,
24     pub component_model_gc: bool,
25     pub legacy_exceptions: bool,
26 }
27 
28 impl<'a> Arbitrary<'a> for ModuleConfig {
29     fn arbitrary(u: &mut Unstructured<'a>) -> arbitrary::Result<ModuleConfig> {
30         let mut config = wasm_smith::Config::arbitrary(u)?;
31 
32         // This list is intended to be the definitive source of truth for
33         // what's at least possible to fuzz within Wasmtime. This is a
34         // combination of features in `wasm-smith` where some proposals are
35         // on-by-default (as determined by fuzz input) and others are
36         // off-by-default (as they aren't stage4+). Wasmtime will default-fuzz
37         // proposals that a pre-stage-4 to test our own implementation. Wasmtime
38         // might also unconditionally disable proposals that it doesn't
39         // implement yet which are stage4+. This is intended to be an exhaustive
40         // list of all the wasm proposals that `wasm-smith` supports and the
41         // fuzzing status within Wasmtime too.
42         let _ = config.multi_value_enabled;
43         let _ = config.saturating_float_to_int_enabled;
44         let _ = config.sign_extension_ops_enabled;
45         let _ = config.bulk_memory_enabled;
46         let _ = config.reference_types_enabled;
47         let _ = config.simd_enabled;
48         let _ = config.relaxed_simd_enabled;
49         let _ = config.tail_call_enabled;
50         let _ = config.extended_const_enabled;
51         let _ = config.gc_enabled;
52         let _ = config.exceptions_enabled;
53         config.custom_page_sizes_enabled = u.arbitrary()?;
54         config.wide_arithmetic_enabled = u.arbitrary()?;
55         config.memory64_enabled = u.ratio(1, 20)?;
56         config.threads_enabled = u.ratio(1, 20)?;
57         // Allow multi-memory but make it unlikely
58         if u.ratio(1, 20)? {
59             config.max_memories = config.max_memories.max(2);
60         } else {
61             config.max_memories = 1;
62         }
63         // ... NB: if you add something above this line please be sure to update
64         // `docs/stability-wasm-proposals.md`
65 
66         // We get better differential execution when we disallow traps, so we'll
67         // do that most of the time.
68         config.disallow_traps = u.ratio(9, 10)?;
69 
70         Ok(ModuleConfig {
71             component_model_async: false,
72             component_model_async_builtins: false,
73             component_model_async_stackful: false,
74             component_model_threading: false,
75             component_model_error_context: false,
76             component_model_gc: false,
77             legacy_exceptions: false,
78             function_references_enabled: config.gc_enabled,
79             config,
80         })
81     }
82 }
83 
84 impl ModuleConfig {
85     /// Uses this configuration and the supplied source of data to generate a
86     /// Wasm module.
87     ///
88     /// If a `default_fuel` is provided, the resulting module will be configured
89     /// to ensure termination; as doing so will add an additional global to the
90     /// module, the pooling allocator, if configured, must also have its globals
91     /// limit updated.
92     pub fn generate(
93         &self,
94         input: &mut Unstructured<'_>,
95         default_fuel: Option<u32>,
96     ) -> arbitrary::Result<wasm_smith::Module> {
97         crate::init_fuzzing();
98 
99         // If requested, save `*.{dna,json}` files for recreating this module
100         // in wasm-tools alone.
101         let input_before = if log::log_enabled!(log::Level::Debug) {
102             let len = input.len();
103             Some(input.peek_bytes(len).unwrap().to_vec())
104         } else {
105             None
106         };
107 
108         let mut module = wasm_smith::Module::new(self.config.clone(), input)?;
109 
110         if let Some(before) = input_before {
111             static GEN_CNT: AtomicUsize = AtomicUsize::new(0);
112             let used = before.len() - input.len();
113             let i = GEN_CNT.fetch_add(1, Relaxed);
114             let dna = format!("testcase{i}.dna");
115             let config = format!("testcase{i}.json");
116             log::debug!("writing `{dna}` and `{config}`");
117             std::fs::write(&dna, &before[..used]).unwrap();
118             std::fs::write(&config, serde_json::to_string_pretty(&self.config).unwrap()).unwrap();
119         }
120 
121         if let Some(default_fuel) = default_fuel {
122             module.ensure_termination(default_fuel).unwrap();
123         }
124 
125         Ok(module)
126     }
127 }
128