QUARK-TEST(8) System Manager's Manual QUARK-TEST(8)

quark-test — quark's test utility

quark-test [-1bKktv] [-x test] [tests ...]

quark-test -h

quark-test -l

quark-test -V

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:

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.
Run only EBPF tests.
Display this manpage.
Run only KPROBE tests.
Make the EBPF backend use its kprobe fallback and not fentry. This sets QUARK_BPF_KPROBE, see quark_queue_open(3).
Prints all available tests on stdout.
Run only NOVA tests.
Print out the contents of /sys/kernel/tracing/trace_pipe during the test. This option cannot be used with -1.
Increase , can be issued multiple times.
Print version and exit.
test
Exclude test from the run, can be specified multiple times.

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.
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

quark_event_dump(3), quark_process_lookup(3), quark_queue_block(3), quark_queue_close(3), quark_queue_get_epollfd(3), quark_queue_get_event(3), quark_queue_get_stats(3), quark_queue_open(3), quark-btf(8), quark-mon(8)

November 3, 2026 Linux