v86/tests/Readme.md

26 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2021-01-01 02:14:34 +01: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.
2017-06-19 22:06:50 +02:00
- [nasm](nasm/): Small unit tests written in assembly, which are run using gdb
on the host.
2021-01-01 02:14:34 +01:00
- [qemu](qemu/): Based on tests from qemu. Builds a Linux binary, which tests
many CPU features, which are then compared to a run on qemu.
2017-04-02 22:20:55 +02:00
- [kvm-unit-test](kvm-unit-test/): Based on tests from the KVM project, tests
various CPU features.
2017-06-19 22:06:50 +02:00
- [full](full/): Starts several OSes and checks if they boot correctly.
2021-01-01 02:14:34 +01:00
- [jit-paging](jit-paging/): Tests jit and paging interaction.
- [api](api/): Tests for several API functions of v86.
- [devices](devices/): Device tests.
- [rust](rust/): Rust unit test helpers.
- [expect](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.
2021-01-02 03:42:02 +01:00
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)