Merge tag 'block-5.9-2020-08-14' of git://git.kernel.dk/linux-block
[linux/fpc-iii.git] / tools / perf / Documentation / perf.txt
blob3f37ded13f8ce404d28b3f6261c62de144e62cd0
1 perf(1)
2 =======
4 NAME
5 ----
6 perf - Performance analysis tools for Linux
8 SYNOPSIS
9 --------
10 [verse]
11 'perf' [--version] [--help] [OPTIONS] COMMAND [ARGS]
13 OPTIONS
14 -------
15 --debug::
16         Setup debug variable (see list below) in value
17         range (0, 10). Use like:
18           --debug verbose   # sets verbose = 1
19           --debug verbose=2 # sets verbose = 2
21         List of debug variables allowed to set:
22           verbose          - general debug messages
23           ordered-events   - ordered events object debug messages
24           data-convert     - data convert command debug messages
25           stderr           - write debug output (option -v) to stderr
26                              in browser mode
27           perf-event-open  - Print perf_event_open() arguments and
28                              return value
30 --buildid-dir::
31         Setup buildid cache directory. It has higher priority than
32         buildid.dir config file option.
34 -v::
35 --version::
36   Display perf version.
38 -h::
39 --help::
40   Run perf help command.
42 DESCRIPTION
43 -----------
44 Performance counters for Linux are a new kernel-based subsystem
45 that provide a framework for all things performance analysis. It
46 covers hardware level (CPU/PMU, Performance Monitoring Unit) features
47 and software features (software counters, tracepoints) as well.
49 SEE ALSO
50 --------
51 linkperf:perf-stat[1], linkperf:perf-top[1],
52 linkperf:perf-record[1], linkperf:perf-report[1],
53 linkperf:perf-list[1]