1 /* SPDX-License-Identifier: GPL-2.0 */
3 #define __PERF_SYMBOL 1
5 #include <linux/types.h>
10 #include <linux/list.h>
11 #include <linux/rbtree.h>
19 #ifdef HAVE_LIBELF_SUPPORT
28 * libelf 0.8.x and earlier do not support ELF_C_READ_MMAP;
29 * for newer versions we can use mmap to reduce memory usage:
31 #ifdef HAVE_LIBELF_MMAP_SUPPORT
32 # define PERF_ELF_C_READ_MMAP ELF_C_READ_MMAP
34 # define PERF_ELF_C_READ_MMAP ELF_C_READ
37 #ifdef HAVE_LIBELF_SUPPORT
38 Elf_Scn
*elf_section_by_name(Elf
*elf
, GElf_Ehdr
*ep
,
39 GElf_Shdr
*shp
, const char *name
, size_t *idx
);
43 #define DMGL_NO_OPTS 0 /* For readability... */
44 #define DMGL_PARAMS (1 << 0) /* Include function args */
45 #define DMGL_ANSI (1 << 1) /* Include const, volatile, etc */
48 #define DSO__NAME_KALLSYMS "[kernel.kallsyms]"
49 #define DSO__NAME_KCORE "[kernel.kcore]"
51 /** struct symbol - symtab entry
53 * @ignore - resolvable but tools ignore it (e.g. idle routines)
56 struct rb_node rb_node
;
67 void symbol__delete(struct symbol
*sym
);
68 void symbols__delete(struct rb_root
*symbols
);
70 /* symbols__for_each_entry - iterate over symbols (rb_root)
72 * @symbols: the rb_root of symbols
73 * @pos: the 'struct symbol *' to use as a loop cursor
74 * @nd: the 'struct rb_node *' to use as a temporary storage
76 #define symbols__for_each_entry(symbols, pos, nd) \
77 for (nd = rb_first(symbols); \
78 nd && (pos = rb_entry(nd, struct symbol, rb_node)); \
81 static inline size_t symbol__size(const struct symbol
*sym
)
83 return sym
->end
- sym
->start
;
90 unsigned short priv_size
;
91 unsigned short nr_events
;
92 bool try_vmlinux_path
,
96 ignore_vmlinux_buildid
,
105 show_branchflag_count
,
107 show_cpu_utilization
,
124 const char *vmlinux_name
,
128 const char *default_guest_vmlinux_name
,
129 *default_guest_kallsyms
,
130 *default_guest_modules
;
131 const char *guestmount
;
132 const char *dso_list_str
,
139 struct strlist
*dso_list
,
147 struct intlist
*pid_list
,
152 extern struct symbol_conf symbol_conf
;
154 struct symbol_name_rb_node
{
155 struct rb_node rb_node
;
159 static inline int __symbol__join_symfs(char *bf
, size_t size
, const char *path
)
161 return path__join(bf
, size
, symbol_conf
.symfs
, path
);
164 #define symbol__join_symfs(bf, path) __symbol__join_symfs(bf, sizeof(bf), path)
166 extern int vmlinux_path__nr_entries
;
167 extern char **vmlinux_path
;
169 static inline void *symbol__priv(struct symbol
*sym
)
171 return ((void *)sym
) - symbol_conf
.priv_size
;
174 struct ref_reloc_sym
{
177 u64 unrelocated_addr
;
185 struct addr_map_symbol
{
194 struct addr_map_symbol from
;
195 struct addr_map_symbol to
;
196 struct branch_flags flags
;
202 struct addr_map_symbol iaddr
;
203 struct addr_map_symbol daddr
;
204 union perf_mem_data_src data_src
;
207 struct addr_location
{
208 struct machine
*machine
;
209 struct thread
*thread
;
223 enum dso_binary_type type
;
225 #ifdef HAVE_LIBELF_SUPPORT
245 void symsrc__destroy(struct symsrc
*ss
);
246 int symsrc__init(struct symsrc
*ss
, struct dso
*dso
, const char *name
,
247 enum dso_binary_type type
);
248 bool symsrc__has_symtab(struct symsrc
*ss
);
249 bool symsrc__possibly_runtime(struct symsrc
*ss
);
251 int dso__load(struct dso
*dso
, struct map
*map
);
252 int dso__load_vmlinux(struct dso
*dso
, struct map
*map
,
253 const char *vmlinux
, bool vmlinux_allocated
);
254 int dso__load_vmlinux_path(struct dso
*dso
, struct map
*map
);
255 int __dso__load_kallsyms(struct dso
*dso
, const char *filename
, struct map
*map
,
257 int dso__load_kallsyms(struct dso
*dso
, const char *filename
, struct map
*map
);
259 void dso__insert_symbol(struct dso
*dso
, enum map_type type
,
262 struct symbol
*dso__find_symbol(struct dso
*dso
, enum map_type type
,
264 struct symbol
*dso__find_symbol_by_name(struct dso
*dso
, enum map_type type
,
266 struct symbol
*symbol__next_by_name(struct symbol
*sym
);
268 struct symbol
*dso__first_symbol(struct dso
*dso
, enum map_type type
);
269 struct symbol
*dso__last_symbol(struct dso
*dso
, enum map_type type
);
270 struct symbol
*dso__next_symbol(struct symbol
*sym
);
272 enum dso_type
dso__type_fd(int fd
);
274 int filename__read_build_id(const char *filename
, void *bf
, size_t size
);
275 int sysfs__read_build_id(const char *filename
, void *bf
, size_t size
);
276 int modules__parse(const char *filename
, void *arg
,
277 int (*process_module
)(void *arg
, const char *name
,
278 u64 start
, u64 size
));
279 int filename__read_debuglink(const char *filename
, char *debuglink
,
283 int symbol__init(struct perf_env
*env
);
284 void symbol__exit(void);
285 void symbol__elf_init(void);
286 int symbol__annotation_init(void);
288 struct symbol
*symbol__new(u64 start
, u64 len
, u8 binding
, const char *name
);
289 size_t __symbol__fprintf_symname_offs(const struct symbol
*sym
,
290 const struct addr_location
*al
,
291 bool unknown_as_addr
,
292 bool print_offsets
, FILE *fp
);
293 size_t symbol__fprintf_symname_offs(const struct symbol
*sym
,
294 const struct addr_location
*al
, FILE *fp
);
295 size_t __symbol__fprintf_symname(const struct symbol
*sym
,
296 const struct addr_location
*al
,
297 bool unknown_as_addr
, FILE *fp
);
298 size_t symbol__fprintf_symname(const struct symbol
*sym
, FILE *fp
);
299 size_t symbol__fprintf(struct symbol
*sym
, FILE *fp
);
300 bool symbol_type__is_a(char symbol_type
, enum map_type map_type
);
301 bool symbol__restricted_filename(const char *filename
,
302 const char *restricted_filename
);
303 int symbol__config_symfs(const struct option
*opt __maybe_unused
,
304 const char *dir
, int unset __maybe_unused
);
306 int dso__load_sym(struct dso
*dso
, struct map
*map
, struct symsrc
*syms_ss
,
307 struct symsrc
*runtime_ss
, int kmodule
);
308 int dso__synthesize_plt_symbols(struct dso
*dso
, struct symsrc
*ss
,
311 char *dso__demangle_sym(struct dso
*dso
, int kmodule
, const char *elf_name
);
313 void __symbols__insert(struct rb_root
*symbols
, struct symbol
*sym
, bool kernel
);
314 void symbols__insert(struct rb_root
*symbols
, struct symbol
*sym
);
315 void symbols__fixup_duplicate(struct rb_root
*symbols
);
316 void symbols__fixup_end(struct rb_root
*symbols
);
317 void __map_groups__fixup_end(struct map_groups
*mg
, enum map_type type
);
319 typedef int (*mapfn_t
)(u64 start
, u64 len
, u64 pgoff
, void *data
);
320 int file__read_maps(int fd
, bool exe
, mapfn_t mapfn
, void *data
,
323 #define PERF_KCORE_EXTRACT "/tmp/perf-kcore-XXXXXX"
325 struct kcore_extract
{
326 char *kcore_filename
;
330 char extract_filename
[sizeof(PERF_KCORE_EXTRACT
)];
334 int kcore_extract__create(struct kcore_extract
*kce
);
335 void kcore_extract__delete(struct kcore_extract
*kce
);
337 int kcore_copy(const char *from_dir
, const char *to_dir
);
338 int compare_proc_modules(const char *from
, const char *to
);
340 int setup_list(struct strlist
**list
, const char *list_str
,
341 const char *list_name
);
342 int setup_intlist(struct intlist
**list
, const char *list_str
,
343 const char *list_name
);
345 #ifdef HAVE_LIBELF_SUPPORT
346 bool elf__needs_adjust_symbols(GElf_Ehdr ehdr
);
347 void arch__sym_update(struct symbol
*s
, GElf_Sym
*sym
);
353 int arch__compare_symbol_names(const char *namea
, const char *nameb
);
354 int arch__compare_symbol_names_n(const char *namea
, const char *nameb
,
356 int arch__choose_best_symbol(struct symbol
*syma
, struct symbol
*symb
);
358 enum symbol_tag_include
{
359 SYMBOL_TAG_INCLUDE__NONE
= 0,
360 SYMBOL_TAG_INCLUDE__DEFAULT_ONLY
363 int symbol__match_symbol_name(const char *namea
, const char *nameb
,
364 enum symbol_tag_include includes
);
366 /* structure containing an SDT note's info */
368 char *name
; /* name of the note*/
369 char *provider
; /* provider name */
371 bool bit32
; /* whether the location is 32 bits? */
372 union { /* location, base and semaphore addrs */
376 struct list_head note_list
; /* SDT notes' list */
379 int get_sdt_note_list(struct list_head
*head
, const char *target
);
380 int cleanup_sdt_note_list(struct list_head
*sdt_notes
);
381 int sdt_notes__get_count(struct list_head
*start
);
383 #define SDT_BASE_SCN ".stapsdt.base"
384 #define SDT_NOTE_SCN ".note.stapsdt"
385 #define SDT_NOTE_TYPE 3
386 #define SDT_NOTE_NAME "stapsdt"
389 #endif /* __PERF_SYMBOL */