Linux Audio

Check our new training course

Loading...
v4.6
  1#ifndef __PERF_EVLIST_H
  2#define __PERF_EVLIST_H 1
  3
  4#include <linux/atomic.h>
  5#include <linux/list.h>
  6#include <api/fd/array.h>
  7#include <stdio.h>
  8#include "../perf.h"
  9#include "event.h"
 10#include "evsel.h"
 11#include "util.h"
 12#include "auxtrace.h"
 13#include <unistd.h>
 14
 15struct pollfd;
 16struct thread_map;
 17struct cpu_map;
 18struct record_opts;
 19
 20#define PERF_EVLIST__HLIST_BITS 8
 21#define PERF_EVLIST__HLIST_SIZE (1 << PERF_EVLIST__HLIST_BITS)
 22
 23/**
 24 * struct perf_mmap - perf's ring buffer mmap details
 25 *
 26 * @refcnt - e.g. code using PERF_EVENT_IOC_SET_OUTPUT to share this
 27 */
 28struct perf_mmap {
 29	void		 *base;
 30	int		 mask;
 
 31	atomic_t	 refcnt;
 32	u64		 prev;
 33	struct auxtrace_mmap auxtrace_mmap;
 34	char		 event_copy[PERF_SAMPLE_MAX_SIZE] __attribute__((aligned(8)));
 35};
 36
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 37struct perf_evlist {
 38	struct list_head entries;
 39	struct hlist_head heads[PERF_EVLIST__HLIST_SIZE];
 40	int		 nr_entries;
 41	int		 nr_groups;
 42	int		 nr_mmaps;
 43	bool		 overwrite;
 44	bool		 enabled;
 45	bool		 has_user_cpus;
 46	size_t		 mmap_len;
 47	int		 id_pos;
 48	int		 is_pos;
 49	u64		 combined_sample_type;
 
 50	struct {
 51		int	cork_fd;
 52		pid_t	pid;
 53	} workload;
 54	struct fdarray	 pollfd;
 55	struct perf_mmap *mmap;
 
 56	struct thread_map *threads;
 57	struct cpu_map	  *cpus;
 58	struct perf_evsel *selected;
 59	struct events_stats stats;
 60	struct perf_env	*env;
 61};
 62
 63struct perf_evsel_str_handler {
 64	const char *name;
 65	void	   *handler;
 66};
 67
 68struct perf_evlist *perf_evlist__new(void);
 69struct perf_evlist *perf_evlist__new_default(void);
 70struct perf_evlist *perf_evlist__new_dummy(void);
 71void perf_evlist__init(struct perf_evlist *evlist, struct cpu_map *cpus,
 72		       struct thread_map *threads);
 73void perf_evlist__exit(struct perf_evlist *evlist);
 74void perf_evlist__delete(struct perf_evlist *evlist);
 75
 76void perf_evlist__add(struct perf_evlist *evlist, struct perf_evsel *entry);
 77void perf_evlist__remove(struct perf_evlist *evlist, struct perf_evsel *evsel);
 78int perf_evlist__add_default(struct perf_evlist *evlist);
 79int __perf_evlist__add_default_attrs(struct perf_evlist *evlist,
 80				     struct perf_event_attr *attrs, size_t nr_attrs);
 81
 82#define perf_evlist__add_default_attrs(evlist, array) \
 83	__perf_evlist__add_default_attrs(evlist, array, ARRAY_SIZE(array))
 84
 85int perf_evlist__add_dummy(struct perf_evlist *evlist);
 86
 87int perf_evlist__add_newtp(struct perf_evlist *evlist,
 88			   const char *sys, const char *name, void *handler);
 89
 
 
 
 
 
 
 
 
 
 
 
 90int perf_evlist__set_filter(struct perf_evlist *evlist, const char *filter);
 91int perf_evlist__set_filter_pid(struct perf_evlist *evlist, pid_t pid);
 92int perf_evlist__set_filter_pids(struct perf_evlist *evlist, size_t npids, pid_t *pids);
 93
 94struct perf_evsel *
 95perf_evlist__find_tracepoint_by_id(struct perf_evlist *evlist, int id);
 96
 97struct perf_evsel *
 98perf_evlist__find_tracepoint_by_name(struct perf_evlist *evlist,
 99				     const char *name);
