PERF-TEST(1) perf Manual PERF-TEST(1)

perf-test - Runs sanity tests.

perf test [<options>] [{list <test-name-fragment>|[<test-name-fragments>|<test-numbers>]}]

This command does assorted sanity tests, initially through linked routines but also will look for a directory with more tests in the form of scripts.

To get a list of available tests use perf test list, specifying a test name fragment will show all tests that have it.

To run just specific tests, inform test name fragments or the numbers obtained from perf test list.

-s, --skip

Tests to skip (comma separated numeric list).

-v, -vv, -vvv, --verbose

With a single -v, verbose level 1, only failing test output is displayed. With -vv and higher all test output is shown.

-S, --sequential

Run all tests one after the other. By default "exclusive" tests are run sequentially, but other tests are run in parallel to speed execution.

-r, --runs-per-test

Run each test the given number of times, by default once. This option can be useful to determine if a test is flaky.

-F, --dont-fork

Do not fork child for each test, run all tests within single process, this sets sequential mode.

--dso

Specify a DSO for the "Symbols" test.

-w, --workload=

Run a built-in workload, to list them use --list-workloads, current ones include: noploop, thloop, leafloop, sqrtloop, brstack, datasym and landlock.
Used with the shell script regression tests.
Some accept an extra parameter:
seconds: leafloop, noploop, sqrtloop, thloop
nrloops: brstack
The datasym and landlock workloads don't accept any.

--list-workloads

List the available workloads to use with -w/--workload.
2025-01-16 perf