| perf-annotate(1) |
| ================ |
| |
| NAME |
| ---- |
| perf-annotate - Read perf.data (created by perf record) and display annotated code |
| |
| SYNOPSIS |
| -------- |
| [verse] |
| 'perf annotate' [-i <file> | --input=file] [symbol_name] |
| |
| DESCRIPTION |
| ----------- |
| This command reads the input file and displays an annotated version of the |
| code. If the object file has debug symbols then the source code will be |
| displayed alongside assembly code. |
| |
| If there is no debug info in the object, then annotated assembly is displayed. |
| |
| OPTIONS |
| ------- |
| -i:: |
| --input=<file>:: |
| Input file name. (default: perf.data unless stdin is a fifo) |
| |
| -d:: |
| --dsos=<dso[,dso...]>:: |
| Only consider symbols in these dsos. |
| -s:: |
| --symbol=<symbol>:: |
| Symbol to annotate. |
| |
| -f:: |
| --force:: |
| Don't do ownership validation. |
| |
| -v:: |
| --verbose:: |
| Be more verbose. (Show symbol address, etc) |
| |
| -q:: |
| --quiet:: |
| Do not show any message. (Suppress -v) |
| |
| -n:: |
| --show-nr-samples:: |
| Show the number of samples for each symbol |
| |
| -D:: |
| --dump-raw-trace:: |
| Dump raw trace in ASCII. |
| |
| -k:: |
| --vmlinux=<file>:: |
| vmlinux pathname. |
| |
| --ignore-vmlinux:: |
| Ignore vmlinux files. |
| |
| -m:: |
| --modules:: |
| Load module symbols. WARNING: use only with -k and LIVE kernel. |
| |
| -l:: |
| --print-line:: |
| Print matching source lines (may be slow). |
| |
| -P:: |
| --full-paths:: |
| Don't shorten the displayed pathnames. |
| |
| --stdio:: Use the stdio interface. |
| |
| --stdio2:: Use the stdio2 interface, non-interactive, uses the TUI formatting. |
| |
| --stdio-color=<mode>:: |
| 'always', 'never' or 'auto', allowing configuring color output |
| via the command line, in addition to via "color.ui" .perfconfig. |
| Use '--stdio-color always' to generate color even when redirecting |
| to a pipe or file. Using just '--stdio-color' is equivalent to |
| using 'always'. |
| |
| --tui:: Use the TUI interface. Use of --tui requires a tty, if one is not |
| present, as when piping to other commands, the stdio interface is |
| used. This interfaces starts by centering on the line with more |
| samples, TAB/UNTAB cycles through the lines with more samples. |
| |
| --gtk:: Use the GTK interface. |
| |
| -C:: |
| --cpu=<cpu>:: Only report samples for the list of CPUs provided. Multiple CPUs can |
| be provided as a comma-separated list with no space: 0,1. Ranges of |
| CPUs are specified with -: 0-2. Default is to report samples on all |
| CPUs. |
| |
| --asm-raw:: |
| Show raw instruction encoding of assembly instructions. |
| |
| --show-total-period:: Show a column with the sum of periods. |
| |
| --source:: |
| Interleave source code with assembly code. Enabled by default, |
| disable with --no-source. |
| |
| --symfs=<directory>:: |
| Look for files with symbols relative to this directory. |
| |
| -M:: |
| --disassembler-style=:: Set disassembler style for objdump. |
| |
| --objdump=<path>:: |
| Path to objdump binary. |
| |
| --skip-missing:: |
| Skip symbols that cannot be annotated. |
| |
| --group:: |
| Show event group information together |
| |
| SEE ALSO |
| -------- |
| linkperf:perf-record[1], linkperf:perf-report[1] |
