1PERF-ANNOTATE(1)                  perf Manual                 PERF-ANNOTATE(1)
2
3
4

NAME

6       perf-annotate - Read perf.data (created by perf record) and display
7       annotated code
8

SYNOPSIS

10       perf annotate [-i <file> | --input=file] [symbol_name]
11

DESCRIPTION

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
17       If there is no debug info in the object, then annotated assembly is
18       displayed.
19

OPTIONS

21       -i, --input=<file>
22           Input file name. (default: perf.data unless stdin is a fifo)
23
24       -d, --dsos=<dso[,dso...]>
25           Only consider symbols in these dsos.
26
27       -s, --symbol=<symbol>
28           Symbol to annotate.
29
30       -f, --force
31           Don’t do ownership validation.
32
33       -v, --verbose
34           Be more verbose. (Show symbol address, etc)
35
36       -q, --quiet
37           Do not show any message. (Suppress -v)
38
39       -n, --show-nr-samples
40           Show the number of samples for each symbol
41
42       -D, --dump-raw-trace
43           Dump raw trace in ASCII.
44
45       -k, --vmlinux=<file>
46           vmlinux pathname.
47
48       --ignore-vmlinux
49           Ignore vmlinux files.
50
51       -m, --modules
52           Load module symbols. WARNING: use only with -k and LIVE kernel.
53
54       -l, --print-line
55           Print matching source lines (may be slow).
56
57       -P, --full-paths
58           Don’t shorten the displayed pathnames.
59
60       --stdio
61           Use the stdio interface.
62
63       --stdio2
64           Use the stdio2 interface, non-interactive, uses the TUI formatting.
65
66       --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
73       --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
79       --gtk
80           Use the GTK interface.
81
82       -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
88       --asm-raw
89           Show raw instruction encoding of assembly instructions.
90
91       --show-total-period
92           Show a column with the sum of periods.
93
94       --source
95           Interleave source code with assembly code. Enabled by default,
96           disable with --no-source.
97
98       --symfs=<directory>
99           Look for files with symbols relative to this directory.
100
101       -M, --disassembler-style=
102           Set disassembler style for objdump.
103
104       --objdump=<path>
105           Path to objdump binary.
106
107       --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
112       --skip-missing
113           Skip symbols that cannot be annotated.
114
115       --group
116           Show event group information together
117
118       --percent-type
119           Set annotation percent type from following choices: global-period,
120           local-period, global-hits, local-hits
121
122               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

SEE ALSO

128       perf-record(1), perf-report(1)
129
130
131
132perf                              04/23/2020                  PERF-ANNOTATE(1)
Impressum