Comment buffer creation behavior wrt packet headers
[lttng-modules.git] / probes / lttng-events.h
CommitLineData
d0dd2ecb 1#include <linux/debugfs.h>
c0edae1d
MD
2#include "lttng.h"
3#include "lttng-types.h"
b13f3ebe 4#include "../wrapper/vmalloc.h" /* for wrapper_vmalloc_sync_all() */
f3bc08c5 5#include "../wrapper/ringbuffer/frontend_types.h"
e763dbf5 6#include "../ltt-events.h"
6db3d13b 7#include "../ltt-tracer-core.h"
40652b65 8
40652b65 9/*
6db3d13b 10 * Macro declarations used for all stages.
40652b65
MD
11 */
12
13/*
14 * DECLARE_EVENT_CLASS can be used to add a generic function
15 * handlers for events. That is, if all events have the same
16 * parameters and just have distinct trace points.
17 * Each tracepoint can be defined with DEFINE_EVENT and that
18 * will map the DECLARE_EVENT_CLASS to the tracepoint.
19 *
20 * TRACE_EVENT is a one to one mapping between tracepoint and template.
21 */
6db3d13b 22
40652b65
MD
23#undef TRACE_EVENT
24#define TRACE_EVENT(name, proto, args, tstruct, assign, print) \
25 DECLARE_EVENT_CLASS(name, \
26 PARAMS(proto), \
27 PARAMS(args), \
28 PARAMS(tstruct), \
29 PARAMS(assign), \
299338c8
MD
30 PARAMS(print)) \
31 DEFINE_EVENT(name, name, PARAMS(proto), PARAMS(args))
40652b65 32
6db3d13b
MD
33#undef DEFINE_EVENT_PRINT
34#define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
35 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
36
37/* Callbacks are meaningless to LTTng. */
38#undef TRACE_EVENT_FN
39#define TRACE_EVENT_FN(name, proto, args, tstruct, \
40 assign, print, reg, unreg) \
41 TRACE_EVENT(name, PARAMS(proto), PARAMS(args), \
42 PARAMS(tstruct), PARAMS(assign), PARAMS(print)) \
43
f62b389e 44/*
c099397a 45 * Stage 1 of the trace events.
f62b389e
MD
46 *
47 * Create dummy trace calls for each events, verifying that the LTTng module
48 * TRACE_EVENT headers match the kernel arguments. Will be optimized out by the
49 * compiler.
50 */
51
52#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
53
54#undef TP_PROTO
55#define TP_PROTO(args...) args
56
57#undef TP_ARGS
58#define TP_ARGS(args...) args
59
60#undef DEFINE_EVENT
61#define DEFINE_EVENT(_template, _name, _proto, _args) \
7eb827f2 62void trace_##_name(_proto);
f62b389e
MD
63
64#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
65
6db3d13b 66/*
c099397a 67 * Stage 2 of the trace events.
6db3d13b
MD
68 *
69 * Create event field type metadata section.
70 * Each event produce an array of fields.
71 */
72
73#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
74
1d12cebd
MD
75/* Named field types must be defined in lttng-types.h */
76
40652b65 77#undef __field
299338c8 78#define __field(_type, _item) \
c099397a
MD
79 { \
80 .name = #_item, \
e0a7a7c4 81 .type = __type_integer(_type, __BYTE_ORDER, 10), \
c099397a 82 },
40652b65
MD
83
84#undef __field_ext
6db3d13b 85#define __field_ext(_type, _item, _filter_type) __field(_type, _item)
40652b65 86
c099397a
MD
87#undef __field_network
88#define __field_network(_type, _item) \
89 { \
90 .name = #_item, \
e0a7a7c4 91 .type = __type_integer(_type, __BIG_ENDIAN, 10), \
c099397a
MD
92 },
93
40652b65 94#undef __array
299338c8
MD
95#define __array(_type, _item, _length) \
96 { \
c099397a
MD
97 .name = #_item, \
98 .type = \
99 { \
299338c8 100 .atype = atype_array, \
c099397a
MD
101 .u.array = \
102 { \
103 .length = _length, \
e0a7a7c4 104 .elem_type = __type_integer(_type, __BYTE_ORDER, 10), \
c099397a 105 }, \
299338c8
MD
106 }, \
107 },
40652b65
MD
108
109#undef __dynamic_array
299338c8
MD
110#define __dynamic_array(_type, _item, _length) \
111 { \
c099397a
MD
112 .name = #_item, \
113 .type = \
114 { \
299338c8 115 .atype = atype_sequence, \
c099397a
MD
116 .u.sequence = \
117 { \
e0a7a7c4
MD
118 .length_type = __type_integer(u32, __BYTE_ORDER, 10), \
119 .elem_type = __type_integer(_type, __BYTE_ORDER, 10), \
c099397a 120 }, \
299338c8
MD
121 }, \
122 },
40652b65
MD
123
124#undef __string
1d12cebd 125#define __string(_item, _src) \
299338c8 126 { \
c099397a
MD
127 .name = #_item, \
128 .type = \
129 { \
299338c8 130 .atype = atype_string, \
c099397a 131 .u.basic.string.encoding = lttng_encode_UTF8, \
299338c8
MD
132 }, \
133 },
1d12cebd 134
40652b65 135#undef TP_STRUCT__entry
1d12cebd
MD
136#define TP_STRUCT__entry(args...) args /* Only one used in this phase */
137
40652b65 138#undef DECLARE_EVENT_CLASS
0d1d4002
MD
139#define DECLARE_EVENT_CLASS(_name, _proto, _args, _tstruct, _assign, _print) \
140 static const struct lttng_event_field __event_fields___##_name[] = { \
141 _tstruct \
299338c8
MD
142 };
143
299338c8
MD
144#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
145
c099397a
MD
146#undef __type_integer
147
19c57fbf 148/*
c099397a 149 * Stage 3 of the trace events.
19c57fbf
MD
150 *
151 * Create probe callback prototypes.
152 */
153
154#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
155
156#undef TP_PROTO
157#define TP_PROTO(args...) args
158
159#undef DECLARE_EVENT_CLASS
160#define DECLARE_EVENT_CLASS(_name, _proto, _args, _tstruct, _assign, _print) \
161static void __event_probe__##_name(void *__data, _proto);
162
163#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
164
299338c8 165/*
c099397a 166 * Stage 4 of the trace events.
299338c8
MD
167 *
168 * Create an array of events.
169 */
170
299338c8
MD
171/* Named field types must be defined in lttng-types.h */
172
6db3d13b 173#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
299338c8 174
d32a57a2
MD
175#undef DEFINE_EVENT
176#define DEFINE_EVENT(_template, _name, _proto, _args) \
177 { \
178 .fields = __event_fields___##_template, \
179 .name = #_name, \
19c57fbf 180 .probe_callback = (void *) &__event_probe__##_template,\
d32a57a2 181 .nr_fields = ARRAY_SIZE(__event_fields___##_template), \
6db3d13b 182 },
40652b65 183
d0dd2ecb
MD
184#define TP_ID1(_token, _system) _token##_system
185#define TP_ID(_token, _system) TP_ID1(_token, _system)
40652b65 186
d0dd2ecb 187static const struct lttng_event_desc TP_ID(__event_desc___, TRACE_SYSTEM)[] = {
40652b65 188#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
299338c8
MD
189};
190
d0dd2ecb
MD
191#undef TP_ID1
192#undef TP_ID
193
85a9ca7f
MD
194
195/*
c099397a 196 * Stage 5 of the trace events.
85a9ca7f
MD
197 *
198 * Create a toplevel descriptor for the whole probe.
199 */
200
201#define TP_ID1(_token, _system) _token##_system
202#define TP_ID(_token, _system) TP_ID1(_token, _system)
203
204/* non-const because list head will be modified when registered. */
205static struct lttng_probe_desc TP_ID(__probe_desc___, TRACE_SYSTEM) = {
206 .event_desc = TP_ID(__event_desc___, TRACE_SYSTEM),
207 .nr_events = ARRAY_SIZE(TP_ID(__event_desc___, TRACE_SYSTEM)),
208};
209
210#undef TP_ID1
211#undef TP_ID
212
d0dd2ecb 213/*
c099397a 214 * Stage 6 of the trace events.
40652b65
MD
215 *
216 * Create static inline function that calculates event size.
217 */
218
6db3d13b 219#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
40652b65 220
6db3d13b
MD
221/* Named field types must be defined in lttng-types.h */
222
223#undef __field
85a80742 224#define __field(_type, _item) \
d793d5e1 225 __event_len += lib_ring_buffer_align(__event_len, ltt_alignof(_type)); \
0d1d4002 226 __event_len += sizeof(_type);
6db3d13b
MD
227
228#undef __field_ext
229#define __field_ext(_type, _item, _filter_type) __field(_type, _item)
230
231#undef __array
85a80742 232#define __array(_type, _item, _length) \
d793d5e1 233 __event_len += lib_ring_buffer_align(__event_len, ltt_alignof(_type)); \
0d1d4002 234 __event_len += sizeof(_type) * (_length);
6db3d13b
MD
235
236#undef __dynamic_array
85a80742 237#define __dynamic_array(_type, _item, _length) \
d793d5e1 238 __event_len += lib_ring_buffer_align(__event_len, ltt_alignof(u32)); \
85a80742 239 __event_len += sizeof(u32); \
d793d5e1 240 __event_len += lib_ring_buffer_align(__event_len, ltt_alignof(_type)); \
0d1d4002 241 __event_len += sizeof(_type) * (_length);
6db3d13b
MD
242
243#undef __string
85a80742 244#define __string(_item, _src) \
0d1d4002
MD
245 __event_len += __dynamic_len[__dynamic_len_idx++] = strlen(_src) + 1;
246
247#undef TP_PROTO
248#define TP_PROTO(args...) args
6db3d13b
MD
249
250#undef TP_STRUCT__entry
0d1d4002 251#define TP_STRUCT__entry(args...) args
6db3d13b
MD
252
253#undef DECLARE_EVENT_CLASS
0d1d4002
MD
254#define DECLARE_EVENT_CLASS(_name, _proto, _args, _tstruct, _assign, _print) \
255static inline size_t __event_get_size__##_name(size_t *__dynamic_len, _proto) \
256{ \
257 size_t __event_len = 0; \
258 unsigned int __dynamic_len_idx = 0; \
259 \
260 if (0) \
261 (void) __dynamic_len_idx; /* don't warn if unused */ \
262 _tstruct \
263 return __event_len; \
6db3d13b 264}
40652b65
MD
265
266#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
267
268/*
c099397a 269 * Stage 7 of the trace events.
e763dbf5
MD
270 *
271 * Create static inline function that calculates event payload alignment.
272 */
273
274#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
275
276/* Named field types must be defined in lttng-types.h */
277
278#undef __field
279#define __field(_type, _item) \
d793d5e1 280 __event_align = max_t(size_t, __event_align, ltt_alignof(_type));
e763dbf5
MD
281
282#undef __field_ext
283#define __field_ext(_type, _item, _filter_type) __field(_type, _item)
284
285#undef __array
286#define __array(_type, _item, _length) \
d793d5e1 287 __event_align = max_t(size_t, __event_align, ltt_alignof(_type));
e763dbf5
MD
288
289#undef __dynamic_array
290#define __dynamic_array(_type, _item, _length) \
d793d5e1
MD
291 __event_align = max_t(size_t, __event_align, ltt_alignof(u32)); \
292 __event_align = max_t(size_t, __event_align, ltt_alignof(_type));
e763dbf5
MD
293
294#undef __string
295#define __string(_item, _src)
296
297#undef TP_PROTO
298#define TP_PROTO(args...) args
299
300#undef TP_STRUCT__entry
301#define TP_STRUCT__entry(args...) args
302
303#undef DECLARE_EVENT_CLASS
304#define DECLARE_EVENT_CLASS(_name, _proto, _args, _tstruct, _assign, _print) \
305static inline size_t __event_get_align__##_name(_proto) \
306{ \
307 size_t __event_align = 1; \
308 _tstruct \
309 return __event_align; \
310}
311
312#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
313
314
e763dbf5 315/*
c099397a 316 * Stage 8 of the trace events.
40652b65 317 *
3c4ffab9
MD
318 * Create structure declaration that allows the "assign" macros to access the
319 * field types.
320 */
321
322#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
323
324/* Named field types must be defined in lttng-types.h */
325
326#undef __field
327#define __field(_type, _item) _type _item;
328
329#undef __field_ext
330#define __field_ext(_type, _item, _filter_type) __field(_type, _item)
331
332#undef __array
333#define __array(_type, _item, _length) _type _item;
334
335#undef __dynamic_array
336#define __dynamic_array(_type, _item, _length) _type _item;
337
338#undef __string
339#define __string(_item, _src) char _item;
340
341#undef TP_STRUCT__entry
342#define TP_STRUCT__entry(args...) args
343
344#undef DECLARE_EVENT_CLASS
345#define DECLARE_EVENT_CLASS(_name, _proto, _args, _tstruct, _assign, _print) \
346struct __event_typemap__##_name { \
347 _tstruct \
348};
349
350#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
351
352
353/*
c099397a 354 * Stage 9 of the trace events.
3c4ffab9 355 *
40652b65
MD
356 * Create the probe function : call even size calculation and write event data
357 * into the buffer.
e763dbf5 358 *
67e5e60c
MD
359 * We use both the field and assignment macros to write the fields in the order
360 * defined in the field declaration. The field declarations control the
361 * execution order, jumping to the appropriate assignment block.
40652b65
MD
362 */
363
e763dbf5
MD
364#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
365
366#undef __field
367#define __field(_type, _item) \
e763dbf5
MD
368 goto __assign_##_item; \
369__end_field_##_item:
40652b65 370
e763dbf5
MD
371#undef __field_ext
372#define __field_ext(_type, _item, _filter_type) __field(_type, _item)
40652b65 373
e763dbf5
MD
374#undef __array
375#define __array(_type, _item, _length) \
e763dbf5
MD
376 goto __assign_##_item; \
377__end_field_##_item:
40652b65 378
e763dbf5
MD
379#undef __dynamic_array
380#define __dynamic_array(_type, _item, _length) \
e763dbf5
MD
381 goto __assign_##_item##_1; \
382__end_field_##_item##_1: \
e763dbf5
MD
383 goto __assign_##_item##_2; \
384__end_field_##_item##_2:
40652b65 385
e763dbf5
MD
386#undef __string
387#define __string(_item, _src) \
388 goto __assign_##_item; \
389__end_field_##_item:
390
391/*
392 * Macros mapping tp_assign() to "=", tp_memcpy() to memcpy() and tp_strcpy() to
393 * strcpy().
394 */
395#undef tp_assign
396#define tp_assign(dest, src) \
397__assign_##dest: \
398 { \
3c4ffab9 399 __typeof__(__typemap.dest) __tmp = (src); \
d793d5e1 400 lib_ring_buffer_align_ctx(&ctx, ltt_alignof(__tmp)); \
3c4ffab9 401 __chan->ops->event_write(&ctx, &__tmp, sizeof(__tmp)); \
e763dbf5
MD
402 } \
403 goto __end_field_##dest;
404
405#undef tp_memcpy
406#define tp_memcpy(dest, src, len) \
407__assign_##dest: \
d793d5e1
MD
408 if (0) \
409 (void) __typemap.dest; \
410 lib_ring_buffer_align_ctx(&ctx, ltt_alignof(__typemap.dest)); \
e763dbf5
MD
411 __chan->ops->event_write(&ctx, src, len); \
412 goto __end_field_##dest;
413
414#undef tp_memcpy_dyn
415#define tp_memcpy_dyn(dest, src, len) \
416__assign_##dest##_1: \
417 { \
3c4ffab9 418 u32 __tmpl = (len); \
d793d5e1 419 lib_ring_buffer_align_ctx(&ctx, ltt_alignof(u32)); \
e763dbf5
MD
420 __chan->ops->event_write(&ctx, &__tmpl, sizeof(u32)); \
421 } \
422 goto __end_field_##dest##_1; \
423__assign_##dest##_2: \
d793d5e1 424 lib_ring_buffer_align_ctx(&ctx, ltt_alignof(__typemap.dest)); \
e763dbf5
MD
425 __chan->ops->event_write(&ctx, src, len); \
426 goto __end_field_##dest##_2;
427
428#undef tp_strcpy
429#define tp_strcpy(dest, src) \
3c4ffab9 430 tp_memcpy(dest, src, __get_dynamic_array_len(dest))
40652b65 431
e763dbf5
MD
432/* Named field types must be defined in lttng-types.h */
433
434#undef __get_str
435#define __get_str(field) field
436
437#undef __get_dynamic_array
438#define __get_dynamic_array(field) field
439
440/* Beware: this get len actually consumes the len value */
441#undef __get_dynamic_array_len
442#define __get_dynamic_array_len(field) __dynamic_len[__dynamic_len_idx++]
443
444#undef TP_PROTO
445#define TP_PROTO(args...) args
446
447#undef TP_ARGS
448#define TP_ARGS(args...) args
449
450#undef TP_STRUCT__entry
451#define TP_STRUCT__entry(args...) args
452
453#undef TP_fast_assign
454#define TP_fast_assign(args...) args
455
456#undef DECLARE_EVENT_CLASS
457#define DECLARE_EVENT_CLASS(_name, _proto, _args, _tstruct, _assign, _print) \
458static void __event_probe__##_name(void *__data, _proto) \
459{ \
460 struct ltt_event *__event = __data; \
461 struct ltt_channel *__chan = __event->chan; \
462 struct lib_ring_buffer_ctx ctx; \
463 size_t __event_len, __event_align; \
464 size_t __dynamic_len_idx = 0; \
465 size_t __dynamic_len[ARRAY_SIZE(__event_fields___##_name)]; \
3c4ffab9 466 struct __event_typemap__##_name __typemap; \
e763dbf5
MD
467 int __ret; \
468 \
469 if (0) \
470 (void) __dynamic_len_idx; /* don't warn if unused */ \
52fc2e1f
MD
471 if (!ACCESS_ONCE(__chan->session->active)) \
472 return; \
e763dbf5
MD
473 __event_len = __event_get_size__##_name(__dynamic_len, _args); \
474 __event_align = __event_get_align__##_name(_args); \
475 lib_ring_buffer_ctx_init(&ctx, __chan->chan, NULL, __event_len, \
476 __event_align, -1); \
4e1f08f4 477 __ret = __chan->ops->event_reserve(&ctx, __event->id); \
e763dbf5
MD
478 if (__ret < 0) \
479 return; \
480 /* Control code (field ordering) */ \
481 _tstruct \
482 __chan->ops->event_commit(&ctx); \
483 return; \
484 /* Copy code, steered by control code */ \
485 _assign \
486}
487
488#include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
489
3afe7aac 490/*
c099397a 491 * Stage 10 of the trace events.
3afe7aac
MD
492 *
493 * Register/unregister probes at module load/unload.
494 */
495
496#include "lttng-events-reset.h" /* Reset all macros within TRACE_EVENT */
497
498#define TP_ID1(_token, _system) _token##_system
499#define TP_ID(_token, _system) TP_ID1(_token, _system)
500#define module_init_eval1(_token, _system) module_init(_token##_system)
501#define module_init_eval(_token, _system) module_init_eval1(_token, _system)
502#define module_exit_eval1(_token, _system) module_exit(_token##_system)
503#define module_exit_eval(_token, _system) module_exit_eval1(_token, _system)
504
3afe7aac
MD
505static int TP_ID(__lttng_events_init__, TRACE_SYSTEM)(void)
506{
6d2a620c 507 wrapper_vmalloc_sync_all();
85a9ca7f 508 return ltt_probe_register(&TP_ID(__probe_desc___, TRACE_SYSTEM));
3afe7aac
MD
509}
510
511module_init_eval(__lttng_events_init__, TRACE_SYSTEM);
512
3afe7aac
MD
513static void TP_ID(__lttng_events_exit__, TRACE_SYSTEM)(void)
514{
85a9ca7f 515 ltt_probe_unregister(&TP_ID(__probe_desc___, TRACE_SYSTEM));
3afe7aac
MD
516}
517
518module_exit_eval(__lttng_events_exit__, TRACE_SYSTEM);
519
520#undef module_init_eval
521#undef module_exit_eval
522#undef TP_ID1
523#undef TP_ID
This page took 0.059477 seconds and 4 git commands to generate.