Linux Audio

Check our new training course

Loading...
v6.8
   1// SPDX-License-Identifier: GPL-2.0
   2#include <linux/hw_breakpoint.h>
   3#include <linux/err.h>
   4#include <linux/list_sort.h>
   5#include <linux/zalloc.h>
   6#include <dirent.h>
   7#include <errno.h>
   8#include <sys/ioctl.h>
 
 
 
   9#include <sys/param.h>
  10#include "term.h"
 
  11#include "evlist.h"
  12#include "evsel.h"
 
  13#include <subcmd/parse-options.h>
  14#include "parse-events.h"
 
  15#include "string2.h"
  16#include "strbuf.h"
 
 
 
  17#include "debug.h"
  18#include <api/fs/tracing_path.h>
  19#include <perf/cpumap.h>
  20#include <util/parse-events-bison.h>
  21#include <util/parse-events-flex.h>
 
  22#include "pmu.h"
  23#include "pmus.h"
 
  24#include "asm/bug.h"
  25#include "util/parse-branch-options.h"
 
  26#include "util/evsel_config.h"
  27#include "util/event.h"
  28#include "util/bpf-filter.h"
  29#include "util/util.h"
  30#include "tracepoint.h"
  31
  32#define MAX_NAME_LEN 100
  33
  34#ifdef PARSER_DEBUG
  35extern int parse_events_debug;
  36#endif
  37static int get_config_terms(struct parse_events_terms *head_config, struct list_head *head_terms);
  38static int parse_events_terms__copy(const struct parse_events_terms *src,
  39				    struct parse_events_terms *dest);
 
 
 
 
 
 
 
 
 
  40
  41struct event_symbol event_symbols_hw[PERF_COUNT_HW_MAX] = {
  42	[PERF_COUNT_HW_CPU_CYCLES] = {
  43		.symbol = "cpu-cycles",
  44		.alias  = "cycles",
  45	},
  46	[PERF_COUNT_HW_INSTRUCTIONS] = {
  47		.symbol = "instructions",
  48		.alias  = "",
  49	},
  50	[PERF_COUNT_HW_CACHE_REFERENCES] = {
  51		.symbol = "cache-references",
  52		.alias  = "",
  53	},
  54	[PERF_COUNT_HW_CACHE_MISSES] = {
  55		.symbol = "cache-misses",
  56		.alias  = "",
  57	},
  58	[PERF_COUNT_HW_BRANCH_INSTRUCTIONS] = {
  59		.symbol = "branch-instructions",
  60		.alias  = "branches",
  61	},
  62	[PERF_COUNT_HW_BRANCH_MISSES] = {
  63		.symbol = "branch-misses",
  64		.alias  = "",
  65	},
  66	[PERF_COUNT_HW_BUS_CYCLES] = {
  67		.symbol = "bus-cycles",
  68		.alias  = "",
  69	},
  70	[PERF_COUNT_HW_STALLED_CYCLES_FRONTEND] = {
  71		.symbol = "stalled-cycles-frontend",
  72		.alias  = "idle-cycles-frontend",
  73	},
  74	[PERF_COUNT_HW_STALLED_CYCLES_BACKEND] = {
  75		.symbol = "stalled-cycles-backend",
  76		.alias  = "idle-cycles-backend",
  77	},
  78	[PERF_COUNT_HW_REF_CPU_CYCLES] = {
  79		.symbol = "ref-cycles",
  80		.alias  = "",
  81	},
  82};
  83
  84struct event_symbol event_symbols_sw[PERF_COUNT_SW_MAX] = {
  85	[PERF_COUNT_SW_CPU_CLOCK] = {
  86		.symbol = "cpu-clock",
  87		.alias  = "",
  88	},
  89	[PERF_COUNT_SW_TASK_CLOCK] = {
  90		.symbol = "task-clock",
  91		.alias  = "",
  92	},
  93	[PERF_COUNT_SW_PAGE_FAULTS] = {
  94		.symbol = "page-faults",
  95		.alias  = "faults",
  96	},
  97	[PERF_COUNT_SW_CONTEXT_SWITCHES] = {
  98		.symbol = "context-switches",
  99		.alias  = "cs",
 100	},
 101	[PERF_COUNT_SW_CPU_MIGRATIONS] = {
 102		.symbol = "cpu-migrations",
 103		.alias  = "migrations",
 104	},
 105	[PERF_COUNT_SW_PAGE_FAULTS_MIN] = {
 106		.symbol = "minor-faults",
 107		.alias  = "",
 108	},
 109	[PERF_COUNT_SW_PAGE_FAULTS_MAJ] = {
 110		.symbol = "major-faults",
 111		.alias  = "",
 112	},
 113	[PERF_COUNT_SW_ALIGNMENT_FAULTS] = {
 114		.symbol = "alignment-faults",
 115		.alias  = "",
 116	},
 117	[PERF_COUNT_SW_EMULATION_FAULTS] = {
 118		.symbol = "emulation-faults",
 119		.alias  = "",
 120	},
 121	[PERF_COUNT_SW_DUMMY] = {
 122		.symbol = "dummy",
 123		.alias  = "",
 124	},
 125	[PERF_COUNT_SW_BPF_OUTPUT] = {
 126		.symbol = "bpf-output",
 127		.alias  = "",
 128	},
 129	[PERF_COUNT_SW_CGROUP_SWITCHES] = {
 130		.symbol = "cgroup-switches",
 131		.alias  = "",
 132	},
 133};
 134
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 135const char *event_type(int type)
 136{
 137	switch (type) {
 138	case PERF_TYPE_HARDWARE:
 139		return "hardware";
 140
 141	case PERF_TYPE_SOFTWARE:
 142		return "software";
 143
 144	case PERF_TYPE_TRACEPOINT:
 145		return "tracepoint";
 146
 147	case PERF_TYPE_HW_CACHE:
 148		return "hardware-cache";
 149
 150	default:
 151		break;
 152	}
 153
 154	return "unknown";
 155}
 156
 157static char *get_config_str(struct parse_events_terms *head_terms,
 158			    enum parse_events__term_type type_term)
 
 
 
 
 159{
 160	struct parse_events_term *term;
 161
 162	if (!head_terms)
 163		return NULL;
 164
 165	list_for_each_entry(term, &head_terms->terms, list)
 166		if (term->type_term == type_term)
 167			return term->val.str;
 168
 169	return NULL;
 170}
 171
 172static char *get_config_metric_id(struct parse_events_terms *head_terms)
 173{
 174	return get_config_str(head_terms, PARSE_EVENTS__TERM_TYPE_METRIC_ID);
 175}
 176
 177static char *get_config_name(struct parse_events_terms *head_terms)
 178{
 179	return get_config_str(head_terms, PARSE_EVENTS__TERM_TYPE_NAME);
 180}
 181
 182/**
 183 * fix_raw - For each raw term see if there is an event (aka alias) in pmu that
 184 *           matches the raw's string value. If the string value matches an
 185 *           event then change the term to be an event, if not then change it to
 186 *           be a config term. For example, "read" may be an event of the PMU or
 187 *           a raw hex encoding of 0xead. The fix-up is done late so the PMU of
 188 *           the event can be determined and we don't need to scan all PMUs
 189 *           ahead-of-time.
 190 * @config_terms: the list of terms that may contain a raw term.
 191 * @pmu: the PMU to scan for events from.
 192 */
 193static void fix_raw(struct parse_events_terms *config_terms, struct perf_pmu *pmu)
 194{
 195	struct parse_events_term *term;
 196
 197	list_for_each_entry(term, &config_terms->terms, list) {
 198		u64 num;
 199
 200		if (term->type_term != PARSE_EVENTS__TERM_TYPE_RAW)
 201			continue;
 202
 203		if (perf_pmu__have_event(pmu, term->val.str)) {
 204			zfree(&term->config);
 205			term->config = term->val.str;
 206			term->type_val = PARSE_EVENTS__TERM_TYPE_NUM;
 207			term->type_term = PARSE_EVENTS__TERM_TYPE_USER;
 208			term->val.num = 1;
 209			term->no_value = true;
 210			continue;
 211		}
 212
 213		zfree(&term->config);
 214		term->config = strdup("config");
 215		errno = 0;
 216		num = strtoull(term->val.str + 1, NULL, 16);
 217		assert(errno == 0);
 218		free(term->val.str);
 219		term->type_val = PARSE_EVENTS__TERM_TYPE_NUM;
 220		term->type_term = PARSE_EVENTS__TERM_TYPE_CONFIG;
 221		term->val.num = num;
 222		term->no_value = false;
 223	}
 224}
 225
 226static struct evsel *
 227__add_event(struct list_head *list, int *idx,
 228	    struct perf_event_attr *attr,
 229	    bool init_attr,
 230	    const char *name, const char *metric_id, struct perf_pmu *pmu,
 231	    struct list_head *config_terms, bool auto_merge_stats,
 232	    const char *cpu_list)
 233{
 234	struct evsel *evsel;
 235	struct perf_cpu_map *cpus = pmu ? perf_cpu_map__get(pmu->cpus) :
 236			       cpu_list ? perf_cpu_map__new(cpu_list) : NULL;
 237
 238	if (pmu)
 239		perf_pmu__warn_invalid_formats(pmu);
 240
 241	if (pmu && (attr->type == PERF_TYPE_RAW || attr->type >= PERF_TYPE_MAX)) {
 242		perf_pmu__warn_invalid_config(pmu, attr->config, name,
 243					      PERF_PMU_FORMAT_VALUE_CONFIG, "config");
 244		perf_pmu__warn_invalid_config(pmu, attr->config1, name,
 245					      PERF_PMU_FORMAT_VALUE_CONFIG1, "config1");
 246		perf_pmu__warn_invalid_config(pmu, attr->config2, name,
 247					      PERF_PMU_FORMAT_VALUE_CONFIG2, "config2");
 248		perf_pmu__warn_invalid_config(pmu, attr->config3, name,
 249					      PERF_PMU_FORMAT_VALUE_CONFIG3, "config3");
 250	}
 251	if (init_attr)
 252		event_attr_init(attr);
 253
 254	evsel = evsel__new_idx(attr, *idx);
 255	if (!evsel) {
 256		perf_cpu_map__put(cpus);
 257		return NULL;
 258	}
 259
 260	(*idx)++;
 261	evsel->core.cpus = cpus;
 262	evsel->core.own_cpus = perf_cpu_map__get(cpus);
 263	evsel->core.requires_cpu = pmu ? pmu->is_uncore : false;
 264	evsel->core.is_pmu_core = pmu ? pmu->is_core : false;
 265	evsel->auto_merge_stats = auto_merge_stats;
 266	evsel->pmu = pmu;
 267	evsel->pmu_name = pmu ? strdup(pmu->name) : NULL;
 268
 269	if (name)
 270		evsel->name = strdup(name);
 271
 272	if (metric_id)
 273		evsel->metric_id = strdup(metric_id);
 274
 275	if (config_terms)
 276		list_splice_init(config_terms, &evsel->config_terms);
 277
 278	if (list)
 279		list_add_tail(&evsel->core.node, list);
 280
 281	return evsel;
 282}
 283
 284struct evsel *parse_events__add_event(int idx, struct perf_event_attr *attr,
 285				      const char *name, const char *metric_id,
 286				      struct perf_pmu *pmu)
 287{
 288	return __add_event(/*list=*/NULL, &idx, attr, /*init_attr=*/false, name,
 289			   metric_id, pmu, /*config_terms=*/NULL,
 290			   /*auto_merge_stats=*/false, /*cpu_list=*/NULL);
 291}
 292
 293static int add_event(struct list_head *list, int *idx,
 294		     struct perf_event_attr *attr, const char *name,
 295		     const char *metric_id, struct list_head *config_terms)
 296{
 297	return __add_event(list, idx, attr, /*init_attr*/true, name, metric_id,
 298			   /*pmu=*/NULL, config_terms,
 299			   /*auto_merge_stats=*/false, /*cpu_list=*/NULL) ? 0 : -ENOMEM;
 300}
 301
 302static int add_event_tool(struct list_head *list, int *idx,
 303			  enum perf_tool_event tool_event)
 304{
 305	struct evsel *evsel;
 306	struct perf_event_attr attr = {
 307		.type = PERF_TYPE_SOFTWARE,
 308		.config = PERF_COUNT_SW_DUMMY,
 309	};
 310
 311	evsel = __add_event(list, idx, &attr, /*init_attr=*/true, /*name=*/NULL,
 312			    /*metric_id=*/NULL, /*pmu=*/NULL,
 313			    /*config_terms=*/NULL, /*auto_merge_stats=*/false,
 314			    /*cpu_list=*/"0");
 315	if (!evsel)
 316		return -ENOMEM;
 317	evsel->tool_event = tool_event;
 318	if (tool_event == PERF_TOOL_DURATION_TIME
 319	    || tool_event == PERF_TOOL_USER_TIME
 320	    || tool_event == PERF_TOOL_SYSTEM_TIME) {
 321		free((char *)evsel->unit);
 322		evsel->unit = strdup("ns");
 323	}
 324	return 0;
 325}
 326
 327/**
 328 * parse_aliases - search names for entries beginning or equalling str ignoring
 329 *                 case. If mutliple entries in names match str then the longest
 330 *                 is chosen.
 331 * @str: The needle to look for.
 332 * @names: The haystack to search.
 333 * @size: The size of the haystack.
 334 * @longest: Out argument giving the length of the matching entry.
 335 */
 336static int parse_aliases(const char *str, const char *const names[][EVSEL__MAX_ALIASES], int size,
 337			 int *longest)
 338{
 339	*longest = -1;
 340	for (int i = 0; i < size; i++) {
 341		for (int j = 0; j < EVSEL__MAX_ALIASES && names[i][j]; j++) {
 342			int n = strlen(names[i][j]);
 343
 344			if (n > *longest && !strncasecmp(str, names[i][j], n))
 345				*longest = n;
 
 
 
 346		}
 347		if (*longest > 0)
 348			return i;
 349	}
 350
 351	return -1;
 352}
 353
 354typedef int config_term_func_t(struct perf_event_attr *attr,
 355			       struct parse_events_term *term,
 356			       struct parse_events_error *err);
 357static int config_term_common(struct perf_event_attr *attr,
 358			      struct parse_events_term *term,
 359			      struct parse_events_error *err);
 360static int config_attr(struct perf_event_attr *attr,
 361		       struct parse_events_terms *head,
 362		       struct parse_events_error *err,
 363		       config_term_func_t config_term);
 364
 365/**
 366 * parse_events__decode_legacy_cache - Search name for the legacy cache event
 367 *                                     name composed of 1, 2 or 3 hyphen
 368 *                                     separated sections. The first section is
 369 *                                     the cache type while the others are the
 370 *                                     optional op and optional result. To make
 371 *                                     life hard the names in the table also
 372 *                                     contain hyphens and the longest name
 373 *                                     should always be selected.
 374 */
 375int parse_events__decode_legacy_cache(const char *name, int extended_pmu_type, __u64 *config)
 376{
 377	int len, cache_type = -1, cache_op = -1, cache_result = -1;
 378	const char *name_end = &name[strlen(name) + 1];
 379	const char *str = name;
 
 
 
 380
 381	cache_type = parse_aliases(str, evsel__hw_cache, PERF_COUNT_HW_CACHE_MAX, &len);
 
 
 
 
 382	if (cache_type == -1)
 383		return -EINVAL;
 384	str += len + 1;
 385
 386	if (str < name_end) {
 387		cache_op = parse_aliases(str, evsel__hw_cache_op,
 388					PERF_COUNT_HW_CACHE_OP_MAX, &len);
 389		if (cache_op >= 0) {
 390			if (!evsel__is_cache_op_valid(cache_type, cache_op))
 391				return -EINVAL;
 392			str += len + 1;
 393		} else {
 394			cache_result = parse_aliases(str, evsel__hw_cache_result,
 395						PERF_COUNT_HW_CACHE_RESULT_MAX, &len);
 396			if (cache_result >= 0)
 397				str += len + 1;
 398		}
 399	}
 400	if (str < name_end) {
 401		if (cache_op < 0) {
 402			cache_op = parse_aliases(str, evsel__hw_cache_op,
 403						PERF_COUNT_HW_CACHE_OP_MAX, &len);
 404			if (cache_op >= 0) {
 405				if (!evsel__is_cache_op_valid(cache_type, cache_op))
 406					return -EINVAL;
 
 407			}
 408		} else if (cache_result < 0) {
 
 
 409			cache_result = parse_aliases(str, evsel__hw_cache_result,
 410						PERF_COUNT_HW_CACHE_RESULT_MAX, &len);
 
 
 411		}
 412	}
 413
 414	/*
 415	 * Fall back to reads:
 416	 */
 417	if (cache_op == -1)
 418		cache_op = PERF_COUNT_HW_CACHE_OP_READ;
 419
 420	/*
 421	 * Fall back to accesses:
 422	 */
 423	if (cache_result == -1)
 424		cache_result = PERF_COUNT_HW_CACHE_RESULT_ACCESS;
 425
 426	*config = cache_type | (cache_op << 8) | (cache_result << 16);
 427	if (perf_pmus__supports_extended_type())
 428		*config |= (__u64)extended_pmu_type << PERF_PMU_TYPE_SHIFT;
 429	return 0;
 430}
 431
 432/**
 433 * parse_events__filter_pmu - returns false if a wildcard PMU should be
 434 *                            considered, true if it should be filtered.
 435 */
 436bool parse_events__filter_pmu(const struct parse_events_state *parse_state,
 437			      const struct perf_pmu *pmu)
 438{
 439	if (parse_state->pmu_filter == NULL)
 440		return false;
 441
 442	return strcmp(parse_state->pmu_filter, pmu->name) != 0;
 443}
 444
 445int parse_events_add_cache(struct list_head *list, int *idx, const char *name,
 446			   struct parse_events_state *parse_state,
 447			   struct parse_events_terms *head_config)
 448{
 449	struct perf_pmu *pmu = NULL;
 450	bool found_supported = false;
 451	const char *config_name = get_config_name(head_config);
 452	const char *metric_id = get_config_metric_id(head_config);
 453
 454	/* Legacy cache events are only supported by core PMUs. */
 455	while ((pmu = perf_pmus__scan_core(pmu)) != NULL) {
 456		LIST_HEAD(config_terms);
 457		struct perf_event_attr attr;
 458		int ret;
 459
 460		if (parse_events__filter_pmu(parse_state, pmu))
 461			continue;
 462
 463		memset(&attr, 0, sizeof(attr));
 464		attr.type = PERF_TYPE_HW_CACHE;
 465
 466		ret = parse_events__decode_legacy_cache(name, pmu->type, &attr.config);
 467		if (ret)
 468			return ret;
 469
 470		found_supported = true;
 471
 472		if (head_config) {
 473			if (config_attr(&attr, head_config, parse_state->error, config_term_common))
 474				return -EINVAL;
 475
 476			if (get_config_terms(head_config, &config_terms))
 477				return -ENOMEM;
 478		}
 
 479
 480		if (__add_event(list, idx, &attr, /*init_attr*/true, config_name ?: name,
 481				metric_id, pmu, &config_terms, /*auto_merge_stats=*/false,
 482				/*cpu_list=*/NULL) == NULL)
 483			return -ENOMEM;
 484
 485		free_config_terms(&config_terms);
 486	}
 487	return found_supported ? 0 : -EINVAL;
 488}
 489
 490#ifdef HAVE_LIBTRACEEVENT
 491static void tracepoint_error(struct parse_events_error *e, int err,
 492			     const char *sys, const char *name, int column)
 493{
 494	const char *str;
 495	char help[BUFSIZ];
 496
 497	if (!e)
 498		return;
 499
 500	/*
 501	 * We get error directly from syscall errno ( > 0),
 502	 * or from encoded pointer's error ( < 0).
 503	 */
 504	err = abs(err);
 505
 506	switch (err) {
 507	case EACCES:
 508		str = "can't access trace events";
 509		break;
 510	case ENOENT:
 511		str = "unknown tracepoint";
 512		break;
 513	default:
 514		str = "failed to add tracepoint";
 515		break;
 516	}
 517
 518	tracing_path__strerror_open_tp(err, help, sizeof(help), sys, name);
 519	parse_events_error__handle(e, column, strdup(str), strdup(help));
 520}
 521
 522static int add_tracepoint(struct list_head *list, int *idx,
 523			  const char *sys_name, const char *evt_name,
 524			  struct parse_events_error *err,
 525			  struct parse_events_terms *head_config, void *loc_)
 526{
 527	YYLTYPE *loc = loc_;
 528	struct evsel *evsel = evsel__newtp_idx(sys_name, evt_name, (*idx)++);
 529
 530	if (IS_ERR(evsel)) {
 531		tracepoint_error(err, PTR_ERR(evsel), sys_name, evt_name, loc->first_column);
 532		return PTR_ERR(evsel);
 533	}
 534
 535	if (head_config) {
 536		LIST_HEAD(config_terms);
 537
 538		if (get_config_terms(head_config, &config_terms))
 539			return -ENOMEM;
 540		list_splice(&config_terms, &evsel->config_terms);
 541	}
 542
 543	list_add_tail(&evsel->core.node, list);
 544	return 0;
 545}
 546
 547static int add_tracepoint_multi_event(struct list_head *list, int *idx,
 548				      const char *sys_name, const char *evt_name,
 549				      struct parse_events_error *err,
 550				      struct parse_events_terms *head_config, YYLTYPE *loc)
 551{
 552	char *evt_path;
 553	struct dirent *evt_ent;
 554	DIR *evt_dir;
 555	int ret = 0, found = 0;
 556
 557	evt_path = get_events_file(sys_name);
 558	if (!evt_path) {
 559		tracepoint_error(err, errno, sys_name, evt_name, loc->first_column);
 560		return -1;
 561	}
 562	evt_dir = opendir(evt_path);
 563	if (!evt_dir) {
 564		put_events_file(evt_path);
 565		tracepoint_error(err, errno, sys_name, evt_name, loc->first_column);
 566		return -1;
 567	}
 568
 569	while (!ret && (evt_ent = readdir(evt_dir))) {
 570		if (!strcmp(evt_ent->d_name, ".")
 571		    || !strcmp(evt_ent->d_name, "..")
 572		    || !strcmp(evt_ent->d_name, "enable")
 573		    || !strcmp(evt_ent->d_name, "filter"))
 574			continue;
 575
 576		if (!strglobmatch(evt_ent->d_name, evt_name))
 577			continue;
 578
 579		found++;
 580
 581		ret = add_tracepoint(list, idx, sys_name, evt_ent->d_name,
 582				     err, head_config, loc);
 583	}
 584
 585	if (!found) {
 586		tracepoint_error(err, ENOENT, sys_name, evt_name, loc->first_column);
 587		ret = -1;
 588	}
 589
 590	put_events_file(evt_path);
 591	closedir(evt_dir);
 592	return ret;
 593}
 594
 595static int add_tracepoint_event(struct list_head *list, int *idx,
 596				const char *sys_name, const char *evt_name,
 597				struct parse_events_error *err,
 598				struct parse_events_terms *head_config, YYLTYPE *loc)
 599{
 600	return strpbrk(evt_name, "*?") ?
 601		add_tracepoint_multi_event(list, idx, sys_name, evt_name,
 602					   err, head_config, loc) :
 603		add_tracepoint(list, idx, sys_name, evt_name,
 604			       err, head_config, loc);
 605}
 606
 607static int add_tracepoint_multi_sys(struct list_head *list, int *idx,
 608				    const char *sys_name, const char *evt_name,
 609				    struct parse_events_error *err,
 610				    struct parse_events_terms *head_config, YYLTYPE *loc)
 611{
 612	struct dirent *events_ent;
 613	DIR *events_dir;
 614	int ret = 0;
 615
 616	events_dir = tracing_events__opendir();
 617	if (!events_dir) {
 618		tracepoint_error(err, errno, sys_name, evt_name, loc->first_column);
 619		return -1;
 620	}
 621
 622	while (!ret && (events_ent = readdir(events_dir))) {
 623		if (!strcmp(events_ent->d_name, ".")
 624		    || !strcmp(events_ent->d_name, "..")
 625		    || !strcmp(events_ent->d_name, "enable")
 626		    || !strcmp(events_ent->d_name, "header_event")
 627		    || !strcmp(events_ent->d_name, "header_page"))
 628			continue;
 629
 630		if (!strglobmatch(events_ent->d_name, sys_name))
 631			continue;
 632
 633		ret = add_tracepoint_event(list, idx, events_ent->d_name,
 634					   evt_name, err, head_config, loc);
 635	}
 636
 637	closedir(events_dir);
 638	return ret;
 639}
 640#endif /* HAVE_LIBTRACEEVENT */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 641
 642static int
 643parse_breakpoint_type(const char *type, struct perf_event_attr *attr)
 644{
 645	int i;
 646
 647	for (i = 0; i < 3; i++) {
 648		if (!type || !type[i])
 649			break;
 650
 651#define CHECK_SET_TYPE(bit)		\
 652do {					\
 653	if (attr->bp_type & bit)	\
 654		return -EINVAL;		\
 655	else				\
 656		attr->bp_type |= bit;	\
 657} while (0)
 658
 659		switch (type[i]) {
 660		case 'r':
 661			CHECK_SET_TYPE(HW_BREAKPOINT_R);
 662			break;
 663		case 'w':
 664			CHECK_SET_TYPE(HW_BREAKPOINT_W);
 665			break;
 666		case 'x':
 667			CHECK_SET_TYPE(HW_BREAKPOINT_X);
 668			break;
 669		default:
 670			return -EINVAL;
 671		}
 672	}
 673
 674#undef CHECK_SET_TYPE
 675
 676	if (!attr->bp_type) /* Default */
 677		attr->bp_type = HW_BREAKPOINT_R | HW_BREAKPOINT_W;
 678
 679	return 0;
 680}
 681
 682int parse_events_add_breakpoint(struct parse_events_state *parse_state,
 683				struct list_head *list,
 684				u64 addr, char *type, u64 len,
 685				struct parse_events_terms *head_config)
 686{
 687	struct perf_event_attr attr;
 688	LIST_HEAD(config_terms);
 689	const char *name;
 690
 691	memset(&attr, 0, sizeof(attr));
 692	attr.bp_addr = addr;
 693
 694	if (parse_breakpoint_type(type, &attr))
 695		return -EINVAL;
 696
 697	/* Provide some defaults if len is not specified */
 698	if (!len) {
 699		if (attr.bp_type == HW_BREAKPOINT_X)
 700			len = sizeof(long);
 701		else
 702			len = HW_BREAKPOINT_LEN_4;
 703	}
 704
 705	attr.bp_len = len;
 706
 707	attr.type = PERF_TYPE_BREAKPOINT;
 708	attr.sample_period = 1;
 709
 710	if (head_config) {
 711		if (config_attr(&attr, head_config, parse_state->error,
 712				config_term_common))
 713			return -EINVAL;
 714
 715		if (get_config_terms(head_config, &config_terms))
 716			return -ENOMEM;
 717	}
 718
 719	name = get_config_name(head_config);
 720
 721	return add_event(list, &parse_state->idx, &attr, name, /*mertic_id=*/NULL,
 722			 &config_terms);
 723}
 724
 725static int check_type_val(struct parse_events_term *term,
 726			  struct parse_events_error *err,
 727			  enum parse_events__term_val_type type)
 728{
 729	if (type == term->type_val)
 730		return 0;
 731
 732	if (err) {
 733		parse_events_error__handle(err, term->err_val,
 734					type == PARSE_EVENTS__TERM_TYPE_NUM
 735					? strdup("expected numeric value")
 736					: strdup("expected string value"),
 737					NULL);
 738	}
 739	return -EINVAL;
 740}
 741
 742static bool config_term_shrinked;
 743
 744static const char *config_term_name(enum parse_events__term_type term_type)
 745{
 746	/*
 747	 * Update according to parse-events.l
 748	 */
 749	static const char *config_term_names[__PARSE_EVENTS__TERM_TYPE_NR] = {
 750		[PARSE_EVENTS__TERM_TYPE_USER]			= "<sysfs term>",
 751		[PARSE_EVENTS__TERM_TYPE_CONFIG]		= "config",
 752		[PARSE_EVENTS__TERM_TYPE_CONFIG1]		= "config1",
 753		[PARSE_EVENTS__TERM_TYPE_CONFIG2]		= "config2",
 754		[PARSE_EVENTS__TERM_TYPE_CONFIG3]		= "config3",
 755		[PARSE_EVENTS__TERM_TYPE_NAME]			= "name",
 756		[PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD]		= "period",
 757		[PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ]		= "freq",
 758		[PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE]	= "branch_type",
 759		[PARSE_EVENTS__TERM_TYPE_TIME]			= "time",
 760		[PARSE_EVENTS__TERM_TYPE_CALLGRAPH]		= "call-graph",
 761		[PARSE_EVENTS__TERM_TYPE_STACKSIZE]		= "stack-size",
 762		[PARSE_EVENTS__TERM_TYPE_NOINHERIT]		= "no-inherit",
 763		[PARSE_EVENTS__TERM_TYPE_INHERIT]		= "inherit",
 764		[PARSE_EVENTS__TERM_TYPE_MAX_STACK]		= "max-stack",
 765		[PARSE_EVENTS__TERM_TYPE_MAX_EVENTS]		= "nr",
 766		[PARSE_EVENTS__TERM_TYPE_OVERWRITE]		= "overwrite",
 767		[PARSE_EVENTS__TERM_TYPE_NOOVERWRITE]		= "no-overwrite",
 768		[PARSE_EVENTS__TERM_TYPE_DRV_CFG]		= "driver-config",
 769		[PARSE_EVENTS__TERM_TYPE_PERCORE]		= "percore",
 770		[PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT]		= "aux-output",
 771		[PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE]	= "aux-sample-size",
 772		[PARSE_EVENTS__TERM_TYPE_METRIC_ID]		= "metric-id",
 773		[PARSE_EVENTS__TERM_TYPE_RAW]                   = "raw",
 774		[PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE]          = "legacy-cache",
 775		[PARSE_EVENTS__TERM_TYPE_HARDWARE]              = "hardware",
 776	};
 777	if ((unsigned int)term_type >= __PARSE_EVENTS__TERM_TYPE_NR)
 778		return "unknown term";
 779
 780	return config_term_names[term_type];
 781}
 782
 783static bool
 784config_term_avail(enum parse_events__term_type term_type, struct parse_events_error *err)
 785{
 786	char *err_str;
 787
 788	if (term_type < 0 || term_type >= __PARSE_EVENTS__TERM_TYPE_NR) {
 789		parse_events_error__handle(err, -1,
 790					strdup("Invalid term_type"), NULL);
 791		return false;
 792	}
 793	if (!config_term_shrinked)
 794		return true;
 795
 796	switch (term_type) {
 797	case PARSE_EVENTS__TERM_TYPE_CONFIG:
 798	case PARSE_EVENTS__TERM_TYPE_CONFIG1:
 799	case PARSE_EVENTS__TERM_TYPE_CONFIG2:
 800	case PARSE_EVENTS__TERM_TYPE_CONFIG3:
 801	case PARSE_EVENTS__TERM_TYPE_NAME:
 802	case PARSE_EVENTS__TERM_TYPE_METRIC_ID:
 803	case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
 804	case PARSE_EVENTS__TERM_TYPE_PERCORE:
 805		return true;
 806	case PARSE_EVENTS__TERM_TYPE_USER:
 807	case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
 808	case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
 809	case PARSE_EVENTS__TERM_TYPE_TIME:
 810	case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
 811	case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
 812	case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
 813	case PARSE_EVENTS__TERM_TYPE_INHERIT:
 814	case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
 815	case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
 816	case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
 817	case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
 818	case PARSE_EVENTS__TERM_TYPE_DRV_CFG:
 819	case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
 820	case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
 821	case PARSE_EVENTS__TERM_TYPE_RAW:
 822	case PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE:
 823	case PARSE_EVENTS__TERM_TYPE_HARDWARE:
 824	default:
 825		if (!err)
 826			return false;
 827
 828		/* term_type is validated so indexing is safe */
 829		if (asprintf(&err_str, "'%s' is not usable in 'perf stat'",
 830			     config_term_name(term_type)) >= 0)
 831			parse_events_error__handle(err, -1, err_str, NULL);
 832		return false;
 833	}
 834}
 835
 836void parse_events__shrink_config_terms(void)
 837{
 838	config_term_shrinked = true;
 839}
 840
 841static int config_term_common(struct perf_event_attr *attr,
 842			      struct parse_events_term *term,
 843			      struct parse_events_error *err)
 844{
 845#define CHECK_TYPE_VAL(type)						   \
 846do {									   \
 847	if (check_type_val(term, err, PARSE_EVENTS__TERM_TYPE_ ## type)) \
 848		return -EINVAL;						   \
 849} while (0)
 850
 851	switch (term->type_term) {
 852	case PARSE_EVENTS__TERM_TYPE_CONFIG:
 853		CHECK_TYPE_VAL(NUM);
 854		attr->config = term->val.num;
 855		break;
 856	case PARSE_EVENTS__TERM_TYPE_CONFIG1:
 857		CHECK_TYPE_VAL(NUM);
 858		attr->config1 = term->val.num;
 859		break;
 860	case PARSE_EVENTS__TERM_TYPE_CONFIG2:
 861		CHECK_TYPE_VAL(NUM);
 862		attr->config2 = term->val.num;
 863		break;
 864	case PARSE_EVENTS__TERM_TYPE_CONFIG3:
 865		CHECK_TYPE_VAL(NUM);
 866		attr->config3 = term->val.num;
 867		break;
 868	case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
 869		CHECK_TYPE_VAL(NUM);
 870		break;
 871	case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
 872		CHECK_TYPE_VAL(NUM);
 873		break;
 874	case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
 875		CHECK_TYPE_VAL(STR);
 876		if (strcmp(term->val.str, "no") &&
 877		    parse_branch_str(term->val.str,
 878				    &attr->branch_sample_type)) {
 879			parse_events_error__handle(err, term->err_val,
 880					strdup("invalid branch sample type"),
 881					NULL);
 882			return -EINVAL;
 883		}
 884		break;
 885	case PARSE_EVENTS__TERM_TYPE_TIME:
 886		CHECK_TYPE_VAL(NUM);
 887		if (term->val.num > 1) {
 888			parse_events_error__handle(err, term->err_val,
 889						strdup("expected 0 or 1"),
 890						NULL);
 891			return -EINVAL;
 892		}
 893		break;
 894	case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
 895		CHECK_TYPE_VAL(STR);
 896		break;
 897	case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
 898		CHECK_TYPE_VAL(NUM);
 899		break;
 900	case PARSE_EVENTS__TERM_TYPE_INHERIT:
 901		CHECK_TYPE_VAL(NUM);
 902		break;
 903	case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
 904		CHECK_TYPE_VAL(NUM);
 905		break;
 906	case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
 907		CHECK_TYPE_VAL(NUM);
 908		break;
 909	case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
 910		CHECK_TYPE_VAL(NUM);
 911		break;
 912	case PARSE_EVENTS__TERM_TYPE_NAME:
 913		CHECK_TYPE_VAL(STR);
 914		break;
 915	case PARSE_EVENTS__TERM_TYPE_METRIC_ID:
 916		CHECK_TYPE_VAL(STR);
 917		break;
 918	case PARSE_EVENTS__TERM_TYPE_RAW:
 919		CHECK_TYPE_VAL(STR);
 920		break;
 921	case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
 922		CHECK_TYPE_VAL(NUM);
 923		break;
 924	case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
 925		CHECK_TYPE_VAL(NUM);
 926		break;
 927	case PARSE_EVENTS__TERM_TYPE_PERCORE:
 928		CHECK_TYPE_VAL(NUM);
 929		if ((unsigned int)term->val.num > 1) {
 930			parse_events_error__handle(err, term->err_val,
 931						strdup("expected 0 or 1"),
 932						NULL);
 933			return -EINVAL;
 934		}
 935		break;
 936	case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
 937		CHECK_TYPE_VAL(NUM);
 938		break;
 939	case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
 940		CHECK_TYPE_VAL(NUM);
 941		if (term->val.num > UINT_MAX) {
 942			parse_events_error__handle(err, term->err_val,
 943						strdup("too big"),
 944						NULL);
 945			return -EINVAL;
 946		}
 947		break;
 948	case PARSE_EVENTS__TERM_TYPE_DRV_CFG:
 949	case PARSE_EVENTS__TERM_TYPE_USER:
 950	case PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE:
 951	case PARSE_EVENTS__TERM_TYPE_HARDWARE:
 952	default:
 953		parse_events_error__handle(err, term->err_term,
 954					strdup(config_term_name(term->type_term)),
 955					parse_events_formats_error_string(NULL));
 956		return -EINVAL;
 957	}
 958
 959	/*
 960	 * Check term availability after basic checking so
 961	 * PARSE_EVENTS__TERM_TYPE_USER can be found and filtered.
 962	 *
 963	 * If check availability at the entry of this function,
 964	 * user will see "'<sysfs term>' is not usable in 'perf stat'"
 965	 * if an invalid config term is provided for legacy events
 966	 * (for example, instructions/badterm/...), which is confusing.
 967	 */
 968	if (!config_term_avail(term->type_term, err))
 969		return -EINVAL;
 970	return 0;
 971#undef CHECK_TYPE_VAL
 972}
 973
 974static int config_term_pmu(struct perf_event_attr *attr,
 975			   struct parse_events_term *term,
 976			   struct parse_events_error *err)
 977{
 978	if (term->type_term == PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE) {
 979		struct perf_pmu *pmu = perf_pmus__find_by_type(attr->type);
 980
 981		if (!pmu) {
 982			char *err_str;
 983
 984			if (asprintf(&err_str, "Failed to find PMU for type %d", attr->type) >= 0)
 985				parse_events_error__handle(err, term->err_term,
 986							   err_str, /*help=*/NULL);
 987			return -EINVAL;
 988		}
 989		/*
 990		 * Rewrite the PMU event to a legacy cache one unless the PMU
 991		 * doesn't support legacy cache events or the event is present
 992		 * within the PMU.
 993		 */
 994		if (perf_pmu__supports_legacy_cache(pmu) &&
 995		    !perf_pmu__have_event(pmu, term->config)) {
 996			attr->type = PERF_TYPE_HW_CACHE;
 997			return parse_events__decode_legacy_cache(term->config, pmu->type,
 998								 &attr->config);
 999		} else {
1000			term->type_term = PARSE_EVENTS__TERM_TYPE_USER;
1001			term->no_value = true;
1002		}
1003	}
1004	if (term->type_term == PARSE_EVENTS__TERM_TYPE_HARDWARE) {
1005		struct perf_pmu *pmu = perf_pmus__find_by_type(attr->type);
1006
1007		if (!pmu) {
1008			char *err_str;
1009
1010			if (asprintf(&err_str, "Failed to find PMU for type %d", attr->type) >= 0)
1011				parse_events_error__handle(err, term->err_term,
1012							   err_str, /*help=*/NULL);
1013			return -EINVAL;
1014		}
1015		/*
1016		 * If the PMU has a sysfs or json event prefer it over
1017		 * legacy. ARM requires this.
1018		 */
1019		if (perf_pmu__have_event(pmu, term->config)) {
1020			term->type_term = PARSE_EVENTS__TERM_TYPE_USER;
1021			term->no_value = true;
1022		} else {
1023			attr->type = PERF_TYPE_HARDWARE;
1024			attr->config = term->val.num;
1025			if (perf_pmus__supports_extended_type())
1026				attr->config |= (__u64)pmu->type << PERF_PMU_TYPE_SHIFT;
1027		}
1028		return 0;
1029	}
1030	if (term->type_term == PARSE_EVENTS__TERM_TYPE_USER ||
1031	    term->type_term == PARSE_EVENTS__TERM_TYPE_DRV_CFG) {
1032		/*
1033		 * Always succeed for sysfs terms, as we dont know
1034		 * at this point what type they need to have.
1035		 */
1036		return 0;
1037	}
1038	return config_term_common(attr, term, err);
1039}
1040
1041#ifdef HAVE_LIBTRACEEVENT
1042static int config_term_tracepoint(struct perf_event_attr *attr,
1043				  struct parse_events_term *term,
1044				  struct parse_events_error *err)
1045{
1046	switch (term->type_term) {
1047	case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
1048	case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
1049	case PARSE_EVENTS__TERM_TYPE_INHERIT:
1050	case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
1051	case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
1052	case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
1053	case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
1054	case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
1055	case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
1056	case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
1057		return config_term_common(attr, term, err);
1058	case PARSE_EVENTS__TERM_TYPE_USER:
1059	case PARSE_EVENTS__TERM_TYPE_CONFIG:
1060	case PARSE_EVENTS__TERM_TYPE_CONFIG1:
1061	case PARSE_EVENTS__TERM_TYPE_CONFIG2:
1062	case PARSE_EVENTS__TERM_TYPE_CONFIG3:
1063	case PARSE_EVENTS__TERM_TYPE_NAME:
1064	case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
1065	case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
1066	case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
1067	case PARSE_EVENTS__TERM_TYPE_TIME:
1068	case PARSE_EVENTS__TERM_TYPE_DRV_CFG:
1069	case PARSE_EVENTS__TERM_TYPE_PERCORE:
1070	case PARSE_EVENTS__TERM_TYPE_METRIC_ID:
1071	case PARSE_EVENTS__TERM_TYPE_RAW:
1072	case PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE:
1073	case PARSE_EVENTS__TERM_TYPE_HARDWARE:
1074	default:
1075		if (err) {
1076			parse_events_error__handle(err, term->err_term,
1077						   strdup(config_term_name(term->type_term)),
1078				strdup("valid terms: call-graph,stack-size\n"));
1079		}
1080		return -EINVAL;
1081	}
1082
1083	return 0;
1084}
1085#endif
1086
1087static int config_attr(struct perf_event_attr *attr,
1088		       struct parse_events_terms *head,
1089		       struct parse_events_error *err,
1090		       config_term_func_t config_term)
1091{
1092	struct parse_events_term *term;
1093
1094	list_for_each_entry(term, &head->terms, list)
1095		if (config_term(attr, term, err))
1096			return -EINVAL;
1097
1098	return 0;
1099}
1100
1101static int get_config_terms(struct parse_events_terms *head_config, struct list_head *head_terms)
 
1102{
1103#define ADD_CONFIG_TERM(__type, __weak)				\
1104	struct evsel_config_term *__t;			\
1105								\
1106	__t = zalloc(sizeof(*__t));				\
1107	if (!__t)						\
1108		return -ENOMEM;					\
1109								\
1110	INIT_LIST_HEAD(&__t->list);				\
1111	__t->type       = EVSEL__CONFIG_TERM_ ## __type;	\
1112	__t->weak	= __weak;				\
1113	list_add_tail(&__t->list, head_terms)
1114
1115#define ADD_CONFIG_TERM_VAL(__type, __name, __val, __weak)	\
1116do {								\
1117	ADD_CONFIG_TERM(__type, __weak);			\
1118	__t->val.__name = __val;				\
1119} while (0)
1120
1121#define ADD_CONFIG_TERM_STR(__type, __val, __weak)		\
1122do {								\
1123	ADD_CONFIG_TERM(__type, __weak);			\
1124	__t->val.str = strdup(__val);				\
1125	if (!__t->val.str) {					\
1126		zfree(&__t);					\
1127		return -ENOMEM;					\
1128	}							\
1129	__t->free_str = true;					\
1130} while (0)
1131
1132	struct parse_events_term *term;
1133
1134	list_for_each_entry(term, &head_config->terms, list) {
1135		switch (term->type_term) {
1136		case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
1137			ADD_CONFIG_TERM_VAL(PERIOD, period, term->val.num, term->weak);
1138			break;
1139		case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
1140			ADD_CONFIG_TERM_VAL(FREQ, freq, term->val.num, term->weak);
1141			break;
1142		case PARSE_EVENTS__TERM_TYPE_TIME:
1143			ADD_CONFIG_TERM_VAL(TIME, time, term->val.num, term->weak);
1144			break;
1145		case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
1146			ADD_CONFIG_TERM_STR(CALLGRAPH, term->val.str, term->weak);
1147			break;
1148		case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
1149			ADD_CONFIG_TERM_STR(BRANCH, term->val.str, term->weak);
1150			break;
1151		case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
1152			ADD_CONFIG_TERM_VAL(STACK_USER, stack_user,
1153					    term->val.num, term->weak);
1154			break;
1155		case PARSE_EVENTS__TERM_TYPE_INHERIT:
1156			ADD_CONFIG_TERM_VAL(INHERIT, inherit,
1157					    term->val.num ? 1 : 0, term->weak);
1158			break;
1159		case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
1160			ADD_CONFIG_TERM_VAL(INHERIT, inherit,
1161					    term->val.num ? 0 : 1, term->weak);
1162			break;
1163		case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
1164			ADD_CONFIG_TERM_VAL(MAX_STACK, max_stack,
1165					    term->val.num, term->weak);
1166			break;
1167		case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
1168			ADD_CONFIG_TERM_VAL(MAX_EVENTS, max_events,
1169					    term->val.num, term->weak);
1170			break;
1171		case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
1172			ADD_CONFIG_TERM_VAL(OVERWRITE, overwrite,
1173					    term->val.num ? 1 : 0, term->weak);
1174			break;
1175		case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
1176			ADD_CONFIG_TERM_VAL(OVERWRITE, overwrite,
1177					    term->val.num ? 0 : 1, term->weak);
1178			break;
1179		case PARSE_EVENTS__TERM_TYPE_DRV_CFG:
1180			ADD_CONFIG_TERM_STR(DRV_CFG, term->val.str, term->weak);
1181			break;
1182		case PARSE_EVENTS__TERM_TYPE_PERCORE:
1183			ADD_CONFIG_TERM_VAL(PERCORE, percore,
1184					    term->val.num ? true : false, term->weak);
1185			break;
1186		case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
1187			ADD_CONFIG_TERM_VAL(AUX_OUTPUT, aux_output,
1188					    term->val.num ? 1 : 0, term->weak);
1189			break;
1190		case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
1191			ADD_CONFIG_TERM_VAL(AUX_SAMPLE_SIZE, aux_sample_size,
1192					    term->val.num, term->weak);
1193			break;
1194		case PARSE_EVENTS__TERM_TYPE_USER:
1195		case PARSE_EVENTS__TERM_TYPE_CONFIG:
1196		case PARSE_EVENTS__TERM_TYPE_CONFIG1:
1197		case PARSE_EVENTS__TERM_TYPE_CONFIG2:
1198		case PARSE_EVENTS__TERM_TYPE_CONFIG3:
1199		case PARSE_EVENTS__TERM_TYPE_NAME:
1200		case PARSE_EVENTS__TERM_TYPE_METRIC_ID:
1201		case PARSE_EVENTS__TERM_TYPE_RAW:
1202		case PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE:
1203		case PARSE_EVENTS__TERM_TYPE_HARDWARE:
1204		default:
1205			break;
1206		}
1207	}
1208	return 0;
1209}
1210
1211/*
1212 * Add EVSEL__CONFIG_TERM_CFG_CHG where cfg_chg will have a bit set for
1213 * each bit of attr->config that the user has changed.
1214 */
1215static int get_config_chgs(struct perf_pmu *pmu, struct parse_events_terms *head_config,
1216			   struct list_head *head_terms)
1217{
1218	struct parse_events_term *term;
1219	u64 bits = 0;
1220	int type;
1221
1222	list_for_each_entry(term, &head_config->terms, list) {
1223		switch (term->type_term) {
1224		case PARSE_EVENTS__TERM_TYPE_USER:
1225			type = perf_pmu__format_type(pmu, term->config);
1226			if (type != PERF_PMU_FORMAT_VALUE_CONFIG)
1227				continue;
1228			bits |= perf_pmu__format_bits(pmu, term->config);
1229			break;
1230		case PARSE_EVENTS__TERM_TYPE_CONFIG:
1231			bits = ~(u64)0;
1232			break;
1233		case PARSE_EVENTS__TERM_TYPE_CONFIG1:
1234		case PARSE_EVENTS__TERM_TYPE_CONFIG2:
1235		case PARSE_EVENTS__TERM_TYPE_CONFIG3:
1236		case PARSE_EVENTS__TERM_TYPE_NAME:
1237		case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
1238		case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
1239		case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
1240		case PARSE_EVENTS__TERM_TYPE_TIME:
1241		case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
1242		case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
1243		case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
1244		case PARSE_EVENTS__TERM_TYPE_INHERIT:
1245		case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
1246		case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
1247		case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
1248		case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
1249		case PARSE_EVENTS__TERM_TYPE_DRV_CFG:
1250		case PARSE_EVENTS__TERM_TYPE_PERCORE:
1251		case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
1252		case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
1253		case PARSE_EVENTS__TERM_TYPE_METRIC_ID:
1254		case PARSE_EVENTS__TERM_TYPE_RAW:
1255		case PARSE_EVENTS__TERM_TYPE_LEGACY_CACHE:
1256		case PARSE_EVENTS__TERM_TYPE_HARDWARE:
1257		default:
1258			break;
1259		}
1260	}
1261
1262	if (bits)
1263		ADD_CONFIG_TERM_VAL(CFG_CHG, cfg_chg, bits, false);
1264
1265#undef ADD_CONFIG_TERM
1266	return 0;
1267}
1268
1269int parse_events_add_tracepoint(struct list_head *list, int *idx,
1270				const char *sys, const char *event,
1271				struct parse_events_error *err,
1272				struct parse_events_terms *head_config, void *loc_)
1273{
1274	YYLTYPE *loc = loc_;
1275#ifdef HAVE_LIBTRACEEVENT
1276	if (head_config) {
1277		struct perf_event_attr attr;
1278
1279		if (config_attr(&attr, head_config, err,
1280				config_term_tracepoint))
1281			return -EINVAL;
1282	}
1283
1284	if (strpbrk(sys, "*?"))
1285		return add_tracepoint_multi_sys(list, idx, sys, event,
1286						err, head_config, loc);
1287	else
1288		return add_tracepoint_event(list, idx, sys, event,
1289					    err, head_config, loc);
1290#else
1291	(void)list;
1292	(void)idx;
1293	(void)sys;
1294	(void)event;
1295	(void)head_config;
1296	parse_events_error__handle(err, loc->first_column, strdup("unsupported tracepoint"),
1297				strdup("libtraceevent is necessary for tracepoint support"));
1298	return -1;
1299#endif
1300}
1301
1302static int __parse_events_add_numeric(struct parse_events_state *parse_state,
1303				struct list_head *list,
1304				struct perf_pmu *pmu, u32 type, u32 extended_type,
1305				u64 config, struct parse_events_terms *head_config)
1306{
1307	struct perf_event_attr attr;
1308	LIST_HEAD(config_terms);
1309	const char *name, *metric_id;
1310	int ret;
1311
1312	memset(&attr, 0, sizeof(attr));
1313	attr.type = type;
1314	attr.config = config;
1315	if (extended_type && (type == PERF_TYPE_HARDWARE || type == PERF_TYPE_HW_CACHE)) {
1316		assert(perf_pmus__supports_extended_type());
1317		attr.config |= (u64)extended_type << PERF_PMU_TYPE_SHIFT;
1318	}
1319
1320	if (head_config) {
1321		if (config_attr(&attr, head_config, parse_state->error,
1322				config_term_common))
1323			return -EINVAL;
1324
1325		if (get_config_terms(head_config, &config_terms))
1326			return -ENOMEM;
1327	}
1328
1329	name = get_config_name(head_config);
1330	metric_id = get_config_metric_id(head_config);
1331	ret = __add_event(list, &parse_state->idx, &attr, /*init_attr*/true, name,
1332			metric_id, pmu, &config_terms, /*auto_merge_stats=*/false,
1333			/*cpu_list=*/NULL) ? 0 : -ENOMEM;
1334	free_config_terms(&config_terms);
1335	return ret;
1336}
1337
1338int parse_events_add_numeric(struct parse_events_state *parse_state,
1339			     struct list_head *list,
1340			     u32 type, u64 config,
1341			     struct parse_events_terms *head_config,
1342			     bool wildcard)
1343{
1344	struct perf_pmu *pmu = NULL;
1345	bool found_supported = false;
1346
1347	/* Wildcards on numeric values are only supported by core PMUs. */
1348	if (wildcard && perf_pmus__supports_extended_type()) {
1349		while ((pmu = perf_pmus__scan_core(pmu)) != NULL) {
1350			int ret;
1351
1352			found_supported = true;
1353			if (parse_events__filter_pmu(parse_state, pmu))
1354				continue;
1355
1356			ret = __parse_events_add_numeric(parse_state, list, pmu,
1357							 type, pmu->type,
1358							 config, head_config);
1359			if (ret)
1360				return ret;
1361		}
1362		if (found_supported)
1363			return 0;
1364	}
1365	return __parse_events_add_numeric(parse_state, list, perf_pmus__find_by_type(type),
1366					type, /*extended_type=*/0, config, head_config);
1367}
1368
1369int parse_events_add_tool(struct parse_events_state *parse_state,
1370			  struct list_head *list,
1371			  int tool_event)
1372{
1373	return add_event_tool(list, &parse_state->idx, tool_event);
1374}
1375
1376static bool config_term_percore(struct list_head *config_terms)
1377{
1378	struct evsel_config_term *term;
1379
1380	list_for_each_entry(term, config_terms, list) {
1381		if (term->type == EVSEL__CONFIG_TERM_PERCORE)
1382			return term->val.percore;
1383	}
1384
1385	return false;
1386}
1387
1388int parse_events_add_pmu(struct parse_events_state *parse_state,
1389			 struct list_head *list, const char *name,
1390			 const struct parse_events_terms *const_parsed_terms,
1391			 bool auto_merge_stats, void *loc_)
 
1392{
1393	struct perf_event_attr attr;
1394	struct perf_pmu_info info;
1395	struct perf_pmu *pmu;
1396	struct evsel *evsel;
1397	struct parse_events_error *err = parse_state->error;
1398	YYLTYPE *loc = loc_;
1399	LIST_HEAD(config_terms);
1400	struct parse_events_terms parsed_terms;
1401	bool alias_rewrote_terms = false;
1402
1403	pmu = parse_state->fake_pmu ?: perf_pmus__find(name);
 
 
 
 
 
 
 
 
 
 
 
1404
 
1405	if (!pmu) {
1406		char *err_str;
1407
1408		if (asprintf(&err_str,
1409				"Cannot find PMU `%s'. Missing kernel support?",
1410				name) >= 0)
1411			parse_events_error__handle(err, loc->first_column, err_str, NULL);
1412		return -EINVAL;
1413	}
1414
1415	parse_events_terms__init(&parsed_terms);
1416	if (const_parsed_terms) {
1417		int ret = parse_events_terms__copy(const_parsed_terms, &parsed_terms);
1418
1419		if (ret)
1420			return ret;
1421	}
1422
1423	if (verbose > 1) {
1424		struct strbuf sb;
1425
1426		strbuf_init(&sb, /*hint=*/ 0);
1427		if (pmu->selectable && list_empty(&parsed_terms.terms)) {
1428			strbuf_addf(&sb, "%s//", name);
 
 
 
 
 
1429		} else {
1430			strbuf_addf(&sb, "%s/", name);
1431			parse_events_terms__to_strbuf(&parsed_terms, &sb);
1432			strbuf_addch(&sb, '/');
1433		}
1434		fprintf(stderr, "Attempt to add: %s\n", sb.buf);
1435		strbuf_release(&sb);
1436	}
1437	fix_raw(&parsed_terms, pmu);
1438
1439	memset(&attr, 0, sizeof(attr));
1440	if (pmu->perf_event_attr_init_default)
1441		pmu->perf_event_attr_init_default(pmu, &attr);
1442
1443	attr.type = pmu->type;
1444
1445	if (list_empty(&parsed_terms.terms)) {
1446		evsel = __add_event(list, &parse_state->idx, &attr,
1447				    /*init_attr=*/true, /*name=*/NULL,
1448				    /*metric_id=*/NULL, pmu,
1449				    /*config_terms=*/NULL, auto_merge_stats,
1450				    /*cpu_list=*/NULL);
1451		return evsel ? 0 : -ENOMEM;
1452	}
1453
1454	/* Configure attr/terms with a known PMU, this will set hardcoded terms. */
1455	if (config_attr(&attr, &parsed_terms, parse_state->error, config_term_pmu)) {
1456		parse_events_terms__exit(&parsed_terms);
1457		return -EINVAL;
1458	}
1459
1460	/* Look for event names in the terms and rewrite into format based terms. */
1461	if (!parse_state->fake_pmu && perf_pmu__check_alias(pmu, &parsed_terms,
1462							    &info, &alias_rewrote_terms, err)) {
1463		parse_events_terms__exit(&parsed_terms);
1464		return -EINVAL;
1465	}
1466
1467	if (verbose > 1) {
1468		struct strbuf sb;
 
 
 
1469
1470		strbuf_init(&sb, /*hint=*/ 0);
1471		parse_events_terms__to_strbuf(&parsed_terms, &sb);
1472		fprintf(stderr, "..after resolving event: %s/%s/\n", name, sb.buf);
1473		strbuf_release(&sb);
 
1474	}
1475
1476	/* Configure attr/terms again if an alias was expanded. */
1477	if (alias_rewrote_terms &&
1478	    config_attr(&attr, &parsed_terms, parse_state->error, config_term_pmu)) {
1479		parse_events_terms__exit(&parsed_terms);
 
1480		return -EINVAL;
1481	}
1482
1483	if (get_config_terms(&parsed_terms, &config_terms)) {
1484		parse_events_terms__exit(&parsed_terms);
1485		return -ENOMEM;
1486	}
1487
1488	/*
1489	 * When using default config, record which bits of attr->config were
1490	 * changed by the user.
1491	 */
1492	if (pmu->perf_event_attr_init_default &&
1493	    get_config_chgs(pmu, &parsed_terms, &config_terms)) {
1494		parse_events_terms__exit(&parsed_terms);
1495		return -ENOMEM;
1496	}
1497
1498	if (!parse_state->fake_pmu &&
1499	    perf_pmu__config(pmu, &attr, &parsed_terms, parse_state->error)) {
1500		free_config_terms(&config_terms);
1501		parse_events_terms__exit(&parsed_terms);
 
 
 
 
 
1502		return -EINVAL;
1503	}
1504
1505	evsel = __add_event(list, &parse_state->idx, &attr, /*init_attr=*/true,
1506			    get_config_name(&parsed_terms),
1507			    get_config_metric_id(&parsed_terms), pmu,
1508			    &config_terms, auto_merge_stats, /*cpu_list=*/NULL);
1509	if (!evsel) {
1510		parse_events_terms__exit(&parsed_terms);
1511		return -ENOMEM;
1512	}
1513
1514	if (evsel->name)
1515		evsel->use_config_name = true;
1516
 
 
1517	evsel->percore = config_term_percore(&evsel->config_terms);
1518
1519	if (parse_state->fake_pmu) {
1520		parse_events_terms__exit(&parsed_terms);
1521		return 0;
1522	}
1523
1524	parse_events_terms__exit(&parsed_terms);
1525	free((char *)evsel->unit);
1526	evsel->unit = strdup(info.unit);
1527	evsel->scale = info.scale;
1528	evsel->per_pkg = info.per_pkg;
1529	evsel->snapshot = info.snapshot;
 
 
1530	return 0;
1531}
1532
1533int parse_events_multi_pmu_add(struct parse_events_state *parse_state,
1534			       const char *event_name,
1535			       const struct parse_events_terms *const_parsed_terms,
1536			       struct list_head **listp, void *loc_)
1537{
1538	struct parse_events_term *term;
1539	struct list_head *list = NULL;
1540	struct perf_pmu *pmu = NULL;
1541	YYLTYPE *loc = loc_;
1542	int ok = 0;
1543	const char *config;
1544	struct parse_events_terms parsed_terms;
1545
1546	*listp = NULL;
 
 
 
 
 
 
 
1547
1548	parse_events_terms__init(&parsed_terms);
1549	if (const_parsed_terms) {
1550		int ret = parse_events_terms__copy(const_parsed_terms, &parsed_terms);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1551
1552		if (ret)
1553			return ret;
1554	}
 
 
 
 
1555
1556	config = strdup(event_name);
1557	if (!config)
1558		goto out_err;
1559
1560	if (parse_events_term__num(&term,
1561				   PARSE_EVENTS__TERM_TYPE_USER,
1562				   config, /*num=*/1, /*novalue=*/true,
1563				   loc, /*loc_val=*/NULL) < 0) {
1564		zfree(&config);
1565		goto out_err;
1566	}
1567	list_add_tail(&term->list, &parsed_terms.terms);
 
 
 
 
 
 
1568
1569	/* Add it for all PMUs that support the alias */
1570	list = malloc(sizeof(struct list_head));
1571	if (!list)
1572		goto out_err;
 
1573
1574	INIT_LIST_HEAD(list);
 
 
 
 
 
 
1575
1576	while ((pmu = perf_pmus__scan(pmu)) != NULL) {
1577		bool auto_merge_stats;
1578
1579		if (parse_events__filter_pmu(parse_state, pmu))
1580			continue;
1581
1582		if (!perf_pmu__have_event(pmu, event_name))
1583			continue;
 
 
 
1584
1585		auto_merge_stats = perf_pmu__auto_merge_stats(pmu);
1586		if (!parse_events_add_pmu(parse_state, list, pmu->name,
1587					  &parsed_terms, auto_merge_stats, loc)) {
1588			struct strbuf sb;
 
 
 
 
 
 
 
 
1589
1590			strbuf_init(&sb, /*hint=*/ 0);
1591			parse_events_terms__to_strbuf(&parsed_terms, &sb);
1592			pr_debug("%s -> %s/%s/\n", event_name, pmu->name, sb.buf);
1593			strbuf_release(&sb);
1594			ok++;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1595		}
 
 
 
1596	}
1597
1598	if (parse_state->fake_pmu) {
1599		if (!parse_events_add_pmu(parse_state, list, event_name, &parsed_terms,
1600					  /*auto_merge_stats=*/true, loc)) {
1601			struct strbuf sb;
 
1602
1603			strbuf_init(&sb, /*hint=*/ 0);
1604			parse_events_terms__to_strbuf(&parsed_terms, &sb);
1605			pr_debug("%s -> %s/%s/\n", event_name, "fake_pmu", sb.buf);
1606			strbuf_release(&sb);
1607			ok++;
1608		}
 
 
 
 
 
 
 
 
 
 
 
1609	}
1610
1611out_err:
1612	parse_events_terms__exit(&parsed_terms);
1613	if (ok)
1614		*listp = list;
1615	else
1616		free(list);
1617
1618	return ok ? 0 : -1;
1619}
1620
1621int parse_events__modifier_group(struct list_head *list,
1622				 char *event_mod)
1623{
1624	return parse_events__modifier_event(list, event_mod, true);
 
1625}
1626
1627void parse_events__set_leader(char *name, struct list_head *list)
 
1628{
1629	struct evsel *leader;
1630
1631	if (list_empty(list)) {
1632		WARN_ONCE(true, "WARNING: failed to set leader: empty list");
1633		return;
1634	}
1635
1636	leader = list_first_entry(list, struct evsel, core.node);
1637	__perf_evlist__set_leader(list, &leader->core);
1638	leader->group_name = name;
 
 
 
1639}
1640
1641/* list_event is assumed to point to malloc'ed memory */
1642void parse_events_update_lists(struct list_head *list_event,
1643			       struct list_head *list_all)
1644{
1645	/*
1646	 * Called for single event definition. Update the
1647	 * 'all event' list, and reinit the 'single event'
1648	 * list, for next event definition.
1649	 */
1650	list_splice_tail(list_event, list_all);
1651	free(list_event);
1652}
1653
1654struct event_modifier {
1655	int eu;
1656	int ek;
1657	int eh;
1658	int eH;
1659	int eG;
1660	int eI;
1661	int precise;
1662	int precise_max;
1663	int exclude_GH;
1664	int sample_read;
1665	int pinned;
1666	int weak;
1667	int exclusive;
1668	int bpf_counter;
1669};
1670
1671static int get_event_modifier(struct event_modifier *mod, char *str,
1672			       struct evsel *evsel)
1673{
1674	int eu = evsel ? evsel->core.attr.exclude_user : 0;
1675	int ek = evsel ? evsel->core.attr.exclude_kernel : 0;
1676	int eh = evsel ? evsel->core.attr.exclude_hv : 0;
1677	int eH = evsel ? evsel->core.attr.exclude_host : 0;
1678	int eG = evsel ? evsel->core.attr.exclude_guest : 0;
1679	int eI = evsel ? evsel->core.attr.exclude_idle : 0;
1680	int precise = evsel ? evsel->core.attr.precise_ip : 0;
1681	int precise_max = 0;
1682	int sample_read = 0;
1683	int pinned = evsel ? evsel->core.attr.pinned : 0;
1684	int exclusive = evsel ? evsel->core.attr.exclusive : 0;
1685
1686	int exclude = eu | ek | eh;
1687	int exclude_GH = evsel ? evsel->exclude_GH : 0;
1688	int weak = 0;
1689	int bpf_counter = 0;
1690
1691	memset(mod, 0, sizeof(*mod));
1692
1693	while (*str) {
1694		if (*str == 'u') {
1695			if (!exclude)
1696				exclude = eu = ek = eh = 1;
1697			if (!exclude_GH && !perf_guest)
1698				eG = 1;
1699			eu = 0;
1700		} else if (*str == 'k') {
1701			if (!exclude)
1702				exclude = eu = ek = eh = 1;
1703			ek = 0;
1704		} else if (*str == 'h') {
1705			if (!exclude)
1706				exclude = eu = ek = eh = 1;
1707			eh = 0;
1708		} else if (*str == 'G') {
1709			if (!exclude_GH)
1710				exclude_GH = eG = eH = 1;
1711			eG = 0;
1712		} else if (*str == 'H') {
1713			if (!exclude_GH)
1714				exclude_GH = eG = eH = 1;
1715			eH = 0;
1716		} else if (*str == 'I') {
1717			eI = 1;
1718		} else if (*str == 'p') {
1719			precise++;
1720			/* use of precise requires exclude_guest */
1721			if (!exclude_GH)
1722				eG = 1;
1723		} else if (*str == 'P') {
1724			precise_max = 1;
1725		} else if (*str == 'S') {
1726			sample_read = 1;
1727		} else if (*str == 'D') {
1728			pinned = 1;
1729		} else if (*str == 'e') {
1730			exclusive = 1;
1731		} else if (*str == 'W') {
1732			weak = 1;
1733		} else if (*str == 'b') {
1734			bpf_counter = 1;
1735		} else
1736			break;
1737
1738		++str;
1739	}
1740
1741	/*
1742	 * precise ip:
1743	 *
1744	 *  0 - SAMPLE_IP can have arbitrary skid
1745	 *  1 - SAMPLE_IP must have constant skid
1746	 *  2 - SAMPLE_IP requested to have 0 skid
1747	 *  3 - SAMPLE_IP must have 0 skid
1748	 *
1749	 *  See also PERF_RECORD_MISC_EXACT_IP
1750	 */
1751	if (precise > 3)
1752		return -EINVAL;
1753
1754	mod->eu = eu;
1755	mod->ek = ek;
1756	mod->eh = eh;
1757	mod->eH = eH;
1758	mod->eG = eG;
1759	mod->eI = eI;
1760	mod->precise = precise;
1761	mod->precise_max = precise_max;
1762	mod->exclude_GH = exclude_GH;
1763	mod->sample_read = sample_read;
1764	mod->pinned = pinned;
1765	mod->weak = weak;
1766	mod->bpf_counter = bpf_counter;
1767	mod->exclusive = exclusive;
1768
1769	return 0;
1770}
1771
1772/*
1773 * Basic modifier sanity check to validate it contains only one
1774 * instance of any modifier (apart from 'p') present.
1775 */
1776static int check_modifier(char *str)
1777{
1778	char *p = str;
1779
1780	/* The sizeof includes 0 byte as well. */
1781	if (strlen(str) > (sizeof("ukhGHpppPSDIWeb") - 1))
1782		return -1;
1783
1784	while (*p) {
1785		if (*p != 'p' && strchr(p + 1, *p))
1786			return -1;
1787		p++;
1788	}
1789
1790	return 0;
1791}
1792
1793int parse_events__modifier_event(struct list_head *list, char *str, bool add)
1794{
1795	struct evsel *evsel;
1796	struct event_modifier mod;
1797
1798	if (str == NULL)
1799		return 0;
1800
1801	if (check_modifier(str))
1802		return -EINVAL;
1803
1804	if (!add && get_event_modifier(&mod, str, NULL))
1805		return -EINVAL;
1806
1807	__evlist__for_each_entry(list, evsel) {
1808		if (add && get_event_modifier(&mod, str, evsel))
1809			return -EINVAL;
1810
1811		evsel->core.attr.exclude_user   = mod.eu;
1812		evsel->core.attr.exclude_kernel = mod.ek;
1813		evsel->core.attr.exclude_hv     = mod.eh;
1814		evsel->core.attr.precise_ip     = mod.precise;
1815		evsel->core.attr.exclude_host   = mod.eH;
1816		evsel->core.attr.exclude_guest  = mod.eG;
1817		evsel->core.attr.exclude_idle   = mod.eI;
1818		evsel->exclude_GH          = mod.exclude_GH;
1819		evsel->sample_read         = mod.sample_read;
1820		evsel->precise_max         = mod.precise_max;
1821		evsel->weak_group	   = mod.weak;
1822		evsel->bpf_counter	   = mod.bpf_counter;
1823
1824		if (evsel__is_group_leader(evsel)) {
1825			evsel->core.attr.pinned = mod.pinned;
1826			evsel->core.attr.exclusive = mod.exclusive;
1827		}
1828	}
1829
1830	return 0;
1831}
1832
1833int parse_events_name(struct list_head *list, const char *name)
1834{
1835	struct evsel *evsel;
1836
1837	__evlist__for_each_entry(list, evsel) {
1838		if (!evsel->name) {
1839			evsel->name = strdup(name);
1840			if (!evsel->name)
1841				return -ENOMEM;
1842		}
1843	}
1844
1845	return 0;
1846}
1847
1848static int parse_events__scanner(const char *str,
1849				 FILE *input,
1850				 struct parse_events_state *parse_state)
1851{
1852	YY_BUFFER_STATE buffer;
1853	void *scanner;
1854	int ret;
1855
1856	ret = parse_events_lex_init_extra(parse_state, &scanner);
1857	if (ret)
1858		return ret;
1859
1860	if (str)
1861		buffer = parse_events__scan_string(str, scanner);
1862	else
1863	        parse_events_set_in(input, scanner);
1864
1865#ifdef PARSER_DEBUG
1866	parse_events_debug = 1;
1867	parse_events_set_debug(1, scanner);
1868#endif
1869	ret = parse_events_parse(parse_state, scanner);
1870
1871	if (str) {
1872		parse_events__flush_buffer(buffer, scanner);
1873		parse_events__delete_buffer(buffer, scanner);
 
 
 
1874	}
1875	parse_events_lex_destroy(scanner);
1876	return ret;
1877}
1878
 
 
 
 
 
 
 
 
1879/*
1880 * parse event config string, return a list of event terms.
 
1881 */
1882int parse_events_terms(struct parse_events_terms *terms, const char *str, FILE *input)
1883{
1884	struct parse_events_state parse_state = {
1885		.terms  = NULL,
1886		.stoken = PE_START_TERMS,
1887	};
1888	int ret;
1889
1890	ret = parse_events__scanner(str, input, &parse_state);
1891	if (!ret)
1892		list_splice(&parse_state.terms->terms, &terms->terms);
1893
1894	zfree(&parse_state.terms);
1895	return ret;
1896}
1897
1898static int evsel__compute_group_pmu_name(struct evsel *evsel,
1899					  const struct list_head *head)
1900{
1901	struct evsel *leader = evsel__leader(evsel);
1902	struct evsel *pos;
1903	const char *group_pmu_name;
1904	struct perf_pmu *pmu = evsel__find_pmu(evsel);
1905
1906	if (!pmu) {
1907		/*
1908		 * For PERF_TYPE_HARDWARE and PERF_TYPE_HW_CACHE types the PMU
1909		 * is a core PMU, but in heterogeneous systems this is
1910		 * unknown. For now pick the first core PMU.
1911		 */
1912		pmu = perf_pmus__scan_core(NULL);
1913	}
1914	if (!pmu) {
1915		pr_debug("No PMU found for '%s'\n", evsel__name(evsel));
1916		return -EINVAL;
1917	}
1918	group_pmu_name = pmu->name;
1919	/*
1920	 * Software events may be in a group with other uncore PMU events. Use
1921	 * the pmu_name of the first non-software event to avoid breaking the
1922	 * software event out of the group.
1923	 *
1924	 * Aux event leaders, like intel_pt, expect a group with events from
1925	 * other PMUs, so substitute the AUX event's PMU in this case.
1926	 */
1927	if (perf_pmu__is_software(pmu) || evsel__is_aux_event(leader)) {
1928		struct perf_pmu *leader_pmu = evsel__find_pmu(leader);
1929
1930		if (!leader_pmu) {
1931			/* As with determining pmu above. */
1932			leader_pmu = perf_pmus__scan_core(NULL);
1933		}
1934		/*
1935		 * Starting with the leader, find the first event with a named
1936		 * non-software PMU. for_each_group_(member|evsel) isn't used as
1937		 * the list isn't yet sorted putting evsel's in the same group
1938		 * together.
1939		 */
1940		if (leader_pmu && !perf_pmu__is_software(leader_pmu)) {
1941			group_pmu_name = leader_pmu->name;
1942		} else if (leader->core.nr_members > 1) {
1943			list_for_each_entry(pos, head, core.node) {
1944				struct perf_pmu *pos_pmu;
1945
1946				if (pos == leader || evsel__leader(pos) != leader)
1947					continue;
1948				pos_pmu = evsel__find_pmu(pos);
1949				if (!pos_pmu) {
1950					/* As with determining pmu above. */
1951					pos_pmu = perf_pmus__scan_core(NULL);
1952				}
1953				if (pos_pmu && !perf_pmu__is_software(pos_pmu)) {
1954					group_pmu_name = pos_pmu->name;
1955					break;
1956				}
 
 
 
 
 
1957			}
1958		}
1959	}
1960	/* Assign the actual name taking care that the fake PMU lacks a name. */
1961	evsel->group_pmu_name = strdup(group_pmu_name ?: "fake");
1962	return evsel->group_pmu_name ? 0 : -ENOMEM;
1963}
1964
1965__weak int arch_evlist__cmp(const struct evsel *lhs, const struct evsel *rhs)
1966{
1967	/* Order by insertion index. */
1968	return lhs->core.idx - rhs->core.idx;
1969}
1970
1971static int evlist__cmp(void *_fg_idx, const struct list_head *l, const struct list_head *r)
 
 
 
 
 
1972{
1973	const struct perf_evsel *lhs_core = container_of(l, struct perf_evsel, node);
1974	const struct evsel *lhs = container_of(lhs_core, struct evsel, core);
1975	const struct perf_evsel *rhs_core = container_of(r, struct perf_evsel, node);
1976	const struct evsel *rhs = container_of(rhs_core, struct evsel, core);
1977	int *force_grouped_idx = _fg_idx;
1978	int lhs_sort_idx, rhs_sort_idx, ret;
1979	const char *lhs_pmu_name, *rhs_pmu_name;
1980	bool lhs_has_group, rhs_has_group;
1981
1982	/*
1983	 * First sort by grouping/leader. Read the leader idx only if the evsel
1984	 * is part of a group, by default ungrouped events will be sorted
1985	 * relative to grouped events based on where the first ungrouped event
1986	 * occurs. If both events don't have a group we want to fall-through to
1987	 * the arch specific sorting, that can reorder and fix things like
1988	 * Intel's topdown events.
1989	 */
1990	if (lhs_core->leader != lhs_core || lhs_core->nr_members > 1) {
1991		lhs_has_group = true;
1992		lhs_sort_idx = lhs_core->leader->idx;
1993	} else {
1994		lhs_has_group = false;
1995		lhs_sort_idx = *force_grouped_idx != -1 && arch_evsel__must_be_in_group(lhs)
1996			? *force_grouped_idx
1997			: lhs_core->idx;
1998	}
1999	if (rhs_core->leader != rhs_core || rhs_core->nr_members > 1) {
2000		rhs_has_group = true;
2001		rhs_sort_idx = rhs_core->leader->idx;
2002	} else {
2003		rhs_has_group = false;
2004		rhs_sort_idx = *force_grouped_idx != -1 && arch_evsel__must_be_in_group(rhs)
2005			? *force_grouped_idx
2006			: rhs_core->idx;
2007	}
2008
2009	if (lhs_sort_idx != rhs_sort_idx)
2010		return lhs_sort_idx - rhs_sort_idx;
2011
2012	/* Group by PMU if there is a group. Groups can't span PMUs. */
2013	if (lhs_has_group && rhs_has_group) {
2014		lhs_pmu_name = lhs->group_pmu_name;
2015		rhs_pmu_name = rhs->group_pmu_name;
2016		ret = strcmp(lhs_pmu_name, rhs_pmu_name);
2017		if (ret)
2018			return ret;
2019	}
2020
2021	/* Architecture specific sorting. */
2022	return arch_evlist__cmp(lhs, rhs);
 
2023}
2024
2025static int parse_events__sort_events_and_fix_groups(struct list_head *list)
 
2026{
2027	int idx = 0, force_grouped_idx = -1;
2028	struct evsel *pos, *cur_leader = NULL;
2029	struct perf_evsel *cur_leaders_grp = NULL;
2030	bool idx_changed = false, cur_leader_force_grouped = false;
2031	int orig_num_leaders = 0, num_leaders = 0;
2032	int ret;
2033
 
 
 
2034	/*
2035	 * Compute index to insert ungrouped events at. Place them where the
2036	 * first ungrouped event appears.
 
2037	 */
2038	list_for_each_entry(pos, list, core.node) {
2039		const struct evsel *pos_leader = evsel__leader(pos);
2040
2041		ret = evsel__compute_group_pmu_name(pos, list);
2042		if (ret)
2043			return ret;
 
 
 
 
2044
2045		if (pos == pos_leader)
2046			orig_num_leaders++;
 
 
 
 
2047
2048		/*
2049		 * Ensure indexes are sequential, in particular for multiple
2050		 * event lists being merged. The indexes are used to detect when
2051		 * the user order is modified.
2052		 */
2053		pos->core.idx = idx++;
2054
2055		/* Remember an index to sort all forced grouped events together to. */
2056		if (force_grouped_idx == -1 && pos == pos_leader && pos->core.nr_members < 2 &&
2057		    arch_evsel__must_be_in_group(pos))
2058			force_grouped_idx = pos->core.idx;
2059	}
2060
2061	/* Sort events. */
2062	list_sort(&force_grouped_idx, list, evlist__cmp);
 
 
 
2063
2064	/*
2065	 * Recompute groups, splitting for PMUs and adding groups for events
2066	 * that require them.
2067	 */
2068	idx = 0;
2069	list_for_each_entry(pos, list, core.node) {
2070		const struct evsel *pos_leader = evsel__leader(pos);
2071		const char *pos_pmu_name = pos->group_pmu_name;
2072		const char *cur_leader_pmu_name;
2073		bool pos_force_grouped = force_grouped_idx != -1 &&
2074			arch_evsel__must_be_in_group(pos);
2075
2076		/* Reset index and nr_members. */
2077		if (pos->core.idx != idx)
2078			idx_changed = true;
2079		pos->core.idx = idx++;
2080		pos->core.nr_members = 0;
2081
2082		/*
2083		 * Set the group leader respecting the given groupings and that
2084		 * groups can't span PMUs.
2085		 */
2086		if (!cur_leader)
2087			cur_leader = pos;
 
 
 
 
2088
2089		cur_leader_pmu_name = cur_leader->group_pmu_name;
2090		if ((cur_leaders_grp != pos->core.leader &&
2091		     (!pos_force_grouped || !cur_leader_force_grouped)) ||
2092		    strcmp(cur_leader_pmu_name, pos_pmu_name)) {
2093			/* Event is for a different group/PMU than last. */
2094			cur_leader = pos;
2095			/*
2096			 * Remember the leader's group before it is overwritten,
2097			 * so that later events match as being in the same
2098			 * group.
2099			 */
2100			cur_leaders_grp = pos->core.leader;
2101			/*
2102			 * Avoid forcing events into groups with events that
2103			 * don't need to be in the group.
2104			 */
2105			cur_leader_force_grouped = pos_force_grouped;
2106		}
2107		if (pos_leader != cur_leader) {
2108			/* The leader changed so update it. */
2109			evsel__set_leader(pos, cur_leader);
2110		}
2111	}
2112	list_for_each_entry(pos, list, core.node) {
2113		struct evsel *pos_leader = evsel__leader(pos);
2114
2115		if (pos == pos_leader)
2116			num_leaders++;
2117		pos_leader->core.nr_members++;
 
2118	}
2119	return (idx_changed || num_leaders != orig_num_leaders) ? 1 : 0;
 
 
2120}
2121
2122int __parse_events(struct evlist *evlist, const char *str, const char *pmu_filter,
2123		   struct parse_events_error *err, struct perf_pmu *fake_pmu,
2124		   bool warn_if_reordered)
2125{
2126	struct parse_events_state parse_state = {
2127		.list	  = LIST_HEAD_INIT(parse_state.list),
2128		.idx	  = evlist->core.nr_entries,
2129		.error	  = err,
 
2130		.stoken	  = PE_START_EVENTS,
2131		.fake_pmu = fake_pmu,
2132		.pmu_filter = pmu_filter,
2133		.match_legacy_cache_terms = true,
2134	};
2135	int ret, ret2;
2136
2137	ret = parse_events__scanner(str, /*input=*/ NULL, &parse_state);
 
2138
2139	if (!ret && list_empty(&parse_state.list)) {
2140		WARN_ONCE(true, "WARNING: event parser found nothing\n");
2141		return -1;
2142	}
2143
2144	ret2 = parse_events__sort_events_and_fix_groups(&parse_state.list);
2145	if (ret2 < 0)
2146		return ret;
2147
2148	if (ret2 && warn_if_reordered && !parse_state.wild_card_pmus)
2149		pr_warning("WARNING: events were regrouped to match PMUs\n");
2150
2151	/*
2152	 * Add list to the evlist even with errors to allow callers to clean up.
2153	 */
2154	evlist__splice_list_tail(evlist, &parse_state.list);
2155
2156	if (!ret) {
2157		struct evsel *last;
2158
 
2159		last = evlist__last(evlist);
2160		last->cmdline_group_boundary = true;
2161
2162		return 0;
2163	}
2164
2165	/*
2166	 * There are 2 users - builtin-record and builtin-test objects.
2167	 * Both call evlist__delete in case of error, so we dont
2168	 * need to bother.
2169	 */
2170	return ret;
2171}
2172
2173int parse_event(struct evlist *evlist, const char *str)
2174{
2175	struct parse_events_error err;
2176	int ret;
2177
2178	parse_events_error__init(&err);
2179	ret = parse_events(evlist, str, &err);
2180	parse_events_error__exit(&err);
2181	return ret;
2182}
2183
2184void parse_events_error__init(struct parse_events_error *err)
2185{
2186	bzero(err, sizeof(*err));
2187}
2188
2189void parse_events_error__exit(struct parse_events_error *err)
2190{
2191	zfree(&err->str);
2192	zfree(&err->help);
2193	zfree(&err->first_str);
2194	zfree(&err->first_help);
2195}
2196
2197void parse_events_error__handle(struct parse_events_error *err, int idx,
2198				char *str, char *help)
2199{
2200	if (WARN(!str || !err, "WARNING: failed to provide error string or struct\n"))
2201		goto out_free;
2202	switch (err->num_errors) {
2203	case 0:
2204		err->idx = idx;
2205		err->str = str;
2206		err->help = help;
2207		break;
2208	case 1:
2209		err->first_idx = err->idx;
2210		err->idx = idx;
2211		err->first_str = err->str;
2212		err->str = str;
2213		err->first_help = err->help;
2214		err->help = help;
2215		break;
2216	default:
2217		pr_debug("Multiple errors dropping message: %s (%s)\n",
2218			err->str, err->help ?: "<no help>");
2219		free(err->str);
2220		err->str = str;
2221		free(err->help);
2222		err->help = help;
2223		break;
2224	}
2225	err->num_errors++;
2226	return;
2227
2228out_free:
2229	free(str);
2230	free(help);
2231}
2232
2233#define MAX_WIDTH 1000
2234static int get_term_width(void)
2235{
2236	struct winsize ws;
2237
2238	get_term_dimensions(&ws);
2239	return ws.ws_col > MAX_WIDTH ? MAX_WIDTH : ws.ws_col;
2240}
2241
2242static void __parse_events_error__print(int err_idx, const char *err_str,
2243					const char *err_help, const char *event)
2244{
2245	const char *str = "invalid or unsupported event: ";
2246	char _buf[MAX_WIDTH];
2247	char *buf = (char *) event;
2248	int idx = 0;
2249	if (err_str) {
2250		/* -2 for extra '' in the final fprintf */
2251		int width       = get_term_width() - 2;
2252		int len_event   = strlen(event);
2253		int len_str, max_len, cut = 0;
2254
2255		/*
2256		 * Maximum error index indent, we will cut
2257		 * the event string if it's bigger.
2258		 */
2259		int max_err_idx = 13;
2260
2261		/*
2262		 * Let's be specific with the message when
2263		 * we have the precise error.
2264		 */
2265		str     = "event syntax error: ";
2266		len_str = strlen(str);
2267		max_len = width - len_str;
2268
2269		buf = _buf;
2270
2271		/* We're cutting from the beginning. */
2272		if (err_idx > max_err_idx)
2273			cut = err_idx - max_err_idx;
2274
2275		strncpy(buf, event + cut, max_len);
2276
2277		/* Mark cut parts with '..' on both sides. */
2278		if (cut)
2279			buf[0] = buf[1] = '.';
2280
2281		if ((len_event - cut) > max_len) {
2282			buf[max_len - 1] = buf[max_len - 2] = '.';
2283			buf[max_len] = 0;
2284		}
2285
2286		idx = len_str + err_idx - cut;
2287	}
2288
2289	fprintf(stderr, "%s'%s'\n", str, buf);
2290	if (idx) {
2291		fprintf(stderr, "%*s\\___ %s\n", idx + 1, "", err_str);
2292		if (err_help)
2293			fprintf(stderr, "\n%s\n", err_help);
2294	}
2295}
2296
2297void parse_events_error__print(struct parse_events_error *err,
2298			       const char *event)
2299{
2300	if (!err->num_errors)
2301		return;
2302
2303	__parse_events_error__print(err->idx, err->str, err->help, event);
 
 
2304
2305	if (err->num_errors > 1) {
2306		fputs("\nInitial error:\n", stderr);
2307		__parse_events_error__print(err->first_idx, err->first_str,
2308					err->first_help, event);
 
 
2309	}
2310}
2311
2312#undef MAX_WIDTH
2313
2314int parse_events_option(const struct option *opt, const char *str,
2315			int unset __maybe_unused)
2316{
2317	struct parse_events_option_args *args = opt->value;
2318	struct parse_events_error err;
2319	int ret;
2320
2321	parse_events_error__init(&err);
2322	ret = __parse_events(*args->evlistp, str, args->pmu_filter, &err,
2323			     /*fake_pmu=*/NULL, /*warn_if_reordered=*/true);
2324
2325	if (ret) {
2326		parse_events_error__print(&err, str);
2327		fprintf(stderr, "Run 'perf list' for a list of valid events\n");
2328	}
2329	parse_events_error__exit(&err);
2330
2331	return ret;
2332}
2333
2334int parse_events_option_new_evlist(const struct option *opt, const char *str, int unset)
2335{
2336	struct parse_events_option_args *args = opt->value;
2337	int ret;
2338
2339	if (*args->evlistp == NULL) {
2340		*args->evlistp = evlist__new();
2341
2342		if (*args->evlistp == NULL) {
2343			fprintf(stderr, "Not enough memory to create evlist\n");
2344			return -1;
2345		}
2346	}
 
2347	ret = parse_events_option(opt, str, unset);
2348	if (ret) {
2349		evlist__delete(*args->evlistp);
2350		*args->evlistp = NULL;
2351	}
2352
2353	return ret;
2354}
2355
2356static int
2357foreach_evsel_in_last_glob(struct evlist *evlist,
2358			   int (*func)(struct evsel *evsel,
2359				       const void *arg),
2360			   const void *arg)
2361{
2362	struct evsel *last = NULL;
2363	int err;
2364
2365	/*
2366	 * Don't return when list_empty, give func a chance to report
2367	 * error when it found last == NULL.
2368	 *
2369	 * So no need to WARN here, let *func do this.
2370	 */
2371	if (evlist->core.nr_entries > 0)
2372		last = evlist__last(evlist);
2373
2374	do {
2375		err = (*func)(last, arg);
2376		if (err)
2377			return -1;
2378		if (!last)
2379			return 0;
2380
2381		if (last->core.node.prev == &evlist->core.entries)
2382			return 0;
2383		last = list_entry(last->core.node.prev, struct evsel, core.node);
2384	} while (!last->cmdline_group_boundary);
2385
2386	return 0;
2387}
2388
2389static int set_filter(struct evsel *evsel, const void *arg)
2390{
2391	const char *str = arg;
2392	bool found = false;
2393	int nr_addr_filters = 0;
2394	struct perf_pmu *pmu = NULL;
2395
2396	if (evsel == NULL) {
2397		fprintf(stderr,
2398			"--filter option should follow a -e tracepoint or HW tracer option\n");
2399		return -1;
2400	}
2401
2402	if (evsel->core.attr.type == PERF_TYPE_TRACEPOINT) {
2403		if (evsel__append_tp_filter(evsel, str) < 0) {
2404			fprintf(stderr,
2405				"not enough memory to hold filter string\n");
2406			return -1;
2407		}
2408
2409		return 0;
2410	}
2411
2412	while ((pmu = perf_pmus__scan(pmu)) != NULL)
2413		if (pmu->type == evsel->core.attr.type) {
2414			found = true;
2415			break;
2416		}
2417
2418	if (found)
2419		perf_pmu__scan_file(pmu, "nr_addr_filters",
2420				    "%d", &nr_addr_filters);
2421
2422	if (!nr_addr_filters)
2423		return perf_bpf_filter__parse(&evsel->bpf_filters, str);
 
 
 
2424
2425	if (evsel__append_addr_filter(evsel, str) < 0) {
2426		fprintf(stderr,
2427			"not enough memory to hold filter string\n");
2428		return -1;
2429	}
2430
2431	return 0;
2432}
2433
2434int parse_filter(const struct option *opt, const char *str,
2435		 int unset __maybe_unused)
2436{
2437	struct evlist *evlist = *(struct evlist **)opt->value;
2438
2439	return foreach_evsel_in_last_glob(evlist, set_filter,
2440					  (const void *)str);
2441}
2442
2443static int add_exclude_perf_filter(struct evsel *evsel,
2444				   const void *arg __maybe_unused)
2445{
2446	char new_filter[64];
2447
2448	if (evsel == NULL || evsel->core.attr.type != PERF_TYPE_TRACEPOINT) {
2449		fprintf(stderr,
2450			"--exclude-perf option should follow a -e tracepoint option\n");
2451		return -1;
2452	}
2453
2454	snprintf(new_filter, sizeof(new_filter), "common_pid != %d", getpid());
2455
2456	if (evsel__append_tp_filter(evsel, new_filter) < 0) {
2457		fprintf(stderr,
2458			"not enough memory to hold filter string\n");
2459		return -1;
2460	}
2461
2462	return 0;
2463}
2464
2465int exclude_perf(const struct option *opt,
2466		 const char *arg __maybe_unused,
2467		 int unset __maybe_unused)
2468{
2469	struct evlist *evlist = *(struct evlist **)opt->value;
2470
2471	return foreach_evsel_in_last_glob(evlist, add_exclude_perf_filter,
2472					  NULL);
2473}
2474
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2475int parse_events__is_hardcoded_term(struct parse_events_term *term)
2476{
2477	return term->type_term != PARSE_EVENTS__TERM_TYPE_USER;
2478}
2479
2480static int new_term(struct parse_events_term **_term,
2481		    struct parse_events_term *temp,
2482		    char *str, u64 num)
2483{
2484	struct parse_events_term *term;
2485
2486	term = malloc(sizeof(*term));
2487	if (!term)
2488		return -ENOMEM;
2489
2490	*term = *temp;
2491	INIT_LIST_HEAD(&term->list);
2492	term->weak = false;
2493
2494	switch (term->type_val) {
2495	case PARSE_EVENTS__TERM_TYPE_NUM:
2496		term->val.num = num;
2497		break;
2498	case PARSE_EVENTS__TERM_TYPE_STR:
2499		term->val.str = str;
2500		break;
2501	default:
2502		free(term);
2503		return -EINVAL;
2504	}
2505
2506	*_term = term;
2507	return 0;
2508}
2509
2510int parse_events_term__num(struct parse_events_term **term,
2511			   enum parse_events__term_type type_term,
2512			   const char *config, u64 num,
2513			   bool no_value,
2514			   void *loc_term_, void *loc_val_)
2515{
2516	YYLTYPE *loc_term = loc_term_;
2517	YYLTYPE *loc_val = loc_val_;
2518
2519	struct parse_events_term temp = {
2520		.type_val  = PARSE_EVENTS__TERM_TYPE_NUM,
2521		.type_term = type_term,
2522		.config    = config ? : strdup(config_term_name(type_term)),
2523		.no_value  = no_value,
2524		.err_term  = loc_term ? loc_term->first_column : 0,
2525		.err_val   = loc_val  ? loc_val->first_column  : 0,
2526	};
2527
2528	return new_term(term, &temp, /*str=*/NULL, num);
2529}
2530
2531int parse_events_term__str(struct parse_events_term **term,
2532			   enum parse_events__term_type type_term,
2533			   char *config, char *str,
2534			   void *loc_term_, void *loc_val_)
2535{
2536	YYLTYPE *loc_term = loc_term_;
2537	YYLTYPE *loc_val = loc_val_;
2538
2539	struct parse_events_term temp = {
2540		.type_val  = PARSE_EVENTS__TERM_TYPE_STR,
2541		.type_term = type_term,
2542		.config    = config,
2543		.err_term  = loc_term ? loc_term->first_column : 0,
2544		.err_val   = loc_val  ? loc_val->first_column  : 0,
2545	};
2546
2547	return new_term(term, &temp, str, /*num=*/0);
2548}
2549
2550int parse_events_term__term(struct parse_events_term **term,
2551			    enum parse_events__term_type term_lhs,
2552			    enum parse_events__term_type term_rhs,
2553			    void *loc_term, void *loc_val)
2554{
2555	return parse_events_term__str(term, term_lhs, NULL,
2556				      strdup(config_term_name(term_rhs)),
2557				      loc_term, loc_val);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2558}
2559
2560int parse_events_term__clone(struct parse_events_term **new,
2561			     struct parse_events_term *term)
2562{
2563	char *str;
2564	struct parse_events_term temp = *term;
 
 
 
 
 
 
2565
2566	temp.used = false;
2567	if (term->config) {
2568		temp.config = strdup(term->config);
2569		if (!temp.config)
2570			return -ENOMEM;
2571	}
2572	if (term->type_val == PARSE_EVENTS__TERM_TYPE_NUM)
2573		return new_term(new, &temp, /*str=*/NULL, term->val.num);
2574
2575	str = strdup(term->val.str);
2576	if (!str) {
2577		zfree(&temp.config);
2578		return -ENOMEM;
2579	}
2580	return new_term(new, &temp, str, /*num=*/0);
2581}
2582
2583void parse_events_term__delete(struct parse_events_term *term)
2584{
 
 
 
2585	if (term->type_val != PARSE_EVENTS__TERM_TYPE_NUM)
2586		zfree(&term->val.str);
2587
2588	zfree(&term->config);
2589	free(term);
2590}
2591
2592static int parse_events_terms__copy(const struct parse_events_terms *src,
2593				    struct parse_events_terms *dest)
2594{
2595	struct parse_events_term *term;
 
2596
2597	list_for_each_entry (term, &src->terms, list) {
2598		struct parse_events_term *n;
2599		int ret;
 
2600
 
 
 
 
 
 
2601		ret = parse_events_term__clone(&n, term);
2602		if (ret)
2603			return ret;
2604
2605		list_add_tail(&n->list, &dest->terms);
2606	}
2607	return 0;
2608}
2609
2610void parse_events_terms__init(struct parse_events_terms *terms)
2611{
2612	INIT_LIST_HEAD(&terms->terms);
2613}
2614
2615void parse_events_terms__exit(struct parse_events_terms *terms)
2616{
2617	struct parse_events_term *term, *h;
2618
2619	list_for_each_entry_safe(term, h, &terms->terms, list) {
2620		list_del_init(&term->list);
2621		parse_events_term__delete(term);
2622	}
2623}
2624
2625void parse_events_terms__delete(struct parse_events_terms *terms)
2626{
2627	if (!terms)
2628		return;
2629	parse_events_terms__exit(terms);
2630	free(terms);
2631}
2632
2633int parse_events_terms__to_strbuf(const struct parse_events_terms *terms, struct strbuf *sb)
2634{
2635	struct parse_events_term *term;
2636	bool first = true;
2637
2638	if (!terms)
2639		return 0;
2640
2641	list_for_each_entry(term, &terms->terms, list) {
2642		int ret;
2643
2644		if (!first) {
2645			ret = strbuf_addch(sb, ',');
2646			if (ret < 0)
2647				return ret;
2648		}
2649		first = false;
2650
2651		if (term->type_val == PARSE_EVENTS__TERM_TYPE_NUM)
2652			if (term->no_value) {
2653				assert(term->val.num == 1);
2654				ret = strbuf_addf(sb, "%s", term->config);
2655			} else
2656				ret = strbuf_addf(sb, "%s=%#"PRIx64, term->config, term->val.num);
2657		else if (term->type_val == PARSE_EVENTS__TERM_TYPE_STR) {
2658			if (term->config) {
2659				ret = strbuf_addf(sb, "%s=", term->config);
2660				if (ret < 0)
2661					return ret;
2662			} else if ((unsigned int)term->type_term < __PARSE_EVENTS__TERM_TYPE_NR) {
2663				ret = strbuf_addf(sb, "%s=", config_term_name(term->type_term));
2664				if (ret < 0)
2665					return ret;
2666			}
2667			assert(!term->no_value);
2668			ret = strbuf_addf(sb, "%s", term->val.str);
2669		}
2670		if (ret < 0)
2671			return ret;
2672	}
2673	return 0;
2674}
2675
2676void parse_events_evlist_error(struct parse_events_state *parse_state,
2677			       int idx, const char *str)
2678{
2679	if (!parse_state->error)
2680		return;
2681
2682	parse_events_error__handle(parse_state->error, idx, strdup(str), NULL);
2683}
2684
2685static void config_terms_list(char *buf, size_t buf_sz)
2686{
2687	int i;
2688	bool first = true;
2689
2690	buf[0] = '\0';
2691	for (i = 0; i < __PARSE_EVENTS__TERM_TYPE_NR; i++) {
2692		const char *name = config_term_name(i);
2693
2694		if (!config_term_avail(i, NULL))
2695			continue;
2696		if (!name)
2697			continue;
2698		if (name[0] == '<')
2699			continue;
2700
2701		if (strlen(buf) + strlen(name) + 2 >= buf_sz)
2702			return;
2703
2704		if (!first)
2705			strcat(buf, ",");
2706		else
2707			first = false;
2708		strcat(buf, name);
2709	}
2710}
2711
2712/*
2713 * Return string contains valid config terms of an event.
2714 * @additional_terms: For terms such as PMU sysfs terms.
2715 */
2716char *parse_events_formats_error_string(char *additional_terms)
2717{
2718	char *str;
2719	/* "no-overwrite" is the longest name */
2720	char static_terms[__PARSE_EVENTS__TERM_TYPE_NR *
2721			  (sizeof("no-overwrite") - 1)];
2722
2723	config_terms_list(static_terms, sizeof(static_terms));
2724	/* valid terms */
2725	if (additional_terms) {
2726		if (asprintf(&str, "valid terms: %s,%s",
2727			     additional_terms, static_terms) < 0)
2728			goto fail;
2729	} else {
2730		if (asprintf(&str, "valid terms: %s", static_terms) < 0)
2731			goto fail;
2732	}
2733	return str;
2734
2735fail:
2736	return NULL;
2737}
v5.9
   1// SPDX-License-Identifier: GPL-2.0
   2#include <linux/hw_breakpoint.h>
   3#include <linux/err.h>
 
   4#include <linux/zalloc.h>
   5#include <dirent.h>
   6#include <errno.h>
   7#include <sys/ioctl.h>
   8#include <sys/types.h>
   9#include <sys/stat.h>
  10#include <fcntl.h>
  11#include <sys/param.h>
  12#include "term.h"
  13#include "build-id.h"
  14#include "evlist.h"
  15#include "evsel.h"
  16#include <subcmd/pager.h>
  17#include <subcmd/parse-options.h>
  18#include "parse-events.h"
  19#include <subcmd/exec-cmd.h>
  20#include "string2.h"
  21#include "strlist.h"
  22#include "symbol.h"
  23#include "header.h"
  24#include "bpf-loader.h"
  25#include "debug.h"
  26#include <api/fs/tracing_path.h>
  27#include <perf/cpumap.h>
  28#include "parse-events-bison.h"
  29#define YY_EXTRA_TYPE void*
  30#include "parse-events-flex.h"
  31#include "pmu.h"
  32#include "thread_map.h"
  33#include "probe-file.h"
  34#include "asm/bug.h"
  35#include "util/parse-branch-options.h"
  36#include "metricgroup.h"
  37#include "util/evsel_config.h"
  38#include "util/event.h"
  39#include "util/pfm.h"
  40#include "perf.h"
 
  41
  42#define MAX_NAME_LEN 100
  43
  44#ifdef PARSER_DEBUG
  45extern int parse_events_debug;
  46#endif
  47int parse_events_parse(void *parse_state, void *scanner);
  48static int get_config_terms(struct list_head *head_config,
  49			    struct list_head *head_terms __maybe_unused);
  50
  51static struct perf_pmu_event_symbol *perf_pmu_events_list;
  52/*
  53 * The variable indicates the number of supported pmu event symbols.
  54 * 0 means not initialized and ready to init
  55 * -1 means failed to init, don't try anymore
  56 * >0 is the number of supported pmu event symbols
  57 */
  58static int perf_pmu_events_list_num;
  59
  60struct event_symbol event_symbols_hw[PERF_COUNT_HW_MAX] = {
  61	[PERF_COUNT_HW_CPU_CYCLES] = {
  62		.symbol = "cpu-cycles",
  63		.alias  = "cycles",
  64	},
  65	[PERF_COUNT_HW_INSTRUCTIONS] = {
  66		.symbol = "instructions",
  67		.alias  = "",
  68	},
  69	[PERF_COUNT_HW_CACHE_REFERENCES] = {
  70		.symbol = "cache-references",
  71		.alias  = "",
  72	},
  73	[PERF_COUNT_HW_CACHE_MISSES] = {
  74		.symbol = "cache-misses",
  75		.alias  = "",
  76	},
  77	[PERF_COUNT_HW_BRANCH_INSTRUCTIONS] = {
  78		.symbol = "branch-instructions",
  79		.alias  = "branches",
  80	},
  81	[PERF_COUNT_HW_BRANCH_MISSES] = {
  82		.symbol = "branch-misses",
  83		.alias  = "",
  84	},
  85	[PERF_COUNT_HW_BUS_CYCLES] = {
  86		.symbol = "bus-cycles",
  87		.alias  = "",
  88	},
  89	[PERF_COUNT_HW_STALLED_CYCLES_FRONTEND] = {
  90		.symbol = "stalled-cycles-frontend",
  91		.alias  = "idle-cycles-frontend",
  92	},
  93	[PERF_COUNT_HW_STALLED_CYCLES_BACKEND] = {
  94		.symbol = "stalled-cycles-backend",
  95		.alias  = "idle-cycles-backend",
  96	},
  97	[PERF_COUNT_HW_REF_CPU_CYCLES] = {
  98		.symbol = "ref-cycles",
  99		.alias  = "",
 100	},
 101};
 102
 103struct event_symbol event_symbols_sw[PERF_COUNT_SW_MAX] = {
 104	[PERF_COUNT_SW_CPU_CLOCK] = {
 105		.symbol = "cpu-clock",
 106		.alias  = "",
 107	},
 108	[PERF_COUNT_SW_TASK_CLOCK] = {
 109		.symbol = "task-clock",
 110		.alias  = "",
 111	},
 112	[PERF_COUNT_SW_PAGE_FAULTS] = {
 113		.symbol = "page-faults",
 114		.alias  = "faults",
 115	},
 116	[PERF_COUNT_SW_CONTEXT_SWITCHES] = {
 117		.symbol = "context-switches",
 118		.alias  = "cs",
 119	},
 120	[PERF_COUNT_SW_CPU_MIGRATIONS] = {
 121		.symbol = "cpu-migrations",
 122		.alias  = "migrations",
 123	},
 124	[PERF_COUNT_SW_PAGE_FAULTS_MIN] = {
 125		.symbol = "minor-faults",
 126		.alias  = "",
 127	},
 128	[PERF_COUNT_SW_PAGE_FAULTS_MAJ] = {
 129		.symbol = "major-faults",
 130		.alias  = "",
 131	},
 132	[PERF_COUNT_SW_ALIGNMENT_FAULTS] = {
 133		.symbol = "alignment-faults",
 134		.alias  = "",
 135	},
 136	[PERF_COUNT_SW_EMULATION_FAULTS] = {
 137		.symbol = "emulation-faults",
 138		.alias  = "",
 139	},
 140	[PERF_COUNT_SW_DUMMY] = {
 141		.symbol = "dummy",
 142		.alias  = "",
 143	},
 144	[PERF_COUNT_SW_BPF_OUTPUT] = {
 145		.symbol = "bpf-output",
 146		.alias  = "",
 147	},
 
 
 
 
 148};
 149
 150#define __PERF_EVENT_FIELD(config, name) \
 151	((config & PERF_EVENT_##name##_MASK) >> PERF_EVENT_##name##_SHIFT)
 152
 153#define PERF_EVENT_RAW(config)		__PERF_EVENT_FIELD(config, RAW)
 154#define PERF_EVENT_CONFIG(config)	__PERF_EVENT_FIELD(config, CONFIG)
 155#define PERF_EVENT_TYPE(config)		__PERF_EVENT_FIELD(config, TYPE)
 156#define PERF_EVENT_ID(config)		__PERF_EVENT_FIELD(config, EVENT)
 157
 158#define for_each_subsystem(sys_dir, sys_dirent)			\
 159	while ((sys_dirent = readdir(sys_dir)) != NULL)		\
 160		if (sys_dirent->d_type == DT_DIR &&		\
 161		    (strcmp(sys_dirent->d_name, ".")) &&	\
 162		    (strcmp(sys_dirent->d_name, "..")))
 163
 164static int tp_event_has_id(const char *dir_path, struct dirent *evt_dir)
 165{
 166	char evt_path[MAXPATHLEN];
 167	int fd;
 168
 169	snprintf(evt_path, MAXPATHLEN, "%s/%s/id", dir_path, evt_dir->d_name);
 170	fd = open(evt_path, O_RDONLY);
 171	if (fd < 0)
 172		return -EINVAL;
 173	close(fd);
 174
 175	return 0;
 176}
 177
 178#define for_each_event(dir_path, evt_dir, evt_dirent)		\
 179	while ((evt_dirent = readdir(evt_dir)) != NULL)		\
 180		if (evt_dirent->d_type == DT_DIR &&		\
 181		    (strcmp(evt_dirent->d_name, ".")) &&	\
 182		    (strcmp(evt_dirent->d_name, "..")) &&	\
 183		    (!tp_event_has_id(dir_path, evt_dirent)))
 184
 185#define MAX_EVENT_LENGTH 512
 186
 187void parse_events__handle_error(struct parse_events_error *err, int idx,
 188				char *str, char *help)
 189{
 190	if (WARN(!str, "WARNING: failed to provide error string\n")) {
 191		free(help);
 192		return;
 193	}
 194	switch (err->num_errors) {
 195	case 0:
 196		err->idx = idx;
 197		err->str = str;
 198		err->help = help;
 199		break;
 200	case 1:
 201		err->first_idx = err->idx;
 202		err->idx = idx;
 203		err->first_str = err->str;
 204		err->str = str;
 205		err->first_help = err->help;
 206		err->help = help;
 207		break;
 208	default:
 209		pr_debug("Multiple errors dropping message: %s (%s)\n",
 210			err->str, err->help);
 211		free(err->str);
 212		err->str = str;
 213		free(err->help);
 214		err->help = help;
 215		break;
 216	}
 217	err->num_errors++;
 218}
 219
 220struct tracepoint_path *tracepoint_id_to_path(u64 config)
 221{
 222	struct tracepoint_path *path = NULL;
 223	DIR *sys_dir, *evt_dir;
 224	struct dirent *sys_dirent, *evt_dirent;
 225	char id_buf[24];
 226	int fd;
 227	u64 id;
 228	char evt_path[MAXPATHLEN];
 229	char *dir_path;
 230
 231	sys_dir = tracing_events__opendir();
 232	if (!sys_dir)
 233		return NULL;
 234
 235	for_each_subsystem(sys_dir, sys_dirent) {
 236		dir_path = get_events_file(sys_dirent->d_name);
 237		if (!dir_path)
 238			continue;
 239		evt_dir = opendir(dir_path);
 240		if (!evt_dir)
 241			goto next;
 242
 243		for_each_event(dir_path, evt_dir, evt_dirent) {
 244
 245			scnprintf(evt_path, MAXPATHLEN, "%s/%s/id", dir_path,
 246				  evt_dirent->d_name);
 247			fd = open(evt_path, O_RDONLY);
 248			if (fd < 0)
 249				continue;
 250			if (read(fd, id_buf, sizeof(id_buf)) < 0) {
 251				close(fd);
 252				continue;
 253			}
 254			close(fd);
 255			id = atoll(id_buf);
 256			if (id == config) {
 257				put_events_file(dir_path);
 258				closedir(evt_dir);
 259				closedir(sys_dir);
 260				path = zalloc(sizeof(*path));
 261				if (!path)
 262					return NULL;
 263				if (asprintf(&path->system, "%.*s", MAX_EVENT_LENGTH, sys_dirent->d_name) < 0) {
 264					free(path);
 265					return NULL;
 266				}
 267				if (asprintf(&path->name, "%.*s", MAX_EVENT_LENGTH, evt_dirent->d_name) < 0) {
 268					zfree(&path->system);
 269					free(path);
 270					return NULL;
 271				}
 272				return path;
 273			}
 274		}
 275		closedir(evt_dir);
 276next:
 277		put_events_file(dir_path);
 278	}
 279
 280	closedir(sys_dir);
 281	return NULL;
 282}
 283
 284struct tracepoint_path *tracepoint_name_to_path(const char *name)
 285{
 286	struct tracepoint_path *path = zalloc(sizeof(*path));
 287	char *str = strchr(name, ':');
 288
 289	if (path == NULL || str == NULL) {
 290		free(path);
 291		return NULL;
 292	}
 293
 294	path->system = strndup(name, str - name);
 295	path->name = strdup(str+1);
 296
 297	if (path->system == NULL || path->name == NULL) {
 298		zfree(&path->system);
 299		zfree(&path->name);
 300		zfree(&path);
 301	}
 302
 303	return path;
 304}
 305
 306const char *event_type(int type)
 307{
 308	switch (type) {
 309	case PERF_TYPE_HARDWARE:
 310		return "hardware";
 311
 312	case PERF_TYPE_SOFTWARE:
 313		return "software";
 314
 315	case PERF_TYPE_TRACEPOINT:
 316		return "tracepoint";
 317
 318	case PERF_TYPE_HW_CACHE:
 319		return "hardware-cache";
 320
 321	default:
 322		break;
 323	}
 324
 325	return "unknown";
 326}
 327
 328static int parse_events__is_name_term(struct parse_events_term *term)
 329{
 330	return term->type_term == PARSE_EVENTS__TERM_TYPE_NAME;
 331}
 332
 333static char *get_config_name(struct list_head *head_terms)
 334{
 335	struct parse_events_term *term;
 336
 337	if (!head_terms)
 338		return NULL;
 339
 340	list_for_each_entry(term, head_terms, list)
 341		if (parse_events__is_name_term(term))
 342			return term->val.str;
 343
 344	return NULL;
 345}
 346
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 347static struct evsel *
 348__add_event(struct list_head *list, int *idx,
 349	    struct perf_event_attr *attr,
 350	    bool init_attr,
 351	    char *name, struct perf_pmu *pmu,
 352	    struct list_head *config_terms, bool auto_merge_stats,
 353	    const char *cpu_list)
 354{
 355	struct evsel *evsel;
 356	struct perf_cpu_map *cpus = pmu ? pmu->cpus :
 357			       cpu_list ? perf_cpu_map__new(cpu_list) : NULL;
 358
 
 
 
 
 
 
 
 
 
 
 
 
 
 359	if (init_attr)
 360		event_attr_init(attr);
 361
 362	evsel = evsel__new_idx(attr, *idx);
 363	if (!evsel)
 
 364		return NULL;
 
 365
 366	(*idx)++;
 367	evsel->core.cpus   = perf_cpu_map__get(cpus);
 368	evsel->core.own_cpus = perf_cpu_map__get(cpus);
 369	evsel->core.system_wide = pmu ? pmu->is_uncore : false;
 
 370	evsel->auto_merge_stats = auto_merge_stats;
 
 
 371
 372	if (name)
 373		evsel->name = strdup(name);
 374
 
 
 
 375	if (config_terms)
 376		list_splice(config_terms, &evsel->config_terms);
 377
 378	if (list)
 379		list_add_tail(&evsel->core.node, list);
 380
 381	return evsel;
 382}
 383
 384struct evsel *parse_events__add_event(int idx, struct perf_event_attr *attr,
 385					char *name, struct perf_pmu *pmu)
 
 386{
 387	return __add_event(NULL, &idx, attr, false, name, pmu, NULL, false,
 388			   NULL);
 
 389}
 390
 391static int add_event(struct list_head *list, int *idx,
 392		     struct perf_event_attr *attr, char *name,
 393		     struct list_head *config_terms)
 394{
 395	return __add_event(list, idx, attr, true, name, NULL, config_terms,
 396			   false, NULL) ? 0 : -ENOMEM;
 
 397}
 398
 399static int add_event_tool(struct list_head *list, int *idx,
 400			  enum perf_tool_event tool_event)
 401{
 402	struct evsel *evsel;
 403	struct perf_event_attr attr = {
 404		.type = PERF_TYPE_SOFTWARE,
 405		.config = PERF_COUNT_SW_DUMMY,
 406	};
 407
 408	evsel = __add_event(list, idx, &attr, true, NULL, NULL, NULL, false,
 409			    "0");
 
 
 410	if (!evsel)
 411		return -ENOMEM;
 412	evsel->tool_event = tool_event;
 413	if (tool_event == PERF_TOOL_DURATION_TIME)
 414		evsel->unit = "ns";
 
 
 
 
 415	return 0;
 416}
 417
 418static int parse_aliases(char *str, const char *names[][EVSEL__MAX_ALIASES], int size)
 
 
 
 
 
 
 
 
 
 
 419{
 420	int i, j;
 421	int n, longest = -1;
 
 
 422
 423	for (i = 0; i < size; i++) {
 424		for (j = 0; j < EVSEL__MAX_ALIASES && names[i][j]; j++) {
 425			n = strlen(names[i][j]);
 426			if (n > longest && !strncasecmp(str, names[i][j], n))
 427				longest = n;
 428		}
 429		if (longest > 0)
 430			return i;
 431	}
 432
 433	return -1;
 434}
 435
 436typedef int config_term_func_t(struct perf_event_attr *attr,
 437			       struct parse_events_term *term,
 438			       struct parse_events_error *err);
 439static int config_term_common(struct perf_event_attr *attr,
 440			      struct parse_events_term *term,
 441			      struct parse_events_error *err);
 442static int config_attr(struct perf_event_attr *attr,
 443		       struct list_head *head,
 444		       struct parse_events_error *err,
 445		       config_term_func_t config_term);
 446
 447int parse_events_add_cache(struct list_head *list, int *idx,
 448			   char *type, char *op_result1, char *op_result2,
 449			   struct parse_events_error *err,
 450			   struct list_head *head_config)
 
 
 
 
 
 
 
 451{
 452	struct perf_event_attr attr;
 453	LIST_HEAD(config_terms);
 454	char name[MAX_NAME_LEN], *config_name;
 455	int cache_type = -1, cache_op = -1, cache_result = -1;
 456	char *op_result[2] = { op_result1, op_result2 };
 457	int i, n;
 458
 459	/*
 460	 * No fallback - if we cannot get a clear cache type
 461	 * then bail out:
 462	 */
 463	cache_type = parse_aliases(type, evsel__hw_cache, PERF_COUNT_HW_CACHE_MAX);
 464	if (cache_type == -1)
 465		return -EINVAL;
 
 466
 467	config_name = get_config_name(head_config);
 468	n = snprintf(name, MAX_NAME_LEN, "%s", type);
 469
 470	for (i = 0; (i < 2) && (op_result[i]); i++) {
 471		char *str = op_result[i];
 472
 473		n += snprintf(name + n, MAX_NAME_LEN - n, "-%s", str);
 474
 475		if (cache_op == -1) {
 
 
 
 
 
 
 
 476			cache_op = parse_aliases(str, evsel__hw_cache_op,
 477						 PERF_COUNT_HW_CACHE_OP_MAX);
 478			if (cache_op >= 0) {
 479				if (!evsel__is_cache_op_valid(cache_type, cache_op))
 480					return -EINVAL;
 481				continue;
 482			}
 483		}
 484
 485		if (cache_result == -1) {
 486			cache_result = parse_aliases(str, evsel__hw_cache_result,
 487						     PERF_COUNT_HW_CACHE_RESULT_MAX);
 488			if (cache_result >= 0)
 489				continue;
 490		}
 491	}
 492
 493	/*
 494	 * Fall back to reads:
 495	 */
 496	if (cache_op == -1)
 497		cache_op = PERF_COUNT_HW_CACHE_OP_READ;
 498
 499	/*
 500	 * Fall back to accesses:
 501	 */
 502	if (cache_result == -1)
 503		cache_result = PERF_COUNT_HW_CACHE_RESULT_ACCESS;
 504
 505	memset(&attr, 0, sizeof(attr));
 506	attr.config = cache_type | (cache_op << 8) | (cache_result << 16);
 507	attr.type = PERF_TYPE_HW_CACHE;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 508
 509	if (head_config) {
 510		if (config_attr(&attr, head_config, err,
 511				config_term_common))
 512			return -EINVAL;
 513
 514		if (get_config_terms(head_config, &config_terms))
 
 
 515			return -ENOMEM;
 
 
 516	}
 517	return add_event(list, idx, &attr, config_name ? : name, &config_terms);
 518}
 519
 
 520static void tracepoint_error(struct parse_events_error *e, int err,
 521			     const char *sys, const char *name)
 522{
 523	const char *str;
 524	char help[BUFSIZ];
 525
 526	if (!e)
 527		return;
 528
 529	/*
 530	 * We get error directly from syscall errno ( > 0),
 531	 * or from encoded pointer's error ( < 0).
 532	 */
 533	err = abs(err);
 534
 535	switch (err) {
 536	case EACCES:
 537		str = "can't access trace events";
 538		break;
 539	case ENOENT:
 540		str = "unknown tracepoint";
 541		break;
 542	default:
 543		str = "failed to add tracepoint";
 544		break;
 545	}
 546
 547	tracing_path__strerror_open_tp(err, help, sizeof(help), sys, name);
 548	parse_events__handle_error(e, 0, strdup(str), strdup(help));
 549}
 550
 551static int add_tracepoint(struct list_head *list, int *idx,
 552			  const char *sys_name, const char *evt_name,
 553			  struct parse_events_error *err,
 554			  struct list_head *head_config)
 555{
 
 556	struct evsel *evsel = evsel__newtp_idx(sys_name, evt_name, (*idx)++);
 557
 558	if (IS_ERR(evsel)) {
 559		tracepoint_error(err, PTR_ERR(evsel), sys_name, evt_name);
 560		return PTR_ERR(evsel);
 561	}
 562
 563	if (head_config) {
 564		LIST_HEAD(config_terms);
 565
 566		if (get_config_terms(head_config, &config_terms))
 567			return -ENOMEM;
 568		list_splice(&config_terms, &evsel->config_terms);
 569	}
 570
 571	list_add_tail(&evsel->core.node, list);
 572	return 0;
 573}
 574
 575static int add_tracepoint_multi_event(struct list_head *list, int *idx,
 576				      const char *sys_name, const char *evt_name,
 577				      struct parse_events_error *err,
 578				      struct list_head *head_config)
 579{
 580	char *evt_path;
 581	struct dirent *evt_ent;
 582	DIR *evt_dir;
 583	int ret = 0, found = 0;
 584
 585	evt_path = get_events_file(sys_name);
 586	if (!evt_path) {
 587		tracepoint_error(err, errno, sys_name, evt_name);
 588		return -1;
 589	}
 590	evt_dir = opendir(evt_path);
 591	if (!evt_dir) {
 592		put_events_file(evt_path);
 593		tracepoint_error(err, errno, sys_name, evt_name);
 594		return -1;
 595	}
 596
 597	while (!ret && (evt_ent = readdir(evt_dir))) {
 598		if (!strcmp(evt_ent->d_name, ".")
 599		    || !strcmp(evt_ent->d_name, "..")
 600		    || !strcmp(evt_ent->d_name, "enable")
 601		    || !strcmp(evt_ent->d_name, "filter"))
 602			continue;
 603
 604		if (!strglobmatch(evt_ent->d_name, evt_name))
 605			continue;
 606
 607		found++;
 608
 609		ret = add_tracepoint(list, idx, sys_name, evt_ent->d_name,
 610				     err, head_config);
 611	}
 612
 613	if (!found) {
 614		tracepoint_error(err, ENOENT, sys_name, evt_name);
 615		ret = -1;
 616	}
 617
 618	put_events_file(evt_path);
 619	closedir(evt_dir);
 620	return ret;
 621}
 622
 623static int add_tracepoint_event(struct list_head *list, int *idx,
 624				const char *sys_name, const char *evt_name,
 625				struct parse_events_error *err,
 626				struct list_head *head_config)
 627{
 628	return strpbrk(evt_name, "*?") ?
 629	       add_tracepoint_multi_event(list, idx, sys_name, evt_name,
 630					  err, head_config) :
 631	       add_tracepoint(list, idx, sys_name, evt_name,
 632			      err, head_config);
 633}
 634
 635static int add_tracepoint_multi_sys(struct list_head *list, int *idx,
 636				    const char *sys_name, const char *evt_name,
 637				    struct parse_events_error *err,
 638				    struct list_head *head_config)
 639{
 640	struct dirent *events_ent;
 641	DIR *events_dir;
 642	int ret = 0;
 643
 644	events_dir = tracing_events__opendir();
 645	if (!events_dir) {
 646		tracepoint_error(err, errno, sys_name, evt_name);
 647		return -1;
 648	}
 649
 650	while (!ret && (events_ent = readdir(events_dir))) {
 651		if (!strcmp(events_ent->d_name, ".")
 652		    || !strcmp(events_ent->d_name, "..")
 653		    || !strcmp(events_ent->d_name, "enable")
 654		    || !strcmp(events_ent->d_name, "header_event")
 655		    || !strcmp(events_ent->d_name, "header_page"))
 656			continue;
 657
 658		if (!strglobmatch(events_ent->d_name, sys_name))
 659			continue;
 660
 661		ret = add_tracepoint_event(list, idx, events_ent->d_name,
 662					   evt_name, err, head_config);
 663	}
 664
 665	closedir(events_dir);
 666	return ret;
 667}
 668
 669struct __add_bpf_event_param {
 670	struct parse_events_state *parse_state;
 671	struct list_head *list;
 672	struct list_head *head_config;
 673};
 674
 675static int add_bpf_event(const char *group, const char *event, int fd, struct bpf_object *obj,
 676			 void *_param)
 677{
 678	LIST_HEAD(new_evsels);
 679	struct __add_bpf_event_param *param = _param;
 680	struct parse_events_state *parse_state = param->parse_state;
 681	struct list_head *list = param->list;
 682	struct evsel *pos;
 683	int err;
 684	/*
 685	 * Check if we should add the event, i.e. if it is a TP but starts with a '!',
 686	 * then don't add the tracepoint, this will be used for something else, like
 687	 * adding to a BPF_MAP_TYPE_PROG_ARRAY.
 688	 *
 689	 * See tools/perf/examples/bpf/augmented_raw_syscalls.c
 690	 */
 691	if (group[0] == '!')
 692		return 0;
 693
 694	pr_debug("add bpf event %s:%s and attach bpf program %d\n",
 695		 group, event, fd);
 696
 697	err = parse_events_add_tracepoint(&new_evsels, &parse_state->idx, group,
 698					  event, parse_state->error,
 699					  param->head_config);
 700	if (err) {
 701		struct evsel *evsel, *tmp;
 702
 703		pr_debug("Failed to add BPF event %s:%s\n",
 704			 group, event);
 705		list_for_each_entry_safe(evsel, tmp, &new_evsels, core.node) {
 706			list_del_init(&evsel->core.node);
 707			evsel__delete(evsel);
 708		}
 709		return err;
 710	}
 711	pr_debug("adding %s:%s\n", group, event);
 712
 713	list_for_each_entry(pos, &new_evsels, core.node) {
 714		pr_debug("adding %s:%s to %p\n",
 715			 group, event, pos);
 716		pos->bpf_fd = fd;
 717		pos->bpf_obj = obj;
 718	}
 719	list_splice(&new_evsels, list);
 720	return 0;
 721}
 722
 723int parse_events_load_bpf_obj(struct parse_events_state *parse_state,
 724			      struct list_head *list,
 725			      struct bpf_object *obj,
 726			      struct list_head *head_config)
 727{
 728	int err;
 729	char errbuf[BUFSIZ];
 730	struct __add_bpf_event_param param = {parse_state, list, head_config};
 731	static bool registered_unprobe_atexit = false;
 732
 733	if (IS_ERR(obj) || !obj) {
 734		snprintf(errbuf, sizeof(errbuf),
 735			 "Internal error: load bpf obj with NULL");
 736		err = -EINVAL;
 737		goto errout;
 738	}
 739
 740	/*
 741	 * Register atexit handler before calling bpf__probe() so
 742	 * bpf__probe() don't need to unprobe probe points its already
 743	 * created when failure.
 744	 */
 745	if (!registered_unprobe_atexit) {
 746		atexit(bpf__clear);
 747		registered_unprobe_atexit = true;
 748	}
 749
 750	err = bpf__probe(obj);
 751	if (err) {
 752		bpf__strerror_probe(obj, err, errbuf, sizeof(errbuf));
 753		goto errout;
 754	}
 755
 756	err = bpf__load(obj);
 757	if (err) {
 758		bpf__strerror_load(obj, err, errbuf, sizeof(errbuf));
 759		goto errout;
 760	}
 761
 762	err = bpf__foreach_event(obj, add_bpf_event, &param);
 763	if (err) {
 764		snprintf(errbuf, sizeof(errbuf),
 765			 "Attach events in BPF object failed");
 766		goto errout;
 767	}
 768
 769	return 0;
 770errout:
 771	parse_events__handle_error(parse_state->error, 0,
 772				strdup(errbuf), strdup("(add -v to see detail)"));
 773	return err;
 774}
 775
 776static int
 777parse_events_config_bpf(struct parse_events_state *parse_state,
 778			struct bpf_object *obj,
 779			struct list_head *head_config)
 780{
 781	struct parse_events_term *term;
 782	int error_pos;
 783
 784	if (!head_config || list_empty(head_config))
 785		return 0;
 786
 787	list_for_each_entry(term, head_config, list) {
 788		int err;
 789
 790		if (term->type_term != PARSE_EVENTS__TERM_TYPE_USER) {
 791			parse_events__handle_error(parse_state->error, term->err_term,
 792						strdup("Invalid config term for BPF object"),
 793						NULL);
 794			return -EINVAL;
 795		}
 796
 797		err = bpf__config_obj(obj, term, parse_state->evlist, &error_pos);
 798		if (err) {
 799			char errbuf[BUFSIZ];
 800			int idx;
 801
 802			bpf__strerror_config_obj(obj, term, parse_state->evlist,
 803						 &error_pos, err, errbuf,
 804						 sizeof(errbuf));
 805
 806			if (err == -BPF_LOADER_ERRNO__OBJCONF_MAP_VALUE)
 807				idx = term->err_val;
 808			else
 809				idx = term->err_term + error_pos;
 810
 811			parse_events__handle_error(parse_state->error, idx,
 812						strdup(errbuf),
 813						strdup(
 814"Hint:\tValid config terms:\n"
 815"     \tmap:[<arraymap>].value<indices>=[value]\n"
 816"     \tmap:[<eventmap>].event<indices>=[event]\n"
 817"\n"
 818"     \twhere <indices> is something like [0,3...5] or [all]\n"
 819"     \t(add -v to see detail)"));
 820			return err;
 821		}
 822	}
 823	return 0;
 824}
 825
 826/*
 827 * Split config terms:
 828 * perf record -e bpf.c/call-graph=fp,map:array.value[0]=1/ ...
 829 *  'call-graph=fp' is 'evt config', should be applied to each
 830 *  events in bpf.c.
 831 * 'map:array.value[0]=1' is 'obj config', should be processed
 832 * with parse_events_config_bpf.
 833 *
 834 * Move object config terms from the first list to obj_head_config.
 835 */
 836static void
 837split_bpf_config_terms(struct list_head *evt_head_config,
 838		       struct list_head *obj_head_config)
 839{
 840	struct parse_events_term *term, *temp;
 841
 842	/*
 843	 * Currectly, all possible user config term
 844	 * belong to bpf object. parse_events__is_hardcoded_term()
 845	 * happends to be a good flag.
 846	 *
 847	 * See parse_events_config_bpf() and
 848	 * config_term_tracepoint().
 849	 */
 850	list_for_each_entry_safe(term, temp, evt_head_config, list)
 851		if (!parse_events__is_hardcoded_term(term))
 852			list_move_tail(&term->list, obj_head_config);
 853}
 854
 855int parse_events_load_bpf(struct parse_events_state *parse_state,
 856			  struct list_head *list,
 857			  char *bpf_file_name,
 858			  bool source,
 859			  struct list_head *head_config)
 860{
 861	int err;
 862	struct bpf_object *obj;
 863	LIST_HEAD(obj_head_config);
 864
 865	if (head_config)
 866		split_bpf_config_terms(head_config, &obj_head_config);
 867
 868	obj = bpf__prepare_load(bpf_file_name, source);
 869	if (IS_ERR(obj)) {
 870		char errbuf[BUFSIZ];
 871
 872		err = PTR_ERR(obj);
 873
 874		if (err == -ENOTSUP)
 875			snprintf(errbuf, sizeof(errbuf),
 876				 "BPF support is not compiled");
 877		else
 878			bpf__strerror_prepare_load(bpf_file_name,
 879						   source,
 880						   -err, errbuf,
 881						   sizeof(errbuf));
 882
 883		parse_events__handle_error(parse_state->error, 0,
 884					strdup(errbuf), strdup("(add -v to see detail)"));
 885		return err;
 886	}
 887
 888	err = parse_events_load_bpf_obj(parse_state, list, obj, head_config);
 889	if (err)
 890		return err;
 891	err = parse_events_config_bpf(parse_state, obj, &obj_head_config);
 892
 893	/*
 894	 * Caller doesn't know anything about obj_head_config,
 895	 * so combine them together again before returnning.
 896	 */
 897	if (head_config)
 898		list_splice_tail(&obj_head_config, head_config);
 899	return err;
 900}
 901
 902static int
 903parse_breakpoint_type(const char *type, struct perf_event_attr *attr)
 904{
 905	int i;
 906
 907	for (i = 0; i < 3; i++) {
 908		if (!type || !type[i])
 909			break;
 910
 911#define CHECK_SET_TYPE(bit)		\
 912do {					\
 913	if (attr->bp_type & bit)	\
 914		return -EINVAL;		\
 915	else				\
 916		attr->bp_type |= bit;	\
 917} while (0)
 918
 919		switch (type[i]) {
 920		case 'r':
 921			CHECK_SET_TYPE(HW_BREAKPOINT_R);
 922			break;
 923		case 'w':
 924			CHECK_SET_TYPE(HW_BREAKPOINT_W);
 925			break;
 926		case 'x':
 927			CHECK_SET_TYPE(HW_BREAKPOINT_X);
 928			break;
 929		default:
 930			return -EINVAL;
 931		}
 932	}
 933
 934#undef CHECK_SET_TYPE
 935
 936	if (!attr->bp_type) /* Default */
 937		attr->bp_type = HW_BREAKPOINT_R | HW_BREAKPOINT_W;
 938
 939	return 0;
 940}
 941
 942int parse_events_add_breakpoint(struct list_head *list, int *idx,
 943				void *ptr, char *type, u64 len)
 
 
 944{
 945	struct perf_event_attr attr;
 
 
 946
 947	memset(&attr, 0, sizeof(attr));
 948	attr.bp_addr = (unsigned long) ptr;
 949
 950	if (parse_breakpoint_type(type, &attr))
 951		return -EINVAL;
 952
 953	/* Provide some defaults if len is not specified */
 954	if (!len) {
 955		if (attr.bp_type == HW_BREAKPOINT_X)
 956			len = sizeof(long);
 957		else
 958			len = HW_BREAKPOINT_LEN_4;
 959	}
 960
 961	attr.bp_len = len;
 962
 963	attr.type = PERF_TYPE_BREAKPOINT;
 964	attr.sample_period = 1;
 965
 966	return add_event(list, idx, &attr, NULL, NULL);
 
 
 
 
 
 
 
 
 
 
 
 
 967}
 968
 969static int check_type_val(struct parse_events_term *term,
 970			  struct parse_events_error *err,
 971			  int type)
 972{
 973	if (type == term->type_val)
 974		return 0;
 975
 976	if (err) {
 977		parse_events__handle_error(err, term->err_val,
 978					type == PARSE_EVENTS__TERM_TYPE_NUM
 979					? strdup("expected numeric value")
 980					: strdup("expected string value"),
 981					NULL);
 982	}
 983	return -EINVAL;
 984}
 985
 986/*
 987 * Update according to parse-events.l
 988 */
 989static const char *config_term_names[__PARSE_EVENTS__TERM_TYPE_NR] = {
 990	[PARSE_EVENTS__TERM_TYPE_USER]			= "<sysfs term>",
 991	[PARSE_EVENTS__TERM_TYPE_CONFIG]		= "config",
 992	[PARSE_EVENTS__TERM_TYPE_CONFIG1]		= "config1",
 993	[PARSE_EVENTS__TERM_TYPE_CONFIG2]		= "config2",
 994	[PARSE_EVENTS__TERM_TYPE_NAME]			= "name",
 995	[PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD]		= "period",
 996	[PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ]		= "freq",
 997	[PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE]	= "branch_type",
 998	[PARSE_EVENTS__TERM_TYPE_TIME]			= "time",
 999	[PARSE_EVENTS__TERM_TYPE_CALLGRAPH]		= "call-graph",
1000	[PARSE_EVENTS__TERM_TYPE_STACKSIZE]		= "stack-size",
1001	[PARSE_EVENTS__TERM_TYPE_NOINHERIT]		= "no-inherit",
1002	[PARSE_EVENTS__TERM_TYPE_INHERIT]		= "inherit",
1003	[PARSE_EVENTS__TERM_TYPE_MAX_STACK]		= "max-stack",
1004	[PARSE_EVENTS__TERM_TYPE_MAX_EVENTS]		= "nr",
1005	[PARSE_EVENTS__TERM_TYPE_OVERWRITE]		= "overwrite",
1006	[PARSE_EVENTS__TERM_TYPE_NOOVERWRITE]		= "no-overwrite",
1007	[PARSE_EVENTS__TERM_TYPE_DRV_CFG]		= "driver-config",
1008	[PARSE_EVENTS__TERM_TYPE_PERCORE]		= "percore",
1009	[PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT]		= "aux-output",
1010	[PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE]	= "aux-sample-size",
1011};
 
 
 
 
 
 
 
 
 
 
 
1012
1013static bool config_term_shrinked;
 
1014
1015static bool
1016config_term_avail(int term_type, struct parse_events_error *err)
1017{
1018	char *err_str;
1019
1020	if (term_type < 0 || term_type >= __PARSE_EVENTS__TERM_TYPE_NR) {
1021		parse_events__handle_error(err, -1,
1022					strdup("Invalid term_type"), NULL);
1023		return false;
1024	}
1025	if (!config_term_shrinked)
1026		return true;
1027
1028	switch (term_type) {
1029	case PARSE_EVENTS__TERM_TYPE_CONFIG:
1030	case PARSE_EVENTS__TERM_TYPE_CONFIG1:
1031	case PARSE_EVENTS__TERM_TYPE_CONFIG2:
 
1032	case PARSE_EVENTS__TERM_TYPE_NAME:
 
1033	case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
1034	case PARSE_EVENTS__TERM_TYPE_PERCORE:
1035		return true;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1036	default:
1037		if (!err)
1038			return false;
1039
1040		/* term_type is validated so indexing is safe */
1041		if (asprintf(&err_str, "'%s' is not usable in 'perf stat'",
1042				config_term_names[term_type]) >= 0)
1043			parse_events__handle_error(err, -1, err_str, NULL);
1044		return false;
1045	}
1046}
1047
1048void parse_events__shrink_config_terms(void)
1049{
1050	config_term_shrinked = true;
1051}
1052
1053static int config_term_common(struct perf_event_attr *attr,
1054			      struct parse_events_term *term,
1055			      struct parse_events_error *err)
1056{
1057#define CHECK_TYPE_VAL(type)						   \
1058do {									   \
1059	if (check_type_val(term, err, PARSE_EVENTS__TERM_TYPE_ ## type)) \
1060		return -EINVAL;						   \
1061} while (0)
1062
1063	switch (term->type_term) {
1064	case PARSE_EVENTS__TERM_TYPE_CONFIG:
1065		CHECK_TYPE_VAL(NUM);
1066		attr->config = term->val.num;
1067		break;
1068	case PARSE_EVENTS__TERM_TYPE_CONFIG1:
1069		CHECK_TYPE_VAL(NUM);
1070		attr->config1 = term->val.num;
1071		break;
1072	case PARSE_EVENTS__TERM_TYPE_CONFIG2:
1073		CHECK_TYPE_VAL(NUM);
1074		attr->config2 = term->val.num;
1075		break;
 
 
 
 
1076	case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
1077		CHECK_TYPE_VAL(NUM);
1078		break;
1079	case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
1080		CHECK_TYPE_VAL(NUM);
1081		break;
1082	case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
1083		CHECK_TYPE_VAL(STR);
1084		if (strcmp(term->val.str, "no") &&
1085		    parse_branch_str(term->val.str,
1086				    &attr->branch_sample_type)) {
1087			parse_events__handle_error(err, term->err_val,
1088					strdup("invalid branch sample type"),
1089					NULL);
1090			return -EINVAL;
1091		}
1092		break;
1093	case PARSE_EVENTS__TERM_TYPE_TIME:
1094		CHECK_TYPE_VAL(NUM);
1095		if (term->val.num > 1) {
1096			parse_events__handle_error(err, term->err_val,
1097						strdup("expected 0 or 1"),
1098						NULL);
1099			return -EINVAL;
1100		}
1101		break;
1102	case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
1103		CHECK_TYPE_VAL(STR);
1104		break;
1105	case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
1106		CHECK_TYPE_VAL(NUM);
1107		break;
1108	case PARSE_EVENTS__TERM_TYPE_INHERIT:
1109		CHECK_TYPE_VAL(NUM);
1110		break;
1111	case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
1112		CHECK_TYPE_VAL(NUM);
1113		break;
1114	case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
1115		CHECK_TYPE_VAL(NUM);
1116		break;
1117	case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
1118		CHECK_TYPE_VAL(NUM);
1119		break;
1120	case PARSE_EVENTS__TERM_TYPE_NAME:
1121		CHECK_TYPE_VAL(STR);
1122		break;
 
 
 
 
 
 
1123	case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
1124		CHECK_TYPE_VAL(NUM);
1125		break;
1126	case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
1127		CHECK_TYPE_VAL(NUM);
1128		break;
1129	case PARSE_EVENTS__TERM_TYPE_PERCORE:
1130		CHECK_TYPE_VAL(NUM);
1131		if ((unsigned int)term->val.num > 1) {
1132			parse_events__handle_error(err, term->err_val,
1133						strdup("expected 0 or 1"),
1134						NULL);
1135			return -EINVAL;
1136		}
1137		break;
1138	case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
1139		CHECK_TYPE_VAL(NUM);
1140		break;
1141	case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
1142		CHECK_TYPE_VAL(NUM);
1143		if (term->val.num > UINT_MAX) {
1144			parse_events__handle_error(err, term->err_val,
1145						strdup("too big"),
1146						NULL);
1147			return -EINVAL;
1148		}
1149		break;
 
 
 
 
1150	default:
1151		parse_events__handle_error(err, term->err_term,
1152				strdup("unknown term"),
1153				parse_events_formats_error_string(NULL));
1154		return -EINVAL;
1155	}
1156
1157	/*
1158	 * Check term availbility after basic checking so
1159	 * PARSE_EVENTS__TERM_TYPE_USER can be found and filtered.
1160	 *
1161	 * If check availbility at the entry of this function,
1162	 * user will see "'<sysfs term>' is not usable in 'perf stat'"
1163	 * if an invalid config term is provided for legacy events
1164	 * (for example, instructions/badterm/...), which is confusing.
1165	 */
1166	if (!config_term_avail(term->type_term, err))
1167		return -EINVAL;
1168	return 0;
1169#undef CHECK_TYPE_VAL
1170}
1171
1172static int config_term_pmu(struct perf_event_attr *attr,
1173			   struct parse_events_term *term,
1174			   struct parse_events_error *err)
1175{
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1176	if (term->type_term == PARSE_EVENTS__TERM_TYPE_USER ||
1177	    term->type_term == PARSE_EVENTS__TERM_TYPE_DRV_CFG)
1178		/*
1179		 * Always succeed for sysfs terms, as we dont know
1180		 * at this point what type they need to have.
1181		 */
1182		return 0;
1183	else
1184		return config_term_common(attr, term, err);
1185}
1186
 
1187static int config_term_tracepoint(struct perf_event_attr *attr,
1188				  struct parse_events_term *term,
1189				  struct parse_events_error *err)
1190{
1191	switch (term->type_term) {
1192	case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
1193	case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
1194	case PARSE_EVENTS__TERM_TYPE_INHERIT:
1195	case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
1196	case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
1197	case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
1198	case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
1199	case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
1200	case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
1201	case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
1202		return config_term_common(attr, term, err);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1203	default:
1204		if (err) {
1205			parse_events__handle_error(err, term->err_term,
1206				strdup("unknown term"),
1207				strdup("valid terms: call-graph,stack-size\n"));
1208		}
1209		return -EINVAL;
1210	}
1211
1212	return 0;
1213}
 
1214
1215static int config_attr(struct perf_event_attr *attr,
1216		       struct list_head *head,
1217		       struct parse_events_error *err,
1218		       config_term_func_t config_term)
1219{
1220	struct parse_events_term *term;
1221
1222	list_for_each_entry(term, head, list)
1223		if (config_term(attr, term, err))
1224			return -EINVAL;
1225
1226	return 0;
1227}
1228
1229static int get_config_terms(struct list_head *head_config,
1230			    struct list_head *head_terms __maybe_unused)
1231{
1232#define ADD_CONFIG_TERM(__type, __weak)				\
1233	struct evsel_config_term *__t;			\
1234								\
1235	__t = zalloc(sizeof(*__t));				\
1236	if (!__t)						\
1237		return -ENOMEM;					\
1238								\
1239	INIT_LIST_HEAD(&__t->list);				\
1240	__t->type       = EVSEL__CONFIG_TERM_ ## __type;	\
1241	__t->weak	= __weak;				\
1242	list_add_tail(&__t->list, head_terms)
1243
1244#define ADD_CONFIG_TERM_VAL(__type, __name, __val, __weak)	\
1245do {								\
1246	ADD_CONFIG_TERM(__type, __weak);			\
1247	__t->val.__name = __val;				\
1248} while (0)
1249
1250#define ADD_CONFIG_TERM_STR(__type, __val, __weak)		\
1251do {								\
1252	ADD_CONFIG_TERM(__type, __weak);			\
1253	__t->val.str = strdup(__val);				\
1254	if (!__t->val.str) {					\
1255		zfree(&__t);					\
1256		return -ENOMEM;					\
1257	}							\
1258	__t->free_str = true;					\
1259} while (0)
1260
1261	struct parse_events_term *term;
1262
1263	list_for_each_entry(term, head_config, list) {
1264		switch (term->type_term) {
1265		case PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD:
1266			ADD_CONFIG_TERM_VAL(PERIOD, period, term->val.num, term->weak);
1267			break;
1268		case PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ:
1269			ADD_CONFIG_TERM_VAL(FREQ, freq, term->val.num, term->weak);
1270			break;
1271		case PARSE_EVENTS__TERM_TYPE_TIME:
1272			ADD_CONFIG_TERM_VAL(TIME, time, term->val.num, term->weak);
1273			break;
1274		case PARSE_EVENTS__TERM_TYPE_CALLGRAPH:
1275			ADD_CONFIG_TERM_STR(CALLGRAPH, term->val.str, term->weak);
1276			break;
1277		case PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE:
1278			ADD_CONFIG_TERM_STR(BRANCH, term->val.str, term->weak);
1279			break;
1280		case PARSE_EVENTS__TERM_TYPE_STACKSIZE:
1281			ADD_CONFIG_TERM_VAL(STACK_USER, stack_user,
1282					    term->val.num, term->weak);
1283			break;
1284		case PARSE_EVENTS__TERM_TYPE_INHERIT:
1285			ADD_CONFIG_TERM_VAL(INHERIT, inherit,
1286					    term->val.num ? 1 : 0, term->weak);
1287			break;
1288		case PARSE_EVENTS__TERM_TYPE_NOINHERIT:
1289			ADD_CONFIG_TERM_VAL(INHERIT, inherit,
1290					    term->val.num ? 0 : 1, term->weak);
1291			break;
1292		case PARSE_EVENTS__TERM_TYPE_MAX_STACK:
1293			ADD_CONFIG_TERM_VAL(MAX_STACK, max_stack,
1294					    term->val.num, term->weak);
1295			break;
1296		case PARSE_EVENTS__TERM_TYPE_MAX_EVENTS:
1297			ADD_CONFIG_TERM_VAL(MAX_EVENTS, max_events,
1298					    term->val.num, term->weak);
1299			break;
1300		case PARSE_EVENTS__TERM_TYPE_OVERWRITE:
1301			ADD_CONFIG_TERM_VAL(OVERWRITE, overwrite,
1302					    term->val.num ? 1 : 0, term->weak);
1303			break;
1304		case PARSE_EVENTS__TERM_TYPE_NOOVERWRITE:
1305			ADD_CONFIG_TERM_VAL(OVERWRITE, overwrite,
1306					    term->val.num ? 0 : 1, term->weak);
1307			break;
1308		case PARSE_EVENTS__TERM_TYPE_DRV_CFG:
1309			ADD_CONFIG_TERM_STR(DRV_CFG, term->val.str, term->weak);
1310			break;
1311		case PARSE_EVENTS__TERM_TYPE_PERCORE:
1312			ADD_CONFIG_TERM_VAL(PERCORE, percore,
1313					    term->val.num ? true : false, term->weak);
1314			break;
1315		case PARSE_EVENTS__TERM_TYPE_AUX_OUTPUT:
1316			ADD_CONFIG_TERM_VAL(AUX_OUTPUT, aux_output,
1317					    term->val.num ? 1 : 0, term->weak);
1318			break;
1319		case PARSE_EVENTS__TERM_TYPE_AUX_SAMPLE_SIZE:
1320			ADD_CONFIG_TERM_VAL(AUX_SAMPLE_SIZE, aux_sample_size,
1321					    term->val.num, term->weak);
1322			break;
 
 
 
 
 
 
 
 
 
 
1323		default:
1324			break;
1325		}
1326	}
1327	return 0;
1328}
1329
1330/*
1331 * Add EVSEL__CONFIG_TERM_CFG_CHG where cfg_chg will have a bit set for
1332 * each bit of attr->config that the user has changed.
1333 */
1334static int get_config_chgs(struct perf_pmu *pmu, struct list_head *head_config,
1335			   struct list_head *head_terms)
1336{
1337	struct parse_events_term *term;
1338	u64 bits = 0;
1339	int type;
1340
1341	list_for_each_entry(term, head_config, list) {
1342		switch (term->type_term) {
1343		case PARSE_EVENTS__TERM_TYPE_USER:
1344			type = perf_pmu__format_type(&pmu->format, term->config);
1345			if (type != PERF_PMU_FORMAT_VALUE_CONFIG)
1346				continue;
1347			bits |= perf_pmu__format_bits(&pmu->format, term->config);
1348			break;
1349		case PARSE_EVENTS__TERM_TYPE_CONFIG:
1350			bits = ~(u64)0;
1351			break;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1352		default:
1353			break;
1354		}
1355	}
1356
1357	if (bits)
1358		ADD_CONFIG_TERM_VAL(CFG_CHG, cfg_chg, bits, false);
1359
1360#undef ADD_CONFIG_TERM
1361	return 0;
1362}
1363
1364int parse_events_add_tracepoint(struct list_head *list, int *idx,
1365				const char *sys, const char *event,
1366				struct parse_events_error *err,
1367				struct list_head *head_config)
1368{
 
 
1369	if (head_config) {
1370		struct perf_event_attr attr;
1371
1372		if (config_attr(&attr, head_config, err,
1373				config_term_tracepoint))
1374			return -EINVAL;
1375	}
1376
1377	if (strpbrk(sys, "*?"))
1378		return add_tracepoint_multi_sys(list, idx, sys, event,
1379						err, head_config);
1380	else
1381		return add_tracepoint_event(list, idx, sys, event,
1382					    err, head_config);
 
 
 
 
 
 
 
 
 
 
1383}
1384
1385int parse_events_add_numeric(struct parse_events_state *parse_state,
1386			     struct list_head *list,
1387			     u32 type, u64 config,
1388			     struct list_head *head_config)
1389{
1390	struct perf_event_attr attr;
1391	LIST_HEAD(config_terms);
 
 
1392
1393	memset(&attr, 0, sizeof(attr));
1394	attr.type = type;
1395	attr.config = config;
 
 
 
 
1396
1397	if (head_config) {
1398		if (config_attr(&attr, head_config, parse_state->error,
1399				config_term_common))
1400			return -EINVAL;
1401
1402		if (get_config_terms(head_config, &config_terms))
1403			return -ENOMEM;
1404	}
1405
1406	return add_event(list, &parse_state->idx, &attr,
1407			 get_config_name(head_config), &config_terms);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1408}
1409
1410int parse_events_add_tool(struct parse_events_state *parse_state,
1411			  struct list_head *list,
1412			  enum perf_tool_event tool_event)
1413{
1414	return add_event_tool(list, &parse_state->idx, tool_event);
1415}
1416
1417static bool config_term_percore(struct list_head *config_terms)
1418{
1419	struct evsel_config_term *term;
1420
1421	list_for_each_entry(term, config_terms, list) {
1422		if (term->type == EVSEL__CONFIG_TERM_PERCORE)
1423			return term->val.percore;
1424	}
1425
1426	return false;
1427}
1428
1429int parse_events_add_pmu(struct parse_events_state *parse_state,
1430			 struct list_head *list, char *name,
1431			 struct list_head *head_config,
1432			 bool auto_merge_stats,
1433			 bool use_alias)
1434{
1435	struct perf_event_attr attr;
1436	struct perf_pmu_info info;
1437	struct perf_pmu *pmu;
1438	struct evsel *evsel;
1439	struct parse_events_error *err = parse_state->error;
1440	bool use_uncore_alias;
1441	LIST_HEAD(config_terms);
 
 
1442
1443	if (verbose > 1) {
1444		fprintf(stderr, "Attempting to add event pmu '%s' with '",
1445			name);
1446		if (head_config) {
1447			struct parse_events_term *term;
1448
1449			list_for_each_entry(term, head_config, list) {
1450				fprintf(stderr, "%s,", term->config);
1451			}
1452		}
1453		fprintf(stderr, "' that may result in non-fatal errors\n");
1454	}
1455
1456	pmu = parse_state->fake_pmu ?: perf_pmu__find(name);
1457	if (!pmu) {
1458		char *err_str;
1459
1460		if (asprintf(&err_str,
1461				"Cannot find PMU `%s'. Missing kernel support?",
1462				name) >= 0)
1463			parse_events__handle_error(err, 0, err_str, NULL);
1464		return -EINVAL;
1465	}
1466
1467	if (pmu->default_config) {
1468		memcpy(&attr, pmu->default_config,
1469		       sizeof(struct perf_event_attr));
1470	} else {
1471		memset(&attr, 0, sizeof(attr));
 
1472	}
1473
1474	use_uncore_alias = (pmu->is_uncore && use_alias);
 
1475
1476	if (!head_config) {
1477		attr.type = pmu->type;
1478		evsel = __add_event(list, &parse_state->idx, &attr, true, NULL,
1479				    pmu, NULL, auto_merge_stats, NULL);
1480		if (evsel) {
1481			evsel->pmu_name = name ? strdup(name) : NULL;
1482			evsel->use_uncore_alias = use_uncore_alias;
1483			return 0;
1484		} else {
1485			return -ENOMEM;
 
 
1486		}
 
 
1487	}
 
 
 
 
 
1488
1489	if (!parse_state->fake_pmu && perf_pmu__check_alias(pmu, head_config, &info))
 
 
 
 
 
 
 
 
 
 
 
 
 
1490		return -EINVAL;
 
 
 
 
 
 
 
 
1491
1492	if (verbose > 1) {
1493		fprintf(stderr, "After aliases, add event pmu '%s' with '",
1494			name);
1495		if (head_config) {
1496			struct parse_events_term *term;
1497
1498			list_for_each_entry(term, head_config, list) {
1499				fprintf(stderr, "%s,", term->config);
1500			}
1501		}
1502		fprintf(stderr, "' that may result in non-fatal errors\n");
1503	}
1504
1505	/*
1506	 * Configure hardcoded terms first, no need to check
1507	 * return value when called with fail == 0 ;)
1508	 */
1509	if (config_attr(&attr, head_config, parse_state->error, config_term_pmu))
1510		return -EINVAL;
 
1511
1512	if (get_config_terms(head_config, &config_terms))
 
1513		return -ENOMEM;
 
1514
1515	/*
1516	 * When using default config, record which bits of attr->config were
1517	 * changed by the user.
1518	 */
1519	if (pmu->default_config && get_config_chgs(pmu, head_config, &config_terms))
 
 
1520		return -ENOMEM;
 
1521
1522	if (!parse_state->fake_pmu && perf_pmu__config(pmu, &attr, head_config, parse_state->error)) {
1523		struct evsel_config_term *pos, *tmp;
1524
1525		list_for_each_entry_safe(pos, tmp, &config_terms, list) {
1526			list_del_init(&pos->list);
1527			if (pos->free_str)
1528				zfree(&pos->val.str);
1529			free(pos);
1530		}
1531		return -EINVAL;
1532	}
1533
1534	evsel = __add_event(list, &parse_state->idx, &attr, true,
1535			    get_config_name(head_config), pmu,
1536			    &config_terms, auto_merge_stats, NULL);
1537	if (!evsel)
 
 
1538		return -ENOMEM;
 
 
 
 
1539
1540	evsel->pmu_name = name ? strdup(name) : NULL;
1541	evsel->use_uncore_alias = use_uncore_alias;
1542	evsel->percore = config_term_percore(&evsel->config_terms);
1543
1544	if (parse_state->fake_pmu)
 
1545		return 0;
 
1546
1547	evsel->unit = info.unit;
 
 
1548	evsel->scale = info.scale;
1549	evsel->per_pkg = info.per_pkg;
1550	evsel->snapshot = info.snapshot;
1551	evsel->metric_expr = info.metric_expr;
1552	evsel->metric_name = info.metric_name;
1553	return 0;
1554}
1555
1556int parse_events_multi_pmu_add(struct parse_events_state *parse_state,
1557			       char *str, struct list_head **listp)
 
 
1558{
1559	struct parse_events_term *term;
1560	struct list_head *list;
1561	struct perf_pmu *pmu = NULL;
 
1562	int ok = 0;
 
 
1563
1564	*listp = NULL;
1565	/* Add it for all PMUs that support the alias */
1566	list = malloc(sizeof(struct list_head));
1567	if (!list)
1568		return -1;
1569	INIT_LIST_HEAD(list);
1570	while ((pmu = perf_pmu__scan(pmu)) != NULL) {
1571		struct perf_pmu_alias *alias;
1572
1573		list_for_each_entry(alias, &pmu->aliases, list) {
1574			if (!strcasecmp(alias->name, str)) {
1575				struct list_head *head;
1576				char *config;
1577
1578				head = malloc(sizeof(struct list_head));
1579				if (!head)
1580					return -1;
1581				INIT_LIST_HEAD(head);
1582				config = strdup(str);
1583				if (!config)
1584					return -1;
1585				if (parse_events_term__num(&term,
1586						   PARSE_EVENTS__TERM_TYPE_USER,
1587						   config, 1, false, &config,
1588						   NULL) < 0) {
1589					free(list);
1590					free(config);
1591					return -1;
1592				}
1593				list_add_tail(&term->list, head);
1594
1595				if (!parse_events_add_pmu(parse_state, list,
1596							  pmu->name, head,
1597							  true, true)) {
1598					pr_debug("%s -> %s/%s/\n", str,
1599						 pmu->name, alias->str);
1600					ok++;
1601				}
1602
1603				parse_events_terms__delete(head);
1604			}
1605		}
 
 
 
 
 
 
 
1606	}
1607	if (!ok) {
1608		free(list);
1609		return -1;
1610	}
1611	*listp = list;
1612	return 0;
1613}
1614
1615int parse_events__modifier_group(struct list_head *list,
1616				 char *event_mod)
1617{
1618	return parse_events__modifier_event(list, event_mod, true);
1619}
1620
1621/*
1622 * Check if the two uncore PMUs are from the same uncore block
1623 * The format of the uncore PMU name is uncore_#blockname_#pmuidx
1624 */
1625static bool is_same_uncore_block(const char *pmu_name_a, const char *pmu_name_b)
1626{
1627	char *end_a, *end_b;
1628
1629	end_a = strrchr(pmu_name_a, '_');
1630	end_b = strrchr(pmu_name_b, '_');
1631
1632	if (!end_a || !end_b)
1633		return false;
1634
1635	if ((end_a - pmu_name_a) != (end_b - pmu_name_b))
1636		return false;
1637
1638	return (strncmp(pmu_name_a, pmu_name_b, end_a - pmu_name_a) == 0);
1639}
1640
1641static int
1642parse_events__set_leader_for_uncore_aliase(char *name, struct list_head *list,
1643					   struct parse_events_state *parse_state)
1644{
1645	struct evsel *evsel, *leader;
1646	uintptr_t *leaders;
1647	bool is_leader = true;
1648	int i, nr_pmu = 0, total_members, ret = 0;
1649
1650	leader = list_first_entry(list, struct evsel, core.node);
1651	evsel = list_last_entry(list, struct evsel, core.node);
1652	total_members = evsel->idx - leader->idx + 1;
1653
1654	leaders = calloc(total_members, sizeof(uintptr_t));
1655	if (WARN_ON(!leaders))
1656		return 0;
1657
1658	/*
1659	 * Going through the whole group and doing sanity check.
1660	 * All members must use alias, and be from the same uncore block.
1661	 * Also, storing the leader events in an array.
1662	 */
1663	__evlist__for_each_entry(list, evsel) {
1664
1665		/* Only split the uncore group which members use alias */
1666		if (!evsel->use_uncore_alias)
1667			goto out;
1668
1669		/* The events must be from the same uncore block */
1670		if (!is_same_uncore_block(leader->pmu_name, evsel->pmu_name))
1671			goto out;
1672
1673		if (!is_leader)
1674			continue;
1675		/*
1676		 * If the event's PMU name starts to repeat, it must be a new
1677		 * event. That can be used to distinguish the leader from
1678		 * other members, even they have the same event name.
1679		 */
1680		if ((leader != evsel) &&
1681		    !strcmp(leader->pmu_name, evsel->pmu_name)) {
1682			is_leader = false;
1683			continue;
1684		}
1685
1686		/* Store the leader event for each PMU */
1687		leaders[nr_pmu++] = (uintptr_t) evsel;
1688	}
1689
1690	/* only one event alias */
1691	if (nr_pmu == total_members) {
1692		parse_state->nr_groups--;
1693		goto handled;
1694	}
1695
1696	/*
1697	 * An uncore event alias is a joint name which means the same event
1698	 * runs on all PMUs of a block.
1699	 * Perf doesn't support mixed events from different PMUs in the same
1700	 * group. The big group has to be split into multiple small groups
1701	 * which only include the events from the same PMU.
1702	 *
1703	 * Here the uncore event aliases must be from the same uncore block.
1704	 * The number of PMUs must be same for each alias. The number of new
1705	 * small groups equals to the number of PMUs.
1706	 * Setting the leader event for corresponding members in each group.
1707	 */
1708	i = 0;
1709	__evlist__for_each_entry(list, evsel) {
1710		if (i >= nr_pmu)
1711			i = 0;
1712		evsel->leader = (struct evsel *) leaders[i++];
1713	}
1714
1715	/* The number of members and group name are same for each group */
1716	for (i = 0; i < nr_pmu; i++) {
1717		evsel = (struct evsel *) leaders[i];
1718		evsel->core.nr_members = total_members / nr_pmu;
1719		evsel->group_name = name ? strdup(name) : NULL;
1720	}
1721
1722	/* Take the new small groups into account */
1723	parse_state->nr_groups += nr_pmu - 1;
1724
1725handled:
1726	ret = 1;
1727out:
1728	free(leaders);
1729	return ret;
1730}
1731
1732void parse_events__set_leader(char *name, struct list_head *list,
1733			      struct parse_events_state *parse_state)
1734{
1735	struct evsel *leader;
1736
1737	if (list_empty(list)) {
1738		WARN_ONCE(true, "WARNING: failed to set leader: empty list");
1739		return;
1740	}
1741
1742	if (parse_events__set_leader_for_uncore_aliase(name, list, parse_state))
1743		return;
1744
1745	__perf_evlist__set_leader(list);
1746	leader = list_entry(list->next, struct evsel, core.node);
1747	leader->group_name = name ? strdup(name) : NULL;
1748}
1749
1750/* list_event is assumed to point to malloc'ed memory */
1751void parse_events_update_lists(struct list_head *list_event,
1752			       struct list_head *list_all)
1753{
1754	/*
1755	 * Called for single event definition. Update the
1756	 * 'all event' list, and reinit the 'single event'
1757	 * list, for next event definition.
1758	 */
1759	list_splice_tail(list_event, list_all);
1760	free(list_event);
1761}
1762
1763struct event_modifier {
1764	int eu;
1765	int ek;
1766	int eh;
1767	int eH;
1768	int eG;
1769	int eI;
1770	int precise;
1771	int precise_max;
1772	int exclude_GH;
1773	int sample_read;
1774	int pinned;
1775	int weak;
 
 
1776};
1777
1778static int get_event_modifier(struct event_modifier *mod, char *str,
1779			       struct evsel *evsel)
1780{
1781	int eu = evsel ? evsel->core.attr.exclude_user : 0;
1782	int ek = evsel ? evsel->core.attr.exclude_kernel : 0;
1783	int eh = evsel ? evsel->core.attr.exclude_hv : 0;
1784	int eH = evsel ? evsel->core.attr.exclude_host : 0;
1785	int eG = evsel ? evsel->core.attr.exclude_guest : 0;
1786	int eI = evsel ? evsel->core.attr.exclude_idle : 0;
1787	int precise = evsel ? evsel->core.attr.precise_ip : 0;
1788	int precise_max = 0;
1789	int sample_read = 0;
1790	int pinned = evsel ? evsel->core.attr.pinned : 0;
 
1791
1792	int exclude = eu | ek | eh;
1793	int exclude_GH = evsel ? evsel->exclude_GH : 0;
1794	int weak = 0;
 
1795
1796	memset(mod, 0, sizeof(*mod));
1797
1798	while (*str) {
1799		if (*str == 'u') {
1800			if (!exclude)
1801				exclude = eu = ek = eh = 1;
1802			if (!exclude_GH && !perf_guest)
1803				eG = 1;
1804			eu = 0;
1805		} else if (*str == 'k') {
1806			if (!exclude)
1807				exclude = eu = ek = eh = 1;
1808			ek = 0;
1809		} else if (*str == 'h') {
1810			if (!exclude)
1811				exclude = eu = ek = eh = 1;
1812			eh = 0;
1813		} else if (*str == 'G') {
1814			if (!exclude_GH)
1815				exclude_GH = eG = eH = 1;
1816			eG = 0;
1817		} else if (*str == 'H') {
1818			if (!exclude_GH)
1819				exclude_GH = eG = eH = 1;
1820			eH = 0;
1821		} else if (*str == 'I') {
1822			eI = 1;
1823		} else if (*str == 'p') {
1824			precise++;
1825			/* use of precise requires exclude_guest */
1826			if (!exclude_GH)
1827				eG = 1;
1828		} else if (*str == 'P') {
1829			precise_max = 1;
1830		} else if (*str == 'S') {
1831			sample_read = 1;
1832		} else if (*str == 'D') {
1833			pinned = 1;
 
 
1834		} else if (*str == 'W') {
1835			weak = 1;
 
 
1836		} else
1837			break;
1838
1839		++str;
1840	}
1841
1842	/*
1843	 * precise ip:
1844	 *
1845	 *  0 - SAMPLE_IP can have arbitrary skid
1846	 *  1 - SAMPLE_IP must have constant skid
1847	 *  2 - SAMPLE_IP requested to have 0 skid
1848	 *  3 - SAMPLE_IP must have 0 skid
1849	 *
1850	 *  See also PERF_RECORD_MISC_EXACT_IP
1851	 */
1852	if (precise > 3)
1853		return -EINVAL;
1854
1855	mod->eu = eu;
1856	mod->ek = ek;
1857	mod->eh = eh;
1858	mod->eH = eH;
1859	mod->eG = eG;
1860	mod->eI = eI;
1861	mod->precise = precise;
1862	mod->precise_max = precise_max;
1863	mod->exclude_GH = exclude_GH;
1864	mod->sample_read = sample_read;
1865	mod->pinned = pinned;
1866	mod->weak = weak;
 
 
1867
1868	return 0;
1869}
1870
1871/*
1872 * Basic modifier sanity check to validate it contains only one
1873 * instance of any modifier (apart from 'p') present.
1874 */
1875static int check_modifier(char *str)
1876{
1877	char *p = str;
1878
1879	/* The sizeof includes 0 byte as well. */
1880	if (strlen(str) > (sizeof("ukhGHpppPSDIW") - 1))
1881		return -1;
1882
1883	while (*p) {
1884		if (*p != 'p' && strchr(p + 1, *p))
1885			return -1;
1886		p++;
1887	}
1888
1889	return 0;
1890}
1891
1892int parse_events__modifier_event(struct list_head *list, char *str, bool add)
1893{
1894	struct evsel *evsel;
1895	struct event_modifier mod;
1896
1897	if (str == NULL)
1898		return 0;
1899
1900	if (check_modifier(str))
1901		return -EINVAL;
1902
1903	if (!add && get_event_modifier(&mod, str, NULL))
1904		return -EINVAL;
1905
1906	__evlist__for_each_entry(list, evsel) {
1907		if (add && get_event_modifier(&mod, str, evsel))
1908			return -EINVAL;
1909
1910		evsel->core.attr.exclude_user   = mod.eu;
1911		evsel->core.attr.exclude_kernel = mod.ek;
1912		evsel->core.attr.exclude_hv     = mod.eh;
1913		evsel->core.attr.precise_ip     = mod.precise;
1914		evsel->core.attr.exclude_host   = mod.eH;
1915		evsel->core.attr.exclude_guest  = mod.eG;
1916		evsel->core.attr.exclude_idle   = mod.eI;
1917		evsel->exclude_GH          = mod.exclude_GH;
1918		evsel->sample_read         = mod.sample_read;
1919		evsel->precise_max         = mod.precise_max;
1920		evsel->weak_group	   = mod.weak;
 
1921
1922		if (evsel__is_group_leader(evsel))
1923			evsel->core.attr.pinned = mod.pinned;
 
 
1924	}
1925
1926	return 0;
1927}
1928
1929int parse_events_name(struct list_head *list, char *name)
1930{
1931	struct evsel *evsel;
1932
1933	__evlist__for_each_entry(list, evsel) {
1934		if (!evsel->name)
1935			evsel->name = strdup(name);
 
 
 
1936	}
1937
1938	return 0;
1939}
1940
1941static int
1942comp_pmu(const void *p1, const void *p2)
 
1943{
1944	struct perf_pmu_event_symbol *pmu1 = (struct perf_pmu_event_symbol *) p1;
1945	struct perf_pmu_event_symbol *pmu2 = (struct perf_pmu_event_symbol *) p2;
 
 
 
 
 
1946
1947	return strcasecmp(pmu1->symbol, pmu2->symbol);
1948}
 
 
1949
1950static void perf_pmu__parse_cleanup(void)
1951{
1952	if (perf_pmu_events_list_num > 0) {
1953		struct perf_pmu_event_symbol *p;
1954		int i;
1955
1956		for (i = 0; i < perf_pmu_events_list_num; i++) {
1957			p = perf_pmu_events_list + i;
1958			zfree(&p->symbol);
1959		}
1960		zfree(&perf_pmu_events_list);
1961		perf_pmu_events_list_num = 0;
1962	}
 
 
1963}
1964
1965#define SET_SYMBOL(str, stype)		\
1966do {					\
1967	p->symbol = str;		\
1968	if (!p->symbol)			\
1969		goto err;		\
1970	p->type = stype;		\
1971} while (0)
1972
1973/*
1974 * Read the pmu events list from sysfs
1975 * Save it into perf_pmu_events_list
1976 */
1977static void perf_pmu__parse_init(void)
1978{
 
 
 
 
 
 
 
 
 
1979
1980	struct perf_pmu *pmu = NULL;
1981	struct perf_pmu_alias *alias;
1982	int len = 0;
 
 
 
 
 
 
 
 
1983
1984	pmu = NULL;
1985	while ((pmu = perf_pmu__scan(pmu)) != NULL) {
1986		list_for_each_entry(alias, &pmu->aliases, list) {
1987			if (strchr(alias->name, '-'))
1988				len++;
1989			len++;
1990		}
 
 
 
 
1991	}
 
 
 
 
 
 
 
 
 
 
 
1992
1993	if (len == 0) {
1994		perf_pmu_events_list_num = -1;
1995		return;
1996	}
1997	perf_pmu_events_list = malloc(sizeof(struct perf_pmu_event_symbol) * len);
1998	if (!perf_pmu_events_list)
1999		return;
2000	perf_pmu_events_list_num = len;
 
 
 
 
 
 
 
2001
2002	len = 0;
2003	pmu = NULL;
2004	while ((pmu = perf_pmu__scan(pmu)) != NULL) {
2005		list_for_each_entry(alias, &pmu->aliases, list) {
2006			struct perf_pmu_event_symbol *p = perf_pmu_events_list + len;
2007			char *tmp = strchr(alias->name, '-');
2008
2009			if (tmp != NULL) {
2010				SET_SYMBOL(strndup(alias->name, tmp - alias->name),
2011						PMU_EVENT_SYMBOL_PREFIX);
2012				p++;
2013				SET_SYMBOL(strdup(++tmp), PMU_EVENT_SYMBOL_SUFFIX);
2014				len += 2;
2015			} else {
2016				SET_SYMBOL(strdup(alias->name), PMU_EVENT_SYMBOL);
2017				len++;
2018			}
2019		}
2020	}
2021	qsort(perf_pmu_events_list, len,
2022		sizeof(struct perf_pmu_event_symbol), comp_pmu);
 
 
2023
2024	return;
2025err:
2026	perf_pmu__parse_cleanup();
 
2027}
2028
2029/*
2030 * This function injects special term in
2031 * perf_pmu_events_list so the test code
2032 * can check on this functionality.
2033 */
2034int perf_pmu__test_parse_init(void)
2035{
2036	struct perf_pmu_event_symbol *list;
 
 
 
 
 
 
 
2037
2038	list = malloc(sizeof(*list) * 1);
2039	if (!list)
2040		return -ENOMEM;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2041
2042	list->type   = PMU_EVENT_SYMBOL;
2043	list->symbol = strdup("read");
2044
2045	if (!list->symbol) {
2046		free(list);
2047		return -ENOMEM;
 
 
 
 
2048	}
2049
2050	perf_pmu_events_list = list;
2051	perf_pmu_events_list_num = 1;
2052	return 0;
2053}
2054
2055enum perf_pmu_event_symbol_type
2056perf_pmu__parse_check(const char *name)
2057{
2058	struct perf_pmu_event_symbol p, *r;
 
 
 
 
 
2059
2060	/* scan kernel pmu events from sysfs if needed */
2061	if (perf_pmu_events_list_num == 0)
2062		perf_pmu__parse_init();
2063	/*
2064	 * name "cpu" could be prefix of cpu-cycles or cpu// events.
2065	 * cpu-cycles has been handled by hardcode.
2066	 * So it must be cpu// events, not kernel pmu event.
2067	 */
2068	if ((perf_pmu_events_list_num <= 0) || !strcmp(name, "cpu"))
2069		return PMU_EVENT_SYMBOL_ERR;
2070
2071	p.symbol = strdup(name);
2072	r = bsearch(&p, perf_pmu_events_list,
2073			(size_t) perf_pmu_events_list_num,
2074			sizeof(struct perf_pmu_event_symbol), comp_pmu);
2075	zfree(&p.symbol);
2076	return r ? r->type : PMU_EVENT_SYMBOL_ERR;
2077}
2078
2079static int parse_events__scanner(const char *str,
2080				 struct parse_events_state *parse_state)
2081{
2082	YY_BUFFER_STATE buffer;
2083	void *scanner;
2084	int ret;
2085
2086	ret = parse_events_lex_init_extra(parse_state, &scanner);
2087	if (ret)
2088		return ret;
 
 
 
2089
2090	buffer = parse_events__scan_string(str, scanner);
 
 
 
 
2091
2092#ifdef PARSER_DEBUG
2093	parse_events_debug = 1;
2094	parse_events_set_debug(1, scanner);
2095#endif
2096	ret = parse_events_parse(parse_state, scanner);
2097
2098	parse_events__flush_buffer(buffer, scanner);
2099	parse_events__delete_buffer(buffer, scanner);
2100	parse_events_lex_destroy(scanner);
2101	return ret;
2102}
 
 
 
 
 
 
 
 
 
 
 
 
2103
2104/*
2105 * parse event config string, return a list of event terms.
2106 */
2107int parse_events_terms(struct list_head *terms, const char *str)
2108{
2109	struct parse_events_state parse_state = {
2110		.terms  = NULL,
2111		.stoken = PE_START_TERMS,
2112	};
2113	int ret;
2114
2115	ret = parse_events__scanner(str, &parse_state);
2116	perf_pmu__parse_cleanup();
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2117
2118	if (!ret) {
2119		list_splice(parse_state.terms, terms);
2120		zfree(&parse_state.terms);
2121		return 0;
2122	}
2123
2124	parse_events_terms__delete(parse_state.terms);
2125	return ret;
2126}
2127
2128int __parse_events(struct evlist *evlist, const char *str,
2129		   struct parse_events_error *err, struct perf_pmu *fake_pmu)
 
2130{
2131	struct parse_events_state parse_state = {
2132		.list	  = LIST_HEAD_INIT(parse_state.list),
2133		.idx	  = evlist->core.nr_entries,
2134		.error	  = err,
2135		.evlist	  = evlist,
2136		.stoken	  = PE_START_EVENTS,
2137		.fake_pmu = fake_pmu,
 
 
2138	};
2139	int ret;
2140
2141	ret = parse_events__scanner(str, &parse_state);
2142	perf_pmu__parse_cleanup();
2143
2144	if (!ret && list_empty(&parse_state.list)) {
2145		WARN_ONCE(true, "WARNING: event parser found nothing\n");
2146		return -1;
2147	}
2148
 
 
 
 
 
 
 
2149	/*
2150	 * Add list to the evlist even with errors to allow callers to clean up.
2151	 */
2152	perf_evlist__splice_list_tail(evlist, &parse_state.list);
2153
2154	if (!ret) {
2155		struct evsel *last;
2156
2157		evlist->nr_groups += parse_state.nr_groups;
2158		last = evlist__last(evlist);
2159		last->cmdline_group_boundary = true;
2160
2161		return 0;
2162	}
2163
2164	/*
2165	 * There are 2 users - builtin-record and builtin-test objects.
2166	 * Both call evlist__delete in case of error, so we dont
2167	 * need to bother.
2168	 */
2169	return ret;
2170}
2171
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2172#define MAX_WIDTH 1000
2173static int get_term_width(void)
2174{
2175	struct winsize ws;
2176
2177	get_term_dimensions(&ws);
2178	return ws.ws_col > MAX_WIDTH ? MAX_WIDTH : ws.ws_col;
2179}
2180
2181static void __parse_events_print_error(int err_idx, const char *err_str,
2182				const char *err_help, const char *event)
2183{
2184	const char *str = "invalid or unsupported event: ";
2185	char _buf[MAX_WIDTH];
2186	char *buf = (char *) event;
2187	int idx = 0;
2188	if (err_str) {
2189		/* -2 for extra '' in the final fprintf */
2190		int width       = get_term_width() - 2;
2191		int len_event   = strlen(event);
2192		int len_str, max_len, cut = 0;
2193
2194		/*
2195		 * Maximum error index indent, we will cut
2196		 * the event string if it's bigger.
2197		 */
2198		int max_err_idx = 13;
2199
2200		/*
2201		 * Let's be specific with the message when
2202		 * we have the precise error.
2203		 */
2204		str     = "event syntax error: ";
2205		len_str = strlen(str);
2206		max_len = width - len_str;
2207
2208		buf = _buf;
2209
2210		/* We're cutting from the beginning. */
2211		if (err_idx > max_err_idx)
2212			cut = err_idx - max_err_idx;
2213
2214		strncpy(buf, event + cut, max_len);
2215
2216		/* Mark cut parts with '..' on both sides. */
2217		if (cut)
2218			buf[0] = buf[1] = '.';
2219
2220		if ((len_event - cut) > max_len) {
2221			buf[max_len - 1] = buf[max_len - 2] = '.';
2222			buf[max_len] = 0;
2223		}
2224
2225		idx = len_str + err_idx - cut;
2226	}
2227
2228	fprintf(stderr, "%s'%s'\n", str, buf);
2229	if (idx) {
2230		fprintf(stderr, "%*s\\___ %s\n", idx + 1, "", err_str);
2231		if (err_help)
2232			fprintf(stderr, "\n%s\n", err_help);
2233	}
2234}
2235
2236void parse_events_print_error(struct parse_events_error *err,
2237			      const char *event)
2238{
2239	if (!err->num_errors)
2240		return;
2241
2242	__parse_events_print_error(err->idx, err->str, err->help, event);
2243	zfree(&err->str);
2244	zfree(&err->help);
2245
2246	if (err->num_errors > 1) {
2247		fputs("\nInitial error:\n", stderr);
2248		__parse_events_print_error(err->first_idx, err->first_str,
2249					err->first_help, event);
2250		zfree(&err->first_str);
2251		zfree(&err->first_help);
2252	}
2253}
2254
2255#undef MAX_WIDTH
2256
2257int parse_events_option(const struct option *opt, const char *str,
2258			int unset __maybe_unused)
2259{
2260	struct evlist *evlist = *(struct evlist **)opt->value;
2261	struct parse_events_error err;
2262	int ret;
2263
2264	bzero(&err, sizeof(err));
2265	ret = parse_events(evlist, str, &err);
 
2266
2267	if (ret) {
2268		parse_events_print_error(&err, str);
2269		fprintf(stderr, "Run 'perf list' for a list of valid events\n");
2270	}
 
2271
2272	return ret;
2273}
2274
2275int parse_events_option_new_evlist(const struct option *opt, const char *str, int unset)
2276{
2277	struct evlist **evlistp = opt->value;
2278	int ret;
2279
2280	if (*evlistp == NULL) {
2281		*evlistp = evlist__new();
2282
2283		if (*evlistp == NULL) {
2284			fprintf(stderr, "Not enough memory to create evlist\n");
2285			return -1;
2286		}
2287	}
2288
2289	ret = parse_events_option(opt, str, unset);
2290	if (ret) {
2291		evlist__delete(*evlistp);
2292		*evlistp = NULL;
2293	}
2294
2295	return ret;
2296}
2297
2298static int
2299foreach_evsel_in_last_glob(struct evlist *evlist,
2300			   int (*func)(struct evsel *evsel,
2301				       const void *arg),
2302			   const void *arg)
2303{
2304	struct evsel *last = NULL;
2305	int err;
2306
2307	/*
2308	 * Don't return when list_empty, give func a chance to report
2309	 * error when it found last == NULL.
2310	 *
2311	 * So no need to WARN here, let *func do this.
2312	 */
2313	if (evlist->core.nr_entries > 0)
2314		last = evlist__last(evlist);
2315
2316	do {
2317		err = (*func)(last, arg);
2318		if (err)
2319			return -1;
2320		if (!last)
2321			return 0;
2322
2323		if (last->core.node.prev == &evlist->core.entries)
2324			return 0;
2325		last = list_entry(last->core.node.prev, struct evsel, core.node);
2326	} while (!last->cmdline_group_boundary);
2327
2328	return 0;
2329}
2330
2331static int set_filter(struct evsel *evsel, const void *arg)
2332{
2333	const char *str = arg;
2334	bool found = false;
2335	int nr_addr_filters = 0;
2336	struct perf_pmu *pmu = NULL;
2337
2338	if (evsel == NULL) {
2339		fprintf(stderr,
2340			"--filter option should follow a -e tracepoint or HW tracer option\n");
2341		return -1;
2342	}
2343
2344	if (evsel->core.attr.type == PERF_TYPE_TRACEPOINT) {
2345		if (evsel__append_tp_filter(evsel, str) < 0) {
2346			fprintf(stderr,
2347				"not enough memory to hold filter string\n");
2348			return -1;
2349		}
2350
2351		return 0;
2352	}
2353
2354	while ((pmu = perf_pmu__scan(pmu)) != NULL)
2355		if (pmu->type == evsel->core.attr.type) {
2356			found = true;
2357			break;
2358		}
2359
2360	if (found)
2361		perf_pmu__scan_file(pmu, "nr_addr_filters",
2362				    "%d", &nr_addr_filters);
2363
2364	if (!nr_addr_filters) {
2365		fprintf(stderr,
2366			"This CPU does not support address filtering\n");
2367		return -1;
2368	}
2369
2370	if (evsel__append_addr_filter(evsel, str) < 0) {
2371		fprintf(stderr,
2372			"not enough memory to hold filter string\n");
2373		return -1;
2374	}
2375
2376	return 0;
2377}
2378
2379int parse_filter(const struct option *opt, const char *str,
2380		 int unset __maybe_unused)
2381{
2382	struct evlist *evlist = *(struct evlist **)opt->value;
2383
2384	return foreach_evsel_in_last_glob(evlist, set_filter,
2385					  (const void *)str);
2386}
2387
2388static int add_exclude_perf_filter(struct evsel *evsel,
2389				   const void *arg __maybe_unused)
2390{
2391	char new_filter[64];
2392
2393	if (evsel == NULL || evsel->core.attr.type != PERF_TYPE_TRACEPOINT) {
2394		fprintf(stderr,
2395			"--exclude-perf option should follow a -e tracepoint option\n");
2396		return -1;
2397	}
2398
2399	snprintf(new_filter, sizeof(new_filter), "common_pid != %d", getpid());
2400
2401	if (evsel__append_tp_filter(evsel, new_filter) < 0) {
2402		fprintf(stderr,
2403			"not enough memory to hold filter string\n");
2404		return -1;
2405	}
2406
2407	return 0;
2408}
2409
2410int exclude_perf(const struct option *opt,
2411		 const char *arg __maybe_unused,
2412		 int unset __maybe_unused)
2413{
2414	struct evlist *evlist = *(struct evlist **)opt->value;
2415
2416	return foreach_evsel_in_last_glob(evlist, add_exclude_perf_filter,
2417					  NULL);
2418}
2419
2420static const char * const event_type_descriptors[] = {
2421	"Hardware event",
2422	"Software event",
2423	"Tracepoint event",
2424	"Hardware cache event",
2425	"Raw hardware event descriptor",
2426	"Hardware breakpoint",
2427};
2428
2429static int cmp_string(const void *a, const void *b)
2430{
2431	const char * const *as = a;
2432	const char * const *bs = b;
2433
2434	return strcmp(*as, *bs);
2435}
2436
2437/*
2438 * Print the events from <debugfs_mount_point>/tracing/events
2439 */
2440
2441void print_tracepoint_events(const char *subsys_glob, const char *event_glob,
2442			     bool name_only)
2443{
2444	DIR *sys_dir, *evt_dir;
2445	struct dirent *sys_dirent, *evt_dirent;
2446	char evt_path[MAXPATHLEN];
2447	char *dir_path;
2448	char **evt_list = NULL;
2449	unsigned int evt_i = 0, evt_num = 0;
2450	bool evt_num_known = false;
2451
2452restart:
2453	sys_dir = tracing_events__opendir();
2454	if (!sys_dir)
2455		return;
2456
2457	if (evt_num_known) {
2458		evt_list = zalloc(sizeof(char *) * evt_num);
2459		if (!evt_list)
2460			goto out_close_sys_dir;
2461	}
2462
2463	for_each_subsystem(sys_dir, sys_dirent) {
2464		if (subsys_glob != NULL &&
2465		    !strglobmatch(sys_dirent->d_name, subsys_glob))
2466			continue;
2467
2468		dir_path = get_events_file(sys_dirent->d_name);
2469		if (!dir_path)
2470			continue;
2471		evt_dir = opendir(dir_path);
2472		if (!evt_dir)
2473			goto next;
2474
2475		for_each_event(dir_path, evt_dir, evt_dirent) {
2476			if (event_glob != NULL &&
2477			    !strglobmatch(evt_dirent->d_name, event_glob))
2478				continue;
2479
2480			if (!evt_num_known) {
2481				evt_num++;
2482				continue;
2483			}
2484
2485			snprintf(evt_path, MAXPATHLEN, "%s:%s",
2486				 sys_dirent->d_name, evt_dirent->d_name);
2487
2488			evt_list[evt_i] = strdup(evt_path);
2489			if (evt_list[evt_i] == NULL) {
2490				put_events_file(dir_path);
2491				goto out_close_evt_dir;
2492			}
2493			evt_i++;
2494		}
2495		closedir(evt_dir);
2496next:
2497		put_events_file(dir_path);
2498	}
2499	closedir(sys_dir);
2500
2501	if (!evt_num_known) {
2502		evt_num_known = true;
2503		goto restart;
2504	}
2505	qsort(evt_list, evt_num, sizeof(char *), cmp_string);
2506	evt_i = 0;
2507	while (evt_i < evt_num) {
2508		if (name_only) {
2509			printf("%s ", evt_list[evt_i++]);
2510			continue;
2511		}
2512		printf("  %-50s [%s]\n", evt_list[evt_i++],
2513				event_type_descriptors[PERF_TYPE_TRACEPOINT]);
2514	}
2515	if (evt_num && pager_in_use())
2516		printf("\n");
2517
2518out_free:
2519	evt_num = evt_i;
2520	for (evt_i = 0; evt_i < evt_num; evt_i++)
2521		zfree(&evt_list[evt_i]);
2522	zfree(&evt_list);
2523	return;
2524
2525out_close_evt_dir:
2526	closedir(evt_dir);
2527out_close_sys_dir:
2528	closedir(sys_dir);
2529
2530	printf("FATAL: not enough memory to print %s\n",
2531			event_type_descriptors[PERF_TYPE_TRACEPOINT]);
2532	if (evt_list)
2533		goto out_free;
2534}
2535
2536/*
2537 * Check whether event is in <debugfs_mount_point>/tracing/events
2538 */
2539
2540int is_valid_tracepoint(const char *event_string)
2541{
2542	DIR *sys_dir, *evt_dir;
2543	struct dirent *sys_dirent, *evt_dirent;
2544	char evt_path[MAXPATHLEN];
2545	char *dir_path;
2546
2547	sys_dir = tracing_events__opendir();
2548	if (!sys_dir)
2549		return 0;
2550
2551	for_each_subsystem(sys_dir, sys_dirent) {
2552		dir_path = get_events_file(sys_dirent->d_name);
2553		if (!dir_path)
2554			continue;
2555		evt_dir = opendir(dir_path);
2556		if (!evt_dir)
2557			goto next;
2558
2559		for_each_event(dir_path, evt_dir, evt_dirent) {
2560			snprintf(evt_path, MAXPATHLEN, "%s:%s",
2561				 sys_dirent->d_name, evt_dirent->d_name);
2562			if (!strcmp(evt_path, event_string)) {
2563				closedir(evt_dir);
2564				closedir(sys_dir);
2565				return 1;
2566			}
2567		}
2568		closedir(evt_dir);
2569next:
2570		put_events_file(dir_path);
2571	}
2572	closedir(sys_dir);
2573	return 0;
2574}
2575
2576static bool is_event_supported(u8 type, unsigned config)
2577{
2578	bool ret = true;
2579	int open_return;
2580	struct evsel *evsel;
2581	struct perf_event_attr attr = {
2582		.type = type,
2583		.config = config,
2584		.disabled = 1,
2585	};
2586	struct perf_thread_map *tmap = thread_map__new_by_tid(0);
2587
2588	if (tmap == NULL)
2589		return false;
2590
2591	evsel = evsel__new(&attr);
2592	if (evsel) {
2593		open_return = evsel__open(evsel, NULL, tmap);
2594		ret = open_return >= 0;
2595
2596		if (open_return == -EACCES) {
2597			/*
2598			 * This happens if the paranoid value
2599			 * /proc/sys/kernel/perf_event_paranoid is set to 2
2600			 * Re-run with exclude_kernel set; we don't do that
2601			 * by default as some ARM machines do not support it.
2602			 *
2603			 */
2604			evsel->core.attr.exclude_kernel = 1;
2605			ret = evsel__open(evsel, NULL, tmap) >= 0;
2606		}
2607		evsel__delete(evsel);
2608	}
2609
2610	perf_thread_map__put(tmap);
2611	return ret;
2612}
2613
2614void print_sdt_events(const char *subsys_glob, const char *event_glob,
2615		      bool name_only)
2616{
2617	struct probe_cache *pcache;
2618	struct probe_cache_entry *ent;
2619	struct strlist *bidlist, *sdtlist;
2620	struct strlist_config cfg = {.dont_dupstr = true};
2621	struct str_node *nd, *nd2;
2622	char *buf, *path, *ptr = NULL;
2623	bool show_detail = false;
2624	int ret;
2625
2626	sdtlist = strlist__new(NULL, &cfg);
2627	if (!sdtlist) {
2628		pr_debug("Failed to allocate new strlist for SDT\n");
2629		return;
2630	}
2631	bidlist = build_id_cache__list_all(true);
2632	if (!bidlist) {
2633		pr_debug("Failed to get buildids: %d\n", errno);
2634		return;
2635	}
2636	strlist__for_each_entry(nd, bidlist) {
2637		pcache = probe_cache__new(nd->s, NULL);
2638		if (!pcache)
2639			continue;
2640		list_for_each_entry(ent, &pcache->entries, node) {
2641			if (!ent->sdt)
2642				continue;
2643			if (subsys_glob &&
2644			    !strglobmatch(ent->pev.group, subsys_glob))
2645				continue;
2646			if (event_glob &&
2647			    !strglobmatch(ent->pev.event, event_glob))
2648				continue;
2649			ret = asprintf(&buf, "%s:%s@%s", ent->pev.group,
2650					ent->pev.event, nd->s);
2651			if (ret > 0)
2652				strlist__add(sdtlist, buf);
2653		}
2654		probe_cache__delete(pcache);
2655	}
2656	strlist__delete(bidlist);
2657
2658	strlist__for_each_entry(nd, sdtlist) {
2659		buf = strchr(nd->s, '@');
2660		if (buf)
2661			*(buf++) = '\0';
2662		if (name_only) {
2663			printf("%s ", nd->s);
2664			continue;
2665		}
2666		nd2 = strlist__next(nd);
2667		if (nd2) {
2668			ptr = strchr(nd2->s, '@');
2669			if (ptr)
2670				*ptr = '\0';
2671			if (strcmp(nd->s, nd2->s) == 0)
2672				show_detail = true;
2673		}
2674		if (show_detail) {
2675			path = build_id_cache__origname(buf);
2676			ret = asprintf(&buf, "%s@%s(%.12s)", nd->s, path, buf);
2677			if (ret > 0) {
2678				printf("  %-50s [%s]\n", buf, "SDT event");
2679				free(buf);
2680			}
2681			free(path);
2682		} else
2683			printf("  %-50s [%s]\n", nd->s, "SDT event");
2684		if (nd2) {
2685			if (strcmp(nd->s, nd2->s) != 0)
2686				show_detail = false;
2687			if (ptr)
2688				*ptr = '@';
2689		}
2690	}
2691	strlist__delete(sdtlist);
2692}
2693
2694int print_hwcache_events(const char *event_glob, bool name_only)
2695{
2696	unsigned int type, op, i, evt_i = 0, evt_num = 0;
2697	char name[64];
2698	char **evt_list = NULL;
2699	bool evt_num_known = false;
2700
2701restart:
2702	if (evt_num_known) {
2703		evt_list = zalloc(sizeof(char *) * evt_num);
2704		if (!evt_list)
2705			goto out_enomem;
2706	}
2707
2708	for (type = 0; type < PERF_COUNT_HW_CACHE_MAX; type++) {
2709		for (op = 0; op < PERF_COUNT_HW_CACHE_OP_MAX; op++) {
2710			/* skip invalid cache type */
2711			if (!evsel__is_cache_op_valid(type, op))
2712				continue;
2713
2714			for (i = 0; i < PERF_COUNT_HW_CACHE_RESULT_MAX; i++) {
2715				__evsel__hw_cache_type_op_res_name(type, op, i, name, sizeof(name));
2716				if (event_glob != NULL && !strglobmatch(name, event_glob))
2717					continue;
2718
2719				if (!is_event_supported(PERF_TYPE_HW_CACHE,
2720							type | (op << 8) | (i << 16)))
2721					continue;
2722
2723				if (!evt_num_known) {
2724					evt_num++;
2725					continue;
2726				}
2727
2728				evt_list[evt_i] = strdup(name);
2729				if (evt_list[evt_i] == NULL)
2730					goto out_enomem;
2731				evt_i++;
2732			}
2733		}
2734	}
2735
2736	if (!evt_num_known) {
2737		evt_num_known = true;
2738		goto restart;
2739	}
2740	qsort(evt_list, evt_num, sizeof(char *), cmp_string);
2741	evt_i = 0;
2742	while (evt_i < evt_num) {
2743		if (name_only) {
2744			printf("%s ", evt_list[evt_i++]);
2745			continue;
2746		}
2747		printf("  %-50s [%s]\n", evt_list[evt_i++],
2748				event_type_descriptors[PERF_TYPE_HW_CACHE]);
2749	}
2750	if (evt_num && pager_in_use())
2751		printf("\n");
2752
2753out_free:
2754	evt_num = evt_i;
2755	for (evt_i = 0; evt_i < evt_num; evt_i++)
2756		zfree(&evt_list[evt_i]);
2757	zfree(&evt_list);
2758	return evt_num;
2759
2760out_enomem:
2761	printf("FATAL: not enough memory to print %s\n", event_type_descriptors[PERF_TYPE_HW_CACHE]);
2762	if (evt_list)
2763		goto out_free;
2764	return evt_num;
2765}
2766
2767static void print_tool_event(const char *name, const char *event_glob,
2768			     bool name_only)
2769{
2770	if (event_glob && !strglobmatch(name, event_glob))
2771		return;
2772	if (name_only)
2773		printf("%s ", name);
2774	else
2775		printf("  %-50s [%s]\n", name, "Tool event");
2776
2777}
2778
2779void print_tool_events(const char *event_glob, bool name_only)
2780{
2781	print_tool_event("duration_time", event_glob, name_only);
2782	if (pager_in_use())
2783		printf("\n");
2784}
2785
2786void print_symbol_events(const char *event_glob, unsigned type,
2787				struct event_symbol *syms, unsigned max,
2788				bool name_only)
2789{
2790	unsigned int i, evt_i = 0, evt_num = 0;
2791	char name[MAX_NAME_LEN];
2792	char **evt_list = NULL;
2793	bool evt_num_known = false;
2794
2795restart:
2796	if (evt_num_known) {
2797		evt_list = zalloc(sizeof(char *) * evt_num);
2798		if (!evt_list)
2799			goto out_enomem;
2800		syms -= max;
2801	}
2802
2803	for (i = 0; i < max; i++, syms++) {
2804
2805		if (event_glob != NULL && syms->symbol != NULL &&
2806		    !(strglobmatch(syms->symbol, event_glob) ||
2807		      (syms->alias && strglobmatch(syms->alias, event_glob))))
2808			continue;
2809
2810		if (!is_event_supported(type, i))
2811			continue;
2812
2813		if (!evt_num_known) {
2814			evt_num++;
2815			continue;
2816		}
2817
2818		if (!name_only && strlen(syms->alias))
2819			snprintf(name, MAX_NAME_LEN, "%s OR %s", syms->symbol, syms->alias);
2820		else
2821			strlcpy(name, syms->symbol, MAX_NAME_LEN);
2822
2823		evt_list[evt_i] = strdup(name);
2824		if (evt_list[evt_i] == NULL)
2825			goto out_enomem;
2826		evt_i++;
2827	}
2828
2829	if (!evt_num_known) {
2830		evt_num_known = true;
2831		goto restart;
2832	}
2833	qsort(evt_list, evt_num, sizeof(char *), cmp_string);
2834	evt_i = 0;
2835	while (evt_i < evt_num) {
2836		if (name_only) {
2837			printf("%s ", evt_list[evt_i++]);
2838			continue;
2839		}
2840		printf("  %-50s [%s]\n", evt_list[evt_i++], event_type_descriptors[type]);
2841	}
2842	if (evt_num && pager_in_use())
2843		printf("\n");
2844
2845out_free:
2846	evt_num = evt_i;
2847	for (evt_i = 0; evt_i < evt_num; evt_i++)
2848		zfree(&evt_list[evt_i]);
2849	zfree(&evt_list);
2850	return;
2851
2852out_enomem:
2853	printf("FATAL: not enough memory to print %s\n", event_type_descriptors[type]);
2854	if (evt_list)
2855		goto out_free;
2856}
2857
2858/*
2859 * Print the help text for the event symbols:
2860 */
2861void print_events(const char *event_glob, bool name_only, bool quiet_flag,
2862			bool long_desc, bool details_flag, bool deprecated)
2863{
2864	print_symbol_events(event_glob, PERF_TYPE_HARDWARE,
2865			    event_symbols_hw, PERF_COUNT_HW_MAX, name_only);
2866
2867	print_symbol_events(event_glob, PERF_TYPE_SOFTWARE,
2868			    event_symbols_sw, PERF_COUNT_SW_MAX, name_only);
2869	print_tool_events(event_glob, name_only);
2870
2871	print_hwcache_events(event_glob, name_only);
2872
2873	print_pmu_events(event_glob, name_only, quiet_flag, long_desc,
2874			details_flag, deprecated);
2875
2876	if (event_glob != NULL)
2877		return;
2878
2879	if (!name_only) {
2880		printf("  %-50s [%s]\n",
2881		       "rNNN",
2882		       event_type_descriptors[PERF_TYPE_RAW]);
2883		printf("  %-50s [%s]\n",
2884		       "cpu/t1=v1[,t2=v2,t3 ...]/modifier",
2885		       event_type_descriptors[PERF_TYPE_RAW]);
2886		if (pager_in_use())
2887			printf("   (see 'man perf-list' on how to encode it)\n\n");
2888
2889		printf("  %-50s [%s]\n",
2890		       "mem:<addr>[/len][:access]",
2891			event_type_descriptors[PERF_TYPE_BREAKPOINT]);
2892		if (pager_in_use())
2893			printf("\n");
2894	}
2895
2896	print_tracepoint_events(NULL, NULL, name_only);
2897
2898	print_sdt_events(NULL, NULL, name_only);
2899
2900	metricgroup__print(true, true, NULL, name_only, details_flag);
2901
2902	print_libpfm_events(name_only, long_desc);
2903}
2904
2905int parse_events__is_hardcoded_term(struct parse_events_term *term)
2906{
2907	return term->type_term != PARSE_EVENTS__TERM_TYPE_USER;
2908}
2909
2910static int new_term(struct parse_events_term **_term,
2911		    struct parse_events_term *temp,
2912		    char *str, u64 num)
2913{
2914	struct parse_events_term *term;
2915
2916	term = malloc(sizeof(*term));
2917	if (!term)
2918		return -ENOMEM;
2919
2920	*term = *temp;
2921	INIT_LIST_HEAD(&term->list);
2922	term->weak = false;
2923
2924	switch (term->type_val) {
2925	case PARSE_EVENTS__TERM_TYPE_NUM:
2926		term->val.num = num;
2927		break;
2928	case PARSE_EVENTS__TERM_TYPE_STR:
2929		term->val.str = str;
2930		break;
2931	default:
2932		free(term);
2933		return -EINVAL;
2934	}
2935
2936	*_term = term;
2937	return 0;
2938}
2939
2940int parse_events_term__num(struct parse_events_term **term,
2941			   int type_term, char *config, u64 num,
 
2942			   bool no_value,
2943			   void *loc_term_, void *loc_val_)
2944{
2945	YYLTYPE *loc_term = loc_term_;
2946	YYLTYPE *loc_val = loc_val_;
2947
2948	struct parse_events_term temp = {
2949		.type_val  = PARSE_EVENTS__TERM_TYPE_NUM,
2950		.type_term = type_term,
2951		.config    = config,
2952		.no_value  = no_value,
2953		.err_term  = loc_term ? loc_term->first_column : 0,
2954		.err_val   = loc_val  ? loc_val->first_column  : 0,
2955	};
2956
2957	return new_term(term, &temp, NULL, num);
2958}
2959
2960int parse_events_term__str(struct parse_events_term **term,
2961			   int type_term, char *config, char *str,
 
2962			   void *loc_term_, void *loc_val_)
2963{
2964	YYLTYPE *loc_term = loc_term_;
2965	YYLTYPE *loc_val = loc_val_;
2966
2967	struct parse_events_term temp = {
2968		.type_val  = PARSE_EVENTS__TERM_TYPE_STR,
2969		.type_term = type_term,
2970		.config    = config,
2971		.err_term  = loc_term ? loc_term->first_column : 0,
2972		.err_val   = loc_val  ? loc_val->first_column  : 0,
2973	};
2974
2975	return new_term(term, &temp, str, 0);
2976}
2977
2978int parse_events_term__sym_hw(struct parse_events_term **term,
2979			      char *config, unsigned idx)
 
 
2980{
2981	struct event_symbol *sym;
2982	char *str;
2983	struct parse_events_term temp = {
2984		.type_val  = PARSE_EVENTS__TERM_TYPE_STR,
2985		.type_term = PARSE_EVENTS__TERM_TYPE_USER,
2986		.config    = config,
2987	};
2988
2989	if (!temp.config) {
2990		temp.config = strdup("event");
2991		if (!temp.config)
2992			return -ENOMEM;
2993	}
2994	BUG_ON(idx >= PERF_COUNT_HW_MAX);
2995	sym = &event_symbols_hw[idx];
2996
2997	str = strdup(sym->symbol);
2998	if (!str)
2999		return -ENOMEM;
3000	return new_term(term, &temp, str, 0);
3001}
3002
3003int parse_events_term__clone(struct parse_events_term **new,
3004			     struct parse_events_term *term)
3005{
3006	char *str;
3007	struct parse_events_term temp = {
3008		.type_val  = term->type_val,
3009		.type_term = term->type_term,
3010		.config    = NULL,
3011		.err_term  = term->err_term,
3012		.err_val   = term->err_val,
3013	};
3014
 
3015	if (term->config) {
3016		temp.config = strdup(term->config);
3017		if (!temp.config)
3018			return -ENOMEM;
3019	}
3020	if (term->type_val == PARSE_EVENTS__TERM_TYPE_NUM)
3021		return new_term(new, &temp, NULL, term->val.num);
3022
3023	str = strdup(term->val.str);
3024	if (!str)
 
3025		return -ENOMEM;
3026	return new_term(new, &temp, str, 0);
 
3027}
3028
3029void parse_events_term__delete(struct parse_events_term *term)
3030{
3031	if (term->array.nr_ranges)
3032		zfree(&term->array.ranges);
3033
3034	if (term->type_val != PARSE_EVENTS__TERM_TYPE_NUM)
3035		zfree(&term->val.str);
3036
3037	zfree(&term->config);
3038	free(term);
3039}
3040
3041int parse_events_copy_term_list(struct list_head *old,
3042				 struct list_head **new)
3043{
3044	struct parse_events_term *term, *n;
3045	int ret;
3046
3047	if (!old) {
3048		*new = NULL;
3049		return 0;
3050	}
3051
3052	*new = malloc(sizeof(struct list_head));
3053	if (!*new)
3054		return -ENOMEM;
3055	INIT_LIST_HEAD(*new);
3056
3057	list_for_each_entry (term, old, list) {
3058		ret = parse_events_term__clone(&n, term);
3059		if (ret)
3060			return ret;
3061		list_add_tail(&n->list, *new);
 
3062	}
3063	return 0;
3064}
3065
3066void parse_events_terms__purge(struct list_head *terms)
 
 
 
 
 
3067{
3068	struct parse_events_term *term, *h;
3069
3070	list_for_each_entry_safe(term, h, terms, list) {
3071		list_del_init(&term->list);
3072		parse_events_term__delete(term);
3073	}
3074}
3075
3076void parse_events_terms__delete(struct list_head *terms)
3077{
3078	if (!terms)
3079		return;
3080	parse_events_terms__purge(terms);
3081	free(terms);
3082}
3083
3084void parse_events__clear_array(struct parse_events_array *a)
3085{
3086	zfree(&a->ranges);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3087}
3088
3089void parse_events_evlist_error(struct parse_events_state *parse_state,
3090			       int idx, const char *str)
3091{
3092	if (!parse_state->error)
3093		return;
3094
3095	parse_events__handle_error(parse_state->error, idx, strdup(str), NULL);
3096}
3097
3098static void config_terms_list(char *buf, size_t buf_sz)
3099{
3100	int i;
3101	bool first = true;
3102
3103	buf[0] = '\0';
3104	for (i = 0; i < __PARSE_EVENTS__TERM_TYPE_NR; i++) {
3105		const char *name = config_term_names[i];
3106
3107		if (!config_term_avail(i, NULL))
3108			continue;
3109		if (!name)
3110			continue;
3111		if (name[0] == '<')
3112			continue;
3113
3114		if (strlen(buf) + strlen(name) + 2 >= buf_sz)
3115			return;
3116
3117		if (!first)
3118			strcat(buf, ",");
3119		else
3120			first = false;
3121		strcat(buf, name);
3122	}
3123}
3124
3125/*
3126 * Return string contains valid config terms of an event.
3127 * @additional_terms: For terms such as PMU sysfs terms.
3128 */
3129char *parse_events_formats_error_string(char *additional_terms)
3130{
3131	char *str;
3132	/* "no-overwrite" is the longest name */
3133	char static_terms[__PARSE_EVENTS__TERM_TYPE_NR *
3134			  (sizeof("no-overwrite") - 1)];
3135
3136	config_terms_list(static_terms, sizeof(static_terms));
3137	/* valid terms */
3138	if (additional_terms) {
3139		if (asprintf(&str, "valid terms: %s,%s",
3140			     additional_terms, static_terms) < 0)
3141			goto fail;
3142	} else {
3143		if (asprintf(&str, "valid terms: %s", static_terms) < 0)
3144			goto fail;
3145	}
3146	return str;
3147
3148fail:
3149	return NULL;
3150}