Linux Audio

Check our new training course

Loading...
Note: File does not exist in v3.5.6.
   1#include <asm/bug.h>
   2#include <sys/time.h>
   3#include <sys/resource.h>
   4#include "symbol.h"
   5#include "dso.h"
   6#include "machine.h"
   7#include "auxtrace.h"
   8#include "util.h"
   9#include "debug.h"
  10
  11char dso__symtab_origin(const struct dso *dso)
  12{
  13	static const char origin[] = {
  14		[DSO_BINARY_TYPE__KALLSYMS]			= 'k',
  15		[DSO_BINARY_TYPE__VMLINUX]			= 'v',
  16		[DSO_BINARY_TYPE__JAVA_JIT]			= 'j',
  17		[DSO_BINARY_TYPE__DEBUGLINK]			= 'l',
  18		[DSO_BINARY_TYPE__BUILD_ID_CACHE]		= 'B',
  19		[DSO_BINARY_TYPE__FEDORA_DEBUGINFO]		= 'f',
  20		[DSO_BINARY_TYPE__UBUNTU_DEBUGINFO]		= 'u',
  21		[DSO_BINARY_TYPE__OPENEMBEDDED_DEBUGINFO]	= 'o',
  22		[DSO_BINARY_TYPE__BUILDID_DEBUGINFO]		= 'b',
  23		[DSO_BINARY_TYPE__SYSTEM_PATH_DSO]		= 'd',
  24		[DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE]		= 'K',
  25		[DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE_COMP]	= 'm',
  26		[DSO_BINARY_TYPE__GUEST_KALLSYMS]		= 'g',
  27		[DSO_BINARY_TYPE__GUEST_KMODULE]		= 'G',
  28		[DSO_BINARY_TYPE__GUEST_KMODULE_COMP]		= 'M',
  29		[DSO_BINARY_TYPE__GUEST_VMLINUX]		= 'V',
  30	};
  31
  32	if (dso == NULL || dso->symtab_type == DSO_BINARY_TYPE__NOT_FOUND)
  33		return '!';
  34	return origin[dso->symtab_type];
  35}
  36
  37int dso__read_binary_type_filename(const struct dso *dso,
  38				   enum dso_binary_type type,
  39				   char *root_dir, char *filename, size_t size)
  40{
  41	char build_id_hex[BUILD_ID_SIZE * 2 + 1];
  42	int ret = 0;
  43	size_t len;
  44
  45	switch (type) {
  46	case DSO_BINARY_TYPE__DEBUGLINK: {
  47		char *debuglink;
  48
  49		len = __symbol__join_symfs(filename, size, dso->long_name);
  50		debuglink = filename + len;
  51		while (debuglink != filename && *debuglink != '/')
  52			debuglink--;
  53		if (*debuglink == '/')
  54			debuglink++;
  55
  56		ret = -1;
  57		if (!is_regular_file(filename))
  58			break;
  59
  60		ret = filename__read_debuglink(filename, debuglink,
  61					       size - (debuglink - filename));
  62		}
  63		break;
  64	case DSO_BINARY_TYPE__BUILD_ID_CACHE:
  65		/* skip the locally configured cache if a symfs is given */
  66		if (symbol_conf.symfs[0] ||
  67		    (dso__build_id_filename(dso, filename, size) == NULL))
  68			ret = -1;
  69		break;
  70
  71	case DSO_BINARY_TYPE__FEDORA_DEBUGINFO:
  72		len = __symbol__join_symfs(filename, size, "/usr/lib/debug");
  73		snprintf(filename + len, size - len, "%s.debug", dso->long_name);
  74		break;
  75
  76	case DSO_BINARY_TYPE__UBUNTU_DEBUGINFO:
  77		len = __symbol__join_symfs(filename, size, "/usr/lib/debug");
  78		snprintf(filename + len, size - len, "%s", dso->long_name);
  79		break;
  80
  81	case DSO_BINARY_TYPE__OPENEMBEDDED_DEBUGINFO:
  82	{
  83		const char *last_slash;
  84		size_t dir_size;
  85
  86		last_slash = dso->long_name + dso->long_name_len;
  87		while (last_slash != dso->long_name && *last_slash != '/')
  88			last_slash--;
  89
  90		len = __symbol__join_symfs(filename, size, "");
  91		dir_size = last_slash - dso->long_name + 2;
  92		if (dir_size > (size - len)) {
  93			ret = -1;
  94			break;
  95		}
  96		len += scnprintf(filename + len, dir_size, "%s",  dso->long_name);
  97		len += scnprintf(filename + len , size - len, ".debug%s",
  98								last_slash);
  99		break;
 100	}
 101
 102	case DSO_BINARY_TYPE__BUILDID_DEBUGINFO:
 103		if (!dso->has_build_id) {
 104			ret = -1;
 105			break;
 106		}
 107
 108		build_id__sprintf(dso->build_id,
 109				  sizeof(dso->build_id),
 110				  build_id_hex);
 111		len = __symbol__join_symfs(filename, size, "/usr/lib/debug/.build-id/");
 112		snprintf(filename + len, size - len, "%.2s/%s.debug",
 113			 build_id_hex, build_id_hex + 2);
 114		break;
 115
 116	case DSO_BINARY_TYPE__VMLINUX:
 117	case DSO_BINARY_TYPE__GUEST_VMLINUX:
 118	case DSO_BINARY_TYPE__SYSTEM_PATH_DSO:
 119		__symbol__join_symfs(filename, size, dso->long_name);
 120		break;
 121
 122	case DSO_BINARY_TYPE__GUEST_KMODULE:
 123	case DSO_BINARY_TYPE__GUEST_KMODULE_COMP:
 124		path__join3(filename, size, symbol_conf.symfs,
 125			    root_dir, dso->long_name);
 126		break;
 127
 128	case DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE:
 129	case DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE_COMP:
 130		__symbol__join_symfs(filename, size, dso->long_name);
 131		break;
 132
 133	case DSO_BINARY_TYPE__KCORE:
 134	case DSO_BINARY_TYPE__GUEST_KCORE:
 135		snprintf(filename, size, "%s", dso->long_name);
 136		break;
 137
 138	default:
 139	case DSO_BINARY_TYPE__KALLSYMS:
 140	case DSO_BINARY_TYPE__GUEST_KALLSYMS:
 141	case DSO_BINARY_TYPE__JAVA_JIT:
 142	case DSO_BINARY_TYPE__NOT_FOUND:
 143		ret = -1;
 144		break;
 145	}
 146
 147	return ret;
 148}
 149
 150static const struct {
 151	const char *fmt;
 152	int (*decompress)(const char *input, int output);
 153} compressions[] = {
 154#ifdef HAVE_ZLIB_SUPPORT
 155	{ "gz", gzip_decompress_to_file },
 156#endif
 157#ifdef HAVE_LZMA_SUPPORT
 158	{ "xz", lzma_decompress_to_file },
 159#endif
 160	{ NULL, NULL },
 161};
 162
 163bool is_supported_compression(const char *ext)
 164{
 165	unsigned i;
 166
 167	for (i = 0; compressions[i].fmt; i++) {
 168		if (!strcmp(ext, compressions[i].fmt))
 169			return true;
 170	}
 171	return false;
 172}
 173
 174bool is_kernel_module(const char *pathname, int cpumode)
 175{
 176	struct kmod_path m;
 177	int mode = cpumode & PERF_RECORD_MISC_CPUMODE_MASK;
 178
 179	WARN_ONCE(mode != cpumode,
 180		  "Internal error: passing unmasked cpumode (%x) to is_kernel_module",
 181		  cpumode);
 182
 183	switch (mode) {
 184	case PERF_RECORD_MISC_USER:
 185	case PERF_RECORD_MISC_HYPERVISOR:
 186	case PERF_RECORD_MISC_GUEST_USER:
 187		return false;
 188	/* Treat PERF_RECORD_MISC_CPUMODE_UNKNOWN as kernel */
 189	default:
 190		if (kmod_path__parse(&m, pathname)) {
 191			pr_err("Failed to check whether %s is a kernel module or not. Assume it is.",
 192					pathname);
 193			return true;
 194		}
 195	}
 196
 197	return m.kmod;
 198}
 199
 200bool decompress_to_file(const char *ext, const char *filename, int output_fd)
 201{
 202	unsigned i;
 203
 204	for (i = 0; compressions[i].fmt; i++) {
 205		if (!strcmp(ext, compressions[i].fmt))
 206			return !compressions[i].decompress(filename,
 207							   output_fd);
 208	}
 209	return false;
 210}
 211
 212bool dso__needs_decompress(struct dso *dso)
 213{
 214	return dso->symtab_type == DSO_BINARY_TYPE__SYSTEM_PATH_KMODULE_COMP ||
 215		dso->symtab_type == DSO_BINARY_TYPE__GUEST_KMODULE_COMP;
 216}
 217
 218/*
 219 * Parses kernel module specified in @path and updates
 220 * @m argument like:
 221 *
 222 *    @comp - true if @path contains supported compression suffix,
 223 *            false otherwise
 224 *    @kmod - true if @path contains '.ko' suffix in right position,
 225 *            false otherwise
 226 *    @name - if (@alloc_name && @kmod) is true, it contains strdup-ed base name
 227 *            of the kernel module without suffixes, otherwise strudup-ed
 228 *            base name of @path
 229 *    @ext  - if (@alloc_ext && @comp) is true, it contains strdup-ed string
 230 *            the compression suffix
 231 *
 232 * Returns 0 if there's no strdup error, -ENOMEM otherwise.
 233 */
 234int __kmod_path__parse(struct kmod_path *m, const char *path,
 235		       bool alloc_name, bool alloc_ext)
 236{
 237	const char *name = strrchr(path, '/');
 238	const char *ext  = strrchr(path, '.');
 239	bool is_simple_name = false;
 240
 241	memset(m, 0x0, sizeof(*m));
 242	name = name ? name + 1 : path;
 243
 244	/*
 245	 * '.' is also a valid character for module name. For example:
 246	 * [aaa.bbb] is a valid module name. '[' should have higher
 247	 * priority than '.ko' suffix.
 248	 *
 249	 * The kernel names are from machine__mmap_name. Such
 250	 * name should belong to kernel itself, not kernel module.
 251	 */
 252	if (name[0] == '[') {
 253		is_simple_name = true;
 254		if ((strncmp(name, "[kernel.kallsyms]", 17) == 0) ||
 255		    (strncmp(name, "[guest.kernel.kallsyms", 22) == 0) ||
 256		    (strncmp(name, "[vdso]", 6) == 0) ||
 257		    (strncmp(name, "[vsyscall]", 10) == 0)) {
 258			m->kmod = false;
 259
 260		} else
 261			m->kmod = true;
 262	}
 263
 264	/* No extension, just return name. */
 265	if ((ext == NULL) || is_simple_name) {
 266		if (alloc_name) {
 267			m->name = strdup(name);
 268			return m->name ? 0 : -ENOMEM;
 269		}
 270		return 0;
 271	}
 272
 273	if (is_supported_compression(ext + 1)) {
 274		m->comp = true;
 275		ext -= 3;
 276	}
 277
 278	/* Check .ko extension only if there's enough name left. */
 279	if (ext > name)
 280		m->kmod = !strncmp(ext, ".ko", 3);
 281
 282	if (alloc_name) {
 283		if (m->kmod) {
 284			if (asprintf(&m->name, "[%.*s]", (int) (ext - name), name) == -1)
 285				return -ENOMEM;
 286		} else {
 287			if (asprintf(&m->name, "%s", name) == -1)
 288				return -ENOMEM;
 289		}
 290
 291		strxfrchar(m->name, '-', '_');
 292	}
 293
 294	if (alloc_ext && m->comp) {
 295		m->ext = strdup(ext + 4);
 296		if (!m->ext) {
 297			free((void *) m->name);
 298			return -ENOMEM;
 299		}
 300	}
 301
 302	return 0;
 303}
 304
 305/*
 306 * Global list of open DSOs and the counter.
 307 */
 308static LIST_HEAD(dso__data_open);
 309static long dso__data_open_cnt;
 310static pthread_mutex_t dso__data_open_lock = PTHREAD_MUTEX_INITIALIZER;
 311
 312static void dso__list_add(struct dso *dso)
 313{
 314	list_add_tail(&dso->data.open_entry, &dso__data_open);
 315	dso__data_open_cnt++;
 316}
 317
 318static void dso__list_del(struct dso *dso)
 319{
 320	list_del(&dso->data.open_entry);
 321	WARN_ONCE(dso__data_open_cnt <= 0,
 322		  "DSO data fd counter out of bounds.");
 323	dso__data_open_cnt--;
 324}
 325
 326static void close_first_dso(void);
 327
 328static int do_open(char *name)
 329{
 330	int fd;
 331	char sbuf[STRERR_BUFSIZE];
 332
 333	do {
 334		fd = open(name, O_RDONLY);
 335		if (fd >= 0)
 336			return fd;
 337
 338		pr_debug("dso open failed: %s\n",
 339			 strerror_r(errno, sbuf, sizeof(sbuf)));
 340		if (!dso__data_open_cnt || errno != EMFILE)
 341			break;
 342
 343		close_first_dso();
 344	} while (1);
 345
 346	return -1;
 347}
 348
 349static int __open_dso(struct dso *dso, struct machine *machine)
 350{
 351	int fd;
 352	char *root_dir = (char *)"";
 353	char *name = malloc(PATH_MAX);
 354
 355	if (!name)
 356		return -ENOMEM;
 357
 358	if (machine)
 359		root_dir = machine->root_dir;
 360
 361	if (dso__read_binary_type_filename(dso, dso->binary_type,
 362					    root_dir, name, PATH_MAX)) {
 363		free(name);
 364		return -EINVAL;
 365	}
 366
 367	fd = do_open(name);
 368	free(name);
 369	return fd;
 370}
 371
 372static void check_data_close(void);
 373
 374/**
 375 * dso_close - Open DSO data file
 376 * @dso: dso object
 377 *
 378 * Open @dso's data file descriptor and updates
 379 * list/count of open DSO objects.
 380 */
 381static int open_dso(struct dso *dso, struct machine *machine)
 382{
 383	int fd = __open_dso(dso, machine);
 384
 385	if (fd >= 0) {
 386		dso__list_add(dso);
 387		/*
 388		 * Check if we crossed the allowed number
 389		 * of opened DSOs and close one if needed.
 390		 */
 391		check_data_close();
 392	}
 393
 394	return fd;
 395}
 396
 397static void close_data_fd(struct dso *dso)
 398{
 399	if (dso->data.fd >= 0) {
 400		close(dso->data.fd);
 401		dso->data.fd = -1;
 402		dso->data.file_size = 0;
 403		dso__list_del(dso);
 404	}
 405}
 406
 407/**
 408 * dso_close - Close DSO data file
 409 * @dso: dso object
 410 *
 411 * Close @dso's data file descriptor and updates
 412 * list/count of open DSO objects.
 413 */
 414static void close_dso(struct dso *dso)
 415{
 416	close_data_fd(dso);
 417}
 418
 419static void close_first_dso(void)
 420{
 421	struct dso *dso;
 422
 423	dso = list_first_entry(&dso__data_open, struct dso, data.open_entry);
 424	close_dso(dso);
 425}
 426
 427static rlim_t get_fd_limit(void)
 428{
 429	struct rlimit l;
 430	rlim_t limit = 0;
 431
 432	/* Allow half of the current open fd limit. */
 433	if (getrlimit(RLIMIT_NOFILE, &l) == 0) {
 434		if (l.rlim_cur == RLIM_INFINITY)
 435			limit = l.rlim_cur;
 436		else
 437			limit = l.rlim_cur / 2;
 438	} else {
 439		pr_err("failed to get fd limit\n");
 440		limit = 1;
 441	}
 442
 443	return limit;
 444}
 445
 446static bool may_cache_fd(void)
 447{
 448	static rlim_t limit;
 449
 450	if (!limit)
 451		limit = get_fd_limit();
 452
 453	if (limit == RLIM_INFINITY)
 454		return true;
 455
 456	return limit > (rlim_t) dso__data_open_cnt;
 457}
 458
 459/*
 460 * Check and close LRU dso if we crossed allowed limit
 461 * for opened dso file descriptors. The limit is half
 462 * of the RLIMIT_NOFILE files opened.
 463*/
 464static void check_data_close(void)
 465{
 466	bool cache_fd = may_cache_fd();
 467
 468	if (!cache_fd)
 469		close_first_dso();
 470}
 471
 472/**
 473 * dso__data_close - Close DSO data file
 474 * @dso: dso object
 475 *
 476 * External interface to close @dso's data file descriptor.
 477 */
 478void dso__data_close(struct dso *dso)
 479{
 480	pthread_mutex_lock(&dso__data_open_lock);
 481	close_dso(dso);
 482	pthread_mutex_unlock(&dso__data_open_lock);
 483}
 484
 485static void try_to_open_dso(struct dso *dso, struct machine *machine)
 486{
 487	enum dso_binary_type binary_type_data[] = {
 488		DSO_BINARY_TYPE__BUILD_ID_CACHE,
 489		DSO_BINARY_TYPE__SYSTEM_PATH_DSO,
 490		DSO_BINARY_TYPE__NOT_FOUND,
 491	};
 492	int i = 0;
 493
 494	if (dso->data.fd >= 0)
 495		return;
 496
 497	if (dso->binary_type != DSO_BINARY_TYPE__NOT_FOUND) {
 498		dso->data.fd = open_dso(dso, machine);
 499		goto out;
 500	}
 501
 502	do {
 503		dso->binary_type = binary_type_data[i++];
 504
 505		dso->data.fd = open_dso(dso, machine);
 506		if (dso->data.fd >= 0)
 507			goto out;
 508
 509	} while (dso->binary_type != DSO_BINARY_TYPE__NOT_FOUND);
 510out:
 511	if (dso->data.fd >= 0)
 512		dso->data.status = DSO_DATA_STATUS_OK;
 513	else
 514		dso->data.status = DSO_DATA_STATUS_ERROR;
 515}
 516
 517/**
 518 * dso__data_get_fd - Get dso's data file descriptor
 519 * @dso: dso object
 520 * @machine: machine object
 521 *
 522 * External interface to find dso's file, open it and
 523 * returns file descriptor.  It should be paired with
 524 * dso__data_put_fd() if it returns non-negative value.
 525 */
 526int dso__data_get_fd(struct dso *dso, struct machine *machine)
 527{
 528	if (dso->data.status == DSO_DATA_STATUS_ERROR)
 529		return -1;
 530
 531	if (pthread_mutex_lock(&dso__data_open_lock) < 0)
 532		return -1;
 533
 534	try_to_open_dso(dso, machine);
 535
 536	if (dso->data.fd < 0)
 537		pthread_mutex_unlock(&dso__data_open_lock);
 538
 539	return dso->data.fd;
 540}
 541
 542void dso__data_put_fd(struct dso *dso __maybe_unused)
 543{
 544	pthread_mutex_unlock(&dso__data_open_lock);
 545}
 546
 547bool dso__data_status_seen(struct dso *dso, enum dso_data_status_seen by)
 548{
 549	u32 flag = 1 << by;
 550
 551	if (dso->data.status_seen & flag)
 552		return true;
 553
 554	dso->data.status_seen |= flag;
 555
 556	return false;
 557}
 558
 559static void
 560dso_cache__free(struct dso *dso)
 561{
 562	struct rb_root *root = &dso->data.cache;
 563	struct rb_node *next = rb_first(root);
 564
 565	pthread_mutex_lock(&dso->lock);
 566	while (next) {
 567		struct dso_cache *cache;
 568
 569		cache = rb_entry(next, struct dso_cache, rb_node);
 570		next = rb_next(&cache->rb_node);
 571		rb_erase(&cache->rb_node, root);
 572		free(cache);
 573	}
 574	pthread_mutex_unlock(&dso->lock);
 575}
 576
 577static struct dso_cache *dso_cache__find(struct dso *dso, u64 offset)
 578{
 579	const struct rb_root *root = &dso->data.cache;
 580	struct rb_node * const *p = &root->rb_node;
 581	const struct rb_node *parent = NULL;
 582	struct dso_cache *cache;
 583
 584	while (*p != NULL) {
 585		u64 end;
 586
 587		parent = *p;
 588		cache = rb_entry(parent, struct dso_cache, rb_node);
 589		end = cache->offset + DSO__DATA_CACHE_SIZE;
 590
 591		if (offset < cache->offset)
 592			p = &(*p)->rb_left;
 593		else if (offset >= end)
 594			p = &(*p)->rb_right;
 595		else
 596			return cache;
 597	}
 598
 599	return NULL;
 600}
 601
 602static struct dso_cache *
 603dso_cache__insert(struct dso *dso, struct dso_cache *new)
 604{
 605	struct rb_root *root = &dso->data.cache;
 606	struct rb_node **p = &root->rb_node;
 607	struct rb_node *parent = NULL;
 608	struct dso_cache *cache;
 609	u64 offset = new->offset;
 610
 611	pthread_mutex_lock(&dso->lock);
 612	while (*p != NULL) {
 613		u64 end;
 614
 615		parent = *p;
 616		cache = rb_entry(parent, struct dso_cache, rb_node);
 617		end = cache->offset + DSO__DATA_CACHE_SIZE;
 618
 619		if (offset < cache->offset)
 620			p = &(*p)->rb_left;
 621		else if (offset >= end)
 622			p = &(*p)->rb_right;
 623		else
 624			goto out;
 625	}
 626
 627	rb_link_node(&new->rb_node, parent, p);
 628	rb_insert_color(&new->rb_node, root);
 629
 630	cache = NULL;
 631out:
 632	pthread_mutex_unlock(&dso->lock);
 633	return cache;
 634}
 635
 636static ssize_t
 637dso_cache__memcpy(struct dso_cache *cache, u64 offset,
 638		  u8 *data, u64 size)
 639{
 640	u64 cache_offset = offset - cache->offset;
 641	u64 cache_size   = min(cache->size - cache_offset, size);
 642
 643	memcpy(data, cache->data + cache_offset, cache_size);
 644	return cache_size;
 645}
 646
 647static ssize_t
 648dso_cache__read(struct dso *dso, struct machine *machine,
 649		u64 offset, u8 *data, ssize_t size)
 650{
 651	struct dso_cache *cache;
 652	struct dso_cache *old;
 653	ssize_t ret;
 654
 655	do {
 656		u64 cache_offset;
 657
 658		cache = zalloc(sizeof(*cache) + DSO__DATA_CACHE_SIZE);
 659		if (!cache)
 660			return -ENOMEM;
 661
 662		pthread_mutex_lock(&dso__data_open_lock);
 663
 664		/*
 665		 * dso->data.fd might be closed if other thread opened another
 666		 * file (dso) due to open file limit (RLIMIT_NOFILE).
 667		 */
 668		try_to_open_dso(dso, machine);
 669
 670		if (dso->data.fd < 0) {
 671			ret = -errno;
 672			dso->data.status = DSO_DATA_STATUS_ERROR;
 673			break;
 674		}
 675
 676		cache_offset = offset & DSO__DATA_CACHE_MASK;
 677
 678		ret = pread(dso->data.fd, cache->data, DSO__DATA_CACHE_SIZE, cache_offset);
 679		if (ret <= 0)
 680			break;
 681
 682		cache->offset = cache_offset;
 683		cache->size   = ret;
 684	} while (0);
 685
 686	pthread_mutex_unlock(&dso__data_open_lock);
 687
 688	if (ret > 0) {
 689		old = dso_cache__insert(dso, cache);
 690		if (old) {
 691			/* we lose the race */
 692			free(cache);
 693			cache = old;
 694		}
 695
 696		ret = dso_cache__memcpy(cache, offset, data, size);
 697	}
 698
 699	if (ret <= 0)
 700		free(cache);
 701
 702	return ret;
 703}
 704
 705static ssize_t dso_cache_read(struct dso *dso, struct machine *machine,
 706			      u64 offset, u8 *data, ssize_t size)
 707{
 708	struct dso_cache *cache;
 709
 710	cache = dso_cache__find(dso, offset);
 711	if (cache)
 712		return dso_cache__memcpy(cache, offset, data, size);
 713	else
 714		return dso_cache__read(dso, machine, offset, data, size);
 715}
 716
 717/*
 718 * Reads and caches dso data DSO__DATA_CACHE_SIZE size chunks
 719 * in the rb_tree. Any read to already cached data is served
 720 * by cached data.
 721 */
 722static ssize_t cached_read(struct dso *dso, struct machine *machine,
 723			   u64 offset, u8 *data, ssize_t size)
 724{
 725	ssize_t r = 0;
 726	u8 *p = data;
 727
 728	do {
 729		ssize_t ret;
 730
 731		ret = dso_cache_read(dso, machine, offset, p, size);
 732		if (ret < 0)
 733			return ret;
 734
 735		/* Reached EOF, return what we have. */
 736		if (!ret)
 737			break;
 738
 739		BUG_ON(ret > size);
 740
 741		r      += ret;
 742		p      += ret;
 743		offset += ret;
 744		size   -= ret;
 745
 746	} while (size);
 747
 748	return r;
 749}
 750
 751static int data_file_size(struct dso *dso, struct machine *machine)
 752{
 753	int ret = 0;
 754	struct stat st;
 755	char sbuf[STRERR_BUFSIZE];
 756
 757	if (dso->data.file_size)
 758		return 0;
 759
 760	if (dso->data.status == DSO_DATA_STATUS_ERROR)
 761		return -1;
 762
 763	pthread_mutex_lock(&dso__data_open_lock);
 764
 765	/*
 766	 * dso->data.fd might be closed if other thread opened another
 767	 * file (dso) due to open file limit (RLIMIT_NOFILE).
 768	 */
 769	try_to_open_dso(dso, machine);
 770
 771	if (dso->data.fd < 0) {
 772		ret = -errno;
 773		dso->data.status = DSO_DATA_STATUS_ERROR;
 774		goto out;
 775	}
 776
 777	if (fstat(dso->data.fd, &st) < 0) {
 778		ret = -errno;
 779		pr_err("dso cache fstat failed: %s\n",
 780		       strerror_r(errno, sbuf, sizeof(sbuf)));
 781		dso->data.status = DSO_DATA_STATUS_ERROR;
 782		goto out;
 783	}
 784	dso->data.file_size = st.st_size;
 785
 786out:
 787	pthread_mutex_unlock(&dso__data_open_lock);
 788	return ret;
 789}
 790
 791/**
 792 * dso__data_size - Return dso data size
 793 * @dso: dso object
 794 * @machine: machine object
 795 *
 796 * Return: dso data size
 797 */
 798off_t dso__data_size(struct dso *dso, struct machine *machine)
 799{
 800	if (data_file_size(dso, machine))
 801		return -1;
 802
 803	/* For now just estimate dso data size is close to file size */
 804	return dso->data.file_size;
 805}
 806
 807static ssize_t data_read_offset(struct dso *dso, struct machine *machine,
 808				u64 offset, u8 *data, ssize_t size)
 809{
 810	if (data_file_size(dso, machine))
 811		return -1;
 812
 813	/* Check the offset sanity. */
 814	if (offset > dso->data.file_size)
 815		return -1;
 816
 817	if (offset + size < offset)
 818		return -1;
 819
 820	return cached_read(dso, machine, offset, data, size);
 821}
 822
 823/**
 824 * dso__data_read_offset - Read data from dso file offset
 825 * @dso: dso object
 826 * @machine: machine object
 827 * @offset: file offset
 828 * @data: buffer to store data
 829 * @size: size of the @data buffer
 830 *
 831 * External interface to read data from dso file offset. Open
 832 * dso data file and use cached_read to get the data.
 833 */
 834ssize_t dso__data_read_offset(struct dso *dso, struct machine *machine,
 835			      u64 offset, u8 *data, ssize_t size)
 836{
 837	if (dso->data.status == DSO_DATA_STATUS_ERROR)
 838		return -1;
 839
 840	return data_read_offset(dso, machine, offset, data, size);
 841}
 842
 843/**
 844 * dso__data_read_addr - Read data from dso address
 845 * @dso: dso object
 846 * @machine: machine object
 847 * @add: virtual memory address
 848 * @data: buffer to store data
 849 * @size: size of the @data buffer
 850 *
 851 * External interface to read data from dso address.
 852 */
 853ssize_t dso__data_read_addr(struct dso *dso, struct map *map,
 854			    struct machine *machine, u64 addr,
 855			    u8 *data, ssize_t size)
 856{
 857	u64 offset = map->map_ip(map, addr);
 858	return dso__data_read_offset(dso, machine, offset, data, size);
 859}
 860
 861struct map *dso__new_map(const char *name)
 862{
 863	struct map *map = NULL;
 864	struct dso *dso = dso__new(name);
 865
 866	if (dso)
 867		map = map__new2(0, dso, MAP__FUNCTION);
 868
 869	return map;
 870}
 871
 872struct dso *machine__findnew_kernel(struct machine *machine, const char *name,
 873				    const char *short_name, int dso_type)
 874{
 875	/*
 876	 * The kernel dso could be created by build_id processing.
 877	 */
 878	struct dso *dso = machine__findnew_dso(machine, name);
 879
 880	/*
 881	 * We need to run this in all cases, since during the build_id
 882	 * processing we had no idea this was the kernel dso.
 883	 */
 884	if (dso != NULL) {
 885		dso__set_short_name(dso, short_name, false);
 886		dso->kernel = dso_type;
 887	}
 888
 889	return dso;
 890}
 891
 892/*
 893 * Find a matching entry and/or link current entry to RB tree.
 894 * Either one of the dso or name parameter must be non-NULL or the
 895 * function will not work.
 896 */
 897static struct dso *__dso__findlink_by_longname(struct rb_root *root,
 898					       struct dso *dso, const char *name)
 899{
 900	struct rb_node **p = &root->rb_node;
 901	struct rb_node  *parent = NULL;
 902
 903	if (!name)
 904		name = dso->long_name;
 905	/*
 906	 * Find node with the matching name
 907	 */
 908	while (*p) {
 909		struct dso *this = rb_entry(*p, struct dso, rb_node);
 910		int rc = strcmp(name, this->long_name);
 911
 912		parent = *p;
 913		if (rc == 0) {
 914			/*
 915			 * In case the new DSO is a duplicate of an existing
 916			 * one, print an one-time warning & put the new entry
 917			 * at the end of the list of duplicates.
 918			 */
 919			if (!dso || (dso == this))
 920				return this;	/* Find matching dso */
 921			/*
 922			 * The core kernel DSOs may have duplicated long name.
 923			 * In this case, the short name should be different.
 924			 * Comparing the short names to differentiate the DSOs.
 925			 */
 926			rc = strcmp(dso->short_name, this->short_name);
 927			if (rc == 0) {
 928				pr_err("Duplicated dso name: %s\n", name);
 929				return NULL;
 930			}
 931		}
 932		if (rc < 0)
 933			p = &parent->rb_left;
 934		else
 935			p = &parent->rb_right;
 936	}
 937	if (dso) {
 938		/* Add new node and rebalance tree */
 939		rb_link_node(&dso->rb_node, parent, p);
 940		rb_insert_color(&dso->rb_node, root);
 941		dso->root = root;
 942	}
 943	return NULL;
 944}
 945
 946static inline struct dso *__dso__find_by_longname(struct rb_root *root,
 947						  const char *name)
 948{
 949	return __dso__findlink_by_longname(root, NULL, name);
 950}
 951
 952void dso__set_long_name(struct dso *dso, const char *name, bool name_allocated)
 953{
 954	struct rb_root *root = dso->root;
 955
 956	if (name == NULL)
 957		return;
 958
 959	if (dso->long_name_allocated)
 960		free((char *)dso->long_name);
 961
 962	if (root) {
 963		rb_erase(&dso->rb_node, root);
 964		/*
 965		 * __dso__findlink_by_longname() isn't guaranteed to add it
 966		 * back, so a clean removal is required here.
 967		 */
 968		RB_CLEAR_NODE(&dso->rb_node);
 969		dso->root = NULL;
 970	}
 971
 972	dso->long_name		 = name;
 973	dso->long_name_len	 = strlen(name);
 974	dso->long_name_allocated = name_allocated;
 975
 976	if (root)
 977		__dso__findlink_by_longname(root, dso, NULL);
 978}
 979
 980void dso__set_short_name(struct dso *dso, const char *name, bool name_allocated)
 981{
 982	if (name == NULL)
 983		return;
 984
 985	if (dso->short_name_allocated)
 986		free((char *)dso->short_name);
 987
 988	dso->short_name		  = name;
 989	dso->short_name_len	  = strlen(name);
 990	dso->short_name_allocated = name_allocated;
 991}
 992
 993static void dso__set_basename(struct dso *dso)
 994{
 995       /*
 996        * basename() may modify path buffer, so we must pass
 997        * a copy.
 998        */
 999       char *base, *lname = strdup(dso->long_name);
1000
1001       if (!lname)
1002               return;
1003
1004       /*
1005        * basename() may return a pointer to internal
1006        * storage which is reused in subsequent calls
1007        * so copy the result.
1008        */
1009       base = strdup(basename(lname));
1010
1011       free(lname);
1012
1013       if (!base)
1014               return;
1015
1016       dso__set_short_name(dso, base, true);
1017}
1018
1019int dso__name_len(const struct dso *dso)
1020{
1021	if (!dso)
1022		return strlen("[unknown]");
1023	if (verbose)
1024		return dso->long_name_len;
1025
1026	return dso->short_name_len;
1027}
1028
1029bool dso__loaded(const struct dso *dso, enum map_type type)
1030{
1031	return dso->loaded & (1 << type);
1032}
1033
1034bool dso__sorted_by_name(const struct dso *dso, enum map_type type)
1035{
1036	return dso->sorted_by_name & (1 << type);
1037}
1038
1039void dso__set_sorted_by_name(struct dso *dso, enum map_type type)
1040{
1041	dso->sorted_by_name |= (1 << type);
1042}
1043
1044struct dso *dso__new(const char *name)
1045{
1046	struct dso *dso = calloc(1, sizeof(*dso) + strlen(name) + 1);
1047
1048	if (dso != NULL) {
1049		int i;
1050		strcpy(dso->name, name);
1051		dso__set_long_name(dso, dso->name, false);
1052		dso__set_short_name(dso, dso->name, false);
1053		for (i = 0; i < MAP__NR_TYPES; ++i)
1054			dso->symbols[i] = dso->symbol_names[i] = RB_ROOT;
1055		dso->data.cache = RB_ROOT;
1056		dso->data.fd = -1;
1057		dso->data.status = DSO_DATA_STATUS_UNKNOWN;
1058		dso->symtab_type = DSO_BINARY_TYPE__NOT_FOUND;
1059		dso->binary_type = DSO_BINARY_TYPE__NOT_FOUND;
1060		dso->is_64_bit = (sizeof(void *) == 8);
1061		dso->loaded = 0;
1062		dso->rel = 0;
1063		dso->sorted_by_name = 0;
1064		dso->has_build_id = 0;
1065		dso->has_srcline = 1;
1066		dso->a2l_fails = 1;
1067		dso->kernel = DSO_TYPE_USER;
1068		dso->needs_swap = DSO_SWAP__UNSET;
1069		RB_CLEAR_NODE(&dso->rb_node);
1070		dso->root = NULL;
1071		INIT_LIST_HEAD(&dso->node);
1072		INIT_LIST_HEAD(&dso->data.open_entry);
1073		pthread_mutex_init(&dso->lock, NULL);
1074		atomic_set(&dso->refcnt, 1);
1075	}
1076
1077	return dso;
1078}
1079
1080void dso__delete(struct dso *dso)
1081{
1082	int i;
1083
1084	if (!RB_EMPTY_NODE(&dso->rb_node))
1085		pr_err("DSO %s is still in rbtree when being deleted!\n",
1086		       dso->long_name);
1087	for (i = 0; i < MAP__NR_TYPES; ++i)
1088		symbols__delete(&dso->symbols[i]);
1089
1090	if (dso->short_name_allocated) {
1091		zfree((char **)&dso->short_name);
1092		dso->short_name_allocated = false;
1093	}
1094
1095	if (dso->long_name_allocated) {
1096		zfree((char **)&dso->long_name);
1097		dso->long_name_allocated = false;
1098	}
1099
1100	dso__data_close(dso);
1101	auxtrace_cache__free(dso->auxtrace_cache);
1102	dso_cache__free(dso);
1103	dso__free_a2l(dso);
1104	zfree(&dso->symsrc_filename);
1105	pthread_mutex_destroy(&dso->lock);
1106	free(dso);
1107}
1108
1109struct dso *dso__get(struct dso *dso)
1110{
1111	if (dso)
1112		atomic_inc(&dso->refcnt);
1113	return dso;
1114}
1115
1116void dso__put(struct dso *dso)
1117{
1118	if (dso && atomic_dec_and_test(&dso->refcnt))
1119		dso__delete(dso);
1120}
1121
1122void dso__set_build_id(struct dso *dso, void *build_id)
1123{
1124	memcpy(dso->build_id, build_id, sizeof(dso->build_id));
1125	dso->has_build_id = 1;
1126}
1127
1128bool dso__build_id_equal(const struct dso *dso, u8 *build_id)
1129{
1130	return memcmp(dso->build_id, build_id, sizeof(dso->build_id)) == 0;
1131}
1132
1133void dso__read_running_kernel_build_id(struct dso *dso, struct machine *machine)
1134{
1135	char path[PATH_MAX];
1136
1137	if (machine__is_default_guest(machine))
1138		return;
1139	sprintf(path, "%s/sys/kernel/notes", machine->root_dir);
1140	if (sysfs__read_build_id(path, dso->build_id,
1141				 sizeof(dso->build_id)) == 0)
1142		dso->has_build_id = true;
1143}
1144
1145int dso__kernel_module_get_build_id(struct dso *dso,
1146				    const char *root_dir)
1147{
1148	char filename[PATH_MAX];
1149	/*
1150	 * kernel module short names are of the form "[module]" and
1151	 * we need just "module" here.
1152	 */
1153	const char *name = dso->short_name + 1;
1154
1155	snprintf(filename, sizeof(filename),
1156		 "%s/sys/module/%.*s/notes/.note.gnu.build-id",
1157		 root_dir, (int)strlen(name) - 1, name);
1158
1159	if (sysfs__read_build_id(filename, dso->build_id,
1160				 sizeof(dso->build_id)) == 0)
1161		dso->has_build_id = true;
1162
1163	return 0;
1164}
1165
1166bool __dsos__read_build_ids(struct list_head *head, bool with_hits)
1167{
1168	bool have_build_id = false;
1169	struct dso *pos;
1170
1171	list_for_each_entry(pos, head, node) {
1172		if (with_hits && !pos->hit)
1173			continue;
1174		if (pos->has_build_id) {
1175			have_build_id = true;
1176			continue;
1177		}
1178		if (filename__read_build_id(pos->long_name, pos->build_id,
1179					    sizeof(pos->build_id)) > 0) {
1180			have_build_id	  = true;
1181			pos->has_build_id = true;
1182		}
1183	}
1184
1185	return have_build_id;
1186}
1187
1188void __dsos__add(struct dsos *dsos, struct dso *dso)
1189{
1190	list_add_tail(&dso->node, &dsos->head);
1191	__dso__findlink_by_longname(&dsos->root, dso, NULL);
1192	/*
1193	 * It is now in the linked list, grab a reference, then garbage collect
1194	 * this when needing memory, by looking at LRU dso instances in the
1195	 * list with atomic_read(&dso->refcnt) == 1, i.e. no references
1196	 * anywhere besides the one for the list, do, under a lock for the
1197	 * list: remove it from the list, then a dso__put(), that probably will
1198	 * be the last and will then call dso__delete(), end of life.
1199	 *
1200	 * That, or at the end of the 'struct machine' lifetime, when all
1201	 * 'struct dso' instances will be removed from the list, in
1202	 * dsos__exit(), if they have no other reference from some other data
1203	 * structure.
1204	 *
1205	 * E.g.: after processing a 'perf.data' file and storing references
1206	 * to objects instantiated while processing events, we will have
1207	 * references to the 'thread', 'map', 'dso' structs all from 'struct
1208	 * hist_entry' instances, but we may not need anything not referenced,
1209	 * so we might as well call machines__exit()/machines__delete() and
1210	 * garbage collect it.
1211	 */
1212	dso__get(dso);
1213}
1214
1215void dsos__add(struct dsos *dsos, struct dso *dso)
1216{
1217	pthread_rwlock_wrlock(&dsos->lock);
1218	__dsos__add(dsos, dso);
1219	pthread_rwlock_unlock(&dsos->lock);
1220}
1221
1222struct dso *__dsos__find(struct dsos *dsos, const char *name, bool cmp_short)
1223{
1224	struct dso *pos;
1225
1226	if (cmp_short) {
1227		list_for_each_entry(pos, &dsos->head, node)
1228			if (strcmp(pos->short_name, name) == 0)
1229				return pos;
1230		return NULL;
1231	}
1232	return __dso__find_by_longname(&dsos->root, name);
1233}
1234
1235struct dso *dsos__find(struct dsos *dsos, const char *name, bool cmp_short)
1236{
1237	struct dso *dso;
1238	pthread_rwlock_rdlock(&dsos->lock);
1239	dso = __dsos__find(dsos, name, cmp_short);
1240	pthread_rwlock_unlock(&dsos->lock);
1241	return dso;
1242}
1243
1244struct dso *__dsos__addnew(struct dsos *dsos, const char *name)
1245{
1246	struct dso *dso = dso__new(name);
1247
1248	if (dso != NULL) {
1249		__dsos__add(dsos, dso);
1250		dso__set_basename(dso);
1251		/* Put dso here because __dsos_add already got it */
1252		dso__put(dso);
1253	}
1254	return dso;
1255}
1256
1257struct dso *__dsos__findnew(struct dsos *dsos, const char *name)
1258{
1259	struct dso *dso = __dsos__find(dsos, name, false);
1260
1261	return dso ? dso : __dsos__addnew(dsos, name);
1262}
1263
1264struct dso *dsos__findnew(struct dsos *dsos, const char *name)
1265{
1266	struct dso *dso;
1267	pthread_rwlock_wrlock(&dsos->lock);
1268	dso = dso__get(__dsos__findnew(dsos, name));
1269	pthread_rwlock_unlock(&dsos->lock);
1270	return dso;
1271}
1272
1273size_t __dsos__fprintf_buildid(struct list_head *head, FILE *fp,
1274			       bool (skip)(struct dso *dso, int parm), int parm)
1275{
1276	struct dso *pos;
1277	size_t ret = 0;
1278
1279	list_for_each_entry(pos, head, node) {
1280		if (skip && skip(pos, parm))
1281			continue;
1282		ret += dso__fprintf_buildid(pos, fp);
1283		ret += fprintf(fp, " %s\n", pos->long_name);
1284	}
1285	return ret;
1286}
1287
1288size_t __dsos__fprintf(struct list_head *head, FILE *fp)
1289{
1290	struct dso *pos;
1291	size_t ret = 0;
1292
1293	list_for_each_entry(pos, head, node) {
1294		int i;
1295		for (i = 0; i < MAP__NR_TYPES; ++i)
1296			ret += dso__fprintf(pos, i, fp);
1297	}
1298
1299	return ret;
1300}
1301
1302size_t dso__fprintf_buildid(struct dso *dso, FILE *fp)
1303{
1304	char sbuild_id[BUILD_ID_SIZE * 2 + 1];
1305
1306	build_id__sprintf(dso->build_id, sizeof(dso->build_id), sbuild_id);
1307	return fprintf(fp, "%s", sbuild_id);
1308}
1309
1310size_t dso__fprintf(struct dso *dso, enum map_type type, FILE *fp)
1311{
1312	struct rb_node *nd;
1313	size_t ret = fprintf(fp, "dso: %s (", dso->short_name);
1314
1315	if (dso->short_name != dso->long_name)
1316		ret += fprintf(fp, "%s, ", dso->long_name);
1317	ret += fprintf(fp, "%s, %sloaded, ", map_type__name[type],
1318		       dso__loaded(dso, type) ? "" : "NOT ");
1319	ret += dso__fprintf_buildid(dso, fp);
1320	ret += fprintf(fp, ")\n");
1321	for (nd = rb_first(&dso->symbols[type]); nd; nd = rb_next(nd)) {
1322		struct symbol *pos = rb_entry(nd, struct symbol, rb_node);
1323		ret += symbol__fprintf(pos, fp);
1324	}
1325
1326	return ret;
1327}
1328
1329enum dso_type dso__type(struct dso *dso, struct machine *machine)
1330{
1331	int fd;
1332	enum dso_type type = DSO__TYPE_UNKNOWN;
1333
1334	fd = dso__data_get_fd(dso, machine);
1335	if (fd >= 0) {
1336		type = dso__type_fd(fd);
1337		dso__data_put_fd(dso);
1338	}
1339
1340	return type;
1341}
1342
1343int dso__strerror_load(struct dso *dso, char *buf, size_t buflen)
1344{
1345	int idx, errnum = dso->load_errno;
1346	/*
1347	 * This must have a same ordering as the enum dso_load_errno.
1348	 */
1349	static const char *dso_load__error_str[] = {
1350	"Internal tools/perf/ library error",
1351	"Invalid ELF file",
1352	"Can not read build id",
1353	"Mismatching build id",
1354	"Decompression failure",
1355	};
1356
1357	BUG_ON(buflen == 0);
1358
1359	if (errnum >= 0) {
1360		const char *err = strerror_r(errnum, buf, buflen);
1361
1362		if (err != buf)
1363			scnprintf(buf, buflen, "%s", err);
1364
1365		return 0;
1366	}
1367
1368	if (errnum <  __DSO_LOAD_ERRNO__START || errnum >= __DSO_LOAD_ERRNO__END)
1369		return -1;
1370
1371	idx = errnum - __DSO_LOAD_ERRNO__START;
1372	scnprintf(buf, buflen, "%s", dso_load__error_str[idx]);
1373	return 0;
1374}