1PERF-ANNOTATE(1) perf Manual PERF-ANNOTATE(1)
2
6 perf-annotate - Read perf.data (created by perf record) and display
7 annotated code
8
10 perf annotate [-i <file> | --input=file] [symbol_name]
11
13 This command reads the input file and displays an annotated version of
14 the code. If the object file has debug symbols then the source code
15 will be displayed alongside assembly code.
16 If there is no debug info in the object, then annotated assembly is
18 displayed.
19
21 -i, --input=<file>
22 Input file name. (default: perf.data unless stdin is a fifo)
23 -d, --dsos=<dso[,dso...]>
25 Only consider symbols in these dsos.
26 -s, --symbol=<symbol>
28 Symbol to annotate.
29 -f, --force
31 Don’t do ownership validation.
32 -v, --verbose
34 Be more verbose. (Show symbol address, etc)
35 -q, --quiet
37 Do not show any message. (Suppress -v)
38 -n, --show-nr-samples
40 Show the number of samples for each symbol
41 -D, --dump-raw-trace
43 Dump raw trace in ASCII.
44 -k, --vmlinux=<file>
46 vmlinux pathname.
47 --ignore-vmlinux
49 Ignore vmlinux files.
50 -m, --modules
52 Load module symbols. WARNING: use only with -k and LIVE kernel.
53 -l, --print-line
55 Print matching source lines (may be slow).
56 -P, --full-paths
58 Don’t shorten the displayed pathnames.
59 --stdio
61 Use the stdio interface.
62 --stdio2
64 Use the stdio2 interface, non-interactive, uses the TUI formatting.
65 --stdio-color=<mode>
67 always, never or auto, allowing configuring color output via the
68 command line, in addition to via "color.ui" .perfconfig. Use
69 --stdio-color always to generate color even when redirecting to a
70 pipe or file. Using just --stdio-color is equivalent to using
71 always.
72 --tui
74 Use the TUI interface. Use of --tui requires a tty, if one is not
75 present, as when piping to other commands, the stdio interface is
76 used. This interfaces starts by centering on the line with more
77 samples, TAB/UNTAB cycles through the lines with more samples.
78 --gtk
80 Use the GTK interface.
81 -C, --cpu=<cpu>
83 Only report samples for the list of CPUs provided. Multiple CPUs
84 can be provided as a comma-separated list with no space: 0,1.
85 Ranges of CPUs are specified with -: 0-2. Default is to report
86 samples on all CPUs.
87 --asm-raw
89 Show raw instruction encoding of assembly instructions.
90 --show-total-period
92 Show a column with the sum of periods.
93 --source
95 Interleave source code with assembly code. Enabled by default,
96 disable with --no-source.
97 --symfs=<directory>
99 Look for files with symbols relative to this directory.
100 -M, --disassembler-style=
102 Set disassembler style for objdump.
103 --objdump=<path>
105 Path to objdump binary.
106 --prefix=PREFIX, --prefix-strip=N
108 Remove first N entries from source file path names in executables
109 and add PREFIX. This allows to display source code compiled on
110 systems with different file system layout.
111 --skip-missing
113 Skip symbols that cannot be annotated.
114 --group
116 Show event group information together
117 --percent-type
119 Set annotation percent type from following choices: global-period,
120 local-period, global-hits, local-hits
121 The local/global keywords set if the percentage is computed
123 in the scope of the function (local) or the whole data (global).
124 The period/hits keywords set the base the percentage is computed
125 on - the samples period or the number of samples (hits).
126
128 perf-record(1), perf-report(1)
129perf 04/23/2020 PERF-ANNOTATE(1)