• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * builtin-diff.c
3  *
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.
6  */
7 #include "builtin.h"
8 
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"
19 #include "util/data.h"
20 
21 #include <stdlib.h>
22 #include <math.h>
23 
24 /* Diff command specific HPP columns. */
25 enum {
26 	PERF_HPP_DIFF__BASELINE,
27 	PERF_HPP_DIFF__PERIOD,
28 	PERF_HPP_DIFF__PERIOD_BASELINE,
29 	PERF_HPP_DIFF__DELTA,
30 	PERF_HPP_DIFF__RATIO,
31 	PERF_HPP_DIFF__WEIGHTED_DIFF,
32 	PERF_HPP_DIFF__FORMULA,
33 
34 	PERF_HPP_DIFF__MAX_INDEX
35 };
36 
37 struct diff_hpp_fmt {
38 	struct perf_hpp_fmt	 fmt;
39 	int			 idx;
40 	char			*header;
41 	int			 header_width;
42 };
43 
44 struct data__file {
45 	struct perf_session	*session;
46 	struct perf_data_file	file;
47 	int			 idx;
48 	struct hists		*hists;
49 	struct diff_hpp_fmt	 fmt[PERF_HPP_DIFF__MAX_INDEX];
50 };
51 
52 static struct data__file *data__files;
53 static int data__files_cnt;
54 
55 #define data__for_each_file_start(i, d, s)	\
56 	for (i = s, d = &data__files[s];	\
57 	     i < data__files_cnt;		\
58 	     i++, d = &data__files[i])
59 
60 #define data__for_each_file(i, d) data__for_each_file_start(i, d, 0)
61 #define data__for_each_file_new(i, d) data__for_each_file_start(i, d, 1)
62 
63 static bool force;
64 static bool show_period;
65 static bool show_formula;
66 static bool show_baseline_only;
67 static unsigned int sort_compute;
68 
69 static s64 compute_wdiff_w1;
70 static s64 compute_wdiff_w2;
71 
72 enum {
73 	COMPUTE_DELTA,
74 	COMPUTE_RATIO,
75 	COMPUTE_WEIGHTED_DIFF,
76 	COMPUTE_MAX,
77 };
78 
79 const char *compute_names[COMPUTE_MAX] = {
80 	[COMPUTE_DELTA] = "delta",
81 	[COMPUTE_RATIO] = "ratio",
82 	[COMPUTE_WEIGHTED_DIFF] = "wdiff",
83 };
84 
85 static int compute;
86 
87 static int compute_2_hpp[COMPUTE_MAX] = {
88 	[COMPUTE_DELTA]		= PERF_HPP_DIFF__DELTA,
89 	[COMPUTE_RATIO]		= PERF_HPP_DIFF__RATIO,
90 	[COMPUTE_WEIGHTED_DIFF]	= PERF_HPP_DIFF__WEIGHTED_DIFF,
91 };
92 
93 #define MAX_COL_WIDTH 70
94 
95 static struct header_column {
96 	const char *name;
97 	int width;
98 } columns[PERF_HPP_DIFF__MAX_INDEX] = {
99 	[PERF_HPP_DIFF__BASELINE] = {
100 		.name  = "Baseline",
101 	},
102 	[PERF_HPP_DIFF__PERIOD] = {
103 		.name  = "Period",
104 		.width = 14,
105 	},
106 	[PERF_HPP_DIFF__PERIOD_BASELINE] = {
107 		.name  = "Base period",
108 		.width = 14,
109 	},
110 	[PERF_HPP_DIFF__DELTA] = {
111 		.name  = "Delta",
112 		.width = 7,
113 	},
114 	[PERF_HPP_DIFF__RATIO] = {
115 		.name  = "Ratio",
116 		.width = 14,
117 	},
118 	[PERF_HPP_DIFF__WEIGHTED_DIFF] = {
119 		.name  = "Weighted diff",
120 		.width = 14,
121 	},
122 	[PERF_HPP_DIFF__FORMULA] = {
123 		.name  = "Formula",
124 		.width = MAX_COL_WIDTH,
125 	}
126 };
127 
setup_compute_opt_wdiff(char * opt)128 static int setup_compute_opt_wdiff(char *opt)
129 {
130 	char *w1_str = opt;
131 	char *w2_str;
132 
133 	int ret = -EINVAL;
134 
135 	if (!opt)
136 		goto out;
137 
138 	w2_str = strchr(opt, ',');
139 	if (!w2_str)
140 		goto out;
141 
142 	*w2_str++ = 0x0;
143 	if (!*w2_str)
144 		goto out;
145 
146 	compute_wdiff_w1 = strtol(w1_str, NULL, 10);
147 	compute_wdiff_w2 = strtol(w2_str, NULL, 10);
148 
149 	if (!compute_wdiff_w1 || !compute_wdiff_w2)
150 		goto out;
151 
152 	pr_debug("compute wdiff w1(%" PRId64 ") w2(%" PRId64 ")\n",
153 		  compute_wdiff_w1, compute_wdiff_w2);
154 
155 	ret = 0;
156 
157  out:
158 	if (ret)
159 		pr_err("Failed: wrong weight data, use 'wdiff:w1,w2'\n");
160 
161 	return ret;
162 }
163 
setup_compute_opt(char * opt)164 static int setup_compute_opt(char *opt)
165 {
166 	if (compute == COMPUTE_WEIGHTED_DIFF)
167 		return setup_compute_opt_wdiff(opt);
168 
169 	if (opt) {
170 		pr_err("Failed: extra option specified '%s'", opt);
171 		return -EINVAL;
172 	}
173 
174 	return 0;
175 }
176 
setup_compute(const struct option * opt,const char * str,int unset __maybe_unused)177 static int setup_compute(const struct option *opt, const char *str,
178 			 int unset __maybe_unused)
179 {
180 	int *cp = (int *) opt->value;
181 	char *cstr = (char *) str;
182 	char buf[50];
183 	unsigned i;
184 	char *option;
185 
186 	if (!str) {
187 		*cp = COMPUTE_DELTA;
188 		return 0;
189 	}
190 
191 	option = strchr(str, ':');
192 	if (option) {
193 		unsigned len = option++ - str;
194 
195 		/*
196 		 * The str data are not writeable, so we need
197 		 * to use another buffer.
198 		 */
199 
200 		/* No option value is longer. */
201 		if (len >= sizeof(buf))
202 			return -EINVAL;
203 
204 		strncpy(buf, str, len);
205 		buf[len] = 0x0;
206 		cstr = buf;
207 	}
208 
209 	for (i = 0; i < COMPUTE_MAX; i++)
210 		if (!strcmp(cstr, compute_names[i])) {
211 			*cp = i;
212 			return setup_compute_opt(option);
213 		}
214 
215 	pr_err("Failed: '%s' is not computation method "
216 	       "(use 'delta','ratio' or 'wdiff')\n", str);
217 	return -EINVAL;
218 }
219 
period_percent(struct hist_entry * he,u64 period)220 static double period_percent(struct hist_entry *he, u64 period)
221 {
222 	u64 total = hists__total_period(he->hists);
223 
224 	return (period * 100.0) / total;
225 }
226 
compute_delta(struct hist_entry * he,struct hist_entry * pair)227 static double compute_delta(struct hist_entry *he, struct hist_entry *pair)
228 {
229 	double old_percent = period_percent(he, he->stat.period);
230 	double new_percent = period_percent(pair, pair->stat.period);
231 
232 	pair->diff.period_ratio_delta = new_percent - old_percent;
233 	pair->diff.computed = true;
234 	return pair->diff.period_ratio_delta;
235 }
236 
compute_ratio(struct hist_entry * he,struct hist_entry * pair)237 static double compute_ratio(struct hist_entry *he, struct hist_entry *pair)
238 {
239 	double old_period = he->stat.period ?: 1;
240 	double new_period = pair->stat.period;
241 
242 	pair->diff.computed = true;
243 	pair->diff.period_ratio = new_period / old_period;
244 	return pair->diff.period_ratio;
245 }
246 
compute_wdiff(struct hist_entry * he,struct hist_entry * pair)247 static s64 compute_wdiff(struct hist_entry *he, struct hist_entry *pair)
248 {
249 	u64 old_period = he->stat.period;
250 	u64 new_period = pair->stat.period;
251 
252 	pair->diff.computed = true;
253 	pair->diff.wdiff = new_period * compute_wdiff_w2 -
254 			   old_period * compute_wdiff_w1;
255 
256 	return pair->diff.wdiff;
257 }
258 
formula_delta(struct hist_entry * he,struct hist_entry * pair,char * buf,size_t size)259 static int formula_delta(struct hist_entry *he, struct hist_entry *pair,
260 			 char *buf, size_t size)
261 {
262 	u64 he_total = he->hists->stats.total_period;
263 	u64 pair_total = pair->hists->stats.total_period;
264 
265 	if (symbol_conf.filter_relative) {
266 		he_total = he->hists->stats.total_non_filtered_period;
267 		pair_total = pair->hists->stats.total_non_filtered_period;
268 	}
269 	return scnprintf(buf, size,
270 			 "(%" PRIu64 " * 100 / %" PRIu64 ") - "
271 			 "(%" PRIu64 " * 100 / %" PRIu64 ")",
272 			 pair->stat.period, pair_total,
273 			 he->stat.period, he_total);
274 }
275 
formula_ratio(struct hist_entry * he,struct hist_entry * pair,char * buf,size_t size)276 static int formula_ratio(struct hist_entry *he, struct hist_entry *pair,
277 			 char *buf, size_t size)
278 {
279 	double old_period = he->stat.period;
280 	double new_period = pair->stat.period;
281 
282 	return scnprintf(buf, size, "%.0F / %.0F", new_period, old_period);
283 }
284 
formula_wdiff(struct hist_entry * he,struct hist_entry * pair,char * buf,size_t size)285 static int formula_wdiff(struct hist_entry *he, struct hist_entry *pair,
286 			 char *buf, size_t size)
287 {
288 	u64 old_period = he->stat.period;
289 	u64 new_period = pair->stat.period;
290 
291 	return scnprintf(buf, size,
292 		  "(%" PRIu64 " * " "%" PRId64 ") - (%" PRIu64 " * " "%" PRId64 ")",
293 		  new_period, compute_wdiff_w2, old_period, compute_wdiff_w1);
294 }
295 
formula_fprintf(struct hist_entry * he,struct hist_entry * pair,char * buf,size_t size)296 static int formula_fprintf(struct hist_entry *he, struct hist_entry *pair,
297 			   char *buf, size_t size)
298 {
299 	switch (compute) {
300 	case COMPUTE_DELTA:
301 		return formula_delta(he, pair, buf, size);
302 	case COMPUTE_RATIO:
303 		return formula_ratio(he, pair, buf, size);
304 	case COMPUTE_WEIGHTED_DIFF:
305 		return formula_wdiff(he, pair, buf, size);
306 	default:
307 		BUG_ON(1);
308 	}
309 
310 	return -1;
311 }
312 
hists__add_entry(struct hists * hists,struct addr_location * al,u64 period,u64 weight,u64 transaction)313 static int hists__add_entry(struct hists *hists,
314 			    struct addr_location *al, u64 period,
315 			    u64 weight, u64 transaction)
316 {
317 	if (__hists__add_entry(hists, al, NULL, NULL, NULL, period, weight,
318 			       transaction, true) != NULL)
319 		return 0;
320 	return -ENOMEM;
321 }
322 
diff__process_sample_event(struct perf_tool * tool __maybe_unused,union perf_event * event,struct perf_sample * sample,struct perf_evsel * evsel,struct machine * machine)323 static int diff__process_sample_event(struct perf_tool *tool __maybe_unused,
324 				      union perf_event *event,
325 				      struct perf_sample *sample,
326 				      struct perf_evsel *evsel,
327 				      struct machine *machine)
328 {
329 	struct addr_location al;
330 	struct hists *hists = evsel__hists(evsel);
331 	int ret = -1;
332 
333 	if (perf_event__preprocess_sample(event, machine, &al, sample) < 0) {
334 		pr_warning("problem processing %d event, skipping it.\n",
335 			   event->header.type);
336 		return -1;
337 	}
338 
339 	if (hists__add_entry(hists, &al, sample->period,
340 			     sample->weight, sample->transaction)) {
341 		pr_warning("problem incrementing symbol period, skipping event\n");
342 		goto out_put;
343 	}
344 
345 	/*
346 	 * The total_period is updated here before going to the output
347 	 * tree since normally only the baseline hists will call
348 	 * hists__output_resort() and precompute needs the total
349 	 * period in order to sort entries by percentage delta.
350 	 */
351 	hists->stats.total_period += sample->period;
352 	if (!al.filtered)
353 		hists->stats.total_non_filtered_period += sample->period;
354 	ret = 0;
355 out_put:
356 	addr_location__put(&al);
357 	return ret;
358 }
359 
360 static struct perf_tool tool = {
361 	.sample	= diff__process_sample_event,
362 	.mmap	= perf_event__process_mmap,
363 	.mmap2	= perf_event__process_mmap2,
364 	.comm	= perf_event__process_comm,
365 	.exit	= perf_event__process_exit,
366 	.fork	= perf_event__process_fork,
367 	.lost	= perf_event__process_lost,
368 	.ordered_events = true,
369 	.ordering_requires_timestamps = true,
370 };
371 
evsel_match(struct perf_evsel * evsel,struct perf_evlist * evlist)372 static struct perf_evsel *evsel_match(struct perf_evsel *evsel,
373 				      struct perf_evlist *evlist)
374 {
375 	struct perf_evsel *e;
376 
377 	evlist__for_each(evlist, e) {
378 		if (perf_evsel__match2(evsel, e))
379 			return e;
380 	}
381 
382 	return NULL;
383 }
384 
perf_evlist__collapse_resort(struct perf_evlist * evlist)385 static void perf_evlist__collapse_resort(struct perf_evlist *evlist)
386 {
387 	struct perf_evsel *evsel;
388 
389 	evlist__for_each(evlist, evsel) {
390 		struct hists *hists = evsel__hists(evsel);
391 
392 		hists__collapse_resort(hists, NULL);
393 	}
394 }
395 
fmt_to_data_file(struct perf_hpp_fmt * fmt)396 static struct data__file *fmt_to_data_file(struct perf_hpp_fmt *fmt)
397 {
398 	struct diff_hpp_fmt *dfmt = container_of(fmt, struct diff_hpp_fmt, fmt);
399 	void *ptr = dfmt - dfmt->idx;
400 	struct data__file *d = container_of(ptr, struct data__file, fmt);
401 
402 	return d;
403 }
404 
405 static struct hist_entry*
get_pair_data(struct hist_entry * he,struct data__file * d)406 get_pair_data(struct hist_entry *he, struct data__file *d)
407 {
408 	if (hist_entry__has_pairs(he)) {
409 		struct hist_entry *pair;
410 
411 		list_for_each_entry(pair, &he->pairs.head, pairs.node)
412 			if (pair->hists == d->hists)
413 				return pair;
414 	}
415 
416 	return NULL;
417 }
418 
419 static struct hist_entry*
get_pair_fmt(struct hist_entry * he,struct diff_hpp_fmt * dfmt)420 get_pair_fmt(struct hist_entry *he, struct diff_hpp_fmt *dfmt)
421 {
422 	struct data__file *d = fmt_to_data_file(&dfmt->fmt);
423 
424 	return get_pair_data(he, d);
425 }
426 
hists__baseline_only(struct hists * hists)427 static void hists__baseline_only(struct hists *hists)
428 {
429 	struct rb_root *root;
430 	struct rb_node *next;
431 
432 	if (sort__need_collapse)
433 		root = &hists->entries_collapsed;
434 	else
435 		root = hists->entries_in;
436 
437 	next = rb_first(root);
438 	while (next != NULL) {
439 		struct hist_entry *he = rb_entry(next, struct hist_entry, rb_node_in);
440 
441 		next = rb_next(&he->rb_node_in);
442 		if (!hist_entry__next_pair(he)) {
443 			rb_erase(&he->rb_node_in, root);
444 			hist_entry__delete(he);
445 		}
446 	}
447 }
448 
hists__precompute(struct hists * hists)449 static void hists__precompute(struct hists *hists)
450 {
451 	struct rb_root *root;
452 	struct rb_node *next;
453 
454 	if (sort__need_collapse)
455 		root = &hists->entries_collapsed;
456 	else
457 		root = hists->entries_in;
458 
459 	next = rb_first(root);
460 	while (next != NULL) {
461 		struct hist_entry *he, *pair;
462 		struct data__file *d;
463 		int i;
464 
465 		he   = rb_entry(next, struct hist_entry, rb_node_in);
466 		next = rb_next(&he->rb_node_in);
467 
468 		data__for_each_file_new(i, d) {
469 			pair = get_pair_data(he, d);
470 			if (!pair)
471 				continue;
472 
473 			switch (compute) {
474 			case COMPUTE_DELTA:
475 				compute_delta(he, pair);
476 				break;
477 			case COMPUTE_RATIO:
478 				compute_ratio(he, pair);
479 				break;
480 			case COMPUTE_WEIGHTED_DIFF:
481 				compute_wdiff(he, pair);
482 				break;
483 			default:
484 				BUG_ON(1);
485 			}
486 		}
487 	}
488 }
489 
cmp_doubles(double l,double r)490 static int64_t cmp_doubles(double l, double r)
491 {
492 	if (l > r)
493 		return -1;
494 	else if (l < r)
495 		return 1;
496 	else
497 		return 0;
498 }
499 
500 static int64_t
__hist_entry__cmp_compute(struct hist_entry * left,struct hist_entry * right,int c)501 __hist_entry__cmp_compute(struct hist_entry *left, struct hist_entry *right,
502 			int c)
503 {
504 	switch (c) {
505 	case COMPUTE_DELTA:
506 	{
507 		double l = left->diff.period_ratio_delta;
508 		double r = right->diff.period_ratio_delta;
509 
510 		return cmp_doubles(l, r);
511 	}
512 	case COMPUTE_RATIO:
513 	{
514 		double l = left->diff.period_ratio;
515 		double r = right->diff.period_ratio;
516 
517 		return cmp_doubles(l, r);
518 	}
519 	case COMPUTE_WEIGHTED_DIFF:
520 	{
521 		s64 l = left->diff.wdiff;
522 		s64 r = right->diff.wdiff;
523 
524 		return r - l;
525 	}
526 	default:
527 		BUG_ON(1);
528 	}
529 
530 	return 0;
531 }
532 
533 static int64_t
hist_entry__cmp_compute(struct hist_entry * left,struct hist_entry * right,int c,int sort_idx)534 hist_entry__cmp_compute(struct hist_entry *left, struct hist_entry *right,
535 			int c, int sort_idx)
536 {
537 	bool pairs_left  = hist_entry__has_pairs(left);
538 	bool pairs_right = hist_entry__has_pairs(right);
539 	struct hist_entry *p_right, *p_left;
540 
541 	if (!pairs_left && !pairs_right)
542 		return 0;
543 
544 	if (!pairs_left || !pairs_right)
545 		return pairs_left ? -1 : 1;
546 
547 	p_left  = get_pair_data(left,  &data__files[sort_idx]);
548 	p_right = get_pair_data(right, &data__files[sort_idx]);
549 
550 	if (!p_left && !p_right)
551 		return 0;
552 
553 	if (!p_left || !p_right)
554 		return p_left ? -1 : 1;
555 
556 	/*
557 	 * We have 2 entries of same kind, let's
558 	 * make the data comparison.
559 	 */
560 	return __hist_entry__cmp_compute(p_left, p_right, c);
561 }
562 
563 static int64_t
hist_entry__cmp_compute_idx(struct hist_entry * left,struct hist_entry * right,int c,int sort_idx)564 hist_entry__cmp_compute_idx(struct hist_entry *left, struct hist_entry *right,
565 			    int c, int sort_idx)
566 {
567 	struct hist_entry *p_right, *p_left;
568 
569 	p_left  = get_pair_data(left,  &data__files[sort_idx]);
570 	p_right = get_pair_data(right, &data__files[sort_idx]);
571 
572 	if (!p_left && !p_right)
573 		return 0;
574 
575 	if (!p_left || !p_right)
576 		return p_left ? -1 : 1;
577 
578 	if (c != COMPUTE_DELTA) {
579 		/*
580 		 * The delta can be computed without the baseline, but
581 		 * others are not.  Put those entries which have no
582 		 * values below.
583 		 */
584 		if (left->dummy && right->dummy)
585 			return 0;
586 
587 		if (left->dummy || right->dummy)
588 			return left->dummy ? 1 : -1;
589 	}
590 
591 	return __hist_entry__cmp_compute(p_left, p_right, c);
592 }
593 
594 static int64_t
hist_entry__cmp_nop(struct perf_hpp_fmt * fmt __maybe_unused,struct hist_entry * left __maybe_unused,struct hist_entry * right __maybe_unused)595 hist_entry__cmp_nop(struct perf_hpp_fmt *fmt __maybe_unused,
596 		    struct hist_entry *left __maybe_unused,
597 		    struct hist_entry *right __maybe_unused)
598 {
599 	return 0;
600 }
601 
602 static int64_t
hist_entry__cmp_baseline(struct perf_hpp_fmt * fmt __maybe_unused,struct hist_entry * left,struct hist_entry * right)603 hist_entry__cmp_baseline(struct perf_hpp_fmt *fmt __maybe_unused,
604 			 struct hist_entry *left, struct hist_entry *right)
605 {
606 	if (left->stat.period == right->stat.period)
607 		return 0;
608 	return left->stat.period > right->stat.period ? 1 : -1;
609 }
610 
611 static int64_t
hist_entry__cmp_delta(struct perf_hpp_fmt * fmt,struct hist_entry * left,struct hist_entry * right)612 hist_entry__cmp_delta(struct perf_hpp_fmt *fmt,
613 		      struct hist_entry *left, struct hist_entry *right)
614 {
615 	struct data__file *d = fmt_to_data_file(fmt);
616 
617 	return hist_entry__cmp_compute(right, left, COMPUTE_DELTA, d->idx);
618 }
619 
620 static int64_t
hist_entry__cmp_ratio(struct perf_hpp_fmt * fmt,struct hist_entry * left,struct hist_entry * right)621 hist_entry__cmp_ratio(struct perf_hpp_fmt *fmt,
622 		      struct hist_entry *left, struct hist_entry *right)
623 {
624 	struct data__file *d = fmt_to_data_file(fmt);
625 
626 	return hist_entry__cmp_compute(right, left, COMPUTE_RATIO, d->idx);
627 }
628 
629 static int64_t
hist_entry__cmp_wdiff(struct perf_hpp_fmt * fmt,struct hist_entry * left,struct hist_entry * right)630 hist_entry__cmp_wdiff(struct perf_hpp_fmt *fmt,
631 		      struct hist_entry *left, struct hist_entry *right)
632 {
633 	struct data__file *d = fmt_to_data_file(fmt);
634 
635 	return hist_entry__cmp_compute(right, left, COMPUTE_WEIGHTED_DIFF, d->idx);
636 }
637 
638 static int64_t
hist_entry__cmp_delta_idx(struct perf_hpp_fmt * fmt __maybe_unused,struct hist_entry * left,struct hist_entry * right)639 hist_entry__cmp_delta_idx(struct perf_hpp_fmt *fmt __maybe_unused,
640 			  struct hist_entry *left, struct hist_entry *right)
641 {
642 	return hist_entry__cmp_compute_idx(right, left, COMPUTE_DELTA,
643 					   sort_compute);
644 }
645 
646 static int64_t
hist_entry__cmp_ratio_idx(struct perf_hpp_fmt * fmt __maybe_unused,struct hist_entry * left,struct hist_entry * right)647 hist_entry__cmp_ratio_idx(struct perf_hpp_fmt *fmt __maybe_unused,
648 			  struct hist_entry *left, struct hist_entry *right)
649 {
650 	return hist_entry__cmp_compute_idx(right, left, COMPUTE_RATIO,
651 					   sort_compute);
652 }
653 
654 static int64_t
hist_entry__cmp_wdiff_idx(struct perf_hpp_fmt * fmt __maybe_unused,struct hist_entry * left,struct hist_entry * right)655 hist_entry__cmp_wdiff_idx(struct perf_hpp_fmt *fmt __maybe_unused,
656 			  struct hist_entry *left, struct hist_entry *right)
657 {
658 	return hist_entry__cmp_compute_idx(right, left, COMPUTE_WEIGHTED_DIFF,
659 					   sort_compute);
660 }
661 
hists__process(struct hists * hists)662 static void hists__process(struct hists *hists)
663 {
664 	if (show_baseline_only)
665 		hists__baseline_only(hists);
666 
667 	hists__precompute(hists);
668 	hists__output_resort(hists, NULL);
669 
670 	hists__fprintf(hists, true, 0, 0, 0, stdout);
671 }
672 
data__fprintf(void)673 static void data__fprintf(void)
674 {
675 	struct data__file *d;
676 	int i;
677 
678 	fprintf(stdout, "# Data files:\n");
679 
680 	data__for_each_file(i, d)
681 		fprintf(stdout, "#  [%d] %s %s\n",
682 			d->idx, d->file.path,
683 			!d->idx ? "(Baseline)" : "");
684 
685 	fprintf(stdout, "#\n");
686 }
687 
data_process(void)688 static void data_process(void)
689 {
690 	struct perf_evlist *evlist_base = data__files[0].session->evlist;
691 	struct perf_evsel *evsel_base;
692 	bool first = true;
693 
694 	evlist__for_each(evlist_base, evsel_base) {
695 		struct hists *hists_base = evsel__hists(evsel_base);
696 		struct data__file *d;
697 		int i;
698 
699 		data__for_each_file_new(i, d) {
700 			struct perf_evlist *evlist = d->session->evlist;
701 			struct perf_evsel *evsel;
702 			struct hists *hists;
703 
704 			evsel = evsel_match(evsel_base, evlist);
705 			if (!evsel)
706 				continue;
707 
708 			hists = evsel__hists(evsel);
709 			d->hists = hists;
710 
711 			hists__match(hists_base, hists);
712 
713 			if (!show_baseline_only)
714 				hists__link(hists_base, hists);
715 		}
716 
717 		fprintf(stdout, "%s# Event '%s'\n#\n", first ? "" : "\n",
718 			perf_evsel__name(evsel_base));
719 
720 		first = false;
721 
722 		if (verbose || data__files_cnt > 2)
723 			data__fprintf();
724 
725 		/* Don't sort callchain for perf diff */
726 		perf_evsel__reset_sample_bit(evsel_base, CALLCHAIN);
727 
728 		hists__process(hists_base);
729 	}
730 }
731 
data__free(struct data__file * d)732 static void data__free(struct data__file *d)
733 {
734 	int col;
735 
736 	for (col = 0; col < PERF_HPP_DIFF__MAX_INDEX; col++) {
737 		struct diff_hpp_fmt *fmt = &d->fmt[col];
738 
739 		zfree(&fmt->header);
740 	}
741 }
742 
__cmd_diff(void)743 static int __cmd_diff(void)
744 {
745 	struct data__file *d;
746 	int ret = -EINVAL, i;
747 
748 	data__for_each_file(i, d) {
749 		d->session = perf_session__new(&d->file, false, &tool);
750 		if (!d->session) {
751 			pr_err("Failed to open %s\n", d->file.path);
752 			ret = -1;
753 			goto out_delete;
754 		}
755 
756 		ret = perf_session__process_events(d->session);
757 		if (ret) {
758 			pr_err("Failed to process %s\n", d->file.path);
759 			goto out_delete;
760 		}
761 
762 		perf_evlist__collapse_resort(d->session->evlist);
763 	}
764 
765 	data_process();
766 
767  out_delete:
768 	data__for_each_file(i, d) {
769 		if (d->session)
770 			perf_session__delete(d->session);
771 
772 		data__free(d);
773 	}
774 
775 	free(data__files);
776 	return ret;
777 }
778 
779 static const char * const diff_usage[] = {
780 	"perf diff [<options>] [old_file] [new_file]",
781 	NULL,
782 };
783 
784 static const struct option options[] = {
785 	OPT_INCR('v', "verbose", &verbose,
786 		    "be more verbose (show symbol address, etc)"),
787 	OPT_BOOLEAN('b', "baseline-only", &show_baseline_only,
788 		    "Show only items with match in baseline"),
789 	OPT_CALLBACK('c', "compute", &compute,
790 		     "delta,ratio,wdiff:w1,w2 (default delta)",
791 		     "Entries differential computation selection",
792 		     setup_compute),
793 	OPT_BOOLEAN('p', "period", &show_period,
794 		    "Show period values."),
795 	OPT_BOOLEAN('F', "formula", &show_formula,
796 		    "Show formula."),
797 	OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace,
798 		    "dump raw trace in ASCII"),
799 	OPT_BOOLEAN('f', "force", &force, "don't complain, do it"),
800 	OPT_STRING(0, "kallsyms", &symbol_conf.kallsyms_name,
801 		   "file", "kallsyms pathname"),
802 	OPT_BOOLEAN('m', "modules", &symbol_conf.use_modules,
803 		    "load module symbols - WARNING: use only with -k and LIVE kernel"),
804 	OPT_STRING('d', "dsos", &symbol_conf.dso_list_str, "dso[,dso...]",
805 		   "only consider symbols in these dsos"),
806 	OPT_STRING('C', "comms", &symbol_conf.comm_list_str, "comm[,comm...]",
807 		   "only consider symbols in these comms"),
808 	OPT_STRING('S', "symbols", &symbol_conf.sym_list_str, "symbol[,symbol...]",
809 		   "only consider these symbols"),
810 	OPT_STRING('s', "sort", &sort_order, "key[,key2...]",
811 		   "sort by key(s): pid, comm, dso, symbol, parent, cpu, srcline, ..."
812 		   " Please refer the man page for the complete list."),
813 	OPT_STRING_NOEMPTY('t', "field-separator", &symbol_conf.field_sep, "separator",
814 		   "separator for columns, no spaces will be added between "
815 		   "columns '.' is reserved."),
816 	OPT_STRING(0, "symfs", &symbol_conf.symfs, "directory",
817 		    "Look for files with symbols relative to this directory"),
818 	OPT_UINTEGER('o', "order", &sort_compute, "Specify compute sorting."),
819 	OPT_CALLBACK(0, "percentage", NULL, "relative|absolute",
820 		     "How to display percentage of filtered entries", parse_filter_percentage),
821 	OPT_END()
822 };
823 
baseline_percent(struct hist_entry * he)824 static double baseline_percent(struct hist_entry *he)
825 {
826 	u64 total = hists__total_period(he->hists);
827 
828 	return 100.0 * he->stat.period / total;
829 }
830 
hpp__color_baseline(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp,struct hist_entry * he)831 static int hpp__color_baseline(struct perf_hpp_fmt *fmt,
832 			       struct perf_hpp *hpp, struct hist_entry *he)
833 {
834 	struct diff_hpp_fmt *dfmt =
835 		container_of(fmt, struct diff_hpp_fmt, fmt);
836 	double percent = baseline_percent(he);
837 	char pfmt[20] = " ";
838 
839 	if (!he->dummy) {
840 		scnprintf(pfmt, 20, "%%%d.2f%%%%", dfmt->header_width - 1);
841 		return percent_color_snprintf(hpp->buf, hpp->size,
842 					      pfmt, percent);
843 	} else
844 		return scnprintf(hpp->buf, hpp->size, "%*s",
845 				 dfmt->header_width, pfmt);
846 }
847 
hpp__entry_baseline(struct hist_entry * he,char * buf,size_t size)848 static int hpp__entry_baseline(struct hist_entry *he, char *buf, size_t size)
849 {
850 	double percent = baseline_percent(he);
851 	const char *fmt = symbol_conf.field_sep ? "%.2f" : "%6.2f%%";
852 	int ret = 0;
853 
854 	if (!he->dummy)
855 		ret = scnprintf(buf, size, fmt, percent);
856 
857 	return ret;
858 }
859 
__hpp__color_compare(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp,struct hist_entry * he,int comparison_method)860 static int __hpp__color_compare(struct perf_hpp_fmt *fmt,
861 				struct perf_hpp *hpp, struct hist_entry *he,
862 				int comparison_method)
863 {
864 	struct diff_hpp_fmt *dfmt =
865 		container_of(fmt, struct diff_hpp_fmt, fmt);
866 	struct hist_entry *pair = get_pair_fmt(he, dfmt);
867 	double diff;
868 	s64 wdiff;
869 	char pfmt[20] = " ";
870 
871 	if (!pair)
872 		goto no_print;
873 
874 	switch (comparison_method) {
875 	case COMPUTE_DELTA:
876 		if (pair->diff.computed)
877 			diff = pair->diff.period_ratio_delta;
878 		else
879 			diff = compute_delta(he, pair);
880 
881 		scnprintf(pfmt, 20, "%%%+d.2f%%%%", dfmt->header_width - 1);
882 		return percent_color_snprintf(hpp->buf, hpp->size,
883 					pfmt, diff);
884 	case COMPUTE_RATIO:
885 		if (he->dummy)
886 			goto dummy_print;
887 		if (pair->diff.computed)
888 			diff = pair->diff.period_ratio;
889 		else
890 			diff = compute_ratio(he, pair);
891 
892 		scnprintf(pfmt, 20, "%%%d.6f", dfmt->header_width);
893 		return value_color_snprintf(hpp->buf, hpp->size,
894 					pfmt, diff);
895 	case COMPUTE_WEIGHTED_DIFF:
896 		if (he->dummy)
897 			goto dummy_print;
898 		if (pair->diff.computed)
899 			wdiff = pair->diff.wdiff;
900 		else
901 			wdiff = compute_wdiff(he, pair);
902 
903 		scnprintf(pfmt, 20, "%%14ld", dfmt->header_width);
904 		return color_snprintf(hpp->buf, hpp->size,
905 				get_percent_color(wdiff),
906 				pfmt, wdiff);
907 	default:
908 		BUG_ON(1);
909 	}
910 dummy_print:
911 	return scnprintf(hpp->buf, hpp->size, "%*s",
912 			dfmt->header_width, "N/A");
913 no_print:
914 	return scnprintf(hpp->buf, hpp->size, "%*s",
915 			dfmt->header_width, pfmt);
916 }
917 
hpp__color_delta(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp,struct hist_entry * he)918 static int hpp__color_delta(struct perf_hpp_fmt *fmt,
919 			struct perf_hpp *hpp, struct hist_entry *he)
920 {
921 	return __hpp__color_compare(fmt, hpp, he, COMPUTE_DELTA);
922 }
923 
hpp__color_ratio(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp,struct hist_entry * he)924 static int hpp__color_ratio(struct perf_hpp_fmt *fmt,
925 			struct perf_hpp *hpp, struct hist_entry *he)
926 {
927 	return __hpp__color_compare(fmt, hpp, he, COMPUTE_RATIO);
928 }
929 
hpp__color_wdiff(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp,struct hist_entry * he)930 static int hpp__color_wdiff(struct perf_hpp_fmt *fmt,
931 			struct perf_hpp *hpp, struct hist_entry *he)
932 {
933 	return __hpp__color_compare(fmt, hpp, he, COMPUTE_WEIGHTED_DIFF);
934 }
935 
936 static void
hpp__entry_unpair(struct hist_entry * he,int idx,char * buf,size_t size)937 hpp__entry_unpair(struct hist_entry *he, int idx, char *buf, size_t size)
938 {
939 	switch (idx) {
940 	case PERF_HPP_DIFF__PERIOD_BASELINE:
941 		scnprintf(buf, size, "%" PRIu64, he->stat.period);
942 		break;
943 
944 	default:
945 		break;
946 	}
947 }
948 
949 static void
hpp__entry_pair(struct hist_entry * he,struct hist_entry * pair,int idx,char * buf,size_t size)950 hpp__entry_pair(struct hist_entry *he, struct hist_entry *pair,
951 		int idx, char *buf, size_t size)
952 {
953 	double diff;
954 	double ratio;
955 	s64 wdiff;
956 
957 	switch (idx) {
958 	case PERF_HPP_DIFF__DELTA:
959 		if (pair->diff.computed)
960 			diff = pair->diff.period_ratio_delta;
961 		else
962 			diff = compute_delta(he, pair);
963 
964 		scnprintf(buf, size, "%+4.2F%%", diff);
965 		break;
966 
967 	case PERF_HPP_DIFF__RATIO:
968 		/* No point for ratio number if we are dummy.. */
969 		if (he->dummy) {
970 			scnprintf(buf, size, "N/A");
971 			break;
972 		}
973 
974 		if (pair->diff.computed)
975 			ratio = pair->diff.period_ratio;
976 		else
977 			ratio = compute_ratio(he, pair);
978 
979 		if (ratio > 0.0)
980 			scnprintf(buf, size, "%14.6F", ratio);
981 		break;
982 
983 	case PERF_HPP_DIFF__WEIGHTED_DIFF:
984 		/* No point for wdiff number if we are dummy.. */
985 		if (he->dummy) {
986 			scnprintf(buf, size, "N/A");
987 			break;
988 		}
989 
990 		if (pair->diff.computed)
991 			wdiff = pair->diff.wdiff;
992 		else
993 			wdiff = compute_wdiff(he, pair);
994 
995 		if (wdiff != 0)
996 			scnprintf(buf, size, "%14ld", wdiff);
997 		break;
998 
999 	case PERF_HPP_DIFF__FORMULA:
1000 		formula_fprintf(he, pair, buf, size);
1001 		break;
1002 
1003 	case PERF_HPP_DIFF__PERIOD:
1004 		scnprintf(buf, size, "%" PRIu64, pair->stat.period);
1005 		break;
1006 
1007 	default:
1008 		BUG_ON(1);
1009 	};
1010 }
1011 
1012 static void
__hpp__entry_global(struct hist_entry * he,struct diff_hpp_fmt * dfmt,char * buf,size_t size)1013 __hpp__entry_global(struct hist_entry *he, struct diff_hpp_fmt *dfmt,
1014 		    char *buf, size_t size)
1015 {
1016 	struct hist_entry *pair = get_pair_fmt(he, dfmt);
1017 	int idx = dfmt->idx;
1018 
1019 	/* baseline is special */
1020 	if (idx == PERF_HPP_DIFF__BASELINE)
1021 		hpp__entry_baseline(he, buf, size);
1022 	else {
1023 		if (pair)
1024 			hpp__entry_pair(he, pair, idx, buf, size);
1025 		else
1026 			hpp__entry_unpair(he, idx, buf, size);
1027 	}
1028 }
1029 
hpp__entry_global(struct perf_hpp_fmt * _fmt,struct perf_hpp * hpp,struct hist_entry * he)1030 static int hpp__entry_global(struct perf_hpp_fmt *_fmt, struct perf_hpp *hpp,
1031 			     struct hist_entry *he)
1032 {
1033 	struct diff_hpp_fmt *dfmt =
1034 		container_of(_fmt, struct diff_hpp_fmt, fmt);
1035 	char buf[MAX_COL_WIDTH] = " ";
1036 
1037 	__hpp__entry_global(he, dfmt, buf, MAX_COL_WIDTH);
1038 
1039 	if (symbol_conf.field_sep)
1040 		return scnprintf(hpp->buf, hpp->size, "%s", buf);
1041 	else
1042 		return scnprintf(hpp->buf, hpp->size, "%*s",
1043 				 dfmt->header_width, buf);
1044 }
1045 
hpp__header(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp,struct perf_evsel * evsel __maybe_unused)1046 static int hpp__header(struct perf_hpp_fmt *fmt, struct perf_hpp *hpp,
1047 		       struct perf_evsel *evsel __maybe_unused)
1048 {
1049 	struct diff_hpp_fmt *dfmt =
1050 		container_of(fmt, struct diff_hpp_fmt, fmt);
1051 
1052 	BUG_ON(!dfmt->header);
1053 	return scnprintf(hpp->buf, hpp->size, dfmt->header);
1054 }
1055 
hpp__width(struct perf_hpp_fmt * fmt,struct perf_hpp * hpp __maybe_unused,struct perf_evsel * evsel __maybe_unused)1056 static int hpp__width(struct perf_hpp_fmt *fmt,
1057 		      struct perf_hpp *hpp __maybe_unused,
1058 		      struct perf_evsel *evsel __maybe_unused)
1059 {
1060 	struct diff_hpp_fmt *dfmt =
1061 		container_of(fmt, struct diff_hpp_fmt, fmt);
1062 
1063 	BUG_ON(dfmt->header_width <= 0);
1064 	return dfmt->header_width;
1065 }
1066 
init_header(struct data__file * d,struct diff_hpp_fmt * dfmt)1067 static void init_header(struct data__file *d, struct diff_hpp_fmt *dfmt)
1068 {
1069 #define MAX_HEADER_NAME 100
1070 	char buf_indent[MAX_HEADER_NAME];
1071 	char buf[MAX_HEADER_NAME];
1072 	const char *header = NULL;
1073 	int width = 0;
1074 
1075 	BUG_ON(dfmt->idx >= PERF_HPP_DIFF__MAX_INDEX);
1076 	header = columns[dfmt->idx].name;
1077 	width  = columns[dfmt->idx].width;
1078 
1079 	/* Only our defined HPP fmts should appear here. */
1080 	BUG_ON(!header);
1081 
1082 	if (data__files_cnt > 2)
1083 		scnprintf(buf, MAX_HEADER_NAME, "%s/%d", header, d->idx);
1084 
1085 #define NAME (data__files_cnt > 2 ? buf : header)
1086 	dfmt->header_width = width;
1087 	width = (int) strlen(NAME);
1088 	if (dfmt->header_width < width)
1089 		dfmt->header_width = width;
1090 
1091 	scnprintf(buf_indent, MAX_HEADER_NAME, "%*s",
1092 		  dfmt->header_width, NAME);
1093 
1094 	dfmt->header = strdup(buf_indent);
1095 #undef MAX_HEADER_NAME
1096 #undef NAME
1097 }
1098 
data__hpp_register(struct data__file * d,int idx)1099 static void data__hpp_register(struct data__file *d, int idx)
1100 {
1101 	struct diff_hpp_fmt *dfmt = &d->fmt[idx];
1102 	struct perf_hpp_fmt *fmt = &dfmt->fmt;
1103 
1104 	dfmt->idx = idx;
1105 
1106 	fmt->header = hpp__header;
1107 	fmt->width  = hpp__width;
1108 	fmt->entry  = hpp__entry_global;
1109 	fmt->cmp    = hist_entry__cmp_nop;
1110 	fmt->collapse = hist_entry__cmp_nop;
1111 
1112 	/* TODO more colors */
1113 	switch (idx) {
1114 	case PERF_HPP_DIFF__BASELINE:
1115 		fmt->color = hpp__color_baseline;
1116 		fmt->sort  = hist_entry__cmp_baseline;
1117 		break;
1118 	case PERF_HPP_DIFF__DELTA:
1119 		fmt->color = hpp__color_delta;
1120 		fmt->sort  = hist_entry__cmp_delta;
1121 		break;
1122 	case PERF_HPP_DIFF__RATIO:
1123 		fmt->color = hpp__color_ratio;
1124 		fmt->sort  = hist_entry__cmp_ratio;
1125 		break;
1126 	case PERF_HPP_DIFF__WEIGHTED_DIFF:
1127 		fmt->color = hpp__color_wdiff;
1128 		fmt->sort  = hist_entry__cmp_wdiff;
1129 		break;
1130 	default:
1131 		fmt->sort  = hist_entry__cmp_nop;
1132 		break;
1133 	}
1134 
1135 	init_header(d, dfmt);
1136 	perf_hpp__column_register(fmt);
1137 	perf_hpp__register_sort_field(fmt);
1138 }
1139 
ui_init(void)1140 static int ui_init(void)
1141 {
1142 	struct data__file *d;
1143 	struct perf_hpp_fmt *fmt;
1144 	int i;
1145 
1146 	data__for_each_file(i, d) {
1147 
1148 		/*
1149 		 * Baseline or compute realted columns:
1150 		 *
1151 		 *   PERF_HPP_DIFF__BASELINE
1152 		 *   PERF_HPP_DIFF__DELTA
1153 		 *   PERF_HPP_DIFF__RATIO
1154 		 *   PERF_HPP_DIFF__WEIGHTED_DIFF
1155 		 */
1156 		data__hpp_register(d, i ? compute_2_hpp[compute] :
1157 					  PERF_HPP_DIFF__BASELINE);
1158 
1159 		/*
1160 		 * And the rest:
1161 		 *
1162 		 * PERF_HPP_DIFF__FORMULA
1163 		 * PERF_HPP_DIFF__PERIOD
1164 		 * PERF_HPP_DIFF__PERIOD_BASELINE
1165 		 */
1166 		if (show_formula && i)
1167 			data__hpp_register(d, PERF_HPP_DIFF__FORMULA);
1168 
1169 		if (show_period)
1170 			data__hpp_register(d, i ? PERF_HPP_DIFF__PERIOD :
1171 						  PERF_HPP_DIFF__PERIOD_BASELINE);
1172 	}
1173 
1174 	if (!sort_compute)
1175 		return 0;
1176 
1177 	/*
1178 	 * Prepend an fmt to sort on columns at 'sort_compute' first.
1179 	 * This fmt is added only to the sort list but not to the
1180 	 * output fields list.
1181 	 *
1182 	 * Note that this column (data) can be compared twice - one
1183 	 * for this 'sort_compute' fmt and another for the normal
1184 	 * diff_hpp_fmt.  But it shouldn't a problem as most entries
1185 	 * will be sorted out by first try or baseline and comparing
1186 	 * is not a costly operation.
1187 	 */
1188 	fmt = zalloc(sizeof(*fmt));
1189 	if (fmt == NULL) {
1190 		pr_err("Memory allocation failed\n");
1191 		return -1;
1192 	}
1193 
1194 	fmt->cmp      = hist_entry__cmp_nop;
1195 	fmt->collapse = hist_entry__cmp_nop;
1196 
1197 	switch (compute) {
1198 	case COMPUTE_DELTA:
1199 		fmt->sort = hist_entry__cmp_delta_idx;
1200 		break;
1201 	case COMPUTE_RATIO:
1202 		fmt->sort = hist_entry__cmp_ratio_idx;
1203 		break;
1204 	case COMPUTE_WEIGHTED_DIFF:
1205 		fmt->sort = hist_entry__cmp_wdiff_idx;
1206 		break;
1207 	default:
1208 		BUG_ON(1);
1209 	}
1210 
1211 	list_add(&fmt->sort_list, &perf_hpp__sort_list);
1212 	return 0;
1213 }
1214 
data_init(int argc,const char ** argv)1215 static int data_init(int argc, const char **argv)
1216 {
1217 	struct data__file *d;
1218 	static const char *defaults[] = {
1219 		"perf.data.old",
1220 		"perf.data",
1221 	};
1222 	bool use_default = true;
1223 	int i;
1224 
1225 	data__files_cnt = 2;
1226 
1227 	if (argc) {
1228 		if (argc == 1)
1229 			defaults[1] = argv[0];
1230 		else {
1231 			data__files_cnt = argc;
1232 			use_default = false;
1233 		}
1234 	} else if (perf_guest) {
1235 		defaults[0] = "perf.data.host";
1236 		defaults[1] = "perf.data.guest";
1237 	}
1238 
1239 	if (sort_compute >= (unsigned int) data__files_cnt) {
1240 		pr_err("Order option out of limit.\n");
1241 		return -EINVAL;
1242 	}
1243 
1244 	data__files = zalloc(sizeof(*data__files) * data__files_cnt);
1245 	if (!data__files)
1246 		return -ENOMEM;
1247 
1248 	data__for_each_file(i, d) {
1249 		struct perf_data_file *file = &d->file;
1250 
1251 		file->path  = use_default ? defaults[i] : argv[i];
1252 		file->mode  = PERF_DATA_MODE_READ,
1253 		file->force = force,
1254 
1255 		d->idx  = i;
1256 	}
1257 
1258 	return 0;
1259 }
1260 
cmd_diff(int argc,const char ** argv,const char * prefix __maybe_unused)1261 int cmd_diff(int argc, const char **argv, const char *prefix __maybe_unused)
1262 {
1263 	int ret = hists__init();
1264 
1265 	if (ret < 0)
1266 		return ret;
1267 
1268 	perf_config(perf_default_config, NULL);
1269 
1270 	argc = parse_options(argc, argv, options, diff_usage, 0);
1271 
1272 	if (symbol__init(NULL) < 0)
1273 		return -1;
1274 
1275 	if (data_init(argc, argv) < 0)
1276 		return -1;
1277 
1278 	if (ui_init() < 0)
1279 		return -1;
1280 
1281 	sort__mode = SORT_MODE__DIFF;
1282 
1283 	if (setup_sorting() < 0)
1284 		usage_with_options(diff_usage, options);
1285 
1286 	setup_pager();
1287 
1288 	sort__setup_elide(NULL);
1289 
1290 	return __cmd_diff();
1291 }
1292