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>
38 struct ins_operands
*ops
;
46 void (*free
)(struct ins_operands
*ops
);
47 int (*parse
)(struct arch
*arch
, struct ins_operands
*ops
, struct map
*map
);
48 int (*scnprintf
)(struct ins
*ins
, char *bf
, size_t size
,
49 struct ins_operands
*ops
);
52 bool ins__is_jump(const struct ins
*ins
);
53 bool ins__is_call(const struct ins
*ins
);
54 bool ins__is_ret(const struct ins
*ins
);
55 int ins__scnprintf(struct ins
*ins
, char *bf
, size_t size
, struct ins_operands
*ops
);
60 struct list_head node
;
67 struct ins_operands ops
;
70 static inline bool disasm_line__has_offset(const struct disasm_line
*dl
)
72 return dl
->ops
.target
.offset_avail
;
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
);
77 int disasm_line__scnprintf(struct disasm_line
*dl
, char *bf
, size_t size
, bool raw
);
78 size_t disasm__fprintf(struct list_head
*head
, FILE *fp
);
79 double disasm__calc_percent(struct annotation
*notes
, int evidx
, s64 offset
,
80 s64 end
, const char **path
, u64
*nr_samples
);
98 struct source_line_samples
{
108 struct source_line_samples samples
[1];
111 /** struct annotated_source - symbols with hits have this attached as in sannotation
113 * @histogram: Array of addr hit histograms per event being monitored
114 * @lines: If 'print_lines' is specified, per source code line percentages
115 * @source: source parsed from a disassembler like objdump -dS
116 * @cyc_hist: Average cycles per basic block
118 * lines is allocated, percentages calculated and all sorted by percentage
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
124 struct annotated_source
{
125 struct list_head source
;
126 struct source_line
*lines
;
128 size_t sizeof_sym_hist
;
129 struct cyc_hist
*cycles_hist
;
130 struct sym_hist histograms
[0];
134 pthread_mutex_t lock
;
136 struct annotated_source
*src
;
139 static inline struct sym_hist
*annotation__histogram(struct annotation
*notes
, int idx
)
141 return (((void *)¬es
->src
->histograms
) +
142 (notes
->src
->sizeof_sym_hist
* idx
));
145 static inline struct annotation
*symbol__annotation(struct symbol
*sym
)
147 return (void *)sym
- symbol_conf
.priv_size
;
150 int addr_map_symbol__inc_samples(struct addr_map_symbol
*ams
, int evidx
);
152 int addr_map_symbol__account_cycles(struct addr_map_symbol
*ams
,
153 struct addr_map_symbol
*start
,
156 int hist_entry__inc_addr_samples(struct hist_entry
*he
, int evidx
, u64 addr
);
158 int symbol__alloc_hist(struct symbol
*sym
);
159 void symbol__annotate_zero_histograms(struct symbol
*sym
);
161 int symbol__disassemble(struct symbol
*sym
, struct map
*map
, const char *arch_name
, size_t privsize
);
163 enum symbol_disassemble_errno
{
164 SYMBOL_ANNOTATE_ERRNO__SUCCESS
= 0,
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.
171 * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/errno.h.html
173 __SYMBOL_ANNOTATE_ERRNO__START
= -10000,
175 SYMBOL_ANNOTATE_ERRNO__NO_VMLINUX
= __SYMBOL_ANNOTATE_ERRNO__START
,
177 __SYMBOL_ANNOTATE_ERRNO__END
,
180 int symbol__strerror_disassemble(struct symbol
*sym
, struct map
*map
,
181 int errnum
, char *buf
, size_t buflen
);
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
);
186 void symbol__annotate_zero_histogram(struct symbol
*sym
, int evidx
);
187 void symbol__annotate_decay_histogram(struct symbol
*sym
, int evidx
);
188 void disasm__purge(struct list_head
*head
);
190 bool ui__has_annotation(void);
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
);
196 #ifdef HAVE_SLANG_SUPPORT
197 int symbol__tui_annotate(struct symbol
*sym
, struct map
*map
,
198 struct perf_evsel
*evsel
,
199 struct hist_browser_timer
*hbt
);
201 static inline int symbol__tui_annotate(struct symbol
*sym __maybe_unused
,
202 struct map
*map __maybe_unused
,
203 struct perf_evsel
*evsel __maybe_unused
,
204 struct hist_browser_timer
*hbt
211 extern const char *disassembler_style
;
213 #endif /* __PERF_ANNOTATE_H */