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