1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

/// Tunable parameters for WebAssembly compilation.
#[derive(Clone)]
pub struct Tunables {
    /// For static heaps, the size of the heap protected by bounds checking.
    pub static_memory_bound: u32,

    /// The size of the offset guard for static heaps.
    pub static_memory_offset_guard_size: u64,

    /// The size of the offset guard for dynamic heaps.
    pub dynamic_memory_offset_guard_size: u64,
}

impl Default for Tunables {
    fn default() -> Self {
        Self {
            /// Size in wasm pages of the bound for static memories.
            ///
            /// When we allocate 4 GiB of address space, we can avoid the
            /// need for explicit bounds checks.
            static_memory_bound: 0x1_0000,

            /// Size in bytes of the offset guard for static memories.
            ///
            /// Allocating 2 GiB of address space lets us translate wasm
            /// offsets into x86 offsets as aggressively as we can.
            static_memory_offset_guard_size: 0x8000_0000,

            /// Size in bytes of the offset guard for dynamic memories.
            ///
            /// Allocate a small guard to optimize common cases but without
            /// wasting too much memor.
            dynamic_memory_offset_guard_size: 0x1_0000,
        }
    }
}