[deliverable/linux.git] / tools / perf / util / evlist.h

#ifndef __PERF_EVLIST_H
#define __PERF_EVLIST_H 1

#include <linux/atomic.h>
#include <linux/list.h>
#include <api/fd/array.h>
#include <stdio.h>
#include "../perf.h"
#include "event.h"
#include "evsel.h"
#include "util.h"
#include "auxtrace.h"
#include <unistd.h>

struct pollfd;
struct thread_map;
struct cpu_map;
struct record_opts;

#define PERF_EVLIST__HLIST_BITS 8
#define PERF_EVLIST__HLIST_SIZE (1 << PERF_EVLIST__HLIST_BITS)

/**
 * struct perf_mmap - perf's ring buffer mmap details
 *
 * @refcnt - e.g. code using PERF_EVENT_IOC_SET_OUTPUT to share this
 */
struct perf_mmap {
	void		 *base;
	int		 mask;
	int		 fd;
	atomic_t	 refcnt;
	u64		 prev;
	struct auxtrace_mmap auxtrace_mmap;
	char		 event_copy[PERF_SAMPLE_MAX_SIZE] __attribute__((aligned(8)));
};

struct perf_evlist {
	struct list_head entries;
	struct hlist_head heads[PERF_EVLIST__HLIST_SIZE];
	int		 nr_entries;
	int		 nr_groups;
	int		 nr_mmaps;
	bool		 overwrite;
	bool		 enabled;
	bool		 has_user_cpus;
	bool		 backward;
	size_t		 mmap_len;
	int		 id_pos;
	int		 is_pos;
	u64		 combined_sample_type;
	struct {
		int	cork_fd;
		pid_t	pid;
	} workload;
	struct fdarray	 pollfd;
	struct perf_mmap *mmap;
	struct thread_map *threads;
	struct cpu_map	  *cpus;
	struct perf_evsel *selected;
	struct events_stats stats;
	struct perf_env	*env;
};

struct perf_evsel_str_handler {
	const char *name;
	void	   *handler;
};

struct perf_evlist *perf_evlist__new(void);
struct perf_evlist *perf_evlist__new_default(void);
struct perf_evlist *perf_evlist__new_dummy(void);
void perf_evlist__init(struct perf_evlist *evlist, struct cpu_map *cpus,
		       struct thread_map *threads);
void perf_evlist__exit(struct perf_evlist *evlist);
void perf_evlist__delete(struct perf_evlist *evlist);

void perf_evlist__add(struct perf_evlist *evlist, struct perf_evsel *entry);
void perf_evlist__remove(struct perf_evlist *evlist, struct perf_evsel *evsel);
int perf_evlist__add_default(struct perf_evlist *evlist);
int __perf_evlist__add_default_attrs(struct perf_evlist *evlist,
				     struct perf_event_attr *attrs, size_t nr_attrs);

#define perf_evlist__add_default_attrs(evlist, array) \
	__perf_evlist__add_default_attrs(evlist, array, ARRAY_SIZE(array))

int perf_evlist__add_dummy(struct perf_evlist *evlist);

int perf_evlist__add_newtp(struct perf_evlist *evlist,
			   const char *sys, const char *name, void *handler);

void __perf_evlist__set_sample_bit(struct perf_evlist *evlist,
				   enum perf_event_sample_format bit);
void __perf_evlist__reset_sample_bit(struct perf_evlist *evlist,
				     enum perf_event_sample_format bit);

