yadava5 opened PR #15049 from yadava5:docs-fuel-cow-determinism to bytecodealliance:main:
Closes #14331.
As discussed in the issue, this documents that copy-on-write memory init changes how much fuel instantiation consumes from host to host, and that disabling
memory_init_cowmakes it the same everywhere. The note goes onConfig::consume_fuel, with a pointer fromConfig::memory_init_cow, the "Deterministic Fuel" section, and the deterministic execution guide.I measured it with the module from the issue (one memory, a data segment of 5 bytes) on GitHub's runners:
host page size CoW, Module::newCoW, deserialize_fileno CoW Linux x86_64 4 KiB 0 0 7 Linux aarch64 4 KiB 0 0 7 macOS x86_64 4 KiB 4097 0 7 macOS aarch64 16 KiB 16385 0 7 Windows x86_64 4 KiB 4097 4097 7 The probe is here.
One thing I noticed while measuring: when CoW is enabled but can't be used, the copy is charged for the whole image rounded up to a page, so 5 bytes cost a full page of fuel. I kept that out of this PR since it's a behavior change, but happy to look at it separately if it's worth changing.
I used Claude Code to measure the fuel numbers and check the doc links.
yadava5 requested fitzgen for a review on PR #15049.
yadava5 removed the review request for wasmtime-core-reviewers from PR #15049.
yadava5 requested wasmtime-core-reviewers for a review on PR #15049.
yadava5 requested wasmtime-default-reviewers for a review on PR #15049.
github-actions[bot] added the label wasmtime:api on PR #15049.
github-actions[bot] added the label wasmtime:config on PR #15049.
github-actions[bot] added the label wasmtime:docs on PR #15049.
github-actions[bot] commented on PR #15049:
Label Messager: wasmtime:config
It looks like you are changing Wasmtime's configuration options. Make sure to
complete this check list:
[ ] If you added a new
Configmethod, you wrote extensive documentation for
it.<details>
Our documentation should be of the following form:
```text
Short, simple summary sentence.More details. These details can be multiple paragraphs. There should be
information about not just the method, but its parameters and results as
well.Is this method fallible? If so, when can it return an error?
Can this method panic? If so, when does it panic?
Example
Optional example here.
```</details>
[ ] If you added a new
Configmethod, or modified an existing one, you
ensured that this configuration is exercised by the fuzz targets.<details>
For example, if you expose a new strategy for allocating the next instance
slot inside the pooling allocator, you should ensure that at least one of our
fuzz targets exercises that new strategy.Often, all that is required of you is to ensure that there is a knob for this
configuration option in [wasmtime_fuzzing::Config][fuzzing-config] (or one
of its nestedstructs).Rarely, this may require authoring a new fuzz target to specifically test this
configuration. See [our docs on fuzzing][fuzzing-docs] for more details.</details>
[ ] If you are enabling a configuration option by default, make sure that it
has been fuzzed for at least two weeks before turning it on by default.[fuzzing-config]: https://github.com/bytecodealliance/wasmtime/blob/ca0e8d0a1d8cefc0496dba2f77a670571d8fdcab/crates/fuzzing/src/generators.rs#L182-L194
[fuzzing-docs]: https://docs.wasmtime.dev/contributing-fuzzing.html
<details>
To modify this label's message, edit the <code>.github/label-messager/wasmtime-config.md</code> file.
To add new label messages or remove existing label messages, edit the
<code>.github/label-messager.json</code> configuration file.</details>
Last updated: Oct 31 2026 at 23:03 UTC