100
101void perf_evlist__id_add(struct perf_evlist *evlist, struct perf_evsel *evsel,
102			 int cpu, int thread, u64 id);
103int perf_evlist__id_add_fd(struct perf_evlist *evlist,
104			   struct perf_evsel *evsel,
105			   int cpu, int thread, int fd);
106
107int perf_evlist__add_pollfd(struct perf_evlist *evlist, int fd);
108int perf_evlist__alloc_pollfd(struct perf_evlist *evlist);
109int perf_evlist__filter_pollfd(struct perf_evlist *evlist, short revents_and_mask);
110
111int perf_evlist__poll(struct perf_evlist *evlist, int timeout);
112
113struct perf_evsel *perf_evlist__id2evsel(struct perf_evlist *evlist, u64 id);
114struct perf_evsel *perf_evlist__id2evsel_strict(struct perf_evlist *evlist,
115						u64 id);
116
117struct perf_sample_id *perf_evlist__id2sid(struct perf_evlist *evlist, u64 id);
118
 
 
 
 
 
 
 
 
119union perf_event *perf_evlist__mmap_read(struct perf_evlist *evlist, int idx);
120
 
 
 
 
 
 
121void perf_evlist__mmap_consume(struct perf_evlist *evlist, int idx);
122
123int perf_evlist__open(struct perf_evlist *evlist);
124void perf_evlist__close(struct perf_evlist *evlist);
125
 
 
126void perf_evlist__set_id_pos(struct perf_evlist *evlist);
127bool perf_can_sample_identifier(void);
128bool perf_can_record_switch_events(void);
129bool perf_can_record_cpu_wide(void);
130void perf_evlist__config(struct perf_evlist *evlist, struct record_opts *opts);
 
