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 !! 25 stderr - write debug output (option -v) to stderr
26 --exec-path:: !! 26 in browser mode
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 27
39 --buildid-dir:: 28 --buildid-dir::
40 Setup buildid cache directory. It has !! 29 Setup buildid cache directory. It has higher priority than
41 than buildid.dir config file option. !! 30 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 31
49 --debugfs-dir:: !! 32 -v::
50 Set debugfs directory or set environme !! 33 --version::
51 !! 34 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 35
69 --debug-file:: !! 36 -h::
70 Write debug output to a specified file !! 37 --help::
>> 38 Run perf help command.
71 39
72 DESCRIPTION 40 DESCRIPTION
73 ----------- 41 -----------
74 Performance counters for Linux are a new kerne 42 Performance counters for Linux are a new kernel-based subsystem
75 that provide a framework for all things perfor 43 that provide a framework for all things performance analysis. It
76 covers hardware level (CPU/PMU, Performance Mo 44 covers hardware level (CPU/PMU, Performance Monitoring Unit) features
77 and software features (software counters, trac 45 and software features (software counters, tracepoints) as well.
78 46
79 SEE ALSO 47 SEE ALSO
80 -------- 48 --------
81 linkperf:perf-stat[1], linkperf:perf-top[1], 49 linkperf:perf-stat[1], linkperf:perf-top[1],
82 linkperf:perf-record[1], linkperf:perf-report[ 50 linkperf:perf-record[1], linkperf:perf-report[1],
83 linkperf:perf-list[1] 51 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.