]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
361c99a6 ACM |
2 | #ifndef __PERF_EVLIST_H |
3 | #define __PERF_EVLIST_H 1 | |
4 | ||
5c97cac6 | 5 | #include <linux/compiler.h> |
877a7a11 | 6 | #include <linux/kernel.h> |
25a3720c | 7 | #include <linux/refcount.h> |
361c99a6 | 8 | #include <linux/list.h> |
1b85337d | 9 | #include <api/fd/array.h> |
ce9036a6 | 10 | #include <internal/evlist.h> |
515dbe48 | 11 | #include <internal/evsel.h> |
47729258 | 12 | #include "events_stats.h" |
0c21f736 | 13 | #include "evsel.h" |
e0fcfb08 | 14 | #include <pthread.h> |
9607ad3a | 15 | #include <signal.h> |
35b9d88e | 16 | #include <unistd.h> |
361c99a6 | 17 | |
5c581041 | 18 | struct pollfd; |
f8a95309 | 19 | struct thread_map; |
f854839b | 20 | struct perf_cpu_map; |
b4006796 | 21 | struct record_opts; |
5c581041 | 22 | |
e0fcfb08 ACM |
23 | /* |
24 | * State machine of bkw_mmap_state: | |
25 | * | |
26 | * .________________(forbid)_____________. | |
27 | * | V | |
28 | * NOTREADY --(0)--> RUNNING --(1)--> DATA_PENDING --(2)--> EMPTY | |
29 | * ^ ^ | ^ | | |
30 | * | |__(forbid)____/ |___(forbid)___/| | |
31 | * | | | |
32 | * \_________________(3)_______________/ | |
33 | * | |
34 | * NOTREADY : Backward ring buffers are not ready | |
35 | * RUNNING : Backward ring buffers are recording | |
36 | * DATA_PENDING : We are required to collect data from backward ring buffers | |
37 | * EMPTY : We have collected data from backward ring buffers. | |
38 | * | |
39 | * (0): Setup backward ring buffer | |
40 | * (1): Pause ring buffers for reading | |
41 | * (2): Read from ring buffers | |
42 | * (3): Resume ring buffers for recording | |
43 | */ | |
44 | enum bkw_mmap_state { | |
45 | BKW_MMAP_NOTREADY, | |
46 | BKW_MMAP_RUNNING, | |
47 | BKW_MMAP_DATA_PENDING, | |
48 | BKW_MMAP_EMPTY, | |
49 | }; | |
50 | ||
63503dba | 51 | struct evlist { |
ce9036a6 | 52 | struct perf_evlist core; |
97f63e4a | 53 | int nr_groups; |
2b56bcfb | 54 | bool enabled; |
75562573 AH |
55 | int id_pos; |
56 | int is_pos; | |
57 | u64 combined_sample_type; | |
54cc54de | 58 | enum bkw_mmap_state bkw_mmap_state; |
35b9d88e ACM |
59 | struct { |
60 | int cork_fd; | |
61 | pid_t pid; | |
62 | } workload; | |
a5830532 JO |
63 | struct mmap *mmap; |
64 | struct mmap *overwrite_mmap; | |
32dcd021 | 65 | struct evsel *selected; |
75be989a | 66 | struct events_stats stats; |
2c07144d | 67 | struct perf_env *env; |
63503dba | 68 | void (*trace_event_sample_raw)(struct evlist *evlist, |
93115d32 TR |
69 | union perf_event *event, |
70 | struct perf_sample *sample); | |
6011518d JY |
71 | u64 first_sample_time; |
72 | u64 last_sample_time; | |
657ee553 SL |
73 | struct { |
74 | pthread_t th; | |
75 | volatile int done; | |
76 | } thread; | |
361c99a6 ACM |
77 | }; |
78 | ||
32dcd021 | 79 | struct evsel_str_handler { |
ee29be62 ACM |
80 | const char *name; |
81 | void *handler; | |
82 | }; | |
83 | ||
0f98b11c | 84 | struct evlist *evlist__new(void); |
63503dba JO |
85 | struct evlist *perf_evlist__new_default(void); |
86 | struct evlist *perf_evlist__new_dummy(void); | |
52c86bca JO |
87 | void evlist__init(struct evlist *evlist, struct perf_cpu_map *cpus, |
88 | struct perf_thread_map *threads); | |
470579b0 | 89 | void evlist__exit(struct evlist *evlist); |
c12995a5 | 90 | void evlist__delete(struct evlist *evlist); |
361c99a6 | 91 | |
a1cf3a75 | 92 | void evlist__add(struct evlist *evlist, struct evsel *entry); |
16251027 | 93 | void evlist__remove(struct evlist *evlist, struct evsel *evsel); |
db918acb | 94 | |
63503dba | 95 | int __perf_evlist__add_default(struct evlist *evlist, bool precise); |
db918acb | 96 | |
63503dba | 97 | static inline int perf_evlist__add_default(struct evlist *evlist) |
db918acb ACM |
98 | { |
99 | return __perf_evlist__add_default(evlist, true); | |
100 | } | |
101 | ||
63503dba | 102 | int __perf_evlist__add_default_attrs(struct evlist *evlist, |
79695e1b | 103 | struct perf_event_attr *attrs, size_t nr_attrs); |
e60fc847 | 104 | |
79695e1b ACM |
105 | #define perf_evlist__add_default_attrs(evlist, array) \ |
106 | __perf_evlist__add_default_attrs(evlist, array, ARRAY_SIZE(array)) | |
361c99a6 | 107 | |
63503dba | 108 | int perf_evlist__add_dummy(struct evlist *evlist); |
5bae0250 | 109 | |
63503dba | 110 | int perf_evlist__add_sb_event(struct evlist **evlist, |
657ee553 SL |
111 | struct perf_event_attr *attr, |
112 | perf_evsel__sb_cb_t cb, | |
113 | void *data); | |
63503dba | 114 | int perf_evlist__start_sb_thread(struct evlist *evlist, |
657ee553 | 115 | struct target *target); |
63503dba | 116 | void perf_evlist__stop_sb_thread(struct evlist *evlist); |
657ee553 | 117 | |
63503dba | 118 | int perf_evlist__add_newtp(struct evlist *evlist, |
39876e7d ACM |
119 | const char *sys, const char *name, void *handler); |
120 | ||
c0e53476 ACM |
121 | int __evlist__set_tracepoints_handlers(struct evlist *evlist, |
122 | const struct evsel_str_handler *assocs, | |
123 | size_t nr_assocs); | |
124 | ||
125 | #define evlist__set_tracepoints_handlers(evlist, array) \ | |
126 | __evlist__set_tracepoints_handlers(evlist, array, ARRAY_SIZE(array)) | |
127 | ||
63503dba | 128 | void __perf_evlist__set_sample_bit(struct evlist *evlist, |
22c8a376 | 129 | enum perf_event_sample_format bit); |
63503dba | 130 | void __perf_evlist__reset_sample_bit(struct evlist *evlist, |
22c8a376 ACM |
131 | enum perf_event_sample_format bit); |
132 | ||
133 | #define perf_evlist__set_sample_bit(evlist, bit) \ | |
134 | __perf_evlist__set_sample_bit(evlist, PERF_SAMPLE_##bit) | |
135 | ||
136 | #define perf_evlist__reset_sample_bit(evlist, bit) \ | |
137 | __perf_evlist__reset_sample_bit(evlist, PERF_SAMPLE_##bit) | |
138 | ||
63503dba JO |
139 | int perf_evlist__set_tp_filter(struct evlist *evlist, const char *filter); |
140 | int perf_evlist__set_tp_filter_pid(struct evlist *evlist, pid_t pid); | |
141 | int perf_evlist__set_tp_filter_pids(struct evlist *evlist, size_t npids, pid_t *pids); | |
745cefc5 | 142 | |
53c92f73 ACM |
143 | int perf_evlist__append_tp_filter(struct evlist *evlist, const char *filter); |
144 | ||
32dcd021 | 145 | struct evsel * |
63503dba | 146 | perf_evlist__find_tracepoint_by_id(struct evlist *evlist, int id); |
da378962 | 147 | |
32dcd021 | 148 | struct evsel * |
63503dba | 149 | perf_evlist__find_tracepoint_by_name(struct evlist *evlist, |
a2f2804a DA |
150 | const char *name); |
151 | ||
f4009e7b JO |
152 | int evlist__add_pollfd(struct evlist *evlist, int fd); |
153 | int evlist__filter_pollfd(struct evlist *evlist, short revents_and_mask); | |
1ddec7f0 | 154 | |
80ab2987 | 155 | int evlist__poll(struct evlist *evlist, int timeout); |
f66a889d | 156 | |
63503dba JO |
157 | struct evsel *perf_evlist__id2evsel(struct evlist *evlist, u64 id); |
158 | struct evsel *perf_evlist__id2evsel_strict(struct evlist *evlist, | |
dddcf6ab | 159 | u64 id); |
70db7533 | 160 | |
63503dba | 161 | struct perf_sample_id *perf_evlist__id2sid(struct evlist *evlist, u64 id); |
932a3594 | 162 | |
63503dba | 163 | void perf_evlist__toggle_bkw_mmap(struct evlist *evlist, enum bkw_mmap_state state); |
54cc54de | 164 | |
9521b5f2 | 165 | void evlist__mmap_consume(struct evlist *evlist, int idx); |
8e50d384 | 166 | |
474ddc4c | 167 | int evlist__open(struct evlist *evlist); |
750b4ede | 168 | void evlist__close(struct evlist *evlist); |
727ab04e | 169 | |
e68ae9cf ACM |
170 | struct callchain_param; |
171 | ||
63503dba | 172 | void perf_evlist__set_id_pos(struct evlist *evlist); |
75562573 | 173 | bool perf_can_sample_identifier(void); |
b757bb09 | 174 | bool perf_can_record_switch_events(void); |
83509565 | 175 | bool perf_can_record_cpu_wide(void); |
63503dba | 176 | void perf_evlist__config(struct evlist *evlist, struct record_opts *opts, |
e68ae9cf | 177 | struct callchain_param *callchain); |
b4006796 | 178 | int record_opts__config(struct record_opts *opts); |
0f82ebc4 | 179 | |
63503dba | 180 | int perf_evlist__prepare_workload(struct evlist *evlist, |
602ad878 | 181 | struct target *target, |
55e162ea | 182 | const char *argv[], bool pipe_output, |
735f7e0b ACM |
183 | void (*exec_error)(int signo, siginfo_t *info, |
184 | void *ucontext)); | |
63503dba | 185 | int perf_evlist__start_workload(struct evlist *evlist); |
35b9d88e | 186 | |
724ce97e ACM |
187 | struct option; |
188 | ||
e9db1310 | 189 | int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages, const char *str); |
994a1f78 JO |
190 | int perf_evlist__parse_mmap_pages(const struct option *opt, |
191 | const char *str, | |
192 | int unset); | |
193 | ||
f5e7150c ACM |
194 | unsigned long perf_event_mlock_kb_in_pages(void); |
195 | ||
9521b5f2 | 196 | int evlist__mmap_ex(struct evlist *evlist, unsigned int pages, |
7a276ff6 | 197 | unsigned int auxtrace_pages, |
470530bb | 198 | bool auxtrace_overwrite, int nr_cblocks, |
51255a8a | 199 | int affinity, int flush, int comp_level); |
9521b5f2 | 200 | int evlist__mmap(struct evlist *evlist, unsigned int pages); |
db6b7b13 | 201 | void evlist__munmap(struct evlist *evlist); |
7e2ed097 | 202 | |
9521b5f2 | 203 | size_t evlist__mmap_size(unsigned long pages); |
0c582449 | 204 | |
e74676de | 205 | void evlist__disable(struct evlist *evlist); |
1c87f165 | 206 | void evlist__enable(struct evlist *evlist); |
63503dba | 207 | void perf_evlist__toggle_enable(struct evlist *evlist); |
4152ab37 | 208 | |
63503dba | 209 | int perf_evlist__enable_event_idx(struct evlist *evlist, |
32dcd021 | 210 | struct evsel *evsel, int idx); |
395c3070 | 211 | |
63503dba | 212 | void perf_evlist__set_selected(struct evlist *evlist, |
32dcd021 | 213 | struct evsel *evsel); |
81cce8de | 214 | |
63503dba JO |
215 | int perf_evlist__create_maps(struct evlist *evlist, struct target *target); |
216 | int perf_evlist__apply_filters(struct evlist *evlist, struct evsel **err_evsel); | |
f8a95309 | 217 | |
63dab225 | 218 | void __perf_evlist__set_leader(struct list_head *list); |
63503dba | 219 | void perf_evlist__set_leader(struct evlist *evlist); |
63dab225 | 220 | |
63503dba JO |
221 | u64 __perf_evlist__combined_sample_type(struct evlist *evlist); |
222 | u64 perf_evlist__combined_sample_type(struct evlist *evlist); | |
223 | u64 perf_evlist__combined_branch_type(struct evlist *evlist); | |
224 | bool perf_evlist__sample_id_all(struct evlist *evlist); | |
225 | u16 perf_evlist__id_hdr_size(struct evlist *evlist); | |
74429964 | 226 | |
63503dba | 227 | int perf_evlist__parse_sample(struct evlist *evlist, union perf_event *event, |
0807d2d8 | 228 | struct perf_sample *sample); |
cb0b29e0 | 229 | |
63503dba | 230 | int perf_evlist__parse_sample_timestamp(struct evlist *evlist, |
01468120 JO |
231 | union perf_event *event, |
232 | u64 *timestamp); | |
233 | ||
63503dba JO |
234 | bool perf_evlist__valid_sample_type(struct evlist *evlist); |
235 | bool perf_evlist__valid_sample_id_all(struct evlist *evlist); | |
236 | bool perf_evlist__valid_read_format(struct evlist *evlist); | |
0529bc1f | 237 | |
63503dba | 238 | void perf_evlist__splice_list_tail(struct evlist *evlist, |
f114d6ef | 239 | struct list_head *list); |
0c21f736 | 240 | |
63503dba | 241 | static inline bool perf_evlist__empty(struct evlist *evlist) |
64831a21 | 242 | { |
ce9036a6 | 243 | return list_empty(&evlist->core.entries); |
64831a21 DCC |
244 | } |
245 | ||
515dbe48 | 246 | static inline struct evsel *evlist__first(struct evlist *evlist) |
0c21f736 | 247 | { |
515dbe48 JO |
248 | struct perf_evsel *evsel = perf_evlist__first(&evlist->core); |
249 | ||
250 | return container_of(evsel, struct evsel, core); | |
0c21f736 ACM |
251 | } |
252 | ||
515dbe48 | 253 | static inline struct evsel *evlist__last(struct evlist *evlist) |
0c21f736 | 254 | { |
515dbe48 JO |
255 | struct perf_evsel *evsel = perf_evlist__last(&evlist->core); |
256 | ||
257 | return container_of(evsel, struct evsel, core); | |
0c21f736 | 258 | } |
78f067b3 | 259 | |
63503dba JO |
260 | int perf_evlist__strerror_open(struct evlist *evlist, int err, char *buf, size_t size); |
261 | int perf_evlist__strerror_mmap(struct evlist *evlist, int err, char *buf, size_t size); | |
6ef068cb | 262 | |
63503dba JO |
263 | bool perf_evlist__can_select_event(struct evlist *evlist, const char *str); |
264 | void perf_evlist__to_front(struct evlist *evlist, | |
32dcd021 | 265 | struct evsel *move_evsel); |
a025e4f0 | 266 | |
0050f7aa | 267 | /** |
e5cadb93 | 268 | * __evlist__for_each_entry - iterate thru all the evsels |
0050f7aa ACM |
269 | * @list: list_head instance to iterate |
270 | * @evsel: struct evsel iterator | |
271 | */ | |
e5cadb93 | 272 | #define __evlist__for_each_entry(list, evsel) \ |
b27c4ece | 273 | list_for_each_entry(evsel, list, core.node) |
0050f7aa ACM |
274 | |
275 | /** | |
e5cadb93 | 276 | * evlist__for_each_entry - iterate thru all the evsels |
0050f7aa ACM |
277 | * @evlist: evlist instance to iterate |
278 | * @evsel: struct evsel iterator | |
279 | */ | |
e5cadb93 | 280 | #define evlist__for_each_entry(evlist, evsel) \ |
ce9036a6 | 281 | __evlist__for_each_entry(&(evlist)->core.entries, evsel) |
0050f7aa ACM |
282 | |
283 | /** | |
e5cadb93 | 284 | * __evlist__for_each_entry_continue - continue iteration thru all the evsels |
0050f7aa ACM |
285 | * @list: list_head instance to iterate |
286 | * @evsel: struct evsel iterator | |
287 | */ | |
e5cadb93 | 288 | #define __evlist__for_each_entry_continue(list, evsel) \ |
b27c4ece | 289 | list_for_each_entry_continue(evsel, list, core.node) |
0050f7aa ACM |
290 | |
291 | /** | |
e5cadb93 | 292 | * evlist__for_each_entry_continue - continue iteration thru all the evsels |
0050f7aa ACM |
293 | * @evlist: evlist instance to iterate |
294 | * @evsel: struct evsel iterator | |
295 | */ | |
e5cadb93 | 296 | #define evlist__for_each_entry_continue(evlist, evsel) \ |
ce9036a6 | 297 | __evlist__for_each_entry_continue(&(evlist)->core.entries, evsel) |
0050f7aa ACM |
298 | |
299 | /** | |
e5cadb93 | 300 | * __evlist__for_each_entry_reverse - iterate thru all the evsels in reverse order |
0050f7aa ACM |
301 | * @list: list_head instance to iterate |
302 | * @evsel: struct evsel iterator | |
303 | */ | |
e5cadb93 | 304 | #define __evlist__for_each_entry_reverse(list, evsel) \ |
b27c4ece | 305 | list_for_each_entry_reverse(evsel, list, core.node) |
0050f7aa ACM |
306 | |
307 | /** | |
e5cadb93 | 308 | * evlist__for_each_entry_reverse - iterate thru all the evsels in reverse order |
0050f7aa ACM |
309 | * @evlist: evlist instance to iterate |
310 | * @evsel: struct evsel iterator | |
311 | */ | |
e5cadb93 | 312 | #define evlist__for_each_entry_reverse(evlist, evsel) \ |
ce9036a6 | 313 | __evlist__for_each_entry_reverse(&(evlist)->core.entries, evsel) |
0050f7aa ACM |
314 | |
315 | /** | |
e5cadb93 | 316 | * __evlist__for_each_entry_safe - safely iterate thru all the evsels |
0050f7aa ACM |
317 | * @list: list_head instance to iterate |
318 | * @tmp: struct evsel temp iterator | |
319 | * @evsel: struct evsel iterator | |
320 | */ | |
e5cadb93 | 321 | #define __evlist__for_each_entry_safe(list, tmp, evsel) \ |
b27c4ece | 322 | list_for_each_entry_safe(evsel, tmp, list, core.node) |
0050f7aa ACM |
323 | |
324 | /** | |
e5cadb93 | 325 | * evlist__for_each_entry_safe - safely iterate thru all the evsels |
0050f7aa ACM |
326 | * @evlist: evlist instance to iterate |
327 | * @evsel: struct evsel iterator | |
328 | * @tmp: struct evsel temp iterator | |
329 | */ | |
e5cadb93 | 330 | #define evlist__for_each_entry_safe(evlist, tmp, evsel) \ |
ce9036a6 | 331 | __evlist__for_each_entry_safe(&(evlist)->core.entries, tmp, evsel) |
c09ec622 | 332 | |
63503dba | 333 | void perf_evlist__set_tracking_event(struct evlist *evlist, |
32dcd021 | 334 | struct evsel *tracking_evsel); |
45cf6c33 | 335 | |
32dcd021 | 336 | struct evsel * |
63503dba | 337 | perf_evlist__find_evsel_by_str(struct evlist *evlist, const char *str); |
7cb5c5ac | 338 | |
63503dba | 339 | struct evsel *perf_evlist__event2evsel(struct evlist *evlist, |
7cb5c5ac | 340 | union perf_event *event); |
07d6f446 | 341 | |
63503dba | 342 | bool perf_evlist__exclude_kernel(struct evlist *evlist); |
e2bdbe80 | 343 | |
63503dba | 344 | void perf_evlist__force_leader(struct evlist *evlist); |
e2bdbe80 | 345 | |
63503dba | 346 | struct evsel *perf_evlist__reset_weak_group(struct evlist *evlist, |
32dcd021 | 347 | struct evsel *evsel); |
361c99a6 | 348 | #endif /* __PERF_EVLIST_H */ |