1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __PERF_PARSE_EVENTS_H
3 #define __PERF_PARSE_EVENTS_H
5 * Parse symbolic events/counts passed in as options:
8 #include <linux/list.h>
10 #include <linux/types.h>
11 #include <linux/perf_event.h>
17 struct parse_events_error
;
21 struct tracepoint_path
{
24 struct tracepoint_path
*next
;
27 struct tracepoint_path
*tracepoint_id_to_path(u64 config
);
28 struct tracepoint_path
*tracepoint_name_to_path(const char *name
);
29 bool have_tracepoints(struct list_head
*evlist
);
31 const char *event_type(int type
);
33 int parse_events_option(const struct option
*opt
, const char *str
, int unset
);
34 int parse_events(struct perf_evlist
*evlist
, const char *str
,
35 struct parse_events_error
*error
);
36 int parse_events_terms(struct list_head
*terms
, const char *str
);
37 int parse_filter(const struct option
*opt
, const char *str
, int unset
);
38 int exclude_perf(const struct option
*opt
, const char *arg
, int unset
);
40 #define EVENTS_HELP_MAX (128*1024)
42 enum perf_pmu_event_symbol_type
{
43 PMU_EVENT_SYMBOL_ERR
, /* not a PMU EVENT */
44 PMU_EVENT_SYMBOL
, /* normal style PMU event */
45 PMU_EVENT_SYMBOL_PREFIX
, /* prefix of pre-suf style event */
46 PMU_EVENT_SYMBOL_SUFFIX
, /* suffix of pre-suf style event */
49 struct perf_pmu_event_symbol
{
51 enum perf_pmu_event_symbol_type type
;
55 PARSE_EVENTS__TERM_TYPE_NUM
,
56 PARSE_EVENTS__TERM_TYPE_STR
,
60 PARSE_EVENTS__TERM_TYPE_USER
,
61 PARSE_EVENTS__TERM_TYPE_CONFIG
,
62 PARSE_EVENTS__TERM_TYPE_CONFIG1
,
63 PARSE_EVENTS__TERM_TYPE_CONFIG2
,
64 PARSE_EVENTS__TERM_TYPE_NAME
,
65 PARSE_EVENTS__TERM_TYPE_SAMPLE_PERIOD
,
66 PARSE_EVENTS__TERM_TYPE_SAMPLE_FREQ
,
67 PARSE_EVENTS__TERM_TYPE_BRANCH_SAMPLE_TYPE
,
68 PARSE_EVENTS__TERM_TYPE_TIME
,
69 PARSE_EVENTS__TERM_TYPE_CALLGRAPH
,
70 PARSE_EVENTS__TERM_TYPE_STACKSIZE
,
71 PARSE_EVENTS__TERM_TYPE_NOINHERIT
,
72 PARSE_EVENTS__TERM_TYPE_INHERIT
,
73 PARSE_EVENTS__TERM_TYPE_MAX_STACK
,
74 PARSE_EVENTS__TERM_TYPE_MAX_EVENTS
,
75 PARSE_EVENTS__TERM_TYPE_NOOVERWRITE
,
76 PARSE_EVENTS__TERM_TYPE_OVERWRITE
,
77 PARSE_EVENTS__TERM_TYPE_DRV_CFG
,
78 __PARSE_EVENTS__TERM_TYPE_NR
,
81 struct parse_events_array
{
89 struct parse_events_term
{
91 struct parse_events_array array
;
98 struct list_head list
;
102 /* error string indexes for within parsed string */
106 /* Coming from implicit alias */
110 struct parse_events_error
{
111 int idx
; /* index in the parsed string */
112 char *str
; /* string to display at the index */
113 char *help
; /* optional help string */
116 struct parse_events_state
{
117 struct list_head list
;
120 struct parse_events_error
*error
;
121 struct perf_evlist
*evlist
;
122 struct list_head
*terms
;
125 void parse_events__shrink_config_terms(void);
126 int parse_events__is_hardcoded_term(struct parse_events_term
*term
);
127 int parse_events_term__num(struct parse_events_term
**term
,
128 int type_term
, char *config
, u64 num
,
130 void *loc_term
, void *loc_val
);
131 int parse_events_term__str(struct parse_events_term
**term
,
132 int type_term
, char *config
, char *str
,
133 void *loc_term
, void *loc_val
);
134 int parse_events_term__sym_hw(struct parse_events_term
**term
,
135 char *config
, unsigned idx
);
136 int parse_events_term__clone(struct parse_events_term
**new,
137 struct parse_events_term
*term
);
138 void parse_events_terms__delete(struct list_head
*terms
);
139 void parse_events_terms__purge(struct list_head
*terms
);
140 void parse_events__clear_array(struct parse_events_array
*a
);
141 int parse_events__modifier_event(struct list_head
*list
, char *str
, bool add
);
142 int parse_events__modifier_group(struct list_head
*list
, char *event_mod
);
143 int parse_events_name(struct list_head
*list
, char *name
);
144 int parse_events_add_tracepoint(struct list_head
*list
, int *idx
,
145 const char *sys
, const char *event
,
146 struct parse_events_error
*error
,
147 struct list_head
*head_config
);
148 int parse_events_load_bpf(struct parse_events_state
*parse_state
,
149 struct list_head
*list
,
152 struct list_head
*head_config
);
153 /* Provide this function for perf test */
155 int parse_events_load_bpf_obj(struct parse_events_state
*parse_state
,
156 struct list_head
*list
,
157 struct bpf_object
*obj
,
158 struct list_head
*head_config
);
159 int parse_events_add_numeric(struct parse_events_state
*parse_state
,
160 struct list_head
*list
,
161 u32 type
, u64 config
,
162 struct list_head
*head_config
);
163 enum perf_tool_event
;
164 int parse_events_add_tool(struct parse_events_state
*parse_state
,
165 struct list_head
*list
,
166 enum perf_tool_event tool_event
);
167 int parse_events_add_cache(struct list_head
*list
, int *idx
,
168 char *type
, char *op_result1
, char *op_result2
,
169 struct parse_events_error
*error
,
170 struct list_head
*head_config
);
171 int parse_events_add_breakpoint(struct list_head
*list
, int *idx
,
172 void *ptr
, char *type
, u64 len
);
173 int parse_events_add_pmu(struct parse_events_state
*parse_state
,
174 struct list_head
*list
, char *name
,
175 struct list_head
*head_config
,
176 bool auto_merge_stats
,
179 int parse_events_multi_pmu_add(struct parse_events_state
*parse_state
,
181 struct list_head
**listp
);
183 int parse_events_copy_term_list(struct list_head
*old
,
184 struct list_head
**new);
186 enum perf_pmu_event_symbol_type
187 perf_pmu__parse_check(const char *name
);
188 void parse_events__set_leader(char *name
, struct list_head
*list
,
189 struct parse_events_state
*parse_state
);
190 void parse_events_update_lists(struct list_head
*list_event
,
191 struct list_head
*list_all
);
192 void parse_events_evlist_error(struct parse_events_state
*parse_state
,
193 int idx
, const char *str
);
195 void print_events(const char *event_glob
, bool name_only
, bool quiet
,
196 bool long_desc
, bool details_flag
);
198 struct event_symbol
{
202 extern struct event_symbol event_symbols_hw
[];
203 extern struct event_symbol event_symbols_sw
[];
204 void print_symbol_events(const char *event_glob
, unsigned type
,
205 struct event_symbol
*syms
, unsigned max
,
207 void print_tool_events(const char *event_glob
, bool name_only
);
208 void print_tracepoint_events(const char *subsys_glob
, const char *event_glob
,
210 int print_hwcache_events(const char *event_glob
, bool name_only
);
211 void print_sdt_events(const char *subsys_glob
, const char *event_glob
,
213 int is_valid_tracepoint(const char *event_string
);
215 int valid_event_mount(const char *eventfs
);
216 char *parse_events_formats_error_string(char *additional_terms
);
218 void parse_events_print_error(struct parse_events_error
*err
,
221 #ifdef HAVE_LIBELF_SUPPORT
223 * If the probe point starts with '%',
224 * or starts with "sdt_" and has a ':' but no '=',
225 * then it should be a SDT/cached probe point.
227 static inline bool is_sdt_event(char *str
)
229 return (str
[0] == '%' ||
230 (!strncmp(str
, "sdt_", 4) &&
231 !!strchr(str
, ':') && !strchr(str
, '=')));
234 static inline bool is_sdt_event(char *str __maybe_unused
)
238 #endif /* HAVE_LIBELF_SUPPORT */
240 #endif /* __PERF_PARSE_EVENTS_H */