diff options
| author | bors <bors@rust-lang.org> | 2022-11-15 06:43:28 +0000 |
|---|---|---|
| committer | bors <bors@rust-lang.org> | 2022-11-15 06:43:28 +0000 |
| commit | ca92d90b5917e7176d5ff06607a2cd5352c088d3 (patch) | |
| tree | b34e3c368642c150f3c81bc98d45d57353480bbc /src/doc | |
| parent | 101e1822c3e54e63996c8aaa014d55716f3937eb (diff) | |
| parent | 7c7cb7182f8b2211005d3f82126e5f45e270ad21 (diff) | |
| download | rust-ca92d90b5917e7176d5ff06607a2cd5352c088d3.tar.gz rust-ca92d90b5917e7176d5ff06607a2cd5352c088d3.zip | |
Auto merge of #104428 - matthiaskrgr:rollup-jo3078i, r=matthiaskrgr
Rollup of 13 pull requests
Successful merges:
- #103842 (Adding Fuchsia compiler testing script, docs)
- #104354 (Remove leading newlines from `NonZero*` doc examples)
- #104372 (Update compiler-builtins)
- #104380 (rustdoc: remove unused CSS `code { opacity: 1 }`)
- #104381 (Remove dead NoneError diagnostic handling)
- #104383 (Remove unused symbols and diagnostic items)
- #104391 (Deriving cleanups)
- #104403 (Specify language of code comment to generate document)
- #104404 (Fix missing minification for static files)
- #104413 ([llvm-wrapper] adapt for LLVM API change)
- #104415 (rustdoc: fix corner case in search keyboard commands)
- #104422 (Fix suggest associated call syntax)
- #104426 (Add test for #102154)
Failed merges:
r? `@ghost`
`@rustbot` modify labels: rollup
Diffstat (limited to 'src/doc')
| -rw-r--r-- | src/doc/rustc/src/platform-support/fuchsia.md | 56 |
1 files changed, 54 insertions, 2 deletions
diff --git a/src/doc/rustc/src/platform-support/fuchsia.md b/src/doc/rustc/src/platform-support/fuchsia.md index 1ff6003c121..62cad19d0ec 100644 --- a/src/doc/rustc/src/platform-support/fuchsia.md +++ b/src/doc/rustc/src/platform-support/fuchsia.md @@ -641,8 +641,60 @@ available on the [Fuchsia devsite]. ### Running the compiler test suite -Running the Rust test suite on Fuchsia is [not currently supported], but work is -underway to enable it. +Pre-requisites for running the Rust test suite on Fuchsia are: +1. Checkout of Rust source. +1. Setup of `config-env.sh` and `config.toml` from "[Targeting Fuchsia with a compiler built from source](#targeting-fuchsia-with-a-compiler-built-from-source)". +1. Download of the Fuchsia SDK. Minimum supported SDK version is [9.20220726.1.1](https://chrome-infra-packages.appspot.com/p/fuchsia/sdk/core/linux-amd64/+/version:9.20220726.1.1) + +Interfacing with the Fuchsia emulator is handled by our test runner script located +at `${RUST_SRC_PATH}/src/ci/docker/scripts/fuchsia-test-runner.py`. + +We start by activating our Fuchsia test environment. From a terminal: + +**Issue command from ${RUST_SRC_PATH}** +```sh +src/ci/docker/scripts/fuchsia-test-runner.py start + --rust . + --sdk ${SDK_PATH} + --target-arch {x64,arm64} +``` + +Next, for ease of commands, we copy `config-env.sh` and `config.toml` into our Rust source +code path, `${RUST_SRC_PATH}`. + +From there, we utilize `x.py` to run our tests, using the test runner script to +run the tests on our emulator. To run the full `src/test/ui` test suite: + +**Run from ${RUST_SRC_PATH}** +```sh +( \ + source config-env.sh && \ + ./x.py \ + --config config.toml \ + --stage=2 \ + test src/test/ui \ + --target x86_64-fuchsia \ + --run=always --jobs 1 \ + --test-args --target-rustcflags -L \ + --test-args --target-rustcflags ${SDK_PATH}/arch/{x64|arm64}/sysroot/lib \ + --test-args --target-rustcflags -L \ + --test-args --target-rustcflags ${SDK_PATH}/arch/{x64|arm64}/lib \ + --test-args --target-rustcflags -Cpanic=abort \ + --test-args --target-rustcflags -Zpanic_abort_tests \ + --test-args --remote-test-client \ + --test-args src/ci/docker/scripts/fuchsia-test-runner.py \ +) +``` + +*Note: The test suite cannot be run in parallel at the moment, so `x.py` +must be run with `--jobs 1` to ensure only one test runs at a time.* + +When finished, stop the test environment: + +**Issue command from ${RUST_SRC_PATH}** +```sh +src/ci/docker/scripts/fuchsia-test-runner.py stop +``` ## Debugging |
