5c1557d2 - Add docs and example for debugging with core dumps (#7087)

Tue, 26 Sep 2023 17:55:45 +0000

Add docs and example for debugging with core dumps (#7087)* Add docs for debugging with core dumps* Fix reference to old style CLI flag* Add `no_run` to example that is only there to trap List of files: /wasmtime-44.0.1/docs/examples-debugging.md

8995750a - Redesign Wasmtime's CLI (#6925)

Mon, 11 Sep 2023 22:05:35 +0000

Redesign Wasmtime's CLI (#6925)* Redesign Wasmtime's CLIThis commit follows through on discussion from #6741 to redesign theflags that the `wasmtime` binary accepts on the CLI. Almost all flagshave been renamed/moved and will require callers to update. The mainmotivation here is to cut down on the forest of options in `wasmtime -h`which are difficult to mentally group together and understand.The main change implemented here is to move options behind "optiongroups" which are intended to be abbreviated with a single letter:* `-O foo` - an optimization or performance-tuning related option* `-C foo` - a codegen option affecting the compilation process.* `-D foo` - a debug-related option* `-W foo` - a wasm-related option, for example changing wasm semantics* `-S foo` - a WASI-related option, configuring various proposals for exampleEach option group can be explored by passing `help`, for example `-Ohelp`. This will print all options within the group along with theirhelp message. Additionally `-O help-long` can be passed to print thefull comment for each option if desired.Option groups can be specified multiple times on the command line, forexample `-Wrelaxed-simd -Wthreads`. They can also be combined togetherwith commas as `-Wrelaxed-simd,threads`. Configuration works as a "lastoption wins" so `-Ccache,cache=n` would end up with a compilationcache disabled.Boolean options can be specified as `-C foo` to enable `foo`, or theycan be specified with `-Cfoo=$val` with any of `y`, `n`, `yes`, `no`,`true`, or `false`. All other options require a `=foo` value to bepassed and the parsing depends on the type.This commit additionally applies a few small refactorings to the CLI aswell. For example the help text no longer prints information about wasmfeatures after printing the option help. This is still available via`-Whelp` as all wasm features have moved from `--wasm-features` to `-W`.Additionally flags are no longer conditionally compiled in, but insteadall flags are always supported. A runtime error is returned if supportfor a flag is not compiled in. Additionally the "experimental" name ofWASI proposals has been dropped in favor of just the name of theproposal, for example `--wasi nn` instead of `--wasi-modulesexperimental-wasi-nn`. This is intended to mirror how wasm proposalsdon't have "experimental" in the name and an opt-in is requiredregardless.A full listing of flags and how they have changed is:| old cli flag | new cli flag ||-----------------------------------------------|-------------------------------------------------|| `-O, --optimize` | removed || `--opt-level ` | `-O opt-level=N` || `--dynamic-memory-guard-size ` | `-O dynamic-memory-guard-size=...` || `--static-memory-forced` | `-O static-memory-forced` || `--static-memory-guard-size ` | `-O static-memory-guard-size=N` || `--static-memory-maximum-size ` | `-O static-memory-maximum-size=N` || `--dynamic-memory-reserved-for-growth ` | `-O dynamic-memory-reserved-for-growth=...` || `--pooling-allocator` | `-O pooling-allocator` || `--disable-memory-init-cow` | `-O memory-init-cow=no` || `--compiler ` | `-C compiler=..` || `--enable-cranelift-debug-verifier` | `-C cranelift-debug-verifier` || `--cranelift-enable ` | `-C cranelift-NAME` || `--cranelift-set ` | `-C cranelift-NAME=VALUE` || `--config ` | `-C cache-config=..` || `--disable-cache` | `-C cache=no` || `--disable-parallel-compilation` | `-C parallel-compilation=no` || `-g` | `-D debug-info` || `--disable-address-map` | `-D address-map=no` || `--disable-logging` | `-D logging=no` || `--log-to-files` | `-D log-to-files` || `--coredump-on-trap ` | `-D coredump=..` || `--wasm-features all` | `-W all-proposals` || `--wasm-features -all` | `-W all-proposals=n` || `--wasm-features bulk-memory` | `-W bulk-memory` || `--wasm-features multi-memory` | `-W multi-memory` || `--wasm-features multi-value` | `-W multi-value` || `--wasm-features reference-types` | `-W reference-types` || `--wasm-features simd` | `-W simd` || `--wasm-features tail-call` | `-W tail-call` || `--wasm-features threads` | `-W threads` || `--wasm-features memory64` | `-W memory64` || `--wasm-features copmonent-model` | `-W component-model` || `--wasm-features function-references` | `-W function-references` || `--relaxed-simd-deterministic` | `-W relaxed-simd-deterministic` || `--enable-cranelift-nan-canonicalization` | `-W nan-canonicalization` || `--fuel ` | `-W fuel=N` || `--epoch-interruption` | `-W epoch-interruption` || `--allow-unknown-exports` | `-W unknown-exports-allow` || `--trap-unknown-imports` | `-W unknown-imports-trap` || `--default-values-unknown-imports` | `-W unknown-imports-default` || `--max-instances ` | `-W max-instances=N` || `--max-memories ` | `-W max-memories=N` || `--max-memory-size ` | `-W max-memory-size=N` || `--max-table-elements ` | `-W max-table-elements=N` || `--max-tables ` | `-W max-tables=N` || `--max-wasm-stack ` | `-W max-wasm-stack=N` || `--trap-on-grow-failure` | `-W trap-on-grow-failure` || `--wasm-timeout ` | `-W timeout=N` || `--wmemcheck` | `-W wmemcheck` || `--wasi-modules default` | removed || `--wasi-modules -default` | removed || `--wasi-modules wasi-common` | `-S common` || `--wasi-modules -wasi-common` | `-S common=n` || `--wasi-modules experimental-wasi-nn` | `-S nn` || `--wasi-modules experimental-wasi-threads` | `-S threads` || `--wasi-modules experimental-wasi-http` | `-S http` || `--listenfd` | `-S listenfd` || `--tcplisten ` | `-S tcplisten=...` || `--wasi-nn-graph ` | `-S nn-graph=FORMAT::HOST` || `--preview2` | `-S preview2` || `--dir ` | `--dir ...` || `--mapdir ` | `--dir a::b` |* Be more descriptive with help text* Document `=val` is optional for `-Ccranelift-xxx`* Fix compile after rebase* Fix rebase of `--inherit-network`* Fix wasi-http test* Fix compile without pooling allocator support* Update some flags in docs* Fix bench-api build* Update flags for gdb/lldb tests* Fixup optimization flagsprtest:full List of files: /wasmtime-44.0.1/docs/examples-debugging.md

9377dfd7 - Add a note about `_NO_DEBUG_HEAP` to the debugging document (#6963)

Tue, 05 Sep 2023 14:02:12 +0000

Add a note about `_NO_DEBUG_HEAP` to the debugging document (#6963)While this is not at all WASM-specific, it is somewhat rare thatLLDB is used for native debugging on Windows, so the cause ofthe slowdown on the order of 50x may not be immediately obvious. List of files: /wasmtime-44.0.1/docs/examples-debugging.md

28eef73a - [Doc] Note where to find start of memory when debugging (#4420)

Fri, 08 Jul 2022 20:23:00 +0000

[Doc] Note where to find start of memory when debugging (#4420) List of files: /wasmtime-44.0.1/docs/examples-debugging.md

a83497e0 - [doc] Add LLDB tips and tricks

Fri, 09 Jul 2021 20:18:16 +0000

[doc] Add LLDB tips and tricks List of files: /wasmtime-44.0.1/docs/examples-debugging.md

e5d25bc2 - [doc] Add some documentation for debugging

Fri, 09 Jul 2021 01:09:29 +0000