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

quark-testquark's test utility

quark-test [-bkv] [tests ...]

quark-test -h

quark-test -l

quark-test -N

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:

Run only EBPF tests.
Display this manpage.
Run only KPROBE tests.
Prints all available tests on stdout.
This is a nop flag, literally, quark-test will just exit with 0. Some tests must fork and exec things in order to collect events, this keeps the binary self contained by forking and execing itself as we don't have access to system utilities in initramfs.gz.
Increase , can be issued multiple times.
Print version and exit.

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)

December 1, 2024 Linux