Commit | Line | Data |
---|---|---|
8035e428 IM |
1 | /* |
2 | * builtin-annotate.c | |
3 | * | |
4 | * Builtin annotate command: Analyze the perf.data input file, | |
5 | * look up and read DSOs and symbol information and display | |
6 | * a histogram of results, along various sorting keys. | |
7 | */ | |
8 | #include "builtin.h" | |
9 | ||
78f7defe | 10 | #include "util/util.h" |
8035e428 | 11 | #include "util/color.h" |
5da50258 | 12 | #include <linux/list.h> |
8035e428 | 13 | #include "util/cache.h" |
43cbcd8a | 14 | #include <linux/rbtree.h> |
8035e428 | 15 | #include "util/symbol.h" |
8035e428 IM |
16 | |
17 | #include "perf.h" | |
8f28827a | 18 | #include "util/debug.h" |
8035e428 | 19 | |
e248de33 ACM |
20 | #include "util/evlist.h" |
21 | #include "util/evsel.h" | |
78f7defe | 22 | #include "util/annotate.h" |
62daacb5 | 23 | #include "util/event.h" |
8035e428 IM |
24 | #include "util/parse-options.h" |
25 | #include "util/parse-events.h" | |
6baa0a5a | 26 | #include "util/thread.h" |
dd68ada2 | 27 | #include "util/sort.h" |
3d1d07ec | 28 | #include "util/hist.h" |
94c744b6 | 29 | #include "util/session.h" |
45694aa7 | 30 | #include "util/tool.h" |
68e94f4e | 31 | #include "arch/common.h" |
8035e428 | 32 | |
5d67be97 AB |
33 | #include <linux/bitmap.h> |
34 | ||
d20deb64 | 35 | struct perf_annotate { |
45694aa7 | 36 | struct perf_tool tool; |
2b676bf0 | 37 | bool force, use_tui, use_stdio, use_gtk; |
7009cc34 ACM |
38 | bool full_paths; |
39 | bool print_line; | |
18c9e5c5 | 40 | bool skip_missing; |
7009cc34 ACM |
41 | const char *sym_hist_filter; |
42 | const char *cpu_list; | |
43 | DECLARE_BITMAP(cpu_bitmap, MAX_NR_CPUS); | |
d20deb64 | 44 | }; |
5d67be97 | 45 | |
d04b35f8 ACM |
46 | static int perf_evsel__add_sample(struct perf_evsel *evsel, |
47 | struct perf_sample *sample, | |
d20deb64 ACM |
48 | struct addr_location *al, |
49 | struct perf_annotate *ann) | |
8035e428 | 50 | { |
628ada0c | 51 | struct hist_entry *he; |
e248de33 | 52 | int ret; |
628ada0c | 53 | |
7009cc34 ACM |
54 | if (ann->sym_hist_filter != NULL && |
55 | (al->sym == NULL || | |
56 | strcmp(ann->sym_hist_filter, al->sym->name) != 0)) { | |
628ada0c ACM |
57 | /* We're only interested in a symbol named sym_hist_filter */ |
58 | if (al->sym != NULL) { | |
59 | rb_erase(&al->sym->rb_node, | |
60 | &al->map->dso->symbols[al->map->type]); | |
61 | symbol__delete(al->sym); | |
62 | } | |
63 | return 0; | |
64 | } | |
65 | ||
e248de33 | 66 | he = __hists__add_entry(&evsel->hists, al, NULL, 1); |
9735abf1 | 67 | if (he == NULL) |
8035e428 | 68 | return -ENOMEM; |
628ada0c | 69 | |
e248de33 | 70 | ret = 0; |
2f525d01 | 71 | if (he->ms.sym != NULL) { |
2f525d01 | 72 | struct annotation *notes = symbol__annotation(he->ms.sym); |
d04b35f8 | 73 | if (notes->src == NULL && symbol__alloc_hist(he->ms.sym) < 0) |
2f525d01 ACM |
74 | return -ENOMEM; |
75 | ||
e248de33 | 76 | ret = hist_entry__inc_addr_samples(he, evsel->idx, al->addr); |
2f525d01 ACM |
77 | } |
78 | ||
e248de33 ACM |
79 | evsel->hists.stats.total_period += sample->period; |
80 | hists__inc_nr_events(&evsel->hists, PERF_RECORD_SAMPLE); | |
81 | return ret; | |
8035e428 IM |
82 | } |
83 | ||
45694aa7 | 84 | static int process_sample_event(struct perf_tool *tool, |
d20deb64 | 85 | union perf_event *event, |
8115d60c | 86 | struct perf_sample *sample, |
9e69c210 | 87 | struct perf_evsel *evsel, |
743eb868 | 88 | struct machine *machine) |
8035e428 | 89 | { |
45694aa7 | 90 | struct perf_annotate *ann = container_of(tool, struct perf_annotate, tool); |
1ed091c4 | 91 | struct addr_location al; |
6baa0a5a | 92 | |
743eb868 | 93 | if (perf_event__preprocess_sample(event, machine, &al, sample, |
ce6f4fab | 94 | symbol__annotate_init) < 0) { |
29a9f66d ACM |
95 | pr_warning("problem processing %d event, skipping it.\n", |
96 | event->header.type); | |
8035e428 IM |
97 | return -1; |
98 | } | |
99 | ||
7009cc34 | 100 | if (ann->cpu_list && !test_bit(sample->cpu, ann->cpu_bitmap)) |
5d67be97 AB |
101 | return 0; |
102 | ||
d20deb64 | 103 | if (!al.filtered && perf_evsel__add_sample(evsel, sample, &al, ann)) { |
29a9f66d ACM |
104 | pr_warning("problem incrementing symbol count, " |
105 | "skipping event\n"); | |
ec218fc4 | 106 | return -1; |
8035e428 | 107 | } |
8035e428 IM |
108 | |
109 | return 0; | |
110 | } | |
111 | ||
d20deb64 ACM |
112 | static int hist_entry__tty_annotate(struct hist_entry *he, int evidx, |
113 | struct perf_annotate *ann) | |
0b73da3f | 114 | { |
2f525d01 | 115 | return symbol__tty_annotate(he->ms.sym, he->ms.map, evidx, |
7009cc34 | 116 | ann->print_line, ann->full_paths, 0, 0); |
0b73da3f IM |
117 | } |
118 | ||
d20deb64 ACM |
119 | static void hists__find_annotations(struct hists *self, int evidx, |
120 | struct perf_annotate *ann) | |
0b73da3f | 121 | { |
b50e003d | 122 | struct rb_node *nd = rb_first(&self->entries), *next; |
cf958003 | 123 | int key = K_RIGHT; |
0b73da3f | 124 | |
46e3e055 | 125 | while (nd) { |
ed52ce2e | 126 | struct hist_entry *he = rb_entry(nd, struct hist_entry, rb_node); |
78f7defe | 127 | struct annotation *notes; |
0b73da3f | 128 | |
46e3e055 ACM |
129 | if (he->ms.sym == NULL || he->ms.map->dso->annotate_warned) |
130 | goto find_next; | |
0b73da3f | 131 | |
78f7defe | 132 | notes = symbol__annotation(he->ms.sym); |
ce6f4fab | 133 | if (notes->src == NULL) { |
46e3e055 | 134 | find_next: |
cf958003 | 135 | if (key == K_LEFT) |
46e3e055 ACM |
136 | nd = rb_prev(nd); |
137 | else | |
138 | nd = rb_next(nd); | |
e4204992 | 139 | continue; |
46e3e055 | 140 | } |
e4204992 | 141 | |
2b676bf0 | 142 | if (use_browser == 2) { |
18c9e5c5 NK |
143 | int ret; |
144 | ||
145 | ret = hist_entry__gtk_annotate(he, evidx, NULL); | |
146 | if (!ret || !ann->skip_missing) | |
147 | return; | |
148 | ||
149 | /* skip missing symbols */ | |
150 | nd = rb_next(nd); | |
2b676bf0 | 151 | } else if (use_browser == 1) { |
9783adf7 | 152 | key = hist_entry__tui_annotate(he, evidx, NULL); |
46e3e055 | 153 | switch (key) { |
18c9e5c5 NK |
154 | case -1: |
155 | if (!ann->skip_missing) | |
156 | return; | |
157 | /* fall through */ | |
cf958003 | 158 | case K_RIGHT: |
b50e003d | 159 | next = rb_next(nd); |
46e3e055 | 160 | break; |
cf958003 | 161 | case K_LEFT: |
b50e003d | 162 | next = rb_prev(nd); |
46e3e055 | 163 | break; |
b50e003d ACM |
164 | default: |
165 | return; | |
46e3e055 | 166 | } |
b50e003d ACM |
167 | |
168 | if (next != NULL) | |
169 | nd = next; | |
46e3e055 | 170 | } else { |
d20deb64 | 171 | hist_entry__tty_annotate(he, evidx, ann); |
46e3e055 ACM |
172 | nd = rb_next(nd); |
173 | /* | |
174 | * Since we have a hist_entry per IP for the same | |
ce6f4fab | 175 | * symbol, free he->ms.sym->src to signal we already |
46e3e055 ACM |
176 | * processed this symbol. |
177 | */ | |
ce6f4fab ACM |
178 | free(notes->src); |
179 | notes->src = NULL; | |
46e3e055 | 180 | } |
0b73da3f | 181 | } |
0b73da3f IM |
182 | } |
183 | ||
d20deb64 | 184 | static int __cmd_annotate(struct perf_annotate *ann) |
8035e428 | 185 | { |
bab81b62 | 186 | int ret; |
75be6cf4 | 187 | struct perf_session *session; |
e248de33 ACM |
188 | struct perf_evsel *pos; |
189 | u64 total_nr_samples; | |
8035e428 | 190 | |
70cb4e96 | 191 | session = perf_session__new(input_name, O_RDONLY, |
45694aa7 | 192 | ann->force, false, &ann->tool); |
94c744b6 ACM |
193 | if (session == NULL) |
194 | return -ENOMEM; | |
195 | ||
7009cc34 ACM |
196 | if (ann->cpu_list) { |
197 | ret = perf_session__cpu_bitmap(session, ann->cpu_list, | |
198 | ann->cpu_bitmap); | |
5d67be97 AB |
199 | if (ret) |
200 | goto out_delete; | |
201 | } | |
202 | ||
68e94f4e IT |
203 | if (!objdump_path) { |
204 | ret = perf_session_env__lookup_objdump(&session->header.env); | |
205 | if (ret) | |
206 | goto out_delete; | |
207 | } | |
208 | ||
45694aa7 | 209 | ret = perf_session__process_events(session, &ann->tool); |
bab81b62 | 210 | if (ret) |
94c744b6 | 211 | goto out_delete; |
8035e428 | 212 | |
62daacb5 | 213 | if (dump_trace) { |
c8446b9b | 214 | perf_session__fprintf_nr_events(session, stdout); |
94c744b6 | 215 | goto out_delete; |
62daacb5 | 216 | } |
8035e428 | 217 | |
da21d1b5 | 218 | if (verbose > 3) |
b3165f41 | 219 | perf_session__fprintf(session, stdout); |
8035e428 | 220 | |
da21d1b5 | 221 | if (verbose > 2) |
cbf69680 | 222 | perf_session__fprintf_dsos(session, stdout); |
8035e428 | 223 | |
e248de33 ACM |
224 | total_nr_samples = 0; |
225 | list_for_each_entry(pos, &session->evlist->entries, node) { | |
226 | struct hists *hists = &pos->hists; | |
227 | u32 nr_samples = hists->stats.nr_events[PERF_RECORD_SAMPLE]; | |
228 | ||
229 | if (nr_samples > 0) { | |
230 | total_nr_samples += nr_samples; | |
231 | hists__collapse_resort(hists); | |
232 | hists__output_resort(hists); | |
d20deb64 | 233 | hists__find_annotations(hists, pos->idx, ann); |
e248de33 ACM |
234 | } |
235 | } | |
8035e428 | 236 | |
e248de33 | 237 | if (total_nr_samples == 0) { |
3780f488 | 238 | ui__error("The %s file has no samples!\n", session->filename); |
e248de33 ACM |
239 | goto out_delete; |
240 | } | |
7a60ba94 NK |
241 | |
242 | if (use_browser == 2) | |
243 | perf_gtk__show_annotations(); | |
244 | ||
e248de33 ACM |
245 | out_delete: |
246 | /* | |
247 | * Speed up the exit process, for large files this can | |
248 | * take quite a while. | |
249 | * | |
250 | * XXX Enable this when using valgrind or if we ever | |
251 | * librarize this command. | |
252 | * | |
253 | * Also experiment with obstacks to see how much speed | |
254 | * up we'll get here. | |
255 | * | |
256 | * perf_session__delete(session); | |
257 | */ | |
bab81b62 | 258 | return ret; |
8035e428 IM |
259 | } |
260 | ||
261 | static const char * const annotate_usage[] = { | |
99345254 | 262 | "perf annotate [<options>]", |
8035e428 IM |
263 | NULL |
264 | }; | |
265 | ||
1d037ca1 | 266 | int cmd_annotate(int argc, const char **argv, const char *prefix __maybe_unused) |
d20deb64 ACM |
267 | { |
268 | struct perf_annotate annotate = { | |
45694aa7 | 269 | .tool = { |
d20deb64 ACM |
270 | .sample = process_sample_event, |
271 | .mmap = perf_event__process_mmap, | |
272 | .comm = perf_event__process_comm, | |
ec4622f5 | 273 | .exit = perf_event__process_exit, |
f62d3f0f | 274 | .fork = perf_event__process_fork, |
d20deb64 ACM |
275 | .ordered_samples = true, |
276 | .ordering_requires_timestamps = true, | |
277 | }, | |
d20deb64 ACM |
278 | }; |
279 | const struct option options[] = { | |
70cb4e96 | 280 | OPT_STRING('i', "input", &input_name, "file", |
8035e428 | 281 | "input file name"), |
ac73c5a9 ACM |
282 | OPT_STRING('d', "dsos", &symbol_conf.dso_list_str, "dso[,dso...]", |
283 | "only consider symbols in these dsos"), | |
7009cc34 | 284 | OPT_STRING('s', "symbol", &annotate.sym_hist_filter, "symbol", |
0b73da3f | 285 | "symbol to annotate"), |
7009cc34 | 286 | OPT_BOOLEAN('f', "force", &annotate.force, "don't complain, do it"), |
c0555642 | 287 | OPT_INCR('v', "verbose", &verbose, |
8035e428 IM |
288 | "be more verbose (show symbol address, etc)"), |
289 | OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace, | |
290 | "dump raw trace in ASCII"), | |
2b676bf0 | 291 | OPT_BOOLEAN(0, "gtk", &annotate.use_gtk, "Use the GTK interface"), |
7009cc34 ACM |
292 | OPT_BOOLEAN(0, "tui", &annotate.use_tui, "Use the TUI interface"), |
293 | OPT_BOOLEAN(0, "stdio", &annotate.use_stdio, "Use the stdio interface"), | |
b32d133a ACM |
294 | OPT_STRING('k', "vmlinux", &symbol_conf.vmlinux_name, |
295 | "file", "vmlinux pathname"), | |
296 | OPT_BOOLEAN('m', "modules", &symbol_conf.use_modules, | |
42976487 | 297 | "load module symbols - WARNING: use only with -k and LIVE kernel"), |
7009cc34 | 298 | OPT_BOOLEAN('l', "print-line", &annotate.print_line, |
301406b9 | 299 | "print matching source lines (may be slow)"), |
7009cc34 | 300 | OPT_BOOLEAN('P', "full-paths", &annotate.full_paths, |
42976487 | 301 | "Don't shorten the displayed pathnames"), |
18c9e5c5 NK |
302 | OPT_BOOLEAN(0, "skip-missing", &annotate.skip_missing, |
303 | "Skip symbols that cannot be annotated"), | |
c8e66720 | 304 | OPT_STRING('C', "cpu", &annotate.cpu_list, "cpu", "list of cpus to profile"), |
e71a0598 SE |
305 | OPT_STRING(0, "symfs", &symbol_conf.symfs, "directory", |
306 | "Look for files with symbols relative to this directory"), | |
64c6f0c7 | 307 | OPT_BOOLEAN(0, "source", &symbol_conf.annotate_src, |
3e6a2a7f | 308 | "Interleave source code with assembly code (default)"), |
64c6f0c7 | 309 | OPT_BOOLEAN(0, "asm-raw", &symbol_conf.annotate_asm_raw, |
3e6a2a7f | 310 | "Display raw encoding of assembly instructions (default)"), |
f69b64f7 AK |
311 | OPT_STRING('M', "disassembler-style", &disassembler_style, "disassembler style", |
312 | "Specify disassembler style (e.g. -M intel for intel syntax)"), | |
7a4ec938 MB |
313 | OPT_STRING(0, "objdump", &objdump_path, "path", |
314 | "objdump binary to use for disassembly and annotations"), | |
8035e428 | 315 | OPT_END() |
d20deb64 | 316 | }; |
8035e428 | 317 | |
655000e7 ACM |
318 | argc = parse_options(argc, argv, options, annotate_usage, 0); |
319 | ||
7009cc34 | 320 | if (annotate.use_stdio) |
8b9e74eb | 321 | use_browser = 0; |
7009cc34 | 322 | else if (annotate.use_tui) |
8b9e74eb | 323 | use_browser = 1; |
2b676bf0 NK |
324 | else if (annotate.use_gtk) |
325 | use_browser = 2; | |
8b9e74eb | 326 | |
229ade9b | 327 | setup_browser(true); |
46e3e055 | 328 | |
78f7defe | 329 | symbol_conf.priv_size = sizeof(struct annotation); |
75be6cf4 ACM |
330 | symbol_conf.try_vmlinux_path = true; |
331 | ||
332 | if (symbol__init() < 0) | |
b32d133a | 333 | return -1; |
8035e428 | 334 | |
55309985 NK |
335 | if (setup_sorting() < 0) |
336 | usage_with_options(annotate_usage, options); | |
8035e428 | 337 | |
0b73da3f IM |
338 | if (argc) { |
339 | /* | |
340 | * Special case: if there's an argument left then assume tha | |
341 | * it's a symbol filter: | |
342 | */ | |
343 | if (argc > 1) | |
344 | usage_with_options(annotate_usage, options); | |
345 | ||
7009cc34 | 346 | annotate.sym_hist_filter = argv[0]; |
0b73da3f IM |
347 | } |
348 | ||
d20deb64 | 349 | return __cmd_annotate(&annotate); |
8035e428 | 350 | } |