Ingo Molnar | 0bec253 | 2009-05-26 09:17:18 +0200 | [diff] [blame] | 1 | perf-report(1) |
Ingo Molnar | c1c2365 | 2009-05-30 12:38:51 +0200 | [diff] [blame] | 2 | ============== |
Ingo Molnar | 0bec253 | 2009-05-26 09:17:18 +0200 | [diff] [blame] | 3 | |
| 4 | NAME |
| 5 | ---- |
Ingo Molnar | 23ac9cb | 2009-05-27 09:33:18 +0200 | [diff] [blame] | 6 | perf-report - Read perf.data (created by perf record) and display the profile |
Ingo Molnar | 0bec253 | 2009-05-26 09:17:18 +0200 | [diff] [blame] | 7 | |
| 8 | SYNOPSIS |
| 9 | -------- |
| 10 | [verse] |
| 11 | 'perf report' [-i <file> | --input=file] |
| 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
| 15 | This command displays the performance counter profile information recorded |
Ingo Molnar | b0a2858 | 2009-06-23 16:39:53 +0200 | [diff] [blame] | 16 | via perf record. |
Ingo Molnar | 0bec253 | 2009-05-26 09:17:18 +0200 | [diff] [blame] | 17 | |
| 18 | OPTIONS |
| 19 | ------- |
| 20 | -i:: |
| 21 | --input=:: |
Robert Richter | efad141 | 2011-12-07 10:02:54 +0100 | [diff] [blame] | 22 | Input file name. (default: perf.data unless stdin is a fifo) |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 23 | |
| 24 | -v:: |
| 25 | --verbose:: |
| 26 | Be more verbose. (show symbol address, etc) |
| 27 | |
Arnaldo Carvalho de Melo | 2590340 | 2009-06-30 19:01:20 -0300 | [diff] [blame] | 28 | -d:: |
| 29 | --dsos=:: |
| 30 | Only consider symbols in these dsos. CSV that understands |
| 31 | file://filename entries. |
Zeev Tarantov | ca2b900 | 2009-11-09 13:26:13 +0200 | [diff] [blame] | 32 | -n:: |
| 33 | --show-nr-samples:: |
Arnaldo Carvalho de Melo | e3d7e18 | 2009-07-11 12:18:37 -0300 | [diff] [blame] | 34 | Show the number of samples for each symbol |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 35 | |
| 36 | --showcpuutilization:: |
| 37 | Show sample percentage for different cpu modes. |
| 38 | |
Zeev Tarantov | ca2b900 | 2009-11-09 13:26:13 +0200 | [diff] [blame] | 39 | -T:: |
| 40 | --threads:: |
Brice Goglin | 8d51327 | 2009-08-07 13:55:24 +0200 | [diff] [blame] | 41 | Show per-thread event counters |
David Ahern | c8e6672 | 2011-11-13 11:30:08 -0700 | [diff] [blame] | 42 | -c:: |
Arnaldo Carvalho de Melo | cc8b88b | 2009-06-30 19:01:21 -0300 | [diff] [blame] | 43 | --comms=:: |
| 44 | Only consider symbols in these comms. CSV that understands |
| 45 | file://filename entries. |
Arnaldo Carvalho de Melo | 7bec7a9 | 2009-06-30 19:01:22 -0300 | [diff] [blame] | 46 | -S:: |
| 47 | --symbols=:: |
| 48 | Only consider these symbols. CSV that understands |
| 49 | file://filename entries. |
Ingo Molnar | 0bec253 | 2009-05-26 09:17:18 +0200 | [diff] [blame] | 50 | |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 51 | -U:: |
| 52 | --hide-unresolved:: |
| 53 | Only display entries resolved to a symbol. |
| 54 | |
Arnaldo Carvalho de Melo | c351c28 | 2009-12-16 13:49:27 -0200 | [diff] [blame] | 55 | -s:: |
| 56 | --sort=:: |
| 57 | Sort by key(s): pid, comm, dso, symbol, parent. |
| 58 | |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 59 | -p:: |
| 60 | --parent=<regex>:: |
| 61 | regex filter to identify parent, see: '--sort parent' |
| 62 | |
| 63 | -x:: |
| 64 | --exclude-other:: |
| 65 | Only display entries with parent-match. |
| 66 | |
Arnaldo Carvalho de Melo | 52d422d | 2009-07-10 22:47:28 -0300 | [diff] [blame] | 67 | -w:: |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 68 | --column-widths=<width[,width...]>:: |
Arnaldo Carvalho de Melo | 52d422d | 2009-07-10 22:47:28 -0300 | [diff] [blame] | 69 | Force each column width to the provided list, for large terminal |
| 70 | readability. |
| 71 | |
| 72 | -t:: |
| 73 | --field-separator=:: |
| 74 | |
| 75 | Use a special separator character and don't pad with spaces, replacing |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 76 | all occurrences of this separator in symbol names (and other output) |
Arnaldo Carvalho de Melo | 52d422d | 2009-07-10 22:47:28 -0300 | [diff] [blame] | 77 | with a '.' character, that thus it's the only non valid separator. |
| 78 | |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 79 | -D:: |
| 80 | --dump-raw-trace:: |
| 81 | Dump raw trace in ASCII. |
| 82 | |
Namhyung Kim | 6581f6e | 2011-12-13 00:16:50 +0900 | [diff] [blame] | 83 | -g [type,min[,limit],order]:: |
Frederic Weisbecker | ec7ba4e | 2009-08-31 03:32:03 +0200 | [diff] [blame] | 84 | --call-graph:: |
Namhyung Kim | 6581f6e | 2011-12-13 00:16:50 +0900 | [diff] [blame] | 85 | Display call chains using type, min percent threshold, optional print |
| 86 | limit and order. |
Frederic Weisbecker | ec7ba4e | 2009-08-31 03:32:03 +0200 | [diff] [blame] | 87 | type can be either: |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 88 | - flat: single column, linear exposure of call chains. |
Frederic Weisbecker | ec7ba4e | 2009-08-31 03:32:03 +0200 | [diff] [blame] | 89 | - graph: use a graph tree, displaying absolute overhead rates. |
| 90 | - fractal: like graph, but displays relative rates. Each branch of |
| 91 | the tree is considered as a new profiled object. + |
Sam Liao | d797fdc | 2011-06-07 23:49:46 +0800 | [diff] [blame] | 92 | |
| 93 | order can be either: |
| 94 | - callee: callee based call graph. |
| 95 | - caller: inverted caller based call graph. |
| 96 | |
| 97 | Default: fractal,0.5,callee. |
| 98 | |
| 99 | -G:: |
| 100 | --inverted:: |
| 101 | alias for inverted caller based call graph. |
Frederic Weisbecker | ec7ba4e | 2009-08-31 03:32:03 +0200 | [diff] [blame] | 102 | |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 103 | --pretty=<key>:: |
| 104 | Pretty printing style. key: normal, raw |
| 105 | |
Arnaldo Carvalho de Melo | 8b9e74e | 2010-08-21 10:38:16 -0300 | [diff] [blame] | 106 | --stdio:: Use the stdio interface. |
| 107 | |
| 108 | --tui:: Use the TUI interface, that is integrated with annotate and allows |
| 109 | zooming into DSOs or threads, among other features. Use of --tui |
| 110 | requires a tty, if one is not present, as when piping to other |
| 111 | commands, the stdio interface is used. |
| 112 | |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 113 | -k:: |
| 114 | --vmlinux=<file>:: |
| 115 | vmlinux pathname |
| 116 | |
David Ahern | b226a5a7 | 2010-12-07 19:39:46 -0700 | [diff] [blame] | 117 | --kallsyms=<file>:: |
| 118 | kallsyms pathname |
| 119 | |
Shawn Bohrer | e04fffc | 2010-11-30 19:57:17 -0600 | [diff] [blame] | 120 | -m:: |
| 121 | --modules:: |
| 122 | Load module symbols. WARNING: This should only be used with -k and |
| 123 | a LIVE kernel. |
| 124 | |
| 125 | -f:: |
| 126 | --force:: |
| 127 | Don't complain, do it. |
| 128 | |
David Ahern | ec5761e | 2010-12-09 13:27:07 -0700 | [diff] [blame] | 129 | --symfs=<directory>:: |
| 130 | Look for files with symbols relative to this directory. |
| 131 | |
David Ahern | c8e6672 | 2011-11-13 11:30:08 -0700 | [diff] [blame] | 132 | -C:: |
Anton Blanchard | 5d67be9 | 2011-07-04 21:57:50 +1000 | [diff] [blame] | 133 | --cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can |
| 134 | be provided as a comma-separated list with no space: 0,1. Ranges of |
| 135 | CPUs are specified with -: 0-2. Default is to report samples on all |
| 136 | CPUs. |
| 137 | |
Andi Kleen | f69b64f | 2011-09-15 14:31:41 -0700 | [diff] [blame] | 138 | -M:: |
| 139 | --disassembler-style=:: Set disassembler style for objdump. |
| 140 | |
Arnaldo Carvalho de Melo | 64c6f0c | 2011-10-06 12:48:31 -0300 | [diff] [blame] | 141 | --source:: |
| 142 | Interleave source code with assembly code. Enabled by default, |
| 143 | disable with --no-source. |
| 144 | |
| 145 | --asm-raw:: |
| 146 | Show raw instruction encoding of assembly instructions. |
| 147 | |
Arnaldo Carvalho de Melo | 3f2728b | 2011-10-05 16:10:06 -0300 | [diff] [blame] | 148 | --show-total-period:: Show a column with the sum of periods. |
| 149 | |
Stephane Eranian | fbe96f2 | 2011-09-30 15:40:40 +0200 | [diff] [blame] | 150 | -I:: |
| 151 | --show-info:: |
| 152 | Display extended information about the perf.data file. This adds |
| 153 | information which may be very large and thus may clutter the display. |
| 154 | It currently includes: cpu and numa topology of the host system. |
| 155 | |
Ingo Molnar | 0bec253 | 2009-05-26 09:17:18 +0200 | [diff] [blame] | 156 | SEE ALSO |
| 157 | -------- |
Arnaldo Carvalho de Melo | 64c6f0c | 2011-10-06 12:48:31 -0300 | [diff] [blame] | 158 | linkperf:perf-stat[1], linkperf:perf-annotate[1] |