linux/tools/perf/util/symbol.h
<<
>>
Prefs
   1#ifndef __PERF_SYMBOL
   2#define __PERF_SYMBOL 1
   3
   4#include <linux/types.h>
   5#include <stdbool.h>
   6#include <stdint.h>
   7#include "map.h"
   8#include "../perf.h"
   9#include <linux/list.h>
  10#include <linux/rbtree.h>
  11#include <stdio.h>
  12#include <byteswap.h>
  13#include <libgen.h>
  14#include "build-id.h"
  15#include "event.h"
  16#include "path.h"
  17
  18#ifdef HAVE_LIBELF_SUPPORT
  19#include <libelf.h>
  20#include <gelf.h>
  21#endif
  22#include <elf.h>
  23
  24#include "dso.h"
  25
  26/*
  27 * libelf 0.8.x and earlier do not support ELF_C_READ_MMAP;
  28 * for newer versions we can use mmap to reduce memory usage:
  29 */
  30#ifdef HAVE_LIBELF_MMAP_SUPPORT
  31# define PERF_ELF_C_READ_MMAP ELF_C_READ_MMAP
  32#else
  33# define PERF_ELF_C_READ_MMAP ELF_C_READ
  34#endif
  35
  36#ifdef HAVE_LIBELF_SUPPORT
  37Elf_Scn *elf_section_by_name(Elf *elf, GElf_Ehdr *ep,
  38                             GElf_Shdr *shp, const char *name, size_t *idx);
  39#endif
  40
  41#ifndef DMGL_PARAMS
  42#define DMGL_NO_OPTS     0              /* For readability... */
  43#define DMGL_PARAMS      (1 << 0)       /* Include function args */
  44#define DMGL_ANSI        (1 << 1)       /* Include const, volatile, etc */
  45#endif
  46
  47#define DSO__NAME_KALLSYMS      "[kernel.kallsyms]"
  48#define DSO__NAME_KCORE         "[kernel.kcore]"
  49
  50/** struct symbol - symtab entry
  51 *
  52 * @ignore - resolvable but tools ignore it (e.g. idle routines)
  53 */
  54struct symbol {
  55        struct rb_node  rb_node;
  56        u64             start;
  57        u64             end;
  58        u16             namelen;
  59        u8              binding;
  60        u8              idle:1;
  61        u8              ignore:1;
  62        u8              arch_sym;
  63        char            name[0];
  64};
  65
  66void symbol__delete(struct symbol *sym);
  67void symbols__delete(struct rb_root *symbols);
  68
  69/* symbols__for_each_entry - iterate over symbols (rb_root)
  70 *
  71 * @symbols: the rb_root of symbols
  72 * @pos: the 'struct symbol *' to use as a loop cursor
  73 * @nd: the 'struct rb_node *' to use as a temporary storage
  74 */
  75#define symbols__for_each_entry(symbols, pos, nd)                       \
  76        for (nd = rb_first(symbols);                                    \
  77             nd && (pos = rb_entry(nd, struct symbol, rb_node));        \
  78             nd = rb_next(nd))
  79
  80static inline size_t symbol__size(const struct symbol *sym)
  81{
  82        return sym->end - sym->start;
  83}
  84
  85struct strlist;
  86struct intlist;
  87
  88struct symbol_conf {
  89        unsigned short  priv_size;
  90        unsigned short  nr_events;
  91        bool            try_vmlinux_path,
  92                        init_annotation,
  93                        force,
  94                        ignore_vmlinux,
  95                        ignore_vmlinux_buildid,
  96                        show_kernel_path,
  97                        use_modules,
  98                        allow_aliases,
  99                        sort_by_name,
 100                        show_nr_samples,
 101                        show_total_period,
 102                        use_callchain,
 103                        cumulate_callchain,
 104                        show_branchflag_count,
 105                        exclude_other,
 106                        show_cpu_utilization,
 107                        initialized,
 108                        kptr_restrict,
 109                        annotate_asm_raw,
 110                        annotate_src,
 111                        event_group,
 112                        demangle,
 113                        demangle_kernel,
 114                        filter_relative,
 115                        show_hist_headers,
 116                        branch_callstack,
 117                        has_filter,
 118                        show_ref_callgraph,
 119                        hide_unresolved,
 120                        raw_trace,
 121                        report_hierarchy,
 122                        inline_name;
 123        const char      *vmlinux_name,
 124                        *kallsyms_name,
 125                        *source_prefix,
 126                        *field_sep;
 127        const char      *default_guest_vmlinux_name,
 128                        *default_guest_kallsyms,
 129                        *default_guest_modules;
 130        const char      *guestmount;
 131        const char      *dso_list_str,
 132                        *comm_list_str,
 133                        *pid_list_str,
 134                        *tid_list_str,
 135                        *sym_list_str,
 136                        *col_width_list_str,
 137                        *bt_stop_list_str;
 138       struct strlist   *dso_list,
 139                        *comm_list,
 140                        *sym_list,
 141                        *dso_from_list,
 142                        *dso_to_list,
 143                        *sym_from_list,
 144                        *sym_to_list,
 145                        *bt_stop_list;
 146        struct intlist  *pid_list,
 147                        *tid_list;
 148        const char      *symfs;
 149};
 150
 151extern struct symbol_conf symbol_conf;
 152
 153struct symbol_name_rb_node {
 154        struct rb_node  rb_node;
 155        struct symbol   sym;
 156};
 157
 158static inline int __symbol__join_symfs(char *bf, size_t size, const char *path)
 159{
 160        return path__join(bf, size, symbol_conf.symfs, path);
 161}
 162
 163#define symbol__join_symfs(bf, path) __symbol__join_symfs(bf, sizeof(bf), path)
 164
 165extern int vmlinux_path__nr_entries;
 166extern char **vmlinux_path;
 167
 168static inline void *symbol__priv(struct symbol *sym)
 169{
 170        return ((void *)sym) - symbol_conf.priv_size;
 171}
 172
 173struct ref_reloc_sym {
 174        const char      *name;
 175        u64             addr;
 176        u64             unrelocated_addr;
 177};
 178
 179struct map_symbol {
 180        struct map    *map;
 181        struct symbol *sym;
 182};
 183
 184struct addr_map_symbol {
 185        struct map    *map;
 186        struct symbol *sym;
 187        u64           addr;
 188        u64           al_addr;
 189};
 190
 191struct branch_info {
 192        struct addr_map_symbol from;
 193        struct addr_map_symbol to;
 194        struct branch_flags flags;
 195        char                    *srcline_from;
 196        char                    *srcline_to;
 197};
 198
 199struct mem_info {
 200        struct addr_map_symbol iaddr;
 201        struct addr_map_symbol daddr;
 202        union perf_mem_data_src data_src;
 203};
 204
 205struct addr_location {
 206        struct machine *machine;
 207        struct thread *thread;
 208        struct map    *map;
 209        struct symbol *sym;
 210        u64           addr;
 211        char          level;
 212        u8            filtered;
 213        u8            cpumode;
 214        s32           cpu;
 215        s32           socket;
 216};
 217
 218struct symsrc {
 219        char *name;
 220        int fd;
 221        enum dso_binary_type type;
 222
 223#ifdef HAVE_LIBELF_SUPPORT
 224        Elf *elf;
 225        GElf_Ehdr ehdr;
 226
 227        Elf_Scn *opdsec;
 228        size_t opdidx;
 229        GElf_Shdr opdshdr;
 230
 231        Elf_Scn *symtab;
 232        GElf_Shdr symshdr;
 233
 234        Elf_Scn *dynsym;
 235        size_t dynsym_idx;
 236        GElf_Shdr dynshdr;
 237
 238        bool adjust_symbols;
 239        bool is_64_bit;
 240#endif
 241};
 242
 243void symsrc__destroy(struct symsrc *ss);
 244int symsrc__init(struct symsrc *ss, struct dso *dso, const char *name,
 245                 enum dso_binary_type type);
 246bool symsrc__has_symtab(struct symsrc *ss);
 247bool symsrc__possibly_runtime(struct symsrc *ss);
 248
 249int dso__load(struct dso *dso, struct map *map);
 250int dso__load_vmlinux(struct dso *dso, struct map *map,
 251                      const char *vmlinux, bool vmlinux_allocated);
 252int dso__load_vmlinux_path(struct dso *dso, struct map *map);
 253int __dso__load_kallsyms(struct dso *dso, const char *filename, struct map *map,
 254                         bool no_kcore);
 255int dso__load_kallsyms(struct dso *dso, const char *filename, struct map *map);
 256
 257void dso__insert_symbol(struct dso *dso, enum map_type type,
 258                        struct symbol *sym);
 259
 260struct symbol *dso__find_symbol(struct dso *dso, enum map_type type,
 261                                u64 addr);
 262struct symbol *dso__find_symbol_by_name(struct dso *dso, enum map_type type,
 263                                        const char *name);
 264struct symbol *symbol__next_by_name(struct symbol *sym);
 265
 266struct symbol *dso__first_symbol(struct dso *dso, enum map_type type);
 267struct symbol *dso__last_symbol(struct dso *dso, enum map_type type);
 268struct symbol *dso__next_symbol(struct symbol *sym);
 269
 270enum dso_type dso__type_fd(int fd);
 271
 272int filename__read_build_id(const char *filename, void *bf, size_t size);
 273int sysfs__read_build_id(const char *filename, void *bf, size_t size);
 274int modules__parse(const char *filename, void *arg,
 275                   int (*process_module)(void *arg, const char *name,
 276                                         u64 start));
 277int filename__read_debuglink(const char *filename, char *debuglink,
 278                             size_t size);
 279
 280struct perf_env;
 281int symbol__init(struct perf_env *env);
 282void symbol__exit(void);
 283void symbol__elf_init(void);
 284int symbol__annotation_init(void);
 285
 286struct symbol *symbol__new(u64 start, u64 len, u8 binding, const char *name);
 287size_t __symbol__fprintf_symname_offs(const struct symbol *sym,
 288                                      const struct addr_location *al,
 289                                      bool unknown_as_addr,
 290                                      bool print_offsets, FILE *fp);
 291size_t symbol__fprintf_symname_offs(const struct symbol *sym,
 292                                    const struct addr_location *al, FILE *fp);
 293size_t __symbol__fprintf_symname(const struct symbol *sym,
 294                                 const struct addr_location *al,
 295                                 bool unknown_as_addr, FILE *fp);
 296size_t symbol__fprintf_symname(const struct symbol *sym, FILE *fp);
 297size_t symbol__fprintf(struct symbol *sym, FILE *fp);
 298bool symbol_type__is_a(char symbol_type, enum map_type map_type);
 299bool symbol__restricted_filename(const char *filename,
 300                                 const char *restricted_filename);
 301int symbol__config_symfs(const struct option *opt __maybe_unused,
 302                         const char *dir, int unset __maybe_unused);
 303
 304int dso__load_sym(struct dso *dso, struct map *map, struct symsrc *syms_ss,
 305                  struct symsrc *runtime_ss, int kmodule);
 306int dso__synthesize_plt_symbols(struct dso *dso, struct symsrc *ss,
 307                                struct map *map);
 308
 309char *dso__demangle_sym(struct dso *dso, int kmodule, char *elf_name);
 310
 311void __symbols__insert(struct rb_root *symbols, struct symbol *sym, bool kernel);
 312void symbols__insert(struct rb_root *symbols, struct symbol *sym);
 313void symbols__fixup_duplicate(struct rb_root *symbols);
 314void symbols__fixup_end(struct rb_root *symbols);
 315void __map_groups__fixup_end(struct map_groups *mg, enum map_type type);
 316
 317typedef int (*mapfn_t)(u64 start, u64 len, u64 pgoff, void *data);
 318int file__read_maps(int fd, bool exe, mapfn_t mapfn, void *data,
 319                    bool *is_64_bit);
 320
 321#define PERF_KCORE_EXTRACT "/tmp/perf-kcore-XXXXXX"
 322
 323struct kcore_extract {
 324        char *kcore_filename;
 325        u64 addr;
 326        u64 offs;
 327        u64 len;
 328        char extract_filename[sizeof(PERF_KCORE_EXTRACT)];
 329        int fd;
 330};
 331
 332int kcore_extract__create(struct kcore_extract *kce);
 333void kcore_extract__delete(struct kcore_extract *kce);
 334
 335int kcore_copy(const char *from_dir, const char *to_dir);
 336int compare_proc_modules(const char *from, const char *to);
 337
 338int setup_list(struct strlist **list, const char *list_str,
 339               const char *list_name);
 340int setup_intlist(struct intlist **list, const char *list_str,
 341                  const char *list_name);
 342
 343#ifdef HAVE_LIBELF_SUPPORT
 344bool elf__needs_adjust_symbols(GElf_Ehdr ehdr);
 345void arch__sym_update(struct symbol *s, GElf_Sym *sym);
 346#endif
 347
 348#define SYMBOL_A 0
 349#define SYMBOL_B 1
 350
 351int arch__compare_symbol_names(const char *namea, const char *nameb);
 352int arch__compare_symbol_names_n(const char *namea, const char *nameb,
 353                                 unsigned int n);
 354int arch__choose_best_symbol(struct symbol *syma, struct symbol *symb);
 355
 356enum symbol_tag_include {
 357        SYMBOL_TAG_INCLUDE__NONE = 0,
 358        SYMBOL_TAG_INCLUDE__DEFAULT_ONLY
 359};
 360
 361int symbol__match_symbol_name(const char *namea, const char *nameb,
 362                              enum symbol_tag_include includes);
 363
 364/* structure containing an SDT note's info */
 365struct sdt_note {
 366        char *name;                     /* name of the note*/
 367        char *provider;                 /* provider name */
 368        char *args;
 369        bool bit32;                     /* whether the location is 32 bits? */
 370        union {                         /* location, base and semaphore addrs */
 371                Elf64_Addr a64[3];
 372                Elf32_Addr a32[3];
 373        } addr;
 374        struct list_head note_list;     /* SDT notes' list */
 375};
 376
 377int get_sdt_note_list(struct list_head *head, const char *target);
 378int cleanup_sdt_note_list(struct list_head *sdt_notes);
 379int sdt_notes__get_count(struct list_head *start);
 380
 381#define SDT_BASE_SCN ".stapsdt.base"
 382#define SDT_NOTE_SCN  ".note.stapsdt"
 383#define SDT_NOTE_TYPE 3
 384#define SDT_NOTE_NAME "stapsdt"
 385#define NR_ADDR 3
 386
 387#endif /* __PERF_SYMBOL */
 388