1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3 * dlfilter.h: Interface to perf script --dlfilter shared object
4 * Copyright (c) 2021, Intel Corporation.
5 */
6
7 #ifndef PERF_UTIL_DLFILTER_H
8 #define PERF_UTIL_DLFILTER_H
9
10 struct perf_session;
11 union perf_event;
12 struct perf_sample;
13 struct evsel;
14 struct machine;
15 struct addr_location;
16 struct perf_dlfilter_fns;
17 struct perf_dlfilter_sample;
18 struct perf_dlfilter_al;
19
20 struct dlfilter {
21 char *file;
22 void *handle;
23 void *data;
24 struct perf_session *session;
25 bool ctx_valid;
26 bool in_start;
27 bool in_stop;
28 int dlargc;
29 char **dlargv;
30
31 union perf_event *event;
32 struct perf_sample *sample;
33 struct evsel *evsel;
34 struct machine *machine;
35 struct addr_location *al;
36 struct addr_location *addr_al;
37 struct perf_dlfilter_sample *d_sample;
38 struct perf_dlfilter_al *d_ip_al;
39 struct perf_dlfilter_al *d_addr_al;
40
41 int (*start)(void **data, void *ctx);
42 int (*stop)(void *data, void *ctx);
43
44 int (*filter_event)(void *data,
45 const struct perf_dlfilter_sample *sample,
46 void *ctx);
47 int (*filter_event_early)(void *data,
48 const struct perf_dlfilter_sample *sample,
49 void *ctx);
50
51 struct perf_dlfilter_fns *fns;
52 };
53
54 struct dlfilter *dlfilter__new(const char *file, int dlargc, char **dlargv);
55
56 int dlfilter__start(struct dlfilter *d, struct perf_session *session);
57
58 int dlfilter__do_filter_event(struct dlfilter *d,
59 union perf_event *event,
60 struct perf_sample *sample,
61 struct evsel *evsel,
62 struct machine *machine,
63 struct addr_location *al,
64 struct addr_location *addr_al,
65 bool early);
66
67 void dlfilter__cleanup(struct dlfilter *d);
68
dlfilter__filter_event(struct dlfilter * d,union perf_event * event,struct perf_sample * sample,struct evsel * evsel,struct machine * machine,struct addr_location * al,struct addr_location * addr_al)69 static inline int dlfilter__filter_event(struct dlfilter *d,
70 union perf_event *event,
71 struct perf_sample *sample,
72 struct evsel *evsel,
73 struct machine *machine,
74 struct addr_location *al,
75 struct addr_location *addr_al)
76 {
77 if (!d || !d->filter_event)
78 return 0;
79 return dlfilter__do_filter_event(d, event, sample, evsel, machine, al, addr_al, false);
80 }
81
dlfilter__filter_event_early(struct dlfilter * d,union perf_event * event,struct perf_sample * sample,struct evsel * evsel,struct machine * machine,struct addr_location * al,struct addr_location * addr_al)82 static inline int dlfilter__filter_event_early(struct dlfilter *d,
83 union perf_event *event,
84 struct perf_sample *sample,
85 struct evsel *evsel,
86 struct machine *machine,
87 struct addr_location *al,
88 struct addr_location *addr_al)
89 {
90 if (!d || !d->filter_event_early)
91 return 0;
92 return dlfilter__do_filter_event(d, event, sample, evsel, machine, al, addr_al, true);
93 }
94
95 int list_available_dlfilters(const struct option *opt, const char *s, int unset);
96 bool get_filter_desc(const char *dirname, const char *name, char **desc,
97 char **long_desc);
98
99 #endif
100