2 * Copyright (C) 2011, Red Hat Inc, Arnaldo Carvalho de Melo <acme@redhat.com>
4 * Parts came from builtin-annotate.c, see those files for further
7 * Released under the GPL v2. (and only v2, not any later version)
24 #include "block-range.h"
26 #include "arch/common.h"
29 #include <linux/bitops.h>
30 #include <linux/kernel.h>
32 /* FIXME: For the HE_COLORSET */
33 #include "ui/browser.h"
36 * FIXME: Using the same values as slang.h,
37 * but that header may not be available everywhere
39 #define LARROW_CHAR ((unsigned char)',')
40 #define RARROW_CHAR ((unsigned char)'+')
41 #define DARROW_CHAR ((unsigned char)'.')
42 #define UARROW_CHAR ((unsigned char)'-')
44 #include "sane_ctype.h"
46 struct annotation_options annotation__default_options = {
49 .offset_level = ANNOTATION__OFFSET_JUMP_TARGETS,
52 const char *disassembler_style;
53 const char *objdump_path;
54 static regex_t file_lineno;
56 static struct ins_ops *ins__find(struct arch *arch, const char *name);
57 static void ins__sort(struct arch *arch);
58 static int disasm_line__parse(char *line, const char **namep, char **rawp);
62 struct ins *instructions;
63 size_t nr_instructions;
64 size_t nr_instructions_allocated;
65 struct ins_ops *(*associate_instruction_ops)(struct arch *arch, const char *name);
66 bool sorted_instructions;
71 int (*init)(struct arch *arch, char *cpuid);
72 bool (*ins_is_fused)(struct arch *arch, const char *ins1,
76 char skip_functions_char;
80 static struct ins_ops call_ops;
81 static struct ins_ops dec_ops;
82 static struct ins_ops jump_ops;
83 static struct ins_ops mov_ops;
84 static struct ins_ops nop_ops;
85 static struct ins_ops lock_ops;
86 static struct ins_ops ret_ops;
88 static int arch__grow_instructions(struct arch *arch)
90 struct ins *new_instructions;
91 size_t new_nr_allocated;
93 if (arch->nr_instructions_allocated == 0 && arch->instructions)
94 goto grow_from_non_allocated_table;
96 new_nr_allocated = arch->nr_instructions_allocated + 128;
97 new_instructions = realloc(arch->instructions, new_nr_allocated * sizeof(struct ins));
98 if (new_instructions == NULL)
101 out_update_instructions:
102 arch->instructions = new_instructions;
103 arch->nr_instructions_allocated = new_nr_allocated;
106 grow_from_non_allocated_table:
107 new_nr_allocated = arch->nr_instructions + 128;
108 new_instructions = calloc(new_nr_allocated, sizeof(struct ins));
109 if (new_instructions == NULL)
112 memcpy(new_instructions, arch->instructions, arch->nr_instructions);
113 goto out_update_instructions;
116 static int arch__associate_ins_ops(struct arch* arch, const char *name, struct ins_ops *ops)
120 if (arch->nr_instructions == arch->nr_instructions_allocated &&
121 arch__grow_instructions(arch))
124 ins = &arch->instructions[arch->nr_instructions];
125 ins->name = strdup(name);
130 arch->nr_instructions++;
136 #include "arch/arm/annotate/instructions.c"
137 #include "arch/arm64/annotate/instructions.c"
138 #include "arch/x86/annotate/instructions.c"
139 #include "arch/powerpc/annotate/instructions.c"
140 #include "arch/s390/annotate/instructions.c"
142 static struct arch architectures[] = {
145 .init = arm__annotate_init,
149 .init = arm64__annotate_init,
153 .init = x86__annotate_init,
154 .instructions = x86__instructions,
155 .nr_instructions = ARRAY_SIZE(x86__instructions),
156 .ins_is_fused = x86__ins_is_fused,
163 .init = powerpc__annotate_init,
167 .init = s390__annotate_init,
174 static void ins__delete(struct ins_operands *ops)
178 zfree(&ops->source.raw);
179 zfree(&ops->source.name);
180 zfree(&ops->target.raw);
181 zfree(&ops->target.name);
184 static int ins__raw_scnprintf(struct ins *ins, char *bf, size_t size,
185 struct ins_operands *ops)
187 return scnprintf(bf, size, "%-6s %s", ins->name, ops->raw);
190 int ins__scnprintf(struct ins *ins, char *bf, size_t size,
191 struct ins_operands *ops)
193 if (ins->ops->scnprintf)
194 return ins->ops->scnprintf(ins, bf, size, ops);
196 return ins__raw_scnprintf(ins, bf, size, ops);
199 bool ins__is_fused(struct arch *arch, const char *ins1, const char *ins2)
201 if (!arch || !arch->ins_is_fused)
204 return arch->ins_is_fused(arch, ins1, ins2);
207 static int call__parse(struct arch *arch, struct ins_operands *ops, struct map_symbol *ms)
209 char *endptr, *tok, *name;
210 struct map *map = ms->map;
211 struct addr_map_symbol target = {
215 ops->target.addr = strtoull(ops->raw, &endptr, 16);
217 name = strchr(endptr, '<');
223 if (arch->objdump.skip_functions_char &&
224 strchr(name, arch->objdump.skip_functions_char))
227 tok = strchr(name, '>');
232 ops->target.name = strdup(name);
235 if (ops->target.name == NULL)
238 target.addr = map__objdump_2mem(map, ops->target.addr);
240 if (map_groups__find_ams(&target) == 0 &&
241 map__rip_2objdump(target.map, map->map_ip(target.map, target.addr)) == ops->target.addr)
242 ops->target.sym = target.sym;
247 tok = strchr(endptr, '*');
249 ops->target.addr = strtoull(tok + 1, NULL, 16);
253 static int call__scnprintf(struct ins *ins, char *bf, size_t size,
254 struct ins_operands *ops)
257 return scnprintf(bf, size, "%-6s %s", ins->name, ops->target.sym->name);
259 if (ops->target.addr == 0)
260 return ins__raw_scnprintf(ins, bf, size, ops);
262 if (ops->target.name)
263 return scnprintf(bf, size, "%-6s %s", ins->name, ops->target.name);
265 return scnprintf(bf, size, "%-6s *%" PRIx64, ins->name, ops->target.addr);
268 static struct ins_ops call_ops = {
269 .parse = call__parse,
270 .scnprintf = call__scnprintf,
273 bool ins__is_call(const struct ins *ins)
275 return ins->ops == &call_ops || ins->ops == &s390_call_ops;
278 static int jump__parse(struct arch *arch __maybe_unused, struct ins_operands *ops, struct map_symbol *ms)
280 struct map *map = ms->map;
281 struct symbol *sym = ms->sym;
282 struct addr_map_symbol target = {
285 const char *c = strchr(ops->raw, ',');
288 * Examples of lines to parse for the _cpp_lex_token@@Base
291 * 1159e6c: jne 115aa32 <_cpp_lex_token@@Base+0xf92>
292 * 1159e8b: jne c469be <cpp_named_operator2name@@Base+0xa72>
294 * The first is a jump to an offset inside the same function,
295 * the second is to another function, i.e. that 0xa72 is an
296 * offset in the cpp_named_operator2name@@base function.
299 * skip over possible up to 2 operands to get to address, e.g.:
300 * tbnz w0, #26, ffff0000083cd190 <security_file_permission+0xd0>
303 ops->target.addr = strtoull(c, NULL, 16);
304 if (!ops->target.addr) {
307 ops->target.addr = strtoull(c, NULL, 16);
310 ops->target.addr = strtoull(ops->raw, NULL, 16);
313 target.addr = map__objdump_2mem(map, ops->target.addr);
314 start = map->unmap_ip(map, sym->start),
315 end = map->unmap_ip(map, sym->end);
317 ops->target.outside = target.addr < start || target.addr > end;
320 * FIXME: things like this in _cpp_lex_token (gcc's cc1 program):
322 cpp_named_operator2name@@Base+0xa72
324 * Point to a place that is after the cpp_named_operator2name
325 * boundaries, i.e. in the ELF symbol table for cc1
326 * cpp_named_operator2name is marked as being 32-bytes long, but it in
327 * fact is much larger than that, so we seem to need a symbols__find()
328 * routine that looks for >= current->start and < next_symbol->start,
329 * possibly just for C++ objects?
331 * For now lets just make some progress by marking jumps to outside the
332 * current function as call like.
334 * Actual navigation will come next, with further understanding of how
335 * the symbol searching and disassembly should be done.
337 if (map_groups__find_ams(&target) == 0 &&
338 map__rip_2objdump(target.map, map->map_ip(target.map, target.addr)) == ops->target.addr)
339 ops->target.sym = target.sym;
341 if (!ops->target.outside) {
342 ops->target.offset = target.addr - start;
343 ops->target.offset_avail = true;
345 ops->target.offset_avail = false;
351 static int jump__scnprintf(struct ins *ins, char *bf, size_t size,
352 struct ins_operands *ops)
356 if (!ops->target.addr || ops->target.offset < 0)
357 return ins__raw_scnprintf(ins, bf, size, ops);
359 if (ops->target.outside && ops->target.sym != NULL)
360 return scnprintf(bf, size, "%-6s %s", ins->name, ops->target.sym->name);
362 c = strchr(ops->raw, ',');
364 const char *c2 = strchr(c + 1, ',');
366 /* check for 3-op insn */
371 /* mirror arch objdump's space-after-comma style */
376 return scnprintf(bf, size, "%-6s %.*s%" PRIx64,
377 ins->name, c ? c - ops->raw : 0, ops->raw,
381 static struct ins_ops jump_ops = {
382 .parse = jump__parse,
383 .scnprintf = jump__scnprintf,
386 bool ins__is_jump(const struct ins *ins)
388 return ins->ops == &jump_ops;
391 static int comment__symbol(char *raw, char *comment, u64 *addrp, char **namep)
393 char *endptr, *name, *t;
395 if (strstr(raw, "(%rip)") == NULL)
398 *addrp = strtoull(comment, &endptr, 16);
399 if (endptr == comment)
401 name = strchr(endptr, '<');
407 t = strchr(name, '>');
412 *namep = strdup(name);
418 static int lock__parse(struct arch *arch, struct ins_operands *ops, struct map_symbol *ms)
420 ops->locked.ops = zalloc(sizeof(*ops->locked.ops));
421 if (ops->locked.ops == NULL)
424 if (disasm_line__parse(ops->raw, &ops->locked.ins.name, &ops->locked.ops->raw) < 0)
427 ops->locked.ins.ops = ins__find(arch, ops->locked.ins.name);
429 if (ops->locked.ins.ops == NULL)
432 if (ops->locked.ins.ops->parse &&
433 ops->locked.ins.ops->parse(arch, ops->locked.ops, ms) < 0)
439 zfree(&ops->locked.ops);
443 static int lock__scnprintf(struct ins *ins, char *bf, size_t size,
444 struct ins_operands *ops)
448 if (ops->locked.ins.ops == NULL)
449 return ins__raw_scnprintf(ins, bf, size, ops);
451 printed = scnprintf(bf, size, "%-6s ", ins->name);
452 return printed + ins__scnprintf(&ops->locked.ins, bf + printed,
453 size - printed, ops->locked.ops);
456 static void lock__delete(struct ins_operands *ops)
458 struct ins *ins = &ops->locked.ins;
460 if (ins->ops && ins->ops->free)
461 ins->ops->free(ops->locked.ops);
463 ins__delete(ops->locked.ops);
465 zfree(&ops->locked.ops);
466 zfree(&ops->target.raw);
467 zfree(&ops->target.name);
470 static struct ins_ops lock_ops = {
471 .free = lock__delete,
472 .parse = lock__parse,
473 .scnprintf = lock__scnprintf,
476 static int mov__parse(struct arch *arch, struct ins_operands *ops, struct map_symbol *ms __maybe_unused)
478 char *s = strchr(ops->raw, ','), *target, *comment, prev;
484 ops->source.raw = strdup(ops->raw);
487 if (ops->source.raw == NULL)
491 comment = strchr(s, arch->objdump.comment_char);
496 s = strchr(s, '\0') - 1;
498 while (s > target && isspace(s[0]))
504 ops->target.raw = strdup(target);
507 if (ops->target.raw == NULL)
508 goto out_free_source;
513 comment = ltrim(comment);
514 comment__symbol(ops->source.raw, comment + 1, &ops->source.addr, &ops->source.name);
515 comment__symbol(ops->target.raw, comment + 1, &ops->target.addr, &ops->target.name);
520 zfree(&ops->source.raw);
524 static int mov__scnprintf(struct ins *ins, char *bf, size_t size,
525 struct ins_operands *ops)
527 return scnprintf(bf, size, "%-6s %s,%s", ins->name,
528 ops->source.name ?: ops->source.raw,
529 ops->target.name ?: ops->target.raw);
532 static struct ins_ops mov_ops = {
534 .scnprintf = mov__scnprintf,
537 static int dec__parse(struct arch *arch __maybe_unused, struct ins_operands *ops, struct map_symbol *ms __maybe_unused)
539 char *target, *comment, *s, prev;
541 target = s = ops->raw;
543 while (s[0] != '\0' && !isspace(s[0]))
548 ops->target.raw = strdup(target);
551 if (ops->target.raw == NULL)
554 comment = strchr(s, arch->objdump.comment_char);
558 comment = ltrim(comment);
559 comment__symbol(ops->target.raw, comment + 1, &ops->target.addr, &ops->target.name);
564 static int dec__scnprintf(struct ins *ins, char *bf, size_t size,
565 struct ins_operands *ops)
567 return scnprintf(bf, size, "%-6s %s", ins->name,
568 ops->target.name ?: ops->target.raw);
571 static struct ins_ops dec_ops = {
573 .scnprintf = dec__scnprintf,
576 static int nop__scnprintf(struct ins *ins __maybe_unused, char *bf, size_t size,
577 struct ins_operands *ops __maybe_unused)
579 return scnprintf(bf, size, "%-6s", "nop");
582 static struct ins_ops nop_ops = {
583 .scnprintf = nop__scnprintf,
586 static struct ins_ops ret_ops = {
587 .scnprintf = ins__raw_scnprintf,
590 bool ins__is_ret(const struct ins *ins)
592 return ins->ops == &ret_ops;
595 bool ins__is_lock(const struct ins *ins)
597 return ins->ops == &lock_ops;
600 static int ins__key_cmp(const void *name, const void *insp)
602 const struct ins *ins = insp;
604 return strcmp(name, ins->name);
607 static int ins__cmp(const void *a, const void *b)
609 const struct ins *ia = a;
610 const struct ins *ib = b;
612 return strcmp(ia->name, ib->name);
615 static void ins__sort(struct arch *arch)
617 const int nmemb = arch->nr_instructions;
619 qsort(arch->instructions, nmemb, sizeof(struct ins), ins__cmp);
622 static struct ins_ops *__ins__find(struct arch *arch, const char *name)
625 const int nmemb = arch->nr_instructions;
627 if (!arch->sorted_instructions) {
629 arch->sorted_instructions = true;
632 ins = bsearch(name, arch->instructions, nmemb, sizeof(struct ins), ins__key_cmp);
633 return ins ? ins->ops : NULL;
636 static struct ins_ops *ins__find(struct arch *arch, const char *name)
638 struct ins_ops *ops = __ins__find(arch, name);
640 if (!ops && arch->associate_instruction_ops)
641 ops = arch->associate_instruction_ops(arch, name);
646 static int arch__key_cmp(const void *name, const void *archp)
648 const struct arch *arch = archp;
650 return strcmp(name, arch->name);
653 static int arch__cmp(const void *a, const void *b)
655 const struct arch *aa = a;
656 const struct arch *ab = b;
658 return strcmp(aa->name, ab->name);
661 static void arch__sort(void)
663 const int nmemb = ARRAY_SIZE(architectures);
665 qsort(architectures, nmemb, sizeof(struct arch), arch__cmp);
668 static struct arch *arch__find(const char *name)
670 const int nmemb = ARRAY_SIZE(architectures);
678 return bsearch(name, architectures, nmemb, sizeof(struct arch), arch__key_cmp);
681 int symbol__alloc_hist(struct symbol *sym)
683 struct annotation *notes = symbol__annotation(sym);
684 size_t size = symbol__size(sym);
685 size_t sizeof_sym_hist;
688 * Add buffer of one element for zero length symbol.
689 * When sample is taken from first instruction of
690 * zero length symbol, perf still resolves it and
691 * shows symbol name in perf report and allows to
697 /* Check for overflow when calculating sizeof_sym_hist */
698 if (size > (SIZE_MAX - sizeof(struct sym_hist)) / sizeof(struct sym_hist_entry))
701 sizeof_sym_hist = (sizeof(struct sym_hist) + size * sizeof(struct sym_hist_entry));
703 /* Check for overflow in zalloc argument */
704 if (sizeof_sym_hist > SIZE_MAX / symbol_conf.nr_events)
707 notes->src = zalloc(sizeof(*notes->src));
708 if (notes->src == NULL)
710 notes->src->histograms = calloc(symbol_conf.nr_events, sizeof_sym_hist);
711 if (notes->src->histograms == NULL) {
715 notes->src->sizeof_sym_hist = sizeof_sym_hist;
716 notes->src->nr_histograms = symbol_conf.nr_events;
717 INIT_LIST_HEAD(¬es->src->source);
721 /* The cycles histogram is lazily allocated. */
722 static int symbol__alloc_hist_cycles(struct symbol *sym)
724 struct annotation *notes = symbol__annotation(sym);
725 const size_t size = symbol__size(sym);
727 notes->src->cycles_hist = calloc(size, sizeof(struct cyc_hist));
728 if (notes->src->cycles_hist == NULL)
733 void symbol__annotate_zero_histograms(struct symbol *sym)
735 struct annotation *notes = symbol__annotation(sym);
737 pthread_mutex_lock(¬es->lock);
738 if (notes->src != NULL) {
739 memset(notes->src->histograms, 0,
740 notes->src->nr_histograms * notes->src->sizeof_sym_hist);
741 if (notes->src->cycles_hist)
742 memset(notes->src->cycles_hist, 0,
743 symbol__size(sym) * sizeof(struct cyc_hist));
745 pthread_mutex_unlock(¬es->lock);
748 static int __symbol__account_cycles(struct cyc_hist *ch,
750 unsigned offset, unsigned cycles,
754 * For now we can only account one basic block per
755 * final jump. But multiple could be overlapping.
756 * Always account the longest one. So when
757 * a shorter one has been already seen throw it away.
759 * We separately always account the full cycles.
761 ch[offset].num_aggr++;
762 ch[offset].cycles_aggr += cycles;
764 if (cycles > ch[offset].cycles_max)
765 ch[offset].cycles_max = cycles;
767 if (ch[offset].cycles_min) {
768 if (cycles && cycles < ch[offset].cycles_min)
769 ch[offset].cycles_min = cycles;
771 ch[offset].cycles_min = cycles;
773 if (!have_start && ch[offset].have_start)
775 if (ch[offset].num) {
776 if (have_start && (!ch[offset].have_start ||
777 ch[offset].start > start)) {
778 ch[offset].have_start = 0;
779 ch[offset].cycles = 0;
781 if (ch[offset].reset < 0xffff)
783 } else if (have_start &&
784 ch[offset].start < start)
787 ch[offset].have_start = have_start;
788 ch[offset].start = start;
789 ch[offset].cycles += cycles;
794 static int __symbol__inc_addr_samples(struct symbol *sym, struct map *map,
795 struct annotation *notes, int evidx, u64 addr,
796 struct perf_sample *sample)
801 pr_debug3("%s: addr=%#" PRIx64 "\n", __func__, map->unmap_ip(map, addr));
803 if ((addr < sym->start || addr >= sym->end) &&
804 (addr != sym->end || sym->start != sym->end)) {
805 pr_debug("%s(%d): ERANGE! sym->name=%s, start=%#" PRIx64 ", addr=%#" PRIx64 ", end=%#" PRIx64 "\n",
806 __func__, __LINE__, sym->name, sym->start, addr, sym->end);
810 offset = addr - sym->start;
811 h = annotation__histogram(notes, evidx);
813 h->addr[offset].nr_samples++;
814 h->period += sample->period;
815 h->addr[offset].period += sample->period;
817 pr_debug3("%#" PRIx64 " %s: period++ [addr: %#" PRIx64 ", %#" PRIx64
818 ", evidx=%d] => nr_samples: %" PRIu64 ", period: %" PRIu64 "\n",
819 sym->start, sym->name, addr, addr - sym->start, evidx,
820 h->addr[offset].nr_samples, h->addr[offset].period);
824 static struct annotation *symbol__get_annotation(struct symbol *sym, bool cycles)
826 struct annotation *notes = symbol__annotation(sym);
828 if (notes->src == NULL) {
829 if (symbol__alloc_hist(sym) < 0)
832 if (!notes->src->cycles_hist && cycles) {
833 if (symbol__alloc_hist_cycles(sym) < 0)
839 static int symbol__inc_addr_samples(struct symbol *sym, struct map *map,
840 struct perf_evsel *evsel, u64 addr,
841 struct perf_sample *sample)
843 struct annotation *notes;
847 notes = symbol__get_annotation(sym, false);
850 return __symbol__inc_addr_samples(sym, map, notes, evsel->idx, addr, sample);
853 static int symbol__account_cycles(u64 addr, u64 start,
854 struct symbol *sym, unsigned cycles)
856 struct annotation *notes;
861 notes = symbol__get_annotation(sym, true);
864 if (addr < sym->start || addr >= sym->end)
868 if (start < sym->start || start >= sym->end)
873 offset = addr - sym->start;
874 return __symbol__account_cycles(notes->src->cycles_hist,
875 start ? start - sym->start : 0,
880 int addr_map_symbol__account_cycles(struct addr_map_symbol *ams,
881 struct addr_map_symbol *start,
891 * Only set start when IPC can be computed. We can only
892 * compute it when the basic block is completely in a single
894 * Special case the case when the jump is elsewhere, but
895 * it starts on the function start.
898 (start->sym == ams->sym ||
900 start->addr == ams->sym->start + ams->map->start)))
901 saddr = start->al_addr;
903 pr_debug2("BB with bad start: addr %"PRIx64" start %"PRIx64" sym %"PRIx64" saddr %"PRIx64"\n",
905 start ? start->addr : 0,
906 ams->sym ? ams->sym->start + ams->map->start : 0,
908 err = symbol__account_cycles(ams->al_addr, saddr, ams->sym, cycles);
910 pr_debug2("account_cycles failed %d\n", err);
914 static unsigned annotation__count_insn(struct annotation *notes, u64 start, u64 end)
919 for (offset = start; offset <= end; offset++) {
920 if (notes->offsets[offset])
926 static void annotation__count_and_fill(struct annotation *notes, u64 start, u64 end, struct cyc_hist *ch)
931 n_insn = annotation__count_insn(notes, start, end);
932 if (n_insn && ch->num && ch->cycles) {
933 float ipc = n_insn / ((double)ch->cycles / (double)ch->num);
935 /* Hide data when there are too many overlaps. */
936 if (ch->reset >= 0x7fff || ch->reset >= ch->num / 2)
939 for (offset = start; offset <= end; offset++) {
940 struct annotation_line *al = notes->offsets[offset];
948 void annotation__compute_ipc(struct annotation *notes, size_t size)
952 if (!notes->src || !notes->src->cycles_hist)
955 pthread_mutex_lock(¬es->lock);
956 for (offset = 0; offset < size; ++offset) {
959 ch = ¬es->src->cycles_hist[offset];
960 if (ch && ch->cycles) {
961 struct annotation_line *al;
964 annotation__count_and_fill(notes, ch->start, offset, ch);
965 al = notes->offsets[offset];
966 if (al && ch->num_aggr) {
967 al->cycles = ch->cycles_aggr / ch->num_aggr;
968 al->cycles_max = ch->cycles_max;
969 al->cycles_min = ch->cycles_min;
971 notes->have_cycles = true;
974 pthread_mutex_unlock(¬es->lock);
977 int addr_map_symbol__inc_samples(struct addr_map_symbol *ams, struct perf_sample *sample,
978 struct perf_evsel *evsel)
980 return symbol__inc_addr_samples(ams->sym, ams->map, evsel, ams->al_addr, sample);
983 int hist_entry__inc_addr_samples(struct hist_entry *he, struct perf_sample *sample,
984 struct perf_evsel *evsel, u64 ip)
986 return symbol__inc_addr_samples(he->ms.sym, he->ms.map, evsel, ip, sample);
989 static void disasm_line__init_ins(struct disasm_line *dl, struct arch *arch, struct map_symbol *ms)
991 dl->ins.ops = ins__find(arch, dl->ins.name);
996 if (dl->ins.ops->parse && dl->ins.ops->parse(arch, &dl->ops, ms) < 0)
1000 static int disasm_line__parse(char *line, const char **namep, char **rawp)
1002 char tmp, *name = ltrim(line);
1004 if (name[0] == '\0')
1009 while ((*rawp)[0] != '\0' && !isspace((*rawp)[0]))
1014 *namep = strdup(name);
1020 *rawp = ltrim(*rawp);
1025 free((void *)namep);
1030 struct annotate_args {
1033 struct map_symbol ms;
1034 struct perf_evsel *evsel;
1040 static void annotation_line__delete(struct annotation_line *al)
1042 void *ptr = (void *) al - al->privsize;
1044 free_srcline(al->path);
1050 * Allocating the annotation line data with following
1053 * --------------------------------------
1054 * private space | struct annotation_line
1055 * --------------------------------------
1057 * Size of the private space is stored in 'struct annotation_line'.
1060 static struct annotation_line *
1061 annotation_line__new(struct annotate_args *args, size_t privsize)
1063 struct annotation_line *al;
1064 struct perf_evsel *evsel = args->evsel;
1065 size_t size = privsize + sizeof(*al);
1068 if (perf_evsel__is_group_event(evsel))
1069 nr = evsel->nr_members;
1071 size += sizeof(al->samples[0]) * nr;
1075 al = (void *) al + privsize;
1076 al->privsize = privsize;
1077 al->offset = args->offset;
1078 al->line = strdup(args->line);
1079 al->line_nr = args->line_nr;
1080 al->samples_nr = nr;
1087 * Allocating the disasm annotation line data with
1088 * following structure:
1090 * ------------------------------------------------------------
1091 * privsize space | struct disasm_line | struct annotation_line
1092 * ------------------------------------------------------------
1094 * We have 'struct annotation_line' member as last member
1095 * of 'struct disasm_line' to have an easy access.
1098 static struct disasm_line *disasm_line__new(struct annotate_args *args)
1100 struct disasm_line *dl = NULL;
1101 struct annotation_line *al;
1102 size_t privsize = args->privsize + offsetof(struct disasm_line, al);
1104 al = annotation_line__new(args, privsize);
1106 dl = disasm_line(al);
1108 if (dl->al.line == NULL)
1111 if (args->offset != -1) {
1112 if (disasm_line__parse(dl->al.line, &dl->ins.name, &dl->ops.raw) < 0)
1115 disasm_line__init_ins(dl, args->arch, &args->ms);
1122 zfree(&dl->al.line);
1128 void disasm_line__free(struct disasm_line *dl)
1130 if (dl->ins.ops && dl->ins.ops->free)
1131 dl->ins.ops->free(&dl->ops);
1133 ins__delete(&dl->ops);
1134 free((void *)dl->ins.name);
1135 dl->ins.name = NULL;
1136 annotation_line__delete(&dl->al);
1139 int disasm_line__scnprintf(struct disasm_line *dl, char *bf, size_t size, bool raw)
1141 if (raw || !dl->ins.ops)
1142 return scnprintf(bf, size, "%-6s %s", dl->ins.name, dl->ops.raw);
1144 return ins__scnprintf(&dl->ins, bf, size, &dl->ops);
1147 static void annotation_line__add(struct annotation_line *al, struct list_head *head)
1149 list_add_tail(&al->node, head);
1152 struct annotation_line *
1153 annotation_line__next(struct annotation_line *pos, struct list_head *head)
1155 list_for_each_entry_continue(pos, head, node)
1156 if (pos->offset >= 0)
1162 static const char *annotate__address_color(struct block_range *br)
1164 double cov = block_range__coverage(br);
1167 /* mark red for >75% coverage */
1169 return PERF_COLOR_RED;
1171 /* mark dull for <1% coverage */
1173 return PERF_COLOR_NORMAL;
1176 return PERF_COLOR_MAGENTA;
1179 static const char *annotate__asm_color(struct block_range *br)
1181 double cov = block_range__coverage(br);
1184 /* mark dull for <1% coverage */
1186 return PERF_COLOR_NORMAL;
1189 return PERF_COLOR_BLUE;
1192 static void annotate__branch_printf(struct block_range *br, u64 addr)
1194 bool emit_comment = true;
1200 if (br->is_target && br->start == addr) {
1201 struct block_range *branch = br;
1205 * Find matching branch to our target.
1207 while (!branch->is_branch)
1208 branch = block_range__next(branch);
1210 p = 100 *(double)br->entry / branch->coverage;
1214 emit_comment = false;
1219 * The percentage of coverage joined at this target in relation
1220 * to the next branch.
1222 printf(" +%.2f%%", p);
1226 if (br->is_branch && br->end == addr) {
1227 double p = 100*(double)br->taken / br->coverage;
1231 emit_comment = false;
1236 * The percentage of coverage leaving at this branch, and
1237 * its prediction ratio.
1239 printf(" -%.2f%% (p:%.2f%%)", p, 100*(double)br->pred / br->taken);
1244 static int disasm_line__print(struct disasm_line *dl, u64 start, int addr_fmt_width)
1246 s64 offset = dl->al.offset;
1247 const u64 addr = start + offset;
1248 struct block_range *br;
1250 br = block_range__find(addr);
1251 color_fprintf(stdout, annotate__address_color(br), " %*" PRIx64 ":", addr_fmt_width, addr);
1252 color_fprintf(stdout, annotate__asm_color(br), "%s", dl->al.line);
1253 annotate__branch_printf(br, addr);
1258 annotation_line__print(struct annotation_line *al, struct symbol *sym, u64 start,
1259 struct perf_evsel *evsel, u64 len, int min_pcnt, int printed,
1260 int max_lines, struct annotation_line *queue, int addr_fmt_width)
1262 struct disasm_line *dl = container_of(al, struct disasm_line, al);
1263 static const char *prev_line;
1264 static const char *prev_color;
1266 if (al->offset != -1) {
1267 double max_percent = 0.0;
1268 int i, nr_percent = 1;
1270 struct annotation *notes = symbol__annotation(sym);
1272 for (i = 0; i < al->samples_nr; i++) {
1273 struct annotation_data *sample = &al->samples[i];
1275 if (sample->percent > max_percent)
1276 max_percent = sample->percent;
1279 if (al->samples_nr > nr_percent)
1280 nr_percent = al->samples_nr;
1282 if (max_percent < min_pcnt)
1285 if (max_lines && printed >= max_lines)
1288 if (queue != NULL) {
1289 list_for_each_entry_from(queue, ¬es->src->source, node) {
1292 annotation_line__print(queue, sym, start, evsel, len,
1293 0, 0, 1, NULL, addr_fmt_width);
1297 color = get_percent_color(max_percent);
1300 * Also color the filename and line if needed, with
1301 * the same color than the percentage. Don't print it
1302 * twice for close colored addr with the same filename:line
1305 if (!prev_line || strcmp(prev_line, al->path)
1306 || color != prev_color) {
1307 color_fprintf(stdout, color, " %s", al->path);
1308 prev_line = al->path;
1313 for (i = 0; i < nr_percent; i++) {
1314 struct annotation_data *sample = &al->samples[i];
1316 color = get_percent_color(sample->percent);
1318 if (symbol_conf.show_total_period)
1319 color_fprintf(stdout, color, " %11" PRIu64,
1321 else if (symbol_conf.show_nr_samples)
1322 color_fprintf(stdout, color, " %7" PRIu64,
1323 sample->he.nr_samples);
1325 color_fprintf(stdout, color, " %7.2f", sample->percent);
1330 disasm_line__print(dl, start, addr_fmt_width);
1332 } else if (max_lines && printed >= max_lines)
1335 int width = symbol_conf.show_total_period ? 12 : 8;
1340 if (perf_evsel__is_group_event(evsel))
1341 width *= evsel->nr_members;
1344 printf(" %*s:\n", width, " ");
1346 printf(" %*s: %*s %s\n", width, " ", addr_fmt_width, " ", al->line);
1353 * symbol__parse_objdump_line() parses objdump output (with -d --no-show-raw)
1354 * which looks like following
1356 * 0000000000415500 <_init>:
1357 * 415500: sub $0x8,%rsp
1358 * 415504: mov 0x2f5ad5(%rip),%rax # 70afe0 <_DYNAMIC+0x2f8>
1359 * 41550b: test %rax,%rax
1360 * 41550e: je 415515 <_init+0x15>
1361 * 415510: callq 416e70 <__gmon_start__@plt>
1362 * 415515: add $0x8,%rsp
1365 * it will be parsed and saved into struct disasm_line as
1366 * <offset> <name> <ops.raw>
1368 * The offset will be a relative offset from the start of the symbol and -1
1369 * means that it's not a disassembly line so should be treated differently.
1370 * The ops.raw part will be parsed further according to type of the instruction.
1372 static int symbol__parse_objdump_line(struct symbol *sym, FILE *file,
1373 struct annotate_args *args,
1376 struct map *map = args->ms.map;
1377 struct annotation *notes = symbol__annotation(sym);
1378 struct disasm_line *dl;
1379 char *line = NULL, *parsed_line, *tmp, *tmp2;
1381 s64 line_ip, offset = -1;
1382 regmatch_t match[2];
1384 if (getline(&line, &line_len, file) < 0)
1391 parsed_line = rtrim(line);
1393 /* /filename:linenr ? Save line number and ignore. */
1394 if (regexec(&file_lineno, parsed_line, 2, match, 0) == 0) {
1395 *line_nr = atoi(parsed_line + match[1].rm_so);
1399 tmp = ltrim(parsed_line);
1402 * Parse hexa addresses followed by ':'
1404 line_ip = strtoull(tmp, &tmp2, 16);
1405 if (*tmp2 != ':' || tmp == tmp2 || tmp2[1] == '\0')
1409 if (line_ip != -1) {
1410 u64 start = map__rip_2objdump(map, sym->start),
1411 end = map__rip_2objdump(map, sym->end);
1413 offset = line_ip - start;
1414 if ((u64)line_ip < start || (u64)line_ip >= end)
1417 parsed_line = tmp2 + 1;
1420 args->offset = offset;
1421 args->line = parsed_line;
1422 args->line_nr = *line_nr;
1425 dl = disasm_line__new(args);
1432 if (!disasm_line__has_local_offset(dl)) {
1433 dl->ops.target.offset = dl->ops.target.addr -
1434 map__rip_2objdump(map, sym->start);
1435 dl->ops.target.offset_avail = true;
1438 /* kcore has no symbols, so add the call target symbol */
1439 if (dl->ins.ops && ins__is_call(&dl->ins) && !dl->ops.target.sym) {
1440 struct addr_map_symbol target = {
1442 .addr = dl->ops.target.addr,
1445 if (!map_groups__find_ams(&target) &&
1446 target.sym->start == target.al_addr)
1447 dl->ops.target.sym = target.sym;
1450 annotation_line__add(&dl->al, ¬es->src->source);
1455 static __attribute__((constructor)) void symbol__init_regexpr(void)
1457 regcomp(&file_lineno, "^/[^:]+:([0-9]+)", REG_EXTENDED);
1460 static void delete_last_nop(struct symbol *sym)
1462 struct annotation *notes = symbol__annotation(sym);
1463 struct list_head *list = ¬es->src->source;
1464 struct disasm_line *dl;
1466 while (!list_empty(list)) {
1467 dl = list_entry(list->prev, struct disasm_line, al.node);
1470 if (dl->ins.ops != &nop_ops)
1473 if (!strstr(dl->al.line, " nop ") &&
1474 !strstr(dl->al.line, " nopl ") &&
1475 !strstr(dl->al.line, " nopw "))
1479 list_del(&dl->al.node);
1480 disasm_line__free(dl);
1484 int symbol__strerror_disassemble(struct symbol *sym __maybe_unused, struct map *map,
1485 int errnum, char *buf, size_t buflen)
1487 struct dso *dso = map->dso;
1489 BUG_ON(buflen == 0);
1492 str_error_r(errnum, buf, buflen);
1497 case SYMBOL_ANNOTATE_ERRNO__NO_VMLINUX: {
1498 char bf[SBUILD_ID_SIZE + 15] = " with build id ";
1499 char *build_id_msg = NULL;
1501 if (dso->has_build_id) {
1502 build_id__sprintf(dso->build_id,
1503 sizeof(dso->build_id), bf + 15);
1506 scnprintf(buf, buflen,
1507 "No vmlinux file%s\nwas found in the path.\n\n"
1508 "Note that annotation using /proc/kcore requires CAP_SYS_RAWIO capability.\n\n"
1510 " perf buildid-cache -vu vmlinux\n\n"
1512 " --vmlinux vmlinux\n", build_id_msg ?: "");
1516 scnprintf(buf, buflen, "Internal error: Invalid %d error code\n", errnum);
1523 static int dso__disassemble_filename(struct dso *dso, char *filename, size_t filename_size)
1525 char linkname[PATH_MAX];
1526 char *build_id_filename;
1527 char *build_id_path = NULL;
1530 if (dso->symtab_type == DSO_BINARY_TYPE__KALLSYMS &&
1531 !dso__is_kcore(dso))
1532 return SYMBOL_ANNOTATE_ERRNO__NO_VMLINUX;
1534 build_id_filename = dso__build_id_filename(dso, NULL, 0, false);
1535 if (build_id_filename) {
1536 __symbol__join_symfs(filename, filename_size, build_id_filename);
1537 free(build_id_filename);
1539 if (dso->has_build_id)
1544 build_id_path = strdup(filename);
1549 * old style build-id cache has name of XX/XXXXXXX.. while
1550 * new style has XX/XXXXXXX../{elf,kallsyms,vdso}.
1551 * extract the build-id part of dirname in the new style only.
1553 pos = strrchr(build_id_path, '/');
1554 if (pos && strlen(pos) < SBUILD_ID_SIZE - 2)
1555 dirname(build_id_path);
1557 if (dso__is_kcore(dso) ||
1558 readlink(build_id_path, linkname, sizeof(linkname)) < 0 ||
1559 strstr(linkname, DSO__NAME_KALLSYMS) ||
1560 access(filename, R_OK)) {
1563 * If we don't have build-ids or the build-id file isn't in the
1564 * cache, or is just a kallsyms file, well, lets hope that this
1565 * DSO is the same as when 'perf record' ran.
1567 __symbol__join_symfs(filename, filename_size, dso->long_name);
1570 free(build_id_path);
1574 static int symbol__disassemble(struct symbol *sym, struct annotate_args *args)
1576 struct map *map = args->ms.map;
1577 struct dso *dso = map->dso;
1580 char symfs_filename[PATH_MAX];
1581 struct kcore_extract kce;
1582 bool delete_extract = false;
1587 int err = dso__disassemble_filename(dso, symfs_filename, sizeof(symfs_filename));
1592 pr_debug("%s: filename=%s, sym=%s, start=%#" PRIx64 ", end=%#" PRIx64 "\n", __func__,
1593 symfs_filename, sym->name, map->unmap_ip(map, sym->start),
1594 map->unmap_ip(map, sym->end));
1596 pr_debug("annotating [%p] %30s : [%p] %30s\n",
1597 dso, dso->long_name, sym, sym->name);
1599 if (dso__is_kcore(dso)) {
1600 kce.kcore_filename = symfs_filename;
1601 kce.addr = map__rip_2objdump(map, sym->start);
1602 kce.offs = sym->start;
1603 kce.len = sym->end - sym->start;
1604 if (!kcore_extract__create(&kce)) {
1605 delete_extract = true;
1606 strlcpy(symfs_filename, kce.extract_filename,
1607 sizeof(symfs_filename));
1609 } else if (dso__needs_decompress(dso)) {
1610 char tmp[KMOD_DECOMP_LEN];
1612 if (dso__decompress_kmodule_path(dso, symfs_filename,
1613 tmp, sizeof(tmp)) < 0)
1616 strcpy(symfs_filename, tmp);
1619 err = asprintf(&command,
1620 "%s %s%s --start-address=0x%016" PRIx64
1621 " --stop-address=0x%016" PRIx64
1622 " -l -d %s %s -C \"%s\" 2>/dev/null|grep -v \"%s:\"|expand",
1623 objdump_path ? objdump_path : "objdump",
1624 disassembler_style ? "-M " : "",
1625 disassembler_style ? disassembler_style : "",
1626 map__rip_2objdump(map, sym->start),
1627 map__rip_2objdump(map, sym->end),
1628 symbol_conf.annotate_asm_raw ? "" : "--no-show-raw",
1629 symbol_conf.annotate_src ? "-S" : "",
1630 symfs_filename, symfs_filename);
1633 pr_err("Failure allocating memory for the command to run\n");
1634 goto out_remove_tmp;
1637 pr_debug("Executing: %s\n", command);
1640 if (pipe(stdout_fd) < 0) {
1641 pr_err("Failure creating the pipe to run %s\n", command);
1642 goto out_free_command;
1647 pr_err("Failure forking to run %s\n", command);
1648 goto out_close_stdout;
1652 close(stdout_fd[0]);
1653 dup2(stdout_fd[1], 1);
1654 close(stdout_fd[1]);
1655 execl("/bin/sh", "sh", "-c", command, NULL);
1660 close(stdout_fd[1]);
1662 file = fdopen(stdout_fd[0], "r");
1664 pr_err("Failure creating FILE stream for %s\n", command);
1666 * If we were using debug info should retry with
1669 goto out_free_command;
1673 while (!feof(file)) {
1675 * The source code line number (lineno) needs to be kept in
1676 * accross calls to symbol__parse_objdump_line(), so that it
1677 * can associate it with the instructions till the next one.
1678 * See disasm_line__new() and struct disasm_line::line_nr.
1680 if (symbol__parse_objdump_line(sym, file, args, &lineno) < 0)
1686 pr_err("No output from %s\n", command);
1689 * kallsyms does not have symbol sizes so there may a nop at the end.
1692 if (dso__is_kcore(dso))
1693 delete_last_nop(sym);
1700 close(stdout_fd[0]);
1702 if (dso__needs_decompress(dso))
1703 unlink(symfs_filename);
1706 kcore_extract__delete(&kce);
1711 close(stdout_fd[1]);
1712 goto out_free_command;
1715 static void calc_percent(struct sym_hist *hist,
1716 struct annotation_data *sample,
1717 s64 offset, s64 end)
1719 unsigned int hits = 0;
1722 while (offset < end) {
1723 hits += hist->addr[offset].nr_samples;
1724 period += hist->addr[offset].period;
1728 if (hist->nr_samples) {
1729 sample->he.period = period;
1730 sample->he.nr_samples = hits;
1731 sample->percent = 100.0 * hits / hist->nr_samples;
1735 static void annotation__calc_percent(struct annotation *notes,
1736 struct perf_evsel *evsel, s64 len)
1738 struct annotation_line *al, *next;
1740 list_for_each_entry(al, ¬es->src->source, node) {
1744 if (al->offset == -1)
1747 next = annotation_line__next(al, ¬es->src->source);
1748 end = next ? next->offset : len;
1750 for (i = 0; i < al->samples_nr; i++) {
1751 struct annotation_data *sample;
1752 struct sym_hist *hist;
1754 hist = annotation__histogram(notes, evsel->idx + i);
1755 sample = &al->samples[i];
1757 calc_percent(hist, sample, al->offset, end);
1762 void symbol__calc_percent(struct symbol *sym, struct perf_evsel *evsel)
1764 struct annotation *notes = symbol__annotation(sym);
1766 annotation__calc_percent(notes, evsel, symbol__size(sym));
1769 int symbol__annotate(struct symbol *sym, struct map *map,
1770 struct perf_evsel *evsel, size_t privsize,
1771 struct arch **parch)
1773 struct annotate_args args = {
1774 .privsize = privsize,
1777 struct perf_env *env = perf_evsel__env(evsel);
1778 const char *arch_name = perf_env__arch(env);
1785 args.arch = arch = arch__find(arch_name);
1793 err = arch->init(arch, env ? env->cpuid : NULL);
1795 pr_err("%s: failed to initialize %s arch priv area\n", __func__, arch->name);
1803 return symbol__disassemble(sym, &args);
1806 static void insert_source_line(struct rb_root *root, struct annotation_line *al)
1808 struct annotation_line *iter;
1809 struct rb_node **p = &root->rb_node;
1810 struct rb_node *parent = NULL;
1813 while (*p != NULL) {
1815 iter = rb_entry(parent, struct annotation_line, rb_node);
1817 ret = strcmp(iter->path, al->path);
1819 for (i = 0; i < al->samples_nr; i++)
1820 iter->samples[i].percent_sum += al->samples[i].percent;
1827 p = &(*p)->rb_right;
1830 for (i = 0; i < al->samples_nr; i++)
1831 al->samples[i].percent_sum = al->samples[i].percent;
1833 rb_link_node(&al->rb_node, parent, p);
1834 rb_insert_color(&al->rb_node, root);
1837 static int cmp_source_line(struct annotation_line *a, struct annotation_line *b)
1841 for (i = 0; i < a->samples_nr; i++) {
1842 if (a->samples[i].percent_sum == b->samples[i].percent_sum)
1844 return a->samples[i].percent_sum > b->samples[i].percent_sum;
1850 static void __resort_source_line(struct rb_root *root, struct annotation_line *al)
1852 struct annotation_line *iter;
1853 struct rb_node **p = &root->rb_node;
1854 struct rb_node *parent = NULL;
1856 while (*p != NULL) {
1858 iter = rb_entry(parent, struct annotation_line, rb_node);
1860 if (cmp_source_line(al, iter))
1863 p = &(*p)->rb_right;
1866 rb_link_node(&al->rb_node, parent, p);
1867 rb_insert_color(&al->rb_node, root);
1870 static void resort_source_line(struct rb_root *dest_root, struct rb_root *src_root)
1872 struct annotation_line *al;
1873 struct rb_node *node;
1875 node = rb_first(src_root);
1877 struct rb_node *next;
1879 al = rb_entry(node, struct annotation_line, rb_node);
1880 next = rb_next(node);
1881 rb_erase(node, src_root);
1883 __resort_source_line(dest_root, al);
1888 static void print_summary(struct rb_root *root, const char *filename)
1890 struct annotation_line *al;
1891 struct rb_node *node;
1893 printf("\nSorted summary for file %s\n", filename);
1894 printf("----------------------------------------------\n\n");
1896 if (RB_EMPTY_ROOT(root)) {
1897 printf(" Nothing higher than %1.1f%%\n", MIN_GREEN);
1901 node = rb_first(root);
1903 double percent, percent_max = 0.0;
1908 al = rb_entry(node, struct annotation_line, rb_node);
1909 for (i = 0; i < al->samples_nr; i++) {
1910 percent = al->samples[i].percent_sum;
1911 color = get_percent_color(percent);
1912 color_fprintf(stdout, color, " %7.2f", percent);
1914 if (percent > percent_max)
1915 percent_max = percent;
1919 color = get_percent_color(percent_max);
1920 color_fprintf(stdout, color, " %s\n", path);
1922 node = rb_next(node);
1926 static void symbol__annotate_hits(struct symbol *sym, struct perf_evsel *evsel)
1928 struct annotation *notes = symbol__annotation(sym);
1929 struct sym_hist *h = annotation__histogram(notes, evsel->idx);
1930 u64 len = symbol__size(sym), offset;
1932 for (offset = 0; offset < len; ++offset)
1933 if (h->addr[offset].nr_samples != 0)
1934 printf("%*" PRIx64 ": %" PRIu64 "\n", BITS_PER_LONG / 2,
1935 sym->start + offset, h->addr[offset].nr_samples);
1936 printf("%*s: %" PRIu64 "\n", BITS_PER_LONG / 2, "h->nr_samples", h->nr_samples);
1939 static int annotated_source__addr_fmt_width(struct list_head *lines, u64 start)
1942 struct annotation_line *line;
1944 list_for_each_entry_reverse(line, lines, node) {
1945 if (line->offset != -1)
1946 return scnprintf(bf, sizeof(bf), "%" PRIx64, start + line->offset);
1952 int symbol__annotate_printf(struct symbol *sym, struct map *map,
1953 struct perf_evsel *evsel, bool full_paths,
1954 int min_pcnt, int max_lines, int context)
1956 struct dso *dso = map->dso;
1958 const char *d_filename;
1959 const char *evsel_name = perf_evsel__name(evsel);
1960 struct annotation *notes = symbol__annotation(sym);
1961 struct sym_hist *h = annotation__histogram(notes, evsel->idx);
1962 struct annotation_line *pos, *queue = NULL;
1963 u64 start = map__rip_2objdump(map, sym->start);
1964 int printed = 2, queue_len = 0, addr_fmt_width;
1967 int width = symbol_conf.show_total_period ? 12 : 8;
1968 int graph_dotted_len;
1971 filename = strdup(dso->long_name);
1976 d_filename = filename;
1978 d_filename = basename(filename);
1980 len = symbol__size(sym);
1982 if (perf_evsel__is_group_event(evsel)) {
1983 width *= evsel->nr_members;
1984 perf_evsel__group_desc(evsel, buf, sizeof(buf));
1988 graph_dotted_len = printf(" %-*.*s| Source code & Disassembly of %s for %s (%" PRIu64 " samples)\n",
1989 width, width, symbol_conf.show_total_period ? "Period" :
1990 symbol_conf.show_nr_samples ? "Samples" : "Percent",
1991 d_filename, evsel_name, h->nr_samples);
1993 printf("%-*.*s----\n",
1994 graph_dotted_len, graph_dotted_len, graph_dotted_line);
1997 symbol__annotate_hits(sym, evsel);
1999 addr_fmt_width = annotated_source__addr_fmt_width(¬es->src->source, start);
2001 list_for_each_entry(pos, ¬es->src->source, node) {
2004 if (context && queue == NULL) {
2009 err = annotation_line__print(pos, sym, start, evsel, len,
2010 min_pcnt, printed, max_lines,
2011 queue, addr_fmt_width);
2017 printed += queue_len;
2023 /* filtered by max_lines */
2029 * Filtered by min_pcnt or non IP lines when
2034 if (queue_len == context)
2035 queue = list_entry(queue->node.next, typeof(*queue), node);
2047 static void FILE__set_percent_color(void *fp __maybe_unused,
2048 double percent __maybe_unused,
2049 bool current __maybe_unused)
2053 static int FILE__set_jumps_percent_color(void *fp __maybe_unused,
2054 int nr __maybe_unused, bool current __maybe_unused)
2059 static int FILE__set_color(void *fp __maybe_unused, int color __maybe_unused)
2064 static void FILE__printf(void *fp, const char *fmt, ...)
2068 va_start(args, fmt);
2069 vfprintf(fp, fmt, args);
2073 static void FILE__write_graph(void *fp, int graph)
2078 case DARROW_CHAR: s = "↓"; break;
2079 case UARROW_CHAR: s = "↑"; break;
2080 case LARROW_CHAR: s = "←"; break;
2081 case RARROW_CHAR: s = "→"; break;
2082 default: s = "?"; break;
2088 int symbol__annotate_fprintf2(struct symbol *sym, FILE *fp)
2090 struct annotation *notes = symbol__annotation(sym);
2091 struct annotation_write_ops ops = {
2094 .set_color = FILE__set_color,
2095 .set_percent_color = FILE__set_percent_color,
2096 .set_jumps_percent_color = FILE__set_jumps_percent_color,
2097 .printf = FILE__printf,
2098 .write_graph = FILE__write_graph,
2100 struct annotation_line *al;
2102 list_for_each_entry(al, ¬es->src->source, node) {
2103 if (annotation_line__filter(al, notes))
2105 annotation_line__write(al, notes, &ops);
2107 ops.first_line = false;
2113 int map_symbol__annotation_dump(struct map_symbol *ms, struct perf_evsel *evsel)
2115 const char *ev_name = perf_evsel__name(evsel);
2121 if (asprintf(&filename, "%s.annotation", ms->sym->name) < 0)
2124 fp = fopen(filename, "w");
2126 goto out_free_filename;
2128 if (perf_evsel__is_group_event(evsel)) {
2129 perf_evsel__group_desc(evsel, buf, sizeof(buf));
2133 fprintf(fp, "%s() %s\nEvent: %s\n\n",
2134 ms->sym->name, ms->map->dso->long_name, ev_name);
2135 symbol__annotate_fprintf2(ms->sym, fp);
2144 void symbol__annotate_zero_histogram(struct symbol *sym, int evidx)
2146 struct annotation *notes = symbol__annotation(sym);
2147 struct sym_hist *h = annotation__histogram(notes, evidx);
2149 memset(h, 0, notes->src->sizeof_sym_hist);
2152 void symbol__annotate_decay_histogram(struct symbol *sym, int evidx)
2154 struct annotation *notes = symbol__annotation(sym);
2155 struct sym_hist *h = annotation__histogram(notes, evidx);
2156 int len = symbol__size(sym), offset;
2159 for (offset = 0; offset < len; ++offset) {
2160 h->addr[offset].nr_samples = h->addr[offset].nr_samples * 7 / 8;
2161 h->nr_samples += h->addr[offset].nr_samples;
2165 void annotated_source__purge(struct annotated_source *as)
2167 struct annotation_line *al, *n;
2169 list_for_each_entry_safe(al, n, &as->source, node) {
2170 list_del(&al->node);
2171 disasm_line__free(disasm_line(al));
2175 static size_t disasm_line__fprintf(struct disasm_line *dl, FILE *fp)
2179 if (dl->al.offset == -1)
2180 return fprintf(fp, "%s\n", dl->al.line);
2182 printed = fprintf(fp, "%#" PRIx64 " %s", dl->al.offset, dl->ins.name);
2184 if (dl->ops.raw[0] != '\0') {
2185 printed += fprintf(fp, "%.*s %s\n", 6 - (int)printed, " ",
2189 return printed + fprintf(fp, "\n");
2192 size_t disasm__fprintf(struct list_head *head, FILE *fp)
2194 struct disasm_line *pos;
2197 list_for_each_entry(pos, head, al.node)
2198 printed += disasm_line__fprintf(pos, fp);
2203 bool disasm_line__is_valid_local_jump(struct disasm_line *dl, struct symbol *sym)
2205 if (!dl || !dl->ins.ops || !ins__is_jump(&dl->ins) ||
2206 !disasm_line__has_local_offset(dl) || dl->ops.target.offset < 0 ||
2207 dl->ops.target.offset >= (s64)symbol__size(sym))
2213 void annotation__mark_jump_targets(struct annotation *notes, struct symbol *sym)
2215 u64 offset, size = symbol__size(sym);
2217 /* PLT symbols contain external offsets */
2218 if (strstr(sym->name, "@plt"))
2221 for (offset = 0; offset < size; ++offset) {
2222 struct annotation_line *al = notes->offsets[offset];
2223 struct disasm_line *dl;
2225 dl = disasm_line(al);
2227 if (!disasm_line__is_valid_local_jump(dl, sym))
2230 al = notes->offsets[dl->ops.target.offset];
2233 * FIXME: Oops, no jump target? Buggy disassembler? Or do we
2234 * have to adjust to the previous offset?
2239 if (++al->jump_sources > notes->max_jump_sources)
2240 notes->max_jump_sources = al->jump_sources;
2246 void annotation__set_offsets(struct annotation *notes, s64 size)
2248 struct annotation_line *al;
2250 notes->max_line_len = 0;
2252 list_for_each_entry(al, ¬es->src->source, node) {
2253 size_t line_len = strlen(al->line);
2255 if (notes->max_line_len < line_len)
2256 notes->max_line_len = line_len;
2257 al->idx = notes->nr_entries++;
2258 if (al->offset != -1) {
2259 al->idx_asm = notes->nr_asm_entries++;
2261 * FIXME: short term bandaid to cope with assembly
2262 * routines that comes with labels in the same column
2263 * as the address in objdump, sigh.
2265 * E.g. copy_user_generic_unrolled
2267 if (al->offset < size)
2268 notes->offsets[al->offset] = al;
2274 static inline int width_jumps(int n)
2283 void annotation__init_column_widths(struct annotation *notes, struct symbol *sym)
2285 notes->widths.addr = notes->widths.target =
2286 notes->widths.min_addr = hex_width(symbol__size(sym));
2287 notes->widths.max_addr = hex_width(sym->end);
2288 notes->widths.jumps = width_jumps(notes->max_jump_sources);
2291 void annotation__update_column_widths(struct annotation *notes)
2293 if (notes->options->use_offset)
2294 notes->widths.target = notes->widths.min_addr;
2296 notes->widths.target = notes->widths.max_addr;
2298 notes->widths.addr = notes->widths.target;
2300 if (notes->options->show_nr_jumps)
2301 notes->widths.addr += notes->widths.jumps + 1;
2304 static void annotation__calc_lines(struct annotation *notes, struct map *map,
2305 struct rb_root *root)
2307 struct annotation_line *al;
2308 struct rb_root tmp_root = RB_ROOT;
2310 list_for_each_entry(al, ¬es->src->source, node) {
2311 double percent_max = 0.0;
2314 for (i = 0; i < al->samples_nr; i++) {
2315 struct annotation_data *sample;
2317 sample = &al->samples[i];
2319 if (sample->percent > percent_max)
2320 percent_max = sample->percent;
2323 if (percent_max <= 0.5)
2326 al->path = get_srcline(map->dso, notes->start + al->offset, NULL,
2327 false, true, notes->start + al->offset);
2328 insert_source_line(&tmp_root, al);
2331 resort_source_line(root, &tmp_root);
2334 static void symbol__calc_lines(struct symbol *sym, struct map *map,
2335 struct rb_root *root)
2337 struct annotation *notes = symbol__annotation(sym);
2339 annotation__calc_lines(notes, map, root);
2342 int symbol__tty_annotate2(struct symbol *sym, struct map *map,
2343 struct perf_evsel *evsel, bool print_lines,
2346 struct dso *dso = map->dso;
2347 struct rb_root source_line = RB_ROOT;
2348 struct annotation_options opts = annotation__default_options;
2349 struct annotation *notes = symbol__annotation(sym);
2352 if (symbol__annotate2(sym, map, evsel, &opts, NULL) < 0)
2356 srcline_full_filename = full_paths;
2357 symbol__calc_lines(sym, map, &source_line);
2358 print_summary(&source_line, dso->long_name);
2361 annotation__scnprintf_samples_period(notes, buf, sizeof(buf), evsel);
2362 fprintf(stdout, "%s\n%s() %s\n", buf, sym->name, dso->long_name);
2363 symbol__annotate_fprintf2(sym, stdout);
2365 annotated_source__purge(symbol__annotation(sym)->src);
2370 int symbol__tty_annotate(struct symbol *sym, struct map *map,
2371 struct perf_evsel *evsel, bool print_lines,
2372 bool full_paths, int min_pcnt, int max_lines)
2374 struct dso *dso = map->dso;
2375 struct rb_root source_line = RB_ROOT;
2377 if (symbol__annotate(sym, map, evsel, 0, NULL) < 0)
2380 symbol__calc_percent(sym, evsel);
2383 srcline_full_filename = full_paths;
2384 symbol__calc_lines(sym, map, &source_line);
2385 print_summary(&source_line, dso->long_name);
2388 symbol__annotate_printf(sym, map, evsel, full_paths,
2389 min_pcnt, max_lines, 0);
2391 annotated_source__purge(symbol__annotation(sym)->src);
2396 bool ui__has_annotation(void)
2398 return use_browser == 1 && perf_hpp_list.sym;
2402 double annotation_line__max_percent(struct annotation_line *al, struct annotation *notes)
2404 double percent_max = 0.0;
2407 for (i = 0; i < notes->nr_events; i++) {
2408 if (al->samples[i].percent > percent_max)
2409 percent_max = al->samples[i].percent;
2415 static void disasm_line__write(struct disasm_line *dl, struct annotation *notes,
2416 void *obj, char *bf, size_t size,
2417 void (*obj__printf)(void *obj, const char *fmt, ...),
2418 void (*obj__write_graph)(void *obj, int graph))
2420 if (dl->ins.ops && dl->ins.ops->scnprintf) {
2421 if (ins__is_jump(&dl->ins)) {
2424 if (dl->ops.target.outside)
2426 fwd = dl->ops.target.offset > dl->al.offset;
2427 obj__write_graph(obj, fwd ? DARROW_CHAR : UARROW_CHAR);
2428 obj__printf(obj, " ");
2429 } else if (ins__is_call(&dl->ins)) {
2431 obj__write_graph(obj, RARROW_CHAR);
2432 obj__printf(obj, " ");
2433 } else if (ins__is_ret(&dl->ins)) {
2434 obj__write_graph(obj, LARROW_CHAR);
2435 obj__printf(obj, " ");
2437 obj__printf(obj, " ");
2440 obj__printf(obj, " ");
2443 disasm_line__scnprintf(dl, bf, size, !notes->options->use_offset);
2446 static void __annotation_line__write(struct annotation_line *al, struct annotation *notes,
2447 bool first_line, bool current_entry, bool change_color, int width,
2449 int (*obj__set_color)(void *obj, int color),
2450 void (*obj__set_percent_color)(void *obj, double percent, bool current),
2451 int (*obj__set_jumps_percent_color)(void *obj, int nr, bool current),
2452 void (*obj__printf)(void *obj, const char *fmt, ...),
2453 void (*obj__write_graph)(void *obj, int graph))
2456 double percent_max = annotation_line__max_percent(al, notes);
2457 int pcnt_width = annotation__pcnt_width(notes),
2458 cycles_width = annotation__cycles_width(notes);
2459 bool show_title = false;
2463 if (first_line && (al->offset == -1 || percent_max == 0.0)) {
2464 if (notes->have_cycles) {
2465 if (al->ipc == 0.0 && al->cycles == 0)
2471 if (al->offset != -1 && percent_max != 0.0) {
2474 for (i = 0; i < notes->nr_events; i++) {
2475 obj__set_percent_color(obj, al->samples[i].percent, current_entry);
2476 if (notes->options->show_total_period) {
2477 obj__printf(obj, "%11" PRIu64 " ", al->samples[i].he.period);
2478 } else if (notes->options->show_nr_samples) {
2479 obj__printf(obj, "%6" PRIu64 " ",
2480 al->samples[i].he.nr_samples);
2482 obj__printf(obj, "%6.2f ",
2483 al->samples[i].percent);
2487 obj__set_percent_color(obj, 0, current_entry);
2490 obj__printf(obj, "%-*s", pcnt_width, " ");
2492 obj__printf(obj, "%-*s", pcnt_width,
2493 notes->options->show_total_period ? "Period" :
2494 notes->options->show_nr_samples ? "Samples" : "Percent");
2498 if (notes->have_cycles) {
2500 obj__printf(obj, "%*.2f ", ANNOTATION__IPC_WIDTH - 1, al->ipc);
2501 else if (!show_title)
2502 obj__printf(obj, "%*s", ANNOTATION__IPC_WIDTH, " ");
2504 obj__printf(obj, "%*s ", ANNOTATION__IPC_WIDTH - 1, "IPC");
2506 if (!notes->options->show_minmax_cycle) {
2508 obj__printf(obj, "%*" PRIu64 " ",
2509 ANNOTATION__CYCLES_WIDTH - 1, al->cycles);
2510 else if (!show_title)
2511 obj__printf(obj, "%*s",
2512 ANNOTATION__CYCLES_WIDTH, " ");
2514 obj__printf(obj, "%*s ",
2515 ANNOTATION__CYCLES_WIDTH - 1,
2521 scnprintf(str, sizeof(str),
2522 "%" PRIu64 "(%" PRIu64 "/%" PRIu64 ")",
2523 al->cycles, al->cycles_min,
2526 obj__printf(obj, "%*s ",
2527 ANNOTATION__MINMAX_CYCLES_WIDTH - 1,
2529 } else if (!show_title)
2530 obj__printf(obj, "%*s",
2531 ANNOTATION__MINMAX_CYCLES_WIDTH,
2534 obj__printf(obj, "%*s ",
2535 ANNOTATION__MINMAX_CYCLES_WIDTH - 1,
2540 obj__printf(obj, " ");
2543 obj__printf(obj, "%-*s", width - pcnt_width - cycles_width, " ");
2544 else if (al->offset == -1) {
2545 if (al->line_nr && notes->options->show_linenr)
2546 printed = scnprintf(bf, sizeof(bf), "%-*d ", notes->widths.addr + 1, al->line_nr);
2548 printed = scnprintf(bf, sizeof(bf), "%-*s ", notes->widths.addr, " ");
2549 obj__printf(obj, bf);
2550 obj__printf(obj, "%-*s", width - printed - pcnt_width - cycles_width + 1, al->line);
2552 u64 addr = al->offset;
2555 if (!notes->options->use_offset)
2556 addr += notes->start;
2558 if (!notes->options->use_offset) {
2559 printed = scnprintf(bf, sizeof(bf), "%" PRIx64 ": ", addr);
2561 if (al->jump_sources &&
2562 notes->options->offset_level >= ANNOTATION__OFFSET_JUMP_TARGETS) {
2563 if (notes->options->show_nr_jumps) {
2565 printed = scnprintf(bf, sizeof(bf), "%*d ",
2566 notes->widths.jumps,
2568 prev = obj__set_jumps_percent_color(obj, al->jump_sources,
2570 obj__printf(obj, bf);
2571 obj__set_color(obj, prev);
2574 printed = scnprintf(bf, sizeof(bf), "%*" PRIx64 ": ",
2575 notes->widths.target, addr);
2576 } else if (ins__is_call(&disasm_line(al)->ins) &&
2577 notes->options->offset_level >= ANNOTATION__OFFSET_CALL) {
2579 } else if (notes->options->offset_level == ANNOTATION__MAX_OFFSET_LEVEL) {
2582 printed = scnprintf(bf, sizeof(bf), "%-*s ",
2583 notes->widths.addr, " ");
2588 color = obj__set_color(obj, HE_COLORSET_ADDR);
2589 obj__printf(obj, bf);
2591 obj__set_color(obj, color);
2593 disasm_line__write(disasm_line(al), notes, obj, bf, sizeof(bf), obj__printf, obj__write_graph);
2595 obj__printf(obj, "%-*s", width - pcnt_width - cycles_width - 3 - printed, bf);
2600 void annotation_line__write(struct annotation_line *al, struct annotation *notes,
2601 struct annotation_write_ops *ops)
2603 __annotation_line__write(al, notes, ops->first_line, ops->current_entry,
2604 ops->change_color, ops->width, ops->obj,
2605 ops->set_color, ops->set_percent_color,
2606 ops->set_jumps_percent_color, ops->printf,
2610 int symbol__annotate2(struct symbol *sym, struct map *map, struct perf_evsel *evsel,
2611 struct annotation_options *options, struct arch **parch)
2613 struct annotation *notes = symbol__annotation(sym);
2614 size_t size = symbol__size(sym);
2615 int nr_pcnt = 1, err;
2617 notes->offsets = zalloc(size * sizeof(struct annotation_line *));
2618 if (notes->offsets == NULL)
2621 if (perf_evsel__is_group_event(evsel))
2622 nr_pcnt = evsel->nr_members;
2624 err = symbol__annotate(sym, map, evsel, 0, parch);
2626 goto out_free_offsets;
2628 notes->options = options;
2630 symbol__calc_percent(sym, evsel);
2632 notes->start = map__rip_2objdump(map, sym->start);
2634 annotation__set_offsets(notes, size);
2635 annotation__mark_jump_targets(notes, sym);
2636 annotation__compute_ipc(notes, size);
2637 annotation__init_column_widths(notes, sym);
2638 notes->nr_events = nr_pcnt;
2640 annotation__update_column_widths(notes);
2645 zfree(¬es->offsets);
2649 int __annotation__scnprintf_samples_period(struct annotation *notes,
2650 char *bf, size_t size,
2651 struct perf_evsel *evsel,
2654 const char *ev_name = perf_evsel__name(evsel);
2655 char buf[1024], ref[30] = " show reference callgraph, ";
2656 char sample_freq_str[64] = "";
2657 unsigned long nr_samples = 0;
2659 bool enable_ref = false;
2664 if (perf_evsel__is_group_event(evsel)) {
2665 perf_evsel__group_desc(evsel, buf, sizeof(buf));
2667 nr_members = evsel->nr_members;
2670 for (i = 0; i < nr_members; i++) {
2671 struct sym_hist *ah = annotation__histogram(notes, evsel->idx + i);
2673 nr_samples += ah->nr_samples;
2674 nr_events += ah->period;
2677 if (symbol_conf.show_ref_callgraph && strstr(ev_name, "call-graph=no"))
2681 scnprintf(sample_freq_str, sizeof(sample_freq_str), " %d Hz,", evsel->attr.sample_freq);
2683 nr_samples = convert_unit(nr_samples, &unit);
2684 return scnprintf(bf, size, "Samples: %lu%c of event%s '%s',%s%sEvent count (approx.): %" PRIu64,
2685 nr_samples, unit, evsel->nr_members > 1 ? "s" : "",
2686 ev_name, sample_freq_str, enable_ref ? ref : " ", nr_events);
2689 #define ANNOTATION__CFG(n) \
2690 { .name = #n, .value = &annotation__default_options.n, }
2693 * Keep the entries sorted, they are bsearch'ed
2695 static struct annotation_config {
2698 } annotation__configs[] = {
2699 ANNOTATION__CFG(hide_src_code),
2700 ANNOTATION__CFG(jump_arrows),
2701 ANNOTATION__CFG(offset_level),
2702 ANNOTATION__CFG(show_linenr),
2703 ANNOTATION__CFG(show_nr_jumps),
2704 ANNOTATION__CFG(show_nr_samples),
2705 ANNOTATION__CFG(show_total_period),
2706 ANNOTATION__CFG(use_offset),
2709 #undef ANNOTATION__CFG
2711 static int annotation_config__cmp(const void *name, const void *cfgp)
2713 const struct annotation_config *cfg = cfgp;
2715 return strcmp(name, cfg->name);
2718 static int annotation__config(const char *var, const char *value,
2719 void *data __maybe_unused)
2721 struct annotation_config *cfg;
2724 if (!strstarts(var, "annotate."))
2728 cfg = bsearch(name, annotation__configs, ARRAY_SIZE(annotation__configs),
2729 sizeof(struct annotation_config), annotation_config__cmp);
2732 pr_debug("%s variable unknown, ignoring...", var);
2733 else if (strcmp(var, "annotate.offset_level") == 0) {
2734 perf_config_int(cfg->value, name, value);
2736 if (*(int *)cfg->value > ANNOTATION__MAX_OFFSET_LEVEL)
2737 *(int *)cfg->value = ANNOTATION__MAX_OFFSET_LEVEL;
2738 else if (*(int *)cfg->value < ANNOTATION__MIN_OFFSET_LEVEL)
2739 *(int *)cfg->value = ANNOTATION__MIN_OFFSET_LEVEL;
2741 *(bool *)cfg->value = perf_config_bool(name, value);
2746 void annotation_config__init(void)
2748 perf_config(annotation__config, NULL);
2750 annotation__default_options.show_total_period = symbol_conf.show_total_period;
2751 annotation__default_options.show_nr_samples = symbol_conf.show_nr_samples;