quark-test —
quark's test utility
quark-test |
[-1bKktv] [-x
test] [tests ...] |
The
quark-test program runs tests for
quark(7). It is designed as one big fat
binary so that you can easily run it with quark's custom
initramfs.gz. Without any arguments,
quark-test will run all tests in both KPROBE and EBPF
as backend.
Each test runs a separate sub-process in order to avoid address
space contaminaton between two tests. The number of failed tests is the
return value of quark-test.
The options are as follows:
-1
- Don't run tests in a child process, useful for debugging with gdb, strace
and whatnot. Filesystem tests can change the runner's mount namespace.
Later tests use that namespace. This also applies if filesystem setup
fails after the namespace change and the run continues.
-b
- Run only EBPF tests.
-h
- Display this manpage.
-k
- Run only KPROBE tests.
-K
- Make the EBPF backend use its kprobe fallback and not fentry. This sets
QUARK_BPF_KPROBE, see
quark_queue_open(3).
-l
- Prints all available tests on stdout.
-n
- Run only NOVA tests.
-t
- Print out the contents of
/sys/kernel/tracing/trace_pipe during the test.
This option cannot be used with
-1.
-v
- Increase
quark_verbose,
can be issued multiple times.
-V
- Print version and exit.
-x
test
- Exclude test from the run, can be specified multiple
times.
QUARK_TEST_FS_IMAGE
- Path to an ext4 test image, made by “make quark-test.ext4”.
The default is quark-test.ext4 in the current
directory, or /quark-test.ext4 in the kernel test
guest. Each use opens the image read-only and copies it to a temporary
file. The tests mount the copy through a loop device in a private mount
namespace. Changes to the copy do not change the source image.
QUARK_TEST_FS_REQUIRED
- If set, failure to set up the test filesystem is an error. Otherwise,
tests that require it print an explicit skip message. Set this variable
for kernel runs which must exercise inode reuse.
quark-test exits with the number of failed
tests, or non-zero if quark-test itself fails.
$ quark-test -k
t_probe @ kprobe: ok
t_fork_exec_exit @ kprobe: ok
failed tests 0
$ quark-test t_fork_exec_exit
t_fork_exec_exit @ ebpf: ok
t_fork_exec_exit @ kprobe: ok
failed tests 0