blob: 6f5a498608b292241e93dc9c498e8ce5f6a683cc [file] [log] [blame]
Ingo Molnar8035e422009-06-06 15:19:13 +02001perf-annotate(1)
Arnaldo Carvalho de Melo4778e0e2010-05-05 11:23:27 -03002================
Ingo Molnar8035e422009-06-06 15:19:13 +02003
4NAME
5----
Ingo Molnar0b73da32009-06-06 15:48:52 +02006perf-annotate - Read perf.data (created by perf record) and display annotated code
Ingo Molnar8035e422009-06-06 15:19:13 +02007
8SYNOPSIS
9--------
10[verse]
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -030011'perf annotate' [-i <file> | --input=file] [symbol_name]
Ingo Molnar8035e422009-06-06 15:19:13 +020012
13DESCRIPTION
14-----------
Ingo Molnar0b73da32009-06-06 15:48:52 +020015This 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 +020020
21OPTIONS
22-------
23-i::
24--input=::
25 Input file name. (default: perf.data)
26
Shawn Bohrer1968ad92010-11-30 19:57:09 -060027-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 complain, do it.
37
38-v::
39--verbose::
40 Be more verbose. (Show symbol address, etc)
41
42-D::
43--dump-raw-trace::
44 Dump raw trace in ASCII.
45
46-k::
47--vmlinux=<file>::
48 vmlinux pathname.
49
50-m::
51--modules::
52 Load module symbols. WARNING: use only with -k and LIVE kernel.
53
54-l::
55--print-line::
56 Print matching source lines (may be slow).
57
58-P::
59--full-paths::
60 Don't shorten the displayed pathnames.
61
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -030062--stdio:: Use the stdio interface.
63
64--tui:: Use the TUI interface Use of --tui requires a tty, if one is not
65 present, as when piping to other commands, the stdio interface is
66 used. This interfaces starts by centering on the line with more
Shawn Bohrer1968ad92010-11-30 19:57:09 -060067 samples, TAB/UNTAB cycles through the lines with more samples.
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -030068
Ingo Molnar8035e422009-06-06 15:19:13 +020069SEE ALSO
70--------
Arnaldo Carvalho de Melo8b9e74e2010-08-21 10:38:16 -030071linkperf:perf-record[1], linkperf:perf-report[1]