xref: /linux-6.15/tools/perf/util/map.c (revision 93df8a1e)
1 #include "symbol.h"
2 #include <errno.h>
3 #include <inttypes.h>
4 #include <limits.h>
5 #include <stdlib.h>
6 #include <string.h>
7 #include <stdio.h>
8 #include <unistd.h>
9 #include "map.h"
10 #include "thread.h"
11 #include "strlist.h"
12 #include "vdso.h"
13 #include "build-id.h"
14 #include "util.h"
15 #include "debug.h"
16 #include "machine.h"
17 #include <linux/string.h>
18 
19 static void __maps__insert(struct maps *maps, struct map *map);
20 
21 const char *map_type__name[MAP__NR_TYPES] = {
22 	[MAP__FUNCTION] = "Functions",
23 	[MAP__VARIABLE] = "Variables",
24 };
25 
26 static inline int is_anon_memory(const char *filename)
27 {
28 	return !strcmp(filename, "//anon") ||
29 	       !strcmp(filename, "/dev/zero (deleted)") ||
30 	       !strcmp(filename, "/anon_hugepage (deleted)");
31 }
32 
33 static inline int is_no_dso_memory(const char *filename)
34 {
35 	return !strncmp(filename, "[stack", 6) ||
36 	       !strncmp(filename, "/SYSV",5)   ||
37 	       !strcmp(filename, "[heap]");
38 }
39 
40 static inline int is_android_lib(const char *filename)
41 {
42 	return !strncmp(filename, "/data/app-lib", 13) ||
43 	       !strncmp(filename, "/system/lib", 11);
44 }
45 
46 static inline bool replace_android_lib(const char *filename, char *newfilename)
47 {
48 	const char *libname;
49 	char *app_abi;
50 	size_t app_abi_length, new_length;
51 	size_t lib_length = 0;
52 
53 	libname  = strrchr(filename, '/');
54 	if (libname)
55 		lib_length = strlen(libname);
56 
57 	app_abi = getenv("APP_ABI");
58 	if (!app_abi)
59 		return false;
60 
61 	app_abi_length = strlen(app_abi);
62 
63 	if (!strncmp(filename, "/data/app-lib", 13)) {
64 		char *apk_path;
65 
66 		if (!app_abi_length)
67 			return false;
68 
69 		new_length = 7 + app_abi_length + lib_length;
70 
71 		apk_path = getenv("APK_PATH");
72 		if (apk_path) {
73 			new_length += strlen(apk_path) + 1;
74 			if (new_length > PATH_MAX)
75 				return false;
76 			snprintf(newfilename, new_length,
77 				 "%s/libs/%s/%s", apk_path, app_abi, libname);
78 		} else {
79 			if (new_length > PATH_MAX)
80 				return false;
81 			snprintf(newfilename, new_length,
82 				 "libs/%s/%s", app_abi, libname);
83 		}
84 		return true;
85 	}
86 
87 	if (!strncmp(filename, "/system/lib/", 11)) {
88 		char *ndk, *app;
89 		const char *arch;
90 		size_t ndk_length;
91 		size_t app_length;
92 
93 		ndk = getenv("NDK_ROOT");
94 		app = getenv("APP_PLATFORM");
95 
96 		if (!(ndk && app))
97 			return false;
98 
99 		ndk_length = strlen(ndk);
100 		app_length = strlen(app);
101 
102 		if (!(ndk_length && app_length && app_abi_length))
103 			return false;
104 
105 		arch = !strncmp(app_abi, "arm", 3) ? "arm" :
106 		       !strncmp(app_abi, "mips", 4) ? "mips" :
107 		       !strncmp(app_abi, "x86", 3) ? "x86" : NULL;
108 
109 		if (!arch)
110 			return false;
111 
112 		new_length = 27 + ndk_length +
113 			     app_length + lib_length
114 			   + strlen(arch);
115 
116 		if (new_length > PATH_MAX)
117 			return false;
118 		snprintf(newfilename, new_length,
119 			"%s/platforms/%s/arch-%s/usr/lib/%s",
120 			ndk, app, arch, libname);
121 
122 		return true;
123 	}
124 	return false;
125 }
126 
127 void map__init(struct map *map, enum map_type type,
128 	       u64 start, u64 end, u64 pgoff, struct dso *dso)
129 {
130 	map->type     = type;
131 	map->start    = start;
132 	map->end      = end;
133 	map->pgoff    = pgoff;
134 	map->reloc    = 0;
135 	map->dso      = dso__get(dso);
136 	map->map_ip   = map__map_ip;
137 	map->unmap_ip = map__unmap_ip;
138 	RB_CLEAR_NODE(&map->rb_node);
139 	map->groups   = NULL;
140 	map->erange_warned = false;
141 	atomic_set(&map->refcnt, 1);
142 }
143 
144 struct map *map__new(struct machine *machine, u64 start, u64 len,
145 		     u64 pgoff, u32 pid, u32 d_maj, u32 d_min, u64 ino,
146 		     u64 ino_gen, u32 prot, u32 flags, char *filename,
147 		     enum map_type type, struct thread *thread)
148 {
149 	struct map *map = malloc(sizeof(*map));
150 
151 	if (map != NULL) {
152 		char newfilename[PATH_MAX];
153 		struct dso *dso;
154 		int anon, no_dso, vdso, android;
155 
156 		android = is_android_lib(filename);
157 		anon = is_anon_memory(filename);
158 		vdso = is_vdso_map(filename);
159 		no_dso = is_no_dso_memory(filename);
160 
161 		map->maj = d_maj;
162 		map->min = d_min;
163 		map->ino = ino;
164 		map->ino_generation = ino_gen;
165 		map->prot = prot;
166 		map->flags = flags;
167 
168 		if ((anon || no_dso) && type == MAP__FUNCTION) {
169 			snprintf(newfilename, sizeof(newfilename), "/tmp/perf-%d.map", pid);
170 			filename = newfilename;
171 		}
172 
173 		if (android) {
174 			if (replace_android_lib(filename, newfilename))
175 				filename = newfilename;
176 		}
177 
178 		if (vdso) {
179 			pgoff = 0;
180 			dso = machine__findnew_vdso(machine, thread);
181 		} else
182 			dso = machine__findnew_dso(machine, filename);
183 
184 		if (dso == NULL)
185 			goto out_delete;
186 
187 		map__init(map, type, start, start + len, pgoff, dso);
188 
189 		if (anon || no_dso) {
190 			map->map_ip = map->unmap_ip = identity__map_ip;
191 
192 			/*
193 			 * Set memory without DSO as loaded. All map__find_*
194 			 * functions still return NULL, and we avoid the
195 			 * unnecessary map__load warning.
196 			 */
197 			if (type != MAP__FUNCTION)
198 				dso__set_loaded(dso, map->type);
199 		}
200 		dso__put(dso);
201 	}
202 	return map;
203 out_delete:
204 	free(map);
205 	return NULL;
206 }
207 
208 /*
209  * Constructor variant for modules (where we know from /proc/modules where
210  * they are loaded) and for vmlinux, where only after we load all the
211  * symbols we'll know where it starts and ends.
212  */
213 struct map *map__new2(u64 start, struct dso *dso, enum map_type type)
214 {
215 	struct map *map = calloc(1, (sizeof(*map) +
216 				     (dso->kernel ? sizeof(struct kmap) : 0)));
217 	if (map != NULL) {
218 		/*
219 		 * ->end will be filled after we load all the symbols
220 		 */
221 		map__init(map, type, start, 0, 0, dso);
222 	}
223 
224 	return map;
225 }
226 
227 /*
228  * Use this and __map__is_kmodule() for map instances that are in
229  * machine->kmaps, and thus have map->groups->machine all properly set, to
230  * disambiguate between the kernel and modules.
231  *
232  * When the need arises, introduce map__is_{kernel,kmodule)() that
233  * checks (map->groups != NULL && map->groups->machine != NULL &&
234  * map->dso->kernel) before calling __map__is_{kernel,kmodule}())
235  */
236 bool __map__is_kernel(const struct map *map)
237 {
238 	return map->groups->machine->vmlinux_maps[map->type] == map;
239 }
240 
241 static void map__exit(struct map *map)
242 {
243 	BUG_ON(!RB_EMPTY_NODE(&map->rb_node));
244 	dso__zput(map->dso);
245 }
246 
247 void map__delete(struct map *map)
248 {
249 	map__exit(map);
250 	free(map);
251 }
252 
253 void map__put(struct map *map)
254 {
255 	if (map && atomic_dec_and_test(&map->refcnt))
256 		map__delete(map);
257 }
258 
259 void map__fixup_start(struct map *map)
260 {
261 	struct rb_root *symbols = &map->dso->symbols[map->type];
262 	struct rb_node *nd = rb_first(symbols);
263 	if (nd != NULL) {
264 		struct symbol *sym = rb_entry(nd, struct symbol, rb_node);
265 		map->start = sym->start;
266 	}
267 }
268 
269 void map__fixup_end(struct map *map)
270 {
271 	struct rb_root *symbols = &map->dso->symbols[map->type];
272 	struct rb_node *nd = rb_last(symbols);
273 	if (nd != NULL) {
274 		struct symbol *sym = rb_entry(nd, struct symbol, rb_node);
275 		map->end = sym->end;
276 	}
277 }
278 
279 #define DSO__DELETED "(deleted)"
280 
281 int map__load(struct map *map, symbol_filter_t filter)
282 {
283 	const char *name = map->dso->long_name;
284 	int nr;
285 
286 	if (dso__loaded(map->dso, map->type))
287 		return 0;
288 
289 	nr = dso__load(map->dso, map, filter);
290 	if (nr < 0) {
291 		if (map->dso->has_build_id) {
292 			char sbuild_id[BUILD_ID_SIZE * 2 + 1];
293 
294 			build_id__sprintf(map->dso->build_id,
295 					  sizeof(map->dso->build_id),
296 					  sbuild_id);
297 			pr_warning("%s with build id %s not found",
298 				   name, sbuild_id);
299 		} else
300 			pr_warning("Failed to open %s", name);
301 
302 		pr_warning(", continuing without symbols\n");
303 		return -1;
304 	} else if (nr == 0) {
305 #ifdef HAVE_LIBELF_SUPPORT
306 		const size_t len = strlen(name);
307 		const size_t real_len = len - sizeof(DSO__DELETED);
308 
309 		if (len > sizeof(DSO__DELETED) &&
310 		    strcmp(name + real_len + 1, DSO__DELETED) == 0) {
311 			pr_warning("%.*s was updated (is prelink enabled?). "
312 				"Restart the long running apps that use it!\n",
313 				   (int)real_len, name);
314 		} else {
315 			pr_warning("no symbols found in %s, maybe install "
316 				   "a debug package?\n", name);
317 		}
318 #endif
319 		return -1;
320 	}
321 
322 	return 0;
323 }
324 
325 int __weak arch__compare_symbol_names(const char *namea, const char *nameb)
326 {
327 	return strcmp(namea, nameb);
328 }
329 
330 struct symbol *map__find_symbol(struct map *map, u64 addr,
331 				symbol_filter_t filter)
332 {
333 	if (map__load(map, filter) < 0)
334 		return NULL;
335 
336 	return dso__find_symbol(map->dso, map->type, addr);
337 }
338 
339 struct symbol *map__find_symbol_by_name(struct map *map, const char *name,
340 					symbol_filter_t filter)
341 {
342 	if (map__load(map, filter) < 0)
343 		return NULL;
344 
345 	if (!dso__sorted_by_name(map->dso, map->type))
346 		dso__sort_by_name(map->dso, map->type);
347 
348 	return dso__find_symbol_by_name(map->dso, map->type, name);
349 }
350 
351 struct map *map__clone(struct map *map)
352 {
353 	return memdup(map, sizeof(*map));
354 }
355 
356 int map__overlap(struct map *l, struct map *r)
357 {
358 	if (l->start > r->start) {
359 		struct map *t = l;
360 		l = r;
361 		r = t;
362 	}
363 
364 	if (l->end > r->start)
365 		return 1;
366 
367 	return 0;
368 }
369 
370 size_t map__fprintf(struct map *map, FILE *fp)
371 {
372 	return fprintf(fp, " %" PRIx64 "-%" PRIx64 " %" PRIx64 " %s\n",
373 		       map->start, map->end, map->pgoff, map->dso->name);
374 }
375 
376 size_t map__fprintf_dsoname(struct map *map, FILE *fp)
377 {
378 	const char *dsoname = "[unknown]";
379 
380 	if (map && map->dso && (map->dso->name || map->dso->long_name)) {
381 		if (symbol_conf.show_kernel_path && map->dso->long_name)
382 			dsoname = map->dso->long_name;
383 		else if (map->dso->name)
384 			dsoname = map->dso->name;
385 	}
386 
387 	return fprintf(fp, "%s", dsoname);
388 }
389 
390 int map__fprintf_srcline(struct map *map, u64 addr, const char *prefix,
391 			 FILE *fp)
392 {
393 	char *srcline;
394 	int ret = 0;
395 
396 	if (map && map->dso) {
397 		srcline = get_srcline(map->dso,
398 				      map__rip_2objdump(map, addr), NULL, true);
399 		if (srcline != SRCLINE_UNKNOWN)
400 			ret = fprintf(fp, "%s%s", prefix, srcline);
401 		free_srcline(srcline);
402 	}
403 	return ret;
404 }
405 
406 /**
407  * map__rip_2objdump - convert symbol start address to objdump address.
408  * @map: memory map
409  * @rip: symbol start address
410  *
411  * objdump wants/reports absolute IPs for ET_EXEC, and RIPs for ET_DYN.
412  * map->dso->adjust_symbols==1 for ET_EXEC-like cases except ET_REL which is
413  * relative to section start.
414  *
415  * Return: Address suitable for passing to "objdump --start-address="
416  */
417 u64 map__rip_2objdump(struct map *map, u64 rip)
418 {
419 	if (!map->dso->adjust_symbols)
420 		return rip;
421 
422 	if (map->dso->rel)
423 		return rip - map->pgoff;
424 
425 	return map->unmap_ip(map, rip) - map->reloc;
426 }
427 
428 /**
429  * map__objdump_2mem - convert objdump address to a memory address.
430  * @map: memory map
431  * @ip: objdump address
432  *
433  * Closely related to map__rip_2objdump(), this function takes an address from
434  * objdump and converts it to a memory address.  Note this assumes that @map
435  * contains the address.  To be sure the result is valid, check it forwards
436  * e.g. map__rip_2objdump(map->map_ip(map, map__objdump_2mem(map, ip))) == ip
437  *
438  * Return: Memory address.
439  */
440 u64 map__objdump_2mem(struct map *map, u64 ip)
441 {
442 	if (!map->dso->adjust_symbols)
443 		return map->unmap_ip(map, ip);
444 
445 	if (map->dso->rel)
446 		return map->unmap_ip(map, ip + map->pgoff);
447 
448 	return ip + map->reloc;
449 }
450 
451 static void maps__init(struct maps *maps)
452 {
453 	maps->entries = RB_ROOT;
454 	pthread_rwlock_init(&maps->lock, NULL);
455 }
456 
457 void map_groups__init(struct map_groups *mg, struct machine *machine)
458 {
459 	int i;
460 	for (i = 0; i < MAP__NR_TYPES; ++i) {
461 		maps__init(&mg->maps[i]);
462 	}
463 	mg->machine = machine;
464 	atomic_set(&mg->refcnt, 1);
465 }
466 
467 static void __maps__purge(struct maps *maps)
468 {
469 	struct rb_root *root = &maps->entries;
470 	struct rb_node *next = rb_first(root);
471 
472 	while (next) {
473 		struct map *pos = rb_entry(next, struct map, rb_node);
474 
475 		next = rb_next(&pos->rb_node);
476 		rb_erase_init(&pos->rb_node, root);
477 		map__put(pos);
478 	}
479 }
480 
481 static void maps__exit(struct maps *maps)
482 {
483 	pthread_rwlock_wrlock(&maps->lock);
484 	__maps__purge(maps);
485 	pthread_rwlock_unlock(&maps->lock);
486 }
487 
488 void map_groups__exit(struct map_groups *mg)
489 {
490 	int i;
491 
492 	for (i = 0; i < MAP__NR_TYPES; ++i)
493 		maps__exit(&mg->maps[i]);
494 }
495 
496 bool map_groups__empty(struct map_groups *mg)
497 {
498 	int i;
499 
500 	for (i = 0; i < MAP__NR_TYPES; ++i) {
501 		if (maps__first(&mg->maps[i]))
502 			return false;
503 	}
504 
505 	return true;
506 }
507 
508 struct map_groups *map_groups__new(struct machine *machine)
509 {
510 	struct map_groups *mg = malloc(sizeof(*mg));
511 
512 	if (mg != NULL)
513 		map_groups__init(mg, machine);
514 
515 	return mg;
516 }
517 
518 void map_groups__delete(struct map_groups *mg)
519 {
520 	map_groups__exit(mg);
521 	free(mg);
522 }
523 
524 void map_groups__put(struct map_groups *mg)
525 {
526 	if (mg && atomic_dec_and_test(&mg->refcnt))
527 		map_groups__delete(mg);
528 }
529 
530 struct symbol *map_groups__find_symbol(struct map_groups *mg,
531 				       enum map_type type, u64 addr,
532 				       struct map **mapp,
533 				       symbol_filter_t filter)
534 {
535 	struct map *map = map_groups__find(mg, type, addr);
536 
537 	/* Ensure map is loaded before using map->map_ip */
538 	if (map != NULL && map__load(map, filter) >= 0) {
539 		if (mapp != NULL)
540 			*mapp = map;
541 		return map__find_symbol(map, map->map_ip(map, addr), filter);
542 	}
543 
544 	return NULL;
545 }
546 
547 struct symbol *map_groups__find_symbol_by_name(struct map_groups *mg,
548 					       enum map_type type,
549 					       const char *name,
550 					       struct map **mapp,
551 					       symbol_filter_t filter)
552 {
553 	struct maps *maps = &mg->maps[type];
554 	struct symbol *sym;
555 	struct rb_node *nd;
556 
557 	pthread_rwlock_rdlock(&maps->lock);
558 
559 	for (nd = rb_first(&maps->entries); nd; nd = rb_next(nd)) {
560 		struct map *pos = rb_entry(nd, struct map, rb_node);
561 
562 		sym = map__find_symbol_by_name(pos, name, filter);
563 
564 		if (sym == NULL)
565 			continue;
566 		if (mapp != NULL)
567 			*mapp = pos;
568 		goto out;
569 	}
570 
571 	sym = NULL;
572 out:
573 	pthread_rwlock_unlock(&maps->lock);
574 	return sym;
575 }
576 
577 int map_groups__find_ams(struct addr_map_symbol *ams, symbol_filter_t filter)
578 {
579 	if (ams->addr < ams->map->start || ams->addr >= ams->map->end) {
580 		if (ams->map->groups == NULL)
581 			return -1;
582 		ams->map = map_groups__find(ams->map->groups, ams->map->type,
583 					    ams->addr);
584 		if (ams->map == NULL)
585 			return -1;
586 	}
587 
588 	ams->al_addr = ams->map->map_ip(ams->map, ams->addr);
589 	ams->sym = map__find_symbol(ams->map, ams->al_addr, filter);
590 
591 	return ams->sym ? 0 : -1;
592 }
593 
594 static size_t maps__fprintf(struct maps *maps, FILE *fp)
595 {
596 	size_t printed = 0;
597 	struct rb_node *nd;
598 
599 	pthread_rwlock_rdlock(&maps->lock);
600 
601 	for (nd = rb_first(&maps->entries); nd; nd = rb_next(nd)) {
602 		struct map *pos = rb_entry(nd, struct map, rb_node);
603 		printed += fprintf(fp, "Map:");
604 		printed += map__fprintf(pos, fp);
605 		if (verbose > 2) {
606 			printed += dso__fprintf(pos->dso, pos->type, fp);
607 			printed += fprintf(fp, "--\n");
608 		}
609 	}
610 
611 	pthread_rwlock_unlock(&maps->lock);
612 
613 	return printed;
614 }
615 
616 size_t __map_groups__fprintf_maps(struct map_groups *mg, enum map_type type,
617 				  FILE *fp)
618 {
619 	size_t printed = fprintf(fp, "%s:\n", map_type__name[type]);
620 	return printed += maps__fprintf(&mg->maps[type], fp);
621 }
622 
623 size_t map_groups__fprintf(struct map_groups *mg, FILE *fp)
624 {
625 	size_t printed = 0, i;
626 	for (i = 0; i < MAP__NR_TYPES; ++i)
627 		printed += __map_groups__fprintf_maps(mg, i, fp);
628 	return printed;
629 }
630 
631 static int maps__fixup_overlappings(struct maps *maps, struct map *map, FILE *fp)
632 {
633 	struct rb_root *root;
634 	struct rb_node *next;
635 	int err = 0;
636 
637 	pthread_rwlock_wrlock(&maps->lock);
638 
639 	root = &maps->entries;
640 	next = rb_first(root);
641 
642 	while (next) {
643 		struct map *pos = rb_entry(next, struct map, rb_node);
644 		next = rb_next(&pos->rb_node);
645 
646 		if (!map__overlap(pos, map))
647 			continue;
648 
649 		if (verbose >= 2) {
650 			fputs("overlapping maps:\n", fp);
651 			map__fprintf(map, fp);
652 			map__fprintf(pos, fp);
653 		}
654 
655 		rb_erase_init(&pos->rb_node, root);
656 		/*
657 		 * Now check if we need to create new maps for areas not
658 		 * overlapped by the new map:
659 		 */
660 		if (map->start > pos->start) {
661 			struct map *before = map__clone(pos);
662 
663 			if (before == NULL) {
664 				err = -ENOMEM;
665 				goto put_map;
666 			}
667 
668 			before->end = map->start;
669 			__maps__insert(maps, before);
670 			if (verbose >= 2)
671 				map__fprintf(before, fp);
672 		}
673 
674 		if (map->end < pos->end) {
675 			struct map *after = map__clone(pos);
676 
677 			if (after == NULL) {
678 				err = -ENOMEM;
679 				goto put_map;
680 			}
681 
682 			after->start = map->end;
683 			__maps__insert(maps, after);
684 			if (verbose >= 2)
685 				map__fprintf(after, fp);
686 		}
687 put_map:
688 		map__put(pos);
689 
690 		if (err)
691 			goto out;
692 	}
693 
694 	err = 0;
695 out:
696 	pthread_rwlock_unlock(&maps->lock);
697 	return err;
698 }
699 
700 int map_groups__fixup_overlappings(struct map_groups *mg, struct map *map,
701 				   FILE *fp)
702 {
703 	return maps__fixup_overlappings(&mg->maps[map->type], map, fp);
704 }
705 
706 /*
707  * XXX This should not really _copy_ te maps, but refcount them.
708  */
709 int map_groups__clone(struct map_groups *mg,
710 		      struct map_groups *parent, enum map_type type)
711 {
712 	int err = -ENOMEM;
713 	struct map *map;
714 	struct maps *maps = &parent->maps[type];
715 
716 	pthread_rwlock_rdlock(&maps->lock);
717 
718 	for (map = maps__first(maps); map; map = map__next(map)) {
719 		struct map *new = map__clone(map);
720 		if (new == NULL)
721 			goto out_unlock;
722 		map_groups__insert(mg, new);
723 	}
724 
725 	err = 0;
726 out_unlock:
727 	pthread_rwlock_unlock(&maps->lock);
728 	return err;
729 }
730 
731 static void __maps__insert(struct maps *maps, struct map *map)
732 {
733 	struct rb_node **p = &maps->entries.rb_node;
734 	struct rb_node *parent = NULL;
735 	const u64 ip = map->start;
736 	struct map *m;
737 
738 	while (*p != NULL) {
739 		parent = *p;
740 		m = rb_entry(parent, struct map, rb_node);
741 		if (ip < m->start)
742 			p = &(*p)->rb_left;
743 		else
744 			p = &(*p)->rb_right;
745 	}
746 
747 	rb_link_node(&map->rb_node, parent, p);
748 	rb_insert_color(&map->rb_node, &maps->entries);
749 	map__get(map);
750 }
751 
752 void maps__insert(struct maps *maps, struct map *map)
753 {
754 	pthread_rwlock_wrlock(&maps->lock);
755 	__maps__insert(maps, map);
756 	pthread_rwlock_unlock(&maps->lock);
757 }
758 
759 static void __maps__remove(struct maps *maps, struct map *map)
760 {
761 	rb_erase_init(&map->rb_node, &maps->entries);
762 	map__put(map);
763 }
764 
765 void maps__remove(struct maps *maps, struct map *map)
766 {
767 	pthread_rwlock_wrlock(&maps->lock);
768 	__maps__remove(maps, map);
769 	pthread_rwlock_unlock(&maps->lock);
770 }
771 
772 struct map *maps__find(struct maps *maps, u64 ip)
773 {
774 	struct rb_node **p, *parent = NULL;
775 	struct map *m;
776 
777 	pthread_rwlock_rdlock(&maps->lock);
778 
779 	p = &maps->entries.rb_node;
780 	while (*p != NULL) {
781 		parent = *p;
782 		m = rb_entry(parent, struct map, rb_node);
783 		if (ip < m->start)
784 			p = &(*p)->rb_left;
785 		else if (ip >= m->end)
786 			p = &(*p)->rb_right;
787 		else
788 			goto out;
789 	}
790 
791 	m = NULL;
792 out:
793 	pthread_rwlock_unlock(&maps->lock);
794 	return m;
795 }
796 
797 struct map *maps__first(struct maps *maps)
798 {
799 	struct rb_node *first = rb_first(&maps->entries);
800 
801 	if (first)
802 		return rb_entry(first, struct map, rb_node);
803 	return NULL;
804 }
805 
806 struct map *map__next(struct map *map)
807 {
808 	struct rb_node *next = rb_next(&map->rb_node);
809 
810 	if (next)
811 		return rb_entry(next, struct map, rb_node);
812 	return NULL;
813 }
814 
815 struct kmap *map__kmap(struct map *map)
816 {
817 	if (!map->dso || !map->dso->kernel) {
818 		pr_err("Internal error: map__kmap with a non-kernel map\n");
819 		return NULL;
820 	}
821 	return (struct kmap *)(map + 1);
822 }
823 
824 struct map_groups *map__kmaps(struct map *map)
825 {
826 	struct kmap *kmap = map__kmap(map);
827 
828 	if (!kmap || !kmap->kmaps) {
829 		pr_err("Internal error: map__kmaps with a non-kernel map\n");
830 		return NULL;
831 	}
832 	return kmap->kmaps;
833 }
834