tools/perf/util/maps.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef __PERF_MAPS_H
   3 #define __PERF_MAPS_H
   4
   5 #include <linux/refcount.h>
   6 #include <linux/rbtree.h>
   7 #include <stdio.h>
   8 #include <stdbool.h>
   9 #include <linux/types.h>
  10 #include "rwsem.h"
  11
  12 struct ref_reloc_sym;
  13 struct machine;
  14 struct map;
  15 struct maps;
  16 struct thread;
  17
  18 struct map *maps__find(struct maps *maps, u64 addr);
  19 struct map *maps__first(struct maps *maps);
  20 struct map *map__next(struct map *map);
  21
  22 #define maps__for_each_entry(maps, map) \
  23         for (map = maps__first(maps); map; map = map__next(map))
  24
  25 #define maps__for_each_entry_safe(maps, map, next) \
  26         for (map = maps__first(maps), next = map__next(map); map; map = next, next = map__next(map))
  27
  28 struct maps {
  29         struct rb_root      entries;
  30         struct rw_semaphore lock;
  31         struct machine   *machine;
  32         struct map       *last_search_by_name;
  33         struct map       **maps_by_name;
  34         refcount_t       refcnt;
  35         unsigned int     nr_maps;
  36         unsigned int     nr_maps_allocated;
  37 #ifdef HAVE_LIBUNWIND_SUPPORT
  38         void                            *addr_space;
  39         struct unwind_libunwind_ops     *unwind_libunwind_ops;
  40 #endif
  41 };
  42
  43 #define KMAP_NAME_LEN 256
  44
  45 struct kmap {
  46         struct ref_reloc_sym *ref_reloc_sym;
  47         struct maps          *kmaps;
  48         char                 name[KMAP_NAME_LEN];
  49 };
  50
  51 struct maps *maps__new(struct machine *machine);
  52 void maps__delete(struct maps *maps);
  53 bool maps__empty(struct maps *maps);
  54
  55 static inline struct maps *maps__get(struct maps *maps)
  56 {
  57         if (maps)
  58                 refcount_inc(&maps->refcnt);
  59         return maps;
  60 }
  61
  62 void maps__put(struct maps *maps);
  63 void maps__init(struct maps *maps, struct machine *machine);
  64 void maps__exit(struct maps *maps);
  65 int maps__clone(struct thread *thread, struct maps *parent);
  66 size_t maps__fprintf(struct maps *maps, FILE *fp);
  67
  68 void maps__insert(struct maps *maps, struct map *map);
  69
  70 void maps__remove(struct maps *maps, struct map *map);
  71
  72 struct symbol *maps__find_symbol(struct maps *maps, u64 addr, struct map **mapp);
  73 struct symbol *maps__find_symbol_by_name(struct maps *maps, const char *name, struct map **mapp);
  74
  75 struct addr_map_symbol;
  76
  77 int maps__find_ams(struct maps *maps, struct addr_map_symbol *ams);
  78
  79 int maps__fixup_overlappings(struct maps *maps, struct map *map, FILE *fp);
  80
  81 struct map *maps__find_by_name(struct maps *maps, const char *name);
  82
  83 int maps__merge_in(struct maps *kmaps, struct map *new_map);
  84
  85 void __maps__sort_by_name(struct maps *maps);
  86
  87 #endif // __PERF_MAPS_H