blob: efa5dc82bfaef4545904cd9c70b51c2007dcd5b6 [file] [log] [blame]
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -02001#ifndef __PERF_ANNOTATE_H
2#define __PERF_ANNOTATE_H
3
4#include <stdbool.h>
5#include "types.h"
6#include "symbol.h"
7#include <linux/list.h>
8#include <linux/rbtree.h>
9
10struct objdump_line {
11 struct list_head node;
12 s64 offset;
13 char *line;
14};
15
16void objdump_line__free(struct objdump_line *self);
17struct objdump_line *objdump__get_next_ip_line(struct list_head *head,
18 struct objdump_line *pos);
19
20struct sym_hist {
21 u64 sum;
22 u64 addr[0];
23};
24
25struct source_line {
26 struct rb_node node;
27 double percent;
28 char *path;
29};
30
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020031/** struct annotated_source - symbols with hits have this attached as in sannotation
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020032 *
33 * @histogram: Array of addr hit histograms per event being monitored
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020034 * @lines: If 'print_lines' is specified, per source code line percentages
35 * @source: source parsed from objdump -dS
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020036 *
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020037 * lines is allocated, percentages calculated and all sorted by percentage
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020038 * when the annotation is about to be presented, so the percentages are for
39 * one of the entries in the histogram array, i.e. for the event/counter being
40 * presented. It is deallocated right after symbol__{tui,tty,etc}_annotate
41 * returns.
42 */
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020043struct annotated_source {
44 struct list_head source;
45 struct source_line *lines;
Arnaldo Carvalho de Melo36532462011-02-06 14:54:44 -020046 int nr_histograms;
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020047 int sizeof_sym_hist;
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020048 struct sym_hist histograms[0];
49};
50
51struct annotation {
52 pthread_mutex_t lock;
53 struct annotated_source *src;
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -020054};
55
56struct sannotation {
57 struct annotation annotation;
58 struct symbol symbol;
59};
60
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020061static inline struct sym_hist *annotation__histogram(struct annotation *notes, int idx)
62{
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020063 return (((void *)&notes->src->histograms) +
64 (notes->src->sizeof_sym_hist * idx));
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020065}
66
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -020067static inline struct annotation *symbol__annotation(struct symbol *sym)
68{
69 struct sannotation *a = container_of(sym, struct sannotation, symbol);
70 return &a->annotation;
71}
72
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020073int symbol__inc_addr_samples(struct symbol *sym, struct map *map,
74 int evidx, u64 addr);
Arnaldo Carvalho de Melod04b35f2011-11-11 22:17:32 -020075int symbol__alloc_hist(struct symbol *sym);
Arnaldo Carvalho de Melo36532462011-02-06 14:54:44 -020076void symbol__annotate_zero_histograms(struct symbol *sym);
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -020077
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020078int symbol__annotate(struct symbol *sym, struct map *map, size_t privsize);
79int symbol__annotate_init(struct map *map __used, struct symbol *sym);
80int symbol__annotate_printf(struct symbol *sym, struct map *map, int evidx,
Arnaldo Carvalho de Melod5e3d742011-02-08 15:29:25 -020081 bool full_paths, int min_pcnt, int max_lines,
82 int context);
Arnaldo Carvalho de Melo36532462011-02-06 14:54:44 -020083void symbol__annotate_zero_histogram(struct symbol *sym, int evidx);
Arnaldo Carvalho de Meloce6f4fa2011-02-08 13:27:39 -020084void symbol__annotate_decay_histogram(struct symbol *sym, int evidx);
Arnaldo Carvalho de Melof1e27012011-02-05 18:51:38 -020085void objdump_line_list__purge(struct list_head *head);
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -020086
Arnaldo Carvalho de Melo2f525d02011-02-04 13:43:24 -020087int symbol__tty_annotate(struct symbol *sym, struct map *map, int evidx,
Arnaldo Carvalho de Melod040bd32011-02-05 15:37:31 -020088 bool print_lines, bool full_paths, int min_pcnt,
89 int max_lines);
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -020090
91#ifdef NO_NEWT_SUPPORT
Borislav Petkova2221792011-02-07 15:32:18 +010092static inline int symbol__tui_annotate(struct symbol *sym __used,
Arnaldo Carvalho de Meloc97cf422011-02-22 12:02:07 -030093 struct map *map __used,
Arnaldo Carvalho de Melo81cce8d2011-10-05 19:11:32 -030094 int evidx __used,
95 void(*timer)(void *arg) __used,
96 void *arg __used, int delay_secs __used)
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -020097{
98 return 0;
99}
100#else
Arnaldo Carvalho de Meloc97cf422011-02-22 12:02:07 -0300101int symbol__tui_annotate(struct symbol *sym, struct map *map, int evidx,
Arnaldo Carvalho de Melod04b35f2011-11-11 22:17:32 -0200102 void(*timer)(void *arg), void *arg, int delay_secs);
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -0200103#endif
104
Andi Kleenf69b64f2011-09-15 14:31:41 -0700105extern const char *disassembler_style;
106
Arnaldo Carvalho de Melo78f7def2011-02-04 09:45:46 -0200107#endif /* __PERF_ANNOTATE_H */