more/kvm-unit-tests/README.md

1 # Welcome to kvm-unit-tests
3 See http://www.linux-kvm.org/page/KVM-unit-tests for a high-level
18 NOTE: GCC cross-compiler is required for [build on macOS](README.macOS.md).
20 ## Cross-compiling
25     ./configure --arch=arm64 --cross-prefix=aarch64-linux-gnu-
28 ## clang  section in Building the tests
30 clang may be used as an alternative to gcc.
32     ./configure --cc=clang
35 clang may also be used with cross binutils when cross-compiling. For example,
36 for riscv64
38     ./configure --arch=riscv64 --cc=clang --cflags='--target=riscv64' \
39                 --cross-prefix=riscv64-linux-gnu-
48     (send tests/some-test somewhere)
50     ./some-test
52 `make install` will install all tests in PREFIX/share/kvm-unit-tests/tests,
61     ./x86-run ./x86/msr.flat
75     QEMU=/tmp/qemu/x86_64-softmmu/qemu-system-x86_64 ./x86-run ./x86/msr.flat
80     ACCEL=kvm ./x86-run ./x86/msr.flat
86 As for running a test with kvmtool, please configure kvm-unit-tests accordingly
89    ./configure --arch=arm64 --target=kvmtool
98 Check [x86/efi/README.md](./x86/efi/README.md).
112 runner's -g option.
116 Unit tests use QEMU's '-append args...' parameter for command line
124 may be passed with '-initrd file' to become the unit test's environ,
130     QEMU_VERSION_STRING          string of the form `qemu -h | head -1`
131     KERNEL_VERSION_STRING        string of the form `uname -r`
133 Additionally these self-explanatory variables are reserved
141 host. kvm-unit-tests provides two ways to handle tests like those.
147      a) independently, `ARCH-run ARCH/test`
149      b) by specifying any other non-nodefault group it is in,
150         groups = nodefault mygroup : `./run_tests.sh -g mygroup`
152      c) by specifying all tests should be run, `./run_tests.sh -a`
168     c) by specifying all tests should be run, `./run_tests.sh -a`
169        (The -a switch ensures the ERRATA_FORCE is provided and set
182     .:                  configure script, top-level Makefile, and run_tests.sh
197   - C: please use standard linux-with-tabs, see Linux kernel
198     doc Documentation/process/coding-style.rst
199   - Shell: use TABs for indentation
203   - While the kernel standard requires 80 columns, we allow up to 120.
218 Please prefix messages with: [kvm-unit-tests PATCH]
223         subjectprefix = kvm-unit-tests PATCH
228 code. git-diff's orderFile feature allows us to specify the order in a