Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

Mar 24-27, 2025, special US time zones
Register
Loading...
v4.17
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __PERF_EVLIST_H
  3#define __PERF_EVLIST_H 1
  4
  5#include <linux/compiler.h>
  6#include <linux/kernel.h>
  7#include <linux/refcount.h>
  8#include <linux/list.h>
  9#include <api/fd/array.h>
 10#include <stdio.h>
 11#include "../perf.h"
 12#include "event.h"
 13#include "evsel.h"
 14#include "mmap.h"
 15#include "util.h"
 16#include <signal.h>
 17#include <unistd.h>
 18
 19struct pollfd;
 20struct thread_map;
 21struct cpu_map;
 22struct record_opts;
 23
 24#define PERF_EVLIST__HLIST_BITS 8
 25#define PERF_EVLIST__HLIST_SIZE (1 << PERF_EVLIST__HLIST_BITS)
 26
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 27struct perf_evlist {
 28	struct list_head entries;
 29	struct hlist_head heads[PERF_EVLIST__HLIST_SIZE];
 30	int		 nr_entries;
 31	int		 nr_groups;
 32	int		 nr_mmaps;
 
 33	bool		 enabled;
 34	bool		 has_user_cpus;
 35	size_t		 mmap_len;
 36	int		 id_pos;
 37	int		 is_pos;
 38	u64		 combined_sample_type;
 39	enum bkw_mmap_state bkw_mmap_state;
 40	struct {
 41		int	cork_fd;
 42		pid_t	pid;
 43	} workload;
 44	struct fdarray	 pollfd;
 45	struct perf_mmap *mmap;
 46	struct perf_mmap *overwrite_mmap;
 47	struct thread_map *threads;
 48	struct cpu_map	  *cpus;
 49	struct perf_evsel *selected;
 50	struct events_stats stats;
 51	struct perf_env	*env;
 52	u64		first_sample_time;
 53	u64		last_sample_time;
 54};
 55
 56struct perf_evsel_str_handler {
 57	const char *name;
 58	void	   *handler;
 59};
 60
 61struct perf_evlist *perf_evlist__new(void);
 62struct perf_evlist *perf_evlist__new_default(void);
 63struct perf_evlist *perf_evlist__new_dummy(void);
 64void perf_evlist__init(struct perf_evlist *evlist, struct cpu_map *cpus,
 65		       struct thread_map *threads);
 66void perf_evlist__exit(struct perf_evlist *evlist);
 67void perf_evlist__delete(struct perf_evlist *evlist);
 68
 69void perf_evlist__add(struct perf_evlist *evlist, struct perf_evsel *entry);
 70void perf_evlist__remove(struct perf_evlist *evlist, struct perf_evsel *evsel);
 71
 72int __perf_evlist__add_default(struct perf_evlist *evlist, bool precise);
 73
 74static inline int perf_evlist__add_default(struct perf_evlist *evlist)
 75{
 76	return __perf_evlist__add_default(evlist, true);
 77}
 78
 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
 90void __perf_evlist__set_sample_bit(struct perf_evlist *evlist,
 91				   enum perf_event_sample_format bit);
 92void __perf_evlist__reset_sample_bit(struct perf_evlist *evlist,
 93				     enum perf_event_sample_format bit);
 94
 95#define perf_evlist__set_sample_bit(evlist, bit) \
 96	__perf_evlist__set_sample_bit(evlist, PERF_SAMPLE_##bit)
 97
 98#define perf_evlist__reset_sample_bit(evlist, bit) \
 99	__perf_evlist__reset_sample_bit(evlist, PERF_SAMPLE_##bit)
100
101int perf_evlist__set_filter(struct perf_evlist *evlist, const char *filter);
102int perf_evlist__set_filter_pid(struct perf_evlist *evlist, pid_t pid);
103int perf_evlist__set_filter_pids(struct perf_evlist *evlist, size_t npids, pid_t *pids);
104
105struct perf_evsel *
106perf_evlist__find_tracepoint_by_id(struct perf_evlist *evlist, int id);
107
108struct perf_evsel *
109perf_evlist__find_tracepoint_by_name(struct perf_evlist *evlist,
110				     const char *name);
111
112void perf_evlist__id_add(struct perf_evlist *evlist, struct perf_evsel *evsel,
113			 int cpu, int thread, u64 id);
114int perf_evlist__id_add_fd(struct perf_evlist *evlist,
115			   struct perf_evsel *evsel,
116			   int cpu, int thread, int fd);
117
118int perf_evlist__add_pollfd(struct perf_evlist *evlist, int fd);
119int perf_evlist__alloc_pollfd(struct perf_evlist *evlist);
120int perf_evlist__filter_pollfd(struct perf_evlist *evlist, short revents_and_mask);
121
122int perf_evlist__poll(struct perf_evlist *evlist, int timeout);
123
124struct perf_evsel *perf_evlist__id2evsel(struct perf_evlist *evlist, u64 id);
125struct perf_evsel *perf_evlist__id2evsel_strict(struct perf_evlist *evlist,
126						u64 id);
127
128struct perf_sample_id *perf_evlist__id2sid(struct perf_evlist *evlist, u64 id);
129
130void perf_evlist__toggle_bkw_mmap(struct perf_evlist *evlist, enum bkw_mmap_state state);
131
 
 
 
 
 
 
 
 
 
 
 
 
 
 
132void perf_evlist__mmap_consume(struct perf_evlist *evlist, int idx);
133
134int perf_evlist__open(struct perf_evlist *evlist);
135void perf_evlist__close(struct perf_evlist *evlist);
136
137struct callchain_param;
138
139void perf_evlist__set_id_pos(struct perf_evlist *evlist);
140bool perf_can_sample_identifier(void);
141bool perf_can_record_switch_events(void);
142bool perf_can_record_cpu_wide(void);
143void perf_evlist__config(struct perf_evlist *evlist, struct record_opts *opts,
144			 struct callchain_param *callchain);
145int record_opts__config(struct record_opts *opts);
146
147int perf_evlist__prepare_workload(struct perf_evlist *evlist,
148				  struct target *target,
149				  const char *argv[], bool pipe_output,
150				  void (*exec_error)(int signo, siginfo_t *info,
151						     void *ucontext));
152int perf_evlist__start_workload(struct perf_evlist *evlist);
153
154struct option;
155
156int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages, const char *str);
157int perf_evlist__parse_mmap_pages(const struct option *opt,
158				  const char *str,
159				  int unset);
160
161unsigned long perf_event_mlock_kb_in_pages(void);
162
163int perf_evlist__mmap_ex(struct perf_evlist *evlist, unsigned int pages,
164			 unsigned int auxtrace_pages,
165			 bool auxtrace_overwrite);
166int perf_evlist__mmap(struct perf_evlist *evlist, unsigned int pages);
 
167void perf_evlist__munmap(struct perf_evlist *evlist);
168
169size_t perf_evlist__mmap_size(unsigned long pages);
170
171void perf_evlist__disable(struct perf_evlist *evlist);
172void perf_evlist__enable(struct perf_evlist *evlist);
173void perf_evlist__toggle_enable(struct perf_evlist *evlist);
174
175int perf_evlist__enable_event_idx(struct perf_evlist *evlist,
176				  struct perf_evsel *evsel, int idx);
177
178void perf_evlist__set_selected(struct perf_evlist *evlist,
179			       struct perf_evsel *evsel);
180
181void perf_evlist__set_maps(struct perf_evlist *evlist, struct cpu_map *cpus,
182			   struct thread_map *threads);
183int perf_evlist__create_maps(struct perf_evlist *evlist, struct target *target);
184int perf_evlist__apply_filters(struct perf_evlist *evlist, struct perf_evsel **err_evsel);
185
186void __perf_evlist__set_leader(struct list_head *list);
187void perf_evlist__set_leader(struct perf_evlist *evlist);
188
189u64 perf_evlist__read_format(struct perf_evlist *evlist);
190u64 __perf_evlist__combined_sample_type(struct perf_evlist *evlist);
191u64 perf_evlist__combined_sample_type(struct perf_evlist *evlist);
192u64 perf_evlist__combined_branch_type(struct perf_evlist *evlist);
193bool perf_evlist__sample_id_all(struct perf_evlist *evlist);
194u16 perf_evlist__id_hdr_size(struct perf_evlist *evlist);
195
196int perf_evlist__parse_sample(struct perf_evlist *evlist, union perf_event *event,
197			      struct perf_sample *sample);
198
199int perf_evlist__parse_sample_timestamp(struct perf_evlist *evlist,
200					union perf_event *event,
201					u64 *timestamp);
202
203bool perf_evlist__valid_sample_type(struct perf_evlist *evlist);
204bool perf_evlist__valid_sample_id_all(struct perf_evlist *evlist);
205bool perf_evlist__valid_read_format(struct perf_evlist *evlist);
206
207void perf_evlist__splice_list_tail(struct perf_evlist *evlist,
208				   struct list_head *list);
209
210static inline bool perf_evlist__empty(struct perf_evlist *evlist)
211{
212	return list_empty(&evlist->entries);
213}
214
215static inline struct perf_evsel *perf_evlist__first(struct perf_evlist *evlist)
216{
217	return list_entry(evlist->entries.next, struct perf_evsel, node);
218}
219
220static inline struct perf_evsel *perf_evlist__last(struct perf_evlist *evlist)
221{
222	return list_entry(evlist->entries.prev, struct perf_evsel, node);
223}
224
225size_t perf_evlist__fprintf(struct perf_evlist *evlist, FILE *fp);
226
227int perf_evlist__strerror_open(struct perf_evlist *evlist, int err, char *buf, size_t size);
228int perf_evlist__strerror_mmap(struct perf_evlist *evlist, int err, char *buf, size_t size);
229
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
230bool perf_evlist__can_select_event(struct perf_evlist *evlist, const char *str);
231void perf_evlist__to_front(struct perf_evlist *evlist,
232			   struct perf_evsel *move_evsel);
233
234/**
235 * __evlist__for_each_entry - iterate thru all the evsels
236 * @list: list_head instance to iterate
237 * @evsel: struct evsel iterator
238 */
239#define __evlist__for_each_entry(list, evsel) \
240        list_for_each_entry(evsel, list, node)
241
242/**
243 * evlist__for_each_entry - iterate thru all the evsels
244 * @evlist: evlist instance to iterate
245 * @evsel: struct evsel iterator
246 */
247#define evlist__for_each_entry(evlist, evsel) \
248	__evlist__for_each_entry(&(evlist)->entries, evsel)
249
250/**
251 * __evlist__for_each_entry_continue - continue iteration thru all the evsels
252 * @list: list_head instance to iterate
253 * @evsel: struct evsel iterator
254 */
255#define __evlist__for_each_entry_continue(list, evsel) \
256        list_for_each_entry_continue(evsel, list, node)
257
258/**
259 * evlist__for_each_entry_continue - continue iteration thru all the evsels
260 * @evlist: evlist instance to iterate
261 * @evsel: struct evsel iterator
262 */
263#define evlist__for_each_entry_continue(evlist, evsel) \
264	__evlist__for_each_entry_continue(&(evlist)->entries, evsel)
265
266/**
267 * __evlist__for_each_entry_reverse - iterate thru all the evsels in reverse order
268 * @list: list_head instance to iterate
269 * @evsel: struct evsel iterator
270 */
271#define __evlist__for_each_entry_reverse(list, evsel) \
272        list_for_each_entry_reverse(evsel, list, node)
273
274/**
275 * evlist__for_each_entry_reverse - iterate thru all the evsels in reverse order
276 * @evlist: evlist instance to iterate
277 * @evsel: struct evsel iterator
278 */
279#define evlist__for_each_entry_reverse(evlist, evsel) \
280	__evlist__for_each_entry_reverse(&(evlist)->entries, evsel)
281
282/**
283 * __evlist__for_each_entry_safe - safely iterate thru all the evsels
284 * @list: list_head instance to iterate
285 * @tmp: struct evsel temp iterator
286 * @evsel: struct evsel iterator
287 */
288#define __evlist__for_each_entry_safe(list, tmp, evsel) \
289        list_for_each_entry_safe(evsel, tmp, list, node)
290
291/**
292 * evlist__for_each_entry_safe - safely iterate thru all the evsels
293 * @evlist: evlist instance to iterate
294 * @evsel: struct evsel iterator
295 * @tmp: struct evsel temp iterator
296 */
297#define evlist__for_each_entry_safe(evlist, tmp, evsel) \
298	__evlist__for_each_entry_safe(&(evlist)->entries, tmp, evsel)
299
300void perf_evlist__set_tracking_event(struct perf_evlist *evlist,
301				     struct perf_evsel *tracking_evsel);
302
303void perf_event_attr__set_max_precise_ip(struct perf_event_attr *attr);
304
305struct perf_evsel *
306perf_evlist__find_evsel_by_str(struct perf_evlist *evlist, const char *str);
307
308struct perf_evsel *perf_evlist__event2evsel(struct perf_evlist *evlist,
309					    union perf_event *event);
310
311bool perf_evlist__exclude_kernel(struct perf_evlist *evlist);
312#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 */