Linux Audio

Check our new training course

Loading...
v4.17
 
   1/*
   2 * probe-file.c : operate ftrace k/uprobe events files
   3 *
   4 * Written by Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
   5 *
   6 * This program is free software; you can redistribute it and/or modify
   7 * it under the terms of the GNU General Public License as published by
   8 * the Free Software Foundation; either version 2 of the License, or
   9 * (at your option) any later version.
  10 *
  11 * This program is distributed in the hope that it will be useful,
  12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 * GNU General Public License for more details.
  15 *
  16 */
  17#include <errno.h>
  18#include <fcntl.h>
  19#include <sys/stat.h>
  20#include <sys/types.h>
  21#include <sys/uio.h>
  22#include <unistd.h>
  23#include "util.h"
 
  24#include "event.h"
  25#include "strlist.h"
  26#include "strfilter.h"
  27#include "debug.h"
  28#include "cache.h"
 
  29#include "color.h"
  30#include "symbol.h"
  31#include "thread.h"
  32#include <api/fs/tracing_path.h>
 
  33#include "probe-event.h"
  34#include "probe-file.h"
  35#include "session.h"
  36#include "perf_regs.h"
  37#include "string2.h"
  38
  39/* 4096 - 2 ('\n' + '\0') */
  40#define MAX_CMDLEN 4094
  41
  42static void print_open_warning(int err, bool uprobe)
  43{
  44	char sbuf[STRERR_BUFSIZE];
 
 
 
 
 
 
  45
  46	if (err == -ENOENT) {
  47		const char *config;
  48
  49		if (uprobe)
  50			config = "CONFIG_UPROBE_EVENTS";
  51		else
  52			config = "CONFIG_KPROBE_EVENTS";
 
 
 
 
 
 
 
 
 
 
 
  53
  54		pr_warning("%cprobe_events file does not exist"
  55			   " - please rebuild kernel with %s.\n",
  56			   uprobe ? 'u' : 'k', config);
  57	} else if (err == -ENOTSUP)
  58		pr_warning("Tracefs or debugfs is not mounted.\n");
  59	else
  60		pr_warning("Failed to open %cprobe_events: %s\n",
  61			   uprobe ? 'u' : 'k',
  62			   str_error_r(-err, sbuf, sizeof(sbuf)));
  63}
  64
  65static void print_both_open_warning(int kerr, int uerr)
  66{
  67	/* Both kprobes and uprobes are disabled, warn it. */
  68	if (kerr == -ENOTSUP && uerr == -ENOTSUP)
  69		pr_warning("Tracefs or debugfs is not mounted.\n");
  70	else if (kerr == -ENOENT && uerr == -ENOENT)
  71		pr_warning("Please rebuild kernel with CONFIG_KPROBE_EVENTS "
  72			   "or/and CONFIG_UPROBE_EVENTS.\n");
  73	else {
  74		char sbuf[STRERR_BUFSIZE];
  75		pr_warning("Failed to open kprobe events: %s.\n",
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  76			   str_error_r(-kerr, sbuf, sizeof(sbuf)));
  77		pr_warning("Failed to open uprobe events: %s.\n",
 
 
  78			   str_error_r(-uerr, sbuf, sizeof(sbuf)));
  79	}
  80}
  81
  82int open_trace_file(const char *trace_file, bool readwrite)
  83{
  84	char buf[PATH_MAX];
  85	int ret;
  86
  87	ret = e_snprintf(buf, PATH_MAX, "%s/%s",
  88			 tracing_path, trace_file);
  89	if (ret >= 0) {
  90		pr_debug("Opening %s write=%d\n", buf, readwrite);
  91		if (readwrite && !probe_event_dry_run)
  92			ret = open(buf, O_RDWR | O_APPEND, 0);
  93		else
  94			ret = open(buf, O_RDONLY, 0);
  95
  96		if (ret < 0)
  97			ret = -errno;
  98	}
  99	return ret;
 100}
 101
 102static int open_kprobe_events(bool readwrite)
 103{
 104	return open_trace_file("kprobe_events", readwrite);
 105}
 106
 107static int open_uprobe_events(bool readwrite)
 108{
 109	return open_trace_file("uprobe_events", readwrite);
 110}
 111
 112int probe_file__open(int flag)
 113{
 114	int fd;
 115
 116	if (flag & PF_FL_UPROBE)
 117		fd = open_uprobe_events(flag & PF_FL_RW);
 118	else
 119		fd = open_kprobe_events(flag & PF_FL_RW);
 120	if (fd < 0)
 121		print_open_warning(fd, flag & PF_FL_UPROBE);
 122
 123	return fd;
 124}
 125
 126int probe_file__open_both(int *kfd, int *ufd, int flag)
 127{
 128	if (!kfd || !ufd)
 129		return -EINVAL;
 130
 131	*kfd = open_kprobe_events(flag & PF_FL_RW);
 132	*ufd = open_uprobe_events(flag & PF_FL_RW);
 133	if (*kfd < 0 && *ufd < 0) {
 134		print_both_open_warning(*kfd, *ufd);
 135		return *kfd;
 136	}
 137
 138	return 0;
 139}
 140
 141/* Get raw string list of current kprobe_events  or uprobe_events */
 142struct strlist *probe_file__get_rawlist(int fd)
 143{
 144	int ret, idx, fddup;
 145	FILE *fp;
 146	char buf[MAX_CMDLEN];
 147	char *p;
 148	struct strlist *sl;
 149
 150	if (fd < 0)
 151		return NULL;
 152
 153	sl = strlist__new(NULL, NULL);
 154	if (sl == NULL)
 155		return NULL;
 156
 157	fddup = dup(fd);
 158	if (fddup < 0)
 159		goto out_free_sl;
 160
 161	fp = fdopen(fddup, "r");
 162	if (!fp)
 163		goto out_close_fddup;
 164
 165	while (!feof(fp)) {
 166		p = fgets(buf, MAX_CMDLEN, fp);
 167		if (!p)
 168			break;
 169
 170		idx = strlen(p) - 1;
 171		if (p[idx] == '\n')
 172			p[idx] = '\0';
 173		ret = strlist__add(sl, buf);
 174		if (ret < 0) {
 175			pr_debug("strlist__add failed (%d)\n", ret);
 176			goto out_close_fp;
 177		}
 178	}
 179	fclose(fp);
 180
 181	return sl;
 182
 183out_close_fp:
 184	fclose(fp);
 185	goto out_free_sl;
 186out_close_fddup:
 187	close(fddup);
 188out_free_sl:
 189	strlist__delete(sl);
 190	return NULL;
 191}
 192
 193static struct strlist *__probe_file__get_namelist(int fd, bool include_group)
 194{
 195	char buf[128];
 196	struct strlist *sl, *rawlist;
 197	struct str_node *ent;
 198	struct probe_trace_event tev;
 199	int ret = 0;
 200
 201	memset(&tev, 0, sizeof(tev));
 202	rawlist = probe_file__get_rawlist(fd);
 203	if (!rawlist)
 204		return NULL;
 205	sl = strlist__new(NULL, NULL);
 206	strlist__for_each_entry(ent, rawlist) {
 207		ret = parse_probe_trace_command(ent->s, &tev);
 208		if (ret < 0)
 209			break;
 210		if (include_group) {
 211			ret = e_snprintf(buf, 128, "%s:%s", tev.group,
 212					tev.event);
 213			if (ret >= 0)
 214				ret = strlist__add(sl, buf);
 215		} else
 216			ret = strlist__add(sl, tev.event);
 217		clear_probe_trace_event(&tev);
 
 
 
 218		if (ret < 0)
 219			break;
 220	}
 221	strlist__delete(rawlist);
 222
 223	if (ret < 0) {
 224		strlist__delete(sl);
 225		return NULL;
 226	}
 227	return sl;
 228}
 229
 230/* Get current perf-probe event names */
 231struct strlist *probe_file__get_namelist(int fd)
 232{
 233	return __probe_file__get_namelist(fd, false);
 234}
 235
 236int probe_file__add_event(int fd, struct probe_trace_event *tev)
 237{
 238	int ret = 0;
 239	char *buf = synthesize_probe_trace_command(tev);
 240	char sbuf[STRERR_BUFSIZE];
 241
 242	if (!buf) {
 243		pr_debug("Failed to synthesize probe trace event.\n");
 244		return -EINVAL;
 245	}
 246
 247	pr_debug("Writing event: %s\n", buf);
 248	if (!probe_event_dry_run) {
 249		if (write(fd, buf, strlen(buf)) < (int)strlen(buf)) {
 250			ret = -errno;
 251			pr_warning("Failed to write event: %s\n",
 252				   str_error_r(errno, sbuf, sizeof(sbuf)));
 253		}
 254	}
 255	free(buf);
 256
 257	return ret;
 258}
 259
 260static int __del_trace_probe_event(int fd, struct str_node *ent)
 261{
 262	char *p;
 263	char buf[128];
 264	int ret;
 265
 266	/* Convert from perf-probe event to trace-probe event */
 267	ret = e_snprintf(buf, 128, "-:%s", ent->s);
 268	if (ret < 0)
 269		goto error;
 270
 271	p = strchr(buf + 2, ':');
 272	if (!p) {
 273		pr_debug("Internal error: %s should have ':' but not.\n",
 274			 ent->s);
 275		ret = -ENOTSUP;
 276		goto error;
 277	}
 278	*p = '/';
 279
 280	pr_debug("Writing event: %s\n", buf);
 281	ret = write(fd, buf, strlen(buf));
 282	if (ret < 0) {
 283		ret = -errno;
 284		goto error;
 285	}
 286
 287	return 0;
 288error:
 289	pr_warning("Failed to delete event: %s\n",
 290		   str_error_r(-ret, buf, sizeof(buf)));
 291	return ret;
 292}
 293
 294int probe_file__get_events(int fd, struct strfilter *filter,
 295			   struct strlist *plist)
 296{
 297	struct strlist *namelist;
 298	struct str_node *ent;
 299	const char *p;
 300	int ret = -ENOENT;
 301
 302	if (!plist)
 303		return -EINVAL;
 304
 305	namelist = __probe_file__get_namelist(fd, true);
 306	if (!namelist)
 307		return -ENOENT;
 308
 309	strlist__for_each_entry(ent, namelist) {
 310		p = strchr(ent->s, ':');
 311		if ((p && strfilter__compare(filter, p + 1)) ||
 312		    strfilter__compare(filter, ent->s)) {
 313			strlist__add(plist, ent->s);
 
 
 
 
 314			ret = 0;
 315		}
 316	}
 
 317	strlist__delete(namelist);
 318
 319	return ret;
 320}
 321
 322int probe_file__del_strlist(int fd, struct strlist *namelist)
 323{
 324	int ret = 0;
 325	struct str_node *ent;
 326
 327	strlist__for_each_entry(ent, namelist) {
 328		ret = __del_trace_probe_event(fd, ent);
 329		if (ret < 0)
 330			break;
 331	}
 332	return ret;
 333}
 334
 335int probe_file__del_events(int fd, struct strfilter *filter)
 336{
 337	struct strlist *namelist;
 338	int ret;
 339
 340	namelist = strlist__new(NULL, NULL);
 341	if (!namelist)
 342		return -ENOMEM;
 343
 344	ret = probe_file__get_events(fd, filter, namelist);
 345	if (ret < 0)
 346		return ret;
 347
 348	ret = probe_file__del_strlist(fd, namelist);
 349	strlist__delete(namelist);
 350
 351	return ret;
 352}
 353
 354/* Caller must ensure to remove this entry from list */
 355static void probe_cache_entry__delete(struct probe_cache_entry *entry)
 356{
 357	if (entry) {
 358		BUG_ON(!list_empty(&entry->node));
 359
 360		strlist__delete(entry->tevlist);
 361		clear_perf_probe_event(&entry->pev);
 362		zfree(&entry->spev);
 363		free(entry);
 364	}
 365}
 366
 367static struct probe_cache_entry *
 368probe_cache_entry__new(struct perf_probe_event *pev)
 369{
 370	struct probe_cache_entry *entry = zalloc(sizeof(*entry));
 371
 372	if (entry) {
 373		INIT_LIST_HEAD(&entry->node);
 374		entry->tevlist = strlist__new(NULL, NULL);
 375		if (!entry->tevlist)
 376			zfree(&entry);
 377		else if (pev) {
 378			entry->spev = synthesize_perf_probe_command(pev);
 379			if (!entry->spev ||
 380			    perf_probe_event__copy(&entry->pev, pev) < 0) {
 381				probe_cache_entry__delete(entry);
 382				return NULL;
 383			}
 384		}
 385	}
 386
 387	return entry;
 388}
 389
 390int probe_cache_entry__get_event(struct probe_cache_entry *entry,
 391				 struct probe_trace_event **tevs)
 392{
 393	struct probe_trace_event *tev;
 394	struct str_node *node;
 395	int ret, i;
 396
 397	ret = strlist__nr_entries(entry->tevlist);
 398	if (ret > probe_conf.max_probes)
 399		return -E2BIG;
 400
 401	*tevs = zalloc(ret * sizeof(*tev));
 402	if (!*tevs)
 403		return -ENOMEM;
 404
 405	i = 0;
 406	strlist__for_each_entry(node, entry->tevlist) {
 407		tev = &(*tevs)[i++];
 408		ret = parse_probe_trace_command(node->s, tev);
 409		if (ret < 0)
 410			break;
 411	}
 412	return i;
 413}
 414
 415/* For the kernel probe caches, pass target = NULL or DSO__NAME_KALLSYMS */
 416static int probe_cache__open(struct probe_cache *pcache, const char *target,
 417			     struct nsinfo *nsi)
 418{
 419	char cpath[PATH_MAX];
 420	char sbuildid[SBUILD_ID_SIZE];
 421	char *dir_name = NULL;
 422	bool is_kallsyms = false;
 423	int ret, fd;
 424	struct nscookie nsc;
 425
 426	if (target && build_id_cache__cached(target)) {
 427		/* This is a cached buildid */
 428		strncpy(sbuildid, target, SBUILD_ID_SIZE);
 429		dir_name = build_id_cache__linkname(sbuildid, NULL, 0);
 430		goto found;
 431	}
 432
 433	if (!target || !strcmp(target, DSO__NAME_KALLSYMS)) {
 434		target = DSO__NAME_KALLSYMS;
 435		is_kallsyms = true;
 436		ret = sysfs__sprintf_build_id("/", sbuildid);
 437	} else {
 438		nsinfo__mountns_enter(nsi, &nsc);
 439		ret = filename__sprintf_build_id(target, sbuildid);
 440		nsinfo__mountns_exit(&nsc);
 441	}
 442
 443	if (ret < 0) {
 444		pr_debug("Failed to get build-id from %s.\n", target);
 445		return ret;
 446	}
 447
 448	/* If we have no buildid cache, make it */
 449	if (!build_id_cache__cached(sbuildid)) {
 450		ret = build_id_cache__add_s(sbuildid, target, nsi,
 451					    is_kallsyms, NULL);
 452		if (ret < 0) {
 453			pr_debug("Failed to add build-id cache: %s\n", target);
 454			return ret;
 455		}
 456	}
 457
 458	dir_name = build_id_cache__cachedir(sbuildid, target, nsi, is_kallsyms,
 459					    false);
 460found:
 461	if (!dir_name) {
 462		pr_debug("Failed to get cache from %s\n", target);
 463		return -ENOMEM;
 464	}
 465
 466	snprintf(cpath, PATH_MAX, "%s/probes", dir_name);
 467	fd = open(cpath, O_CREAT | O_RDWR, 0644);
 468	if (fd < 0)
 469		pr_debug("Failed to open cache(%d): %s\n", fd, cpath);
 470	free(dir_name);
 471	pcache->fd = fd;
 472
 473	return fd;
 474}
 475
 476static int probe_cache__load(struct probe_cache *pcache)
 477{
 478	struct probe_cache_entry *entry = NULL;
 479	char buf[MAX_CMDLEN], *p;
 480	int ret = 0, fddup;
 481	FILE *fp;
 482
 483	fddup = dup(pcache->fd);
 484	if (fddup < 0)
 485		return -errno;
 486	fp = fdopen(fddup, "r");
 487	if (!fp) {
 488		close(fddup);
 489		return -EINVAL;
 490	}
 491
 492	while (!feof(fp)) {
 493		if (!fgets(buf, MAX_CMDLEN, fp))
 494			break;
 495		p = strchr(buf, '\n');
 496		if (p)
 497			*p = '\0';
 498		/* #perf_probe_event or %sdt_event */
 499		if (buf[0] == '#' || buf[0] == '%') {
 500			entry = probe_cache_entry__new(NULL);
 501			if (!entry) {
 502				ret = -ENOMEM;
 503				goto out;
 504			}
 505			if (buf[0] == '%')
 506				entry->sdt = true;
 507			entry->spev = strdup(buf + 1);
 508			if (entry->spev)
 509				ret = parse_perf_probe_command(buf + 1,
 510								&entry->pev);
 511			else
 512				ret = -ENOMEM;
 513			if (ret < 0) {
 514				probe_cache_entry__delete(entry);
 515				goto out;
 516			}
 517			list_add_tail(&entry->node, &pcache->entries);
 518		} else {	/* trace_probe_event */
 519			if (!entry) {
 520				ret = -EINVAL;
 521				goto out;
 522			}
 523			strlist__add(entry->tevlist, buf);
 
 
 
 
 524		}
 525	}
 526out:
 527	fclose(fp);
 528	return ret;
 529}
 530
 531static struct probe_cache *probe_cache__alloc(void)
 532{
 533	struct probe_cache *pcache = zalloc(sizeof(*pcache));
 534
 535	if (pcache) {
 536		INIT_LIST_HEAD(&pcache->entries);
 537		pcache->fd = -EINVAL;
 538	}
 539	return pcache;
 540}
 541
 542void probe_cache__purge(struct probe_cache *pcache)
 543{
 544	struct probe_cache_entry *entry, *n;
 545
 546	list_for_each_entry_safe(entry, n, &pcache->entries, node) {
 547		list_del_init(&entry->node);
 548		probe_cache_entry__delete(entry);
 549	}
 550}
 551
 552void probe_cache__delete(struct probe_cache *pcache)
 553{
 554	if (!pcache)
 555		return;
 556
 557	probe_cache__purge(pcache);
 558	if (pcache->fd > 0)
 559		close(pcache->fd);
 560	free(pcache);
 561}
 562
 563struct probe_cache *probe_cache__new(const char *target, struct nsinfo *nsi)
 564{
 565	struct probe_cache *pcache = probe_cache__alloc();
 566	int ret;
 567
 568	if (!pcache)
 569		return NULL;
 570
 571	ret = probe_cache__open(pcache, target, nsi);
 572	if (ret < 0) {
 573		pr_debug("Cache open error: %d\n", ret);
 574		goto out_err;
 575	}
 576
 577	ret = probe_cache__load(pcache);
 578	if (ret < 0) {
 579		pr_debug("Cache read error: %d\n", ret);
 580		goto out_err;
 581	}
 582
 583	return pcache;
 584
 585out_err:
 586	probe_cache__delete(pcache);
 587	return NULL;
 588}
 589
 590static bool streql(const char *a, const char *b)
 591{
 592	if (a == b)
 593		return true;
 594
 595	if (!a || !b)
 596		return false;
 597
 598	return !strcmp(a, b);
 599}
 600
 601struct probe_cache_entry *
 602probe_cache__find(struct probe_cache *pcache, struct perf_probe_event *pev)
 603{
 604	struct probe_cache_entry *entry = NULL;
 605	char *cmd = synthesize_perf_probe_command(pev);
 606
 607	if (!cmd)
 608		return NULL;
 609
 610	for_each_probe_cache_entry(entry, pcache) {
 611		if (pev->sdt) {
 612			if (entry->pev.event &&
 613			    streql(entry->pev.event, pev->event) &&
 614			    (!pev->group ||
 615			     streql(entry->pev.group, pev->group)))
 616				goto found;
 617
 618			continue;
 619		}
 620		/* Hit if same event name or same command-string */
 621		if ((pev->event &&
 622		     (streql(entry->pev.group, pev->group) &&
 623		      streql(entry->pev.event, pev->event))) ||
 624		    (!strcmp(entry->spev, cmd)))
 625			goto found;
 626	}
 627	entry = NULL;
 628
 629found:
 630	free(cmd);
 631	return entry;
 632}
 633
 634struct probe_cache_entry *
 635probe_cache__find_by_name(struct probe_cache *pcache,
 636			  const char *group, const char *event)
 637{
 638	struct probe_cache_entry *entry = NULL;
 639
 640	for_each_probe_cache_entry(entry, pcache) {
 641		/* Hit if same event name or same command-string */
 642		if (streql(entry->pev.group, group) &&
 643		    streql(entry->pev.event, event))
 644			goto found;
 645	}
 646	entry = NULL;
 647
 648found:
 649	return entry;
 650}
 651
 652int probe_cache__add_entry(struct probe_cache *pcache,
 653			   struct perf_probe_event *pev,
 654			   struct probe_trace_event *tevs, int ntevs)
 655{
 656	struct probe_cache_entry *entry = NULL;
 657	char *command;
 658	int i, ret = 0;
 659
 660	if (!pcache || !pev || !tevs || ntevs <= 0) {
 661		ret = -EINVAL;
 662		goto out_err;
 663	}
 664
 665	/* Remove old cache entry */
 666	entry = probe_cache__find(pcache, pev);
 667	if (entry) {
 668		list_del_init(&entry->node);
 669		probe_cache_entry__delete(entry);
 670	}
 671
 672	ret = -ENOMEM;
 673	entry = probe_cache_entry__new(pev);
 674	if (!entry)
 675		goto out_err;
 676
 677	for (i = 0; i < ntevs; i++) {
 678		if (!tevs[i].point.symbol)
 679			continue;
 680
 681		command = synthesize_probe_trace_command(&tevs[i]);
 682		if (!command)
 683			goto out_err;
 684		strlist__add(entry->tevlist, command);
 
 
 
 
 
 685		free(command);
 686	}
 687	list_add_tail(&entry->node, &pcache->entries);
 688	pr_debug("Added probe cache: %d\n", ntevs);
 689	return 0;
 690
 691out_err:
 692	pr_debug("Failed to add probe caches\n");
 693	probe_cache_entry__delete(entry);
 694	return ret;
 695}
 696
 697#ifdef HAVE_GELF_GETNOTE_SUPPORT
 698static unsigned long long sdt_note__get_addr(struct sdt_note *note)
 699{
 700	return note->bit32 ? (unsigned long long)note->addr.a32[0]
 701		 : (unsigned long long)note->addr.a64[0];
 
 
 
 
 
 
 
 
 702}
 703
 704static const char * const type_to_suffix[] = {
 705	":s64", "", "", "", ":s32", "", ":s16", ":s8",
 706	"", ":u8", ":u16", "", ":u32", "", "", "", ":u64"
 707};
 708
 709/*
 710 * Isolate the string number and convert it into a decimal value;
 711 * this will be an index to get suffix of the uprobe name (defining
 712 * the type)
 713 */
 714static int sdt_arg_parse_size(char *n_ptr, const char **suffix)
 715{
 716	long type_idx;
 717
 718	type_idx = strtol(n_ptr, NULL, 10);
 719	if (type_idx < -8 || type_idx > 8) {
 720		pr_debug4("Failed to get a valid sdt type\n");
 721		return -1;
 722	}
 723
 724	*suffix = type_to_suffix[type_idx + 8];
 725	return 0;
 726}
 727
 728static int synthesize_sdt_probe_arg(struct strbuf *buf, int i, const char *arg)
 729{
 730	char *op, *desc = strdup(arg), *new_op = NULL;
 731	const char *suffix = "";
 732	int ret = -1;
 733
 734	if (desc == NULL) {
 735		pr_debug4("Allocation error\n");
 736		return ret;
 737	}
 738
 739	/*
 740	 * Argument is in N@OP format. N is size of the argument and OP is
 741	 * the actual assembly operand. N can be omitted; in that case
 742	 * argument is just OP(without @).
 743	 */
 744	op = strchr(desc, '@');
 745	if (op) {
 746		op[0] = '\0';
 747		op++;
 748
 749		if (sdt_arg_parse_size(desc, &suffix))
 750			goto error;
 751	} else {
 752		op = desc;
 753	}
 754
 755	ret = arch_sdt_arg_parse_op(op, &new_op);
 756
 757	if (ret < 0)
 758		goto error;
 759
 760	if (ret == SDT_ARG_VALID) {
 761		ret = strbuf_addf(buf, " arg%d=%s%s", i + 1, new_op, suffix);
 762		if (ret < 0)
 763			goto error;
 764	}
 765
 766	ret = 0;
 767error:
 768	free(desc);
 769	free(new_op);
 770	return ret;
 771}
 772
 773static char *synthesize_sdt_probe_command(struct sdt_note *note,
 774					const char *pathname,
 775					const char *sdtgrp)
 776{
 777	struct strbuf buf;
 778	char *ret = NULL, **args;
 779	int i, args_count;
 
 
 
 780
 781	if (strbuf_init(&buf, 32) < 0)
 782		return NULL;
 783
 784	if (strbuf_addf(&buf, "p:%s/%s %s:0x%llx",
 785				sdtgrp, note->name, pathname,
 786				sdt_note__get_addr(note)) < 0)
 
 
 
 
 
 
 787		goto error;
 788
 789	if (!note->args)
 790		goto out;
 791
 792	if (note->args) {
 793		args = argv_split(note->args, &args_count);
 794
 795		for (i = 0; i < args_count; ++i) {
 796			if (synthesize_sdt_probe_arg(&buf, i, args[i]) < 0)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 797				goto error;
 
 
 
 
 
 
 
 
 
 
 798		}
 
 
 799	}
 800
 801out:
 802	ret = strbuf_detach(&buf, NULL);
 803error:
 804	strbuf_release(&buf);
 805	return ret;
 806}
 807
 808int probe_cache__scan_sdt(struct probe_cache *pcache, const char *pathname)
 809{
 810	struct probe_cache_entry *entry = NULL;
 811	struct list_head sdtlist;
 812	struct sdt_note *note;
 813	char *buf;
 814	char sdtgrp[64];
 815	int ret;
 816
 817	INIT_LIST_HEAD(&sdtlist);
 818	ret = get_sdt_note_list(&sdtlist, pathname);
 819	if (ret < 0) {
 820		pr_debug4("Failed to get sdt note: %d\n", ret);
 821		return ret;
 822	}
 823	list_for_each_entry(note, &sdtlist, note_list) {
 824		ret = snprintf(sdtgrp, 64, "sdt_%s", note->provider);
 825		if (ret < 0)
 826			break;
 827		/* Try to find same-name entry */
 828		entry = probe_cache__find_by_name(pcache, sdtgrp, note->name);
 829		if (!entry) {
 830			entry = probe_cache_entry__new(NULL);
 831			if (!entry) {
 832				ret = -ENOMEM;
 833				break;
 834			}
 835			entry->sdt = true;
 836			ret = asprintf(&entry->spev, "%s:%s=%s", sdtgrp,
 837					note->name, note->name);
 838			if (ret < 0)
 839				break;
 840			entry->pev.event = strdup(note->name);
 841			entry->pev.group = strdup(sdtgrp);
 842			list_add_tail(&entry->node, &pcache->entries);
 843		}
 844		buf = synthesize_sdt_probe_command(note, pathname, sdtgrp);
 845		if (!buf) {
 846			ret = -ENOMEM;
 847			break;
 848		}
 849
 850		strlist__add(entry->tevlist, buf);
 
 851		free(buf);
 852		entry = NULL;
 
 
 
 
 
 853	}
 854	if (entry) {
 855		list_del_init(&entry->node);
 856		probe_cache_entry__delete(entry);
 857	}
 858	cleanup_sdt_note_list(&sdtlist);
 859	return ret;
 860}
 861#endif
 862
 863static int probe_cache_entry__write(struct probe_cache_entry *entry, int fd)
 864{
 865	struct str_node *snode;
 866	struct stat st;
 867	struct iovec iov[3];
 868	const char *prefix = entry->sdt ? "%" : "#";
 869	int ret;
 870	/* Save stat for rollback */
 871	ret = fstat(fd, &st);
 872	if (ret < 0)
 873		return ret;
 874
 875	pr_debug("Writing cache: %s%s\n", prefix, entry->spev);
 876	iov[0].iov_base = (void *)prefix; iov[0].iov_len = 1;
 877	iov[1].iov_base = entry->spev; iov[1].iov_len = strlen(entry->spev);
 878	iov[2].iov_base = (void *)"\n"; iov[2].iov_len = 1;
 879	ret = writev(fd, iov, 3);
 880	if (ret < (int)iov[1].iov_len + 2)
 881		goto rollback;
 882
 883	strlist__for_each_entry(snode, entry->tevlist) {
 884		iov[0].iov_base = (void *)snode->s;
 885		iov[0].iov_len = strlen(snode->s);
 886		iov[1].iov_base = (void *)"\n"; iov[1].iov_len = 1;
 887		ret = writev(fd, iov, 2);
 888		if (ret < (int)iov[0].iov_len + 1)
 889			goto rollback;
 890	}
 891	return 0;
 892
 893rollback:
 894	/* Rollback to avoid cache file corruption */
 895	if (ret > 0)
 896		ret = -1;
 897	if (ftruncate(fd, st.st_size) < 0)
 898		ret = -2;
 899
 900	return ret;
 901}
 902
 903int probe_cache__commit(struct probe_cache *pcache)
 904{
 905	struct probe_cache_entry *entry;
 906	int ret = 0;
 907
 908	/* TBD: if we do not update existing entries, skip it */
 909	ret = lseek(pcache->fd, 0, SEEK_SET);
 910	if (ret < 0)
 911		goto out;
 912
 913	ret = ftruncate(pcache->fd, 0);
 914	if (ret < 0)
 915		goto out;
 916
 917	for_each_probe_cache_entry(entry, pcache) {
 918		ret = probe_cache_entry__write(entry, pcache->fd);
 919		pr_debug("Cache committed: %d\n", ret);
 920		if (ret < 0)
 921			break;
 922	}
 923out:
 924	return ret;
 925}
 926
 927static bool probe_cache_entry__compare(struct probe_cache_entry *entry,
 928				       struct strfilter *filter)
 929{
 930	char buf[128], *ptr = entry->spev;
 931
 932	if (entry->pev.event) {
 933		snprintf(buf, 128, "%s:%s", entry->pev.group, entry->pev.event);
 934		ptr = buf;
 935	}
 936	return strfilter__compare(filter, ptr);
 937}
 938
 939int probe_cache__filter_purge(struct probe_cache *pcache,
 940			      struct strfilter *filter)
 941{
 942	struct probe_cache_entry *entry, *tmp;
 943
 944	list_for_each_entry_safe(entry, tmp, &pcache->entries, node) {
 945		if (probe_cache_entry__compare(entry, filter)) {
 946			pr_info("Removed cached event: %s\n", entry->spev);
 947			list_del_init(&entry->node);
 948			probe_cache_entry__delete(entry);
 949		}
 950	}
 951	return 0;
 952}
 953
 954static int probe_cache__show_entries(struct probe_cache *pcache,
 955				     struct strfilter *filter)
 956{
 957	struct probe_cache_entry *entry;
 958
 959	for_each_probe_cache_entry(entry, pcache) {
 960		if (probe_cache_entry__compare(entry, filter))
 961			printf("%s\n", entry->spev);
 962	}
 963	return 0;
 964}
 965
 966/* Show all cached probes */
 967int probe_cache__show_all_caches(struct strfilter *filter)
 968{
 969	struct probe_cache *pcache;
 970	struct strlist *bidlist;
 971	struct str_node *nd;
 972	char *buf = strfilter__string(filter);
 973
 974	pr_debug("list cache with filter: %s\n", buf);
 975	free(buf);
 976
 977	bidlist = build_id_cache__list_all(true);
 978	if (!bidlist) {
 979		pr_debug("Failed to get buildids: %d\n", errno);
 980		return -EINVAL;
 981	}
 982	strlist__for_each_entry(nd, bidlist) {
 983		pcache = probe_cache__new(nd->s, NULL);
 984		if (!pcache)
 985			continue;
 986		if (!list_empty(&pcache->entries)) {
 987			buf = build_id_cache__origname(nd->s);
 988			printf("%s (%s):\n", buf, nd->s);
 989			free(buf);
 990			probe_cache__show_entries(pcache, filter);
 991		}
 992		probe_cache__delete(pcache);
 993	}
 994	strlist__delete(bidlist);
 995
 996	return 0;
 997}
 998
 999enum ftrace_readme {
1000	FTRACE_README_PROBE_TYPE_X = 0,
1001	FTRACE_README_KRETPROBE_OFFSET,
 
 
 
 
1002	FTRACE_README_END,
1003};
1004
1005static struct {
1006	const char *pattern;
1007	bool avail;
1008} ftrace_readme_table[] = {
1009#define DEFINE_TYPE(idx, pat)			\
1010	[idx] = {.pattern = pat, .avail = false}
1011	DEFINE_TYPE(FTRACE_README_PROBE_TYPE_X, "*type: * x8/16/32/64,*"),
1012	DEFINE_TYPE(FTRACE_README_KRETPROBE_OFFSET, "*place (kretprobe): *"),
 
 
 
 
1013};
1014
1015static bool scan_ftrace_readme(enum ftrace_readme type)
1016{
1017	int fd;
1018	FILE *fp;
1019	char *buf = NULL;
1020	size_t len = 0;
1021	bool ret = false;
1022	static bool scanned = false;
1023
1024	if (scanned)
1025		goto result;
1026
1027	fd = open_trace_file("README", false);
1028	if (fd < 0)
1029		return ret;
1030
1031	fp = fdopen(fd, "r");
1032	if (!fp) {
1033		close(fd);
1034		return ret;
1035	}
1036
1037	while (getline(&buf, &len, fp) > 0)
1038		for (enum ftrace_readme i = 0; i < FTRACE_README_END; i++)
1039			if (!ftrace_readme_table[i].avail)
1040				ftrace_readme_table[i].avail =
1041					strglobmatch(buf, ftrace_readme_table[i].pattern);
1042	scanned = true;
1043
1044	fclose(fp);
1045	free(buf);
1046
1047result:
1048	if (type >= FTRACE_README_END)
1049		return false;
1050
1051	return ftrace_readme_table[type].avail;
1052}
1053
1054bool probe_type_is_available(enum probe_type type)
1055{
1056	if (type >= PROBE_TYPE_END)
1057		return false;
1058	else if (type == PROBE_TYPE_X)
1059		return scan_ftrace_readme(FTRACE_README_PROBE_TYPE_X);
1060
1061	return true;
1062}
1063
1064bool kretprobe_offset_is_supported(void)
1065{
1066	return scan_ftrace_readme(FTRACE_README_KRETPROBE_OFFSET);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1067}
v6.13.7
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 * probe-file.c : operate ftrace k/uprobe events files
   4 *
   5 * Written by Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
 
 
 
 
 
 
 
 
 
 
 
   6 */
   7#include <errno.h>
   8#include <fcntl.h>
   9#include <sys/stat.h>
  10#include <sys/types.h>
  11#include <sys/uio.h>
  12#include <unistd.h>
  13#include <linux/zalloc.h>
  14#include "namespaces.h"
  15#include "event.h"
  16#include "strlist.h"
  17#include "strfilter.h"
  18#include "debug.h"
  19#include "build-id.h"
  20#include "dso.h"
  21#include "color.h"
  22#include "symbol.h"
  23#include "strbuf.h"
  24#include <api/fs/tracing_path.h>
  25#include <api/fs/fs.h>
  26#include "probe-event.h"
  27#include "probe-file.h"
  28#include "session.h"
  29#include "perf_regs.h"
  30#include "string2.h"
  31
  32/* 4096 - 2 ('\n' + '\0') */
  33#define MAX_CMDLEN 4094
  34
  35static bool print_common_warning(int err, bool readwrite)
  36{
  37	if (err == -EACCES)
  38		pr_warning("No permission to %s tracefs.\nPlease %s\n",
  39			   readwrite ? "write" : "read",
  40			   readwrite ? "run this command again with sudo." :
  41				       "try 'sudo mount -o remount,mode=755 /sys/kernel/tracing/'");
  42	else
  43		return false;
  44
  45	return true;
  46}
  47
  48static bool print_configure_probe_event(int kerr, int uerr)
  49{
  50	const char *config, *file;
  51
  52	if (kerr == -ENOENT && uerr == -ENOENT) {
  53		file = "{k,u}probe_events";
  54		config = "CONFIG_KPROBE_EVENTS=y and CONFIG_UPROBE_EVENTS=y";
  55	} else if (kerr == -ENOENT) {
  56		file = "kprobe_events";
  57		config = "CONFIG_KPROBE_EVENTS=y";
  58	} else if (uerr == -ENOENT) {
  59		file = "uprobe_events";
  60		config = "CONFIG_UPROBE_EVENTS=y";
  61	} else
  62		return false;
  63
  64	if (!debugfs__configured() && !tracefs__configured())
  65		pr_warning("Debugfs or tracefs is not mounted\n"
  66			   "Please try 'sudo mount -t tracefs nodev /sys/kernel/tracing/'\n");
 
 
  67	else
  68		pr_warning("%s/%s does not exist.\nPlease rebuild kernel with %s.\n",
  69			   tracing_path_mount(), file, config);
  70
  71	return true;
  72}
  73
  74static void print_open_warning(int err, bool uprobe, bool readwrite)
  75{
  76	char sbuf[STRERR_BUFSIZE];
  77
  78	if (print_common_warning(err, readwrite))
  79		return;
  80
  81	if (print_configure_probe_event(uprobe ? 0 : err, uprobe ? err : 0))
  82		return;
  83
  84	pr_warning("Failed to open %s/%cprobe_events: %s\n",
  85		   tracing_path_mount(), uprobe ? 'u' : 'k',
  86		   str_error_r(-err, sbuf, sizeof(sbuf)));
  87}
  88
  89static void print_both_open_warning(int kerr, int uerr, bool readwrite)
  90{
  91	char sbuf[STRERR_BUFSIZE];
  92
  93	if (kerr == uerr && print_common_warning(kerr, readwrite))
  94		return;
  95
  96	if (print_configure_probe_event(kerr, uerr))
  97		return;
  98
  99	if (kerr < 0)
 100		pr_warning("Failed to open %s/kprobe_events: %s.\n",
 101			   tracing_path_mount(),
 102			   str_error_r(-kerr, sbuf, sizeof(sbuf)));
 103	if (uerr < 0)
 104		pr_warning("Failed to open %s/uprobe_events: %s.\n",
 105			   tracing_path_mount(),
 106			   str_error_r(-uerr, sbuf, sizeof(sbuf)));
 
 107}
 108
 109int open_trace_file(const char *trace_file, bool readwrite)
 110{
 111	char buf[PATH_MAX];
 112	int ret;
 113
 114	ret = e_snprintf(buf, PATH_MAX, "%s/%s", tracing_path_mount(), trace_file);
 
 115	if (ret >= 0) {
 116		pr_debug("Opening %s write=%d\n", buf, readwrite);
 117		if (readwrite && !probe_event_dry_run)
 118			ret = open(buf, O_RDWR | O_APPEND, 0);
 119		else
 120			ret = open(buf, O_RDONLY, 0);
 121
 122		if (ret < 0)
 123			ret = -errno;
 124	}
 125	return ret;
 126}
 127
 128static int open_kprobe_events(bool readwrite)
 129{
 130	return open_trace_file("kprobe_events", readwrite);
 131}
 132
 133static int open_uprobe_events(bool readwrite)
 134{
 135	return open_trace_file("uprobe_events", readwrite);
 136}
 137
 138int probe_file__open(int flag)
 139{
 140	int fd;
 141
 142	if (flag & PF_FL_UPROBE)
 143		fd = open_uprobe_events(flag & PF_FL_RW);
 144	else
 145		fd = open_kprobe_events(flag & PF_FL_RW);
 146	if (fd < 0)
 147		print_open_warning(fd, flag & PF_FL_UPROBE, flag & PF_FL_RW);
 148
 149	return fd;
 150}
 151
 152int probe_file__open_both(int *kfd, int *ufd, int flag)
 153{
 154	if (!kfd || !ufd)
 155		return -EINVAL;
 156
 157	*kfd = open_kprobe_events(flag & PF_FL_RW);
 158	*ufd = open_uprobe_events(flag & PF_FL_RW);
 159	if (*kfd < 0 && *ufd < 0) {
 160		print_both_open_warning(*kfd, *ufd, flag & PF_FL_RW);
 161		return *kfd;
 162	}
 163
 164	return 0;
 165}
 166
 167/* Get raw string list of current kprobe_events  or uprobe_events */
 168struct strlist *probe_file__get_rawlist(int fd)
 169{
 170	int ret, idx, fddup;
 171	FILE *fp;
 172	char buf[MAX_CMDLEN];
 173	char *p;
 174	struct strlist *sl;
 175
 176	if (fd < 0)
 177		return NULL;
 178
 179	sl = strlist__new(NULL, NULL);
 180	if (sl == NULL)
 181		return NULL;
 182
 183	fddup = dup(fd);
 184	if (fddup < 0)
 185		goto out_free_sl;
 186
 187	fp = fdopen(fddup, "r");
 188	if (!fp)
 189		goto out_close_fddup;
 190
 191	while (!feof(fp)) {
 192		p = fgets(buf, MAX_CMDLEN, fp);
 193		if (!p)
 194			break;
 195
 196		idx = strlen(p) - 1;
 197		if (p[idx] == '\n')
 198			p[idx] = '\0';
 199		ret = strlist__add(sl, buf);
 200		if (ret < 0) {
 201			pr_debug("strlist__add failed (%d)\n", ret);
 202			goto out_close_fp;
 203		}
 204	}
 205	fclose(fp);
 206
 207	return sl;
 208
 209out_close_fp:
 210	fclose(fp);
 211	goto out_free_sl;
 212out_close_fddup:
 213	close(fddup);
 214out_free_sl:
 215	strlist__delete(sl);
 216	return NULL;
 217}
 218
 219static struct strlist *__probe_file__get_namelist(int fd, bool include_group)
 220{
 221	char buf[128];
 222	struct strlist *sl, *rawlist;
 223	struct str_node *ent;
 224	struct probe_trace_event tev;
 225	int ret = 0;
 226
 227	memset(&tev, 0, sizeof(tev));
 228	rawlist = probe_file__get_rawlist(fd);
 229	if (!rawlist)
 230		return NULL;
 231	sl = strlist__new(NULL, NULL);
 232	strlist__for_each_entry(ent, rawlist) {
 233		ret = parse_probe_trace_command(ent->s, &tev);
 234		if (ret < 0)
 235			break;
 236		if (include_group) {
 237			ret = e_snprintf(buf, 128, "%s:%s", tev.group,
 238					tev.event);
 239			if (ret >= 0)
 240				ret = strlist__add(sl, buf);
 241		} else
 242			ret = strlist__add(sl, tev.event);
 243		clear_probe_trace_event(&tev);
 244		/* Skip if there is same name multi-probe event in the list */
 245		if (ret == -EEXIST)
 246			ret = 0;
 247		if (ret < 0)
 248			break;
 249	}
 250	strlist__delete(rawlist);
 251
 252	if (ret < 0) {
 253		strlist__delete(sl);
 254		return NULL;
 255	}
 256	return sl;
 257}
 258
 259/* Get current perf-probe event names */
 260struct strlist *probe_file__get_namelist(int fd)
 261{
 262	return __probe_file__get_namelist(fd, false);
 263}
 264
 265int probe_file__add_event(int fd, struct probe_trace_event *tev)
 266{
 267	int ret = 0;
 268	char *buf = synthesize_probe_trace_command(tev);
 269	char sbuf[STRERR_BUFSIZE];
 270
 271	if (!buf) {
 272		pr_debug("Failed to synthesize probe trace event.\n");
 273		return -EINVAL;
 274	}
 275
 276	pr_debug("Writing event: %s\n", buf);
 277	if (!probe_event_dry_run) {
 278		if (write(fd, buf, strlen(buf)) < (int)strlen(buf)) {
 279			ret = -errno;
 280			pr_warning("Failed to write event: %s\n",
 281				   str_error_r(errno, sbuf, sizeof(sbuf)));
 282		}
 283	}
 284	free(buf);
 285
 286	return ret;
 287}
 288
 289static int __del_trace_probe_event(int fd, struct str_node *ent)
 290{
 291	char *p;
 292	char buf[128];
 293	int ret;
 294
 295	/* Convert from perf-probe event to trace-probe event */
 296	ret = e_snprintf(buf, 128, "-:%s", ent->s);
 297	if (ret < 0)
 298		goto error;
 299
 300	p = strchr(buf + 2, ':');
 301	if (!p) {
 302		pr_debug("Internal error: %s should have ':' but not.\n",
 303			 ent->s);
 304		ret = -ENOTSUP;
 305		goto error;
 306	}
 307	*p = '/';
 308
 309	pr_debug("Writing event: %s\n", buf);
 310	ret = write(fd, buf, strlen(buf));
 311	if (ret < 0) {
 312		ret = -errno;
 313		goto error;
 314	}
 315
 316	return 0;
 317error:
 318	pr_warning("Failed to delete event: %s\n",
 319		   str_error_r(-ret, buf, sizeof(buf)));
 320	return ret;
 321}
 322
 323int probe_file__get_events(int fd, struct strfilter *filter,
 324			   struct strlist *plist)
 325{
 326	struct strlist *namelist;
 327	struct str_node *ent;
 328	const char *p;
 329	int ret = -ENOENT;
 330
 331	if (!plist)
 332		return -EINVAL;
 333
 334	namelist = __probe_file__get_namelist(fd, true);
 335	if (!namelist)
 336		return -ENOENT;
 337
 338	strlist__for_each_entry(ent, namelist) {
 339		p = strchr(ent->s, ':');
 340		if ((p && strfilter__compare(filter, p + 1)) ||
 341		    strfilter__compare(filter, ent->s)) {
 342			ret = strlist__add(plist, ent->s);
 343			if (ret == -ENOMEM) {
 344				pr_err("strlist__add failed with -ENOMEM\n");
 345				goto out;
 346			}
 347			ret = 0;
 348		}
 349	}
 350out:
 351	strlist__delete(namelist);
 352
 353	return ret;
 354}
 355
 356int probe_file__del_strlist(int fd, struct strlist *namelist)
 357{
 358	int ret = 0;
 359	struct str_node *ent;
 360
 361	strlist__for_each_entry(ent, namelist) {
 362		ret = __del_trace_probe_event(fd, ent);
 363		if (ret < 0)
 364			break;
 365	}
 366	return ret;
 367}
 368
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 369/* Caller must ensure to remove this entry from list */
 370static void probe_cache_entry__delete(struct probe_cache_entry *entry)
 371{
 372	if (entry) {
 373		BUG_ON(!list_empty(&entry->node));
 374
 375		strlist__delete(entry->tevlist);
 376		clear_perf_probe_event(&entry->pev);
 377		zfree(&entry->spev);
 378		free(entry);
 379	}
 380}
 381
 382static struct probe_cache_entry *
 383probe_cache_entry__new(struct perf_probe_event *pev)
 384{
 385	struct probe_cache_entry *entry = zalloc(sizeof(*entry));
 386
 387	if (entry) {
 388		INIT_LIST_HEAD(&entry->node);
 389		entry->tevlist = strlist__new(NULL, NULL);
 390		if (!entry->tevlist)
 391			zfree(&entry);
 392		else if (pev) {
 393			entry->spev = synthesize_perf_probe_command(pev);
 394			if (!entry->spev ||
 395			    perf_probe_event__copy(&entry->pev, pev) < 0) {
 396				probe_cache_entry__delete(entry);
 397				return NULL;
 398			}
 399		}
 400	}
 401
 402	return entry;
 403}
 404
 405int probe_cache_entry__get_event(struct probe_cache_entry *entry,
 406				 struct probe_trace_event **tevs)
 407{
 408	struct probe_trace_event *tev;
 409	struct str_node *node;
 410	int ret, i;
 411
 412	ret = strlist__nr_entries(entry->tevlist);
 413	if (ret > probe_conf.max_probes)
 414		return -E2BIG;
 415
 416	*tevs = zalloc(ret * sizeof(*tev));
 417	if (!*tevs)
 418		return -ENOMEM;
 419
 420	i = 0;
 421	strlist__for_each_entry(node, entry->tevlist) {
 422		tev = &(*tevs)[i++];
 423		ret = parse_probe_trace_command(node->s, tev);
 424		if (ret < 0)
 425			break;
 426	}
 427	return i;
 428}
 429
 430/* For the kernel probe caches, pass target = NULL or DSO__NAME_KALLSYMS */
 431static int probe_cache__open(struct probe_cache *pcache, const char *target,
 432			     struct nsinfo *nsi)
 433{
 434	char cpath[PATH_MAX];
 435	char sbuildid[SBUILD_ID_SIZE];
 436	char *dir_name = NULL;
 437	bool is_kallsyms = false;
 438	int ret, fd;
 439	struct nscookie nsc;
 440
 441	if (target && build_id_cache__cached(target)) {
 442		/* This is a cached buildid */
 443		strlcpy(sbuildid, target, SBUILD_ID_SIZE);
 444		dir_name = build_id_cache__linkname(sbuildid, NULL, 0);
 445		goto found;
 446	}
 447
 448	if (!target || !strcmp(target, DSO__NAME_KALLSYMS)) {
 449		target = DSO__NAME_KALLSYMS;
 450		is_kallsyms = true;
 451		ret = sysfs__sprintf_build_id("/", sbuildid);
 452	} else {
 453		nsinfo__mountns_enter(nsi, &nsc);
 454		ret = filename__sprintf_build_id(target, sbuildid);
 455		nsinfo__mountns_exit(&nsc);
 456	}
 457
 458	if (ret < 0) {
 459		pr_debug("Failed to get build-id from %s.\n", target);
 460		return ret;
 461	}
 462
 463	/* If we have no buildid cache, make it */
 464	if (!build_id_cache__cached(sbuildid)) {
 465		ret = build_id_cache__add_s(sbuildid, target, nsi,
 466					    is_kallsyms, NULL);
 467		if (ret < 0) {
 468			pr_debug("Failed to add build-id cache: %s\n", target);
 469			return ret;
 470		}
 471	}
 472
 473	dir_name = build_id_cache__cachedir(sbuildid, target, nsi, is_kallsyms,
 474					    false);
 475found:
 476	if (!dir_name) {
 477		pr_debug("Failed to get cache from %s\n", target);
 478		return -ENOMEM;
 479	}
 480
 481	snprintf(cpath, PATH_MAX, "%s/probes", dir_name);
 482	fd = open(cpath, O_CREAT | O_RDWR, 0644);
 483	if (fd < 0)
 484		pr_debug("Failed to open cache(%d): %s\n", fd, cpath);
 485	free(dir_name);
 486	pcache->fd = fd;
 487
 488	return fd;
 489}
 490
 491static int probe_cache__load(struct probe_cache *pcache)
 492{
 493	struct probe_cache_entry *entry = NULL;
 494	char buf[MAX_CMDLEN], *p;
 495	int ret = 0, fddup;
 496	FILE *fp;
 497
 498	fddup = dup(pcache->fd);
 499	if (fddup < 0)
 500		return -errno;
 501	fp = fdopen(fddup, "r");
 502	if (!fp) {
 503		close(fddup);
 504		return -EINVAL;
 505	}
 506
 507	while (!feof(fp)) {
 508		if (!fgets(buf, MAX_CMDLEN, fp))
 509			break;
 510		p = strchr(buf, '\n');
 511		if (p)
 512			*p = '\0';
 513		/* #perf_probe_event or %sdt_event */
 514		if (buf[0] == '#' || buf[0] == '%') {
 515			entry = probe_cache_entry__new(NULL);
 516			if (!entry) {
 517				ret = -ENOMEM;
 518				goto out;
 519			}
 520			if (buf[0] == '%')
 521				entry->sdt = true;
 522			entry->spev = strdup(buf + 1);
 523			if (entry->spev)
 524				ret = parse_perf_probe_command(buf + 1,
 525								&entry->pev);
 526			else
 527				ret = -ENOMEM;
 528			if (ret < 0) {
 529				probe_cache_entry__delete(entry);
 530				goto out;
 531			}
 532			list_add_tail(&entry->node, &pcache->entries);
 533		} else {	/* trace_probe_event */
 534			if (!entry) {
 535				ret = -EINVAL;
 536				goto out;
 537			}
 538			ret = strlist__add(entry->tevlist, buf);
 539			if (ret == -ENOMEM) {
 540				pr_err("strlist__add failed with -ENOMEM\n");
 541				goto out;
 542			}
 543		}
 544	}
 545out:
 546	fclose(fp);
 547	return ret;
 548}
 549
 550static struct probe_cache *probe_cache__alloc(void)
 551{
 552	struct probe_cache *pcache = zalloc(sizeof(*pcache));
 553
 554	if (pcache) {
 555		INIT_LIST_HEAD(&pcache->entries);
 556		pcache->fd = -EINVAL;
 557	}
 558	return pcache;
 559}
 560
 561void probe_cache__purge(struct probe_cache *pcache)
 562{
 563	struct probe_cache_entry *entry, *n;
 564
 565	list_for_each_entry_safe(entry, n, &pcache->entries, node) {
 566		list_del_init(&entry->node);
 567		probe_cache_entry__delete(entry);
 568	}
 569}
 570
 571void probe_cache__delete(struct probe_cache *pcache)
 572{
 573	if (!pcache)
 574		return;
 575
 576	probe_cache__purge(pcache);
 577	if (pcache->fd > 0)
 578		close(pcache->fd);
 579	free(pcache);
 580}
 581
 582struct probe_cache *probe_cache__new(const char *target, struct nsinfo *nsi)
 583{
 584	struct probe_cache *pcache = probe_cache__alloc();
 585	int ret;
 586
 587	if (!pcache)
 588		return NULL;
 589
 590	ret = probe_cache__open(pcache, target, nsi);
 591	if (ret < 0) {
 592		pr_debug("Cache open error: %d\n", ret);
 593		goto out_err;
 594	}
 595
 596	ret = probe_cache__load(pcache);
 597	if (ret < 0) {
 598		pr_debug("Cache read error: %d\n", ret);
 599		goto out_err;
 600	}
 601
 602	return pcache;
 603
 604out_err:
 605	probe_cache__delete(pcache);
 606	return NULL;
 607}
 608
 609static bool streql(const char *a, const char *b)
 610{
 611	if (a == b)
 612		return true;
 613
 614	if (!a || !b)
 615		return false;
 616
 617	return !strcmp(a, b);
 618}
 619
 620struct probe_cache_entry *
 621probe_cache__find(struct probe_cache *pcache, struct perf_probe_event *pev)
 622{
 623	struct probe_cache_entry *entry = NULL;
 624	char *cmd = synthesize_perf_probe_command(pev);
 625
 626	if (!cmd)
 627		return NULL;
 628
 629	for_each_probe_cache_entry(entry, pcache) {
 630		if (pev->sdt) {
 631			if (entry->pev.event &&
 632			    streql(entry->pev.event, pev->event) &&
 633			    (!pev->group ||
 634			     streql(entry->pev.group, pev->group)))
 635				goto found;
 636
 637			continue;
 638		}
 639		/* Hit if same event name or same command-string */
 640		if ((pev->event &&
 641		     (streql(entry->pev.group, pev->group) &&
 642		      streql(entry->pev.event, pev->event))) ||
 643		    (!strcmp(entry->spev, cmd)))
 644			goto found;
 645	}
 646	entry = NULL;
 647
 648found:
 649	free(cmd);
 650	return entry;
 651}
 652
 653struct probe_cache_entry *
 654probe_cache__find_by_name(struct probe_cache *pcache,
 655			  const char *group, const char *event)
 656{
 657	struct probe_cache_entry *entry = NULL;
 658
 659	for_each_probe_cache_entry(entry, pcache) {
 660		/* Hit if same event name or same command-string */
 661		if (streql(entry->pev.group, group) &&
 662		    streql(entry->pev.event, event))
 663			goto found;
 664	}
 665	entry = NULL;
 666
 667found:
 668	return entry;
 669}
 670
 671int probe_cache__add_entry(struct probe_cache *pcache,
 672			   struct perf_probe_event *pev,
 673			   struct probe_trace_event *tevs, int ntevs)
 674{
 675	struct probe_cache_entry *entry = NULL;
 676	char *command;
 677	int i, ret = 0;
 678
 679	if (!pcache || !pev || !tevs || ntevs <= 0) {
 680		ret = -EINVAL;
 681		goto out_err;
 682	}
 683
 684	/* Remove old cache entry */
 685	entry = probe_cache__find(pcache, pev);
 686	if (entry) {
 687		list_del_init(&entry->node);
 688		probe_cache_entry__delete(entry);
 689	}
 690
 691	ret = -ENOMEM;
 692	entry = probe_cache_entry__new(pev);
 693	if (!entry)
 694		goto out_err;
 695
 696	for (i = 0; i < ntevs; i++) {
 697		if (!tevs[i].point.symbol)
 698			continue;
 699
 700		command = synthesize_probe_trace_command(&tevs[i]);
 701		if (!command)
 702			goto out_err;
 703		ret = strlist__add(entry->tevlist, command);
 704		if (ret == -ENOMEM) {
 705			pr_err("strlist__add failed with -ENOMEM\n");
 706			goto out_err;
 707		}
 708
 709		free(command);
 710	}
 711	list_add_tail(&entry->node, &pcache->entries);
 712	pr_debug("Added probe cache: %d\n", ntevs);
 713	return 0;
 714
 715out_err:
 716	pr_debug("Failed to add probe caches\n");
 717	probe_cache_entry__delete(entry);
 718	return ret;
 719}
 720
 721#ifdef HAVE_GELF_GETNOTE_SUPPORT
 722static unsigned long long sdt_note__get_addr(struct sdt_note *note)
 723{
 724	return note->bit32 ?
 725		(unsigned long long)note->addr.a32[SDT_NOTE_IDX_LOC] :
 726		(unsigned long long)note->addr.a64[SDT_NOTE_IDX_LOC];
 727}
 728
 729static unsigned long long sdt_note__get_ref_ctr_offset(struct sdt_note *note)
 730{
 731	return note->bit32 ?
 732		(unsigned long long)note->addr.a32[SDT_NOTE_IDX_REFCTR] :
 733		(unsigned long long)note->addr.a64[SDT_NOTE_IDX_REFCTR];
 734}
 735
 736static const char * const type_to_suffix[] = {
 737	":s64", "", "", "", ":s32", "", ":s16", ":s8",
 738	"", ":u8", ":u16", "", ":u32", "", "", "", ":u64"
 739};
 740
 741/*
 742 * Isolate the string number and convert it into a decimal value;
 743 * this will be an index to get suffix of the uprobe name (defining
 744 * the type)
 745 */
 746static int sdt_arg_parse_size(char *n_ptr, const char **suffix)
 747{
 748	long type_idx;
 749
 750	type_idx = strtol(n_ptr, NULL, 10);
 751	if (type_idx < -8 || type_idx > 8) {
 752		pr_debug4("Failed to get a valid sdt type\n");
 753		return -1;
 754	}
 755
 756	*suffix = type_to_suffix[type_idx + 8];
 757	return 0;
 758}
 759
 760static int synthesize_sdt_probe_arg(struct strbuf *buf, int i, const char *arg)
 761{
 762	char *op, *desc = strdup(arg), *new_op = NULL;
 763	const char *suffix = "";
 764	int ret = -1;
 765
 766	if (desc == NULL) {
 767		pr_debug4("Allocation error\n");
 768		return ret;
 769	}
 770
 771	/*
 772	 * Argument is in N@OP format. N is size of the argument and OP is
 773	 * the actual assembly operand. N can be omitted; in that case
 774	 * argument is just OP(without @).
 775	 */
 776	op = strchr(desc, '@');
 777	if (op) {
 778		op[0] = '\0';
 779		op++;
 780
 781		if (sdt_arg_parse_size(desc, &suffix))
 782			goto error;
 783	} else {
 784		op = desc;
 785	}
 786
 787	ret = arch_sdt_arg_parse_op(op, &new_op);
 788
 789	if (ret < 0)
 790		goto error;
 791
 792	if (ret == SDT_ARG_VALID) {
 793		ret = strbuf_addf(buf, " arg%d=%s%s", i + 1, new_op, suffix);
 794		if (ret < 0)
 795			goto error;
 796	}
 797
 798	ret = 0;
 799error:
 800	free(desc);
 801	free(new_op);
 802	return ret;
 803}
 804
 805static char *synthesize_sdt_probe_command(struct sdt_note *note,
 806					const char *pathname,
 807					const char *sdtgrp)
 808{
 809	struct strbuf buf;
 810	char *ret = NULL;
 811	int i, args_count, err;
 812	unsigned long long ref_ctr_offset;
 813	char *arg;
 814	int arg_idx = 0;
 815
 816	if (strbuf_init(&buf, 32) < 0)
 817		return NULL;
 818
 819	err = strbuf_addf(&buf, "p:%s/%s %s:0x%llx",
 820			sdtgrp, note->name, pathname,
 821			sdt_note__get_addr(note));
 822
 823	ref_ctr_offset = sdt_note__get_ref_ctr_offset(note);
 824	if (ref_ctr_offset && err >= 0)
 825		err = strbuf_addf(&buf, "(0x%llx)", ref_ctr_offset);
 826
 827	if (err < 0)
 828		goto error;
 829
 830	if (!note->args)
 831		goto out;
 832
 833	if (note->args) {
 834		char **args = argv_split(note->args, &args_count);
 835
 836		if (args == NULL)
 837			goto error;
 838
 839		for (i = 0; i < args_count; ) {
 840			/*
 841			 * FIXUP: Arm64 ELF section '.note.stapsdt' uses string
 842			 * format "-4@[sp, NUM]" if a probe is to access data in
 843			 * the stack, e.g. below is an example for the SDT
 844			 * Arguments:
 845			 *
 846			 *   Arguments: -4@[sp, 12] -4@[sp, 8] -4@[sp, 4]
 847			 *
 848			 * Since the string introduces an extra space character
 849			 * in the middle of square brackets, the argument is
 850			 * divided into two items.  Fixup for this case, if an
 851			 * item contains sub string "[sp,", need to concatenate
 852			 * the two items.
 853			 */
 854			if (strstr(args[i], "[sp,") && (i+1) < args_count) {
 855				err = asprintf(&arg, "%s %s", args[i], args[i+1]);
 856				i += 2;
 857			} else {
 858				err = asprintf(&arg, "%s", args[i]);
 859				i += 1;
 860			}
 861
 862			/* Failed to allocate memory */
 863			if (err < 0) {
 864				argv_free(args);
 865				goto error;
 866			}
 867
 868			if (synthesize_sdt_probe_arg(&buf, arg_idx, arg) < 0) {
 869				free(arg);
 870				argv_free(args);
 871				goto error;
 872			}
 873
 874			free(arg);
 875			arg_idx++;
 876		}
 877
 878		argv_free(args);
 879	}
 880
 881out:
 882	ret = strbuf_detach(&buf, NULL);
 883error:
 884	strbuf_release(&buf);
 885	return ret;
 886}
 887
 888int probe_cache__scan_sdt(struct probe_cache *pcache, const char *pathname)
 889{
 890	struct probe_cache_entry *entry = NULL;
 891	struct list_head sdtlist;
 892	struct sdt_note *note;
 893	char *buf;
 894	char sdtgrp[64];
 895	int ret;
 896
 897	INIT_LIST_HEAD(&sdtlist);
 898	ret = get_sdt_note_list(&sdtlist, pathname);
 899	if (ret < 0) {
 900		pr_debug4("Failed to get sdt note: %d\n", ret);
 901		return ret;
 902	}
 903	list_for_each_entry(note, &sdtlist, note_list) {
 904		ret = snprintf(sdtgrp, 64, "sdt_%s", note->provider);
 905		if (ret < 0)
 906			break;
 907		/* Try to find same-name entry */
 908		entry = probe_cache__find_by_name(pcache, sdtgrp, note->name);
 909		if (!entry) {
 910			entry = probe_cache_entry__new(NULL);
 911			if (!entry) {
 912				ret = -ENOMEM;
 913				break;
 914			}
 915			entry->sdt = true;
 916			ret = asprintf(&entry->spev, "%s:%s=%s", sdtgrp,
 917					note->name, note->name);
 918			if (ret < 0)
 919				break;
 920			entry->pev.event = strdup(note->name);
 921			entry->pev.group = strdup(sdtgrp);
 922			list_add_tail(&entry->node, &pcache->entries);
 923		}
 924		buf = synthesize_sdt_probe_command(note, pathname, sdtgrp);
 925		if (!buf) {
 926			ret = -ENOMEM;
 927			break;
 928		}
 929
 930		ret = strlist__add(entry->tevlist, buf);
 931
 932		free(buf);
 933		entry = NULL;
 934
 935		if (ret == -ENOMEM) {
 936			pr_err("strlist__add failed with -ENOMEM\n");
 937			break;
 938		}
 939	}
 940	if (entry) {
 941		list_del_init(&entry->node);
 942		probe_cache_entry__delete(entry);
 943	}
 944	cleanup_sdt_note_list(&sdtlist);
 945	return ret;
 946}
 947#endif
 948
 949static int probe_cache_entry__write(struct probe_cache_entry *entry, int fd)
 950{
 951	struct str_node *snode;
 952	struct stat st;
 953	struct iovec iov[3];
 954	const char *prefix = entry->sdt ? "%" : "#";
 955	int ret;
 956	/* Save stat for rollback */
 957	ret = fstat(fd, &st);
 958	if (ret < 0)
 959		return ret;
 960
 961	pr_debug("Writing cache: %s%s\n", prefix, entry->spev);
 962	iov[0].iov_base = (void *)prefix; iov[0].iov_len = 1;
 963	iov[1].iov_base = entry->spev; iov[1].iov_len = strlen(entry->spev);
 964	iov[2].iov_base = (void *)"\n"; iov[2].iov_len = 1;
 965	ret = writev(fd, iov, 3);
 966	if (ret < (int)iov[1].iov_len + 2)
 967		goto rollback;
 968
 969	strlist__for_each_entry(snode, entry->tevlist) {
 970		iov[0].iov_base = (void *)snode->s;
 971		iov[0].iov_len = strlen(snode->s);
 972		iov[1].iov_base = (void *)"\n"; iov[1].iov_len = 1;
 973		ret = writev(fd, iov, 2);
 974		if (ret < (int)iov[0].iov_len + 1)
 975			goto rollback;
 976	}
 977	return 0;
 978
 979rollback:
 980	/* Rollback to avoid cache file corruption */
 981	if (ret > 0)
 982		ret = -1;
 983	if (ftruncate(fd, st.st_size) < 0)
 984		ret = -2;
 985
 986	return ret;
 987}
 988
 989int probe_cache__commit(struct probe_cache *pcache)
 990{
 991	struct probe_cache_entry *entry;
 992	int ret = 0;
 993
 994	/* TBD: if we do not update existing entries, skip it */
 995	ret = lseek(pcache->fd, 0, SEEK_SET);
 996	if (ret < 0)
 997		goto out;
 998
 999	ret = ftruncate(pcache->fd, 0);
1000	if (ret < 0)
1001		goto out;
1002
1003	for_each_probe_cache_entry(entry, pcache) {
1004		ret = probe_cache_entry__write(entry, pcache->fd);
1005		pr_debug("Cache committed: %d\n", ret);
1006		if (ret < 0)
1007			break;
1008	}
1009out:
1010	return ret;
1011}
1012
1013static bool probe_cache_entry__compare(struct probe_cache_entry *entry,
1014				       struct strfilter *filter)
1015{
1016	char buf[128], *ptr = entry->spev;
1017
1018	if (entry->pev.event) {
1019		snprintf(buf, 128, "%s:%s", entry->pev.group, entry->pev.event);
1020		ptr = buf;
1021	}
1022	return strfilter__compare(filter, ptr);
1023}
1024
1025int probe_cache__filter_purge(struct probe_cache *pcache,
1026			      struct strfilter *filter)
1027{
1028	struct probe_cache_entry *entry, *tmp;
1029
1030	list_for_each_entry_safe(entry, tmp, &pcache->entries, node) {
1031		if (probe_cache_entry__compare(entry, filter)) {
1032			pr_info("Removed cached event: %s\n", entry->spev);
1033			list_del_init(&entry->node);
1034			probe_cache_entry__delete(entry);
1035		}
1036	}
1037	return 0;
1038}
1039
1040static int probe_cache__show_entries(struct probe_cache *pcache,
1041				     struct strfilter *filter)
1042{
1043	struct probe_cache_entry *entry;
1044
1045	for_each_probe_cache_entry(entry, pcache) {
1046		if (probe_cache_entry__compare(entry, filter))
1047			printf("%s\n", entry->spev);
1048	}
1049	return 0;
1050}
1051
1052/* Show all cached probes */
1053int probe_cache__show_all_caches(struct strfilter *filter)
1054{
1055	struct probe_cache *pcache;
1056	struct strlist *bidlist;
1057	struct str_node *nd;
1058	char *buf = strfilter__string(filter);
1059
1060	pr_debug("list cache with filter: %s\n", buf);
1061	free(buf);
1062
1063	bidlist = build_id_cache__list_all(true);
1064	if (!bidlist) {
1065		pr_debug("Failed to get buildids: %d\n", errno);
1066		return -EINVAL;
1067	}
1068	strlist__for_each_entry(nd, bidlist) {
1069		pcache = probe_cache__new(nd->s, NULL);
1070		if (!pcache)
1071			continue;
1072		if (!list_empty(&pcache->entries)) {
1073			buf = build_id_cache__origname(nd->s);
1074			printf("%s (%s):\n", buf, nd->s);
1075			free(buf);
1076			probe_cache__show_entries(pcache, filter);
1077		}
1078		probe_cache__delete(pcache);
1079	}
1080	strlist__delete(bidlist);
1081
1082	return 0;
1083}
1084
1085enum ftrace_readme {
1086	FTRACE_README_PROBE_TYPE_X = 0,
1087	FTRACE_README_KRETPROBE_OFFSET,
1088	FTRACE_README_UPROBE_REF_CTR,
1089	FTRACE_README_USER_ACCESS,
1090	FTRACE_README_MULTIPROBE_EVENT,
1091	FTRACE_README_IMMEDIATE_VALUE,
1092	FTRACE_README_END,
1093};
1094
1095static struct {
1096	const char *pattern;
1097	bool avail;
1098} ftrace_readme_table[] = {
1099#define DEFINE_TYPE(idx, pat)			\
1100	[idx] = {.pattern = pat, .avail = false}
1101	DEFINE_TYPE(FTRACE_README_PROBE_TYPE_X, "*type: * x8/16/32/64,*"),
1102	DEFINE_TYPE(FTRACE_README_KRETPROBE_OFFSET, "*place (kretprobe): *"),
1103	DEFINE_TYPE(FTRACE_README_UPROBE_REF_CTR, "*ref_ctr_offset*"),
1104	DEFINE_TYPE(FTRACE_README_USER_ACCESS, "*u]<offset>*"),
1105	DEFINE_TYPE(FTRACE_README_MULTIPROBE_EVENT, "*Create/append/*"),
1106	DEFINE_TYPE(FTRACE_README_IMMEDIATE_VALUE, "*\\imm-value,*"),
1107};
1108
1109static bool scan_ftrace_readme(enum ftrace_readme type)
1110{
1111	int fd;
1112	FILE *fp;
1113	char *buf = NULL;
1114	size_t len = 0;
1115	bool ret = false;
1116	static bool scanned = false;
1117
1118	if (scanned)
1119		goto result;
1120
1121	fd = open_trace_file("README", false);
1122	if (fd < 0)
1123		return ret;
1124
1125	fp = fdopen(fd, "r");
1126	if (!fp) {
1127		close(fd);
1128		return ret;
1129	}
1130
1131	while (getline(&buf, &len, fp) > 0)
1132		for (enum ftrace_readme i = 0; i < FTRACE_README_END; i++)
1133			if (!ftrace_readme_table[i].avail)
1134				ftrace_readme_table[i].avail =
1135					strglobmatch(buf, ftrace_readme_table[i].pattern);
1136	scanned = true;
1137
1138	fclose(fp);
1139	free(buf);
1140
1141result:
1142	if (type >= FTRACE_README_END)
1143		return false;
1144
1145	return ftrace_readme_table[type].avail;
1146}
1147
1148bool probe_type_is_available(enum probe_type type)
1149{
1150	if (type >= PROBE_TYPE_END)
1151		return false;
1152	else if (type == PROBE_TYPE_X)
1153		return scan_ftrace_readme(FTRACE_README_PROBE_TYPE_X);
1154
1155	return true;
1156}
1157
1158bool kretprobe_offset_is_supported(void)
1159{
1160	return scan_ftrace_readme(FTRACE_README_KRETPROBE_OFFSET);
1161}
1162
1163bool uprobe_ref_ctr_is_supported(void)
1164{
1165	return scan_ftrace_readme(FTRACE_README_UPROBE_REF_CTR);
1166}
1167
1168bool user_access_is_supported(void)
1169{
1170	return scan_ftrace_readme(FTRACE_README_USER_ACCESS);
1171}
1172
1173bool multiprobe_event_is_supported(void)
1174{
1175	return scan_ftrace_readme(FTRACE_README_MULTIPROBE_EVENT);
1176}
1177
1178bool immediate_value_is_supported(void)
1179{
1180	return scan_ftrace_readme(FTRACE_README_IMMEDIATE_VALUE);
1181}