4 * Builtin diff command: Analyze two perf.data input files, look up and read
5 * DSOs and symbol information, sort them and produce a diff.
9 #include "util/debug.h"
10 #include "util/event.h"
11 #include "util/hist.h"
12 #include "util/evsel.h"
13 #include "util/evlist.h"
14 #include "util/session.h"
15 #include "util/tool.h"
16 #include "util/sort.h"
17 #include "util/symbol.h"
18 #include "util/util.h"
22 static char const *input_old = "perf.data.old",
23 *input_new = "perf.data";
24 static char diff__default_sort_order[] = "dso,symbol";
26 static bool show_period;
27 static bool show_formula;
28 static bool show_baseline_only;
29 static bool sort_compute;
31 static s64 compute_wdiff_w1;
32 static s64 compute_wdiff_w2;
37 COMPUTE_WEIGHTED_DIFF,
41 const char *compute_names[COMPUTE_MAX] = {
42 [COMPUTE_DELTA] = "delta",
43 [COMPUTE_RATIO] = "ratio",
44 [COMPUTE_WEIGHTED_DIFF] = "wdiff",
49 static int setup_compute_opt_wdiff(char *opt)
59 w2_str = strchr(opt, ',');
67 compute_wdiff_w1 = strtol(w1_str, NULL, 10);
68 compute_wdiff_w2 = strtol(w2_str, NULL, 10);
70 if (!compute_wdiff_w1 || !compute_wdiff_w2)
73 pr_debug("compute wdiff w1(%" PRId64 ") w2(%" PRId64 ")\n",
74 compute_wdiff_w1, compute_wdiff_w2);
80 pr_err("Failed: wrong weight data, use 'wdiff:w1,w2'\n");
85 static int setup_compute_opt(char *opt)
87 if (compute == COMPUTE_WEIGHTED_DIFF)
88 return setup_compute_opt_wdiff(opt);
91 pr_err("Failed: extra option specified '%s'", opt);
98 static int setup_compute(const struct option *opt, const char *str,
99 int unset __maybe_unused)
101 int *cp = (int *) opt->value;
102 char *cstr = (char *) str;
114 cstr = (char *) ++str;
119 option = strchr(str, ':');
121 unsigned len = option++ - str;
124 * The str data are not writeable, so we need
125 * to use another buffer.
128 /* No option value is longer. */
129 if (len >= sizeof(buf))
132 strncpy(buf, str, len);
137 for (i = 0; i < COMPUTE_MAX; i++)
138 if (!strcmp(cstr, compute_names[i])) {
140 return setup_compute_opt(option);
143 pr_err("Failed: '%s' is not computation method "
144 "(use 'delta','ratio' or 'wdiff')\n", str);
148 double perf_diff__period_percent(struct hist_entry *he, u64 period)
150 u64 total = he->hists->stats.total_period;
151 return (period * 100.0) / total;
154 double perf_diff__compute_delta(struct hist_entry *he, struct hist_entry *pair)
156 double new_percent = perf_diff__period_percent(he, he->stat.period);
157 double old_percent = perf_diff__period_percent(pair, pair->stat.period);
159 he->diff.period_ratio_delta = new_percent - old_percent;
160 he->diff.computed = true;
161 return he->diff.period_ratio_delta;
164 double perf_diff__compute_ratio(struct hist_entry *he, struct hist_entry *pair)
166 double new_period = he->stat.period;
167 double old_period = pair->stat.period;
169 he->diff.computed = true;
170 he->diff.period_ratio = new_period / old_period;
171 return he->diff.period_ratio;
174 s64 perf_diff__compute_wdiff(struct hist_entry *he, struct hist_entry *pair)
176 u64 new_period = he->stat.period;
177 u64 old_period = pair->stat.period;
179 he->diff.computed = true;
180 he->diff.wdiff = new_period * compute_wdiff_w2 -
181 old_period * compute_wdiff_w1;
183 return he->diff.wdiff;
186 static int formula_delta(struct hist_entry *he, struct hist_entry *pair,
187 char *buf, size_t size)
189 return scnprintf(buf, size,
190 "(%" PRIu64 " * 100 / %" PRIu64 ") - "
191 "(%" PRIu64 " * 100 / %" PRIu64 ")",
192 he->stat.period, he->hists->stats.total_period,
193 pair->stat.period, pair->hists->stats.total_period);
196 static int formula_ratio(struct hist_entry *he, struct hist_entry *pair,
197 char *buf, size_t size)
199 double new_period = he->stat.period;
200 double old_period = pair->stat.period;
202 return scnprintf(buf, size, "%.0F / %.0F", new_period, old_period);
205 static int formula_wdiff(struct hist_entry *he, struct hist_entry *pair,
206 char *buf, size_t size)
208 u64 new_period = he->stat.period;
209 u64 old_period = pair->stat.period;
211 return scnprintf(buf, size,
212 "(%" PRIu64 " * " "%" PRId64 ") - (%" PRIu64 " * " "%" PRId64 ")",
213 new_period, compute_wdiff_w2, old_period, compute_wdiff_w1);
216 int perf_diff__formula(struct hist_entry *he, struct hist_entry *pair,
217 char *buf, size_t size)
221 return formula_delta(he, pair, buf, size);
223 return formula_ratio(he, pair, buf, size);
224 case COMPUTE_WEIGHTED_DIFF:
225 return formula_wdiff(he, pair, buf, size);
233 static int hists__add_entry(struct hists *self,
234 struct addr_location *al, u64 period,
237 if (__hists__add_entry(self, al, NULL, period, weight) != NULL)
242 static int diff__process_sample_event(struct perf_tool *tool __maybe_unused,
243 union perf_event *event,
244 struct perf_sample *sample,
245 struct perf_evsel *evsel,
246 struct machine *machine)
248 struct addr_location al;
250 if (perf_event__preprocess_sample(event, machine, &al, sample, NULL) < 0) {
251 pr_warning("problem processing %d event, skipping it.\n",
259 if (hists__add_entry(&evsel->hists, &al, sample->period, sample->weight)) {
260 pr_warning("problem incrementing symbol period, skipping event\n");
264 evsel->hists.stats.total_period += sample->period;
268 static struct perf_tool tool = {
269 .sample = diff__process_sample_event,
270 .mmap = perf_event__process_mmap,
271 .comm = perf_event__process_comm,
272 .exit = perf_event__process_exit,
273 .fork = perf_event__process_fork,
274 .lost = perf_event__process_lost,
275 .ordered_samples = true,
276 .ordering_requires_timestamps = true,
279 static struct perf_evsel *evsel_match(struct perf_evsel *evsel,
280 struct perf_evlist *evlist)
282 struct perf_evsel *e;
284 list_for_each_entry(e, &evlist->entries, node)
285 if (perf_evsel__match2(evsel, e))
291 static void perf_evlist__collapse_resort(struct perf_evlist *evlist)
293 struct perf_evsel *evsel;
295 list_for_each_entry(evsel, &evlist->entries, node) {
296 struct hists *hists = &evsel->hists;
298 hists__collapse_resort(hists);
302 static void hists__baseline_only(struct hists *hists)
304 struct rb_root *root;
305 struct rb_node *next;
307 if (sort__need_collapse)
308 root = &hists->entries_collapsed;
310 root = hists->entries_in;
312 next = rb_first(root);
313 while (next != NULL) {
314 struct hist_entry *he = rb_entry(next, struct hist_entry, rb_node_in);
316 next = rb_next(&he->rb_node_in);
317 if (!hist_entry__next_pair(he)) {
318 rb_erase(&he->rb_node_in, root);
319 hist_entry__free(he);
324 static void hists__precompute(struct hists *hists)
326 struct rb_node *next = rb_first(&hists->entries);
328 while (next != NULL) {
329 struct hist_entry *he = rb_entry(next, struct hist_entry, rb_node);
330 struct hist_entry *pair = hist_entry__next_pair(he);
332 next = rb_next(&he->rb_node);
338 perf_diff__compute_delta(he, pair);
341 perf_diff__compute_ratio(he, pair);
343 case COMPUTE_WEIGHTED_DIFF:
344 perf_diff__compute_wdiff(he, pair);
352 static int64_t cmp_doubles(double l, double r)
363 hist_entry__cmp_compute(struct hist_entry *left, struct hist_entry *right,
369 double l = left->diff.period_ratio_delta;
370 double r = right->diff.period_ratio_delta;
372 return cmp_doubles(l, r);
376 double l = left->diff.period_ratio;
377 double r = right->diff.period_ratio;
379 return cmp_doubles(l, r);
381 case COMPUTE_WEIGHTED_DIFF:
383 s64 l = left->diff.wdiff;
384 s64 r = right->diff.wdiff;
395 static void insert_hist_entry_by_compute(struct rb_root *root,
396 struct hist_entry *he,
399 struct rb_node **p = &root->rb_node;
400 struct rb_node *parent = NULL;
401 struct hist_entry *iter;
405 iter = rb_entry(parent, struct hist_entry, rb_node);
406 if (hist_entry__cmp_compute(he, iter, c) < 0)
412 rb_link_node(&he->rb_node, parent, p);
413 rb_insert_color(&he->rb_node, root);
416 static void hists__compute_resort(struct hists *hists)
418 struct rb_root *root;
419 struct rb_node *next;
421 if (sort__need_collapse)
422 root = &hists->entries_collapsed;
424 root = hists->entries_in;
426 hists->entries = RB_ROOT;
427 next = rb_first(root);
429 hists->nr_entries = 0;
430 hists->stats.total_period = 0;
431 hists__reset_col_len(hists);
433 while (next != NULL) {
434 struct hist_entry *he;
436 he = rb_entry(next, struct hist_entry, rb_node_in);
437 next = rb_next(&he->rb_node_in);
439 insert_hist_entry_by_compute(&hists->entries, he, compute);
440 hists__inc_nr_entries(hists, he);
444 static void hists__process(struct hists *old, struct hists *new)
446 hists__match(new, old);
448 if (show_baseline_only)
449 hists__baseline_only(new);
451 hists__link(new, old);
454 hists__precompute(new);
455 hists__compute_resort(new);
457 hists__output_resort(new);
460 hists__fprintf(new, true, 0, 0, stdout);
463 static int __cmd_diff(void)
466 #define older (session[0])
467 #define newer (session[1])
468 struct perf_session *session[2];
469 struct perf_evlist *evlist_new, *evlist_old;
470 struct perf_evsel *evsel;
473 older = perf_session__new(input_old, O_RDONLY, force, false,
475 newer = perf_session__new(input_new, O_RDONLY, force, false,
477 if (session[0] == NULL || session[1] == NULL)
480 for (i = 0; i < 2; ++i) {
481 ret = perf_session__process_events(session[i], &tool);
486 evlist_old = older->evlist;
487 evlist_new = newer->evlist;
489 perf_evlist__collapse_resort(evlist_old);
490 perf_evlist__collapse_resort(evlist_new);
492 list_for_each_entry(evsel, &evlist_new->entries, node) {
493 struct perf_evsel *evsel_old;
495 evsel_old = evsel_match(evsel, evlist_old);
499 fprintf(stdout, "%s# Event '%s'\n#\n", first ? "" : "\n",
500 perf_evsel__name(evsel));
504 hists__process(&evsel_old->hists, &evsel->hists);
508 for (i = 0; i < 2; ++i)
509 perf_session__delete(session[i]);
515 static const char * const diff_usage[] = {
516 "perf diff [<options>] [old_file] [new_file]",
520 static const struct option options[] = {
521 OPT_INCR('v', "verbose", &verbose,
522 "be more verbose (show symbol address, etc)"),
523 OPT_BOOLEAN('b', "baseline-only", &show_baseline_only,
524 "Show only items with match in baseline"),
525 OPT_CALLBACK('c', "compute", &compute,
526 "delta,ratio,wdiff:w1,w2 (default delta)",
527 "Entries differential computation selection",
529 OPT_BOOLEAN('p', "period", &show_period,
530 "Show period values."),
531 OPT_BOOLEAN('F', "formula", &show_formula,
533 OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace,
534 "dump raw trace in ASCII"),
535 OPT_BOOLEAN('f', "force", &force, "don't complain, do it"),
536 OPT_BOOLEAN('m', "modules", &symbol_conf.use_modules,
537 "load module symbols - WARNING: use only with -k and LIVE kernel"),
538 OPT_STRING('d', "dsos", &symbol_conf.dso_list_str, "dso[,dso...]",
539 "only consider symbols in these dsos"),
540 OPT_STRING('C', "comms", &symbol_conf.comm_list_str, "comm[,comm...]",
541 "only consider symbols in these comms"),
542 OPT_STRING('S', "symbols", &symbol_conf.sym_list_str, "symbol[,symbol...]",
543 "only consider these symbols"),
544 OPT_STRING('s', "sort", &sort_order, "key[,key2...]",
545 "sort by key(s): pid, comm, dso, symbol, parent"),
546 OPT_STRING('t', "field-separator", &symbol_conf.field_sep, "separator",
547 "separator for columns, no spaces will be added between "
548 "columns '.' is reserved."),
549 OPT_STRING(0, "symfs", &symbol_conf.symfs, "directory",
550 "Look for files with symbols relative to this directory"),
554 static void ui_init(void)
557 * Display baseline/delta/ratio
558 * formula/periods columns.
560 perf_hpp__column_enable(PERF_HPP__BASELINE);
564 perf_hpp__column_enable(PERF_HPP__DELTA);
567 perf_hpp__column_enable(PERF_HPP__RATIO);
569 case COMPUTE_WEIGHTED_DIFF:
570 perf_hpp__column_enable(PERF_HPP__WEIGHTED_DIFF);
577 perf_hpp__column_enable(PERF_HPP__FORMULA);
580 perf_hpp__column_enable(PERF_HPP__PERIOD);
581 perf_hpp__column_enable(PERF_HPP__PERIOD_BASELINE);
585 int cmd_diff(int argc, const char **argv, const char *prefix __maybe_unused)
587 sort_order = diff__default_sort_order;
588 argc = parse_options(argc, argv, options, diff_usage, 0);
591 usage_with_options(diff_usage, options);
597 } else if (symbol_conf.default_guest_vmlinux_name ||
598 symbol_conf.default_guest_kallsyms) {
599 input_old = "perf.data.host";
600 input_new = "perf.data.guest";
603 symbol_conf.exclude_other = false;
604 if (symbol__init() < 0)
609 if (setup_sorting() < 0)
610 usage_with_options(diff_usage, options);
614 sort_entry__setup_elide(&sort_dso, symbol_conf.dso_list, "dso", NULL);
615 sort_entry__setup_elide(&sort_comm, symbol_conf.comm_list, "comm", NULL);
616 sort_entry__setup_elide(&sort_sym, symbol_conf.sym_list, "symbol", NULL);