xref: /openbmc/linux/tools/perf/util/map.c (revision 552b8b36)
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 *from)
352 {
353 	struct map *map = memdup(from, sizeof(*map));
354 
355 	if (map != NULL) {
356 		atomic_set(&map->refcnt, 1);
357 		RB_CLEAR_NODE(&map->rb_node);
358 		dso__get(map->dso);
359 		map->groups = NULL;
360 	}
361 
362 	return map;
363 }
364 
365 int map__overlap(struct map *l, struct map *r)
366 {
367 	if (l->start > r->start) {
368 		struct map *t = l;
369 		l = r;
370 		r = t;
371 	}
372 
373 	if (l->end > r->start)
374 		return 1;
375 
376 	return 0;
377 }
378 
379 size_t map__fprintf(struct map *map, FILE *fp)
380 {
381 	return fprintf(fp, " %" PRIx64 "-%" PRIx64 " %" PRIx64 " %s\n",
382 		       map->start, map->end, map->pgoff, map->dso->name);
383 }
384 
385 size_t map__fprintf_dsoname(struct map *map, FILE *fp)
386 {
387 	const char *dsoname = "[unknown]";
388 
389 	if (map && map->dso && (map->dso->name || map->dso->long_name)) {
390 		if (symbol_conf.show_kernel_path && map->dso->long_name)
391 			dsoname = map->dso->long_name;
392 		else if (map->dso->name)
393 			dsoname = map->dso->name;
394 	}
395 
396 	return fprintf(fp, "%s", dsoname);
397 }
398 
399 int map__fprintf_srcline(struct map *map, u64 addr, const char *prefix,
400 			 FILE *fp)
401 {
402 	char *srcline;
403 	int ret = 0;
404 
405 	if (map && map->dso) {
406 		srcline = get_srcline(map->dso,
407 				      map__rip_2objdump(map, addr), NULL, true);
408 		if (srcline != SRCLINE_UNKNOWN)
409 			ret = fprintf(fp, "%s%s", prefix, srcline);
410 		free_srcline(srcline);
411 	}
412 	return ret;
413 }
414 
415 /**
416  * map__rip_2objdump - convert symbol start address to objdump address.
417  * @map: memory map
418  * @rip: symbol start address
419  *
420  * objdump wants/reports absolute IPs for ET_EXEC, and RIPs for ET_DYN.
421  * map->dso->adjust_symbols==1 for ET_EXEC-like cases except ET_REL which is
422  * relative to section start.
423  *
424  * Return: Address suitable for passing to "objdump --start-address="
425  */
426 u64 map__rip_2objdump(struct map *map, u64 rip)
427 {
428 	if (!map->dso->adjust_symbols)
429 		return rip;
430 
431 	if (map->dso->rel)
432 		return rip - map->pgoff;
433 
434 	return map->unmap_ip(map, rip) - map->reloc;
435 }
436 
437 /**
438  * map__objdump_2mem - convert objdump address to a memory address.
439  * @map: memory map
440  * @ip: objdump address
441  *
442  * Closely related to map__rip_2objdump(), this function takes an address from
443  * objdump and converts it to a memory address.  Note this assumes that @map
444  * contains the address.  To be sure the result is valid, check it forwards
445  * e.g. map__rip_2objdump(map->map_ip(map, map__objdump_2mem(map, ip))) == ip
446  *
447  * Return: Memory address.
448  */
449 u64 map__objdump_2mem(struct map *map, u64 ip)
450 {
451 	if (!map->dso->adjust_symbols)
452 		return map->unmap_ip(map, ip);
453 
454 	if (map->dso->rel)
455 		return map->unmap_ip(map, ip + map->pgoff);
456 
457 	return ip + map->reloc;
458 }
459 
460 static void maps__init(struct maps *maps)
461 {
462 	maps->entries = RB_ROOT;
463 	pthread_rwlock_init(&maps->lock, NULL);
464 }
465 
466 void map_groups__init(struct map_groups *mg, struct machine *machine)
467 {
468 	int i;
469 	for (i = 0; i < MAP__NR_TYPES; ++i) {
470 		maps__init(&mg->maps[i]);
471 	}
472 	mg->machine = machine;
473 	atomic_set(&mg->refcnt, 1);
474 }
475 
476 static void __maps__purge(struct maps *maps)
477 {
478 	struct rb_root *root = &maps->entries;
479 	struct rb_node *next = rb_first(root);
480 
481 	while (next) {
482 		struct map *pos = rb_entry(next, struct map, rb_node);
483 
484 		next = rb_next(&pos->rb_node);
485 		rb_erase_init(&pos->rb_node, root);
486 		map__put(pos);
487 	}
488 }
489 
490 static void maps__exit(struct maps *maps)
491 {
492 	pthread_rwlock_wrlock(&maps->lock);
493 	__maps__purge(maps);
494 	pthread_rwlock_unlock(&maps->lock);
495 }
496 
497 void map_groups__exit(struct map_groups *mg)
498 {
499 	int i;
500 
501 	for (i = 0; i < MAP__NR_TYPES; ++i)
502 		maps__exit(&mg->maps[i]);
503 }
504 
505 bool map_groups__empty(struct map_groups *mg)
506 {
507 	int i;
508 
509 	for (i = 0; i < MAP__NR_TYPES; ++i) {
510 		if (maps__first(&mg->maps[i]))
511 			return false;
512 	}
513 
514 	return true;
515 }
516 
517 struct map_groups *map_groups__new(struct machine *machine)
518 {
519 	struct map_groups *mg = malloc(sizeof(*mg));
520 
521 	if (mg != NULL)
522 		map_groups__init(mg, machine);
523 
524 	return mg;
525 }
526 
527 void map_groups__delete(struct map_groups *mg)
528 {
529 	map_groups__exit(mg);
530 	free(mg);
531 }
532 
533 void map_groups__put(struct map_groups *mg)
534 {
535 	if (mg && atomic_dec_and_test(&mg->refcnt))
536 		map_groups__delete(mg);
537 }
538 
539 struct symbol *map_groups__find_symbol(struct map_groups *mg,
540 				       enum map_type type, u64 addr,
541 				       struct map **mapp,
542 				       symbol_filter_t filter)
543 {
544 	struct map *map = map_groups__find(mg, type, addr);
545 
546 	/* Ensure map is loaded before using map->map_ip */
547 	if (map != NULL && map__load(map, filter) >= 0) {
548 		if (mapp != NULL)
549 			*mapp = map;
550 		return map__find_symbol(map, map->map_ip(map, addr), filter);
551 	}
552 
553 	return NULL;
554 }
555 
556 struct symbol *map_groups__find_symbol_by_name(struct map_groups *mg,
557 					       enum map_type type,
558 					       const char *name,
559 					       struct map **mapp,
560 					       symbol_filter_t filter)
561 {
562 	struct maps *maps = &mg->maps[type];
563 	struct symbol *sym;
564 	struct rb_node *nd;
565 
566 	pthread_rwlock_rdlock(&maps->lock);
567 
568 	for (nd = rb_first(&maps->entries); nd; nd = rb_next(nd)) {
569 		struct map *pos = rb_entry(nd, struct map, rb_node);
570 
571 		sym = map__find_symbol_by_name(pos, name, filter);
572 
573 		if (sym == NULL)
574 			continue;
575 		if (mapp != NULL)
576 			*mapp = pos;
577 		goto out;
578 	}
579 
580 	sym = NULL;
581 out:
582 	pthread_rwlock_unlock(&maps->lock);
583 	return sym;
584 }
585 
586 int map_groups__find_ams(struct addr_map_symbol *ams, symbol_filter_t filter)
587 {
588 	if (ams->addr < ams->map->start || ams->addr >= ams->map->end) {
589 		if (ams->map->groups == NULL)
590 			return -1;
591 		ams->map = map_groups__find(ams->map->groups, ams->map->type,
592 					    ams->addr);
593 		if (ams->map == NULL)
594 			return -1;
595 	}
596 
597 	ams->al_addr = ams->map->map_ip(ams->map, ams->addr);
598 	ams->sym = map__find_symbol(ams->map, ams->al_addr, filter);
599 
600 	return ams->sym ? 0 : -1;
601 }
602 
603 static size_t maps__fprintf(struct maps *maps, FILE *fp)
604 {
605 	size_t printed = 0;
606 	struct rb_node *nd;
607 
608 	pthread_rwlock_rdlock(&maps->lock);
609 
610 	for (nd = rb_first(&maps->entries); nd; nd = rb_next(nd)) {
611 		struct map *pos = rb_entry(nd, struct map, rb_node);
612 		printed += fprintf(fp, "Map:");
613 		printed += map__fprintf(pos, fp);
614 		if (verbose > 2) {
615 			printed += dso__fprintf(pos->dso, pos->type, fp);
616 			printed += fprintf(fp, "--\n");
617 		}
618 	}
619 
620 	pthread_rwlock_unlock(&maps->lock);
621 
622 	return printed;
623 }
624 
625 size_t __map_groups__fprintf_maps(struct map_groups *mg, enum map_type type,
626 				  FILE *fp)
627 {
628 	size_t printed = fprintf(fp, "%s:\n", map_type__name[type]);
629 	return printed += maps__fprintf(&mg->maps[type], fp);
630 }
631 
632 size_t map_groups__fprintf(struct map_groups *mg, FILE *fp)
633 {
634 	size_t printed = 0, i;
635 	for (i = 0; i < MAP__NR_TYPES; ++i)
636 		printed += __map_groups__fprintf_maps(mg, i, fp);
637 	return printed;
638 }
639 
640 static int maps__fixup_overlappings(struct maps *maps, struct map *map, FILE *fp)
641 {
642 	struct rb_root *root;
643 	struct rb_node *next;
644 	int err = 0;
645 
646 	pthread_rwlock_wrlock(&maps->lock);
647 
648 	root = &maps->entries;
649 	next = rb_first(root);
650 
651 	while (next) {
652 		struct map *pos = rb_entry(next, struct map, rb_node);
653 		next = rb_next(&pos->rb_node);
654 
655 		if (!map__overlap(pos, map))
656 			continue;
657 
658 		if (verbose >= 2) {
659 			fputs("overlapping maps:\n", fp);
660 			map__fprintf(map, fp);
661 			map__fprintf(pos, fp);
662 		}
663 
664 		rb_erase_init(&pos->rb_node, root);
665 		/*
666 		 * Now check if we need to create new maps for areas not
667 		 * overlapped by the new map:
668 		 */
669 		if (map->start > pos->start) {
670 			struct map *before = map__clone(pos);
671 
672 			if (before == NULL) {
673 				err = -ENOMEM;
674 				goto put_map;
675 			}
676 
677 			before->end = map->start;
678 			__maps__insert(maps, before);
679 			if (verbose >= 2)
680 				map__fprintf(before, fp);
681 		}
682 
683 		if (map->end < pos->end) {
684 			struct map *after = map__clone(pos);
685 
686 			if (after == NULL) {
687 				err = -ENOMEM;
688 				goto put_map;
689 			}
690 
691 			after->start = map->end;
692 			__maps__insert(maps, after);
693 			if (verbose >= 2)
694 				map__fprintf(after, fp);
695 		}
696 put_map:
697 		map__put(pos);
698 
699 		if (err)
700 			goto out;
701 	}
702 
703 	err = 0;
704 out:
705 	pthread_rwlock_unlock(&maps->lock);
706 	return err;
707 }
708 
709 int map_groups__fixup_overlappings(struct map_groups *mg, struct map *map,
710 				   FILE *fp)
711 {
712 	return maps__fixup_overlappings(&mg->maps[map->type], map, fp);
713 }
714 
715 /*
716  * XXX This should not really _copy_ te maps, but refcount them.
717  */
718 int map_groups__clone(struct map_groups *mg,
719 		      struct map_groups *parent, enum map_type type)
720 {
721 	int err = -ENOMEM;
722 	struct map *map;
723 	struct maps *maps = &parent->maps[type];
724 
725 	pthread_rwlock_rdlock(&maps->lock);
726 
727 	for (map = maps__first(maps); map; map = map__next(map)) {
728 		struct map *new = map__clone(map);
729 		if (new == NULL)
730 			goto out_unlock;
731 		map_groups__insert(mg, new);
732 	}
733 
734 	err = 0;
735 out_unlock:
736 	pthread_rwlock_unlock(&maps->lock);
737 	return err;
738 }
739 
740 static void __maps__insert(struct maps *maps, struct map *map)
741 {
742 	struct rb_node **p = &maps->entries.rb_node;
743 	struct rb_node *parent = NULL;
744 	const u64 ip = map->start;
745 	struct map *m;
746 
747 	while (*p != NULL) {
748 		parent = *p;
749 		m = rb_entry(parent, struct map, rb_node);
750 		if (ip < m->start)
751 			p = &(*p)->rb_left;
752 		else
753 			p = &(*p)->rb_right;
754 	}
755 
756 	rb_link_node(&map->rb_node, parent, p);
757 	rb_insert_color(&map->rb_node, &maps->entries);
758 	map__get(map);
759 }
760 
761 void maps__insert(struct maps *maps, struct map *map)
762 {
763 	pthread_rwlock_wrlock(&maps->lock);
764 	__maps__insert(maps, map);
765 	pthread_rwlock_unlock(&maps->lock);
766 }
767 
768 static void __maps__remove(struct maps *maps, struct map *map)
769 {
770 	rb_erase_init(&map->rb_node, &maps->entries);
771 	map__put(map);
772 }
773 
774 void maps__remove(struct maps *maps, struct map *map)
775 {
776 	pthread_rwlock_wrlock(&maps->lock);
777 	__maps__remove(maps, map);
778 	pthread_rwlock_unlock(&maps->lock);
779 }
780 
781 struct map *maps__find(struct maps *maps, u64 ip)
782 {
783 	struct rb_node **p, *parent = NULL;
784 	struct map *m;
785 
786 	pthread_rwlock_rdlock(&maps->lock);
787 
788 	p = &maps->entries.rb_node;
789 	while (*p != NULL) {
790 		parent = *p;
791 		m = rb_entry(parent, struct map, rb_node);
792 		if (ip < m->start)
793 			p = &(*p)->rb_left;
794 		else if (ip >= m->end)
795 			p = &(*p)->rb_right;
796 		else
797 			goto out;
798 	}
799 
800 	m = NULL;
801 out:
802 	pthread_rwlock_unlock(&maps->lock);
803 	return m;
804 }
805 
806 struct map *maps__first(struct maps *maps)
807 {
808 	struct rb_node *first = rb_first(&maps->entries);
809 
810 	if (first)
811 		return rb_entry(first, struct map, rb_node);
812 	return NULL;
813 }
814 
815 struct map *map__next(struct map *map)
816 {
817 	struct rb_node *next = rb_next(&map->rb_node);
818 
819 	if (next)
820 		return rb_entry(next, struct map, rb_node);
821 	return NULL;
822 }
823 
824 struct kmap *map__kmap(struct map *map)
825 {
826 	if (!map->dso || !map->dso->kernel) {
827 		pr_err("Internal error: map__kmap with a non-kernel map\n");
828 		return NULL;
829 	}
830 	return (struct kmap *)(map + 1);
831 }
832 
833 struct map_groups *map__kmaps(struct map *map)
834 {
835 	struct kmap *kmap = map__kmap(map);
836 
837 	if (!kmap || !kmap->kmaps) {
838 		pr_err("Internal error: map__kmaps with a non-kernel map\n");
839 		return NULL;
840 	}
841 	return kmap->kmaps;
842 }
843