Commit | Line | Data |
---|---|---|
8035e428 | 1 | perf-annotate(1) |
4778e0e8 | 2 | ================ |
8035e428 IM |
3 | |
4 | NAME | |
5 | ---- | |
0b73da3f | 6 | perf-annotate - Read perf.data (created by perf record) and display annotated code |
8035e428 IM |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
10 | [verse] | |
8b9e74eb | 11 | 'perf annotate' [-i <file> | --input=file] [symbol_name] |
8035e428 IM |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
0b73da3f IM |
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. | |
8035e428 IM |
20 | |
21 | OPTIONS | |
22 | ------- | |
23 | -i:: | |
24 | --input=:: | |
efad1415 | 25 | Input file name. (default: perf.data unless stdin is a fifo) |
8035e428 | 26 | |
1968ad91 SB |
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:: | |
e0be62cc | 36 | Don't do ownership validation. |
1968ad91 SB |
37 | |
38 | -v:: | |
39 | --verbose:: | |
40 | Be more verbose. (Show symbol address, etc) | |
41 | ||
eddaef88 NK |
42 | -q:: |
43 | --quiet:: | |
44 | Do not show any message. (Suppress -v) | |
45 | ||
1968ad91 SB |
46 | -D:: |
47 | --dump-raw-trace:: | |
48 | Dump raw trace in ASCII. | |
49 | ||
50 | -k:: | |
51 | --vmlinux=<file>:: | |
52 | vmlinux pathname. | |
53 | ||
54 | -m:: | |
55 | --modules:: | |
56 | Load module symbols. WARNING: use only with -k and LIVE kernel. | |
57 | ||
58 | -l:: | |
59 | --print-line:: | |
60 | Print matching source lines (may be slow). | |
61 | ||
62 | -P:: | |
63 | --full-paths:: | |
64 | Don't shorten the displayed pathnames. | |
65 | ||
8b9e74eb ACM |
66 | --stdio:: Use the stdio interface. |
67 | ||
53fe4ba1 ACM |
68 | --stdio-color:: |
69 | 'always', 'never' or 'auto', allowing configuring color output | |
70 | via the command line, in addition to via "color.ui" .perfconfig. | |
71 | Use '--stdio-color always' to generate color even when redirecting | |
72 | to a pipe or file. Using just '--stdio-color' is equivalent to | |
73 | using 'always'. | |
74 | ||
2b676bf0 | 75 | --tui:: Use the TUI interface. Use of --tui requires a tty, if one is not |
8b9e74eb ACM |
76 | present, as when piping to other commands, the stdio interface is |
77 | used. This interfaces starts by centering on the line with more | |
1968ad91 | 78 | samples, TAB/UNTAB cycles through the lines with more samples. |
8b9e74eb | 79 | |
2b676bf0 NK |
80 | --gtk:: Use the GTK interface. |
81 | ||
c8e66720 | 82 | -C:: |
5d67be97 AB |
83 | --cpu:: Only report samples for the list of CPUs provided. Multiple CPUs can |
84 | be provided as a comma-separated list with no space: 0,1. Ranges of | |
85 | CPUs are specified with -: 0-2. Default is to report samples on all | |
86 | CPUs. | |
87 | ||
3e6a2a7f | 88 | --asm-raw:: |
64c6f0c7 | 89 | Show raw instruction encoding of assembly instructions. |
3e6a2a7f SE |
90 | |
91 | --source:: | |
92 | Interleave source code with assembly code. Enabled by default, | |
93 | disable with --no-source. | |
94 | ||
e71a0598 SE |
95 | --symfs=<directory>:: |
96 | Look for files with symbols relative to this directory. | |
97 | ||
f69b64f7 AK |
98 | -M:: |
99 | --disassembler-style=:: Set disassembler style for objdump. | |
100 | ||
7a4ec938 MB |
101 | --objdump=<path>:: |
102 | Path to objdump binary. | |
103 | ||
18c9e5c5 NK |
104 | --skip-missing:: |
105 | Skip symbols that cannot be annotated. | |
106 | ||
b1dd4432 NK |
107 | --group:: |
108 | Show event group information together | |
109 | ||
8035e428 IM |
110 | SEE ALSO |
111 | -------- | |
8b9e74eb | 112 | linkperf:perf-record[1], linkperf:perf-report[1] |