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=:: | |
25 | Input file name. (default: perf.data) | |
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:: | |
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 | ||
8b9e74eb ACM |
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 | |
1968ad91 | 67 | samples, TAB/UNTAB cycles through the lines with more samples. |
8b9e74eb | 68 | |
8035e428 IM |
69 | SEE ALSO |
70 | -------- | |
8b9e74eb | 71 | linkperf:perf-record[1], linkperf:perf-report[1] |