1 perf(1) 1 perf(1)
2 ======= 2 =======
3 3
4 NAME 4 NAME
5 ---- 5 ----
6 perf - Performance analysis tools for Linux 6 perf - Performance analysis tools for Linux
7 7
8 SYNOPSIS 8 SYNOPSIS
9 -------- 9 --------
10 [verse] 10 [verse]
11 'perf' [--version] [--help] [OPTIONS] COMMAND 11 'perf' [--version] [--help] [OPTIONS] COMMAND [ARGS]
12 12
13 OPTIONS 13 OPTIONS
14 ------- 14 -------
15 -h:: !! 15 --debug::
16 --help:: !! 16 Setup debug variable (see list below) in value
17 Run perf help command. !! 17 range (0, 10). Use like:
18 !! 18 --debug verbose # sets verbose = 1
19 -v:: !! 19 --debug verbose=2 # sets verbose = 2
20 --version:: !! 20
21 Display perf version. !! 21 List of debug variables allowed to set:
22 !! 22 verbose - general debug messages
23 -vv:: !! 23 ordered-events - ordered events object debug messages
24 Print the compiled-in status of librar !! 24 data-convert - data convert command debug messages
25 <<
26 --exec-path:: <<
27 Display or set exec path. <<
28 <<
29 --html-path:: <<
30 Display html documentation path. <<
31 <<
32 -p:: <<
33 --paginate:: <<
34 Set up pager. <<
35 <<
36 --no-pager:: <<
37 Do not set pager. <<
38 25
39 --buildid-dir:: 26 --buildid-dir::
40 Setup buildid cache directory. It has !! 27 Setup buildid cache directory. It has higher priority than
41 than buildid.dir config file option. !! 28 buildid.dir config file option.
42 <<
43 --list-cmds:: <<
44 List the most commonly used perf comma <<
45 <<
46 --list-opts:: <<
47 List available perf options. <<
48 29
49 --debugfs-dir:: !! 30 -v::
50 Set debugfs directory or set environme !! 31 --version::
51 !! 32 Display perf version.
52 --debug:: <<
53 Setup debug variable (see list below) <<
54 range (0, 10). Use like: <<
55 --debug verbose # sets verbose = 1 <<
56 --debug verbose=2 # sets verbose = 2 <<
57 <<
58 List of debug variables allowed to set <<
59 verbose - general debug mes <<
60 ordered-events - ordered events ob <<
61 data-convert - data convert comm <<
62 stderr - write debug outpu <<
63 in browser mode <<
64 perf-event-open - Print perf_event_ <<
65 return value <<
66 kmaps - Print kernel and <<
67 and perf report w <<
68 33
69 --debug-file:: !! 34 -h::
70 Write debug output to a specified file !! 35 --help::
>> 36 Run perf help command.
71 37
72 DESCRIPTION 38 DESCRIPTION
73 ----------- 39 -----------
74 Performance counters for Linux are a new kerne 40 Performance counters for Linux are a new kernel-based subsystem
75 that provide a framework for all things perfor 41 that provide a framework for all things performance analysis. It
76 covers hardware level (CPU/PMU, Performance Mo 42 covers hardware level (CPU/PMU, Performance Monitoring Unit) features
77 and software features (software counters, trac 43 and software features (software counters, tracepoints) as well.
78 44
79 SEE ALSO 45 SEE ALSO
80 -------- 46 --------
81 linkperf:perf-stat[1], linkperf:perf-top[1], 47 linkperf:perf-stat[1], linkperf:perf-top[1],
82 linkperf:perf-record[1], linkperf:perf-report[ 48 linkperf:perf-record[1], linkperf:perf-report[1],
83 linkperf:perf-list[1] 49 linkperf:perf-list[1]
84 <<
85 linkperf:perf-amd-ibs[1], linkperf:perf-annota <<
86 linkperf:perf-archive[1], linkperf:perf-arm-sp <<
87 linkperf:perf-bench[1], linkperf:perf-buildid- <<
88 linkperf:perf-buildid-list[1], linkperf:perf-c <<
89 linkperf:perf-config[1], linkperf:perf-data[1] <<
90 linkperf:perf-evlist[1], linkperf:perf-ftrace[ <<
91 linkperf:perf-help[1], linkperf:perf-inject[1] <<
92 linkperf:perf-intel-pt[1], linkperf:perf-iosta <<
93 linkperf:perf-kmem[1], linkperf:perf-kvm[1], l <<
94 linkperf:perf-mem[1], linkperf:perf-probe[1], <<
95 linkperf:perf-script[1], linkperf:perf-test[1] <<
96 linkperf:perf-trace[1], linkperf:perf-version[ <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.