summaryrefslogtreecommitdiff
path: root/tools/perf/Documentation/perf-test.txt
blob: 32da0d1fa86ab411434bb77ec47e5e76161613fd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
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::
-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.