crosvm-testing
Skill to assist with running tests and managing test VMs in the crosvm repository.
- License 许可
- BSD-3-Clause
- 所属仓库
- google/crosvm
- 最近更新
- 2026-11-14
- Stars
- ★ 1.4k
- Forks
- 191
01 前言 Front Matter
- name
- crosvm-testing
- description
- Skill to assist with running tests and managing test VMs in the crosvm repository.
03 SKILL.md 正文
Crosvm Testing (tools/run_tests & tools/testvm)
This skill covers running the crosvm test suite and managing the virtual machines used for
integration testing.
[!TIP] When you have completed your code changes and are ready to commit or upload, please run the overall presubmit checks according to the crosvm-contribution-workflow SKILL.md.
Running Tests (tools/run_tests)
The tools/run_tests script is the primary test runner. It supports unit tests (running on the host
or via emulators) and integration tests (running on a test VM or the host).
1. Unit Tests
- Run host native unit tests:
./tools/run_tests - Run unit tests for a specific platform (via emulator):
Supported platforms:./tools/run_tests -p <platform>x86_64,aarch64,armhw,mingw64,riscv64. Example for ARM64:./tools/run_tests -p aarch64Example for Windows (via Wine):./tools/run_tests -p mingw64
2. Integration Tests
Integration tests require a Device Under Test (DUT).
- Run integration tests on a Test VM (Recommended):
This will automatically start a test VM, run the tests inside it, and keep the VM running for subsequent runs../tools/run_tests --dut=vm - Run integration tests on the Host:
Note: This may not work on all host configurations and might require root../tools/run_tests --dut=host
3. Test Filtering
The runner supports nextest filter expressions using the -E or --filter-expr flag. See
nextest documentation for details.
- Run tests for a specific package:
./tools/run_tests -E 'package(devices)' - Run a specific test by name:
./tools/run_tests -E 'test(test_send_cmd_not_ready)' - Run tests for a package and its dependencies:
./tools/run_tests -E 'deps(vm_control)'
4. Useful Flags
--no-unit-tests: Skip unit tests and only run integration tests.--no-integration-tests: Skip integration tests.--run-root-tests: Enable integration tests that require root privileges.--retries <N>: Retry failed tests N times.--repetitions <N>: Repeat all tests N times (useful for detecting flakiness).
Managing Test VMs (tools/testvm, tools/x86vm, tools/aarch64vm)
For integration testing (--dut=vm), crosvm uses test VMs. You can manage these VMs using
tools/x86vm (for x86_64) or tools/aarch64vm (for ARM64). These are wrappers around
tools/testvm.
Replace x86vm with aarch64vm in the commands below depending on the architecture you are
testing.
- Start the VM:
./tools/x86vm up - Open an interactive SSH shell into the VM:
(This will start the VM if it is not already running)../tools/x86vm shell - Stop the VM gracefully:
./tools/x86vm stop - Force kill the VM:
./tools/x86vm kill - View VM console logs:
./tools/x86vm logs - Clean/Reset the VM (deletes images):
./tools/x86vm clean
04 同仓库更多 Skills
crosvm-dev-container
Skill to assist with using the `dev_container` tool for running builds, tests, and other tools in a consistent containerized environment.
crosvm-contribution-workflow
Skill to assist with the contribution workflow for crosvm. ALL agents making code changes MUST use this skill to run presubmit checks before committing.
crosvm-cl-tool
Skill to assist with using the `./tools/cl` tool for managing and uploading Gerrit CLs in the crosvm repository.