blob: 59f0b846cd7141a1c76de2486dd531b45b624334 [file] [log] [blame]
Ingo Molnar0bec2532009-05-26 09:17:18 +02001perf-report(1)
Ingo Molnarc1c23652009-05-30 12:38:51 +02002==============
Ingo Molnar0bec2532009-05-26 09:17:18 +02003
4NAME
5----
Ingo Molnar23ac9cb2009-05-27 09:33:18 +02006perf-report - Read perf.data (created by perf record) and display the profile
Ingo Molnar0bec2532009-05-26 09:17:18 +02007
8SYNOPSIS
9--------
10[verse]
11'perf report' [-i <file> | --input=file]
12
13DESCRIPTION
14-----------
15This command displays the performance counter profile information recorded
Ingo Molnarb0a28582009-06-23 16:39:53 +020016via perf record.
Ingo Molnar0bec2532009-05-26 09:17:18 +020017
18OPTIONS
19-------
20-i::
21--input=::
Ingo Molnar23ac9cb2009-05-27 09:33:18 +020022 Input file name. (default: perf.data)
Arnaldo Carvalho de Melo25903402009-06-30 19:01:20 -030023-d::
24--dsos=::
25 Only consider symbols in these dsos. CSV that understands
26 file://filename entries.
Arnaldo Carvalho de Meloe3d7e182009-07-11 12:18:37 -030027-n
28--show-nr-samples
29 Show the number of samples for each symbol
Brice Goglin8d513272009-08-07 13:55:24 +020030-T
31--threads
32 Show per-thread event counters
Arnaldo Carvalho de Melocc8b88b2009-06-30 19:01:21 -030033-C::
34--comms=::
35 Only consider symbols in these comms. CSV that understands
36 file://filename entries.
Arnaldo Carvalho de Melo7bec7a92009-06-30 19:01:22 -030037-S::
38--symbols=::
39 Only consider these symbols. CSV that understands
40 file://filename entries.
Ingo Molnar0bec2532009-05-26 09:17:18 +020041
Arnaldo Carvalho de Melo52d422d2009-07-10 22:47:28 -030042-w::
43--field-width=::
44 Force each column width to the provided list, for large terminal
45 readability.
46
47-t::
48--field-separator=::
49
50 Use a special separator character and don't pad with spaces, replacing
51 all occurances of this separator in symbol names (and other output)
52 with a '.' character, that thus it's the only non valid separator.
53
Frederic Weisbeckerec7ba4e2009-08-31 03:32:03 +020054-g [type,min]::
55--call-graph::
56 Display callchains using type and min percent threshold.
57 type can be either:
58 - flat: single column, linear exposure of callchains.
59 - graph: use a graph tree, displaying absolute overhead rates.
60 - fractal: like graph, but displays relative rates. Each branch of
61 the tree is considered as a new profiled object. +
62 Default: fractal,0.5.
63
Ingo Molnar0bec2532009-05-26 09:17:18 +020064SEE ALSO
65--------
66linkperf:perf-stat[1]