blob: 3f156ccc1acb4c7b93d85620438844f5ba3744ac [file] [log] [blame]
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -02001#ifndef __PERF_EVSEL_H
2#define __PERF_EVSEL_H 1
3
4#include <linux/list.h>
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -02005#include <stdbool.h>
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -03006#include <stddef.h>
David Howellsd2709c72012-11-19 22:21:03 +00007#include <linux/perf_event.h>
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -02008#include "types.h"
9#include "xyarray.h"
Stephane Eranian023695d2011-02-14 11:20:01 +020010#include "cgroup.h"
Arnaldo Carvalho de Meloe248de32011-03-05 21:40:06 -030011#include "hist.h"
Namhyung Kim759ff492013-03-05 14:53:26 +090012#include "symbol.h"
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -020013
14struct perf_counts_values {
15 union {
16 struct {
17 u64 val;
18 u64 ena;
19 u64 run;
20 };
21 u64 values[3];
22 };
23};
24
25struct perf_counts {
26 s8 scaled;
27 struct perf_counts_values aggr;
28 struct perf_counts_values cpu[];
29};
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020030
Arnaldo Carvalho de Melo70db7532011-01-12 22:39:13 -020031struct perf_evsel;
32
33/*
34 * Per fd, to map back from PERF_SAMPLE_ID to evsel, only used when there are
35 * more than one entry in the evlist.
36 */
37struct perf_sample_id {
38 struct hlist_node node;
39 u64 id;
40 struct perf_evsel *evsel;
41};
42
Stephane Eranianf0c55bc2011-02-16 15:10:01 +020043/** struct perf_evsel - event selector
44 *
45 * @name - Can be set to retain the original event name passed by the user,
46 * so that when showing results in tools such as 'perf stat', we
47 * show the name used, not some alias.
48 */
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020049struct perf_evsel {
50 struct list_head node;
51 struct perf_event_attr attr;
52 char *filter;
53 struct xyarray *fd;
Arnaldo Carvalho de Meloa91e5432011-03-10 11:15:54 -030054 struct xyarray *sample_id;
55 u64 *id;
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -020056 struct perf_counts *counts;
Stephane Eranianc7a79c42013-01-29 12:47:43 +010057 struct perf_counts *prev_raw_counts;
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020058 int idx;
Robert Richterf4d83432012-08-16 21:10:17 +020059 u32 ids;
Arnaldo Carvalho de Meloe248de32011-03-05 21:40:06 -030060 struct hists hists;
Stephane Eranianf0c55bc2011-02-16 15:10:01 +020061 char *name;
Arnaldo Carvalho de Melofcf65bf2012-08-07 09:58:03 -030062 struct event_format *tp_format;
Arnaldo Carvalho de Meloa91e5432011-03-10 11:15:54 -030063 union {
64 void *priv;
65 off_t id_offset;
66 };
Stephane Eranian023695d2011-02-14 11:20:01 +020067 struct cgroup_sel *cgrp;
Arnaldo Carvalho de Meloee29be62011-11-28 17:57:40 -020068 struct {
69 void *func;
70 void *data;
71 } handler;
Yan, Zheng7ae92e72012-09-10 15:53:50 +080072 struct cpu_map *cpus;
Arnaldo Carvalho de Melobde09462012-08-01 18:53:11 -030073 unsigned int sample_size;
David Ahern2cee77c2011-05-30 08:55:59 -060074 bool supported;
Arnaldo Carvalho de Melo0807d2d2012-09-26 12:48:18 -030075 bool needs_swap;
Jiri Olsaf5b11352012-08-08 12:21:54 +020076 /* parse modifier helper */
77 int exclude_GH;
Namhyung Kim97f63e42013-01-22 18:09:29 +090078 int nr_members;
Jiri Olsa6a4bb042012-08-08 12:22:36 +020079 struct perf_evsel *leader;
80 char *group_name;
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020081};
82
Namhyung Kim29d720e2013-01-22 18:09:33 +090083#define hists_to_evsel(h) container_of(h, struct perf_evsel, hists)
84
Arnaldo Carvalho de Melo86bd5e82011-01-03 23:09:46 -020085struct cpu_map;
86struct thread_map;
Arnaldo Carvalho de Melo70082dd2011-01-12 17:03:24 -020087struct perf_evlist;
Arnaldo Carvalho de Melo0f82ebc2011-11-08 14:41:57 -020088struct perf_record_opts;
Arnaldo Carvalho de Melo86bd5e82011-01-03 23:09:46 -020089
Lin Ming23a2f3a2011-01-07 11:11:09 +080090struct perf_evsel *perf_evsel__new(struct perf_event_attr *attr, int idx);
Arnaldo Carvalho de Meloefd2b922012-09-18 11:21:50 -030091struct perf_evsel *perf_evsel__newtp(const char *sys, const char *name, int idx);
Arnaldo Carvalho de Melo201b7332012-09-26 20:24:19 -030092
93struct event_format *event_format__new(const char *sys, const char *name);
94
Arnaldo Carvalho de Meloef1d1af2011-01-18 21:41:45 -020095void perf_evsel__init(struct perf_evsel *evsel,
96 struct perf_event_attr *attr, int idx);
97void perf_evsel__exit(struct perf_evsel *evsel);
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020098void perf_evsel__delete(struct perf_evsel *evsel);
99
Arnaldo Carvalho de Melo0f82ebc2011-11-08 14:41:57 -0200100void perf_evsel__config(struct perf_evsel *evsel,
Jiri Olsacac21422012-11-12 18:34:00 +0100101 struct perf_record_opts *opts);
Arnaldo Carvalho de Melo0f82ebc2011-11-08 14:41:57 -0200102
Arnaldo Carvalho de Melo0b668bc2012-06-11 14:08:07 -0300103bool perf_evsel__is_cache_op_valid(u8 type, u8 op);
104
105#define PERF_EVSEL__MAX_ALIASES 8
106
107extern const char *perf_evsel__hw_cache[PERF_COUNT_HW_CACHE_MAX]
108 [PERF_EVSEL__MAX_ALIASES];
109extern const char *perf_evsel__hw_cache_op[PERF_COUNT_HW_CACHE_OP_MAX]
110 [PERF_EVSEL__MAX_ALIASES];
Arnaldo Carvalho de Melo8ad70132012-09-06 13:11:18 -0300111extern const char *perf_evsel__hw_cache_result[PERF_COUNT_HW_CACHE_RESULT_MAX]
112 [PERF_EVSEL__MAX_ALIASES];
113extern const char *perf_evsel__hw_names[PERF_COUNT_HW_MAX];
114extern const char *perf_evsel__sw_names[PERF_COUNT_SW_MAX];
Arnaldo Carvalho de Melo0b668bc2012-06-11 14:08:07 -0300115int __perf_evsel__hw_cache_type_op_res_name(u8 type, u8 op, u8 result,
116 char *bf, size_t size);
Arnaldo Carvalho de Melo7289f832012-06-12 12:34:58 -0300117const char *perf_evsel__name(struct perf_evsel *evsel);
Namhyung Kim717e2632013-01-22 18:09:44 +0900118const char *perf_evsel__group_name(struct perf_evsel *evsel);
119int perf_evsel__group_desc(struct perf_evsel *evsel, char *buf, size_t size);
Arnaldo Carvalho de Meloc4104312012-05-25 16:38:11 -0300120
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200121int perf_evsel__alloc_fd(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo70db7532011-01-12 22:39:13 -0200122int perf_evsel__alloc_id(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -0200123int perf_evsel__alloc_counts(struct perf_evsel *evsel, int ncpus);
Frederik Deweerdta7e191c2013-03-01 13:02:27 -0500124void perf_evsel__reset_counts(struct perf_evsel *evsel, int ncpus);
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200125void perf_evsel__free_fd(struct perf_evsel *evsel);
Arnaldo Carvalho de Melo70db7532011-01-12 22:39:13 -0200126void perf_evsel__free_id(struct perf_evsel *evsel);
Namhyung Kim43f8e762013-01-25 10:44:44 +0900127void perf_evsel__free_counts(struct perf_evsel *evsel);
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -0200128void perf_evsel__close_fd(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200129
Arnaldo Carvalho de Melo7be5ebe2012-12-10 14:53:43 -0300130void __perf_evsel__set_sample_bit(struct perf_evsel *evsel,
131 enum perf_event_sample_format bit);
132void __perf_evsel__reset_sample_bit(struct perf_evsel *evsel,
133 enum perf_event_sample_format bit);
134
135#define perf_evsel__set_sample_bit(evsel, bit) \
136 __perf_evsel__set_sample_bit(evsel, PERF_SAMPLE_##bit)
137
138#define perf_evsel__reset_sample_bit(evsel, bit) \
139 __perf_evsel__reset_sample_bit(evsel, PERF_SAMPLE_##bit)
140
Arnaldo Carvalho de Melo7a5a5ca2012-12-10 15:21:30 -0300141void perf_evsel__set_sample_id(struct perf_evsel *evsel);
142
Arnaldo Carvalho de Melo745cefc2012-09-26 15:07:39 -0300143int perf_evsel__set_filter(struct perf_evsel *evsel, int ncpus, int nthreads,
144 const char *filter);
145
Arnaldo Carvalho de Melof08199d2011-01-11 23:42:19 -0200146int perf_evsel__open_per_cpu(struct perf_evsel *evsel,
Jiri Olsa6a4bb042012-08-08 12:22:36 +0200147 struct cpu_map *cpus);
Arnaldo Carvalho de Melof08199d2011-01-11 23:42:19 -0200148int perf_evsel__open_per_thread(struct perf_evsel *evsel,
Jiri Olsa6a4bb042012-08-08 12:22:36 +0200149 struct thread_map *threads);
Arnaldo Carvalho de Melof08199d2011-01-11 23:42:19 -0200150int perf_evsel__open(struct perf_evsel *evsel, struct cpu_map *cpus,
Jiri Olsa6a4bb042012-08-08 12:22:36 +0200151 struct thread_map *threads);
Arnaldo Carvalho de Melo727ab042011-10-25 10:42:19 -0200152void perf_evsel__close(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo48290602011-01-03 17:48:12 -0200153
Arnaldo Carvalho de Melo5555ded2012-09-11 19:24:23 -0300154struct perf_sample;
155
Arnaldo Carvalho de Melo5d2074e2012-09-26 20:22:00 -0300156void *perf_evsel__rawptr(struct perf_evsel *evsel, struct perf_sample *sample,
Arnaldo Carvalho de Melo5555ded2012-09-11 19:24:23 -0300157 const char *name);
158u64 perf_evsel__intval(struct perf_evsel *evsel, struct perf_sample *sample,
159 const char *name);
160
Arnaldo Carvalho de Melo5d2074e2012-09-26 20:22:00 -0300161static inline char *perf_evsel__strval(struct perf_evsel *evsel,
162 struct perf_sample *sample,
163 const char *name)
164{
165 return perf_evsel__rawptr(evsel, sample, name);
166}
167
Arnaldo Carvalho de Meloefd2b922012-09-18 11:21:50 -0300168struct format_field;
169
170struct format_field *perf_evsel__field(struct perf_evsel *evsel, const char *name);
171
Arnaldo Carvalho de Melodaec78a2011-01-03 16:49:44 -0200172#define perf_evsel__match(evsel, t, c) \
173 (evsel->attr.type == PERF_TYPE_##t && \
174 evsel->attr.config == PERF_COUNT_##c)
175
Jiri Olsa863e4512012-09-06 17:46:55 +0200176static inline bool perf_evsel__match2(struct perf_evsel *e1,
177 struct perf_evsel *e2)
178{
179 return (e1->attr.type == e2->attr.type) &&
180 (e1->attr.config == e2->attr.config);
181}
182
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -0200183int __perf_evsel__read_on_cpu(struct perf_evsel *evsel,
184 int cpu, int thread, bool scale);
185
186/**
187 * perf_evsel__read_on_cpu - Read out the results on a CPU and thread
188 *
189 * @evsel - event selector to read value
190 * @cpu - CPU of interest
191 * @thread - thread of interest
192 */
193static inline int perf_evsel__read_on_cpu(struct perf_evsel *evsel,
194 int cpu, int thread)
195{
196 return __perf_evsel__read_on_cpu(evsel, cpu, thread, false);
197}
198
199/**
200 * perf_evsel__read_on_cpu_scaled - Read out the results on a CPU and thread, scaled
201 *
202 * @evsel - event selector to read value
203 * @cpu - CPU of interest
204 * @thread - thread of interest
205 */
206static inline int perf_evsel__read_on_cpu_scaled(struct perf_evsel *evsel,
207 int cpu, int thread)
208{
209 return __perf_evsel__read_on_cpu(evsel, cpu, thread, true);
210}
211
212int __perf_evsel__read(struct perf_evsel *evsel, int ncpus, int nthreads,
213 bool scale);
214
215/**
216 * perf_evsel__read - Read the aggregate results on all CPUs
217 *
218 * @evsel - event selector to read value
219 * @ncpus - Number of cpus affected, from zero
220 * @nthreads - Number of threads affected, from zero
221 */
222static inline int perf_evsel__read(struct perf_evsel *evsel,
223 int ncpus, int nthreads)
224{
225 return __perf_evsel__read(evsel, ncpus, nthreads, false);
226}
227
228/**
229 * perf_evsel__read_scaled - Read the aggregate results on all CPUs, scaled
230 *
231 * @evsel - event selector to read value
232 * @ncpus - Number of cpus affected, from zero
233 * @nthreads - Number of threads affected, from zero
234 */
235static inline int perf_evsel__read_scaled(struct perf_evsel *evsel,
236 int ncpus, int nthreads)
237{
238 return __perf_evsel__read(evsel, ncpus, nthreads, true);
239}
240
Jiri Olsa4bf9ce12012-03-22 14:37:26 +0100241void hists__init(struct hists *hists);
242
Arnaldo Carvalho de Meloa3f698f2012-08-02 12:23:46 -0300243int perf_evsel__parse_sample(struct perf_evsel *evsel, union perf_event *event,
Arnaldo Carvalho de Melo0807d2d2012-09-26 12:48:18 -0300244 struct perf_sample *sample);
Arnaldo Carvalho de Melo0c21f732012-08-14 16:42:15 -0300245
246static inline struct perf_evsel *perf_evsel__next(struct perf_evsel *evsel)
247{
248 return list_entry(evsel->node.next, struct perf_evsel, node);
249}
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -0300250
Namhyung Kim759ff492013-03-05 14:53:26 +0900251/**
252 * perf_evsel__is_group_leader - Return whether given evsel is a leader event
253 *
254 * @evsel - evsel selector to be tested
255 *
256 * Return %true if @evsel is a group leader or a stand-alone event
257 */
Namhyung Kim823254e2012-11-29 15:38:30 +0900258static inline bool perf_evsel__is_group_leader(const struct perf_evsel *evsel)
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -0300259{
Namhyung Kim823254e2012-11-29 15:38:30 +0900260 return evsel->leader == evsel;
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -0300261}
Arnaldo Carvalho de Melo0698aed2012-12-10 18:17:08 -0300262
Namhyung Kim759ff492013-03-05 14:53:26 +0900263/**
264 * perf_evsel__is_group_event - Return whether given evsel is a group event
265 *
266 * @evsel - evsel selector to be tested
267 *
268 * Return %true iff event group view is enabled and @evsel is a actual group
269 * leader which has other members in the group
270 */
271static inline bool perf_evsel__is_group_event(struct perf_evsel *evsel)
272{
273 if (!symbol_conf.event_group)
274 return false;
275
276 return perf_evsel__is_group_leader(evsel) && evsel->nr_members > 1;
277}
278
Arnaldo Carvalho de Melo0698aed2012-12-10 18:17:08 -0300279struct perf_attr_details {
280 bool freq;
281 bool verbose;
Arnaldo Carvalho de Meloe35ef3552013-02-06 17:20:02 -0300282 bool event_group;
Arnaldo Carvalho de Melo0698aed2012-12-10 18:17:08 -0300283};
284
285int perf_evsel__fprintf(struct perf_evsel *evsel,
286 struct perf_attr_details *details, FILE *fp);
Arnaldo Carvalho de Meloc0a54342012-12-13 14:16:30 -0300287
288bool perf_evsel__fallback(struct perf_evsel *evsel, int err,
289 char *msg, size_t msgsize);
Arnaldo Carvalho de Melo56e52e82012-12-13 15:10:58 -0300290int perf_evsel__open_strerror(struct perf_evsel *evsel,
291 struct perf_target *target,
292 int err, char *msg, size_t size);
Namhyung Kim97f63e42013-01-22 18:09:29 +0900293
294static inline int perf_evsel__group_idx(struct perf_evsel *evsel)
295{
296 return evsel->idx - evsel->leader->idx;
297}
Namhyung Kim717e2632013-01-22 18:09:44 +0900298
299#define for_each_group_member(_evsel, _leader) \
300for ((_evsel) = list_entry((_leader)->node.next, struct perf_evsel, node); \
301 (_evsel) && (_evsel)->leader == (_leader); \
302 (_evsel) = list_entry((_evsel)->node.next, struct perf_evsel, node))
303
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200304#endif /* __PERF_EVSEL_H */