131int record_opts__config(struct record_opts *opts);
132
133int perf_evlist__prepare_workload(struct perf_evlist *evlist,
134				  struct target *target,
135				  const char *argv[], bool pipe_output,
136				  void (*exec_error)(int signo, siginfo_t *info,
137						     void *ucontext));
138int perf_evlist__start_workload(struct perf_evlist *evlist);
139
140struct option;
141
142int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages, const char *str);
143int perf_evlist__parse_mmap_pages(const struct option *opt,
144				  const char *str,
145				  int unset);
146
 
 
147int perf_evlist__mmap_ex(struct perf_evlist *evlist, unsigned int pages,
148			 bool overwrite, unsigned int auxtrace_pages,
149			 bool auxtrace_overwrite);
150int perf_evlist__mmap(struct perf_evlist *evlist, unsigned int pages,
151		      bool overwrite);
152void perf_evlist__munmap(struct perf_evlist *evlist);
153
154void perf_evlist__disable(struct perf_evlist *evlist);
155void perf_evlist__enable(struct perf_evlist *evlist);
156void perf_evlist__toggle_enable(struct perf_evlist *evlist);
157
158int perf_evlist__enable_event_idx(struct perf_evlist *evlist,
159				  struct perf_evsel *evsel, int idx);
160
161void perf_evlist__set_selected(struct perf_evlist *evlist,
162			       struct perf_evsel *evsel);
163
164void perf_evlist__set_maps(struct perf_evlist *evlist, struct cpu_map *cpus,
165			   struct thread_map *threads);
166int perf_evlist__create_maps(struct perf_evlist *evlist, struct target *target);
167int perf_evlist__apply_filters(struct perf_evlist *evlist, struct perf_evsel **err_evsel);
168
169void __perf_evlist__set_leader(struct list_head *list);
170void perf_evlist__set_leader(struct perf_evlist *evlist);
171
172u64 perf_evlist__read_format(struct perf_evlist *evlist);
173u64 __perf_evlist__combined_sample_type(struct perf_evlist *evlist);
174u64 perf_evlist__combined_sample_type(struct perf_evlist *evlist);
175u64 perf_evlist__combined_branch_type(struct perf_evlist *evlist);
176bool perf_evlist__sample_id_all(struct perf_evlist *evlist);
177u16 perf_evlist__id_hdr_size(struct perf_evlist *evlist);
178
179int perf_evlist__parse_sample(struct perf_evlist *evlist, union perf_event *event,
180			      struct perf_sample *sample);
181
182bool perf_evlist__valid_sample_type(struct perf_evlist *evlist);
183bool perf_evlist__valid_sample_id_all(struct perf_evlist *evlist);
184bool perf_evlist__valid_read_format(struct perf_evlist *evlist);
185
186void perf_evlist__splice_list_tail(struct perf_evlist *evlist,
187				   struct list_head *list);
188
189static inline struct perf_evsel *perf_evlist__first(struct perf_evlist *evlist)
190{
191	return list_entry(evlist->entries.next, struct perf_evsel, node);
192}
193
194static inline struct perf_evsel *perf_evlist__last(struct perf_evlist *evlist)
195{
196	return list_entry(evlist->entries.prev, struct perf_evsel, node);
197}
198
199size_t perf_evlist__fprintf(struct perf_evlist *evlist, FILE *fp);
200
201int perf_evlist__strerror_open(struct perf_evlist *evlist, int err, char *buf, size_t size);
202int perf_evlist__strerror_mmap(struct perf_evlist *evlist, int err, char *buf, size_t size);
203
204static inline u64 perf_mmap__read_head(struct perf_mmap *mm)
205{
206	struct perf_event_mmap_page *pc = mm->base;
207	u64 head = ACCESS_ONCE(pc->data_head);
208	rmb();
209	return head;
210}
211
212static inline void perf_mmap__write_tail(struct perf_mmap *md, u64 tail)
213{
214	struct perf_event_mmap_page *pc = md->base;
215
216	/*
217	 * ensure all reads are done before we write the tail out.
218	 */
219	mb();
220	pc->data_tail = tail;
221}
222
223bool perf_evlist__can_select_event(struct perf_evlist *evlist, const char *str);
224void perf_evlist__to_front(struct perf_evlist *evlist,
225			   struct perf_evsel *move_evsel);
226
227/**
228 * __evlist__for_each - iterate thru all the evsels
229 * @list: list_head instance to iterate
230 * @evsel: struct evsel iterator
231 */
232#define __evlist__for_each(list, evsel) \
233        list_for_each_entry(evsel, list, node)
234
235/**
236 * evlist__for_each - iterate thru all the evsels
237 * @evlist: evlist instance to iterate
238 * @evsel: struct evsel iterator
239 */
240#define evlist__for_each(evlist, evsel) \
241	__evlist__for_each(&(evlist)->entries, evsel)
242
243/**
244 * __evlist__for_each_continue - continue iteration thru all the evsels
245 * @list: list_head instance to iterate
246 * @evsel: struct evsel iterator
247 */
248#define __evlist__for_each_continue(list, evsel) \
249        list_for_each_entry_continue(evsel, list, node)
250
251/**
252 * evlist__for_each_continue - continue iteration thru all the evsels
253 * @evlist: evlist instance to iterate
254 * @evsel: struct evsel iterator
255 */
256#define evlist__for_each_continue(evlist, evsel) \
257	__evlist__for_each_continue(&(evlist)->entries, evsel)
258
259/**
260 * __evlist__for_each_reverse - iterate thru all the evsels in reverse order
261 * @list: list_head instance to iterate
262 * @evsel: struct evsel iterator
263 */
264#define __evlist__for_each_reverse(list, evsel) \
265        list_for_each_entry_reverse(evsel, list, node)
266
267/**
268 * evlist__for_each_reverse - iterate thru all the evsels in reverse order
269 * @evlist: evlist instance to iterate
270 * @evsel: struct evsel iterator
271 */
272#define evlist__for_each_reverse(evlist, evsel) \
273	__evlist__for_each_reverse(&(evlist)->entries, evsel)
274
275/**
276 * __evlist__for_each_safe - safely iterate thru all the evsels
277 * @list: list_head instance to iterate
278 * @tmp: struct evsel temp iterator
279 * @evsel: struct evsel iterator
280 */
281#define __evlist__for_each_safe(list, tmp, evsel) \
282        list_for_each_entry_safe(evsel, tmp, list, node)
283
284/**
285 * evlist__for_each_safe - safely iterate thru all the evsels
286 * @evlist: evlist instance to iterate
287 * @evsel: struct evsel iterator
288 * @tmp: struct evsel temp iterator
289 */
290#define evlist__for_each_safe(evlist, tmp, evsel) \
291	__evlist__for_each_safe(&(evlist)->entries, tmp, evsel)
292
293void perf_evlist__set_tracking_event(struct perf_evlist *evlist,
294				     struct perf_evsel *tracking_evsel);
295
296void perf_event_attr__set_max_precise_ip(struct perf_event_attr *attr);
297
298struct perf_evsel *
299perf_evlist__find_evsel_by_str(struct perf_evlist *evlist, const char *str);
 
 
 
