Gitiles
Code Review Sign In
LeafOS / LeafOS-Devices / android_kernel_samsung_gta4xl / dbf57fd1e05efc0d37503af5f08a532aff2c9823 / . / tools / perf / Documentation / perf-annotate.txt
blob: c635eab6af5409ddb6b19d249084a79aa825acf2 [file] [log] [blame]
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]1perf-annotate(1)
Arnaldo Carvalho de Melo4778e0e2010-05-05 11:23:27 -0300[diff] [blame]2================
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]3
4NAME
5----
Ingo Molnar0b73da32009-06-06 15:48:52 +0200[diff] [blame]6perf-annotate - Read perf.data (created by perf record) and display annotated code
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]7
8SYNOPSIS
9--------
10[verse]
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -0300[diff] [blame]11'perf annotate' [-i <file> | --input=file] [symbol_name]
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]12
13DESCRIPTION
14-----------
Ingo Molnar0b73da32009-06-06 15:48:52 +0200[diff] [blame]15This command reads the input file and displays an annotated version of the
16code. If the object file has debug symbols then the source code will be
17displayed alongside assembly code.
18
19If there is no debug info in the object, then annotated assembly is displayed.
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]20
21OPTIONS
22-------
23-i::
24--input=::
Robert Richterefad1412011-12-07 10:02:54 +0100[diff] [blame]25 Input file name. (default: perf.data unless stdin is a fifo)
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]26
Shawn Bohrer1968ad92010-11-30 19:57:09 -0600[diff] [blame]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::
Jiri Olsae0be62c2016-03-24 13:52:19 +0100[diff] [blame]36 Don't do ownership validation.
Shawn Bohrer1968ad92010-11-30 19:57:09 -0600[diff] [blame]37
38-v::
39--verbose::
40 Be more verbose. (Show symbol address, etc)
41
Namhyung Kimeddaef82017-02-17 17:17:41 +0900[diff] [blame]42-q::
43--quiet::
44 Do not show any message. (Suppress -v)
45
Taeung Song1ac39372017-08-18 17:46:48 +0900[diff] [blame]46-n::
47--show-nr-samples::
48 Show the number of samples for each symbol
49
Shawn Bohrer1968ad92010-11-30 19:57:09 -0600[diff] [blame]50-D::
51--dump-raw-trace::
52 Dump raw trace in ASCII.
53
54-k::
55--vmlinux=<file>::
56 vmlinux pathname.
57
58-m::
59--modules::
60 Load module symbols. WARNING: use only with -k and LIVE kernel.
61
62-l::
63--print-line::
64 Print matching source lines (may be slow).
65
66-P::
67--full-paths::
68 Don't shorten the displayed pathnames.
69
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -0300[diff] [blame]70--stdio:: Use the stdio interface.
71
Arnaldo Carvalho de Melo53fe4ba2016-07-05 11:08:17 -0300[diff] [blame]72--stdio-color::
73 'always', 'never' or 'auto', allowing configuring color output
74 via the command line, in addition to via "color.ui" .perfconfig.
75 Use '--stdio-color always' to generate color even when redirecting
76 to a pipe or file. Using just '--stdio-color' is equivalent to
77 using 'always'.
78
Namhyung Kim2b676bf2013-02-07 18:02:08 +0900[diff] [blame]79--tui:: Use the TUI interface. Use of --tui requires a tty, if one is not
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -0300[diff] [blame]80 present, as when piping to other commands, the stdio interface is
81 used. This interfaces starts by centering on the line with more
Shawn Bohrer1968ad92010-11-30 19:57:09 -0600[diff] [blame]82 samples, TAB/UNTAB cycles through the lines with more samples.
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -0300[diff] [blame]83
Namhyung Kim2b676bf2013-02-07 18:02:08 +0900[diff] [blame]84--gtk:: Use the GTK interface.
85
David Ahernc8e66722011-11-13 11:30:08 -0700[diff] [blame]86-C::
Anton Blanchard5d67be92011-07-04 21:57:50 +1000[diff] [blame]87--cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can
88 be provided as a comma-separated list with no space: 0,1. Ranges of
89 CPUs are specified with -: 0-2. Default is to report samples on all
90 CPUs.
91
Stephane Eranian3e6a2a72011-05-17 17:32:07 +0200[diff] [blame]92--asm-raw::
Arnaldo Carvalho de Melo64c6f0c2011-10-06 12:48:31 -0300[diff] [blame]93 Show raw instruction encoding of assembly instructions.
Stephane Eranian3e6a2a72011-05-17 17:32:07 +0200[diff] [blame]94
Taeung Song01c85622017-08-18 17:46:53 +0900[diff] [blame]95--show-total-period:: Show a column with the sum of periods.
96
Stephane Eranian3e6a2a72011-05-17 17:32:07 +0200[diff] [blame]97--source::
98 Interleave source code with assembly code. Enabled by default,
99 disable with --no-source.
100
Stephane Eraniane71a0592011-07-30 01:20:40 +0200[diff] [blame]101--symfs=<directory>::
102 Look for files with symbols relative to this directory.
103
Andi Kleenf69b64f2011-09-15 14:31:41 -0700[diff] [blame]104-M::
105--disassembler-style=:: Set disassembler style for objdump.
106
Maciek Borzecki7a4ec932012-09-04 12:32:30 +0200[diff] [blame]107--objdump=<path>::
108 Path to objdump binary.
109
Namhyung Kim18c9e5c2013-02-07 18:02:14 +0900[diff] [blame]110--skip-missing::
111 Skip symbols that cannot be annotated.
112
Namhyung Kimb1dd4432013-03-05 14:53:25 +0900[diff] [blame]113--group::
114 Show event group information together
115
Ingo Molnar8035e422009-06-06 15:19:13 +0200[diff] [blame]116SEE ALSO
117--------
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -0300[diff] [blame]118linkperf:perf-record[1], linkperf:perf-report[1]