perf/Documentation/perf-annotate.txt

1 perf-annotate(1)
5 ----
6 perf-annotate - Read perf.data (created by perf record) and display annotated code
9 --------
11 'perf annotate' [-i <file> | --input=file] [symbol_name]
14 -----------
22 -------
23 -i::
24 --input=<file>::
27 -d::
28 --dsos=<dso[,dso...]>::
30 -s::
31 --symbol=<symbol>::
34 -f::
35 --force::
38 -v::
39 --verbose::
42 -q::
43 --quiet::
44 	Do not show any warnings or messages.  (Suppress -v)
46 -n::
47 --show-nr-samples::
50 -D::
51 --dump-raw-trace::
54 -k::
55 --vmlinux=<file>::
58 --ignore-vmlinux::
61 --itrace::
66 	To disable decoding entirely, use --no-itrace.
68 -m::
69 --modules::
70         Load module symbols. WARNING: use only with -k and LIVE kernel.
72 -l::
73 --print-line::
76 -P::
77 --full-paths::
80 --stdio:: Use the stdio interface.
82 --stdio2:: Use the stdio2 interface, non-interactive, uses the TUI formatting.
84 --stdio-color=<mode>::
87 	Use '--stdio-color always' to generate color even when redirecting
88 	to a pipe or file. Using just '--stdio-color' is equivalent to
91 --tui:: Use the TUI interface. Use of --tui requires a tty, if one is not
96 --gtk:: Use the GTK interface.
98 -C::
99 --cpu=<cpu>:: Only report samples for the list of CPUs provided. Multiple CPUs can
100 	be provided as a comma-separated list with no space: 0,1. Ranges of
101 	CPUs are specified with -: 0-2. Default is to report samples on all
104 --asm-raw::
107 --show-total-period:: Show a column with the sum of periods.
109 --source::
110 	Interleave source code with assembly code. Enabled by default,
111 	disable with --no-source.
113 --symfs=<directory>::
116 -M::
117 --disassembler-style=:: Set disassembler style for objdump.
119 --addr2line=<path>::
122 --objdump=<path>::
125 --prefix=PREFIX::
126 --prefix-strip=N::
131 --skip-missing::
134 --group::
137 --demangle::
139 	disable with --no-demangle.
141 --demangle-kernel::
144 --percent-type::
146 	  global-period, local-period, global-hits, local-hits
151 	on - the samples period or the number of samples (hits).
153 --percent-limit::
158 --data-type[=TYPE_NAME]::
165 --type-stat::
168 --skip-empty::
173 --------
174 linkperf:perf-record[1], linkperf:perf-report[1]