1 perf-annotate(1)
2 ================
3
4 NAME
5 ----
6 perf-annotate - Read perf.data (created by per
7
8 SYNOPSIS
9 --------
10 [verse]
11 'perf annotate' [-i <file> | --input=file] [sy
12
13 DESCRIPTION
14 -----------
15 This command reads the input file and displays
16 code. If the object file has debug symbols the
17 displayed alongside assembly code.
18
19 If there is no debug info in the object, then
20
21 OPTIONS
22 -------
23 -i::
24 --input=<file>::
25 Input file name. (default: perf.data u
26
27 -d::
28 --dsos=<dso[,dso...]>::
29 Only consider symbols in these dsos.
30 -s::
31 --symbol=<symbol>::
32 Symbol to annotate.
33
34 -f::
35 --force::
36 Don't do ownership validation.
37
38 -v::
39 --verbose::
40 Be more verbose. (Show symbol address,
41
42 -q::
43 --quiet::
44 Do not show any warnings or messages.
45
46 -n::
47 --show-nr-samples::
48 Show the number of samples for each sy
49
50 -D::
51 --dump-raw-trace::
52 Dump raw trace in ASCII.
53
54 -k::
55 --vmlinux=<file>::
56 vmlinux pathname.
57
58 --ignore-vmlinux::
59 Ignore vmlinux files.
60
61 --itrace::
62 Options for decoding instruction traci
63
64 include::itrace.txt[]
65
66 To disable decoding entirely, use --no
67
68 -m::
69 --modules::
70 Load module symbols. WARNING: use only
71
72 -l::
73 --print-line::
74 Print matching source lines (may be sl
75
76 -P::
77 --full-paths::
78 Don't shorten the displayed pathnames.
79
80 --stdio:: Use the stdio interface.
81
82 --stdio2:: Use the stdio2 interface, non-inter
83
84 --stdio-color=<mode>::
85 'always', 'never' or 'auto', allowing
86 via the command line, in addition to v
87 Use '--stdio-color always' to generate
88 to a pipe or file. Using just '--stdio
89 using 'always'.
90
91 --tui:: Use the TUI interface. Use of --tui re
92 present, as when piping to other comma
93 used. This interfaces starts by center
94 samples, TAB/UNTAB cycles through the
95
96 --gtk:: Use the GTK interface.
97
98 -C::
99 --cpu=<cpu>:: Only report samples for the list
100 be provided as a comma-separated list
101 CPUs are specified with -: 0-2. Defaul
102 CPUs.
103
104 --asm-raw::
105 Show raw instruction encoding of assem
106
107 --show-total-period:: Show a column with the s
108
109 --source::
110 Interleave source code with assembly c
111 disable with --no-source.
112
113 --symfs=<directory>::
114 Look for files with symbols relative t
115
116 -M::
117 --disassembler-style=:: Set disassembler style
118
119 --addr2line=<path>::
120 Path to addr2line binary.
121
122 --objdump=<path>::
123 Path to objdump binary.
124
125 --prefix=PREFIX::
126 --prefix-strip=N::
127 Remove first N entries from source fil
128 and add PREFIX. This allows to display
129 with different file system layout.
130
131 --skip-missing::
132 Skip symbols that cannot be annotated.
133
134 --group::
135 Show event group information together
136
137 --demangle::
138 Demangle symbol names to human readabl
139 disable with --no-demangle.
140
141 --demangle-kernel::
142 Demangle kernel symbol names to human
143
144 --percent-type::
145 Set annotation percent type from follo
146 global-period, local-period, global-
147
148 The local/global keywords set if the p
149 in the scope of the function (local) o
150 The period/hits keywords set the base
151 on - the samples period or the number
152
153 --percent-limit::
154 Do not show functions which have an ov
155 stdio or stdio2 (Default: 0). Note th
156 functions to display, not about lines
157
158 --data-type[=TYPE_NAME]::
159 Display data type annotation instead o
160 samples (if they are memory accessing
161 information. It can take an optional
162 that case it'd show annotation for the
163 all data types it finds.
164
165 --type-stat::
166 Show stats for the data type annotatio
167
168 --skip-empty::
169 Do not display empty (or dummy) events
170
171
172 SEE ALSO
173 --------
174 linkperf:perf-record[1], linkperf:perf-report[
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.