NAME

       perf-test - Runs sanity tests.

SYNOPSIS

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

DESCRIPTION

       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.

OPTIONS

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

perf                                               06/15/2025                                       PERF-TEST(1)