← Back to branch summary

~ubuntu-branches/ubuntu/precise/linux-lowlatency/precise

« back to all changes in this revision

Viewing changes to tools/perf/Documentation/perf-annotate.txt

  • Committer: Package Import Robot
  • Author(s): Alessio Igor Bogani
  • Date: 2011-10-26 11:13:05 UTC
  • Revision ID: package-import@ubuntu.com-20111026111305-tz023xykf0i6eosh
Tags: upstream-3.2.0
Import upstream version 3.2.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/perf/Documentation/perf-annotate.txt
 
1
perf-annotate(1)
 
2
================
 
3
 
 
4
NAME
 
5
----
 
6
perf-annotate - Read perf.data (created by perf record) and display annotated code
 
7
 
 
8
SYNOPSIS
 
9
--------
 
10
[verse]
 
11
'perf annotate' [-i <file> | --input=file] [symbol_name]
 
12
 
 
13
DESCRIPTION
 
14
-----------
 
15
This command reads the input file and displays an annotated version of the
 
16
code. If the object file has debug symbols then the source code will be
 
17
displayed alongside assembly code.
 
18
 
 
19
If there is no debug info in the object, then annotated assembly is displayed.
 
20
 
 
21
OPTIONS
 
22
-------
 
23
-i::
 
24
--input=::
 
25
        Input file name. (default: perf.data)
 
26
 
 
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::
 
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
 
 
62
--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
 
67
        samples, TAB/UNTAB cycles through the lines with more samples.
 
68
 
 
69
-c::
 
70
--cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can
 
71
        be provided as a comma-separated list with no space: 0,1. Ranges of
 
72
        CPUs are specified with -: 0-2. Default is to report samples on all
 
73
        CPUs.
 
74
 
 
75
--asm-raw::
 
76
        Show raw instruction encoding of assembly instructions.
 
77
 
 
78
--source::
 
79
        Interleave source code with assembly code. Enabled by default,
 
80
        disable with --no-source.
 
81
 
 
82
--symfs=<directory>::
 
83
        Look for files with symbols relative to this directory.
 
84
 
 
85
-M::
 
86
--disassembler-style=:: Set disassembler style for objdump.
 
87
 
 
88
SEE ALSO
 
89
--------
 
90
linkperf:perf-record[1], linkperf:perf-report[1]