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       --skip-missing
108           Skip symbols that cannot be annotated.
109
110       --group
111           Show event group information together
112
113       --percent-type
114           Set annotation percent type from following choices: global-period,
115           local-period, global-hits, local-hits
116
117               The local/global keywords set if the percentage is computed
118               in the scope of the function (local) or the whole data (global).
119               The period/hits keywords set the base the percentage is computed
120               on - the samples period or the number of samples (hits).
121

SEE ALSO

123       perf-record(1), perf-report(1)
124
125
126
127perf                              06/03/2019                  PERF-ANNOTATE(1)
Impressum