diff options
| author | Jana Dönszelmann <jana@donsz.nl> | 2025-08-06 14:41:34 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-08-06 14:41:34 +0200 |
| commit | 4a2ef3c1c84cbd86f6144849e2ddc97dcc88c86a (patch) | |
| tree | 80c7ac43f0855f5832e4fe8c80e4b4dde3669a4a | |
| parent | dfec44905c23076ed6e5c7731f3aabc0e22e65d9 (diff) | |
| parent | c3ee4033229ce7e594263c763ac94bf00709ff3e (diff) | |
| download | rust-4a2ef3c1c84cbd86f6144849e2ddc97dcc88c86a.tar.gz rust-4a2ef3c1c84cbd86f6144849e2ddc97dcc88c86a.zip | |
Merge pull request #2537 from jdonszelmann/wasi
Add instructions to test wasi (wasm32-wasip1) specific tests
| -rw-r--r-- | src/doc/rustc-dev-guide/src/tests/running.md | 23 |
1 files changed, 22 insertions, 1 deletions
diff --git a/src/doc/rustc-dev-guide/src/tests/running.md b/src/doc/rustc-dev-guide/src/tests/running.md index f6e313062cd..317b65f98cd 100644 --- a/src/doc/rustc-dev-guide/src/tests/running.md +++ b/src/doc/rustc-dev-guide/src/tests/running.md @@ -342,7 +342,6 @@ coordinate running tests (see [src/bootstrap/src/core/build_steps/test.rs]). > **TODO** > > - Is there any support for using an iOS emulator? -> - It's also unclear to me how the wasm or asm.js tests are run. [armhf-gnu]: https://github.com/rust-lang/rust/tree/master/src/ci/docker/host-x86_64/armhf-gnu/Dockerfile [QEMU]: https://www.qemu.org/ @@ -350,6 +349,28 @@ coordinate running tests (see [src/bootstrap/src/core/build_steps/test.rs]). [remote-test-server]: https://github.com/rust-lang/rust/tree/master/src/tools/remote-test-server [src/bootstrap/src/core/build_steps/test.rs]: https://github.com/rust-lang/rust/blob/master/src/bootstrap/src/core/build_steps/test.rs +## Testing tests on wasi (wasm32-wasip1) + +Some tests are specific to wasm targets. +To run theste tests, you have to pass `--target wasm32-wasip1` to `x test`. +Additionally, you need the wasi sdk. +Follow the install instructions from the [wasi sdk repository] to get a sysroot on your computer. +On the [wasm32-wasip1 target support page] a minimum version is specified that your sdk must be able to build. +Some cmake commands that take a while and give a lot of very concerning c++ warnings... +Then, in `bootstrap.toml`, point to the sysroot like so: + +``` +[target.wasm32-wasip1] +wasi-root = "<wasi-sdk location>/build/sysroot/install/share/wasi-sysroot" +``` + +In my case I git-cloned it next to my rust folder, so it was `../wasi-sdk/build/....` +Now, tests should just run, you don't have to set up anything else. + +[wasi sdk repository]: https://github.com/WebAssembly/wasi-sdk +[wasm32-wasip1 target support page]: https://github.com/rust-lang/rust/blob/master/src/doc/rustc/src/platform-support/wasm32-wasip1.md#building-the-target. + + ## Running rustc_codegen_gcc tests First thing to know is that it only supports linux x86_64 at the moment. We will |