From 8c8939860ea2009e1469c9b1ff4e99caa9a43558 Mon Sep 17 00:00:00 2001 From: Junichi Uekawa Date: Tue, 20 Feb 2024 14:59:09 +0900 Subject: [PATCH] book: qemu-user not qemu-static. static is just describing how the binaries are linked; the emulator being used is the qemu-user, which emulates guest userspace syscall API and uses the host kernel. BUG=None TEST=read it Change-Id: I8b827498727de4ce85604dc3b9efebd89df56e62 Reviewed-on: https://chromium-review.googlesource.com/c/crosvm/crosvm/+/5308639 Commit-Queue: Junichi Uekawa Reviewed-by: Ryuichiro Chiba Reviewed-by: Dennis Kempin --- docs/book/src/testing/index.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/docs/book/src/testing/index.md b/docs/book/src/testing/index.md index e4355a1967..0441e06b9a 100644 --- a/docs/book/src/testing/index.md +++ b/docs/book/src/testing/index.md @@ -19,7 +19,8 @@ unit tests: - Avoid accessing kernel devices - Avoid global state in unit tests -This allows us to execute unit tests for any platform using emulators such as qemu-static or wine64. +This allows us to execute unit tests for any platform using emulators such as qemu-user-static or +wine64. ### Documentation tests @@ -79,17 +80,17 @@ processes. The platforms below can all be tested using `tools/run_tests -p $platform`. The table indicates how these tests are executed: -| Platform | Build | Unit Tests | Integration Tests | E2E Tests | -| :-------------------------- | :---: | :---------------------------: | :---------------: | :-------: | -| x86_64 (linux) | ✅ | ✅ | ✅ | ✅ | -| aarch64 (linux) | ✅ | ✅ (qemu-static[^qemu-static]) | ✅ (qemu[^qemu]) | ❌ | -| armhf (linux) | ✅ | ✅ (qemu-static[^qemu-static]) | ❌ | ❌ | -| mingw64[^windows] (linux) | 🚧 | 🚧 (wine64) | ❌ | ❌ | -| mingw64[^windows] (windows) | 🚧 | 🚧 | 🚧 | ❌ | +| Platform | Build | Unit Tests | Integration Tests | E2E Tests | +| :-------------------------- | :---: | :-----------------------: | :---------------: | :-------: | +| x86_64 (linux) | ✅ | ✅ | ✅ | ✅ | +| aarch64 (linux) | ✅ | ✅ (qemu-user[^qemu-user]) | ✅ (qemu[^qemu]) | ❌ | +| armhf (linux) | ✅ | ✅ (qemu-user[^qemu-user]) | ❌ | ❌ | +| mingw64[^windows] (linux) | 🚧 | 🚧 (wine64) | ❌ | ❌ | +| mingw64[^windows] (windows) | 🚧 | 🚧 | 🚧 | ❌ | Crosvm CI will use the same configuration as `tools/run_tests`. -[^qemu-static]: qemu-static-aarch64 or qemu-static-arm translate instructions into x86 and executes them on the +[^qemu-user]: qemu-aarch64-static or qemu-arm-static translate instructions into x86 and executes them on the host kernel. This works well for unit tests, but will fail when interacting with platform specific kernel features.