1 #ifndef __PERF_EVLIST_H
2 #define __PERF_EVLIST_H 1
4 #include <linux/atomic.h>
5 #include <linux/list.h>
6 #include <api/fd/array.h>
20 #define PERF_EVLIST__HLIST_BITS 8
21 #define PERF_EVLIST__HLIST_SIZE (1 << PERF_EVLIST__HLIST_BITS)
24 * struct perf_mmap - perf's ring buffer mmap details
26 * @refcnt - e.g. code using PERF_EVENT_IOC_SET_OUTPUT to share this
33 struct auxtrace_mmap auxtrace_mmap
;
34 char event_copy
[PERF_SAMPLE_MAX_SIZE
] __attribute__((aligned(8)));
38 struct list_head entries
;
39 struct hlist_head heads
[PERF_EVLIST__HLIST_SIZE
];
49 u64 combined_sample_type
;
54 struct fdarray pollfd
;
55 struct perf_mmap
*mmap
;
56 struct thread_map
*threads
;
58 struct perf_evsel
*selected
;
59 struct events_stats stats
;
63 struct perf_evsel_str_handler
{
68 struct perf_evlist
*perf_evlist__new(void);
69 struct perf_evlist
*perf_evlist__new_default(void);
70 struct perf_evlist
*perf_evlist__new_dummy(void);
71 void perf_evlist__init(struct perf_evlist
*evlist
, struct cpu_map
*cpus
,
72 struct thread_map
*threads
);
73 void perf_evlist__exit(struct perf_evlist
*evlist
);
74 void perf_evlist__delete(struct perf_evlist
*evlist
);
76 void perf_evlist__add(struct perf_evlist
*evlist
, struct perf_evsel
*entry
);
77 void perf_evlist__remove(struct perf_evlist
*evlist
, struct perf_evsel
*evsel
);
78 int perf_evlist__add_default(struct perf_evlist
*evlist
);
79 int __perf_evlist__add_default_attrs(struct perf_evlist
*evlist
,
80 struct perf_event_attr
*attrs
, size_t nr_attrs
);
82 #define perf_evlist__add_default_attrs(evlist, array) \
83 __perf_evlist__add_default_attrs(evlist, array, ARRAY_SIZE(array))
85 int perf_evlist__add_dummy(struct perf_evlist
*evlist
);
87 int perf_evlist__add_newtp(struct perf_evlist
*evlist
,
88 const char *sys
, const char *name
, void *handler
);
90 void __perf_evlist__set_sample_bit(struct perf_evlist
*evlist
,
91 enum perf_event_sample_format bit
);
92 void __perf_evlist__reset_sample_bit(struct perf_evlist
*evlist
,
93 enum perf_event_sample_format bit
);
95 #define perf_evlist__set_sample_bit(evlist, bit) \
96 __perf_evlist__set_sample_bit(evlist, PERF_SAMPLE_##bit)
98 #define perf_evlist__reset_sample_bit(evlist, bit) \
99 __perf_evlist__reset_sample_bit(evlist, PERF_SAMPLE_##bit)
101 int perf_evlist__set_filter(struct perf_evlist
*evlist
, const char *filter
);
102 int perf_evlist__set_filter_pid(struct perf_evlist
*evlist
, pid_t pid
);
103 int perf_evlist__set_filter_pids(struct perf_evlist
*evlist
, size_t npids
, pid_t
*pids
);
106 perf_evlist__find_tracepoint_by_id(struct perf_evlist
*evlist
, int id
);
109 perf_evlist__find_tracepoint_by_name(struct perf_evlist
*evlist
,
112 void perf_evlist__id_add(struct perf_evlist
*evlist
, struct perf_evsel
*evsel
,
113 int cpu
, int thread
, u64 id
);
114 int perf_evlist__id_add_fd(struct perf_evlist
*evlist
,
115 struct perf_evsel
*evsel
,
116 int cpu
, int thread
, int fd
);
118 int perf_evlist__add_pollfd(struct perf_evlist
*evlist
, int fd
);
119 int perf_evlist__alloc_pollfd(struct perf_evlist
*evlist
);
120 int perf_evlist__filter_pollfd(struct perf_evlist
*evlist
, short revents_and_mask
);
122 int perf_evlist__poll(struct perf_evlist
*evlist
, int timeout
);
124 struct perf_evsel
*perf_evlist__id2evsel(struct perf_evlist
*evlist
, u64 id
);
125 struct perf_evsel
*perf_evlist__id2evsel_strict(struct perf_evlist
*evlist
,
128 struct perf_sample_id
*perf_evlist__id2sid(struct perf_evlist
*evlist
, u64 id
);
130 union perf_event
*perf_evlist__mmap_read(struct perf_evlist
*evlist
, int idx
);
132 union perf_event
*perf_evlist__mmap_read_backward(struct perf_evlist
*evlist
,
134 void perf_evlist__mmap_read_catchup(struct perf_evlist
*evlist
, int idx
);
136 void perf_evlist__mmap_consume(struct perf_evlist
*evlist
, int idx
);
138 int perf_evlist__open(struct perf_evlist
*evlist
);
139 void perf_evlist__close(struct perf_evlist
*evlist
);
141 struct callchain_param
;
143 void perf_evlist__set_id_pos(struct perf_evlist
*evlist
);
144 bool perf_can_sample_identifier(void);
145 bool perf_can_record_switch_events(void);
146 bool perf_can_record_cpu_wide(void);
147 void perf_evlist__config(struct perf_evlist
*evlist
, struct record_opts
*opts
,
148 struct callchain_param
*callchain
);
149 int record_opts__config(struct record_opts
*opts
);
151 int perf_evlist__prepare_workload(struct perf_evlist
*evlist
,
152 struct target
*target
,
153 const char *argv
[], bool pipe_output
,
154 void (*exec_error
)(int signo
, siginfo_t
*info
,
156 int perf_evlist__start_workload(struct perf_evlist
*evlist
);
160 int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages
, const char *str
);
161 int perf_evlist__parse_mmap_pages(const struct option
*opt
,
165 unsigned long perf_event_mlock_kb_in_pages(void);
167 int perf_evlist__mmap_ex(struct perf_evlist
*evlist
, unsigned int pages
,
168 bool overwrite
, unsigned int auxtrace_pages
,
169 bool auxtrace_overwrite
);
170 int perf_evlist__mmap(struct perf_evlist
*evlist
, unsigned int pages
,
172 void perf_evlist__munmap(struct perf_evlist
*evlist
);
174 void perf_evlist__disable(struct perf_evlist
*evlist
);
175 void perf_evlist__enable(struct perf_evlist
*evlist
);
176 void perf_evlist__toggle_enable(struct perf_evlist
*evlist
);
178 int perf_evlist__enable_event_idx(struct perf_evlist
*evlist
,
179 struct perf_evsel
*evsel
, int idx
);
181 void perf_evlist__set_selected(struct perf_evlist
*evlist
,
182 struct perf_evsel
*evsel
);
184 void perf_evlist__set_maps(struct perf_evlist
*evlist
, struct cpu_map
*cpus
,
185 struct thread_map
*threads
);
186 int perf_evlist__create_maps(struct perf_evlist
*evlist
, struct target
*target
);
187 int perf_evlist__apply_filters(struct perf_evlist
*evlist
, struct perf_evsel
**err_evsel
);
189 void __perf_evlist__set_leader(struct list_head
*list
);
190 void perf_evlist__set_leader(struct perf_evlist
*evlist
);
192 u64
perf_evlist__read_format(struct perf_evlist
*evlist
);
193 u64
__perf_evlist__combined_sample_type(struct perf_evlist
*evlist
);
194 u64
perf_evlist__combined_sample_type(struct perf_evlist
*evlist
);
195 u64
perf_evlist__combined_branch_type(struct perf_evlist
*evlist
);
196 bool perf_evlist__sample_id_all(struct perf_evlist
*evlist
);
197 u16
perf_evlist__id_hdr_size(struct perf_evlist
*evlist
);
199 int perf_evlist__parse_sample(struct perf_evlist
*evlist
, union perf_event
*event
,
200 struct perf_sample
*sample
);
202 bool perf_evlist__valid_sample_type(struct perf_evlist
*evlist
);
203 bool perf_evlist__valid_sample_id_all(struct perf_evlist
*evlist
);
204 bool perf_evlist__valid_read_format(struct perf_evlist
*evlist
);
206 void perf_evlist__splice_list_tail(struct perf_evlist
*evlist
,
207 struct list_head
*list
);
209 static inline struct perf_evsel
*perf_evlist__first(struct perf_evlist
*evlist
)
211 return list_entry(evlist
->entries
.next
, struct perf_evsel
, node
);
214 static inline struct perf_evsel
*perf_evlist__last(struct perf_evlist
*evlist
)
216 return list_entry(evlist
->entries
.prev
, struct perf_evsel
, node
);
219 size_t perf_evlist__fprintf(struct perf_evlist
*evlist
, FILE *fp
);
221 int perf_evlist__strerror_open(struct perf_evlist
*evlist
, int err
, char *buf
, size_t size
);
222 int perf_evlist__strerror_mmap(struct perf_evlist
*evlist
, int err
, char *buf
, size_t size
);
224 static inline u64
perf_mmap__read_head(struct perf_mmap
*mm
)
226 struct perf_event_mmap_page
*pc
= mm
->base
;
227 u64 head
= ACCESS_ONCE(pc
->data_head
);
232 static inline void perf_mmap__write_tail(struct perf_mmap
*md
, u64 tail
)
234 struct perf_event_mmap_page
*pc
= md
->base
;
237 * ensure all reads are done before we write the tail out.
240 pc
->data_tail
= tail
;
243 bool perf_evlist__can_select_event(struct perf_evlist
*evlist
, const char *str
);
244 void perf_evlist__to_front(struct perf_evlist
*evlist
,
245 struct perf_evsel
*move_evsel
);
248 * __evlist__for_each - iterate thru all the evsels
249 * @list: list_head instance to iterate
250 * @evsel: struct evsel iterator
252 #define __evlist__for_each(list, evsel) \
253 list_for_each_entry(evsel, list, node)
256 * evlist__for_each - iterate thru all the evsels
257 * @evlist: evlist instance to iterate
258 * @evsel: struct evsel iterator
260 #define evlist__for_each(evlist, evsel) \
261 __evlist__for_each(&(evlist)->entries, evsel)
264 * __evlist__for_each_continue - continue iteration thru all the evsels
265 * @list: list_head instance to iterate
266 * @evsel: struct evsel iterator
268 #define __evlist__for_each_continue(list, evsel) \
269 list_for_each_entry_continue(evsel, list, node)
272 * evlist__for_each_continue - continue iteration thru all the evsels
273 * @evlist: evlist instance to iterate
274 * @evsel: struct evsel iterator
276 #define evlist__for_each_continue(evlist, evsel) \
277 __evlist__for_each_continue(&(evlist)->entries, evsel)
280 * __evlist__for_each_reverse - iterate thru all the evsels in reverse order
281 * @list: list_head instance to iterate
282 * @evsel: struct evsel iterator
284 #define __evlist__for_each_reverse(list, evsel) \
285 list_for_each_entry_reverse(evsel, list, node)
288 * evlist__for_each_reverse - iterate thru all the evsels in reverse order
289 * @evlist: evlist instance to iterate
290 * @evsel: struct evsel iterator
292 #define evlist__for_each_reverse(evlist, evsel) \
293 __evlist__for_each_reverse(&(evlist)->entries, evsel)
296 * __evlist__for_each_safe - safely iterate thru all the evsels
297 * @list: list_head instance to iterate
298 * @tmp: struct evsel temp iterator
299 * @evsel: struct evsel iterator
301 #define __evlist__for_each_safe(list, tmp, evsel) \
302 list_for_each_entry_safe(evsel, tmp, list, node)
305 * evlist__for_each_safe - safely iterate thru all the evsels
306 * @evlist: evlist instance to iterate
307 * @evsel: struct evsel iterator
308 * @tmp: struct evsel temp iterator
310 #define evlist__for_each_safe(evlist, tmp, evsel) \
311 __evlist__for_each_safe(&(evlist)->entries, tmp, evsel)
313 void perf_evlist__set_tracking_event(struct perf_evlist
*evlist
,
314 struct perf_evsel
*tracking_evsel
);
316 void perf_event_attr__set_max_precise_ip(struct perf_event_attr
*attr
);
319 perf_evlist__find_evsel_by_str(struct perf_evlist
*evlist
, const char *str
);
320 #endif /* __PERF_EVLIST_H */