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