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 | ||
10 | #include "util/util.h" | |
11 | ||
78f7defe | 12 | #include "util/util.h" |
8035e428 | 13 | #include "util/color.h" |
5da50258 | 14 | #include <linux/list.h> |
8035e428 | 15 | #include "util/cache.h" |
43cbcd8a | 16 | #include <linux/rbtree.h> |
8035e428 | 17 | #include "util/symbol.h" |
8035e428 IM |
18 | |
19 | #include "perf.h" | |
8f28827a | 20 | #include "util/debug.h" |
8035e428 | 21 | |
e248de33 ACM |
22 | #include "util/evlist.h" |
23 | #include "util/evsel.h" | |
78f7defe | 24 | #include "util/annotate.h" |
62daacb5 | 25 | #include "util/event.h" |
8035e428 IM |
26 | #include "util/parse-options.h" |
27 | #include "util/parse-events.h" | |
6baa0a5a | 28 | #include "util/thread.h" |
dd68ada2 | 29 | #include "util/sort.h" |
3d1d07ec | 30 | #include "util/hist.h" |
94c744b6 | 31 | #include "util/session.h" |
8035e428 | 32 | |
8035e428 | 33 | static char const *input_name = "perf.data"; |
8035e428 | 34 | |
8b9e74eb | 35 | static bool force, use_tui, use_stdio; |
8035e428 | 36 | |
c0555642 | 37 | static bool full_paths; |
42976487 | 38 | |
c0555642 | 39 | static bool print_line; |
301406b9 | 40 | |
e4204992 ACM |
41 | static const char *sym_hist_filter; |
42 | ||
e248de33 ACM |
43 | static int perf_evlist__add_sample(struct perf_evlist *evlist, |
44 | struct perf_sample *sample, | |
9e69c210 | 45 | struct perf_evsel *evsel, |
e248de33 | 46 | struct addr_location *al) |
8035e428 | 47 | { |
628ada0c | 48 | struct hist_entry *he; |
e248de33 | 49 | int ret; |
628ada0c ACM |
50 | |
51 | if (sym_hist_filter != NULL && | |
52 | (al->sym == NULL || strcmp(sym_hist_filter, al->sym->name) != 0)) { | |
53 | /* We're only interested in a symbol named sym_hist_filter */ | |
54 | if (al->sym != NULL) { | |
55 | rb_erase(&al->sym->rb_node, | |
56 | &al->map->dso->symbols[al->map->type]); | |
57 | symbol__delete(al->sym); | |
58 | } | |
59 | return 0; | |
60 | } | |
61 | ||
e248de33 | 62 | he = __hists__add_entry(&evsel->hists, al, NULL, 1); |
9735abf1 | 63 | if (he == NULL) |
8035e428 | 64 | return -ENOMEM; |
628ada0c | 65 | |
e248de33 | 66 | ret = 0; |
2f525d01 | 67 | if (he->ms.sym != NULL) { |
2f525d01 | 68 | struct annotation *notes = symbol__annotation(he->ms.sym); |
ce6f4fab | 69 | if (notes->src == NULL && |
e248de33 | 70 | symbol__alloc_hist(he->ms.sym, evlist->nr_entries) < 0) |
2f525d01 ACM |
71 | return -ENOMEM; |
72 | ||
e248de33 | 73 | ret = hist_entry__inc_addr_samples(he, evsel->idx, al->addr); |
2f525d01 ACM |
74 | } |
75 | ||
e248de33 ACM |
76 | evsel->hists.stats.total_period += sample->period; |
77 | hists__inc_nr_events(&evsel->hists, PERF_RECORD_SAMPLE); | |
78 | return ret; | |
8035e428 IM |
79 | } |
80 | ||
8115d60c ACM |
81 | static int process_sample_event(union perf_event *event, |
82 | struct perf_sample *sample, | |
9e69c210 | 83 | struct perf_evsel *evsel, |
640c03ce | 84 | struct perf_session *session) |
8035e428 | 85 | { |
1ed091c4 | 86 | struct addr_location al; |
6baa0a5a | 87 | |
ce6f4fab ACM |
88 | if (perf_event__preprocess_sample(event, session, &al, sample, |
89 | symbol__annotate_init) < 0) { | |
29a9f66d ACM |
90 | pr_warning("problem processing %d event, skipping it.\n", |
91 | event->header.type); | |
8035e428 IM |
92 | return -1; |
93 | } | |
94 | ||
9e69c210 ACM |
95 | if (!al.filtered && |
96 | perf_evlist__add_sample(session->evlist, sample, evsel, &al)) { | |
29a9f66d ACM |
97 | pr_warning("problem incrementing symbol count, " |
98 | "skipping event\n"); | |
ec218fc4 | 99 | return -1; |
8035e428 | 100 | } |
8035e428 IM |
101 | |
102 | return 0; | |
103 | } | |
104 | ||
2f525d01 | 105 | static int hist_entry__tty_annotate(struct hist_entry *he, int evidx) |
0b73da3f | 106 | { |
2f525d01 | 107 | return symbol__tty_annotate(he->ms.sym, he->ms.map, evidx, |
d040bd36 | 108 | print_line, full_paths, 0, 0); |
0b73da3f IM |
109 | } |
110 | ||
e248de33 | 111 | static void hists__find_annotations(struct hists *self, int evidx) |
0b73da3f | 112 | { |
b50e003d | 113 | struct rb_node *nd = rb_first(&self->entries), *next; |
46e3e055 | 114 | int key = KEY_RIGHT; |
0b73da3f | 115 | |
46e3e055 | 116 | while (nd) { |
ed52ce2e | 117 | struct hist_entry *he = rb_entry(nd, struct hist_entry, rb_node); |
78f7defe | 118 | struct annotation *notes; |
0b73da3f | 119 | |
46e3e055 ACM |
120 | if (he->ms.sym == NULL || he->ms.map->dso->annotate_warned) |
121 | goto find_next; | |
0b73da3f | 122 | |
78f7defe | 123 | notes = symbol__annotation(he->ms.sym); |
ce6f4fab | 124 | if (notes->src == NULL) { |
46e3e055 ACM |
125 | find_next: |
126 | if (key == KEY_LEFT) | |
127 | nd = rb_prev(nd); | |
128 | else | |
129 | nd = rb_next(nd); | |
e4204992 | 130 | continue; |
46e3e055 | 131 | } |
e4204992 | 132 | |
62e3436b | 133 | if (use_browser > 0) { |
e248de33 | 134 | key = hist_entry__tui_annotate(he, evidx); |
46e3e055 ACM |
135 | switch (key) { |
136 | case KEY_RIGHT: | |
b50e003d | 137 | next = rb_next(nd); |
46e3e055 ACM |
138 | break; |
139 | case KEY_LEFT: | |
b50e003d | 140 | next = rb_prev(nd); |
46e3e055 | 141 | break; |
b50e003d ACM |
142 | default: |
143 | return; | |
46e3e055 | 144 | } |
b50e003d ACM |
145 | |
146 | if (next != NULL) | |
147 | nd = next; | |
46e3e055 | 148 | } else { |
e248de33 | 149 | hist_entry__tty_annotate(he, evidx); |
46e3e055 ACM |
150 | nd = rb_next(nd); |
151 | /* | |
152 | * Since we have a hist_entry per IP for the same | |
ce6f4fab | 153 | * symbol, free he->ms.sym->src to signal we already |
46e3e055 ACM |
154 | * processed this symbol. |
155 | */ | |
ce6f4fab ACM |
156 | free(notes->src); |
157 | notes->src = NULL; | |
46e3e055 | 158 | } |
0b73da3f | 159 | } |
0b73da3f IM |
160 | } |
161 | ||
301a0b02 | 162 | static struct perf_event_ops event_ops = { |
55aa640f | 163 | .sample = process_sample_event, |
8115d60c ACM |
164 | .mmap = perf_event__process_mmap, |
165 | .comm = perf_event__process_comm, | |
166 | .fork = perf_event__process_task, | |
eac23d1c IM |
167 | .ordered_samples = true, |
168 | .ordering_requires_timestamps = true, | |
bab81b62 LZ |
169 | }; |
170 | ||
8035e428 IM |
171 | static int __cmd_annotate(void) |
172 | { | |
bab81b62 | 173 | int ret; |
75be6cf4 | 174 | struct perf_session *session; |
e248de33 ACM |
175 | struct perf_evsel *pos; |
176 | u64 total_nr_samples; | |
8035e428 | 177 | |
21ef97f0 | 178 | session = perf_session__new(input_name, O_RDONLY, force, false, &event_ops); |
94c744b6 ACM |
179 | if (session == NULL) |
180 | return -ENOMEM; | |
181 | ||
ec913369 | 182 | ret = perf_session__process_events(session, &event_ops); |
bab81b62 | 183 | if (ret) |
94c744b6 | 184 | goto out_delete; |
8035e428 | 185 | |
62daacb5 | 186 | if (dump_trace) { |
c8446b9b | 187 | perf_session__fprintf_nr_events(session, stdout); |
94c744b6 | 188 | goto out_delete; |
62daacb5 | 189 | } |
8035e428 | 190 | |
da21d1b5 | 191 | if (verbose > 3) |
b3165f41 | 192 | perf_session__fprintf(session, stdout); |
8035e428 | 193 | |
da21d1b5 | 194 | if (verbose > 2) |
cbf69680 | 195 | perf_session__fprintf_dsos(session, stdout); |
8035e428 | 196 | |
e248de33 ACM |
197 | total_nr_samples = 0; |
198 | list_for_each_entry(pos, &session->evlist->entries, node) { | |
199 | struct hists *hists = &pos->hists; | |
200 | u32 nr_samples = hists->stats.nr_events[PERF_RECORD_SAMPLE]; | |
201 | ||
202 | if (nr_samples > 0) { | |
203 | total_nr_samples += nr_samples; | |
204 | hists__collapse_resort(hists); | |
205 | hists__output_resort(hists); | |
206 | hists__find_annotations(hists, pos->idx); | |
207 | } | |
208 | } | |
8035e428 | 209 | |
e248de33 ACM |
210 | if (total_nr_samples == 0) { |
211 | ui__warning("The %s file has no samples!\n", input_name); | |
212 | goto out_delete; | |
213 | } | |
214 | out_delete: | |
215 | /* | |
216 | * Speed up the exit process, for large files this can | |
217 | * take quite a while. | |
218 | * | |
219 | * XXX Enable this when using valgrind or if we ever | |
220 | * librarize this command. | |
221 | * | |
222 | * Also experiment with obstacks to see how much speed | |
223 | * up we'll get here. | |
224 | * | |
225 | * perf_session__delete(session); | |
226 | */ | |
bab81b62 | 227 | return ret; |
8035e428 IM |
228 | } |
229 | ||
230 | static const char * const annotate_usage[] = { | |
231 | "perf annotate [<options>] <command>", | |
232 | NULL | |
233 | }; | |
234 | ||
235 | static const struct option options[] = { | |
236 | OPT_STRING('i', "input", &input_name, "file", | |
237 | "input file name"), | |
ac73c5a9 ACM |
238 | OPT_STRING('d', "dsos", &symbol_conf.dso_list_str, "dso[,dso...]", |
239 | "only consider symbols in these dsos"), | |
23b87116 | 240 | OPT_STRING('s', "symbol", &sym_hist_filter, "symbol", |
0b73da3f | 241 | "symbol to annotate"), |
fa6963b2 | 242 | OPT_BOOLEAN('f', "force", &force, "don't complain, do it"), |
c0555642 | 243 | OPT_INCR('v', "verbose", &verbose, |
8035e428 IM |
244 | "be more verbose (show symbol address, etc)"), |
245 | OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace, | |
246 | "dump raw trace in ASCII"), | |
8b9e74eb ACM |
247 | OPT_BOOLEAN(0, "tui", &use_tui, "Use the TUI interface"), |
248 | OPT_BOOLEAN(0, "stdio", &use_stdio, "Use the stdio interface"), | |
b32d133a ACM |
249 | OPT_STRING('k', "vmlinux", &symbol_conf.vmlinux_name, |
250 | "file", "vmlinux pathname"), | |
251 | OPT_BOOLEAN('m', "modules", &symbol_conf.use_modules, | |
42976487 | 252 | "load module symbols - WARNING: use only with -k and LIVE kernel"), |
301406b9 FW |
253 | OPT_BOOLEAN('l', "print-line", &print_line, |
254 | "print matching source lines (may be slow)"), | |
42976487 MG |
255 | OPT_BOOLEAN('P', "full-paths", &full_paths, |
256 | "Don't shorten the displayed pathnames"), | |
8035e428 IM |
257 | OPT_END() |
258 | }; | |
259 | ||
f37a291c | 260 | int cmd_annotate(int argc, const char **argv, const char *prefix __used) |
8035e428 | 261 | { |
655000e7 ACM |
262 | argc = parse_options(argc, argv, options, annotate_usage, 0); |
263 | ||
8b9e74eb ACM |
264 | if (use_stdio) |
265 | use_browser = 0; | |
266 | else if (use_tui) | |
267 | use_browser = 1; | |
268 | ||
229ade9b | 269 | setup_browser(true); |
46e3e055 | 270 | |
78f7defe | 271 | symbol_conf.priv_size = sizeof(struct annotation); |
75be6cf4 ACM |
272 | symbol_conf.try_vmlinux_path = true; |
273 | ||
274 | if (symbol__init() < 0) | |
b32d133a | 275 | return -1; |
8035e428 | 276 | |
c8829c7a | 277 | setup_sorting(annotate_usage, options); |
8035e428 | 278 | |
0b73da3f IM |
279 | if (argc) { |
280 | /* | |
281 | * Special case: if there's an argument left then assume tha | |
282 | * it's a symbol filter: | |
283 | */ | |
284 | if (argc > 1) | |
285 | usage_with_options(annotate_usage, options); | |
286 | ||
287 | sym_hist_filter = argv[0]; | |
288 | } | |
289 | ||
dd68ada2 | 290 | if (field_sep && *field_sep == '.') { |
29a9f66d ACM |
291 | pr_err("'.' is the only non valid --field-separator argument\n"); |
292 | return -1; | |
dd68ada2 JK |
293 | } |
294 | ||
8035e428 IM |
295 | return __cmd_annotate(); |
296 | } |