xref: /openbmc/linux/tools/perf/util/annotate.c (revision 6774def6)
1 /*
2  * Copyright (C) 2011, Red Hat Inc, Arnaldo Carvalho de Melo <acme@redhat.com>
3  *
4  * Parts came from builtin-annotate.c, see those files for further
5  * copyright notes.
6  *
7  * Released under the GPL v2. (and only v2, not any later version)
8  */
9 
10 #include "util.h"
11 #include "ui/ui.h"
12 #include "sort.h"
13 #include "build-id.h"
14 #include "color.h"
15 #include "cache.h"
16 #include "symbol.h"
17 #include "debug.h"
18 #include "annotate.h"
19 #include "evsel.h"
20 #include <pthread.h>
21 #include <linux/bitops.h>
22 
23 const char 	*disassembler_style;
24 const char	*objdump_path;
25 
26 static struct ins *ins__find(const char *name);
27 static int disasm_line__parse(char *line, char **namep, char **rawp);
28 
29 static void ins__delete(struct ins_operands *ops)
30 {
31 	zfree(&ops->source.raw);
32 	zfree(&ops->source.name);
33 	zfree(&ops->target.raw);
34 	zfree(&ops->target.name);
35 }
36 
37 static int ins__raw_scnprintf(struct ins *ins, char *bf, size_t size,
38 			      struct ins_operands *ops)
39 {
40 	return scnprintf(bf, size, "%-6.6s %s", ins->name, ops->raw);
41 }
42 
43 int ins__scnprintf(struct ins *ins, char *bf, size_t size,
44 		  struct ins_operands *ops)
45 {
46 	if (ins->ops->scnprintf)
47 		return ins->ops->scnprintf(ins, bf, size, ops);
48 
49 	return ins__raw_scnprintf(ins, bf, size, ops);
50 }
51 
52 static int call__parse(struct ins_operands *ops)
53 {
54 	char *endptr, *tok, *name;
55 
56 	ops->target.addr = strtoull(ops->raw, &endptr, 16);
57 
58 	name = strchr(endptr, '<');
59 	if (name == NULL)
60 		goto indirect_call;
61 
62 	name++;
63 
64 	tok = strchr(name, '>');
65 	if (tok == NULL)
66 		return -1;
67 
68 	*tok = '\0';
69 	ops->target.name = strdup(name);
70 	*tok = '>';
71 
72 	return ops->target.name == NULL ? -1 : 0;
73 
74 indirect_call:
75 	tok = strchr(endptr, '(');
76 	if (tok != NULL) {
77 		ops->target.addr = 0;
78 		return 0;
79 	}
80 
81 	tok = strchr(endptr, '*');
82 	if (tok == NULL)
83 		return -1;
84 
85 	ops->target.addr = strtoull(tok + 1, NULL, 16);
86 	return 0;
87 }
88 
89 static int call__scnprintf(struct ins *ins, char *bf, size_t size,
90 			   struct ins_operands *ops)
91 {
92 	if (ops->target.name)
93 		return scnprintf(bf, size, "%-6.6s %s", ins->name, ops->target.name);
94 
95 	if (ops->target.addr == 0)
96 		return ins__raw_scnprintf(ins, bf, size, ops);
97 
98 	return scnprintf(bf, size, "%-6.6s *%" PRIx64, ins->name, ops->target.addr);
99 }
100 
101 static struct ins_ops call_ops = {
102 	.parse	   = call__parse,
103 	.scnprintf = call__scnprintf,
104 };
105 
106 bool ins__is_call(const struct ins *ins)
107 {
108 	return ins->ops == &call_ops;
109 }
110 
111 static int jump__parse(struct ins_operands *ops)
112 {
113 	const char *s = strchr(ops->raw, '+');
114 
115 	ops->target.addr = strtoull(ops->raw, NULL, 16);
116 
117 	if (s++ != NULL)
118 		ops->target.offset = strtoull(s, NULL, 16);
119 	else
120 		ops->target.offset = UINT64_MAX;
121 
122 	return 0;
123 }
124 
125 static int jump__scnprintf(struct ins *ins, char *bf, size_t size,
126 			   struct ins_operands *ops)
127 {
128 	return scnprintf(bf, size, "%-6.6s %" PRIx64, ins->name, ops->target.offset);
129 }
130 
131 static struct ins_ops jump_ops = {
132 	.parse	   = jump__parse,
133 	.scnprintf = jump__scnprintf,
134 };
135 
136 bool ins__is_jump(const struct ins *ins)
137 {
138 	return ins->ops == &jump_ops;
139 }
140 
141 static int comment__symbol(char *raw, char *comment, u64 *addrp, char **namep)
142 {
143 	char *endptr, *name, *t;
144 
145 	if (strstr(raw, "(%rip)") == NULL)
146 		return 0;
147 
148 	*addrp = strtoull(comment, &endptr, 16);
149 	name = strchr(endptr, '<');
150 	if (name == NULL)
151 		return -1;
152 
153 	name++;
154 
155 	t = strchr(name, '>');
156 	if (t == NULL)
157 		return 0;
158 
159 	*t = '\0';
160 	*namep = strdup(name);
161 	*t = '>';
162 
163 	return 0;
164 }
165 
166 static int lock__parse(struct ins_operands *ops)
167 {
168 	char *name;
169 
170 	ops->locked.ops = zalloc(sizeof(*ops->locked.ops));
171 	if (ops->locked.ops == NULL)
172 		return 0;
173 
174 	if (disasm_line__parse(ops->raw, &name, &ops->locked.ops->raw) < 0)
175 		goto out_free_ops;
176 
177 	ops->locked.ins = ins__find(name);
178 	if (ops->locked.ins == NULL)
179 		goto out_free_ops;
180 
181 	if (!ops->locked.ins->ops)
182 		return 0;
183 
184 	if (ops->locked.ins->ops->parse)
185 		ops->locked.ins->ops->parse(ops->locked.ops);
186 
187 	return 0;
188 
189 out_free_ops:
190 	zfree(&ops->locked.ops);
191 	return 0;
192 }
193 
194 static int lock__scnprintf(struct ins *ins, char *bf, size_t size,
195 			   struct ins_operands *ops)
196 {
197 	int printed;
198 
199 	if (ops->locked.ins == NULL)
200 		return ins__raw_scnprintf(ins, bf, size, ops);
201 
202 	printed = scnprintf(bf, size, "%-6.6s ", ins->name);
203 	return printed + ins__scnprintf(ops->locked.ins, bf + printed,
204 					size - printed, ops->locked.ops);
205 }
206 
207 static void lock__delete(struct ins_operands *ops)
208 {
209 	zfree(&ops->locked.ops);
210 	zfree(&ops->target.raw);
211 	zfree(&ops->target.name);
212 }
213 
214 static struct ins_ops lock_ops = {
215 	.free	   = lock__delete,
216 	.parse	   = lock__parse,
217 	.scnprintf = lock__scnprintf,
218 };
219 
220 static int mov__parse(struct ins_operands *ops)
221 {
222 	char *s = strchr(ops->raw, ','), *target, *comment, prev;
223 
224 	if (s == NULL)
225 		return -1;
226 
227 	*s = '\0';
228 	ops->source.raw = strdup(ops->raw);
229 	*s = ',';
230 
231 	if (ops->source.raw == NULL)
232 		return -1;
233 
234 	target = ++s;
235 	comment = strchr(s, '#');
236 
237 	if (comment != NULL)
238 		s = comment - 1;
239 	else
240 		s = strchr(s, '\0') - 1;
241 
242 	while (s > target && isspace(s[0]))
243 		--s;
244 	s++;
245 	prev = *s;
246 	*s = '\0';
247 
248 	ops->target.raw = strdup(target);
249 	*s = prev;
250 
251 	if (ops->target.raw == NULL)
252 		goto out_free_source;
253 
254 	if (comment == NULL)
255 		return 0;
256 
257 	while (comment[0] != '\0' && isspace(comment[0]))
258 		++comment;
259 
260 	comment__symbol(ops->source.raw, comment, &ops->source.addr, &ops->source.name);
261 	comment__symbol(ops->target.raw, comment, &ops->target.addr, &ops->target.name);
262 
263 	return 0;
264 
265 out_free_source:
266 	zfree(&ops->source.raw);
267 	return -1;
268 }
269 
270 static int mov__scnprintf(struct ins *ins, char *bf, size_t size,
271 			   struct ins_operands *ops)
272 {
273 	return scnprintf(bf, size, "%-6.6s %s,%s", ins->name,
274 			 ops->source.name ?: ops->source.raw,
275 			 ops->target.name ?: ops->target.raw);
276 }
277 
278 static struct ins_ops mov_ops = {
279 	.parse	   = mov__parse,
280 	.scnprintf = mov__scnprintf,
281 };
282 
283 static int dec__parse(struct ins_operands *ops)
284 {
285 	char *target, *comment, *s, prev;
286 
287 	target = s = ops->raw;
288 
289 	while (s[0] != '\0' && !isspace(s[0]))
290 		++s;
291 	prev = *s;
292 	*s = '\0';
293 
294 	ops->target.raw = strdup(target);
295 	*s = prev;
296 
297 	if (ops->target.raw == NULL)
298 		return -1;
299 
300 	comment = strchr(s, '#');
301 	if (comment == NULL)
302 		return 0;
303 
304 	while (comment[0] != '\0' && isspace(comment[0]))
305 		++comment;
306 
307 	comment__symbol(ops->target.raw, comment, &ops->target.addr, &ops->target.name);
308 
309 	return 0;
310 }
311 
312 static int dec__scnprintf(struct ins *ins, char *bf, size_t size,
313 			   struct ins_operands *ops)
314 {
315 	return scnprintf(bf, size, "%-6.6s %s", ins->name,
316 			 ops->target.name ?: ops->target.raw);
317 }
318 
319 static struct ins_ops dec_ops = {
320 	.parse	   = dec__parse,
321 	.scnprintf = dec__scnprintf,
322 };
323 
324 static int nop__scnprintf(struct ins *ins __maybe_unused, char *bf, size_t size,
325 			  struct ins_operands *ops __maybe_unused)
326 {
327 	return scnprintf(bf, size, "%-6.6s", "nop");
328 }
329 
330 static struct ins_ops nop_ops = {
331 	.scnprintf = nop__scnprintf,
332 };
333 
334 /*
335  * Must be sorted by name!
336  */
337 static struct ins instructions[] = {
338 	{ .name = "add",   .ops  = &mov_ops, },
339 	{ .name = "addl",  .ops  = &mov_ops, },
340 	{ .name = "addq",  .ops  = &mov_ops, },
341 	{ .name = "addw",  .ops  = &mov_ops, },
342 	{ .name = "and",   .ops  = &mov_ops, },
343 	{ .name = "bts",   .ops  = &mov_ops, },
344 	{ .name = "call",  .ops  = &call_ops, },
345 	{ .name = "callq", .ops  = &call_ops, },
346 	{ .name = "cmp",   .ops  = &mov_ops, },
347 	{ .name = "cmpb",  .ops  = &mov_ops, },
348 	{ .name = "cmpl",  .ops  = &mov_ops, },
349 	{ .name = "cmpq",  .ops  = &mov_ops, },
350 	{ .name = "cmpw",  .ops  = &mov_ops, },
351 	{ .name = "cmpxch", .ops  = &mov_ops, },
352 	{ .name = "dec",   .ops  = &dec_ops, },
353 	{ .name = "decl",  .ops  = &dec_ops, },
354 	{ .name = "imul",  .ops  = &mov_ops, },
355 	{ .name = "inc",   .ops  = &dec_ops, },
356 	{ .name = "incl",  .ops  = &dec_ops, },
357 	{ .name = "ja",	   .ops  = &jump_ops, },
358 	{ .name = "jae",   .ops  = &jump_ops, },
359 	{ .name = "jb",	   .ops  = &jump_ops, },
360 	{ .name = "jbe",   .ops  = &jump_ops, },
361 	{ .name = "jc",	   .ops  = &jump_ops, },
362 	{ .name = "jcxz",  .ops  = &jump_ops, },
363 	{ .name = "je",	   .ops  = &jump_ops, },
364 	{ .name = "jecxz", .ops  = &jump_ops, },
365 	{ .name = "jg",	   .ops  = &jump_ops, },
366 	{ .name = "jge",   .ops  = &jump_ops, },
367 	{ .name = "jl",    .ops  = &jump_ops, },
368 	{ .name = "jle",   .ops  = &jump_ops, },
369 	{ .name = "jmp",   .ops  = &jump_ops, },
370 	{ .name = "jmpq",  .ops  = &jump_ops, },
371 	{ .name = "jna",   .ops  = &jump_ops, },
372 	{ .name = "jnae",  .ops  = &jump_ops, },
373 	{ .name = "jnb",   .ops  = &jump_ops, },
374 	{ .name = "jnbe",  .ops  = &jump_ops, },
375 	{ .name = "jnc",   .ops  = &jump_ops, },
376 	{ .name = "jne",   .ops  = &jump_ops, },
377 	{ .name = "jng",   .ops  = &jump_ops, },
378 	{ .name = "jnge",  .ops  = &jump_ops, },
379 	{ .name = "jnl",   .ops  = &jump_ops, },
380 	{ .name = "jnle",  .ops  = &jump_ops, },
381 	{ .name = "jno",   .ops  = &jump_ops, },
382 	{ .name = "jnp",   .ops  = &jump_ops, },
383 	{ .name = "jns",   .ops  = &jump_ops, },
384 	{ .name = "jnz",   .ops  = &jump_ops, },
385 	{ .name = "jo",	   .ops  = &jump_ops, },
386 	{ .name = "jp",	   .ops  = &jump_ops, },
387 	{ .name = "jpe",   .ops  = &jump_ops, },
388 	{ .name = "jpo",   .ops  = &jump_ops, },
389 	{ .name = "jrcxz", .ops  = &jump_ops, },
390 	{ .name = "js",	   .ops  = &jump_ops, },
391 	{ .name = "jz",	   .ops  = &jump_ops, },
392 	{ .name = "lea",   .ops  = &mov_ops, },
393 	{ .name = "lock",  .ops  = &lock_ops, },
394 	{ .name = "mov",   .ops  = &mov_ops, },
395 	{ .name = "movb",  .ops  = &mov_ops, },
396 	{ .name = "movdqa",.ops  = &mov_ops, },
397 	{ .name = "movl",  .ops  = &mov_ops, },
398 	{ .name = "movq",  .ops  = &mov_ops, },
399 	{ .name = "movslq", .ops  = &mov_ops, },
400 	{ .name = "movzbl", .ops  = &mov_ops, },
401 	{ .name = "movzwl", .ops  = &mov_ops, },
402 	{ .name = "nop",   .ops  = &nop_ops, },
403 	{ .name = "nopl",  .ops  = &nop_ops, },
404 	{ .name = "nopw",  .ops  = &nop_ops, },
405 	{ .name = "or",    .ops  = &mov_ops, },
406 	{ .name = "orl",   .ops  = &mov_ops, },
407 	{ .name = "test",  .ops  = &mov_ops, },
408 	{ .name = "testb", .ops  = &mov_ops, },
409 	{ .name = "testl", .ops  = &mov_ops, },
410 	{ .name = "xadd",  .ops  = &mov_ops, },
411 	{ .name = "xbeginl", .ops  = &jump_ops, },
412 	{ .name = "xbeginq", .ops  = &jump_ops, },
413 };
414 
415 static int ins__cmp(const void *name, const void *insp)
416 {
417 	const struct ins *ins = insp;
418 
419 	return strcmp(name, ins->name);
420 }
421 
422 static struct ins *ins__find(const char *name)
423 {
424 	const int nmemb = ARRAY_SIZE(instructions);
425 
426 	return bsearch(name, instructions, nmemb, sizeof(struct ins), ins__cmp);
427 }
428 
429 int symbol__annotate_init(struct map *map __maybe_unused, struct symbol *sym)
430 {
431 	struct annotation *notes = symbol__annotation(sym);
432 	pthread_mutex_init(&notes->lock, NULL);
433 	return 0;
434 }
435 
436 int symbol__alloc_hist(struct symbol *sym)
437 {
438 	struct annotation *notes = symbol__annotation(sym);
439 	const size_t size = symbol__size(sym);
440 	size_t sizeof_sym_hist;
441 
442 	/* Check for overflow when calculating sizeof_sym_hist */
443 	if (size > (SIZE_MAX - sizeof(struct sym_hist)) / sizeof(u64))
444 		return -1;
445 
446 	sizeof_sym_hist = (sizeof(struct sym_hist) + size * sizeof(u64));
447 
448 	/* Check for overflow in zalloc argument */
449 	if (sizeof_sym_hist > (SIZE_MAX - sizeof(*notes->src))
450 				/ symbol_conf.nr_events)
451 		return -1;
452 
453 	notes->src = zalloc(sizeof(*notes->src) + symbol_conf.nr_events * sizeof_sym_hist);
454 	if (notes->src == NULL)
455 		return -1;
456 	notes->src->sizeof_sym_hist = sizeof_sym_hist;
457 	notes->src->nr_histograms   = symbol_conf.nr_events;
458 	INIT_LIST_HEAD(&notes->src->source);
459 	return 0;
460 }
461 
462 void symbol__annotate_zero_histograms(struct symbol *sym)
463 {
464 	struct annotation *notes = symbol__annotation(sym);
465 
466 	pthread_mutex_lock(&notes->lock);
467 	if (notes->src != NULL)
468 		memset(notes->src->histograms, 0,
469 		       notes->src->nr_histograms * notes->src->sizeof_sym_hist);
470 	pthread_mutex_unlock(&notes->lock);
471 }
472 
473 static int __symbol__inc_addr_samples(struct symbol *sym, struct map *map,
474 				      struct annotation *notes, int evidx, u64 addr)
475 {
476 	unsigned offset;
477 	struct sym_hist *h;
478 
479 	pr_debug3("%s: addr=%#" PRIx64 "\n", __func__, map->unmap_ip(map, addr));
480 
481 	if (addr < sym->start || addr >= sym->end)
482 		return -ERANGE;
483 
484 	offset = addr - sym->start;
485 	h = annotation__histogram(notes, evidx);
486 	h->sum++;
487 	h->addr[offset]++;
488 
489 	pr_debug3("%#" PRIx64 " %s: period++ [addr: %#" PRIx64 ", %#" PRIx64
490 		  ", evidx=%d] => %" PRIu64 "\n", sym->start, sym->name,
491 		  addr, addr - sym->start, evidx, h->addr[offset]);
492 	return 0;
493 }
494 
495 static int symbol__inc_addr_samples(struct symbol *sym, struct map *map,
496 				    int evidx, u64 addr)
497 {
498 	struct annotation *notes;
499 
500 	if (sym == NULL)
501 		return 0;
502 
503 	notes = symbol__annotation(sym);
504 	if (notes->src == NULL) {
505 		if (symbol__alloc_hist(sym) < 0)
506 			return -ENOMEM;
507 	}
508 
509 	return __symbol__inc_addr_samples(sym, map, notes, evidx, addr);
510 }
511 
512 int addr_map_symbol__inc_samples(struct addr_map_symbol *ams, int evidx)
513 {
514 	return symbol__inc_addr_samples(ams->sym, ams->map, evidx, ams->al_addr);
515 }
516 
517 int hist_entry__inc_addr_samples(struct hist_entry *he, int evidx, u64 ip)
518 {
519 	return symbol__inc_addr_samples(he->ms.sym, he->ms.map, evidx, ip);
520 }
521 
522 static void disasm_line__init_ins(struct disasm_line *dl)
523 {
524 	dl->ins = ins__find(dl->name);
525 
526 	if (dl->ins == NULL)
527 		return;
528 
529 	if (!dl->ins->ops)
530 		return;
531 
532 	if (dl->ins->ops->parse)
533 		dl->ins->ops->parse(&dl->ops);
534 }
535 
536 static int disasm_line__parse(char *line, char **namep, char **rawp)
537 {
538 	char *name = line, tmp;
539 
540 	while (isspace(name[0]))
541 		++name;
542 
543 	if (name[0] == '\0')
544 		return -1;
545 
546 	*rawp = name + 1;
547 
548 	while ((*rawp)[0] != '\0' && !isspace((*rawp)[0]))
549 		++*rawp;
550 
551 	tmp = (*rawp)[0];
552 	(*rawp)[0] = '\0';
553 	*namep = strdup(name);
554 
555 	if (*namep == NULL)
556 		goto out_free_name;
557 
558 	(*rawp)[0] = tmp;
559 
560 	if ((*rawp)[0] != '\0') {
561 		(*rawp)++;
562 		while (isspace((*rawp)[0]))
563 			++(*rawp);
564 	}
565 
566 	return 0;
567 
568 out_free_name:
569 	zfree(namep);
570 	return -1;
571 }
572 
573 static struct disasm_line *disasm_line__new(s64 offset, char *line, size_t privsize)
574 {
575 	struct disasm_line *dl = zalloc(sizeof(*dl) + privsize);
576 
577 	if (dl != NULL) {
578 		dl->offset = offset;
579 		dl->line = strdup(line);
580 		if (dl->line == NULL)
581 			goto out_delete;
582 
583 		if (offset != -1) {
584 			if (disasm_line__parse(dl->line, &dl->name, &dl->ops.raw) < 0)
585 				goto out_free_line;
586 
587 			disasm_line__init_ins(dl);
588 		}
589 	}
590 
591 	return dl;
592 
593 out_free_line:
594 	zfree(&dl->line);
595 out_delete:
596 	free(dl);
597 	return NULL;
598 }
599 
600 void disasm_line__free(struct disasm_line *dl)
601 {
602 	zfree(&dl->line);
603 	zfree(&dl->name);
604 	if (dl->ins && dl->ins->ops->free)
605 		dl->ins->ops->free(&dl->ops);
606 	else
607 		ins__delete(&dl->ops);
608 	free(dl);
609 }
610 
611 int disasm_line__scnprintf(struct disasm_line *dl, char *bf, size_t size, bool raw)
612 {
613 	if (raw || !dl->ins)
614 		return scnprintf(bf, size, "%-6.6s %s", dl->name, dl->ops.raw);
615 
616 	return ins__scnprintf(dl->ins, bf, size, &dl->ops);
617 }
618 
619 static void disasm__add(struct list_head *head, struct disasm_line *line)
620 {
621 	list_add_tail(&line->node, head);
622 }
623 
624 struct disasm_line *disasm__get_next_ip_line(struct list_head *head, struct disasm_line *pos)
625 {
626 	list_for_each_entry_continue(pos, head, node)
627 		if (pos->offset >= 0)
628 			return pos;
629 
630 	return NULL;
631 }
632 
633 double disasm__calc_percent(struct annotation *notes, int evidx, s64 offset,
634 			    s64 end, const char **path)
635 {
636 	struct source_line *src_line = notes->src->lines;
637 	double percent = 0.0;
638 
639 	if (src_line) {
640 		size_t sizeof_src_line = sizeof(*src_line) +
641 				sizeof(src_line->p) * (src_line->nr_pcnt - 1);
642 
643 		while (offset < end) {
644 			src_line = (void *)notes->src->lines +
645 					(sizeof_src_line * offset);
646 
647 			if (*path == NULL)
648 				*path = src_line->path;
649 
650 			percent += src_line->p[evidx].percent;
651 			offset++;
652 		}
653 	} else {
654 		struct sym_hist *h = annotation__histogram(notes, evidx);
655 		unsigned int hits = 0;
656 
657 		while (offset < end)
658 			hits += h->addr[offset++];
659 
660 		if (h->sum)
661 			percent = 100.0 * hits / h->sum;
662 	}
663 
664 	return percent;
665 }
666 
667 static int disasm_line__print(struct disasm_line *dl, struct symbol *sym, u64 start,
668 		      struct perf_evsel *evsel, u64 len, int min_pcnt, int printed,
669 		      int max_lines, struct disasm_line *queue)
670 {
671 	static const char *prev_line;
672 	static const char *prev_color;
673 
674 	if (dl->offset != -1) {
675 		const char *path = NULL;
676 		double percent, max_percent = 0.0;
677 		double *ppercents = &percent;
678 		int i, nr_percent = 1;
679 		const char *color;
680 		struct annotation *notes = symbol__annotation(sym);
681 		s64 offset = dl->offset;
682 		const u64 addr = start + offset;
683 		struct disasm_line *next;
684 
685 		next = disasm__get_next_ip_line(&notes->src->source, dl);
686 
687 		if (perf_evsel__is_group_event(evsel)) {
688 			nr_percent = evsel->nr_members;
689 			ppercents = calloc(nr_percent, sizeof(double));
690 			if (ppercents == NULL)
691 				return -1;
692 		}
693 
694 		for (i = 0; i < nr_percent; i++) {
695 			percent = disasm__calc_percent(notes,
696 					notes->src->lines ? i : evsel->idx + i,
697 					offset,
698 					next ? next->offset : (s64) len,
699 					&path);
700 
701 			ppercents[i] = percent;
702 			if (percent > max_percent)
703 				max_percent = percent;
704 		}
705 
706 		if (max_percent < min_pcnt)
707 			return -1;
708 
709 		if (max_lines && printed >= max_lines)
710 			return 1;
711 
712 		if (queue != NULL) {
713 			list_for_each_entry_from(queue, &notes->src->source, node) {
714 				if (queue == dl)
715 					break;
716 				disasm_line__print(queue, sym, start, evsel, len,
717 						    0, 0, 1, NULL);
718 			}
719 		}
720 
721 		color = get_percent_color(max_percent);
722 
723 		/*
724 		 * Also color the filename and line if needed, with
725 		 * the same color than the percentage. Don't print it
726 		 * twice for close colored addr with the same filename:line
727 		 */
728 		if (path) {
729 			if (!prev_line || strcmp(prev_line, path)
730 				       || color != prev_color) {
731 				color_fprintf(stdout, color, " %s", path);
732 				prev_line = path;
733 				prev_color = color;
734 			}
735 		}
736 
737 		for (i = 0; i < nr_percent; i++) {
738 			percent = ppercents[i];
739 			color = get_percent_color(percent);
740 			color_fprintf(stdout, color, " %7.2f", percent);
741 		}
742 
743 		printf(" :	");
744 		color_fprintf(stdout, PERF_COLOR_MAGENTA, "  %" PRIx64 ":", addr);
745 		color_fprintf(stdout, PERF_COLOR_BLUE, "%s\n", dl->line);
746 
747 		if (ppercents != &percent)
748 			free(ppercents);
749 
750 	} else if (max_lines && printed >= max_lines)
751 		return 1;
752 	else {
753 		int width = 8;
754 
755 		if (queue)
756 			return -1;
757 
758 		if (perf_evsel__is_group_event(evsel))
759 			width *= evsel->nr_members;
760 
761 		if (!*dl->line)
762 			printf(" %*s:\n", width, " ");
763 		else
764 			printf(" %*s:	%s\n", width, " ", dl->line);
765 	}
766 
767 	return 0;
768 }
769 
770 /*
771  * symbol__parse_objdump_line() parses objdump output (with -d --no-show-raw)
772  * which looks like following
773  *
774  *  0000000000415500 <_init>:
775  *    415500:       sub    $0x8,%rsp
776  *    415504:       mov    0x2f5ad5(%rip),%rax        # 70afe0 <_DYNAMIC+0x2f8>
777  *    41550b:       test   %rax,%rax
778  *    41550e:       je     415515 <_init+0x15>
779  *    415510:       callq  416e70 <__gmon_start__@plt>
780  *    415515:       add    $0x8,%rsp
781  *    415519:       retq
782  *
783  * it will be parsed and saved into struct disasm_line as
784  *  <offset>       <name>  <ops.raw>
785  *
786  * The offset will be a relative offset from the start of the symbol and -1
787  * means that it's not a disassembly line so should be treated differently.
788  * The ops.raw part will be parsed further according to type of the instruction.
789  */
790 static int symbol__parse_objdump_line(struct symbol *sym, struct map *map,
791 				      FILE *file, size_t privsize)
792 {
793 	struct annotation *notes = symbol__annotation(sym);
794 	struct disasm_line *dl;
795 	char *line = NULL, *parsed_line, *tmp, *tmp2, *c;
796 	size_t line_len;
797 	s64 line_ip, offset = -1;
798 
799 	if (getline(&line, &line_len, file) < 0)
800 		return -1;
801 
802 	if (!line)
803 		return -1;
804 
805 	while (line_len != 0 && isspace(line[line_len - 1]))
806 		line[--line_len] = '\0';
807 
808 	c = strchr(line, '\n');
809 	if (c)
810 		*c = 0;
811 
812 	line_ip = -1;
813 	parsed_line = line;
814 
815 	/*
816 	 * Strip leading spaces:
817 	 */
818 	tmp = line;
819 	while (*tmp) {
820 		if (*tmp != ' ')
821 			break;
822 		tmp++;
823 	}
824 
825 	if (*tmp) {
826 		/*
827 		 * Parse hexa addresses followed by ':'
828 		 */
829 		line_ip = strtoull(tmp, &tmp2, 16);
830 		if (*tmp2 != ':' || tmp == tmp2 || tmp2[1] == '\0')
831 			line_ip = -1;
832 	}
833 
834 	if (line_ip != -1) {
835 		u64 start = map__rip_2objdump(map, sym->start),
836 		    end = map__rip_2objdump(map, sym->end);
837 
838 		offset = line_ip - start;
839 		if ((u64)line_ip < start || (u64)line_ip >= end)
840 			offset = -1;
841 		else
842 			parsed_line = tmp2 + 1;
843 	}
844 
845 	dl = disasm_line__new(offset, parsed_line, privsize);
846 	free(line);
847 
848 	if (dl == NULL)
849 		return -1;
850 
851 	if (dl->ops.target.offset == UINT64_MAX)
852 		dl->ops.target.offset = dl->ops.target.addr -
853 					map__rip_2objdump(map, sym->start);
854 
855 	/* kcore has no symbols, so add the call target name */
856 	if (dl->ins && ins__is_call(dl->ins) && !dl->ops.target.name) {
857 		struct addr_map_symbol target = {
858 			.map = map,
859 			.addr = dl->ops.target.addr,
860 		};
861 
862 		if (!map_groups__find_ams(&target, NULL) &&
863 		    target.sym->start == target.al_addr)
864 			dl->ops.target.name = strdup(target.sym->name);
865 	}
866 
867 	disasm__add(&notes->src->source, dl);
868 
869 	return 0;
870 }
871 
872 static void delete_last_nop(struct symbol *sym)
873 {
874 	struct annotation *notes = symbol__annotation(sym);
875 	struct list_head *list = &notes->src->source;
876 	struct disasm_line *dl;
877 
878 	while (!list_empty(list)) {
879 		dl = list_entry(list->prev, struct disasm_line, node);
880 
881 		if (dl->ins && dl->ins->ops) {
882 			if (dl->ins->ops != &nop_ops)
883 				return;
884 		} else {
885 			if (!strstr(dl->line, " nop ") &&
886 			    !strstr(dl->line, " nopl ") &&
887 			    !strstr(dl->line, " nopw "))
888 				return;
889 		}
890 
891 		list_del(&dl->node);
892 		disasm_line__free(dl);
893 	}
894 }
895 
896 int symbol__annotate(struct symbol *sym, struct map *map, size_t privsize)
897 {
898 	struct dso *dso = map->dso;
899 	char *filename = dso__build_id_filename(dso, NULL, 0);
900 	bool free_filename = true;
901 	char command[PATH_MAX * 2];
902 	FILE *file;
903 	int err = 0;
904 	char symfs_filename[PATH_MAX];
905 	struct kcore_extract kce;
906 	bool delete_extract = false;
907 
908 	if (filename)
909 		symbol__join_symfs(symfs_filename, filename);
910 
911 	if (filename == NULL) {
912 		if (dso->has_build_id) {
913 			pr_err("Can't annotate %s: not enough memory\n",
914 			       sym->name);
915 			return -ENOMEM;
916 		}
917 		goto fallback;
918 	} else if (readlink(symfs_filename, command, sizeof(command)) < 0 ||
919 		   strstr(command, "[kernel.kallsyms]") ||
920 		   access(symfs_filename, R_OK)) {
921 		free(filename);
922 fallback:
923 		/*
924 		 * If we don't have build-ids or the build-id file isn't in the
925 		 * cache, or is just a kallsyms file, well, lets hope that this
926 		 * DSO is the same as when 'perf record' ran.
927 		 */
928 		filename = (char *)dso->long_name;
929 		symbol__join_symfs(symfs_filename, filename);
930 		free_filename = false;
931 	}
932 
933 	if (dso->symtab_type == DSO_BINARY_TYPE__KALLSYMS &&
934 	    !dso__is_kcore(dso)) {
935 		char bf[BUILD_ID_SIZE * 2 + 16] = " with build id ";
936 		char *build_id_msg = NULL;
937 
938 		if (dso->annotate_warned)
939 			goto out_free_filename;
940 
941 		if (dso->has_build_id) {
942 			build_id__sprintf(dso->build_id,
943 					  sizeof(dso->build_id), bf + 15);
944 			build_id_msg = bf;
945 		}
946 		err = -ENOENT;
947 		dso->annotate_warned = 1;
948 		pr_err("Can't annotate %s:\n\n"
949 		       "No vmlinux file%s\nwas found in the path.\n\n"
950 		       "Please use:\n\n"
951 		       "  perf buildid-cache -vu vmlinux\n\n"
952 		       "or:\n\n"
953 		       "  --vmlinux vmlinux\n",
954 		       sym->name, build_id_msg ?: "");
955 		goto out_free_filename;
956 	}
957 
958 	pr_debug("%s: filename=%s, sym=%s, start=%#" PRIx64 ", end=%#" PRIx64 "\n", __func__,
959 		 filename, sym->name, map->unmap_ip(map, sym->start),
960 		 map->unmap_ip(map, sym->end));
961 
962 	pr_debug("annotating [%p] %30s : [%p] %30s\n",
963 		 dso, dso->long_name, sym, sym->name);
964 
965 	if (dso__is_kcore(dso)) {
966 		kce.kcore_filename = symfs_filename;
967 		kce.addr = map__rip_2objdump(map, sym->start);
968 		kce.offs = sym->start;
969 		kce.len = sym->end - sym->start;
970 		if (!kcore_extract__create(&kce)) {
971 			delete_extract = true;
972 			strlcpy(symfs_filename, kce.extract_filename,
973 				sizeof(symfs_filename));
974 			if (free_filename) {
975 				free(filename);
976 				free_filename = false;
977 			}
978 			filename = symfs_filename;
979 		}
980 	}
981 
982 	snprintf(command, sizeof(command),
983 		 "%s %s%s --start-address=0x%016" PRIx64
984 		 " --stop-address=0x%016" PRIx64
985 		 " -d %s %s -C %s 2>/dev/null|grep -v %s|expand",
986 		 objdump_path ? objdump_path : "objdump",
987 		 disassembler_style ? "-M " : "",
988 		 disassembler_style ? disassembler_style : "",
989 		 map__rip_2objdump(map, sym->start),
990 		 map__rip_2objdump(map, sym->end),
991 		 symbol_conf.annotate_asm_raw ? "" : "--no-show-raw",
992 		 symbol_conf.annotate_src ? "-S" : "",
993 		 symfs_filename, filename);
994 
995 	pr_debug("Executing: %s\n", command);
996 
997 	file = popen(command, "r");
998 	if (!file)
999 		goto out_free_filename;
1000 
1001 	while (!feof(file))
1002 		if (symbol__parse_objdump_line(sym, map, file, privsize) < 0)
1003 			break;
1004 
1005 	/*
1006 	 * kallsyms does not have symbol sizes so there may a nop at the end.
1007 	 * Remove it.
1008 	 */
1009 	if (dso__is_kcore(dso))
1010 		delete_last_nop(sym);
1011 
1012 	pclose(file);
1013 out_free_filename:
1014 	if (delete_extract)
1015 		kcore_extract__delete(&kce);
1016 	if (free_filename)
1017 		free(filename);
1018 	return err;
1019 }
1020 
1021 static void insert_source_line(struct rb_root *root, struct source_line *src_line)
1022 {
1023 	struct source_line *iter;
1024 	struct rb_node **p = &root->rb_node;
1025 	struct rb_node *parent = NULL;
1026 	int i, ret;
1027 
1028 	while (*p != NULL) {
1029 		parent = *p;
1030 		iter = rb_entry(parent, struct source_line, node);
1031 
1032 		ret = strcmp(iter->path, src_line->path);
1033 		if (ret == 0) {
1034 			for (i = 0; i < src_line->nr_pcnt; i++)
1035 				iter->p[i].percent_sum += src_line->p[i].percent;
1036 			return;
1037 		}
1038 
1039 		if (ret < 0)
1040 			p = &(*p)->rb_left;
1041 		else
1042 			p = &(*p)->rb_right;
1043 	}
1044 
1045 	for (i = 0; i < src_line->nr_pcnt; i++)
1046 		src_line->p[i].percent_sum = src_line->p[i].percent;
1047 
1048 	rb_link_node(&src_line->node, parent, p);
1049 	rb_insert_color(&src_line->node, root);
1050 }
1051 
1052 static int cmp_source_line(struct source_line *a, struct source_line *b)
1053 {
1054 	int i;
1055 
1056 	for (i = 0; i < a->nr_pcnt; i++) {
1057 		if (a->p[i].percent_sum == b->p[i].percent_sum)
1058 			continue;
1059 		return a->p[i].percent_sum > b->p[i].percent_sum;
1060 	}
1061 
1062 	return 0;
1063 }
1064 
1065 static void __resort_source_line(struct rb_root *root, struct source_line *src_line)
1066 {
1067 	struct source_line *iter;
1068 	struct rb_node **p = &root->rb_node;
1069 	struct rb_node *parent = NULL;
1070 
1071 	while (*p != NULL) {
1072 		parent = *p;
1073 		iter = rb_entry(parent, struct source_line, node);
1074 
1075 		if (cmp_source_line(src_line, iter))
1076 			p = &(*p)->rb_left;
1077 		else
1078 			p = &(*p)->rb_right;
1079 	}
1080 
1081 	rb_link_node(&src_line->node, parent, p);
1082 	rb_insert_color(&src_line->node, root);
1083 }
1084 
1085 static void resort_source_line(struct rb_root *dest_root, struct rb_root *src_root)
1086 {
1087 	struct source_line *src_line;
1088 	struct rb_node *node;
1089 
1090 	node = rb_first(src_root);
1091 	while (node) {
1092 		struct rb_node *next;
1093 
1094 		src_line = rb_entry(node, struct source_line, node);
1095 		next = rb_next(node);
1096 		rb_erase(node, src_root);
1097 
1098 		__resort_source_line(dest_root, src_line);
1099 		node = next;
1100 	}
1101 }
1102 
1103 static void symbol__free_source_line(struct symbol *sym, int len)
1104 {
1105 	struct annotation *notes = symbol__annotation(sym);
1106 	struct source_line *src_line = notes->src->lines;
1107 	size_t sizeof_src_line;
1108 	int i;
1109 
1110 	sizeof_src_line = sizeof(*src_line) +
1111 			  (sizeof(src_line->p) * (src_line->nr_pcnt - 1));
1112 
1113 	for (i = 0; i < len; i++) {
1114 		free_srcline(src_line->path);
1115 		src_line = (void *)src_line + sizeof_src_line;
1116 	}
1117 
1118 	zfree(&notes->src->lines);
1119 }
1120 
1121 /* Get the filename:line for the colored entries */
1122 static int symbol__get_source_line(struct symbol *sym, struct map *map,
1123 				   struct perf_evsel *evsel,
1124 				   struct rb_root *root, int len)
1125 {
1126 	u64 start;
1127 	int i, k;
1128 	int evidx = evsel->idx;
1129 	struct source_line *src_line;
1130 	struct annotation *notes = symbol__annotation(sym);
1131 	struct sym_hist *h = annotation__histogram(notes, evidx);
1132 	struct rb_root tmp_root = RB_ROOT;
1133 	int nr_pcnt = 1;
1134 	u64 h_sum = h->sum;
1135 	size_t sizeof_src_line = sizeof(struct source_line);
1136 
1137 	if (perf_evsel__is_group_event(evsel)) {
1138 		for (i = 1; i < evsel->nr_members; i++) {
1139 			h = annotation__histogram(notes, evidx + i);
1140 			h_sum += h->sum;
1141 		}
1142 		nr_pcnt = evsel->nr_members;
1143 		sizeof_src_line += (nr_pcnt - 1) * sizeof(src_line->p);
1144 	}
1145 
1146 	if (!h_sum)
1147 		return 0;
1148 
1149 	src_line = notes->src->lines = calloc(len, sizeof_src_line);
1150 	if (!notes->src->lines)
1151 		return -1;
1152 
1153 	start = map__rip_2objdump(map, sym->start);
1154 
1155 	for (i = 0; i < len; i++) {
1156 		u64 offset;
1157 		double percent_max = 0.0;
1158 
1159 		src_line->nr_pcnt = nr_pcnt;
1160 
1161 		for (k = 0; k < nr_pcnt; k++) {
1162 			h = annotation__histogram(notes, evidx + k);
1163 			src_line->p[k].percent = 100.0 * h->addr[i] / h->sum;
1164 
1165 			if (src_line->p[k].percent > percent_max)
1166 				percent_max = src_line->p[k].percent;
1167 		}
1168 
1169 		if (percent_max <= 0.5)
1170 			goto next;
1171 
1172 		offset = start + i;
1173 		src_line->path = get_srcline(map->dso, offset);
1174 		insert_source_line(&tmp_root, src_line);
1175 
1176 	next:
1177 		src_line = (void *)src_line + sizeof_src_line;
1178 	}
1179 
1180 	resort_source_line(root, &tmp_root);
1181 	return 0;
1182 }
1183 
1184 static void print_summary(struct rb_root *root, const char *filename)
1185 {
1186 	struct source_line *src_line;
1187 	struct rb_node *node;
1188 
1189 	printf("\nSorted summary for file %s\n", filename);
1190 	printf("----------------------------------------------\n\n");
1191 
1192 	if (RB_EMPTY_ROOT(root)) {
1193 		printf(" Nothing higher than %1.1f%%\n", MIN_GREEN);
1194 		return;
1195 	}
1196 
1197 	node = rb_first(root);
1198 	while (node) {
1199 		double percent, percent_max = 0.0;
1200 		const char *color;
1201 		char *path;
1202 		int i;
1203 
1204 		src_line = rb_entry(node, struct source_line, node);
1205 		for (i = 0; i < src_line->nr_pcnt; i++) {
1206 			percent = src_line->p[i].percent_sum;
1207 			color = get_percent_color(percent);
1208 			color_fprintf(stdout, color, " %7.2f", percent);
1209 
1210 			if (percent > percent_max)
1211 				percent_max = percent;
1212 		}
1213 
1214 		path = src_line->path;
1215 		color = get_percent_color(percent_max);
1216 		color_fprintf(stdout, color, " %s\n", path);
1217 
1218 		node = rb_next(node);
1219 	}
1220 }
1221 
1222 static void symbol__annotate_hits(struct symbol *sym, struct perf_evsel *evsel)
1223 {
1224 	struct annotation *notes = symbol__annotation(sym);
1225 	struct sym_hist *h = annotation__histogram(notes, evsel->idx);
1226 	u64 len = symbol__size(sym), offset;
1227 
1228 	for (offset = 0; offset < len; ++offset)
1229 		if (h->addr[offset] != 0)
1230 			printf("%*" PRIx64 ": %" PRIu64 "\n", BITS_PER_LONG / 2,
1231 			       sym->start + offset, h->addr[offset]);
1232 	printf("%*s: %" PRIu64 "\n", BITS_PER_LONG / 2, "h->sum", h->sum);
1233 }
1234 
1235 int symbol__annotate_printf(struct symbol *sym, struct map *map,
1236 			    struct perf_evsel *evsel, bool full_paths,
1237 			    int min_pcnt, int max_lines, int context)
1238 {
1239 	struct dso *dso = map->dso;
1240 	char *filename;
1241 	const char *d_filename;
1242 	const char *evsel_name = perf_evsel__name(evsel);
1243 	struct annotation *notes = symbol__annotation(sym);
1244 	struct disasm_line *pos, *queue = NULL;
1245 	u64 start = map__rip_2objdump(map, sym->start);
1246 	int printed = 2, queue_len = 0;
1247 	int more = 0;
1248 	u64 len;
1249 	int width = 8;
1250 	int namelen, evsel_name_len, graph_dotted_len;
1251 
1252 	filename = strdup(dso->long_name);
1253 	if (!filename)
1254 		return -ENOMEM;
1255 
1256 	if (full_paths)
1257 		d_filename = filename;
1258 	else
1259 		d_filename = basename(filename);
1260 
1261 	len = symbol__size(sym);
1262 	namelen = strlen(d_filename);
1263 	evsel_name_len = strlen(evsel_name);
1264 
1265 	if (perf_evsel__is_group_event(evsel))
1266 		width *= evsel->nr_members;
1267 
1268 	printf(" %-*.*s|	Source code & Disassembly of %s for %s\n",
1269 	       width, width, "Percent", d_filename, evsel_name);
1270 
1271 	graph_dotted_len = width + namelen + evsel_name_len;
1272 	printf("-%-*.*s-----------------------------------------\n",
1273 	       graph_dotted_len, graph_dotted_len, graph_dotted_line);
1274 
1275 	if (verbose)
1276 		symbol__annotate_hits(sym, evsel);
1277 
1278 	list_for_each_entry(pos, &notes->src->source, node) {
1279 		if (context && queue == NULL) {
1280 			queue = pos;
1281 			queue_len = 0;
1282 		}
1283 
1284 		switch (disasm_line__print(pos, sym, start, evsel, len,
1285 					    min_pcnt, printed, max_lines,
1286 					    queue)) {
1287 		case 0:
1288 			++printed;
1289 			if (context) {
1290 				printed += queue_len;
1291 				queue = NULL;
1292 				queue_len = 0;
1293 			}
1294 			break;
1295 		case 1:
1296 			/* filtered by max_lines */
1297 			++more;
1298 			break;
1299 		case -1:
1300 		default:
1301 			/*
1302 			 * Filtered by min_pcnt or non IP lines when
1303 			 * context != 0
1304 			 */
1305 			if (!context)
1306 				break;
1307 			if (queue_len == context)
1308 				queue = list_entry(queue->node.next, typeof(*queue), node);
1309 			else
1310 				++queue_len;
1311 			break;
1312 		}
1313 	}
1314 
1315 	free(filename);
1316 
1317 	return more;
1318 }
1319 
1320 void symbol__annotate_zero_histogram(struct symbol *sym, int evidx)
1321 {
1322 	struct annotation *notes = symbol__annotation(sym);
1323 	struct sym_hist *h = annotation__histogram(notes, evidx);
1324 
1325 	memset(h, 0, notes->src->sizeof_sym_hist);
1326 }
1327 
1328 void symbol__annotate_decay_histogram(struct symbol *sym, int evidx)
1329 {
1330 	struct annotation *notes = symbol__annotation(sym);
1331 	struct sym_hist *h = annotation__histogram(notes, evidx);
1332 	int len = symbol__size(sym), offset;
1333 
1334 	h->sum = 0;
1335 	for (offset = 0; offset < len; ++offset) {
1336 		h->addr[offset] = h->addr[offset] * 7 / 8;
1337 		h->sum += h->addr[offset];
1338 	}
1339 }
1340 
1341 void disasm__purge(struct list_head *head)
1342 {
1343 	struct disasm_line *pos, *n;
1344 
1345 	list_for_each_entry_safe(pos, n, head, node) {
1346 		list_del(&pos->node);
1347 		disasm_line__free(pos);
1348 	}
1349 }
1350 
1351 static size_t disasm_line__fprintf(struct disasm_line *dl, FILE *fp)
1352 {
1353 	size_t printed;
1354 
1355 	if (dl->offset == -1)
1356 		return fprintf(fp, "%s\n", dl->line);
1357 
1358 	printed = fprintf(fp, "%#" PRIx64 " %s", dl->offset, dl->name);
1359 
1360 	if (dl->ops.raw[0] != '\0') {
1361 		printed += fprintf(fp, "%.*s %s\n", 6 - (int)printed, " ",
1362 				   dl->ops.raw);
1363 	}
1364 
1365 	return printed + fprintf(fp, "\n");
1366 }
1367 
1368 size_t disasm__fprintf(struct list_head *head, FILE *fp)
1369 {
1370 	struct disasm_line *pos;
1371 	size_t printed = 0;
1372 
1373 	list_for_each_entry(pos, head, node)
1374 		printed += disasm_line__fprintf(pos, fp);
1375 
1376 	return printed;
1377 }
1378 
1379 int symbol__tty_annotate(struct symbol *sym, struct map *map,
1380 			 struct perf_evsel *evsel, bool print_lines,
1381 			 bool full_paths, int min_pcnt, int max_lines)
1382 {
1383 	struct dso *dso = map->dso;
1384 	struct rb_root source_line = RB_ROOT;
1385 	u64 len;
1386 
1387 	if (symbol__annotate(sym, map, 0) < 0)
1388 		return -1;
1389 
1390 	len = symbol__size(sym);
1391 
1392 	if (print_lines) {
1393 		symbol__get_source_line(sym, map, evsel, &source_line, len);
1394 		print_summary(&source_line, dso->long_name);
1395 	}
1396 
1397 	symbol__annotate_printf(sym, map, evsel, full_paths,
1398 				min_pcnt, max_lines, 0);
1399 	if (print_lines)
1400 		symbol__free_source_line(sym, len);
1401 
1402 	disasm__purge(&symbol__annotation(sym)->src->source);
1403 
1404 	return 0;
1405 }
1406 
1407 int hist_entry__annotate(struct hist_entry *he, size_t privsize)
1408 {
1409 	return symbol__annotate(he->ms.sym, he->ms.map, privsize);
1410 }
1411 
1412 bool ui__has_annotation(void)
1413 {
1414 	return use_browser == 1 && sort__has_sym;
1415 }
1416