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=
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 complain, do it.
32
33       -v, --verbose
34           Be more verbose. (Show symbol address, etc)
35
36       -D, --dump-raw-trace
37           Dump raw trace in ASCII.
38
39       -k, --vmlinux=<file>
40           vmlinux pathname.
41
42       -m, --modules
43           Load module symbols. WARNING: use only with -k and LIVE kernel.
44
45       -l, --print-line
46           Print matching source lines (may be slow).
47
48       -P, --full-paths
49           Don’t shorten the displayed pathnames.
50
51       --stdio
52           Use the stdio interface.
53
54       --tui
55           Use the TUI interface. Use of --tui requires a tty, if one is not
56           present, as when piping to other commands, the stdio interface is
57           used. This interfaces starts by centering on the line with more
58           samples, TAB/UNTAB cycles through the lines with more samples.
59
60       --gtk
61           Use the GTK interface.
62
63       -C, --cpu
64           Only report samples for the list of CPUs provided. Multiple CPUs
65           can be provided as a comma-separated list with no space: 0,1.
66           Ranges of CPUs are specified with -: 0-2. Default is to report
67           samples on all CPUs.
68
69       --asm-raw
70           Show raw instruction encoding of assembly instructions.
71
72       --source
73           Interleave source code with assembly code. Enabled by default,
74           disable with --no-source.
75
76       --symfs=<directory>
77           Look for files with symbols relative to this directory.
78
79       -M, --disassembler-style=
80           Set disassembler style for objdump.
81
82       --objdump=<path>
83           Path to objdump binary.
84
85       --skip-missing
86           Skip symbols that cannot be annotated.
87
88       --group
89           Show event group information together
90

SEE ALSO

92       perf-record(1), perf-report(1)
93
94
95
96perf                              06/18/2019                  PERF-ANNOTATE(1)
Impressum