1 /* SPDX-License-Identifier: GPL-2.0 */
3 #define __PERF_SYMBOL 1
5 #include <linux/types.h>
8 #include <linux/list.h>
9 #include <linux/rbtree.h>
11 #include "map_symbol.h"
14 #include "symbol_conf.h"
16 #ifdef HAVE_LIBELF_SUPPORT
29 * libelf 0.8.x and earlier do not support ELF_C_READ_MMAP;
30 * for newer versions we can use mmap to reduce memory usage:
32 #ifdef HAVE_LIBELF_MMAP_SUPPORT
33 # define PERF_ELF_C_READ_MMAP ELF_C_READ_MMAP
35 # define PERF_ELF_C_READ_MMAP ELF_C_READ
38 #ifdef HAVE_LIBELF_SUPPORT
39 Elf_Scn
*elf_section_by_name(Elf
*elf
, GElf_Ehdr
*ep
,
40 GElf_Shdr
*shp
, const char *name
, size_t *idx
);
44 #define DMGL_NO_OPTS 0 /* For readability... */
45 #define DMGL_PARAMS (1 << 0) /* Include function args */
46 #define DMGL_ANSI (1 << 1) /* Include const, volatile, etc */
49 /** struct symbol - symtab entry
51 * @ignore - resolvable but tools ignore it (e.g. idle routines)
54 struct rb_node rb_node
;
68 void symbol__delete(struct symbol
*sym
);
69 void symbols__delete(struct rb_root_cached
*symbols
);
71 /* symbols__for_each_entry - iterate over symbols (rb_root)
73 * @symbols: the rb_root of symbols
74 * @pos: the 'struct symbol *' to use as a loop cursor
75 * @nd: the 'struct rb_node *' to use as a temporary storage
77 #define symbols__for_each_entry(symbols, pos, nd) \
78 for (nd = rb_first_cached(symbols); \
79 nd && (pos = rb_entry(nd, struct symbol, rb_node)); \
82 static inline size_t symbol__size(const struct symbol
*sym
)
84 return sym
->end
- sym
->start
;
90 struct symbol_name_rb_node
{
91 struct rb_node rb_node
;
95 static inline int __symbol__join_symfs(char *bf
, size_t size
, const char *path
)
97 return path__join(bf
, size
, symbol_conf
.symfs
, path
);
100 #define symbol__join_symfs(bf, path) __symbol__join_symfs(bf, sizeof(bf), path)
102 extern int vmlinux_path__nr_entries
;
103 extern char **vmlinux_path
;
105 static inline void *symbol__priv(struct symbol
*sym
)
107 return ((void *)sym
) - symbol_conf
.priv_size
;
110 struct ref_reloc_sym
{
113 u64 unrelocated_addr
;
117 struct addr_map_symbol from
;
118 struct addr_map_symbol to
;
119 struct branch_flags flags
;
125 struct addr_map_symbol iaddr
;
126 struct addr_map_symbol daddr
;
127 union perf_mem_data_src data_src
;
142 struct addr_location
{
143 struct machine
*machine
;
144 struct thread
*thread
;
159 enum dso_binary_type type
;
161 #ifdef HAVE_LIBELF_SUPPORT
181 void symsrc__destroy(struct symsrc
*ss
);
182 int symsrc__init(struct symsrc
*ss
, struct dso
*dso
, const char *name
,
183 enum dso_binary_type type
);
184 bool symsrc__has_symtab(struct symsrc
*ss
);
185 bool symsrc__possibly_runtime(struct symsrc
*ss
);
187 int dso__load(struct dso
*dso
, struct map
*map
);
188 int dso__load_vmlinux(struct dso
*dso
, struct map
*map
,
189 const char *vmlinux
, bool vmlinux_allocated
);
190 int dso__load_vmlinux_path(struct dso
*dso
, struct map
*map
);
191 int __dso__load_kallsyms(struct dso
*dso
, const char *filename
, struct map
*map
,
193 int dso__load_kallsyms(struct dso
*dso
, const char *filename
, struct map
*map
);
195 void dso__insert_symbol(struct dso
*dso
,
198 struct symbol
*dso__find_symbol(struct dso
*dso
, u64 addr
);
199 struct symbol
*dso__find_symbol_by_name(struct dso
*dso
, const char *name
);
201 struct symbol
*symbol__next_by_name(struct symbol
*sym
);
203 struct symbol
*dso__first_symbol(struct dso
*dso
);
204 struct symbol
*dso__last_symbol(struct dso
*dso
);
205 struct symbol
*dso__next_symbol(struct symbol
*sym
);
207 enum dso_type
dso__type_fd(int fd
);
209 int filename__read_build_id(const char *filename
, void *bf
, size_t size
);
210 int sysfs__read_build_id(const char *filename
, void *bf
, size_t size
);
211 int modules__parse(const char *filename
, void *arg
,
212 int (*process_module
)(void *arg
, const char *name
,
213 u64 start
, u64 size
));
214 int filename__read_debuglink(const char *filename
, char *debuglink
,
218 int symbol__init(struct perf_env
*env
);
219 void symbol__exit(void);
220 void symbol__elf_init(void);
221 int symbol__annotation_init(void);
223 struct symbol
*symbol__new(u64 start
, u64 len
, u8 binding
, u8 type
, const char *name
);
224 size_t __symbol__fprintf_symname_offs(const struct symbol
*sym
,
225 const struct addr_location
*al
,
226 bool unknown_as_addr
,
227 bool print_offsets
, FILE *fp
);
228 size_t symbol__fprintf_symname_offs(const struct symbol
*sym
,
229 const struct addr_location
*al
, FILE *fp
);
230 size_t __symbol__fprintf_symname(const struct symbol
*sym
,
231 const struct addr_location
*al
,
232 bool unknown_as_addr
, FILE *fp
);
233 size_t symbol__fprintf_symname(const struct symbol
*sym
, FILE *fp
);
234 size_t symbol__fprintf(struct symbol
*sym
, FILE *fp
);
235 bool symbol__restricted_filename(const char *filename
,
236 const char *restricted_filename
);
237 int symbol__config_symfs(const struct option
*opt __maybe_unused
,
238 const char *dir
, int unset __maybe_unused
);
240 int dso__load_sym(struct dso
*dso
, struct map
*map
, struct symsrc
*syms_ss
,
241 struct symsrc
*runtime_ss
, int kmodule
);
242 int dso__synthesize_plt_symbols(struct dso
*dso
, struct symsrc
*ss
);
244 char *dso__demangle_sym(struct dso
*dso
, int kmodule
, const char *elf_name
);
246 void __symbols__insert(struct rb_root_cached
*symbols
, struct symbol
*sym
,
248 void symbols__insert(struct rb_root_cached
*symbols
, struct symbol
*sym
);
249 void symbols__fixup_duplicate(struct rb_root_cached
*symbols
);
250 void symbols__fixup_end(struct rb_root_cached
*symbols
);
251 void map_groups__fixup_end(struct map_groups
*mg
);
253 typedef int (*mapfn_t
)(u64 start
, u64 len
, u64 pgoff
, void *data
);
254 int file__read_maps(int fd
, bool exe
, mapfn_t mapfn
, void *data
,
257 #define PERF_KCORE_EXTRACT "/tmp/perf-kcore-XXXXXX"
259 struct kcore_extract
{
260 char *kcore_filename
;
264 char extract_filename
[sizeof(PERF_KCORE_EXTRACT
)];
268 int kcore_extract__create(struct kcore_extract
*kce
);
269 void kcore_extract__delete(struct kcore_extract
*kce
);
271 int kcore_copy(const char *from_dir
, const char *to_dir
);
272 int compare_proc_modules(const char *from
, const char *to
);
274 int setup_list(struct strlist
**list
, const char *list_str
,
275 const char *list_name
);
276 int setup_intlist(struct intlist
**list
, const char *list_str
,
277 const char *list_name
);
279 #ifdef HAVE_LIBELF_SUPPORT
280 bool elf__needs_adjust_symbols(GElf_Ehdr ehdr
);
281 void arch__sym_update(struct symbol
*s
, GElf_Sym
*sym
);
284 const char *arch__normalize_symbol_name(const char *name
);
288 void arch__symbols__fixup_end(struct symbol
*p
, struct symbol
*c
);
289 int arch__compare_symbol_names(const char *namea
, const char *nameb
);
290 int arch__compare_symbol_names_n(const char *namea
, const char *nameb
,
292 int arch__choose_best_symbol(struct symbol
*syma
, struct symbol
*symb
);
294 enum symbol_tag_include
{
295 SYMBOL_TAG_INCLUDE__NONE
= 0,
296 SYMBOL_TAG_INCLUDE__DEFAULT_ONLY
299 int symbol__match_symbol_name(const char *namea
, const char *nameb
,
300 enum symbol_tag_include includes
);
302 /* structure containing an SDT note's info */
304 char *name
; /* name of the note*/
305 char *provider
; /* provider name */
307 bool bit32
; /* whether the location is 32 bits? */
308 union { /* location, base and semaphore addrs */
312 struct list_head note_list
; /* SDT notes' list */
315 int get_sdt_note_list(struct list_head
*head
, const char *target
);
316 int cleanup_sdt_note_list(struct list_head
*sdt_notes
);
317 int sdt_notes__get_count(struct list_head
*start
);
319 #define SDT_PROBES_SCN ".probes"
320 #define SDT_BASE_SCN ".stapsdt.base"
321 #define SDT_NOTE_SCN ".note.stapsdt"
322 #define SDT_NOTE_TYPE 3
323 #define SDT_NOTE_NAME "stapsdt"
327 SDT_NOTE_IDX_LOC
= 0,
332 struct mem_info
*mem_info__new(void);
333 struct mem_info
*mem_info__get(struct mem_info
*mi
);
334 void mem_info__put(struct mem_info
*mi
);
336 static inline void __mem_info__zput(struct mem_info
**mi
)
342 #define mem_info__zput(mi) __mem_info__zput(&mi)
344 struct block_info
*block_info__new(void);
345 struct block_info
*block_info__get(struct block_info
*bi
);
346 void block_info__put(struct block_info
*bi
);
348 static inline void __block_info__zput(struct block_info
**bi
)
350 block_info__put(*bi
);
354 #define block_info__zput(bi) __block_info__zput(&bi)
356 #endif /* __PERF_SYMBOL */