1 #ifndef __PERF_ANNOTATE_H
2 #define __PERF_ANNOTATE_H
6 #include <linux/types.h>
10 #include <linux/list.h>
11 #include <linux/rbtree.h>
32 struct ins_operands
*ops
;
38 void (*free
)(struct ins_operands
*ops
);
39 int (*parse
)(struct ins_operands
*ops
);
40 int (*scnprintf
)(struct ins
*ins
, char *bf
, size_t size
,
41 struct ins_operands
*ops
);
49 bool ins__is_jump(const struct ins
*ins
);
50 bool ins__is_call(const struct ins
*ins
);
51 bool ins__is_ret(const struct ins
*ins
);
52 int ins__scnprintf(struct ins
*ins
, char *bf
, size_t size
, struct ins_operands
*ops
);
57 struct list_head node
;
65 struct ins_operands ops
;
68 static inline bool disasm_line__has_offset(const struct disasm_line
*dl
)
70 return dl
->ops
.target
.offset
!= UINT64_MAX
;
73 void disasm_line__free(struct disasm_line
*dl
);
74 struct disasm_line
*disasm__get_next_ip_line(struct list_head
*head
, struct disasm_line
*pos
);
75 int disasm_line__scnprintf(struct disasm_line
*dl
, char *bf
, size_t size
, bool raw
);
76 size_t disasm__fprintf(struct list_head
*head
, FILE *fp
);
77 double disasm__calc_percent(struct annotation
*notes
, int evidx
, s64 offset
,
78 s64 end
, const char **path
, u64
*nr_samples
);
96 struct source_line_samples
{
106 struct source_line_samples samples
[1];
109 /** struct annotated_source - symbols with hits have this attached as in sannotation
111 * @histogram: Array of addr hit histograms per event being monitored
112 * @lines: If 'print_lines' is specified, per source code line percentages
113 * @source: source parsed from a disassembler like objdump -dS
114 * @cyc_hist: Average cycles per basic block
116 * lines is allocated, percentages calculated and all sorted by percentage
117 * when the annotation is about to be presented, so the percentages are for
118 * one of the entries in the histogram array, i.e. for the event/counter being
119 * presented. It is deallocated right after symbol__{tui,tty,etc}_annotate
122 struct annotated_source
{
123 struct list_head source
;
124 struct source_line
*lines
;
126 size_t sizeof_sym_hist
;
127 struct cyc_hist
*cycles_hist
;
128 struct sym_hist histograms
[0];
132 pthread_mutex_t lock
;
133 struct annotated_source
*src
;
136 static inline struct sym_hist
*annotation__histogram(struct annotation
*notes
, int idx
)
138 return (((void *)¬es
->src
->histograms
) +
139 (notes
->src
->sizeof_sym_hist
* idx
));
142 static inline struct annotation
*symbol__annotation(struct symbol
*sym
)
144 return (void *)sym
- symbol_conf
.priv_size
;
147 int addr_map_symbol__inc_samples(struct addr_map_symbol
*ams
, int evidx
);
149 int addr_map_symbol__account_cycles(struct addr_map_symbol
*ams
,
150 struct addr_map_symbol
*start
,
153 int hist_entry__inc_addr_samples(struct hist_entry
*he
, int evidx
, u64 addr
);
155 int symbol__alloc_hist(struct symbol
*sym
);
156 void symbol__annotate_zero_histograms(struct symbol
*sym
);
158 int symbol__disassemble(struct symbol
*sym
, struct map
*map
, size_t privsize
);
160 enum symbol_disassemble_errno
{
161 SYMBOL_ANNOTATE_ERRNO__SUCCESS
= 0,
164 * Choose an arbitrary negative big number not to clash with standard
165 * errno since SUS requires the errno has distinct positive values.
166 * See 'Issue 6' in the link below.
168 * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/errno.h.html
170 __SYMBOL_ANNOTATE_ERRNO__START
= -10000,
172 SYMBOL_ANNOTATE_ERRNO__NO_VMLINUX
= __SYMBOL_ANNOTATE_ERRNO__START
,
174 __SYMBOL_ANNOTATE_ERRNO__END
,
177 int symbol__strerror_disassemble(struct symbol
*sym
, struct map
*map
,
178 int errnum
, char *buf
, size_t buflen
);
180 int symbol__annotate_init(struct map
*map
, struct symbol
*sym
);
181 int symbol__annotate_printf(struct symbol
*sym
, struct map
*map
,
182 struct perf_evsel
*evsel
, bool full_paths
,
183 int min_pcnt
, int max_lines
, int context
);
184 void symbol__annotate_zero_histogram(struct symbol
*sym
, int evidx
);
185 void symbol__annotate_decay_histogram(struct symbol
*sym
, int evidx
);
186 void disasm__purge(struct list_head
*head
);
188 bool ui__has_annotation(void);
190 int symbol__tty_annotate(struct symbol
*sym
, struct map
*map
,
191 struct perf_evsel
*evsel
, bool print_lines
,
192 bool full_paths
, int min_pcnt
, int max_lines
);
194 #ifdef HAVE_SLANG_SUPPORT
195 int symbol__tui_annotate(struct symbol
*sym
, struct map
*map
,
196 struct perf_evsel
*evsel
,
197 struct hist_browser_timer
*hbt
);
199 static inline int symbol__tui_annotate(struct symbol
*sym __maybe_unused
,
200 struct map
*map __maybe_unused
,
201 struct perf_evsel
*evsel __maybe_unused
,
202 struct hist_browser_timer
*hbt
209 extern const char *disassembler_style
;
211 #endif /* __PERF_ANNOTATE_H */