xref: /linux/tools/perf/builtin-annotate.c (revision 2277ab4a1df50e05bc732fe9488d4e902bb8399a)
1 /*
2  * builtin-annotate.c
3  *
4  * Builtin annotate command: Analyze the perf.data input file,
5  * look up and read DSOs and symbol information and display
6  * a histogram of results, along various sorting keys.
7  */
8 #include "builtin.h"
9 
10 #include "util/util.h"
11 
12 #include "util/color.h"
13 #include <linux/list.h>
14 #include "util/cache.h"
15 #include <linux/rbtree.h>
16 #include "util/symbol.h"
17 #include "util/string.h"
18 
19 #include "perf.h"
20 
21 #include "util/parse-options.h"
22 #include "util/parse-events.h"
23 
24 #define SHOW_KERNEL	1
25 #define SHOW_USER	2
26 #define SHOW_HV		4
27 
28 static char		const *input_name = "perf.data";
29 static char		*vmlinux = "vmlinux";
30 
31 static char		default_sort_order[] = "comm,symbol";
32 static char		*sort_order = default_sort_order;
33 
34 static int		input;
35 static int		show_mask = SHOW_KERNEL | SHOW_USER | SHOW_HV;
36 
37 static int		dump_trace = 0;
38 #define dprintf(x...)	do { if (dump_trace) printf(x); } while (0)
39 
40 static int		verbose;
41 
42 static int		modules;
43 
44 static int		full_paths;
45 
46 static int		print_line;
47 
48 static unsigned long	page_size;
49 static unsigned long	mmap_window = 32;
50 
51 struct ip_event {
52 	struct perf_event_header header;
53 	u64 ip;
54 	u32 pid, tid;
55 };
56 
57 struct mmap_event {
58 	struct perf_event_header header;
59 	u32 pid, tid;
60 	u64 start;
61 	u64 len;
62 	u64 pgoff;
63 	char filename[PATH_MAX];
64 };
65 
66 struct comm_event {
67 	struct perf_event_header header;
68 	u32 pid, tid;
69 	char comm[16];
70 };
71 
72 struct fork_event {
73 	struct perf_event_header header;
74 	u32 pid, ppid;
75 };
76 
77 struct period_event {
78 	struct perf_event_header header;
79 	u64 time;
80 	u64 id;
81 	u64 sample_period;
82 };
83 
84 typedef union event_union {
85 	struct perf_event_header	header;
86 	struct ip_event			ip;
87 	struct mmap_event		mmap;
88 	struct comm_event		comm;
89 	struct fork_event		fork;
90 	struct period_event		period;
91 } event_t;
92 
93 
94 struct sym_ext {
95 	struct rb_node	node;
96 	double		percent;
97 	char		*path;
98 };
99 
100 static LIST_HEAD(dsos);
101 static struct dso *kernel_dso;
102 static struct dso *vdso;
103 
104 
105 static void dsos__add(struct dso *dso)
106 {
107 	list_add_tail(&dso->node, &dsos);
108 }
109 
110 static struct dso *dsos__find(const char *name)
111 {
112 	struct dso *pos;
113 
114 	list_for_each_entry(pos, &dsos, node)
115 		if (strcmp(pos->name, name) == 0)
116 			return pos;
117 	return NULL;
118 }
119 
120 static struct dso *dsos__findnew(const char *name)
121 {
122 	struct dso *dso = dsos__find(name);
123 	int nr;
124 
125 	if (dso)
126 		return dso;
127 
128 	dso = dso__new(name, 0);
129 	if (!dso)
130 		goto out_delete_dso;
131 
132 	nr = dso__load(dso, NULL, verbose);
133 	if (nr < 0) {
134 		if (verbose)
135 			fprintf(stderr, "Failed to open: %s\n", name);
136 		goto out_delete_dso;
137 	}
138 	if (!nr && verbose) {
139 		fprintf(stderr,
140 		"No symbols found in: %s, maybe install a debug package?\n",
141 				name);
142 	}
143 
144 	dsos__add(dso);
145 
146 	return dso;
147 
148 out_delete_dso:
149 	dso__delete(dso);
150 	return NULL;
151 }
152 
153 static void dsos__fprintf(FILE *fp)
154 {
155 	struct dso *pos;
156 
157 	list_for_each_entry(pos, &dsos, node)
158 		dso__fprintf(pos, fp);
159 }
160 
161 static struct symbol *vdso__find_symbol(struct dso *dso, u64 ip)
162 {
163 	return dso__find_symbol(dso, ip);
164 }
165 
166 static int load_kernel(void)
167 {
168 	int err;
169 
170 	kernel_dso = dso__new("[kernel]", 0);
171 	if (!kernel_dso)
172 		return -1;
173 
174 	err = dso__load_kernel(kernel_dso, vmlinux, NULL, verbose, modules);
175 	if (err <= 0) {
176 		dso__delete(kernel_dso);
177 		kernel_dso = NULL;
178 	} else
179 		dsos__add(kernel_dso);
180 
181 	vdso = dso__new("[vdso]", 0);
182 	if (!vdso)
183 		return -1;
184 
185 	vdso->find_symbol = vdso__find_symbol;
186 
187 	dsos__add(vdso);
188 
189 	return err;
190 }
191 
192 struct map {
193 	struct list_head node;
194 	u64	 start;
195 	u64	 end;
196 	u64	 pgoff;
197 	u64	 (*map_ip)(struct map *, u64);
198 	struct dso	 *dso;
199 };
200 
201 static u64 map__map_ip(struct map *map, u64 ip)
202 {
203 	return ip - map->start + map->pgoff;
204 }
205 
206 static u64 vdso__map_ip(struct map *map __used, u64 ip)
207 {
208 	return ip;
209 }
210 
211 static struct map *map__new(struct mmap_event *event)
212 {
213 	struct map *self = malloc(sizeof(*self));
214 
215 	if (self != NULL) {
216 		const char *filename = event->filename;
217 
218 		self->start = event->start;
219 		self->end   = event->start + event->len;
220 		self->pgoff = event->pgoff;
221 
222 		self->dso = dsos__findnew(filename);
223 		if (self->dso == NULL)
224 			goto out_delete;
225 
226 		if (self->dso == vdso)
227 			self->map_ip = vdso__map_ip;
228 		else
229 			self->map_ip = map__map_ip;
230 	}
231 	return self;
232 out_delete:
233 	free(self);
234 	return NULL;
235 }
236 
237 static struct map *map__clone(struct map *self)
238 {
239 	struct map *map = malloc(sizeof(*self));
240 
241 	if (!map)
242 		return NULL;
243 
244 	memcpy(map, self, sizeof(*self));
245 
246 	return map;
247 }
248 
249 static int map__overlap(struct map *l, struct map *r)
250 {
251 	if (l->start > r->start) {
252 		struct map *t = l;
253 		l = r;
254 		r = t;
255 	}
256 
257 	if (l->end > r->start)
258 		return 1;
259 
260 	return 0;
261 }
262 
263 static size_t map__fprintf(struct map *self, FILE *fp)
264 {
265 	return fprintf(fp, " %Lx-%Lx %Lx %s\n",
266 		       self->start, self->end, self->pgoff, self->dso->name);
267 }
268 
269 
270 struct thread {
271 	struct rb_node	 rb_node;
272 	struct list_head maps;
273 	pid_t		 pid;
274 	char		 *comm;
275 };
276 
277 static struct thread *thread__new(pid_t pid)
278 {
279 	struct thread *self = malloc(sizeof(*self));
280 
281 	if (self != NULL) {
282 		self->pid = pid;
283 		self->comm = malloc(32);
284 		if (self->comm)
285 			snprintf(self->comm, 32, ":%d", self->pid);
286 		INIT_LIST_HEAD(&self->maps);
287 	}
288 
289 	return self;
290 }
291 
292 static int thread__set_comm(struct thread *self, const char *comm)
293 {
294 	if (self->comm)
295 		free(self->comm);
296 	self->comm = strdup(comm);
297 	return self->comm ? 0 : -ENOMEM;
298 }
299 
300 static size_t thread__fprintf(struct thread *self, FILE *fp)
301 {
302 	struct map *pos;
303 	size_t ret = fprintf(fp, "Thread %d %s\n", self->pid, self->comm);
304 
305 	list_for_each_entry(pos, &self->maps, node)
306 		ret += map__fprintf(pos, fp);
307 
308 	return ret;
309 }
310 
311 
312 static struct rb_root threads;
313 static struct thread *last_match;
314 
315 static struct thread *threads__findnew(pid_t pid)
316 {
317 	struct rb_node **p = &threads.rb_node;
318 	struct rb_node *parent = NULL;
319 	struct thread *th;
320 
321 	/*
322 	 * Font-end cache - PID lookups come in blocks,
323 	 * so most of the time we dont have to look up
324 	 * the full rbtree:
325 	 */
326 	if (last_match && last_match->pid == pid)
327 		return last_match;
328 
329 	while (*p != NULL) {
330 		parent = *p;
331 		th = rb_entry(parent, struct thread, rb_node);
332 
333 		if (th->pid == pid) {
334 			last_match = th;
335 			return th;
336 		}
337 
338 		if (pid < th->pid)
339 			p = &(*p)->rb_left;
340 		else
341 			p = &(*p)->rb_right;
342 	}
343 
344 	th = thread__new(pid);
345 	if (th != NULL) {
346 		rb_link_node(&th->rb_node, parent, p);
347 		rb_insert_color(&th->rb_node, &threads);
348 		last_match = th;
349 	}
350 
351 	return th;
352 }
353 
354 static void thread__insert_map(struct thread *self, struct map *map)
355 {
356 	struct map *pos, *tmp;
357 
358 	list_for_each_entry_safe(pos, tmp, &self->maps, node) {
359 		if (map__overlap(pos, map)) {
360 			list_del_init(&pos->node);
361 			/* XXX leaks dsos */
362 			free(pos);
363 		}
364 	}
365 
366 	list_add_tail(&map->node, &self->maps);
367 }
368 
369 static int thread__fork(struct thread *self, struct thread *parent)
370 {
371 	struct map *map;
372 
373 	if (self->comm)
374 		free(self->comm);
375 	self->comm = strdup(parent->comm);
376 	if (!self->comm)
377 		return -ENOMEM;
378 
379 	list_for_each_entry(map, &parent->maps, node) {
380 		struct map *new = map__clone(map);
381 		if (!new)
382 			return -ENOMEM;
383 		thread__insert_map(self, new);
384 	}
385 
386 	return 0;
387 }
388 
389 static struct map *thread__find_map(struct thread *self, u64 ip)
390 {
391 	struct map *pos;
392 
393 	if (self == NULL)
394 		return NULL;
395 
396 	list_for_each_entry(pos, &self->maps, node)
397 		if (ip >= pos->start && ip <= pos->end)
398 			return pos;
399 
400 	return NULL;
401 }
402 
403 static size_t threads__fprintf(FILE *fp)
404 {
405 	size_t ret = 0;
406 	struct rb_node *nd;
407 
408 	for (nd = rb_first(&threads); nd; nd = rb_next(nd)) {
409 		struct thread *pos = rb_entry(nd, struct thread, rb_node);
410 
411 		ret += thread__fprintf(pos, fp);
412 	}
413 
414 	return ret;
415 }
416 
417 /*
418  * histogram, sorted on item, collects counts
419  */
420 
421 static struct rb_root hist;
422 
423 struct hist_entry {
424 	struct rb_node	 rb_node;
425 
426 	struct thread	 *thread;
427 	struct map	 *map;
428 	struct dso	 *dso;
429 	struct symbol	 *sym;
430 	u64	 ip;
431 	char		 level;
432 
433 	uint32_t	 count;
434 };
435 
436 /*
437  * configurable sorting bits
438  */
439 
440 struct sort_entry {
441 	struct list_head list;
442 
443 	char *header;
444 
445 	int64_t (*cmp)(struct hist_entry *, struct hist_entry *);
446 	int64_t (*collapse)(struct hist_entry *, struct hist_entry *);
447 	size_t	(*print)(FILE *fp, struct hist_entry *);
448 };
449 
450 /* --sort pid */
451 
452 static int64_t
453 sort__thread_cmp(struct hist_entry *left, struct hist_entry *right)
454 {
455 	return right->thread->pid - left->thread->pid;
456 }
457 
458 static size_t
459 sort__thread_print(FILE *fp, struct hist_entry *self)
460 {
461 	return fprintf(fp, "%16s:%5d", self->thread->comm ?: "", self->thread->pid);
462 }
463 
464 static struct sort_entry sort_thread = {
465 	.header = "         Command:  Pid",
466 	.cmp	= sort__thread_cmp,
467 	.print	= sort__thread_print,
468 };
469 
470 /* --sort comm */
471 
472 static int64_t
473 sort__comm_cmp(struct hist_entry *left, struct hist_entry *right)
474 {
475 	return right->thread->pid - left->thread->pid;
476 }
477 
478 static int64_t
479 sort__comm_collapse(struct hist_entry *left, struct hist_entry *right)
480 {
481 	char *comm_l = left->thread->comm;
482 	char *comm_r = right->thread->comm;
483 
484 	if (!comm_l || !comm_r) {
485 		if (!comm_l && !comm_r)
486 			return 0;
487 		else if (!comm_l)
488 			return -1;
489 		else
490 			return 1;
491 	}
492 
493 	return strcmp(comm_l, comm_r);
494 }
495 
496 static size_t
497 sort__comm_print(FILE *fp, struct hist_entry *self)
498 {
499 	return fprintf(fp, "%16s", self->thread->comm);
500 }
501 
502 static struct sort_entry sort_comm = {
503 	.header		= "         Command",
504 	.cmp		= sort__comm_cmp,
505 	.collapse	= sort__comm_collapse,
506 	.print		= sort__comm_print,
507 };
508 
509 /* --sort dso */
510 
511 static int64_t
512 sort__dso_cmp(struct hist_entry *left, struct hist_entry *right)
513 {
514 	struct dso *dso_l = left->dso;
515 	struct dso *dso_r = right->dso;
516 
517 	if (!dso_l || !dso_r) {
518 		if (!dso_l && !dso_r)
519 			return 0;
520 		else if (!dso_l)
521 			return -1;
522 		else
523 			return 1;
524 	}
525 
526 	return strcmp(dso_l->name, dso_r->name);
527 }
528 
529 static size_t
530 sort__dso_print(FILE *fp, struct hist_entry *self)
531 {
532 	if (self->dso)
533 		return fprintf(fp, "%-25s", self->dso->name);
534 
535 	return fprintf(fp, "%016llx         ", (u64)self->ip);
536 }
537 
538 static struct sort_entry sort_dso = {
539 	.header = "Shared Object            ",
540 	.cmp	= sort__dso_cmp,
541 	.print	= sort__dso_print,
542 };
543 
544 /* --sort symbol */
545 
546 static int64_t
547 sort__sym_cmp(struct hist_entry *left, struct hist_entry *right)
548 {
549 	u64 ip_l, ip_r;
550 
551 	if (left->sym == right->sym)
552 		return 0;
553 
554 	ip_l = left->sym ? left->sym->start : left->ip;
555 	ip_r = right->sym ? right->sym->start : right->ip;
556 
557 	return (int64_t)(ip_r - ip_l);
558 }
559 
560 static size_t
561 sort__sym_print(FILE *fp, struct hist_entry *self)
562 {
563 	size_t ret = 0;
564 
565 	if (verbose)
566 		ret += fprintf(fp, "%#018llx  ", (u64)self->ip);
567 
568 	if (self->sym) {
569 		ret += fprintf(fp, "[%c] %s",
570 			self->dso == kernel_dso ? 'k' : '.', self->sym->name);
571 	} else {
572 		ret += fprintf(fp, "%#016llx", (u64)self->ip);
573 	}
574 
575 	return ret;
576 }
577 
578 static struct sort_entry sort_sym = {
579 	.header = "Symbol",
580 	.cmp	= sort__sym_cmp,
581 	.print	= sort__sym_print,
582 };
583 
584 static int sort__need_collapse = 0;
585 
586 struct sort_dimension {
587 	char			*name;
588 	struct sort_entry	*entry;
589 	int			taken;
590 };
591 
592 static struct sort_dimension sort_dimensions[] = {
593 	{ .name = "pid",	.entry = &sort_thread,	},
594 	{ .name = "comm",	.entry = &sort_comm,	},
595 	{ .name = "dso",	.entry = &sort_dso,	},
596 	{ .name = "symbol",	.entry = &sort_sym,	},
597 };
598 
599 static LIST_HEAD(hist_entry__sort_list);
600 
601 static int sort_dimension__add(char *tok)
602 {
603 	unsigned int i;
604 
605 	for (i = 0; i < ARRAY_SIZE(sort_dimensions); i++) {
606 		struct sort_dimension *sd = &sort_dimensions[i];
607 
608 		if (sd->taken)
609 			continue;
610 
611 		if (strncasecmp(tok, sd->name, strlen(tok)))
612 			continue;
613 
614 		if (sd->entry->collapse)
615 			sort__need_collapse = 1;
616 
617 		list_add_tail(&sd->entry->list, &hist_entry__sort_list);
618 		sd->taken = 1;
619 
620 		return 0;
621 	}
622 
623 	return -ESRCH;
624 }
625 
626 static int64_t
627 hist_entry__cmp(struct hist_entry *left, struct hist_entry *right)
628 {
629 	struct sort_entry *se;
630 	int64_t cmp = 0;
631 
632 	list_for_each_entry(se, &hist_entry__sort_list, list) {
633 		cmp = se->cmp(left, right);
634 		if (cmp)
635 			break;
636 	}
637 
638 	return cmp;
639 }
640 
641 static int64_t
642 hist_entry__collapse(struct hist_entry *left, struct hist_entry *right)
643 {
644 	struct sort_entry *se;
645 	int64_t cmp = 0;
646 
647 	list_for_each_entry(se, &hist_entry__sort_list, list) {
648 		int64_t (*f)(struct hist_entry *, struct hist_entry *);
649 
650 		f = se->collapse ?: se->cmp;
651 
652 		cmp = f(left, right);
653 		if (cmp)
654 			break;
655 	}
656 
657 	return cmp;
658 }
659 
660 /*
661  * collect histogram counts
662  */
663 static void hist_hit(struct hist_entry *he, u64 ip)
664 {
665 	unsigned int sym_size, offset;
666 	struct symbol *sym = he->sym;
667 
668 	he->count++;
669 
670 	if (!sym || !sym->hist)
671 		return;
672 
673 	sym_size = sym->end - sym->start;
674 	offset = ip - sym->start;
675 
676 	if (offset >= sym_size)
677 		return;
678 
679 	sym->hist_sum++;
680 	sym->hist[offset]++;
681 
682 	if (verbose >= 3)
683 		printf("%p %s: count++ [ip: %p, %08Lx] => %Ld\n",
684 			(void *)(unsigned long)he->sym->start,
685 			he->sym->name,
686 			(void *)(unsigned long)ip, ip - he->sym->start,
687 			sym->hist[offset]);
688 }
689 
690 static int
691 hist_entry__add(struct thread *thread, struct map *map, struct dso *dso,
692 		struct symbol *sym, u64 ip, char level)
693 {
694 	struct rb_node **p = &hist.rb_node;
695 	struct rb_node *parent = NULL;
696 	struct hist_entry *he;
697 	struct hist_entry entry = {
698 		.thread	= thread,
699 		.map	= map,
700 		.dso	= dso,
701 		.sym	= sym,
702 		.ip	= ip,
703 		.level	= level,
704 		.count	= 1,
705 	};
706 	int cmp;
707 
708 	while (*p != NULL) {
709 		parent = *p;
710 		he = rb_entry(parent, struct hist_entry, rb_node);
711 
712 		cmp = hist_entry__cmp(&entry, he);
713 
714 		if (!cmp) {
715 			hist_hit(he, ip);
716 
717 			return 0;
718 		}
719 
720 		if (cmp < 0)
721 			p = &(*p)->rb_left;
722 		else
723 			p = &(*p)->rb_right;
724 	}
725 
726 	he = malloc(sizeof(*he));
727 	if (!he)
728 		return -ENOMEM;
729 	*he = entry;
730 	rb_link_node(&he->rb_node, parent, p);
731 	rb_insert_color(&he->rb_node, &hist);
732 
733 	return 0;
734 }
735 
736 static void hist_entry__free(struct hist_entry *he)
737 {
738 	free(he);
739 }
740 
741 /*
742  * collapse the histogram
743  */
744 
745 static struct rb_root collapse_hists;
746 
747 static void collapse__insert_entry(struct hist_entry *he)
748 {
749 	struct rb_node **p = &collapse_hists.rb_node;
750 	struct rb_node *parent = NULL;
751 	struct hist_entry *iter;
752 	int64_t cmp;
753 
754 	while (*p != NULL) {
755 		parent = *p;
756 		iter = rb_entry(parent, struct hist_entry, rb_node);
757 
758 		cmp = hist_entry__collapse(iter, he);
759 
760 		if (!cmp) {
761 			iter->count += he->count;
762 			hist_entry__free(he);
763 			return;
764 		}
765 
766 		if (cmp < 0)
767 			p = &(*p)->rb_left;
768 		else
769 			p = &(*p)->rb_right;
770 	}
771 
772 	rb_link_node(&he->rb_node, parent, p);
773 	rb_insert_color(&he->rb_node, &collapse_hists);
774 }
775 
776 static void collapse__resort(void)
777 {
778 	struct rb_node *next;
779 	struct hist_entry *n;
780 
781 	if (!sort__need_collapse)
782 		return;
783 
784 	next = rb_first(&hist);
785 	while (next) {
786 		n = rb_entry(next, struct hist_entry, rb_node);
787 		next = rb_next(&n->rb_node);
788 
789 		rb_erase(&n->rb_node, &hist);
790 		collapse__insert_entry(n);
791 	}
792 }
793 
794 /*
795  * reverse the map, sort on count.
796  */
797 
798 static struct rb_root output_hists;
799 
800 static void output__insert_entry(struct hist_entry *he)
801 {
802 	struct rb_node **p = &output_hists.rb_node;
803 	struct rb_node *parent = NULL;
804 	struct hist_entry *iter;
805 
806 	while (*p != NULL) {
807 		parent = *p;
808 		iter = rb_entry(parent, struct hist_entry, rb_node);
809 
810 		if (he->count > iter->count)
811 			p = &(*p)->rb_left;
812 		else
813 			p = &(*p)->rb_right;
814 	}
815 
816 	rb_link_node(&he->rb_node, parent, p);
817 	rb_insert_color(&he->rb_node, &output_hists);
818 }
819 
820 static void output__resort(void)
821 {
822 	struct rb_node *next;
823 	struct hist_entry *n;
824 	struct rb_root *tree = &hist;
825 
826 	if (sort__need_collapse)
827 		tree = &collapse_hists;
828 
829 	next = rb_first(tree);
830 
831 	while (next) {
832 		n = rb_entry(next, struct hist_entry, rb_node);
833 		next = rb_next(&n->rb_node);
834 
835 		rb_erase(&n->rb_node, tree);
836 		output__insert_entry(n);
837 	}
838 }
839 
840 static void register_idle_thread(void)
841 {
842 	struct thread *thread = threads__findnew(0);
843 
844 	if (thread == NULL ||
845 			thread__set_comm(thread, "[idle]")) {
846 		fprintf(stderr, "problem inserting idle task.\n");
847 		exit(-1);
848 	}
849 }
850 
851 static unsigned long total = 0,
852 		     total_mmap = 0,
853 		     total_comm = 0,
854 		     total_fork = 0,
855 		     total_unknown = 0;
856 
857 static int
858 process_sample_event(event_t *event, unsigned long offset, unsigned long head)
859 {
860 	char level;
861 	int show = 0;
862 	struct dso *dso = NULL;
863 	struct thread *thread = threads__findnew(event->ip.pid);
864 	u64 ip = event->ip.ip;
865 	struct map *map = NULL;
866 
867 	dprintf("%p [%p]: PERF_EVENT (IP, %d): %d: %p\n",
868 		(void *)(offset + head),
869 		(void *)(long)(event->header.size),
870 		event->header.misc,
871 		event->ip.pid,
872 		(void *)(long)ip);
873 
874 	dprintf(" ... thread: %s:%d\n", thread->comm, thread->pid);
875 
876 	if (thread == NULL) {
877 		fprintf(stderr, "problem processing %d event, skipping it.\n",
878 			event->header.type);
879 		return -1;
880 	}
881 
882 	if (event->header.misc & PERF_EVENT_MISC_KERNEL) {
883 		show = SHOW_KERNEL;
884 		level = 'k';
885 
886 		dso = kernel_dso;
887 
888 		dprintf(" ...... dso: %s\n", dso->name);
889 
890 	} else if (event->header.misc & PERF_EVENT_MISC_USER) {
891 
892 		show = SHOW_USER;
893 		level = '.';
894 
895 		map = thread__find_map(thread, ip);
896 		if (map != NULL) {
897 			ip = map->map_ip(map, ip);
898 			dso = map->dso;
899 		} else {
900 			/*
901 			 * If this is outside of all known maps,
902 			 * and is a negative address, try to look it
903 			 * up in the kernel dso, as it might be a
904 			 * vsyscall (which executes in user-mode):
905 			 */
906 			if ((long long)ip < 0)
907 				dso = kernel_dso;
908 		}
909 		dprintf(" ...... dso: %s\n", dso ? dso->name : "<not found>");
910 
911 	} else {
912 		show = SHOW_HV;
913 		level = 'H';
914 		dprintf(" ...... dso: [hypervisor]\n");
915 	}
916 
917 	if (show & show_mask) {
918 		struct symbol *sym = NULL;
919 
920 		if (dso)
921 			sym = dso->find_symbol(dso, ip);
922 
923 		if (hist_entry__add(thread, map, dso, sym, ip, level)) {
924 			fprintf(stderr,
925 		"problem incrementing symbol count, skipping event\n");
926 			return -1;
927 		}
928 	}
929 	total++;
930 
931 	return 0;
932 }
933 
934 static int
935 process_mmap_event(event_t *event, unsigned long offset, unsigned long head)
936 {
937 	struct thread *thread = threads__findnew(event->mmap.pid);
938 	struct map *map = map__new(&event->mmap);
939 
940 	dprintf("%p [%p]: PERF_EVENT_MMAP %d: [%p(%p) @ %p]: %s\n",
941 		(void *)(offset + head),
942 		(void *)(long)(event->header.size),
943 		event->mmap.pid,
944 		(void *)(long)event->mmap.start,
945 		(void *)(long)event->mmap.len,
946 		(void *)(long)event->mmap.pgoff,
947 		event->mmap.filename);
948 
949 	if (thread == NULL || map == NULL) {
950 		dprintf("problem processing PERF_EVENT_MMAP, skipping event.\n");
951 		return 0;
952 	}
953 
954 	thread__insert_map(thread, map);
955 	total_mmap++;
956 
957 	return 0;
958 }
959 
960 static int
961 process_comm_event(event_t *event, unsigned long offset, unsigned long head)
962 {
963 	struct thread *thread = threads__findnew(event->comm.pid);
964 
965 	dprintf("%p [%p]: PERF_EVENT_COMM: %s:%d\n",
966 		(void *)(offset + head),
967 		(void *)(long)(event->header.size),
968 		event->comm.comm, event->comm.pid);
969 
970 	if (thread == NULL ||
971 	    thread__set_comm(thread, event->comm.comm)) {
972 		dprintf("problem processing PERF_EVENT_COMM, skipping event.\n");
973 		return -1;
974 	}
975 	total_comm++;
976 
977 	return 0;
978 }
979 
980 static int
981 process_fork_event(event_t *event, unsigned long offset, unsigned long head)
982 {
983 	struct thread *thread = threads__findnew(event->fork.pid);
984 	struct thread *parent = threads__findnew(event->fork.ppid);
985 
986 	dprintf("%p [%p]: PERF_EVENT_FORK: %d:%d\n",
987 		(void *)(offset + head),
988 		(void *)(long)(event->header.size),
989 		event->fork.pid, event->fork.ppid);
990 
991 	if (!thread || !parent || thread__fork(thread, parent)) {
992 		dprintf("problem processing PERF_EVENT_FORK, skipping event.\n");
993 		return -1;
994 	}
995 	total_fork++;
996 
997 	return 0;
998 }
999 
1000 static int
1001 process_period_event(event_t *event, unsigned long offset, unsigned long head)
1002 {
1003 	dprintf("%p [%p]: PERF_EVENT_PERIOD: time:%Ld, id:%Ld: period:%Ld\n",
1004 		(void *)(offset + head),
1005 		(void *)(long)(event->header.size),
1006 		event->period.time,
1007 		event->period.id,
1008 		event->period.sample_period);
1009 
1010 	return 0;
1011 }
1012 
1013 static int
1014 process_event(event_t *event, unsigned long offset, unsigned long head)
1015 {
1016 	switch (event->header.type) {
1017 	case PERF_EVENT_SAMPLE:
1018 		return process_sample_event(event, offset, head);
1019 
1020 	case PERF_EVENT_MMAP:
1021 		return process_mmap_event(event, offset, head);
1022 
1023 	case PERF_EVENT_COMM:
1024 		return process_comm_event(event, offset, head);
1025 
1026 	case PERF_EVENT_FORK:
1027 		return process_fork_event(event, offset, head);
1028 
1029 	case PERF_EVENT_PERIOD:
1030 		return process_period_event(event, offset, head);
1031 	/*
1032 	 * We dont process them right now but they are fine:
1033 	 */
1034 
1035 	case PERF_EVENT_THROTTLE:
1036 	case PERF_EVENT_UNTHROTTLE:
1037 		return 0;
1038 
1039 	default:
1040 		return -1;
1041 	}
1042 
1043 	return 0;
1044 }
1045 
1046 static int
1047 parse_line(FILE *file, struct symbol *sym, u64 start, u64 len)
1048 {
1049 	char *line = NULL, *tmp, *tmp2;
1050 	static const char *prev_line;
1051 	static const char *prev_color;
1052 	unsigned int offset;
1053 	size_t line_len;
1054 	s64 line_ip;
1055 	int ret;
1056 	char *c;
1057 
1058 	if (getline(&line, &line_len, file) < 0)
1059 		return -1;
1060 	if (!line)
1061 		return -1;
1062 
1063 	c = strchr(line, '\n');
1064 	if (c)
1065 		*c = 0;
1066 
1067 	line_ip = -1;
1068 	offset = 0;
1069 	ret = -2;
1070 
1071 	/*
1072 	 * Strip leading spaces:
1073 	 */
1074 	tmp = line;
1075 	while (*tmp) {
1076 		if (*tmp != ' ')
1077 			break;
1078 		tmp++;
1079 	}
1080 
1081 	if (*tmp) {
1082 		/*
1083 		 * Parse hexa addresses followed by ':'
1084 		 */
1085 		line_ip = strtoull(tmp, &tmp2, 16);
1086 		if (*tmp2 != ':')
1087 			line_ip = -1;
1088 	}
1089 
1090 	if (line_ip != -1) {
1091 		const char *path = NULL;
1092 		unsigned int hits = 0;
1093 		double percent = 0.0;
1094 		char *color;
1095 		struct sym_ext *sym_ext = sym->priv;
1096 
1097 		offset = line_ip - start;
1098 		if (offset < len)
1099 			hits = sym->hist[offset];
1100 
1101 		if (offset < len && sym_ext) {
1102 			path = sym_ext[offset].path;
1103 			percent = sym_ext[offset].percent;
1104 		} else if (sym->hist_sum)
1105 			percent = 100.0 * hits / sym->hist_sum;
1106 
1107 		color = get_percent_color(percent);
1108 
1109 		/*
1110 		 * Also color the filename and line if needed, with
1111 		 * the same color than the percentage. Don't print it
1112 		 * twice for close colored ip with the same filename:line
1113 		 */
1114 		if (path) {
1115 			if (!prev_line || strcmp(prev_line, path)
1116 				       || color != prev_color) {
1117 				color_fprintf(stdout, color, " %s", path);
1118 				prev_line = path;
1119 				prev_color = color;
1120 			}
1121 		}
1122 
1123 		color_fprintf(stdout, color, " %7.2f", percent);
1124 		printf(" :	");
1125 		color_fprintf(stdout, PERF_COLOR_BLUE, "%s\n", line);
1126 	} else {
1127 		if (!*line)
1128 			printf("         :\n");
1129 		else
1130 			printf("         :	%s\n", line);
1131 	}
1132 
1133 	return 0;
1134 }
1135 
1136 static struct rb_root root_sym_ext;
1137 
1138 static void insert_source_line(struct sym_ext *sym_ext)
1139 {
1140 	struct sym_ext *iter;
1141 	struct rb_node **p = &root_sym_ext.rb_node;
1142 	struct rb_node *parent = NULL;
1143 
1144 	while (*p != NULL) {
1145 		parent = *p;
1146 		iter = rb_entry(parent, struct sym_ext, node);
1147 
1148 		if (sym_ext->percent > iter->percent)
1149 			p = &(*p)->rb_left;
1150 		else
1151 			p = &(*p)->rb_right;
1152 	}
1153 
1154 	rb_link_node(&sym_ext->node, parent, p);
1155 	rb_insert_color(&sym_ext->node, &root_sym_ext);
1156 }
1157 
1158 static void free_source_line(struct symbol *sym, int len)
1159 {
1160 	struct sym_ext *sym_ext = sym->priv;
1161 	int i;
1162 
1163 	if (!sym_ext)
1164 		return;
1165 
1166 	for (i = 0; i < len; i++)
1167 		free(sym_ext[i].path);
1168 	free(sym_ext);
1169 
1170 	sym->priv = NULL;
1171 	root_sym_ext = RB_ROOT;
1172 }
1173 
1174 /* Get the filename:line for the colored entries */
1175 static void
1176 get_source_line(struct symbol *sym, u64 start, int len, char *filename)
1177 {
1178 	int i;
1179 	char cmd[PATH_MAX * 2];
1180 	struct sym_ext *sym_ext;
1181 
1182 	if (!sym->hist_sum)
1183 		return;
1184 
1185 	sym->priv = calloc(len, sizeof(struct sym_ext));
1186 	if (!sym->priv)
1187 		return;
1188 
1189 	sym_ext = sym->priv;
1190 
1191 	for (i = 0; i < len; i++) {
1192 		char *path = NULL;
1193 		size_t line_len;
1194 		u64 offset;
1195 		FILE *fp;
1196 
1197 		sym_ext[i].percent = 100.0 * sym->hist[i] / sym->hist_sum;
1198 		if (sym_ext[i].percent <= 0.5)
1199 			continue;
1200 
1201 		offset = start + i;
1202 		sprintf(cmd, "addr2line -e %s %016llx", filename, offset);
1203 		fp = popen(cmd, "r");
1204 		if (!fp)
1205 			continue;
1206 
1207 		if (getline(&path, &line_len, fp) < 0 || !line_len)
1208 			goto next;
1209 
1210 		sym_ext[i].path = malloc(sizeof(char) * line_len + 1);
1211 		if (!sym_ext[i].path)
1212 			goto next;
1213 
1214 		strcpy(sym_ext[i].path, path);
1215 		insert_source_line(&sym_ext[i]);
1216 
1217 	next:
1218 		pclose(fp);
1219 	}
1220 }
1221 
1222 static void print_summary(char *filename)
1223 {
1224 	struct sym_ext *sym_ext;
1225 	struct rb_node *node;
1226 
1227 	printf("\nSorted summary for file %s\n", filename);
1228 	printf("----------------------------------------------\n\n");
1229 
1230 	if (RB_EMPTY_ROOT(&root_sym_ext)) {
1231 		printf(" Nothing higher than %1.1f%%\n", MIN_GREEN);
1232 		return;
1233 	}
1234 
1235 	node = rb_first(&root_sym_ext);
1236 	while (node) {
1237 		double percent;
1238 		char *color;
1239 		char *path;
1240 
1241 		sym_ext = rb_entry(node, struct sym_ext, node);
1242 		percent = sym_ext->percent;
1243 		color = get_percent_color(percent);
1244 		path = sym_ext->path;
1245 
1246 		color_fprintf(stdout, color, " %7.2f %s", percent, path);
1247 		node = rb_next(node);
1248 	}
1249 }
1250 
1251 static void annotate_sym(struct dso *dso, struct symbol *sym)
1252 {
1253 	char *filename = dso->name, *d_filename;
1254 	u64 start, end, len;
1255 	char command[PATH_MAX*2];
1256 	FILE *file;
1257 
1258 	if (!filename)
1259 		return;
1260 	if (sym->module)
1261 		filename = sym->module->path;
1262 	else if (dso == kernel_dso)
1263 		filename = vmlinux;
1264 
1265 	start = sym->obj_start;
1266 	if (!start)
1267 		start = sym->start;
1268 	if (full_paths)
1269 		d_filename = filename;
1270 	else
1271 		d_filename = basename(filename);
1272 
1273 	end = start + sym->end - sym->start + 1;
1274 	len = sym->end - sym->start;
1275 
1276 	if (print_line) {
1277 		get_source_line(sym, start, len, filename);
1278 		print_summary(filename);
1279 	}
1280 
1281 	printf("\n\n------------------------------------------------\n");
1282 	printf(" Percent |	Source code & Disassembly of %s\n", d_filename);
1283 	printf("------------------------------------------------\n");
1284 
1285 	if (verbose >= 2)
1286 		printf("annotating [%p] %30s : [%p] %30s\n", dso, dso->name, sym, sym->name);
1287 
1288 	sprintf(command, "objdump --start-address=0x%016Lx --stop-address=0x%016Lx -dS %s|grep -v %s",
1289 			(u64)start, (u64)end, filename, filename);
1290 
1291 	if (verbose >= 3)
1292 		printf("doing: %s\n", command);
1293 
1294 	file = popen(command, "r");
1295 	if (!file)
1296 		return;
1297 
1298 	while (!feof(file)) {
1299 		if (parse_line(file, sym, start, len) < 0)
1300 			break;
1301 	}
1302 
1303 	pclose(file);
1304 	if (print_line)
1305 		free_source_line(sym, len);
1306 }
1307 
1308 static void find_annotations(void)
1309 {
1310 	struct rb_node *nd;
1311 	struct dso *dso;
1312 	int count = 0;
1313 
1314 	list_for_each_entry(dso, &dsos, node) {
1315 
1316 		for (nd = rb_first(&dso->syms); nd; nd = rb_next(nd)) {
1317 			struct symbol *sym = rb_entry(nd, struct symbol, rb_node);
1318 
1319 			if (sym->hist) {
1320 				annotate_sym(dso, sym);
1321 				count++;
1322 			}
1323 		}
1324 	}
1325 
1326 	if (!count)
1327 		printf(" Error: symbol '%s' not present amongst the samples.\n", sym_hist_filter);
1328 }
1329 
1330 static int __cmd_annotate(void)
1331 {
1332 	int ret, rc = EXIT_FAILURE;
1333 	unsigned long offset = 0;
1334 	unsigned long head = 0;
1335 	struct stat stat;
1336 	event_t *event;
1337 	uint32_t size;
1338 	char *buf;
1339 
1340 	register_idle_thread();
1341 
1342 	input = open(input_name, O_RDONLY);
1343 	if (input < 0) {
1344 		perror("failed to open file");
1345 		exit(-1);
1346 	}
1347 
1348 	ret = fstat(input, &stat);
1349 	if (ret < 0) {
1350 		perror("failed to stat file");
1351 		exit(-1);
1352 	}
1353 
1354 	if (!stat.st_size) {
1355 		fprintf(stderr, "zero-sized file, nothing to do!\n");
1356 		exit(0);
1357 	}
1358 
1359 	if (load_kernel() < 0) {
1360 		perror("failed to load kernel symbols");
1361 		return EXIT_FAILURE;
1362 	}
1363 
1364 remap:
1365 	buf = (char *)mmap(NULL, page_size * mmap_window, PROT_READ,
1366 			   MAP_SHARED, input, offset);
1367 	if (buf == MAP_FAILED) {
1368 		perror("failed to mmap file");
1369 		exit(-1);
1370 	}
1371 
1372 more:
1373 	event = (event_t *)(buf + head);
1374 
1375 	size = event->header.size;
1376 	if (!size)
1377 		size = 8;
1378 
1379 	if (head + event->header.size >= page_size * mmap_window) {
1380 		unsigned long shift = page_size * (head / page_size);
1381 		int ret;
1382 
1383 		ret = munmap(buf, page_size * mmap_window);
1384 		assert(ret == 0);
1385 
1386 		offset += shift;
1387 		head -= shift;
1388 		goto remap;
1389 	}
1390 
1391 	size = event->header.size;
1392 
1393 	dprintf("%p [%p]: event: %d\n",
1394 			(void *)(offset + head),
1395 			(void *)(long)event->header.size,
1396 			event->header.type);
1397 
1398 	if (!size || process_event(event, offset, head) < 0) {
1399 
1400 		dprintf("%p [%p]: skipping unknown header type: %d\n",
1401 			(void *)(offset + head),
1402 			(void *)(long)(event->header.size),
1403 			event->header.type);
1404 
1405 		total_unknown++;
1406 
1407 		/*
1408 		 * assume we lost track of the stream, check alignment, and
1409 		 * increment a single u64 in the hope to catch on again 'soon'.
1410 		 */
1411 
1412 		if (unlikely(head & 7))
1413 			head &= ~7ULL;
1414 
1415 		size = 8;
1416 	}
1417 
1418 	head += size;
1419 
1420 	if (offset + head < (unsigned long)stat.st_size)
1421 		goto more;
1422 
1423 	rc = EXIT_SUCCESS;
1424 	close(input);
1425 
1426 	dprintf("      IP events: %10ld\n", total);
1427 	dprintf("    mmap events: %10ld\n", total_mmap);
1428 	dprintf("    comm events: %10ld\n", total_comm);
1429 	dprintf("    fork events: %10ld\n", total_fork);
1430 	dprintf(" unknown events: %10ld\n", total_unknown);
1431 
1432 	if (dump_trace)
1433 		return 0;
1434 
1435 	if (verbose >= 3)
1436 		threads__fprintf(stdout);
1437 
1438 	if (verbose >= 2)
1439 		dsos__fprintf(stdout);
1440 
1441 	collapse__resort();
1442 	output__resort();
1443 
1444 	find_annotations();
1445 
1446 	return rc;
1447 }
1448 
1449 static const char * const annotate_usage[] = {
1450 	"perf annotate [<options>] <command>",
1451 	NULL
1452 };
1453 
1454 static const struct option options[] = {
1455 	OPT_STRING('i', "input", &input_name, "file",
1456 		    "input file name"),
1457 	OPT_STRING('s', "symbol", &sym_hist_filter, "symbol",
1458 		    "symbol to annotate"),
1459 	OPT_BOOLEAN('v', "verbose", &verbose,
1460 		    "be more verbose (show symbol address, etc)"),
1461 	OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace,
1462 		    "dump raw trace in ASCII"),
1463 	OPT_STRING('k', "vmlinux", &vmlinux, "file", "vmlinux pathname"),
1464 	OPT_BOOLEAN('m', "modules", &modules,
1465 		    "load module symbols - WARNING: use only with -k and LIVE kernel"),
1466 	OPT_BOOLEAN('l', "print-line", &print_line,
1467 		    "print matching source lines (may be slow)"),
1468 	OPT_BOOLEAN('P', "full-paths", &full_paths,
1469 		    "Don't shorten the displayed pathnames"),
1470 	OPT_END()
1471 };
1472 
1473 static void setup_sorting(void)
1474 {
1475 	char *tmp, *tok, *str = strdup(sort_order);
1476 
1477 	for (tok = strtok_r(str, ", ", &tmp);
1478 			tok; tok = strtok_r(NULL, ", ", &tmp)) {
1479 		if (sort_dimension__add(tok) < 0) {
1480 			error("Unknown --sort key: `%s'", tok);
1481 			usage_with_options(annotate_usage, options);
1482 		}
1483 	}
1484 
1485 	free(str);
1486 }
1487 
1488 int cmd_annotate(int argc, const char **argv, const char *prefix __used)
1489 {
1490 	symbol__init();
1491 
1492 	page_size = getpagesize();
1493 
1494 	argc = parse_options(argc, argv, options, annotate_usage, 0);
1495 
1496 	setup_sorting();
1497 
1498 	if (argc) {
1499 		/*
1500 		 * Special case: if there's an argument left then assume tha
1501 		 * it's a symbol filter:
1502 		 */
1503 		if (argc > 1)
1504 			usage_with_options(annotate_usage, options);
1505 
1506 		sym_hist_filter = argv[0];
1507 	}
1508 
1509 	if (!sym_hist_filter)
1510 		usage_with_options(annotate_usage, options);
1511 
1512 	setup_pager();
1513 
1514 	return __cmd_annotate();
1515 }
1516