xref: /linux/tools/perf/util/map.h (revision 4c62e9764ab403d42f9b8871b1241fe7812f19d4)
1 #ifndef __PERF_MAP_H
2 #define __PERF_MAP_H
3 
4 #include <linux/compiler.h>
5 #include <linux/list.h>
6 #include <linux/rbtree.h>
7 #include <stdio.h>
8 #include <stdbool.h>
9 #include "types.h"
10 
11 enum map_type {
12 	MAP__FUNCTION = 0,
13 	MAP__VARIABLE,
14 };
15 
16 #define MAP__NR_TYPES (MAP__VARIABLE + 1)
17 
18 extern const char *map_type__name[MAP__NR_TYPES];
19 
20 struct dso;
21 struct ip_callchain;
22 struct ref_reloc_sym;
23 struct map_groups;
24 struct machine;
25 struct perf_evsel;
26 
27 struct map {
28 	union {
29 		struct rb_node	rb_node;
30 		struct list_head node;
31 	};
32 	u64			start;
33 	u64			end;
34 	u8 /* enum map_type */	type;
35 	bool			referenced;
36 	bool			erange_warned;
37 	u32			priv;
38 	u64			pgoff;
39 
40 	/* ip -> dso rip */
41 	u64			(*map_ip)(struct map *, u64);
42 	/* dso rip -> ip */
43 	u64			(*unmap_ip)(struct map *, u64);
44 
45 	struct dso		*dso;
46 	struct map_groups	*groups;
47 };
48 
49 struct kmap {
50 	struct ref_reloc_sym	*ref_reloc_sym;
51 	struct map_groups	*kmaps;
52 };
53 
54 struct map_groups {
55 	struct rb_root	 maps[MAP__NR_TYPES];
56 	struct list_head removed_maps[MAP__NR_TYPES];
57 	struct machine	 *machine;
58 };
59 
60 static inline struct kmap *map__kmap(struct map *self)
61 {
62 	return (struct kmap *)(self + 1);
63 }
64 
65 static inline u64 map__map_ip(struct map *map, u64 ip)
66 {
67 	return ip - map->start + map->pgoff;
68 }
69 
70 static inline u64 map__unmap_ip(struct map *map, u64 ip)
71 {
72 	return ip + map->start - map->pgoff;
73 }
74 
75 static inline u64 identity__map_ip(struct map *map __maybe_unused, u64 ip)
76 {
77 	return ip;
78 }
79 
80 
81 /* rip/ip <-> addr suitable for passing to `objdump --start-address=` */
82 u64 map__rip_2objdump(struct map *map, u64 rip);
83 
84 struct symbol;
85 
86 typedef int (*symbol_filter_t)(struct map *map, struct symbol *sym);
87 
88 void map__init(struct map *self, enum map_type type,
89 	       u64 start, u64 end, u64 pgoff, struct dso *dso);
90 struct map *map__new(struct list_head *dsos__list, u64 start, u64 len,
91 		     u64 pgoff, u32 pid, char *filename,
92 		     enum map_type type);
93 struct map *map__new2(u64 start, struct dso *dso, enum map_type type);
94 void map__delete(struct map *self);
95 struct map *map__clone(struct map *self);
96 int map__overlap(struct map *l, struct map *r);
97 size_t map__fprintf(struct map *self, FILE *fp);
98 size_t map__fprintf_dsoname(struct map *map, FILE *fp);
99 
100 int map__load(struct map *self, symbol_filter_t filter);
101 struct symbol *map__find_symbol(struct map *self,
102 				u64 addr, symbol_filter_t filter);
103 struct symbol *map__find_symbol_by_name(struct map *self, const char *name,
104 					symbol_filter_t filter);
105 void map__fixup_start(struct map *self);
106 void map__fixup_end(struct map *self);
107 
108 void map__reloc_vmlinux(struct map *self);
109 
110 size_t __map_groups__fprintf_maps(struct map_groups *mg,
111 				  enum map_type type, int verbose, FILE *fp);
112 void maps__insert(struct rb_root *maps, struct map *map);
113 void maps__remove(struct rb_root *maps, struct map *map);
114 struct map *maps__find(struct rb_root *maps, u64 addr);
115 void map_groups__init(struct map_groups *mg);
116 void map_groups__exit(struct map_groups *mg);
117 int map_groups__clone(struct map_groups *mg,
118 		      struct map_groups *parent, enum map_type type);
119 size_t map_groups__fprintf(struct map_groups *mg, int verbose, FILE *fp);
120 size_t map_groups__fprintf_maps(struct map_groups *mg, int verbose, FILE *fp);
121 
122 int maps__set_kallsyms_ref_reloc_sym(struct map **maps, const char *symbol_name,
123 				     u64 addr);
124 
125 static inline void map_groups__insert(struct map_groups *mg, struct map *map)
126 {
127 	maps__insert(&mg->maps[map->type], map);
128 	map->groups = mg;
129 }
130 
131 static inline void map_groups__remove(struct map_groups *mg, struct map *map)
132 {
133 	maps__remove(&mg->maps[map->type], map);
134 }
135 
136 static inline struct map *map_groups__find(struct map_groups *mg,
137 					   enum map_type type, u64 addr)
138 {
139 	return maps__find(&mg->maps[type], addr);
140 }
141 
142 struct symbol *map_groups__find_symbol(struct map_groups *mg,
143 				       enum map_type type, u64 addr,
144 				       struct map **mapp,
145 				       symbol_filter_t filter);
146 
147 struct symbol *map_groups__find_symbol_by_name(struct map_groups *mg,
148 					       enum map_type type,
149 					       const char *name,
150 					       struct map **mapp,
151 					       symbol_filter_t filter);
152 
153 static inline
154 struct symbol *map_groups__find_function_by_name(struct map_groups *mg,
155 						 const char *name, struct map **mapp,
156 						 symbol_filter_t filter)
157 {
158 	return map_groups__find_symbol_by_name(mg, MAP__FUNCTION, name, mapp, filter);
159 }
160 
161 int map_groups__fixup_overlappings(struct map_groups *mg, struct map *map,
162 				   int verbose, FILE *fp);
163 
164 struct map *map_groups__find_by_name(struct map_groups *mg,
165 				     enum map_type type, const char *name);
166 
167 void map_groups__flush(struct map_groups *mg);
168 
169 #endif /* __PERF_MAP_H */
170