#define perf_evlist__set_sample_bit(evlist, bit) \
	__perf_evlist__set_sample_bit(evlist, PERF_SAMPLE_##bit)

#define perf_evlist__reset_sample_bit(evlist, bit) \
	__perf_evlist__reset_sample_bit(evlist, PERF_SAMPLE_##bit)

int perf_evlist__set_filter(struct perf_evlist *evlist, const char *filter);
int perf_evlist__set_filter_pid(struct perf_evlist *evlist, pid_t pid);
int perf_evlist__set_filter_pids(struct perf_evlist *evlist, size_t npids, pid_t *pids);

struct perf_evsel *
perf_evlist__find_tracepoint_by_id(struct perf_evlist *evlist, int id);

struct perf_evsel *
perf_evlist__find_tracepoint_by_name(struct perf_evlist *evlist,
				     const char *name);

void perf_evlist__id_add(struct perf_evlist *evlist, struct perf_evsel *evsel,
			 int cpu, int thread, u64 id);
int perf_evlist__id_add_fd(struct perf_evlist *evlist,
			   struct perf_evsel *evsel,
			   int cpu, int thread, int fd);

int perf_evlist__add_pollfd(struct perf_evlist *evlist, int fd);
int perf_evlist__alloc_pollfd(struct perf_evlist *evlist);
int perf_evlist__filter_pollfd(struct perf_evlist *evlist, short revents_and_mask);

int perf_evlist__poll(struct perf_evlist *evlist, int timeout);

struct perf_evsel *perf_evlist__id2evsel(struct perf_evlist *evlist, u64 id);
struct perf_evsel *perf_evlist__id2evsel_strict(struct perf_evlist *evlist,
						u64 id);

struct perf_sample_id *perf_evlist__id2sid(struct perf_evlist *evlist, u64 id);

union perf_event *perf_evlist__mmap_read(struct perf_evlist *evlist, int idx);

union perf_event *perf_evlist__mmap_read_backward(struct perf_evlist *evlist,
						  int idx);
void perf_evlist__mmap_read_catchup(struct perf_evlist *evlist, int idx);

void perf_evlist__mmap_consume(struct perf_evlist *evlist, int idx);

int perf_evlist__pause(struct perf_evlist *evlist);
int perf_evlist__resume(struct perf_evlist *evlist);
int perf_evlist__open(struct perf_evlist *evlist);
void perf_evlist__close(struct perf_evlist *evlist);

struct callchain_param;

void perf_evlist__set_id_pos(struct perf_evlist *evlist);
bool perf_can_sample_identifier(void);
bool perf_can_record_switch_events(void);
bool perf_can_record_cpu_wide(void);
void perf_evlist__config(struct perf_evlist *evlist, struct record_opts *opts,
			 struct callchain_param *callchain);
int record_opts__config(struct record_opts *opts);

int perf_evlist__prepare_workload(struct perf_evlist *evlist,
				  struct target *target,
				  const char *argv[], bool pipe_output,
				  void (*exec_error)(int signo, siginfo_t *info,
						     void *ucontext));
int perf_evlist__start_workload(struct perf_evlist *evlist);

struct option;

int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages, const char *str);
int perf_evlist__parse_mmap_pages(const struct option *opt,
				  const char *str,
				  int unset);

unsigned long perf_event_mlock_kb_in_pages(void);

int perf_evlist__mmap_ex(struct perf_evlist *evlist, unsigned int pages,
			 bool overwrite, unsigned int auxtrace_pages,
			 bool auxtrace_overwrite);
int perf_evlist__mmap(struct perf_evlist *evlist, unsigned int pages,
		      bool overwrite);
void perf_evlist__munmap(struct perf_evlist *evlist);

void perf_evlist__disable(struct perf_evlist *evlist);
void perf_evlist__enable(struct perf_evlist *evlist);
void perf_evlist__toggle_enable(struct perf_evlist *evlist);

int perf_evlist__enable_event_idx(struct perf_evlist *evlist,
				  struct perf_evsel *evsel, int idx);

void perf_evlist__set_selected(struct perf_evlist *evlist,
			       struct perf_evsel *evsel);

void perf_evlist__set_maps(struct perf_evlist *evlist, struct cpu_map *cpus,
			   struct thread_map *threads);
int perf_evlist__create_maps(struct perf_evlist *evlist, struct target *target);
int perf_evlist__apply_filters(struct perf_evlist *evlist, struct perf_evsel **err_evsel);

void __perf_evlist__set_leader(struct list_head *list);
void perf_evlist__set_leader(struct perf_evlist *evlist);

u64 perf_evlist__read_format(struct perf_evlist *evlist);
u64 __perf_evlist__combined_sample_type(struct perf_evlist *evlist);
u64 perf_evlist__combined_sample_type(struct perf_evlist *evlist);
u64 perf_evlist__combined_branch_type(struct perf_evlist *evlist);
bool perf_evlist__sample_id_all(struct perf_evlist *evlist);
u16 perf_evlist__id_hdr_size(struct perf_evlist *evlist);

int perf_evlist__parse_sample(struct perf_evlist *evlist, union perf_event *event,
			      struct perf_sample *sample);

bool perf_evlist__valid_sample_type(struct perf_evlist *evlist);
bool perf_evlist__valid_sample_id_all(struct perf_evlist *evlist);
bool perf_evlist__valid_read_format(struct perf_evlist *evlist);

void perf_evlist__splice_list_tail(struct perf_evlist *evlist,
				   struct list_head *list);

static inline struct perf_evsel *perf_evlist__first(struct perf_evlist *evlist)
{
	return list_entry(evlist->entries.next, struct perf_evsel, node);
}

static inline struct perf_evsel *perf_evlist__last(struct perf_evlist *evlist)
{
	return list_entry(evlist->entries.prev, struct perf_evsel, node);
}

size_t perf_evlist__fprintf(struct perf_evlist *evlist, FILE *fp);

int perf_evlist__strerror_open(struct perf_evlist *evlist, int err, char *buf, size_t size);
int perf_evlist__strerror_mmap(struct perf_evlist *evlist, int err, char *buf, size_t size);

static inline u64 perf_mmap__read_head(struct perf_mmap *mm)
{
	struct perf_event_mmap_page *pc = mm->base;
	u64 head = ACCESS_ONCE(pc->data_head);
	rmb();
	return head;
}

static inline void perf_mmap__write_tail(struct perf_mmap *md, u64 tail)
{
	struct perf_event_mmap_page *pc = md->base;

	/*
	 * ensure all reads are done before we write the tail out.
	 */
	mb();
	pc->data_tail = tail;
}

bool perf_evlist__can_select_event(struct perf_evlist *evlist, const char *str);
void perf_evlist__to_front(struct perf_evlist *evlist,
			   struct perf_evsel *move_evsel);

/**
 * __evlist__for_each - iterate thru all the evsels
 * @list: list_head instance to iterate
 * @evsel: struct evsel iterator
 */
#define __evlist__for_each(list, evsel) \
        list_for_each_entry(evsel, list, node)

/**
 * evlist__for_each - iterate thru all the evsels
 * @evlist: evlist instance to iterate
 * @evsel: struct evsel iterator
 */
#define evlist__for_each(evlist, evsel) \
	__evlist__for_each(&(evlist)->entries, evsel)

/**
 * __evlist__for_each_continue - continue iteration thru all the evsels
 * @list: list_head instance to iterate
 * @evsel: struct evsel iterator
 */
#define __evlist__for_each_continue(list, evsel) \
        list_for_each_entry_continue(evsel, list, node)

/**
 * evlist__for_each_continue - continue iteration thru all the evsels
 * @evlist: evlist instance to iterate
 * @evsel: struct evsel iterator
 */
#define evlist__for_each_continue(evlist, evsel) \
	__evlist__for_each_continue(&(evlist)->entries, evsel)

/**
 * __evlist__for_each_reverse - iterate thru all the evsels in reverse order
 * @list: list_head instance to iterate
 * @evsel: struct evsel iterator
 */
#define __evlist__for_each_reverse(list, evsel) \
        list_for_each_entry_reverse(evsel, list, node)

/**
 * evlist__for_each_reverse - iterate thru all the evsels in reverse order
 * @evlist: evlist instance to iterate
 * @evsel: struct evsel iterator
 */
#define evlist__for_each_reverse(evlist, evsel) \
	__evlist__for_each_reverse(&(evlist)->entries, evsel)

/**
 * __evlist__for_each_safe - safely iterate thru all the evsels
 * @list: list_head instance to iterate
 * @tmp: struct evsel temp iterator
 * @evsel: struct evsel iterator
 */
#define __evlist__for_each_safe(list, tmp, evsel) \
        list_for_each_entry_safe(evsel, tmp, list, node)

/**
 * evlist__for_each_safe - safely iterate thru all the evsels
 * @evlist: evlist instance to iterate
 * @evsel: struct evsel iterator
 * @tmp: struct evsel temp iterator
 */
#define evlist__for_each_safe(evlist, tmp, evsel) \
	__evlist__for_each_safe(&(evlist)->entries, tmp, evsel)

void perf_evlist__set_tracking_event(struct perf_evlist *evlist,
				     struct perf_evsel *tracking_evsel);

void perf_event_attr__set_max_precise_ip(struct perf_event_attr *attr);

struct perf_evsel *
perf_evlist__find_evsel_by_str(struct perf_evlist *evlist, const char *str);
#endif /* __PERF_EVLIST_H */
Commit	Line	Data
361c99a6 ACM	1	#ifndef __PERF_EVLIST_H
	2	#define __PERF_EVLIST_H 1
	3
7143849a	4	#include <linux/atomic.h>
361c99a6	5	#include <linux/list.h>
1b85337d	6	#include <api/fd/array.h>
50d08e47	7	#include <stdio.h>
70db7533	8	#include "../perf.h"
04391deb	9	#include "event.h"
0c21f736	10	#include "evsel.h"
50d08e47	11	#include "util.h"
718c602d	12	#include "auxtrace.h"
35b9d88e	13	#include <unistd.h>
361c99a6	14
5c581041	15	struct pollfd;
f8a95309 ACM	16	struct thread_map;
f8a95309 ACM	17	struct cpu_map;
b4006796	18	struct record_opts;
5c581041	19
70db7533 ACM	20	#define PERF_EVLIST__HLIST_BITS 8
	21	#define PERF_EVLIST__HLIST_SIZE (1 << PERF_EVLIST__HLIST_BITS)
	22
82396986 ACM	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	*/
0479b8b9 DA	28	struct perf_mmap {
	29	void *base;
	30	int mask;
d4c6fb36	31	int fd;
7143849a	32	atomic_t refcnt;
7b8283b5	33	u64 prev;
718c602d	34	struct auxtrace_mmap auxtrace_mmap;
a73b6c19	35	char event_copy[PERF_SAMPLE_MAX_SIZE] __attribute__((aligned(8)));
0479b8b9 DA	36	};
0479b8b9 DA	37
361c99a6 ACM	38	struct perf_evlist {
361c99a6 ACM	39	struct list_head entries;
70db7533	40	struct hlist_head heads[PERF_EVLIST__HLIST_SIZE];
361c99a6	41	int nr_entries;
97f63e4a	42	int nr_groups;
aece948f	43	int nr_mmaps;
86066064	44	bool overwrite;
2b56bcfb	45	bool enabled;
ec9a77a7	46	bool has_user_cpus;
3a62a7b8	47	bool backward;
994a1f78	48	size_t mmap_len;
75562573 AH	49	int id_pos;
	50	int is_pos;
	51	u64 combined_sample_type;
35b9d88e ACM	52	struct {
	53	int cork_fd;
	54	pid_t pid;
	55	} workload;
1b85337d	56	struct fdarray pollfd;
70db7533	57	struct perf_mmap *mmap;
7e2ed097 ACM	58	struct thread_map *threads;
7e2ed097 ACM	59	struct cpu_map *cpus;
81cce8de	60	struct perf_evsel *selected;
75be989a	61	struct events_stats stats;
2c07144d	62	struct perf_env *env;
361c99a6 ACM	63	};
361c99a6 ACM	64
ee29be62 ACM	65	struct perf_evsel_str_handler {
	66	const char *name;
	67	void *handler;
	68	};
	69
334fe7a3	70	struct perf_evlist *perf_evlist__new(void);
b22d54b0	71	struct perf_evlist *perf_evlist__new_default(void);
5bae0250	72	struct perf_evlist *perf_evlist__new_dummy(void);
7e2ed097 ACM	73	void perf_evlist__init(struct perf_evlist evlist, struct cpu_map cpus,
7e2ed097 ACM	74	struct thread_map *threads);
ef1d1af2	75	void perf_evlist__exit(struct perf_evlist *evlist);
361c99a6 ACM	76	void perf_evlist__delete(struct perf_evlist *evlist);
	77
	78	void perf_evlist__add(struct perf_evlist evlist, struct perf_evsel entry);
4768230a	79	void perf_evlist__remove(struct perf_evlist evlist, struct perf_evsel evsel);
361c99a6	80	int perf_evlist__add_default(struct perf_evlist *evlist);
79695e1b ACM	81	int __perf_evlist__add_default_attrs(struct perf_evlist *evlist,
79695e1b ACM	82	struct perf_event_attr *attrs, size_t nr_attrs);
e60fc847	83
79695e1b ACM	84	#define perf_evlist__add_default_attrs(evlist, array) \
79695e1b ACM	85	__perf_evlist__add_default_attrs(evlist, array, ARRAY_SIZE(array))
361c99a6	86
5bae0250 ACM	87	int perf_evlist__add_dummy(struct perf_evlist *evlist);
5bae0250 ACM	88
39876e7d ACM	89	int perf_evlist__add_newtp(struct perf_evlist *evlist,
	90	const char sys, const char name, void *handler);
	91
22c8a376 ACM	92	void __perf_evlist__set_sample_bit(struct perf_evlist *evlist,
	93	enum perf_event_sample_format bit);
	94	void __perf_evlist__reset_sample_bit(struct perf_evlist *evlist,
	95	enum perf_event_sample_format bit);
	96
	97	#define perf_evlist__set_sample_bit(evlist, bit) \
	98	__perf_evlist__set_sample_bit(evlist, PERF_SAMPLE_##bit)
	99
	100	#define perf_evlist__reset_sample_bit(evlist, bit) \
	101	__perf_evlist__reset_sample_bit(evlist, PERF_SAMPLE_##bit)
	102
745cefc5	103	int perf_evlist__set_filter(struct perf_evlist evlist, const char filter);
cfd70a26	104	int perf_evlist__set_filter_pid(struct perf_evlist *evlist, pid_t pid);
be199ada	105	int perf_evlist__set_filter_pids(struct perf_evlist evlist, size_t npids, pid_t pids);
745cefc5	106
da378962 ACM	107	struct perf_evsel *
	108	perf_evlist__find_tracepoint_by_id(struct perf_evlist *evlist, int id);
	109
a2f2804a DA	110	struct perf_evsel *
	111	perf_evlist__find_tracepoint_by_name(struct perf_evlist *evlist,
	112	const char *name);
	113
a91e5431 ACM	114	void perf_evlist__id_add(struct perf_evlist evlist, struct perf_evsel evsel,
a91e5431 ACM	115	int cpu, int thread, u64 id);
1c59612d JO	116	int perf_evlist__id_add_fd(struct perf_evlist *evlist,
	117	struct perf_evsel *evsel,
	118	int cpu, int thread, int fd);
3d3b5e95	119
ad6765dd ACM	120	int perf_evlist__add_pollfd(struct perf_evlist *evlist, int fd);
ad6765dd ACM	121	int perf_evlist__alloc_pollfd(struct perf_evlist *evlist);
1ddec7f0 ACM	122	int perf_evlist__filter_pollfd(struct perf_evlist *evlist, short revents_and_mask);
1ddec7f0 ACM	123
f66a889d ACM	124	int perf_evlist__poll(struct perf_evlist *evlist, int timeout);
f66a889d ACM	125
70db7533	126	struct perf_evsel perf_evlist__id2evsel(struct perf_evlist evlist, u64 id);
dddcf6ab AH	127	struct perf_evsel perf_evlist__id2evsel_strict(struct perf_evlist evlist,
dddcf6ab AH	128	u64 id);
70db7533	129
932a3594 JO	130	struct perf_sample_id perf_evlist__id2sid(struct perf_evlist evlist, u64 id);
932a3594 JO	131
316c7136	132	union perf_event perf_evlist__mmap_read(struct perf_evlist evlist, int idx);
04391deb	133
e24c7520 WN	134	union perf_event perf_evlist__mmap_read_backward(struct perf_evlist evlist,
	135	int idx);
	136	void perf_evlist__mmap_read_catchup(struct perf_evlist *evlist, int idx);
	137
8e50d384 ZZ	138	void perf_evlist__mmap_consume(struct perf_evlist *evlist, int idx);
8e50d384 ZZ	139
65aea233 WN	140	int perf_evlist__pause(struct perf_evlist *evlist);
65aea233 WN	141	int perf_evlist__resume(struct perf_evlist *evlist);
6a4bb04c	142	int perf_evlist__open(struct perf_evlist *evlist);
a74b4b66	143	void perf_evlist__close(struct perf_evlist *evlist);
727ab04e	144
e68ae9cf ACM	145	struct callchain_param;
e68ae9cf ACM	146
75562573 AH	147	void perf_evlist__set_id_pos(struct perf_evlist *evlist);
75562573 AH	148	bool perf_can_sample_identifier(void);
b757bb09	149	bool perf_can_record_switch_events(void);
83509565	150	bool perf_can_record_cpu_wide(void);
e68ae9cf ACM	151	void perf_evlist__config(struct perf_evlist evlist, struct record_opts opts,
e68ae9cf ACM	152	struct callchain_param *callchain);
b4006796	153	int record_opts__config(struct record_opts *opts);
0f82ebc4	154
35b9d88e	155	int perf_evlist__prepare_workload(struct perf_evlist *evlist,
602ad878	156	struct target *target,
55e162ea	157	const char *argv[], bool pipe_output,
735f7e0b ACM	158	void (exec_error)(int signo, siginfo_t info,
735f7e0b ACM	159	void *ucontext));
35b9d88e ACM	160	int perf_evlist__start_workload(struct perf_evlist *evlist);
35b9d88e ACM	161
724ce97e ACM	162	struct option;
724ce97e ACM	163
e9db1310	164	int __perf_evlist__parse_mmap_pages(unsigned int mmap_pages, const char str);
994a1f78 JO	165	int perf_evlist__parse_mmap_pages(const struct option *opt,
	166	const char *str,
	167	int unset);
	168
f5e7150c ACM	169	unsigned long perf_event_mlock_kb_in_pages(void);
f5e7150c ACM	170
718c602d AH	171	int perf_evlist__mmap_ex(struct perf_evlist *evlist, unsigned int pages,
	172	bool overwrite, unsigned int auxtrace_pages,
	173	bool auxtrace_overwrite);
50a682ce ACM	174	int perf_evlist__mmap(struct perf_evlist *evlist, unsigned int pages,
50a682ce ACM	175	bool overwrite);
7e2ed097 ACM	176	void perf_evlist__munmap(struct perf_evlist *evlist);
7e2ed097 ACM	177
4152ab37	178	void perf_evlist__disable(struct perf_evlist *evlist);
764e16a3	179	void perf_evlist__enable(struct perf_evlist *evlist);
2b56bcfb	180	void perf_evlist__toggle_enable(struct perf_evlist *evlist);
4152ab37	181
1c65056c AH	182	int perf_evlist__enable_event_idx(struct perf_evlist *evlist,
1c65056c AH	183	struct perf_evsel *evsel, int idx);
395c3070	184
81cce8de ACM	185	void perf_evlist__set_selected(struct perf_evlist *evlist,
	186	struct perf_evsel *evsel);
	187
d5bc056e AH	188	void perf_evlist__set_maps(struct perf_evlist evlist, struct cpu_map cpus,
d5bc056e AH	189	struct thread_map *threads);
602ad878	190	int perf_evlist__create_maps(struct perf_evlist evlist, struct target target);
23d4aad4	191	int perf_evlist__apply_filters(struct perf_evlist evlist, struct perf_evsel *err_evsel);
f8a95309	192
63dab225 ACM	193	void __perf_evlist__set_leader(struct list_head *list);
	194	void perf_evlist__set_leader(struct perf_evlist *evlist);
	195
9ede473c	196	u64 perf_evlist__read_format(struct perf_evlist *evlist);
75562573 AH	197	u64 __perf_evlist__combined_sample_type(struct perf_evlist *evlist);
75562573 AH	198	u64 perf_evlist__combined_sample_type(struct perf_evlist *evlist);
98df858e	199	u64 perf_evlist__combined_branch_type(struct perf_evlist *evlist);
0c21f736 ACM	200	bool perf_evlist__sample_id_all(struct perf_evlist *evlist);
0c21f736 ACM	201	u16 perf_evlist__id_hdr_size(struct perf_evlist *evlist);
74429964	202
a3f698fe	203	int perf_evlist__parse_sample(struct perf_evlist evlist, union perf_event event,
0807d2d8	204	struct perf_sample *sample);
cb0b29e0	205
0c21f736 ACM	206	bool perf_evlist__valid_sample_type(struct perf_evlist *evlist);
0c21f736 ACM	207	bool perf_evlist__valid_sample_id_all(struct perf_evlist *evlist);
9ede473c	208	bool perf_evlist__valid_read_format(struct perf_evlist *evlist);
0529bc1f JO	209
0529bc1f JO	210	void perf_evlist__splice_list_tail(struct perf_evlist *evlist,
f114d6ef	211	struct list_head *list);
0c21f736 ACM	212
	213	static inline struct perf_evsel perf_evlist__first(struct perf_evlist evlist)
	214	{
	215	return list_entry(evlist->entries.next, struct perf_evsel, node);
	216	}
	217
	218	static inline struct perf_evsel perf_evlist__last(struct perf_evlist evlist)
	219	{
	220	return list_entry(evlist->entries.prev, struct perf_evsel, node);
	221	}
78f067b3 ACM	222
78f067b3 ACM	223	size_t perf_evlist__fprintf(struct perf_evlist evlist, FILE fp);
0479b8b9	224
a8f23d8f	225	int perf_evlist__strerror_open(struct perf_evlist evlist, int err, char buf, size_t size);
956fa571	226	int perf_evlist__strerror_mmap(struct perf_evlist evlist, int err, char buf, size_t size);
6ef068cb	227
7b8283b5	228	static inline u64 perf_mmap__read_head(struct perf_mmap *mm)
0479b8b9 DA	229	{
0479b8b9 DA	230	struct perf_event_mmap_page *pc = mm->base;
7b8283b5	231	u64 head = ACCESS_ONCE(pc->data_head);
0479b8b9 DA	232	rmb();
	233	return head;
	234	}
	235
7b8283b5	236	static inline void perf_mmap__write_tail(struct perf_mmap *md, u64 tail)
0479b8b9 DA	237	{
	238	struct perf_event_mmap_page *pc = md->base;
	239
	240	/*
	241	* ensure all reads are done before we write the tail out.
	242	*/
a94d342b	243	mb();
0479b8b9 DA	244	pc->data_tail = tail;
	245	}
	246
c09ec622	247	bool perf_evlist__can_select_event(struct perf_evlist evlist, const char str);
a025e4f0 AH	248	void perf_evlist__to_front(struct perf_evlist *evlist,
	249	struct perf_evsel *move_evsel);
	250
0050f7aa ACM	251	/**
	252	* __evlist__for_each - iterate thru all the evsels
	253	* @list: list_head instance to iterate
	254	* @evsel: struct evsel iterator
	255	*/
	256	#define __evlist__for_each(list, evsel) \
	257	list_for_each_entry(evsel, list, node)
	258
	259	/**
	260	* evlist__for_each - iterate thru all the evsels
	261	* @evlist: evlist instance to iterate
	262	* @evsel: struct evsel iterator
	263	*/
	264	#define evlist__for_each(evlist, evsel) \
	265	__evlist__for_each(&(evlist)->entries, evsel)
	266
	267	/**
	268	* __evlist__for_each_continue - continue iteration thru all the evsels
	269	* @list: list_head instance to iterate
	270	* @evsel: struct evsel iterator
	271	*/
	272	#define __evlist__for_each_continue(list, evsel) \
	273	list_for_each_entry_continue(evsel, list, node)
	274
	275	/**
	276	* evlist__for_each_continue - continue iteration thru all the evsels
	277	* @evlist: evlist instance to iterate
	278	* @evsel: struct evsel iterator
	279	*/
	280	#define evlist__for_each_continue(evlist, evsel) \
	281	__evlist__for_each_continue(&(evlist)->entries, evsel)
	282
	283	/**
	284	* __evlist__for_each_reverse - iterate thru all the evsels in reverse order
	285	* @list: list_head instance to iterate
	286	* @evsel: struct evsel iterator
	287	*/
	288	#define __evlist__for_each_reverse(list, evsel) \
	289	list_for_each_entry_reverse(evsel, list, node)
	290
	291	/**
	292	* evlist__for_each_reverse - iterate thru all the evsels in reverse order
	293	* @evlist: evlist instance to iterate
	294	* @evsel: struct evsel iterator
	295	*/
	296	#define evlist__for_each_reverse(evlist, evsel) \
	297	__evlist__for_each_reverse(&(evlist)->entries, evsel)
	298
	299	/**
	300	* __evlist__for_each_safe - safely iterate thru all the evsels
	301	* @list: list_head instance to iterate
	302	* @tmp: struct evsel temp iterator
	303	* @evsel: struct evsel iterator
	304	*/
	305	#define __evlist__for_each_safe(list, tmp, evsel) \
	306	list_for_each_entry_safe(evsel, tmp, list, node)
	307
	308	/**
	309	* evlist__for_each_safe - safely iterate thru all the evsels
	310	* @evlist: evlist instance to iterate
	311	* @evsel: struct evsel iterator
	312	* @tmp: struct evsel temp iterator
	313	*/
	314	#define evlist__for_each_safe(evlist, tmp, evsel) \
315	__evlist__for_each_safe(&(evlist)->entries, tmp, evsel)
c09ec622	316
60b0896c AH	317	void perf_evlist__set_tracking_event(struct perf_evlist *evlist,
60b0896c AH	318	struct perf_evsel *tracking_evsel);
45cf6c33 JO	319
45cf6c33 JO	320	void perf_event_attr__set_max_precise_ip(struct perf_event_attr *attr);
7630b3e2 WN	321
	322	struct perf_evsel *
	323	perf_evlist__find_evsel_by_str(struct perf_evlist evlist, const char str);
361c99a6	324	#endif /* __PERF_EVLIST_H */