blob: f1b325665aae8201b9696b2c3c5a6a64e009ffb7 [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;
Jiri Olsae4caec02012-10-10 18:52:24 +020041
42 /* Holds total ID period value for PERF_SAMPLE_READ processing. */
43 u64 period;
Arnaldo Carvalho de Melo70db7532011-01-12 22:39:13 -020044};
45
Stephane Eranianf0c55bc2011-02-16 15:10:01 +020046/** struct perf_evsel - event selector
47 *
48 * @name - Can be set to retain the original event name passed by the user,
49 * so that when showing results in tools such as 'perf stat', we
50 * show the name used, not some alias.
Adrian Hunter75562572013-08-27 11:23:09 +030051 * @id_pos: the position of the event id (PERF_SAMPLE_ID or
52 * PERF_SAMPLE_IDENTIFIER) in a sample event i.e. in the array of
53 * struct sample_event
54 * @is_pos: the position (counting backwards) of the event id (PERF_SAMPLE_ID or
55 * PERF_SAMPLE_IDENTIFIER) in a non-sample event i.e. if sample_id_all
56 * is used there is an id sample appended to non-sample events
Stephane Eranianf0c55bc2011-02-16 15:10:01 +020057 */
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020058struct perf_evsel {
59 struct list_head node;
60 struct perf_event_attr attr;
61 char *filter;
62 struct xyarray *fd;
Arnaldo Carvalho de Meloa91e5432011-03-10 11:15:54 -030063 struct xyarray *sample_id;
64 u64 *id;
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -020065 struct perf_counts *counts;
Stephane Eranianc7a79c42013-01-29 12:47:43 +010066 struct perf_counts *prev_raw_counts;
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020067 int idx;
Robert Richterf4d83432012-08-16 21:10:17 +020068 u32 ids;
Arnaldo Carvalho de Meloe248de32011-03-05 21:40:06 -030069 struct hists hists;
Stephane Eranianf0c55bc2011-02-16 15:10:01 +020070 char *name;
Stephane Eranian410136f2013-11-12 17:58:49 +010071 double scale;
72 const char *unit;
Arnaldo Carvalho de Melofcf65bf2012-08-07 09:58:03 -030073 struct event_format *tp_format;
Arnaldo Carvalho de Meloa91e5432011-03-10 11:15:54 -030074 union {
75 void *priv;
76 off_t id_offset;
77 };
Stephane Eranian023695d2011-02-14 11:20:01 +020078 struct cgroup_sel *cgrp;
Arnaldo Carvalho de Melo744a9712013-11-06 10:17:38 -030079 void *handler;
Yan, Zheng7ae92e72012-09-10 15:53:50 +080080 struct cpu_map *cpus;
Arnaldo Carvalho de Melobde09462012-08-01 18:53:11 -030081 unsigned int sample_size;
Adrian Hunter75562572013-08-27 11:23:09 +030082 int id_pos;
83 int is_pos;
David Ahern2cee77c2011-05-30 08:55:59 -060084 bool supported;
Arnaldo Carvalho de Melo0807d2d2012-09-26 12:48:18 -030085 bool needs_swap;
Jiri Olsaf5b11352012-08-08 12:21:54 +020086 /* parse modifier helper */
87 int exclude_GH;
Namhyung Kim97f63e42013-01-22 18:09:29 +090088 int nr_members;
Jiri Olsa3c176312012-10-10 17:39:03 +020089 int sample_read;
Jiri Olsa6a4bb042012-08-08 12:22:36 +020090 struct perf_evsel *leader;
91 char *group_name;
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -020092};
93
Namhyung Kim29d720e2013-01-22 18:09:33 +090094#define hists_to_evsel(h) container_of(h, struct perf_evsel, hists)
95
Arnaldo Carvalho de Melo86bd5e82011-01-03 23:09:46 -020096struct cpu_map;
97struct thread_map;
Arnaldo Carvalho de Melo70082dd2011-01-12 17:03:24 -020098struct perf_evlist;
Arnaldo Carvalho de Melob4006792013-12-19 14:43:45 -030099struct record_opts;
Arnaldo Carvalho de Melo86bd5e82011-01-03 23:09:46 -0200100
Arnaldo Carvalho de Meloef503832013-11-07 16:41:19 -0300101struct perf_evsel *perf_evsel__new_idx(struct perf_event_attr *attr, int idx);
102
103static inline struct perf_evsel *perf_evsel__new(struct perf_event_attr *attr)
104{
105 return perf_evsel__new_idx(attr, 0);
106}
107
108struct perf_evsel *perf_evsel__newtp_idx(const char *sys, const char *name, int idx);
109
110static inline struct perf_evsel *perf_evsel__newtp(const char *sys, const char *name)
111{
112 return perf_evsel__newtp_idx(sys, name, 0);
113}
Arnaldo Carvalho de Melo201b7332012-09-26 20:24:19 -0300114
115struct event_format *event_format__new(const char *sys, const char *name);
116
Arnaldo Carvalho de Meloef1d1af2011-01-18 21:41:45 -0200117void perf_evsel__init(struct perf_evsel *evsel,
118 struct perf_event_attr *attr, int idx);
119void perf_evsel__exit(struct perf_evsel *evsel);
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200120void perf_evsel__delete(struct perf_evsel *evsel);
121
Arnaldo Carvalho de Melo0f82ebc2011-11-08 14:41:57 -0200122void perf_evsel__config(struct perf_evsel *evsel,
Arnaldo Carvalho de Melob4006792013-12-19 14:43:45 -0300123 struct record_opts *opts);
Arnaldo Carvalho de Melo0f82ebc2011-11-08 14:41:57 -0200124
Adrian Hunter75562572013-08-27 11:23:09 +0300125int __perf_evsel__sample_size(u64 sample_type);
126void perf_evsel__calc_id_pos(struct perf_evsel *evsel);
127
Arnaldo Carvalho de Melo0b668bc2012-06-11 14:08:07 -0300128bool perf_evsel__is_cache_op_valid(u8 type, u8 op);
129
130#define PERF_EVSEL__MAX_ALIASES 8
131
132extern const char *perf_evsel__hw_cache[PERF_COUNT_HW_CACHE_MAX]
133 [PERF_EVSEL__MAX_ALIASES];
134extern const char *perf_evsel__hw_cache_op[PERF_COUNT_HW_CACHE_OP_MAX]
135 [PERF_EVSEL__MAX_ALIASES];
Arnaldo Carvalho de Melo8ad70132012-09-06 13:11:18 -0300136extern const char *perf_evsel__hw_cache_result[PERF_COUNT_HW_CACHE_RESULT_MAX]
137 [PERF_EVSEL__MAX_ALIASES];
138extern const char *perf_evsel__hw_names[PERF_COUNT_HW_MAX];
139extern const char *perf_evsel__sw_names[PERF_COUNT_SW_MAX];
Arnaldo Carvalho de Melo0b668bc2012-06-11 14:08:07 -0300140int __perf_evsel__hw_cache_type_op_res_name(u8 type, u8 op, u8 result,
141 char *bf, size_t size);
Arnaldo Carvalho de Melo7289f832012-06-12 12:34:58 -0300142const char *perf_evsel__name(struct perf_evsel *evsel);
Stephane Eranian410136f2013-11-12 17:58:49 +0100143
Namhyung Kim717e2632013-01-22 18:09:44 +0900144const char *perf_evsel__group_name(struct perf_evsel *evsel);
145int perf_evsel__group_desc(struct perf_evsel *evsel, char *buf, size_t size);
Arnaldo Carvalho de Meloc4104312012-05-25 16:38:11 -0300146
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200147int perf_evsel__alloc_fd(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo70db7532011-01-12 22:39:13 -0200148int perf_evsel__alloc_id(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -0200149int perf_evsel__alloc_counts(struct perf_evsel *evsel, int ncpus);
Frederik Deweerdta7e191c2013-03-01 13:02:27 -0500150void perf_evsel__reset_counts(struct perf_evsel *evsel, int ncpus);
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200151void perf_evsel__free_fd(struct perf_evsel *evsel);
Arnaldo Carvalho de Melo70db7532011-01-12 22:39:13 -0200152void perf_evsel__free_id(struct perf_evsel *evsel);
Namhyung Kim43f8e762013-01-25 10:44:44 +0900153void perf_evsel__free_counts(struct perf_evsel *evsel);
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -0200154void perf_evsel__close_fd(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200155
Arnaldo Carvalho de Melo7be5ebe2012-12-10 14:53:43 -0300156void __perf_evsel__set_sample_bit(struct perf_evsel *evsel,
157 enum perf_event_sample_format bit);
158void __perf_evsel__reset_sample_bit(struct perf_evsel *evsel,
159 enum perf_event_sample_format bit);
160
161#define perf_evsel__set_sample_bit(evsel, bit) \
162 __perf_evsel__set_sample_bit(evsel, PERF_SAMPLE_##bit)
163
164#define perf_evsel__reset_sample_bit(evsel, bit) \
165 __perf_evsel__reset_sample_bit(evsel, PERF_SAMPLE_##bit)
166
Adrian Hunter75562572013-08-27 11:23:09 +0300167void perf_evsel__set_sample_id(struct perf_evsel *evsel,
168 bool use_sample_identifier);
Arnaldo Carvalho de Melo7a5a5ca2012-12-10 15:21:30 -0300169
Arnaldo Carvalho de Melo745cefc2012-09-26 15:07:39 -0300170int perf_evsel__set_filter(struct perf_evsel *evsel, int ncpus, int nthreads,
171 const char *filter);
Andi Kleene2407be2013-08-02 17:41:10 -0700172int perf_evsel__enable(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo745cefc2012-09-26 15:07:39 -0300173
Arnaldo Carvalho de Melof08199d2011-01-11 23:42:19 -0200174int perf_evsel__open_per_cpu(struct perf_evsel *evsel,
Jiri Olsa6a4bb042012-08-08 12:22:36 +0200175 struct cpu_map *cpus);
Arnaldo Carvalho de Melof08199d2011-01-11 23:42:19 -0200176int perf_evsel__open_per_thread(struct perf_evsel *evsel,
Jiri Olsa6a4bb042012-08-08 12:22:36 +0200177 struct thread_map *threads);
Arnaldo Carvalho de Melof08199d2011-01-11 23:42:19 -0200178int perf_evsel__open(struct perf_evsel *evsel, struct cpu_map *cpus,
Jiri Olsa6a4bb042012-08-08 12:22:36 +0200179 struct thread_map *threads);
Arnaldo Carvalho de Melo727ab042011-10-25 10:42:19 -0200180void perf_evsel__close(struct perf_evsel *evsel, int ncpus, int nthreads);
Arnaldo Carvalho de Melo48290602011-01-03 17:48:12 -0200181
Arnaldo Carvalho de Melo5555ded2012-09-11 19:24:23 -0300182struct perf_sample;
183
Arnaldo Carvalho de Melo5d2074e2012-09-26 20:22:00 -0300184void *perf_evsel__rawptr(struct perf_evsel *evsel, struct perf_sample *sample,
Arnaldo Carvalho de Melo5555ded2012-09-11 19:24:23 -0300185 const char *name);
186u64 perf_evsel__intval(struct perf_evsel *evsel, struct perf_sample *sample,
187 const char *name);
188
Arnaldo Carvalho de Melo5d2074e2012-09-26 20:22:00 -0300189static inline char *perf_evsel__strval(struct perf_evsel *evsel,
190 struct perf_sample *sample,
191 const char *name)
192{
193 return perf_evsel__rawptr(evsel, sample, name);
194}
195
Arnaldo Carvalho de Meloefd2b922012-09-18 11:21:50 -0300196struct format_field;
197
198struct format_field *perf_evsel__field(struct perf_evsel *evsel, const char *name);
199
Arnaldo Carvalho de Melodaec78a2011-01-03 16:49:44 -0200200#define perf_evsel__match(evsel, t, c) \
201 (evsel->attr.type == PERF_TYPE_##t && \
202 evsel->attr.config == PERF_COUNT_##c)
203
Jiri Olsa863e4512012-09-06 17:46:55 +0200204static inline bool perf_evsel__match2(struct perf_evsel *e1,
205 struct perf_evsel *e2)
206{
207 return (e1->attr.type == e2->attr.type) &&
208 (e1->attr.config == e2->attr.config);
209}
210
Andi Kleen4cabc3d2013-08-21 16:47:26 -0700211#define perf_evsel__cmp(a, b) \
212 ((a) && \
213 (b) && \
214 (a)->attr.type == (b)->attr.type && \
215 (a)->attr.config == (b)->attr.config)
216
Arnaldo Carvalho de Meloc52b12e2011-01-03 17:45:52 -0200217int __perf_evsel__read_on_cpu(struct perf_evsel *evsel,
218 int cpu, int thread, bool scale);
219
220/**
221 * perf_evsel__read_on_cpu - Read out the results on a CPU and thread
222 *
223 * @evsel - event selector to read value
224 * @cpu - CPU of interest
225 * @thread - thread of interest
226 */
227static inline int perf_evsel__read_on_cpu(struct perf_evsel *evsel,
228 int cpu, int thread)
229{
230 return __perf_evsel__read_on_cpu(evsel, cpu, thread, false);
231}
232
233/**
234 * perf_evsel__read_on_cpu_scaled - Read out the results on a CPU and thread, scaled
235 *
236 * @evsel - event selector to read value
237 * @cpu - CPU of interest
238 * @thread - thread of interest
239 */
240static inline int perf_evsel__read_on_cpu_scaled(struct perf_evsel *evsel,
241 int cpu, int thread)
242{
243 return __perf_evsel__read_on_cpu(evsel, cpu, thread, true);
244}
245
246int __perf_evsel__read(struct perf_evsel *evsel, int ncpus, int nthreads,
247 bool scale);
248
249/**
250 * perf_evsel__read - Read the aggregate results on all CPUs
251 *
252 * @evsel - event selector to read value
253 * @ncpus - Number of cpus affected, from zero
254 * @nthreads - Number of threads affected, from zero
255 */
256static inline int perf_evsel__read(struct perf_evsel *evsel,
257 int ncpus, int nthreads)
258{
259 return __perf_evsel__read(evsel, ncpus, nthreads, false);
260}
261
262/**
263 * perf_evsel__read_scaled - Read the aggregate results on all CPUs, scaled
264 *
265 * @evsel - event selector to read value
266 * @ncpus - Number of cpus affected, from zero
267 * @nthreads - Number of threads affected, from zero
268 */
269static inline int perf_evsel__read_scaled(struct perf_evsel *evsel,
270 int ncpus, int nthreads)
271{
272 return __perf_evsel__read(evsel, ncpus, nthreads, true);
273}
274
Jiri Olsa4bf9ce12012-03-22 14:37:26 +0100275void hists__init(struct hists *hists);
276
Arnaldo Carvalho de Meloa3f698f2012-08-02 12:23:46 -0300277int perf_evsel__parse_sample(struct perf_evsel *evsel, union perf_event *event,
Arnaldo Carvalho de Melo0807d2d2012-09-26 12:48:18 -0300278 struct perf_sample *sample);
Arnaldo Carvalho de Melo0c21f732012-08-14 16:42:15 -0300279
280static inline struct perf_evsel *perf_evsel__next(struct perf_evsel *evsel)
281{
282 return list_entry(evsel->node.next, struct perf_evsel, node);
283}
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -0300284
Arnaldo Carvalho de Melod87fcb42013-11-13 15:56:40 -0300285static inline struct perf_evsel *perf_evsel__prev(struct perf_evsel *evsel)
286{
287 return list_entry(evsel->node.prev, struct perf_evsel, node);
288}
289
Namhyung Kim759ff492013-03-05 14:53:26 +0900290/**
291 * perf_evsel__is_group_leader - Return whether given evsel is a leader event
292 *
293 * @evsel - evsel selector to be tested
294 *
295 * Return %true if @evsel is a group leader or a stand-alone event
296 */
Namhyung Kim823254e2012-11-29 15:38:30 +0900297static inline bool perf_evsel__is_group_leader(const struct perf_evsel *evsel)
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -0300298{
Namhyung Kim823254e2012-11-29 15:38:30 +0900299 return evsel->leader == evsel;
Arnaldo Carvalho de Melo07ac0022012-11-13 17:27:28 -0300300}
Arnaldo Carvalho de Melo0698aed2012-12-10 18:17:08 -0300301
Namhyung Kim759ff492013-03-05 14:53:26 +0900302/**
303 * perf_evsel__is_group_event - Return whether given evsel is a group event
304 *
305 * @evsel - evsel selector to be tested
306 *
307 * Return %true iff event group view is enabled and @evsel is a actual group
308 * leader which has other members in the group
309 */
310static inline bool perf_evsel__is_group_event(struct perf_evsel *evsel)
311{
312 if (!symbol_conf.event_group)
313 return false;
314
315 return perf_evsel__is_group_leader(evsel) && evsel->nr_members > 1;
316}
317
Arnaldo Carvalho de Melo0698aed2012-12-10 18:17:08 -0300318struct perf_attr_details {
319 bool freq;
320 bool verbose;
Arnaldo Carvalho de Meloe35ef3552013-02-06 17:20:02 -0300321 bool event_group;
Arnaldo Carvalho de Melo0698aed2012-12-10 18:17:08 -0300322};
323
324int perf_evsel__fprintf(struct perf_evsel *evsel,
325 struct perf_attr_details *details, FILE *fp);
Arnaldo Carvalho de Meloc0a54342012-12-13 14:16:30 -0300326
327bool perf_evsel__fallback(struct perf_evsel *evsel, int err,
328 char *msg, size_t msgsize);
Arnaldo Carvalho de Melo602ad872013-11-12 16:46:16 -0300329int perf_evsel__open_strerror(struct perf_evsel *evsel, struct target *target,
Arnaldo Carvalho de Melo56e52e82012-12-13 15:10:58 -0300330 int err, char *msg, size_t size);
Namhyung Kim97f63e42013-01-22 18:09:29 +0900331
332static inline int perf_evsel__group_idx(struct perf_evsel *evsel)
333{
334 return evsel->idx - evsel->leader->idx;
335}
Namhyung Kim717e2632013-01-22 18:09:44 +0900336
337#define for_each_group_member(_evsel, _leader) \
338for ((_evsel) = list_entry((_leader)->node.next, struct perf_evsel, node); \
339 (_evsel) && (_evsel)->leader == (_leader); \
340 (_evsel) = list_entry((_evsel)->node.next, struct perf_evsel, node))
341
Arnaldo Carvalho de Melo69aad6f2011-01-03 16:39:04 -0200342#endif /* __PERF_EVSEL_H */