]> git.kernelconcepts.de Git - karo-tx-linux.git/blob - tools/perf/util/map.c
Merge tag 'platform-drivers-x86-v4.3-1' of git://git.infradead.org/users/dvhart/linux...
[karo-tx-linux.git] / tools / perf / util / map.c
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 }