linux-stable/tools/perf/Documentation/perf-test.txt
Arnaldo Carvalho de Melo 915a377627 perf test: Document the -w/--workload option
Wasn't documented so far, mention that it is mostly used in the shell
regression tests.

Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Reviewed-by: James Clark <james.clark@linaro.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Clark Williams <williams@redhat.com>
Link: https://lore.kernel.org/r/20241020021842.1752770-4-acme@kernel.org
Signed-off-by: Namhyung Kim <namhyung@kernel.org>
2024-10-21 21:10:50 -07:00

68 lines
1.6 KiB
Plaintext

perf-test(1)
============
NAME
----
perf-test - Runs sanity tests.
SYNOPSIS
--------
[verse]
'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::
--verbose::
Be more verbose.
-S::
--sequential::
Run tests one after the other, this is the default mode.
-p::
--parallel::
Run tests in parallel, speeds up the whole process but is not safe with
the current infrastructure, where some tests that compete for some resources,
for instance, 'perf probe' tests that add/remove probes or clean all probes, etc.
-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.