]>
Commit | Line | Data |
---|---|---|
78f7defe ACM |
1 | #ifndef __PERF_ANNOTATE_H |
2 | #define __PERF_ANNOTATE_H | |
3 | ||
4 | #include <stdbool.h> | |
fb29fa58 | 5 | #include <stdint.h> |
d944c4ee | 6 | #include <linux/types.h> |
78f7defe | 7 | #include "symbol.h" |
9783adf7 | 8 | #include "hist.h" |
2b676bf0 | 9 | #include "sort.h" |
78f7defe ACM |
10 | #include <linux/list.h> |
11 | #include <linux/rbtree.h> | |
27683dc5 | 12 | #include <pthread.h> |
78f7defe | 13 | |
75b49202 ACM |
14 | struct ins_ops; |
15 | ||
16 | struct ins { | |
17 | const char *name; | |
18 | struct ins_ops *ops; | |
19 | }; | |
28548d78 | 20 | |
c7e6ead7 ACM |
21 | struct ins_operands { |
22 | char *raw; | |
44d1a3ed | 23 | struct { |
6de783b6 | 24 | char *raw; |
44d1a3ed | 25 | char *name; |
44d1a3ed | 26 | u64 addr; |
e216874c RB |
27 | s64 offset; |
28 | bool offset_avail; | |
44d1a3ed | 29 | } target; |
7a997fe4 ACM |
30 | union { |
31 | struct { | |
32 | char *raw; | |
33 | char *name; | |
34 | u64 addr; | |
35 | } source; | |
36 | struct { | |
75b49202 | 37 | struct ins ins; |
7a997fe4 ACM |
38 | struct ins_operands *ops; |
39 | } locked; | |
40 | }; | |
c7e6ead7 ACM |
41 | }; |
42 | ||
786c1b51 ACM |
43 | struct arch; |
44 | ||
4f9d0325 | 45 | struct ins_ops { |
c46219ac | 46 | void (*free)(struct ins_operands *ops); |
786c1b51 | 47 | int (*parse)(struct arch *arch, struct ins_operands *ops, struct map *map); |
28548d78 | 48 | int (*scnprintf)(struct ins *ins, char *bf, size_t size, |
5417072b | 49 | struct ins_operands *ops); |
4f9d0325 ACM |
50 | }; |
51 | ||
4f9d0325 | 52 | bool ins__is_jump(const struct ins *ins); |
d86b0597 | 53 | bool ins__is_call(const struct ins *ins); |
6ef94929 | 54 | bool ins__is_ret(const struct ins *ins); |
5417072b | 55 | int ins__scnprintf(struct ins *ins, char *bf, size_t size, struct ins_operands *ops); |
4f9d0325 | 56 | |
e64aa75b NK |
57 | struct annotation; |
58 | ||
29ed6e76 | 59 | struct disasm_line { |
c7e6ead7 ACM |
60 | struct list_head node; |
61 | s64 offset; | |
62 | char *line; | |
75b49202 | 63 | struct ins ins; |
e592488c | 64 | int line_nr; |
30e863bb AK |
65 | float ipc; |
66 | u64 cycles; | |
c7e6ead7 | 67 | struct ins_operands ops; |
78f7defe ACM |
68 | }; |
69 | ||
fb29fa58 ACM |
70 | static inline bool disasm_line__has_offset(const struct disasm_line *dl) |
71 | { | |
e216874c | 72 | return dl->ops.target.offset_avail; |
fb29fa58 ACM |
73 | } |
74 | ||
29ed6e76 ACM |
75 | void disasm_line__free(struct disasm_line *dl); |
76 | struct disasm_line *disasm__get_next_ip_line(struct list_head *head, struct disasm_line *pos); | |
5417072b | 77 | int disasm_line__scnprintf(struct disasm_line *dl, char *bf, size_t size, bool raw); |
5145418b | 78 | size_t disasm__fprintf(struct list_head *head, FILE *fp); |
e64aa75b | 79 | double disasm__calc_percent(struct annotation *notes, int evidx, s64 offset, |
0c4a5bce | 80 | s64 end, const char **path, u64 *nr_samples); |
78f7defe ACM |
81 | |
82 | struct sym_hist { | |
83 | u64 sum; | |
84 | u64 addr[0]; | |
85 | }; | |
86 | ||
d4957633 AK |
87 | struct cyc_hist { |
88 | u64 start; | |
89 | u64 cycles; | |
90 | u64 cycles_aggr; | |
91 | u32 num; | |
92 | u32 num_aggr; | |
93 | u8 have_start; | |
94 | /* 1 byte padding */ | |
95 | u16 reset; | |
96 | }; | |
97 | ||
276af92f | 98 | struct source_line_samples { |
78f7defe | 99 | double percent; |
41127965 | 100 | double percent_sum; |
99094a5e | 101 | u64 nr; |
c5a8368c NK |
102 | }; |
103 | ||
104 | struct source_line { | |
105 | struct rb_node node; | |
78f7defe | 106 | char *path; |
1491c22a | 107 | int nr_pcnt; |
276af92f | 108 | struct source_line_samples samples[1]; |
78f7defe ACM |
109 | }; |
110 | ||
ce6f4fab | 111 | /** struct annotated_source - symbols with hits have this attached as in sannotation |
2f525d01 ACM |
112 | * |
113 | * @histogram: Array of addr hit histograms per event being monitored | |
ce6f4fab | 114 | * @lines: If 'print_lines' is specified, per source code line percentages |
29ed6e76 | 115 | * @source: source parsed from a disassembler like objdump -dS |
d4957633 | 116 | * @cyc_hist: Average cycles per basic block |
2f525d01 | 117 | * |
ce6f4fab | 118 | * lines is allocated, percentages calculated and all sorted by percentage |
2f525d01 ACM |
119 | * when the annotation is about to be presented, so the percentages are for |
120 | * one of the entries in the histogram array, i.e. for the event/counter being | |
121 | * presented. It is deallocated right after symbol__{tui,tty,etc}_annotate | |
122 | * returns. | |
123 | */ | |
ce6f4fab ACM |
124 | struct annotated_source { |
125 | struct list_head source; | |
126 | struct source_line *lines; | |
36532461 | 127 | int nr_histograms; |
5ec4502d | 128 | size_t sizeof_sym_hist; |
d4957633 | 129 | struct cyc_hist *cycles_hist; |
ce6f4fab ACM |
130 | struct sym_hist histograms[0]; |
131 | }; | |
132 | ||
133 | struct annotation { | |
134 | pthread_mutex_t lock; | |
70fbe057 | 135 | u64 max_coverage; |
ce6f4fab | 136 | struct annotated_source *src; |
78f7defe ACM |
137 | }; |
138 | ||
2f525d01 ACM |
139 | static inline struct sym_hist *annotation__histogram(struct annotation *notes, int idx) |
140 | { | |
ce6f4fab ACM |
141 | return (((void *)¬es->src->histograms) + |
142 | (notes->src->sizeof_sym_hist * idx)); | |
2f525d01 ACM |
143 | } |
144 | ||
78f7defe ACM |
145 | static inline struct annotation *symbol__annotation(struct symbol *sym) |
146 | { | |
813ccd15 | 147 | return (void *)sym - symbol_conf.priv_size; |
78f7defe ACM |
148 | } |
149 | ||
0f4e7a24 ACM |
150 | int addr_map_symbol__inc_samples(struct addr_map_symbol *ams, int evidx); |
151 | ||
d4957633 AK |
152 | int addr_map_symbol__account_cycles(struct addr_map_symbol *ams, |
153 | struct addr_map_symbol *start, | |
154 | unsigned cycles); | |
155 | ||
f626adff ACM |
156 | int hist_entry__inc_addr_samples(struct hist_entry *he, int evidx, u64 addr); |
157 | ||
d04b35f8 | 158 | int symbol__alloc_hist(struct symbol *sym); |
36532461 | 159 | void symbol__annotate_zero_histograms(struct symbol *sym); |
78f7defe | 160 | |
786c1b51 | 161 | int symbol__disassemble(struct symbol *sym, struct map *map, const char *arch_name, size_t privsize); |
f626adff | 162 | |
ee51d851 ACM |
163 | enum symbol_disassemble_errno { |
164 | SYMBOL_ANNOTATE_ERRNO__SUCCESS = 0, | |
165 | ||
166 | /* | |
167 | * Choose an arbitrary negative big number not to clash with standard | |
168 | * errno since SUS requires the errno has distinct positive values. | |
169 | * See 'Issue 6' in the link below. | |
170 | * | |
171 | * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/errno.h.html | |
172 | */ | |
173 | __SYMBOL_ANNOTATE_ERRNO__START = -10000, | |
174 | ||
175 | SYMBOL_ANNOTATE_ERRNO__NO_VMLINUX = __SYMBOL_ANNOTATE_ERRNO__START, | |
176 | ||
177 | __SYMBOL_ANNOTATE_ERRNO__END, | |
178 | }; | |
179 | ||
180 | int symbol__strerror_disassemble(struct symbol *sym, struct map *map, | |
181 | int errnum, char *buf, size_t buflen); | |
182 | ||
db8fd07a NK |
183 | int symbol__annotate_printf(struct symbol *sym, struct map *map, |
184 | struct perf_evsel *evsel, bool full_paths, | |
185 | int min_pcnt, int max_lines, int context); | |
36532461 | 186 | void symbol__annotate_zero_histogram(struct symbol *sym, int evidx); |
ce6f4fab | 187 | void symbol__annotate_decay_histogram(struct symbol *sym, int evidx); |
29ed6e76 | 188 | void disasm__purge(struct list_head *head); |
78f7defe | 189 | |
48c65bda NK |
190 | bool ui__has_annotation(void); |
191 | ||
db8fd07a NK |
192 | int symbol__tty_annotate(struct symbol *sym, struct map *map, |
193 | struct perf_evsel *evsel, bool print_lines, | |
194 | bool full_paths, int min_pcnt, int max_lines); | |
78f7defe | 195 | |
89fe808a | 196 | #ifdef HAVE_SLANG_SUPPORT |
db8fd07a NK |
197 | int symbol__tui_annotate(struct symbol *sym, struct map *map, |
198 | struct perf_evsel *evsel, | |
9783adf7 | 199 | struct hist_browser_timer *hbt); |
1254b51e | 200 | #else |
1d037ca1 | 201 | static inline int symbol__tui_annotate(struct symbol *sym __maybe_unused, |
db8fd07a NK |
202 | struct map *map __maybe_unused, |
203 | struct perf_evsel *evsel __maybe_unused, | |
204 | struct hist_browser_timer *hbt | |
205 | __maybe_unused) | |
78f7defe ACM |
206 | { |
207 | return 0; | |
208 | } | |
78f7defe ACM |
209 | #endif |
210 | ||
f69b64f7 AK |
211 | extern const char *disassembler_style; |
212 | ||
78f7defe | 213 | #endif /* __PERF_ANNOTATE_H */ |