300#endif /* __PERF_EVLIST_H */
v4.10.11
  1#ifndef __PERF_EVLIST_H
  2#define __PERF_EVLIST_H 1
  3
  4#include <linux/atomic.h>
  5#include <linux/list.h>
  6#include <api/fd/array.h>
  7#include <stdio.h>
  8#include "../perf.h"
  9#include "event.h"
 10#include "evsel.h"
 11#include "util.h"
 12#include "auxtrace.h"
 13#include <unistd.h>
 14
 15struct pollfd;
 16struct thread_map;
 17struct cpu_map;
 18struct record_opts;
 19
 20#define PERF_EVLIST__HLIST_BITS 8
 21#define PERF_EVLIST__HLIST_SIZE (1 << PERF_EVLIST__HLIST_BITS)
 22
 23/**
 24 * struct perf_mmap - perf's ring buffer mmap details
 25 *
 26 * @refcnt - e.g. code using PERF_EVENT_IOC_SET_OUTPUT to share this
 27 */
 28struct perf_mmap {
 29	void		 *base;
 30	int		 mask;
 31	int		 fd;
 32	atomic_t	 refcnt;
 33	u64		 prev;
 34	struct auxtrace_mmap auxtrace_mmap;
 35	char		 event_copy[PERF_SAMPLE_MAX_SIZE] __attribute__((aligned(8)));
 36};
 37
 38static inline size_t
 39perf_mmap__mmap_len(struct perf_mmap *map)
 40{
 41	return map->mask + 1 + page_size;
 42}
 43
 44/*
 45 * State machine of bkw_mmap_state:
 46 *
 47 *                     .________________(forbid)_____________.
 48 *                     |                                     V
 49 * NOTREADY --(0)--> RUNNING --(1)--> DATA_PENDING --(2)--> EMPTY
 50 *                     ^  ^              |   ^               |
 51 *                     |  |__(forbid)____/   |___(forbid)___/|
 52 *                     |                                     |
 53 *                      \_________________(3)_______________/
 54 *
 55 * NOTREADY     : Backward ring buffers are not ready
 56 * RUNNING      : Backward ring buffers are recording
 57 * DATA_PENDING : We are required to collect data from backward ring buffers
 58 * EMPTY        : We have collected data from backward ring buffers.
 59 *
 60 * (0): Setup backward ring buffer
 61 * (1): Pause ring buffers for reading
 62 * (2): Read from ring buffers
 63 * (3): Resume ring buffers for recording
 64 */
 65enum bkw_mmap_state {
 66	BKW_MMAP_NOTREADY,
 67	BKW_MMAP_RUNNING,
 68	BKW_MMAP_DATA_PENDING,
 69	BKW_MMAP_EMPTY,
 70};
 71
 72struct perf_evlist {
 73	struct list_head entries;
 74	struct hlist_head heads[PERF_EVLIST__HLIST_SIZE];
 75	int		 nr_entries;
 76	int		 nr_groups;
 77	int		 nr_mmaps;
 78	bool		 overwrite;
 79	bool		 enabled;
 80	bool		 has_user_cpus;
 81	size_t		 mmap_len;
 82	int		 id_pos;
 83	int		 is_pos;
 84	u64		 combined_sample_type;
 85	enum bkw_mmap_state bkw_mmap_state;
 86	struct {
 87		int	cork_fd;
 88		pid_t	pid;
 89	} workload;
 90	struct fdarray	 pollfd;
 91	struct perf_mmap *mmap;
 92	struct perf_mmap *backward_mmap;
 93	struct thread_map *threads;
 94	struct cpu_map	  *cpus;
 95	struct perf_evsel *selected;
 96	struct events_stats stats;
 97	struct perf_env	*env;
 98};
 99
