xref: /linux/tools/perf/util/maps.h (revision bf4afc53b77aeaa48b5409da5c8da6bb4eff7f43)
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 <stdio.h>
7 #include <stdbool.h>
8 #include <linux/types.h>
9 
10 struct ref_reloc_sym;
11 struct machine;
12 struct map;
13 struct maps;
14 
15 #define KMAP_NAME_LEN 256
16 
17 struct kmap {
18 	struct ref_reloc_sym *ref_reloc_sym;
19 	struct maps	     *kmaps;
20 	char		     name[KMAP_NAME_LEN];
21 };
22 
23 struct maps *maps__new(struct machine *machine);
24 bool maps__empty(struct maps *maps);
25 int maps__copy_from(struct maps *maps, struct maps *parent);
26 
27 struct maps *maps__get(struct maps *maps);
28 void maps__put(struct maps *maps);
29 
30 static inline void __maps__zput(struct maps **map)
31 {
32 	maps__put(*map);
33 	*map = NULL;
34 }
35 
36 #define maps__zput(map) __maps__zput(&map)
37 
38 bool maps__equal(struct maps *a, struct maps *b);
39 
40 /* Iterate over map calling cb for each entry. */
41 int maps__for_each_map(struct maps *maps, int (*cb)(struct map *map, void *data), void *data);
42 /* Iterate over map removing an entry if cb returns true. */
43 void maps__remove_maps(struct maps *maps, bool (*cb)(struct map *map, void *data), void *data);
44 
45 struct machine *maps__machine(const struct maps *maps);
46 unsigned int maps__nr_maps(const struct maps *maps); /* Test only. */
47 refcount_t *maps__refcnt(struct maps *maps); /* Test only. */
48 
49 #ifdef HAVE_LIBUNWIND_SUPPORT
50 void *maps__addr_space(const struct maps *maps);
51 void maps__set_addr_space(struct maps *maps, void *addr_space);
52 const struct unwind_libunwind_ops *maps__unwind_libunwind_ops(const struct maps *maps);
53 void maps__set_unwind_libunwind_ops(struct maps *maps, const struct unwind_libunwind_ops *ops);
54 #endif
55 #ifdef HAVE_LIBDW_SUPPORT
56 void *maps__libdw_addr_space_dwfl(const struct maps *maps);
57 void maps__set_libdw_addr_space_dwfl(struct maps *maps, void *dwfl);
58 #endif
59 
60 size_t maps__fprintf(struct maps *maps, FILE *fp);
61 
62 int maps__insert(struct maps *maps, struct map *map);
63 void maps__remove(struct maps *maps, struct map *map);
64 
65 struct map *maps__find(struct maps *maps, u64 addr);
66 struct symbol *maps__find_symbol(struct maps *maps, u64 addr, struct map **mapp);
67 struct symbol *maps__find_symbol_by_name(struct maps *maps, const char *name, struct map **mapp);
68 
69 struct addr_map_symbol;
70 
71 int maps__find_ams(struct maps *maps, struct addr_map_symbol *ams);
72 
73 int maps__fixup_overlap_and_insert(struct maps *maps, struct map *new);
74 
75 struct map *maps__find_by_name(struct maps *maps, const char *name);
76 
77 struct map *maps__find_next_entry(struct maps *maps, struct map *map);
78 
79 int maps__merge_in(struct maps *kmaps, struct map *new_map);
80 
81 void maps__fixup_end(struct maps *maps);
82 
83 void maps__load_first(struct maps *maps);
84 
85 #endif // __PERF_MAPS_H
86