1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef __PERF_MAP_H 3 #define __PERF_MAP_H 4 5 #include <linux/refcount.h> 6 #include <linux/compiler.h> 7 #include <linux/list.h> 8 #include <linux/rbtree.h> 9 #include <stdio.h> 10 #include <string.h> 11 #include <stdbool.h> 12 #include <linux/types.h> 13 #include <internal/rc_check.h> 14 15 struct dso; 16 struct maps; 17 struct machine; 18 19 enum mapping_type { 20 /* map__map_ip/map__unmap_ip are given as offsets in the DSO. */ 21 MAPPING_TYPE__DSO, 22 /* map__map_ip/map__unmap_ip are just the given ip value. */ 23 MAPPING_TYPE__IDENTITY, 24 }; 25 26 DECLARE_RC_STRUCT(map) { 27 u64 start; 28 u64 end; 29 u64 pgoff; 30 u64 reloc; 31 struct dso *dso; 32 refcount_t refcnt; 33 u32 prot; 34 u32 flags; 35 enum mapping_type mapping_type:8; 36 bool erange_warned; 37 bool priv; 38 bool hit; 39 }; 40 41 struct kmap; 42 43 struct kmap *__map__kmap(struct map *map); 44 struct kmap *map__kmap(struct map *map); 45 struct maps *map__kmaps(struct map *map); 46 47 static inline struct dso *map__dso(const struct map *map) 48 { 49 return RC_CHK_ACCESS(map)->dso; 50 } 51 52 static inline u64 map__start(const struct map *map) 53 { 54 return RC_CHK_ACCESS(map)->start; 55 } 56 57 static inline u64 map__end(const struct map *map) 58 { 59 return RC_CHK_ACCESS(map)->end; 60 } 61 62 static inline u64 map__pgoff(const struct map *map) 63 { 64 return RC_CHK_ACCESS(map)->pgoff; 65 } 66 67 static inline u64 map__reloc(const struct map *map) 68 { 69 return RC_CHK_ACCESS(map)->reloc; 70 } 71 72 static inline u32 map__flags(const struct map *map) 73 { 74 return RC_CHK_ACCESS(map)->flags; 75 } 76 77 static inline u32 map__prot(const struct map *map) 78 { 79 return RC_CHK_ACCESS(map)->prot; 80 } 81 82 static inline bool map__priv(const struct map *map) 83 { 84 return RC_CHK_ACCESS(map)->priv; 85 } 86 87 static inline bool map__hit(const struct map *map) 88 { 89 return RC_CHK_ACCESS(map)->hit; 90 } 91 92 static inline refcount_t *map__refcnt(struct map *map) 93 { 94 return &RC_CHK_ACCESS(map)->refcnt; 95 } 96 97 static inline bool map__erange_warned(struct map *map) 98 { 99 return RC_CHK_ACCESS(map)->erange_warned; 100 } 101 102 static inline size_t map__size(const struct map *map) 103 { 104 return map__end(map) - map__start(map); 105 } 106 107 /* ip -> dso rip */ 108 static inline u64 map__dso_map_ip(const struct map *map, u64 ip) 109 { 110 return ip - map__start(map) + map__pgoff(map); 111 } 112 113 /* dso rip -> ip */ 114 static inline u64 map__dso_unmap_ip(const struct map *map, u64 rip) 115 { 116 return rip + map__start(map) - map__pgoff(map); 117 } 118 119 static inline u64 map__map_ip(const struct map *map, u64 ip_or_rip) 120 { 121 if ((RC_CHK_ACCESS(map)->mapping_type) == MAPPING_TYPE__DSO) 122 return map__dso_map_ip(map, ip_or_rip); 123 else 124 return ip_or_rip; 125 } 126 127 static inline u64 map__unmap_ip(const struct map *map, u64 ip_or_rip) 128 { 129 if ((RC_CHK_ACCESS(map)->mapping_type) == MAPPING_TYPE__DSO) 130 return map__dso_unmap_ip(map, ip_or_rip); 131 else 132 return ip_or_rip; 133 } 134 135 /* rip/ip <-> addr suitable for passing to `objdump --start-address=` */ 136 u64 map__rip_2objdump(struct map *map, u64 rip); 137 138 /* objdump address -> memory address */ 139 u64 map__objdump_2mem(struct map *map, u64 ip); 140 141 /* objdump address -> rip */ 142 u64 map__objdump_2rip(struct map *map, u64 ip); 143 144 struct symbol; 145 struct thread; 146 147 /* map__for_each_symbol - iterate over the symbols in the given map 148 * 149 * @map: the 'struct map *' in which symbols are iterated 150 * @pos: the 'struct symbol *' to use as a loop cursor 151 * @n: the 'struct rb_node *' to use as a temporary storage 152 * Note: caller must ensure map->dso is not NULL (map is loaded). 153 */ 154 #define map__for_each_symbol(map, pos, n) \ 155 dso__for_each_symbol(map__dso(map), pos, n) 156 157 /* map__for_each_symbol_with_name - iterate over the symbols in the given map 158 * that have the given name 159 * 160 * @map: the 'struct map *' in which symbols are iterated 161 * @sym_name: the symbol name 162 * @pos: the 'struct symbol *' to use as a loop cursor 163 * @idx: the cursor index in the symbol names array 164 */ 165 #define __map__for_each_symbol_by_name(map, sym_name, pos, idx) \ 166 for (pos = map__find_symbol_by_name_idx(map, sym_name, &idx); \ 167 pos && \ 168 !symbol__match_symbol_name(pos->name, sym_name, \ 169 SYMBOL_TAG_INCLUDE__DEFAULT_ONLY); \ 170 pos = dso__next_symbol_by_name(map__dso(map), &idx)) 171 172 #define map__for_each_symbol_by_name(map, sym_name, pos, idx) \ 173 __map__for_each_symbol_by_name(map, sym_name, (pos), idx) 174 175 struct dso_id; 176 177 struct map *map__new(struct machine *machine, u64 start, u64 len, 178 u64 pgoff, const struct dso_id *id, u32 prot, u32 flags, 179 char *filename, struct thread *thread); 180 struct map *map__new2(u64 start, struct dso *dso); 181 void map__delete(struct map *map); 182 struct map *map__clone(struct map *map); 183 184 static inline struct map *map__get(struct map *map) 185 { 186 struct map *result; 187 188 if (RC_CHK_GET(result, map)) 189 refcount_inc(map__refcnt(map)); 190 191 return result; 192 } 193 194 void map__put(struct map *map); 195 196 static inline void __map__zput(struct map **map) 197 { 198 map__put(*map); 199 *map = NULL; 200 } 201 202 #define map__zput(map) __map__zput(&map) 203 204 size_t map__fprintf(struct map *map, FILE *fp); 205 size_t map__fprintf_dsoname(struct map *map, FILE *fp); 206 size_t map__fprintf_dsoname_dsoff(struct map *map, bool print_off, u64 addr, FILE *fp); 207 char *map__srcline(struct map *map, u64 addr, struct symbol *sym); 208 int map__fprintf_srcline(struct map *map, u64 addr, const char *prefix, 209 FILE *fp); 210 211 int map__load(struct map *map); 212 struct symbol *map__find_symbol(struct map *map, u64 addr); 213 struct symbol *map__find_symbol_by_name(struct map *map, const char *name); 214 struct symbol *map__find_symbol_by_name_idx(struct map *map, const char *name, size_t *idx); 215 void map__fixup_start(struct map *map); 216 void map__fixup_end(struct map *map); 217 218 int map__set_kallsyms_ref_reloc_sym(struct map *map, const char *symbol_name, 219 u64 addr); 220 221 bool __map__is_kernel(const struct map *map); 222 bool __map__is_extra_kernel_map(const struct map *map); 223 bool __map__is_bpf_prog(const struct map *map); 224 bool __map__is_bpf_image(const struct map *map); 225 bool __map__is_ool(const struct map *map); 226 227 static inline bool __map__is_kmodule(const struct map *map) 228 { 229 return !__map__is_kernel(map) && !__map__is_extra_kernel_map(map) && 230 !__map__is_bpf_prog(map) && !__map__is_ool(map) && 231 !__map__is_bpf_image(map); 232 } 233 234 bool map__has_symbols(const struct map *map); 235 236 bool map__contains_symbol(const struct map *map, const struct symbol *sym); 237 238 #define ENTRY_TRAMPOLINE_NAME "__entry_SYSCALL_64_trampoline" 239 240 static inline bool is_entry_trampoline(const char *name) 241 { 242 return !strcmp(name, ENTRY_TRAMPOLINE_NAME); 243 } 244 245 static inline bool is_bpf_image(const char *name) 246 { 247 return strncmp(name, "bpf_trampoline_", sizeof("bpf_trampoline_") - 1) == 0 || 248 strncmp(name, "bpf_dispatcher_", sizeof("bpf_dispatcher_") - 1) == 0; 249 } 250 251 static inline int is_anon_memory(const char *filename) 252 { 253 return !strcmp(filename, "//anon") || 254 !strncmp(filename, "/dev/zero", sizeof("/dev/zero") - 1) || 255 !strncmp(filename, "/anon_hugepage", sizeof("/anon_hugepage") - 1); 256 } 257 258 static inline int is_no_dso_memory(const char *filename) 259 { 260 return !strncmp(filename, "[stack", 6) || 261 !strncmp(filename, "/SYSV", 5) || 262 !strcmp(filename, "[heap]"); 263 } 264 265 static inline void map__set_start(struct map *map, u64 start) 266 { 267 RC_CHK_ACCESS(map)->start = start; 268 } 269 270 static inline void map__set_end(struct map *map, u64 end) 271 { 272 RC_CHK_ACCESS(map)->end = end; 273 } 274 275 static inline void map__set_pgoff(struct map *map, u64 pgoff) 276 { 277 RC_CHK_ACCESS(map)->pgoff = pgoff; 278 } 279 280 static inline void map__add_pgoff(struct map *map, u64 inc) 281 { 282 RC_CHK_ACCESS(map)->pgoff += inc; 283 } 284 285 static inline void map__set_reloc(struct map *map, u64 reloc) 286 { 287 RC_CHK_ACCESS(map)->reloc = reloc; 288 } 289 290 static inline void map__set_priv(struct map *map) 291 { 292 RC_CHK_ACCESS(map)->priv = true; 293 } 294 295 static inline void map__set_hit(struct map *map) 296 { 297 RC_CHK_ACCESS(map)->hit = true; 298 } 299 300 static inline void map__set_erange_warned(struct map *map) 301 { 302 RC_CHK_ACCESS(map)->erange_warned = true; 303 } 304 305 static inline void map__set_dso(struct map *map, struct dso *dso) 306 { 307 RC_CHK_ACCESS(map)->dso = dso; 308 } 309 310 static inline void map__set_mapping_type(struct map *map, enum mapping_type type) 311 { 312 RC_CHK_ACCESS(map)->mapping_type = type; 313 } 314 315 static inline enum mapping_type map__mapping_type(struct map *map) 316 { 317 return RC_CHK_ACCESS(map)->mapping_type; 318 } 319 #endif /* __PERF_MAP_H */ 320