xref: /linux/tools/perf/util/map.c (revision 56d06fa29edd58c448766014afd833b7ff51247b)
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 	       !strncmp(filename, "/dev/zero", sizeof("/dev/zero") - 1) ||
30 	       !strncmp(filename, "/anon_hugepage", sizeof("/anon_hugepage") - 1);
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 __machine__kernel_map(map->groups->machine, 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 *maps__find_symbol_by_name(struct maps *maps, const char *name,
557 					 struct map **mapp, symbol_filter_t filter)
558 {
559 	struct symbol *sym;
560 	struct rb_node *nd;
561 
562 	pthread_rwlock_rdlock(&maps->lock);
563 
564 	for (nd = rb_first(&maps->entries); nd; nd = rb_next(nd)) {
565 		struct map *pos = rb_entry(nd, struct map, rb_node);
566 
567 		sym = map__find_symbol_by_name(pos, name, filter);
568 
569 		if (sym == NULL)
570 			continue;
571 		if (mapp != NULL)
572 			*mapp = pos;
573 		goto out;
574 	}
575 
576 	sym = NULL;
577 out:
578 	pthread_rwlock_unlock(&maps->lock);
579 	return sym;
580 }
581 
582 struct symbol *map_groups__find_symbol_by_name(struct map_groups *mg,
583 					       enum map_type type,
584 					       const char *name,
585 					       struct map **mapp,
586 					       symbol_filter_t filter)
587 {
588 	struct symbol *sym = maps__find_symbol_by_name(&mg->maps[type], name, mapp, filter);
589 
590 	return sym;
591 }
592 
593 int map_groups__find_ams(struct addr_map_symbol *ams, symbol_filter_t filter)
594 {
595 	if (ams->addr < ams->map->start || ams->addr >= ams->map->end) {
596 		if (ams->map->groups == NULL)
597 			return -1;
598 		ams->map = map_groups__find(ams->map->groups, ams->map->type,
599 					    ams->addr);
600 		if (ams->map == NULL)
601 			return -1;
602 	}
603 
604 	ams->al_addr = ams->map->map_ip(ams->map, ams->addr);
605 	ams->sym = map__find_symbol(ams->map, ams->al_addr, filter);
606 
607 	return ams->sym ? 0 : -1;
608 }
609 
610 static size_t maps__fprintf(struct maps *maps, FILE *fp)
611 {
612 	size_t printed = 0;
613 	struct rb_node *nd;
614 
615 	pthread_rwlock_rdlock(&maps->lock);
616 
617 	for (nd = rb_first(&maps->entries); nd; nd = rb_next(nd)) {
618 		struct map *pos = rb_entry(nd, struct map, rb_node);
619 		printed += fprintf(fp, "Map:");
620 		printed += map__fprintf(pos, fp);
621 		if (verbose > 2) {
622 			printed += dso__fprintf(pos->dso, pos->type, fp);
623 			printed += fprintf(fp, "--\n");
624 		}
625 	}
626 
627 	pthread_rwlock_unlock(&maps->lock);
628 
629 	return printed;
630 }
631 
632 size_t __map_groups__fprintf_maps(struct map_groups *mg, enum map_type type,
633 				  FILE *fp)
634 {
635 	size_t printed = fprintf(fp, "%s:\n", map_type__name[type]);
636 	return printed += maps__fprintf(&mg->maps[type], fp);
637 }
638 
639 size_t map_groups__fprintf(struct map_groups *mg, FILE *fp)
640 {
641 	size_t printed = 0, i;
642 	for (i = 0; i < MAP__NR_TYPES; ++i)
643 		printed += __map_groups__fprintf_maps(mg, i, fp);
644 	return printed;
645 }
646 
647 static void __map_groups__insert(struct map_groups *mg, struct map *map)
648 {
649 	__maps__insert(&mg->maps[map->type], map);
650 	map->groups = mg;
651 }
652 
653 static int maps__fixup_overlappings(struct maps *maps, struct map *map, FILE *fp)
654 {
655 	struct rb_root *root;
656 	struct rb_node *next;
657 	int err = 0;
658 
659 	pthread_rwlock_wrlock(&maps->lock);
660 
661 	root = &maps->entries;
662 	next = rb_first(root);
663 
664 	while (next) {
665 		struct map *pos = rb_entry(next, struct map, rb_node);
666 		next = rb_next(&pos->rb_node);
667 
668 		if (!map__overlap(pos, map))
669 			continue;
670 
671 		if (verbose >= 2) {
672 			fputs("overlapping maps:\n", fp);
673 			map__fprintf(map, fp);
674 			map__fprintf(pos, fp);
675 		}
676 
677 		rb_erase_init(&pos->rb_node, root);
678 		/*
679 		 * Now check if we need to create new maps for areas not
680 		 * overlapped by the new map:
681 		 */
682 		if (map->start > pos->start) {
683 			struct map *before = map__clone(pos);
684 
685 			if (before == NULL) {
686 				err = -ENOMEM;
687 				goto put_map;
688 			}
689 
690 			before->end = map->start;
691 			__map_groups__insert(pos->groups, before);
692 			if (verbose >= 2)
693 				map__fprintf(before, fp);
694 			map__put(before);
695 		}
696 
697 		if (map->end < pos->end) {
698 			struct map *after = map__clone(pos);
699 
700 			if (after == NULL) {
701 				err = -ENOMEM;
702 				goto put_map;
703 			}
704 
705 			after->start = map->end;
706 			__map_groups__insert(pos->groups, after);
707 			if (verbose >= 2)
708 				map__fprintf(after, fp);
709 			map__put(after);
710 		}
711 put_map:
712 		map__put(pos);
713 
714 		if (err)
715 			goto out;
716 	}
717 
718 	err = 0;
719 out:
720 	pthread_rwlock_unlock(&maps->lock);
721 	return err;
722 }
723 
724 int map_groups__fixup_overlappings(struct map_groups *mg, struct map *map,
725 				   FILE *fp)
726 {
727 	return maps__fixup_overlappings(&mg->maps[map->type], map, fp);
728 }
729 
730 /*
731  * XXX This should not really _copy_ te maps, but refcount them.
732  */
733 int map_groups__clone(struct map_groups *mg,
734 		      struct map_groups *parent, enum map_type type)
735 {
736 	int err = -ENOMEM;
737 	struct map *map;
738 	struct maps *maps = &parent->maps[type];
739 
740 	pthread_rwlock_rdlock(&maps->lock);
741 
742 	for (map = maps__first(maps); map; map = map__next(map)) {
743 		struct map *new = map__clone(map);
744 		if (new == NULL)
745 			goto out_unlock;
746 		map_groups__insert(mg, new);
747 		map__put(new);
748 	}
749 
750 	err = 0;
751 out_unlock:
752 	pthread_rwlock_unlock(&maps->lock);
753 	return err;
754 }
755 
756 static void __maps__insert(struct maps *maps, struct map *map)
757 {
758 	struct rb_node **p = &maps->entries.rb_node;
759 	struct rb_node *parent = NULL;
760 	const u64 ip = map->start;
761 	struct map *m;
762 
763 	while (*p != NULL) {
764 		parent = *p;
765 		m = rb_entry(parent, struct map, rb_node);
766 		if (ip < m->start)
767 			p = &(*p)->rb_left;
768 		else
769 			p = &(*p)->rb_right;
770 	}
771 
772 	rb_link_node(&map->rb_node, parent, p);
773 	rb_insert_color(&map->rb_node, &maps->entries);
774 	map__get(map);
775 }
776 
777 void maps__insert(struct maps *maps, struct map *map)
778 {
779 	pthread_rwlock_wrlock(&maps->lock);
780 	__maps__insert(maps, map);
781 	pthread_rwlock_unlock(&maps->lock);
782 }
783 
784 static void __maps__remove(struct maps *maps, struct map *map)
785 {
786 	rb_erase_init(&map->rb_node, &maps->entries);
787 	map__put(map);
788 }
789 
790 void maps__remove(struct maps *maps, struct map *map)
791 {
792 	pthread_rwlock_wrlock(&maps->lock);
793 	__maps__remove(maps, map);
794 	pthread_rwlock_unlock(&maps->lock);
795 }
796 
797 struct map *maps__find(struct maps *maps, u64 ip)
798 {
799 	struct rb_node **p, *parent = NULL;
800 	struct map *m;
801 
802 	pthread_rwlock_rdlock(&maps->lock);
803 
804 	p = &maps->entries.rb_node;
805 	while (*p != NULL) {
806 		parent = *p;
807 		m = rb_entry(parent, struct map, rb_node);
808 		if (ip < m->start)
809 			p = &(*p)->rb_left;
810 		else if (ip >= m->end)
811 			p = &(*p)->rb_right;
812 		else
813 			goto out;
814 	}
815 
816 	m = NULL;
817 out:
818 	pthread_rwlock_unlock(&maps->lock);
819 	return m;
820 }
821 
822 struct map *maps__first(struct maps *maps)
823 {
824 	struct rb_node *first = rb_first(&maps->entries);
825 
826 	if (first)
827 		return rb_entry(first, struct map, rb_node);
828 	return NULL;
829 }
830 
831 struct map *map__next(struct map *map)
832 {
833 	struct rb_node *next = rb_next(&map->rb_node);
834 
835 	if (next)
836 		return rb_entry(next, struct map, rb_node);
837 	return NULL;
838 }
839 
840 struct kmap *map__kmap(struct map *map)
841 {
842 	if (!map->dso || !map->dso->kernel) {
843 		pr_err("Internal error: map__kmap with a non-kernel map\n");
844 		return NULL;
845 	}
846 	return (struct kmap *)(map + 1);
847 }
848 
849 struct map_groups *map__kmaps(struct map *map)
850 {
851 	struct kmap *kmap = map__kmap(map);
852 
853 	if (!kmap || !kmap->kmaps) {
854 		pr_err("Internal error: map__kmaps with a non-kernel map\n");
855 		return NULL;
856 	}
857 	return kmap->kmaps;
858 }
859