v86/tests
2021-01-03 22:58:19 -06:00
..
api api tests: Use linux4 image 2021-01-03 22:43:03 -06:00
benchmark benchmark script improvements 2020-12-31 19:14:33 -06:00
devices Remove dead & improve 2020-12-31 19:14:29 -06:00
expect Update expect tests 2020-12-31 19:14:33 -06:00
full Not experimental 2021-01-03 22:58:19 -06:00
jit-paging Add TEST_RELEASE_BUILD to run tests on release build 2020-08-30 19:37:15 -05:00
kvm-unit-tests kvm-unit-test: Add a few benchmarks and run them longer 2020-12-31 19:14:34 -06:00
nasm Also mask exceptions bits in sse test 2021-01-03 22:43:08 -06:00
qemu Fix tests depending on arch 2021-01-03 22:43:08 -06:00
rust Avoid console.assert (doesn't throw) 2020-12-31 19:14:30 -06:00
Readme.md Document env variables for tests 2021-01-01 21:51:17 -06:00

Use the corresponding make target in the root directory to run a test. The following list is roughtly sorted from most interesting/useful to least.

  • nasm: Small unit tests written in assembly, which are run using gdb on the host.
  • qemu: Based on tests from qemu. Builds a Linux binary, which tests many CPU features, which are then compared to a run on qemu.
  • kvm-unit-test: Based on tests from the KVM project, tests various CPU features.
  • full: Starts several OSes and checks if they boot correctly.
  • jit-paging: Tests jit and paging interaction.
  • api: Tests for several API functions of v86.
  • devices: Device tests.
  • rust: Rust unit test helpers.
  • expect: Expect tests for the jit output. Contains a set of asm+wasm files, where the jit is expected to produce the wasm file given the asm file.

The following environmental variables are respected by most tests if applicable:

  • TEST_RELEASE_BUILD=1: Test the release build (libv86.js, v86.wasm) instead of the debug build (libv86-debug.js, v86-debug.wasm)
  • MAX_PARALLEL_TESTS=n: Maximum number of tests to run in parallel. Defaults to the number of cores in your system or less.
  • TEST_NAME="…": Run only the specified test (only expect, full, nasm)