Linux Audio

Check our new training course

In-person Linux kernel drivers training

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