]> asedeno.scripts.mit.edu Git - linux.git/blob - tools/perf/Documentation/perf.txt
Merge branch 'pipe-exclusive-wakeup'
[linux.git] / tools / perf / Documentation / perf.txt
1 perf(1)
2 =======
3
4 NAME
5 ----
6 perf - Performance analysis tools for Linux
7
8 SYNOPSIS
9 --------
10 [verse]
11 'perf' [--version] [--help] [OPTIONS] COMMAND [ARGS]
12
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
20
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
29
30 --buildid-dir::
31         Setup buildid cache directory. It has higher priority than
32         buildid.dir config file option.
33
34 -v::
35 --version::
36   Display perf version.
37
38 -h::
39 --help::
40   Run perf help command.
41
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.
48
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]