100struct perf_evsel_str_handler {
101	const char *name;
102	void	   *handler;
103};
104
105struct perf_evlist *perf_evlist__new(void);
106struct perf_evlist *perf_evlist__new_default(void);
107struct perf_evlist *perf_evlist__new_dummy(void);
108void perf_evlist__init(struct perf_evlist *evlist, struct cpu_map *cpus,
109		       struct thread_map *threads);
110void perf_evlist__exit(struct perf_evlist *evlist);
111void perf_evlist__delete(struct perf_evlist *evlist);
112
113void perf_evlist__add(struct perf_evlist *evlist, struct perf_evsel *entry);
114void perf_evlist__remove(struct perf_evlist *evlist, struct perf_evsel *evsel);
115int perf_evlist__add_default(struct perf_evlist *evlist);
116int __perf_evlist__add_default_attrs(struct perf_evlist *evlist,
117				     struct perf_event_attr *attrs, size_t nr_attrs);
118
119#define perf_evlist__add_default_attrs(evlist, array) \
120	__perf_evlist__add_default_attrs(evlist, array, ARRAY_SIZE(array))
121
122int perf_evlist__add_dummy(struct perf_evlist *evlist);
123
124int perf_evlist__add_newtp(struct perf_evlist *evlist,
125			   const char *sys, const char *name, void *handler);
126
127void __perf_evlist__set_sample_bit(struct perf_evlist *evlist,
128				   enum perf_event_sample_format bit);
129void __perf_evlist__reset_sample_bit(struct perf_evlist *evlist,
130				     enum perf_event_sample_format bit);
131
132#define perf_evlist__set_sample_bit(evlist, bit) \
133	__perf_evlist__set_sample_bit(evlist, PERF_SAMPLE_##bit)
134
135#define perf_evlist__reset_sample_bit(evlist, bit) \
136	__perf_evlist__reset_sample_bit(evlist, PERF_SAMPLE_##bit)
137
138int perf_evlist__set_filter(struct perf_evlist *evlist, const char *filter);
139int perf_evlist__set_filter_pid(struct perf_evlist *evlist, pid_t pid);
140int perf_evlist__set_filter_pids(struct perf_evlist *evlist, size_t npids, pid_t *pids);
141
142struct perf_evsel *
143perf_evlist__find_tracepoint_by_id(struct perf_evlist *evlist, int id);
144
145struct perf_evsel *
146perf_evlist__find_tracepoint_by_name(struct perf_evlist *evlist,
147				     const char *name);
148
149void perf_evlist__id_add(struct perf_evlist *evlist, struct perf_evsel *evsel,
150			 int cpu, int thread, u64 id);
151int perf_evlist__id_add_fd(struct perf_evlist *evlist,
152			   struct perf_evsel *evsel,
153			   int cpu, int thread, int fd);
154
155int perf_evlist__add_pollfd(struct perf_evlist *evlist, int fd);
156int perf_evlist__alloc_pollfd(struct perf_evlist *evlist);
157int perf_evlist__filter_pollfd(struct perf_evlist *evlist, short revents_and_mask);
158
159int perf_evlist__poll(struct perf_evlist *evlist, int timeout);
160
161struct perf_evsel *perf_evlist__id2evsel(struct perf_evlist *evlist, u64 id);
162struct perf_evsel *perf_evlist__id2evsel_strict(struct perf_evlist *evlist,
163						u64 id);
164
165struct perf_sample_id *perf_evlist__id2sid(struct perf_evlist *evlist, u64 id);
166
167void perf_evlist__toggle_bkw_mmap(struct perf_evlist *evlist, enum bkw_mmap_state state);
168
169union perf_event *perf_mmap__read_forward(struct perf_mmap *map, bool check_messup);
170union perf_event *perf_mmap__read_backward(struct perf_mmap *map);
171
172void perf_mmap__read_catchup(struct perf_mmap *md);
173void perf_mmap__consume(struct perf_mmap *md, bool overwrite);
174
175union perf_event *perf_evlist__mmap_read(struct perf_evlist *evlist, int idx);
176
177union perf_event *perf_evlist__mmap_read_forward(struct perf_evlist *evlist,
178						 int idx);
179union perf_event *perf_evlist__mmap_read_backward(struct perf_evlist *evlist,
180						  int idx);
181void perf_evlist__mmap_read_catchup(struct perf_evlist *evlist, int idx);
182
183void perf_evlist__mmap_consume(struct perf_evlist *evlist, int idx);
184
185int perf_evlist__open(struct perf_evlist *evlist);
186void perf_evlist__close(struct perf_evlist *evlist);
187
188struct callchain_param;
189
190void perf_evlist__set_id_pos(struct perf_evlist *evlist);
191bool perf_can_sample_identifier(void);
192bool perf_can_record_switch_events(void);
193bool perf_can_record_cpu_wide(void);
194void perf_evlist__config(struct perf_evlist *evlist, struct record_opts *opts,
195			 struct callchain_param *callchain);
196int record_opts__config(struct record_opts *opts);
197
198int perf_evlist__prepare_workload(struct perf_evlist *evlist,
199				  struct target *target,
200				  const char *argv[], bool pipe_output,
201				  void (*exec_error)(int signo, siginfo_t *info,
202						     void *ucontext));
203int perf_evlist__start_workload(struct perf_evlist *evlist);
204
205struct option;
206
207int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages, const char *str);
208int perf_evlist__parse_mmap_pages(const struct option *opt,
209				  const char *str,
210				  int unset);
211
212unsigned long perf_event_mlock_kb_in_pages(void);
213
214int perf_evlist__mmap_ex(struct perf_evlist *evlist, unsigned int pages,
215			 bool overwrite, unsigned int auxtrace_pages,
216			 bool auxtrace_overwrite);
217int perf_evlist__mmap(struct perf_evlist *evlist, unsigned int pages,
218		      bool overwrite);
219void perf_evlist__munmap(struct perf_evlist *evlist);
220
221void perf_evlist__disable(struct perf_evlist *evlist);
222void perf_evlist__enable(struct perf_evlist *evlist);
223void perf_evlist__toggle_enable(struct perf_evlist *evlist);
224
225int perf_evlist__enable_event_idx(struct perf_evlist *evlist,
226				  struct perf_evsel *evsel, int idx);
227
228void perf_evlist__set_selected(struct perf_evlist *evlist,
229			       struct perf_evsel *evsel);
230
231void perf_evlist__set_maps(struct perf_evlist *evlist, struct cpu_map *cpus,
232			   struct thread_map *threads);
233int perf_evlist__create_maps(struct perf_evlist *evlist, struct target *target);
234int perf_evlist__apply_filters(struct perf_evlist *evlist, struct perf_evsel **err_evsel);
235
236void __perf_evlist__set_leader(struct list_head *list);
237void perf_evlist__set_leader(struct perf_evlist *evlist);
238
239u64 perf_evlist__read_format(struct perf_evlist *evlist);
240u64 __perf_evlist__combined_sample_type(struct perf_evlist *evlist);
241u64 perf_evlist__combined_sample_type(struct perf_evlist *evlist);
242u64 perf_evlist__combined_branch_type(struct perf_evlist *evlist);
243bool perf_evlist__sample_id_all(struct perf_evlist *evlist);
244u16 perf_evlist__id_hdr_size(struct perf_evlist *evlist);
245
246int perf_evlist__parse_sample(struct perf_evlist *evlist, union perf_event *event,
247			      struct perf_sample *sample);
248
249bool perf_evlist__valid_sample_type(struct perf_evlist *evlist);
250bool perf_evlist__valid_sample_id_all(struct perf_evlist *evlist);
251bool perf_evlist__valid_read_format(struct perf_evlist *evlist);
252
253void perf_evlist__splice_list_tail(struct perf_evlist *evlist,
254				   struct list_head *list);
255
256static inline struct perf_evsel *perf_evlist__first(struct perf_evlist *evlist)
257{
258	return list_entry(evlist->entries.next, struct perf_evsel, node);
259}
260
261static inline struct perf_evsel *perf_evlist__last(struct perf_evlist *evlist)
262{
263	return list_entry(evlist->entries.prev, struct perf_evsel, node);
264}
265
266size_t perf_evlist__fprintf(struct perf_evlist *evlist, FILE *fp);
267
268int perf_evlist__strerror_open(struct perf_evlist *evlist, int err, char *buf, size_t size);
269int perf_evlist__strerror_mmap(struct perf_evlist *evlist, int err, char *buf, size_t size);
270
271static inline u64 perf_mmap__read_head(struct perf_mmap *mm)
272{
273	struct perf_event_mmap_page *pc = mm->base;
274	u64 head = ACCESS_ONCE(pc->data_head);
275	rmb();
276	return head;
277}
278
279static inline void perf_mmap__write_tail(struct perf_mmap *md, u64 tail)
280{
281	struct perf_event_mmap_page *pc = md->base;
282
283	/*
284	 * ensure all reads are done before we write the tail out.
285	 */
286	mb();
287	pc->data_tail = tail;
288}
289
290bool perf_evlist__can_select_event(struct perf_evlist *evlist, const char *str);
291void perf_evlist__to_front(struct perf_evlist *evlist,
292			   struct perf_evsel *move_evsel);
293
294/**
295 * __evlist__for_each_entry - iterate thru all the evsels
296 * @list: list_head instance to iterate
297 * @evsel: struct evsel iterator
298 */
299#define __evlist__for_each_entry(list, evsel) \
300        list_for_each_entry(evsel, list, node)
301
302/**
303 * evlist__for_each_entry - iterate thru all the evsels
304 * @evlist: evlist instance to iterate
305 * @evsel: struct evsel iterator
306 */
307#define evlist__for_each_entry(evlist, evsel) \
308	__evlist__for_each_entry(&(evlist)->entries, evsel)
309
310/**
311 * __evlist__for_each_entry_continue - continue iteration thru all the evsels
312 * @list: list_head instance to iterate
313 * @evsel: struct evsel iterator
314 */
315#define __evlist__for_each_entry_continue(list, evsel) \
316        list_for_each_entry_continue(evsel, list, node)
317
318/**
319 * evlist__for_each_entry_continue - continue iteration thru all the evsels
320 * @evlist: evlist instance to iterate
321 * @evsel: struct evsel iterator
322 */
323#define evlist__for_each_entry_continue(evlist, evsel) \
324	__evlist__for_each_entry_continue(&(evlist)->entries, evsel)
325
326/**
327 * __evlist__for_each_entry_reverse - iterate thru all the evsels in reverse order
328 * @list: list_head instance to iterate
329 * @evsel: struct evsel iterator
330 */
331#define __evlist__for_each_entry_reverse(list, evsel) \
332        list_for_each_entry_reverse(evsel, list, node)
333
334/**
335 * evlist__for_each_entry_reverse - iterate thru all the evsels in reverse order
336 * @evlist: evlist instance to iterate
337 * @evsel: struct evsel iterator
338 */
339#define evlist__for_each_entry_reverse(evlist, evsel) \
340	__evlist__for_each_entry_reverse(&(evlist)->entries, evsel)
341
342/**
343 * __evlist__for_each_entry_safe - safely iterate thru all the evsels
344 * @list: list_head instance to iterate
345 * @tmp: struct evsel temp iterator
346 * @evsel: struct evsel iterator
347 */
348#define __evlist__for_each_entry_safe(list, tmp, evsel) \
349        list_for_each_entry_safe(evsel, tmp, list, node)
350
351/**
352 * evlist__for_each_entry_safe - safely iterate thru all the evsels
353 * @evlist: evlist instance to iterate
354 * @evsel: struct evsel iterator
355 * @tmp: struct evsel temp iterator
356 */
357#define evlist__for_each_entry_safe(evlist, tmp, evsel) \
358	__evlist__for_each_entry_safe(&(evlist)->entries, tmp, evsel)
359
360void perf_evlist__set_tracking_event(struct perf_evlist *evlist,
361				     struct perf_evsel *tracking_evsel);
362
363void perf_event_attr__set_max_precise_ip(struct perf_event_attr *attr);
364
365struct perf_evsel *
366perf_evlist__find_evsel_by_str(struct perf_evlist *evlist, const char *str);
367
368struct perf_evsel *perf_evlist__event2evsel(struct perf_evlist *evlist,
369					    union perf_event *event);
370#endif /* __PERF_EVLIST_H */