xref: /linux/tools/perf/util/annotate.c (revision e9fb13bfec7e017130ddc5c1b5466340470f4900)
1 /*
2  * Copyright (C) 2011, Red Hat Inc, Arnaldo Carvalho de Melo <acme@redhat.com>
3  *
4  * Parts came from builtin-annotate.c, see those files for further
5  * copyright notes.
6  *
7  * Released under the GPL v2. (and only v2, not any later version)
8  */
9 
10 #include "util.h"
11 #include "build-id.h"
12 #include "color.h"
13 #include "cache.h"
14 #include "symbol.h"
15 #include "debug.h"
16 #include "annotate.h"
17 #include <pthread.h>
18 
19 int symbol__annotate_init(struct map *map __used, struct symbol *sym)
20 {
21 	struct annotation *notes = symbol__annotation(sym);
22 	pthread_mutex_init(&notes->lock, NULL);
23 	return 0;
24 }
25 
26 int symbol__alloc_hist(struct symbol *sym, int nevents)
27 {
28 	struct annotation *notes = symbol__annotation(sym);
29 	size_t sizeof_sym_hist = (sizeof(struct sym_hist) +
30 				  (sym->end - sym->start) * sizeof(u64));
31 
32 	notes->src = zalloc(sizeof(*notes->src) + nevents * sizeof_sym_hist);
33 	if (notes->src == NULL)
34 		return -1;
35 	notes->src->sizeof_sym_hist = sizeof_sym_hist;
36 	notes->src->nr_histograms   = nevents;
37 	INIT_LIST_HEAD(&notes->src->source);
38 	return 0;
39 }
40 
41 void symbol__annotate_zero_histograms(struct symbol *sym)
42 {
43 	struct annotation *notes = symbol__annotation(sym);
44 
45 	pthread_mutex_lock(&notes->lock);
46 	if (notes->src != NULL)
47 		memset(notes->src->histograms, 0,
48 		       notes->src->nr_histograms * notes->src->sizeof_sym_hist);
49 	pthread_mutex_unlock(&notes->lock);
50 }
51 
52 int symbol__inc_addr_samples(struct symbol *sym, struct map *map,
53 			     int evidx, u64 addr)
54 {
55 	unsigned offset;
56 	struct annotation *notes;
57 	struct sym_hist *h;
58 
59 	notes = symbol__annotation(sym);
60 	if (notes->src == NULL)
61 		return -ENOMEM;
62 
63 	pr_debug3("%s: addr=%#" PRIx64 "\n", __func__, map->unmap_ip(map, addr));
64 
65 	if (addr >= sym->end)
66 		return 0;
67 
68 	offset = addr - sym->start;
69 	h = annotation__histogram(notes, evidx);
70 	h->sum++;
71 	h->addr[offset]++;
72 
73 	pr_debug3("%#" PRIx64 " %s: period++ [addr: %#" PRIx64 ", %#" PRIx64
74 		  ", evidx=%d] => %" PRIu64 "\n", sym->start, sym->name,
75 		  addr, addr - sym->start, evidx, h->addr[offset]);
76 	return 0;
77 }
78 
79 static struct objdump_line *objdump_line__new(s64 offset, char *line, size_t privsize)
80 {
81 	struct objdump_line *self = malloc(sizeof(*self) + privsize);
82 
83 	if (self != NULL) {
84 		self->offset = offset;
85 		self->line = line;
86 	}
87 
88 	return self;
89 }
90 
91 void objdump_line__free(struct objdump_line *self)
92 {
93 	free(self->line);
94 	free(self);
95 }
96 
97 static void objdump__add_line(struct list_head *head, struct objdump_line *line)
98 {
99 	list_add_tail(&line->node, head);
100 }
101 
102 struct objdump_line *objdump__get_next_ip_line(struct list_head *head,
103 					       struct objdump_line *pos)
104 {
105 	list_for_each_entry_continue(pos, head, node)
106 		if (pos->offset >= 0)
107 			return pos;
108 
109 	return NULL;
110 }
111 
112 static int objdump_line__print(struct objdump_line *oline, struct symbol *sym,
113 			       int evidx, u64 len, int min_pcnt,
114 			       int printed, int max_lines,
115 			       struct objdump_line *queue)
116 {
117 	static const char *prev_line;
118 	static const char *prev_color;
119 
120 	if (oline->offset != -1) {
121 		const char *path = NULL;
122 		unsigned int hits = 0;
123 		double percent = 0.0;
124 		const char *color;
125 		struct annotation *notes = symbol__annotation(sym);
126 		struct source_line *src_line = notes->src->lines;
127 		struct sym_hist *h = annotation__histogram(notes, evidx);
128 		s64 offset = oline->offset;
129 		struct objdump_line *next;
130 
131 		next = objdump__get_next_ip_line(&notes->src->source, oline);
132 
133 		while (offset < (s64)len &&
134 		       (next == NULL || offset < next->offset)) {
135 			if (src_line) {
136 				if (path == NULL)
137 					path = src_line[offset].path;
138 				percent += src_line[offset].percent;
139 			} else
140 				hits += h->addr[offset];
141 
142 			++offset;
143 		}
144 
145 		if (src_line == NULL && h->sum)
146 			percent = 100.0 * hits / h->sum;
147 
148 		if (percent < min_pcnt)
149 			return -1;
150 
151 		if (max_lines && printed >= max_lines)
152 			return 1;
153 
154 		if (queue != NULL) {
155 			list_for_each_entry_from(queue, &notes->src->source, node) {
156 				if (queue == oline)
157 					break;
158 				objdump_line__print(queue, sym, evidx, len,
159 						    0, 0, 1, NULL);
160 			}
161 		}
162 
163 		color = get_percent_color(percent);
164 
165 		/*
166 		 * Also color the filename and line if needed, with
167 		 * the same color than the percentage. Don't print it
168 		 * twice for close colored addr with the same filename:line
169 		 */
170 		if (path) {
171 			if (!prev_line || strcmp(prev_line, path)
172 				       || color != prev_color) {
173 				color_fprintf(stdout, color, " %s", path);
174 				prev_line = path;
175 				prev_color = color;
176 			}
177 		}
178 
179 		color_fprintf(stdout, color, " %7.2f", percent);
180 		printf(" :	");
181 		color_fprintf(stdout, PERF_COLOR_BLUE, "%s\n", oline->line);
182 	} else if (max_lines && printed >= max_lines)
183 		return 1;
184 	else {
185 		if (queue)
186 			return -1;
187 
188 		if (!*oline->line)
189 			printf("         :\n");
190 		else
191 			printf("         :	%s\n", oline->line);
192 	}
193 
194 	return 0;
195 }
196 
197 static int symbol__parse_objdump_line(struct symbol *sym, struct map *map,
198 				      FILE *file, size_t privsize)
199 {
200 	struct annotation *notes = symbol__annotation(sym);
201 	struct objdump_line *objdump_line;
202 	char *line = NULL, *tmp, *tmp2, *c;
203 	size_t line_len;
204 	s64 line_ip, offset = -1;
205 
206 	if (getline(&line, &line_len, file) < 0)
207 		return -1;
208 
209 	if (!line)
210 		return -1;
211 
212 	while (line_len != 0 && isspace(line[line_len - 1]))
213 		line[--line_len] = '\0';
214 
215 	c = strchr(line, '\n');
216 	if (c)
217 		*c = 0;
218 
219 	line_ip = -1;
220 
221 	/*
222 	 * Strip leading spaces:
223 	 */
224 	tmp = line;
225 	while (*tmp) {
226 		if (*tmp != ' ')
227 			break;
228 		tmp++;
229 	}
230 
231 	if (*tmp) {
232 		/*
233 		 * Parse hexa addresses followed by ':'
234 		 */
235 		line_ip = strtoull(tmp, &tmp2, 16);
236 		if (*tmp2 != ':' || tmp == tmp2 || tmp2[1] == '\0')
237 			line_ip = -1;
238 	}
239 
240 	if (line_ip != -1) {
241 		u64 start = map__rip_2objdump(map, sym->start),
242 		    end = map__rip_2objdump(map, sym->end);
243 
244 		offset = line_ip - start;
245 		if (offset < 0 || (u64)line_ip > end)
246 			offset = -1;
247 	}
248 
249 	objdump_line = objdump_line__new(offset, line, privsize);
250 	if (objdump_line == NULL) {
251 		free(line);
252 		return -1;
253 	}
254 	objdump__add_line(&notes->src->source, objdump_line);
255 
256 	return 0;
257 }
258 
259 int symbol__annotate(struct symbol *sym, struct map *map, size_t privsize)
260 {
261 	struct dso *dso = map->dso;
262 	char *filename = dso__build_id_filename(dso, NULL, 0);
263 	bool free_filename = true;
264 	char command[PATH_MAX * 2];
265 	FILE *file;
266 	int err = 0;
267 	char symfs_filename[PATH_MAX];
268 
269 	if (filename) {
270 		snprintf(symfs_filename, sizeof(symfs_filename), "%s%s",
271 			 symbol_conf.symfs, filename);
272 	}
273 
274 	if (filename == NULL) {
275 		if (dso->has_build_id) {
276 			pr_err("Can't annotate %s: not enough memory\n",
277 			       sym->name);
278 			return -ENOMEM;
279 		}
280 		goto fallback;
281 	} else if (readlink(symfs_filename, command, sizeof(command)) < 0 ||
282 		   strstr(command, "[kernel.kallsyms]") ||
283 		   access(symfs_filename, R_OK)) {
284 		free(filename);
285 fallback:
286 		/*
287 		 * If we don't have build-ids or the build-id file isn't in the
288 		 * cache, or is just a kallsyms file, well, lets hope that this
289 		 * DSO is the same as when 'perf record' ran.
290 		 */
291 		filename = dso->long_name;
292 		snprintf(symfs_filename, sizeof(symfs_filename), "%s%s",
293 			 symbol_conf.symfs, filename);
294 		free_filename = false;
295 	}
296 
297 	if (dso->symtab_type == SYMTAB__KALLSYMS) {
298 		char bf[BUILD_ID_SIZE * 2 + 16] = " with build id ";
299 		char *build_id_msg = NULL;
300 
301 		if (dso->annotate_warned)
302 			goto out_free_filename;
303 
304 		if (dso->has_build_id) {
305 			build_id__sprintf(dso->build_id,
306 					  sizeof(dso->build_id), bf + 15);
307 			build_id_msg = bf;
308 		}
309 		err = -ENOENT;
310 		dso->annotate_warned = 1;
311 		pr_err("Can't annotate %s: No vmlinux file%s was found in the "
312 		       "path.\nPlease use 'perf buildid-cache -av vmlinux' or "
313 		       "--vmlinux vmlinux.\n",
314 		       sym->name, build_id_msg ?: "");
315 		goto out_free_filename;
316 	}
317 
318 	pr_debug("%s: filename=%s, sym=%s, start=%#" PRIx64 ", end=%#" PRIx64 "\n", __func__,
319 		 filename, sym->name, map->unmap_ip(map, sym->start),
320 		 map->unmap_ip(map, sym->end));
321 
322 	pr_debug("annotating [%p] %30s : [%p] %30s\n",
323 		 dso, dso->long_name, sym, sym->name);
324 
325 	snprintf(command, sizeof(command),
326 		 "objdump --start-address=0x%016" PRIx64
327 		 " --stop-address=0x%016" PRIx64 " -dS -C %s|grep -v %s|expand",
328 		 map__rip_2objdump(map, sym->start),
329 		 map__rip_2objdump(map, sym->end),
330 		 symfs_filename, filename);
331 
332 	pr_debug("Executing: %s\n", command);
333 
334 	file = popen(command, "r");
335 	if (!file)
336 		goto out_free_filename;
337 
338 	while (!feof(file))
339 		if (symbol__parse_objdump_line(sym, map, file, privsize) < 0)
340 			break;
341 
342 	pclose(file);
343 out_free_filename:
344 	if (free_filename)
345 		free(filename);
346 	return err;
347 }
348 
349 static void insert_source_line(struct rb_root *root, struct source_line *src_line)
350 {
351 	struct source_line *iter;
352 	struct rb_node **p = &root->rb_node;
353 	struct rb_node *parent = NULL;
354 
355 	while (*p != NULL) {
356 		parent = *p;
357 		iter = rb_entry(parent, struct source_line, node);
358 
359 		if (src_line->percent > iter->percent)
360 			p = &(*p)->rb_left;
361 		else
362 			p = &(*p)->rb_right;
363 	}
364 
365 	rb_link_node(&src_line->node, parent, p);
366 	rb_insert_color(&src_line->node, root);
367 }
368 
369 static void symbol__free_source_line(struct symbol *sym, int len)
370 {
371 	struct annotation *notes = symbol__annotation(sym);
372 	struct source_line *src_line = notes->src->lines;
373 	int i;
374 
375 	for (i = 0; i < len; i++)
376 		free(src_line[i].path);
377 
378 	free(src_line);
379 	notes->src->lines = NULL;
380 }
381 
382 /* Get the filename:line for the colored entries */
383 static int symbol__get_source_line(struct symbol *sym, struct map *map,
384 				   int evidx, struct rb_root *root, int len,
385 				   const char *filename)
386 {
387 	u64 start;
388 	int i;
389 	char cmd[PATH_MAX * 2];
390 	struct source_line *src_line;
391 	struct annotation *notes = symbol__annotation(sym);
392 	struct sym_hist *h = annotation__histogram(notes, evidx);
393 
394 	if (!h->sum)
395 		return 0;
396 
397 	src_line = notes->src->lines = calloc(len, sizeof(struct source_line));
398 	if (!notes->src->lines)
399 		return -1;
400 
401 	start = map->unmap_ip(map, sym->start);
402 
403 	for (i = 0; i < len; i++) {
404 		char *path = NULL;
405 		size_t line_len;
406 		u64 offset;
407 		FILE *fp;
408 
409 		src_line[i].percent = 100.0 * h->addr[i] / h->sum;
410 		if (src_line[i].percent <= 0.5)
411 			continue;
412 
413 		offset = start + i;
414 		sprintf(cmd, "addr2line -e %s %016" PRIx64, filename, offset);
415 		fp = popen(cmd, "r");
416 		if (!fp)
417 			continue;
418 
419 		if (getline(&path, &line_len, fp) < 0 || !line_len)
420 			goto next;
421 
422 		src_line[i].path = malloc(sizeof(char) * line_len + 1);
423 		if (!src_line[i].path)
424 			goto next;
425 
426 		strcpy(src_line[i].path, path);
427 		insert_source_line(root, &src_line[i]);
428 
429 	next:
430 		pclose(fp);
431 	}
432 
433 	return 0;
434 }
435 
436 static void print_summary(struct rb_root *root, const char *filename)
437 {
438 	struct source_line *src_line;
439 	struct rb_node *node;
440 
441 	printf("\nSorted summary for file %s\n", filename);
442 	printf("----------------------------------------------\n\n");
443 
444 	if (RB_EMPTY_ROOT(root)) {
445 		printf(" Nothing higher than %1.1f%%\n", MIN_GREEN);
446 		return;
447 	}
448 
449 	node = rb_first(root);
450 	while (node) {
451 		double percent;
452 		const char *color;
453 		char *path;
454 
455 		src_line = rb_entry(node, struct source_line, node);
456 		percent = src_line->percent;
457 		color = get_percent_color(percent);
458 		path = src_line->path;
459 
460 		color_fprintf(stdout, color, " %7.2f %s", percent, path);
461 		node = rb_next(node);
462 	}
463 }
464 
465 static void symbol__annotate_hits(struct symbol *sym, int evidx)
466 {
467 	struct annotation *notes = symbol__annotation(sym);
468 	struct sym_hist *h = annotation__histogram(notes, evidx);
469 	u64 len = sym->end - sym->start, offset;
470 
471 	for (offset = 0; offset < len; ++offset)
472 		if (h->addr[offset] != 0)
473 			printf("%*" PRIx64 ": %" PRIu64 "\n", BITS_PER_LONG / 2,
474 			       sym->start + offset, h->addr[offset]);
475 	printf("%*s: %" PRIu64 "\n", BITS_PER_LONG / 2, "h->sum", h->sum);
476 }
477 
478 int symbol__annotate_printf(struct symbol *sym, struct map *map, int evidx,
479 			    bool full_paths, int min_pcnt, int max_lines,
480 			    int context)
481 {
482 	struct dso *dso = map->dso;
483 	const char *filename = dso->long_name, *d_filename;
484 	struct annotation *notes = symbol__annotation(sym);
485 	struct objdump_line *pos, *queue = NULL;
486 	int printed = 2, queue_len = 0;
487 	int more = 0;
488 	u64 len;
489 
490 	if (full_paths)
491 		d_filename = filename;
492 	else
493 		d_filename = basename(filename);
494 
495 	len = sym->end - sym->start;
496 
497 	printf(" Percent |	Source code & Disassembly of %s\n", d_filename);
498 	printf("------------------------------------------------\n");
499 
500 	if (verbose)
501 		symbol__annotate_hits(sym, evidx);
502 
503 	list_for_each_entry(pos, &notes->src->source, node) {
504 		if (context && queue == NULL) {
505 			queue = pos;
506 			queue_len = 0;
507 		}
508 
509 		switch (objdump_line__print(pos, sym, evidx, len, min_pcnt,
510 					    printed, max_lines, queue)) {
511 		case 0:
512 			++printed;
513 			if (context) {
514 				printed += queue_len;
515 				queue = NULL;
516 				queue_len = 0;
517 			}
518 			break;
519 		case 1:
520 			/* filtered by max_lines */
521 			++more;
522 			break;
523 		case -1:
524 		default:
525 			/*
526 			 * Filtered by min_pcnt or non IP lines when
527 			 * context != 0
528 			 */
529 			if (!context)
530 				break;
531 			if (queue_len == context)
532 				queue = list_entry(queue->node.next, typeof(*queue), node);
533 			else
534 				++queue_len;
535 			break;
536 		}
537 	}
538 
539 	return more;
540 }
541 
542 void symbol__annotate_zero_histogram(struct symbol *sym, int evidx)
543 {
544 	struct annotation *notes = symbol__annotation(sym);
545 	struct sym_hist *h = annotation__histogram(notes, evidx);
546 
547 	memset(h, 0, notes->src->sizeof_sym_hist);
548 }
549 
550 void symbol__annotate_decay_histogram(struct symbol *sym, int evidx)
551 {
552 	struct annotation *notes = symbol__annotation(sym);
553 	struct sym_hist *h = annotation__histogram(notes, evidx);
554 	struct objdump_line *pos;
555 	int len = sym->end - sym->start;
556 
557 	h->sum = 0;
558 
559 	list_for_each_entry(pos, &notes->src->source, node) {
560 		if (pos->offset != -1 && pos->offset < len) {
561 			h->addr[pos->offset] = h->addr[pos->offset] * 7 / 8;
562 			h->sum += h->addr[pos->offset];
563 		}
564 	}
565 }
566 
567 void objdump_line_list__purge(struct list_head *head)
568 {
569 	struct objdump_line *pos, *n;
570 
571 	list_for_each_entry_safe(pos, n, head, node) {
572 		list_del(&pos->node);
573 		objdump_line__free(pos);
574 	}
575 }
576 
577 int symbol__tty_annotate(struct symbol *sym, struct map *map, int evidx,
578 			 bool print_lines, bool full_paths, int min_pcnt,
579 			 int max_lines)
580 {
581 	struct dso *dso = map->dso;
582 	const char *filename = dso->long_name;
583 	struct rb_root source_line = RB_ROOT;
584 	u64 len;
585 
586 	if (symbol__annotate(sym, map, 0) < 0)
587 		return -1;
588 
589 	len = sym->end - sym->start;
590 
591 	if (print_lines) {
592 		symbol__get_source_line(sym, map, evidx, &source_line,
593 					len, filename);
594 		print_summary(&source_line, filename);
595 	}
596 
597 	symbol__annotate_printf(sym, map, evidx, full_paths,
598 				min_pcnt, max_lines, 0);
599 	if (print_lines)
600 		symbol__free_source_line(sym, len);
601 
602 	objdump_line_list__purge(&symbol__annotation(sym)->src->source);
603 
604 	return 0;
605 }
606