Fabian 719bc39e08 fix more AMD-specific undefined behaviour 1 year ago
..
api 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
benchmark 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
devices 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
expect 58f9902057 merge updates to last_op_size and flags_changed 2 years ago
full 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
jit-paging 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
kvm-unit-tests 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
manual 080482da89 s/V86Starter/V86 1 year ago
nasm 719bc39e08 fix more AMD-specific undefined behaviour 1 year ago
qemu 4928c9165d (breaking change) replace *-output-char with *-output-byte (#928) 1 year ago
rust acb8ad5423 Avoid console.assert (doesn't throw) 3 years ago
Readme.md 2697aa6192 Document env variables for tests 3 years ago

Readme.md

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)