1 /* SPDX-License-Identifier: GPL-2.0 */
3 * Stage 1 of the trace events.
5 * Override the macros in the event tracepoint header <trace/events/XXX.h>
6 * to include the following:
8 * struct trace_event_raw_<call> {
9 * struct trace_entry ent;
11 * <type2> <item2>[<len>];
15 * The <type> <item> is created by the __field(type, item) macro or
16 * the __array(type2, item2, len) macro.
17 * We simply do "type item;", and that will create the fields
21 #include <linux/trace_events.h>
23 #ifndef TRACE_SYSTEM_VAR
24 #define TRACE_SYSTEM_VAR TRACE_SYSTEM
27 #define __app__(x, y) str__##x##y
28 #define __app(x, y) __app__(x, y)
30 #define TRACE_SYSTEM_STRING __app(TRACE_SYSTEM_VAR,__trace_system_name)
32 #define TRACE_MAKE_SYSTEM_STR() \
33 static const char TRACE_SYSTEM_STRING[] = \
34 __stringify(TRACE_SYSTEM)
36 TRACE_MAKE_SYSTEM_STR();
38 #undef TRACE_DEFINE_ENUM
39 #define TRACE_DEFINE_ENUM(a) \
40 static struct trace_eval_map __used __initdata \
41 __##TRACE_SYSTEM##_##a = \
43 .system = TRACE_SYSTEM_STRING, \
47 static struct trace_eval_map __used \
48 __section("_ftrace_eval_map") \
49 *TRACE_SYSTEM##_##a = &__##TRACE_SYSTEM##_##a
51 #undef TRACE_DEFINE_SIZEOF
52 #define TRACE_DEFINE_SIZEOF(a) \
53 static struct trace_eval_map __used __initdata \
54 __##TRACE_SYSTEM##_##a = \
56 .system = TRACE_SYSTEM_STRING, \
57 .eval_string = "sizeof(" #a ")", \
58 .eval_value = sizeof(a) \
60 static struct trace_eval_map __used \
61 __section("_ftrace_eval_map") \
62 *TRACE_SYSTEM##_##a = &__##TRACE_SYSTEM##_##a
65 * DECLARE_EVENT_CLASS can be used to add a generic function
66 * handlers for events. That is, if all events have the same
67 * parameters and just have distinct trace points.
68 * Each tracepoint can be defined with DEFINE_EVENT and that
69 * will map the DECLARE_EVENT_CLASS to the tracepoint.
71 * TRACE_EVENT is a one to one mapping between tracepoint and template.
74 #define TRACE_EVENT(name, proto, args, tstruct, assign, print) \
75 DECLARE_EVENT_CLASS(name, \
81 DEFINE_EVENT(name, name, PARAMS(proto), PARAMS(args));
85 #define __field(type, item) type item;
88 #define __field_ext(type, item, filter_type) type item;
91 #define __field_struct(type, item) type item;
93 #undef __field_struct_ext
94 #define __field_struct_ext(type, item, filter_type) type item;
97 #define __array(type, item, len) type item[len];
99 #undef __dynamic_array
100 #define __dynamic_array(type, item, len) u32 __data_loc_##item;
103 #define __string(item, src) __dynamic_array(char, item, -1)
106 #define __bitmask(item, nr_bits) __dynamic_array(char, item, -1)
108 #undef TP_STRUCT__entry
109 #define TP_STRUCT__entry(args...) args
111 #undef DECLARE_EVENT_CLASS
112 #define DECLARE_EVENT_CLASS(name, proto, args, tstruct, assign, print) \
113 struct trace_event_raw_##name { \
114 struct trace_entry ent; \
119 static struct trace_event_class event_class_##name;
122 #define DEFINE_EVENT(template, name, proto, args) \
123 static struct trace_event_call __used \
124 __attribute__((__aligned__(4))) event_##name
126 #undef DEFINE_EVENT_FN
127 #define DEFINE_EVENT_FN(template, name, proto, args, reg, unreg) \
128 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
130 #undef DEFINE_EVENT_PRINT
131 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
132 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
134 /* Callbacks are meaningless to ftrace. */
135 #undef TRACE_EVENT_FN
136 #define TRACE_EVENT_FN(name, proto, args, tstruct, \
137 assign, print, reg, unreg) \
138 TRACE_EVENT(name, PARAMS(proto), PARAMS(args), \
139 PARAMS(tstruct), PARAMS(assign), PARAMS(print)) \
141 #undef TRACE_EVENT_FN_COND
142 #define TRACE_EVENT_FN_COND(name, proto, args, cond, tstruct, \
143 assign, print, reg, unreg) \
144 TRACE_EVENT_CONDITION(name, PARAMS(proto), PARAMS(args), PARAMS(cond), \
145 PARAMS(tstruct), PARAMS(assign), PARAMS(print)) \
147 #undef TRACE_EVENT_FLAGS
148 #define TRACE_EVENT_FLAGS(name, value) \
149 __TRACE_EVENT_FLAGS(name, value)
151 #undef TRACE_EVENT_PERF_PERM
152 #define TRACE_EVENT_PERF_PERM(name, expr...) \
153 __TRACE_EVENT_PERF_PERM(name, expr)
155 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
158 * Stage 2 of the trace events.
160 * Include the following:
162 * struct trace_event_data_offsets_<call> {
168 * The __dynamic_array() macro will create each u32 <item>, this is
169 * to keep the offset of each array from the beginning of the event.
170 * The size of an array is also encoded, in the higher 16 bits of <item>.
173 #undef TRACE_DEFINE_ENUM
174 #define TRACE_DEFINE_ENUM(a)
176 #undef TRACE_DEFINE_SIZEOF
177 #define TRACE_DEFINE_SIZEOF(a)
180 #define __field(type, item)
183 #define __field_ext(type, item, filter_type)
185 #undef __field_struct
186 #define __field_struct(type, item)
188 #undef __field_struct_ext
189 #define __field_struct_ext(type, item, filter_type)
192 #define __array(type, item, len)
194 #undef __dynamic_array
195 #define __dynamic_array(type, item, len) u32 item;
198 #define __string(item, src) __dynamic_array(char, item, -1)
201 #define __bitmask(item, nr_bits) __dynamic_array(unsigned long, item, -1)
203 #undef DECLARE_EVENT_CLASS
204 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
205 struct trace_event_data_offsets_##call { \
210 #define DEFINE_EVENT(template, name, proto, args)
212 #undef DEFINE_EVENT_PRINT
213 #define DEFINE_EVENT_PRINT(template, name, proto, args, print)
215 #undef TRACE_EVENT_FLAGS
216 #define TRACE_EVENT_FLAGS(event, flag)
218 #undef TRACE_EVENT_PERF_PERM
219 #define TRACE_EVENT_PERF_PERM(event, expr...)
221 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
224 * Stage 3 of the trace events.
226 * Override the macros in the event tracepoint header <trace/events/XXX.h>
227 * to include the following:
230 * trace_raw_output_<call>(struct trace_iterator *iter, int flags)
232 * struct trace_seq *s = &iter->seq;
233 * struct trace_event_raw_<call> *field; <-- defined in stage 1
234 * struct trace_seq *p = &iter->tmp_seq;
236 * -------(for event)-------
238 * struct trace_entry *entry;
242 * if (entry->type != event_<call>->event.type) {
244 * return TRACE_TYPE_UNHANDLED;
247 * field = (typeof(field))entry;
250 * return trace_output_call(iter, <call>, <TP_printk> "\n");
252 * ------(or, for event class)------
256 * field = (typeof(field))iter->ent;
258 * ret = trace_raw_output_prep(iter, trace_event);
259 * if (ret != TRACE_TYPE_HANDLED)
262 * trace_event_printf(iter, <TP_printk> "\n");
264 * return trace_handle_return(s);
268 * This is the method used to print the raw event to the trace
269 * output format. Note, this is not needed if the data is read
274 #define __entry field
277 #define TP_printk(fmt, args...) fmt "\n", args
279 #undef __get_dynamic_array
280 #define __get_dynamic_array(field) \
281 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
283 #undef __get_dynamic_array_len
284 #define __get_dynamic_array_len(field) \
285 ((__entry->__data_loc_##field >> 16) & 0xffff)
288 #define __get_str(field) ((char *)__get_dynamic_array(field))
291 #define __get_bitmask(field) \
293 void *__bitmask = __get_dynamic_array(field); \
294 unsigned int __bitmask_size; \
295 __bitmask_size = __get_dynamic_array_len(field); \
296 trace_print_bitmask_seq(p, __bitmask, __bitmask_size); \
300 #define __print_flags(flag, delim, flag_array...) \
302 static const struct trace_print_flags __flags[] = \
303 { flag_array, { -1, NULL }}; \
304 trace_print_flags_seq(p, delim, flag, __flags); \
307 #undef __print_symbolic
308 #define __print_symbolic(value, symbol_array...) \
310 static const struct trace_print_flags symbols[] = \
311 { symbol_array, { -1, NULL }}; \
312 trace_print_symbols_seq(p, value, symbols); \
315 #undef __print_flags_u64
316 #undef __print_symbolic_u64
317 #if BITS_PER_LONG == 32
318 #define __print_flags_u64(flag, delim, flag_array...) \
320 static const struct trace_print_flags_u64 __flags[] = \
321 { flag_array, { -1, NULL } }; \
322 trace_print_flags_seq_u64(p, delim, flag, __flags); \
325 #define __print_symbolic_u64(value, symbol_array...) \
327 static const struct trace_print_flags_u64 symbols[] = \
328 { symbol_array, { -1, NULL } }; \
329 trace_print_symbols_seq_u64(p, value, symbols); \
332 #define __print_flags_u64(flag, delim, flag_array...) \
333 __print_flags(flag, delim, flag_array)
335 #define __print_symbolic_u64(value, symbol_array...) \
336 __print_symbolic(value, symbol_array)
340 #define __print_hex(buf, buf_len) \
341 trace_print_hex_seq(p, buf, buf_len, false)
343 #undef __print_hex_str
344 #define __print_hex_str(buf, buf_len) \
345 trace_print_hex_seq(p, buf, buf_len, true)
348 #define __print_array(array, count, el_size) \
350 BUILD_BUG_ON(el_size != 1 && el_size != 2 && \
351 el_size != 4 && el_size != 8); \
352 trace_print_array_seq(p, array, count, el_size); \
355 #undef __print_hex_dump
356 #define __print_hex_dump(prefix_str, prefix_type, \
357 rowsize, groupsize, buf, len, ascii) \
358 trace_print_hex_dump_seq(p, prefix_str, prefix_type, \
359 rowsize, groupsize, buf, len, ascii)
361 #undef DECLARE_EVENT_CLASS
362 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
363 static notrace enum print_line_t \
364 trace_raw_output_##call(struct trace_iterator *iter, int flags, \
365 struct trace_event *trace_event) \
367 struct trace_seq *s = &iter->seq; \
368 struct trace_seq __maybe_unused *p = &iter->tmp_seq; \
369 struct trace_event_raw_##call *field; \
372 field = (typeof(field))iter->ent; \
374 ret = trace_raw_output_prep(iter, trace_event); \
375 if (ret != TRACE_TYPE_HANDLED) \
378 trace_event_printf(iter, print); \
380 return trace_handle_return(s); \
382 static struct trace_event_functions trace_event_type_funcs_##call = { \
383 .trace = trace_raw_output_##call, \
386 #undef DEFINE_EVENT_PRINT
387 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
388 static notrace enum print_line_t \
389 trace_raw_output_##call(struct trace_iterator *iter, int flags, \
390 struct trace_event *event) \
392 struct trace_event_raw_##template *field; \
393 struct trace_entry *entry; \
394 struct trace_seq *p = &iter->tmp_seq; \
398 if (entry->type != event_##call.event.type) { \
400 return TRACE_TYPE_UNHANDLED; \
403 field = (typeof(field))entry; \
406 return trace_output_call(iter, #call, print); \
408 static struct trace_event_functions trace_event_type_funcs_##call = { \
409 .trace = trace_raw_output_##call, \
412 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
415 #define __field_ext(_type, _item, _filter_type) { \
416 .type = #_type, .name = #_item, \
417 .size = sizeof(_type), .align = __alignof__(_type), \
418 .is_signed = is_signed_type(_type), .filter_type = _filter_type },
420 #undef __field_struct_ext
421 #define __field_struct_ext(_type, _item, _filter_type) { \
422 .type = #_type, .name = #_item, \
423 .size = sizeof(_type), .align = __alignof__(_type), \
424 0, .filter_type = _filter_type },
427 #define __field(type, item) __field_ext(type, item, FILTER_OTHER)
429 #undef __field_struct
430 #define __field_struct(type, item) __field_struct_ext(type, item, FILTER_OTHER)
433 #define __array(_type, _item, _len) { \
434 .type = #_type"["__stringify(_len)"]", .name = #_item, \
435 .size = sizeof(_type[_len]), .align = __alignof__(_type), \
436 .is_signed = is_signed_type(_type), .filter_type = FILTER_OTHER },
438 #undef __dynamic_array
439 #define __dynamic_array(_type, _item, _len) { \
440 .type = "__data_loc " #_type "[]", .name = #_item, \
441 .size = 4, .align = 4, \
442 .is_signed = is_signed_type(_type), .filter_type = FILTER_OTHER },
445 #define __string(item, src) __dynamic_array(char, item, -1)
448 #define __bitmask(item, nr_bits) __dynamic_array(unsigned long, item, -1)
450 #undef DECLARE_EVENT_CLASS
451 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, func, print) \
452 static struct trace_event_fields trace_event_fields_##call[] = { \
456 #undef DEFINE_EVENT_PRINT
457 #define DEFINE_EVENT_PRINT(template, name, proto, args, print)
459 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
462 * remember the offset of each array from the beginning of the event.
466 #define __entry entry
469 #define __field(type, item)
472 #define __field_ext(type, item, filter_type)
474 #undef __field_struct
475 #define __field_struct(type, item)
477 #undef __field_struct_ext
478 #define __field_struct_ext(type, item, filter_type)
481 #define __array(type, item, len)
483 #undef __dynamic_array
484 #define __dynamic_array(type, item, len) \
485 __item_length = (len) * sizeof(type); \
486 __data_offsets->item = __data_size + \
487 offsetof(typeof(*entry), __data); \
488 __data_offsets->item |= __item_length << 16; \
489 __data_size += __item_length;
492 #define __string(item, src) __dynamic_array(char, item, \
493 strlen((src) ? (const char *)(src) : "(null)") + 1)
496 * __bitmask_size_in_bytes_raw is the number of bytes needed to hold
497 * num_possible_cpus().
499 #define __bitmask_size_in_bytes_raw(nr_bits) \
500 (((nr_bits) + 7) / 8)
502 #define __bitmask_size_in_longs(nr_bits) \
503 ((__bitmask_size_in_bytes_raw(nr_bits) + \
504 ((BITS_PER_LONG / 8) - 1)) / (BITS_PER_LONG / 8))
507 * __bitmask_size_in_bytes is the number of bytes needed to hold
508 * num_possible_cpus() padded out to the nearest long. This is what
509 * is saved in the buffer, just to be consistent.
511 #define __bitmask_size_in_bytes(nr_bits) \
512 (__bitmask_size_in_longs(nr_bits) * (BITS_PER_LONG / 8))
515 #define __bitmask(item, nr_bits) __dynamic_array(unsigned long, item, \
516 __bitmask_size_in_longs(nr_bits))
518 #undef DECLARE_EVENT_CLASS
519 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
520 static inline notrace int trace_event_get_offsets_##call( \
521 struct trace_event_data_offsets_##call *__data_offsets, proto) \
523 int __data_size = 0; \
524 int __maybe_unused __item_length; \
525 struct trace_event_raw_##call __maybe_unused *entry; \
529 return __data_size; \
532 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
535 * Stage 4 of the trace events.
537 * Override the macros in the event tracepoint header <trace/events/XXX.h>
538 * to include the following:
540 * For those macros defined with TRACE_EVENT:
542 * static struct trace_event_call event_<call>;
544 * static void trace_event_raw_event_<call>(void *__data, proto)
546 * struct trace_event_file *trace_file = __data;
547 * struct trace_event_call *event_call = trace_file->event_call;
548 * struct trace_event_data_offsets_<call> __maybe_unused __data_offsets;
549 * unsigned long eflags = trace_file->flags;
550 * enum event_trigger_type __tt = ETT_NONE;
551 * struct ring_buffer_event *event;
552 * struct trace_event_raw_<call> *entry; <-- defined in stage 1
553 * struct trace_buffer *buffer;
554 * unsigned long irq_flags;
558 * if (!(eflags & EVENT_FILE_FL_TRIGGER_COND)) {
559 * if (eflags & EVENT_FILE_FL_TRIGGER_MODE)
560 * event_triggers_call(trace_file, NULL);
561 * if (eflags & EVENT_FILE_FL_SOFT_DISABLED)
565 * local_save_flags(irq_flags);
566 * pc = preempt_count();
568 * __data_size = trace_event_get_offsets_<call>(&__data_offsets, args);
570 * event = trace_event_buffer_lock_reserve(&buffer, trace_file,
571 * event_<call>->event.type,
572 * sizeof(*entry) + __data_size,
576 * entry = ring_buffer_event_data(event);
578 * { <assign>; } <-- Here we assign the entries by the __field and
581 * if (eflags & EVENT_FILE_FL_TRIGGER_COND)
582 * __tt = event_triggers_call(trace_file, entry);
584 * if (test_bit(EVENT_FILE_FL_SOFT_DISABLED_BIT,
585 * &trace_file->flags))
586 * ring_buffer_discard_commit(buffer, event);
587 * else if (!filter_check_discard(trace_file, entry, buffer, event))
588 * trace_buffer_unlock_commit(buffer, event, irq_flags, pc);
591 * event_triggers_post_call(trace_file, __tt);
594 * static struct trace_event ftrace_event_type_<call> = {
595 * .trace = trace_raw_output_<call>, <-- stage 2
598 * static char print_fmt_<call>[] = <TP_printk>;
600 * static struct trace_event_class __used event_class_<template> = {
601 * .system = "<system>",
602 * .fields_array = trace_event_fields_<call>,
603 * .fields = LIST_HEAD_INIT(event_class_##call.fields),
604 * .raw_init = trace_event_raw_init,
605 * .probe = trace_event_raw_event_##call,
606 * .reg = trace_event_reg,
609 * static struct trace_event_call event_<call> = {
610 * .class = event_class_<template>,
612 * .tp = &__tracepoint_<call>,
614 * .event = &ftrace_event_type_<call>,
615 * .print_fmt = print_fmt_<call>,
616 * .flags = TRACE_EVENT_FL_TRACEPOINT,
618 * // its only safe to use pointers when doing linker tricks to
619 * // create an array.
620 * static struct trace_event_call __used
621 * __section("_ftrace_events") *__event_<call> = &event_<call>;
625 #ifdef CONFIG_PERF_EVENTS
627 #define _TRACE_PERF_PROTO(call, proto) \
628 static notrace void \
629 perf_trace_##call(void *__data, proto);
631 #define _TRACE_PERF_INIT(call) \
632 .perf_probe = perf_trace_##call,
635 #define _TRACE_PERF_PROTO(call, proto)
636 #define _TRACE_PERF_INIT(call)
637 #endif /* CONFIG_PERF_EVENTS */
640 #define __entry entry
643 #define __field(type, item)
645 #undef __field_struct
646 #define __field_struct(type, item)
649 #define __array(type, item, len)
651 #undef __dynamic_array
652 #define __dynamic_array(type, item, len) \
653 __entry->__data_loc_##item = __data_offsets.item;
656 #define __string(item, src) __dynamic_array(char, item, -1)
659 #define __assign_str(dst, src) \
660 strcpy(__get_str(dst), (src) ? (const char *)(src) : "(null)");
663 #define __bitmask(item, nr_bits) __dynamic_array(unsigned long, item, -1)
666 #define __get_bitmask(field) (char *)__get_dynamic_array(field)
668 #undef __assign_bitmask
669 #define __assign_bitmask(dst, src, nr_bits) \
670 memcpy(__get_bitmask(dst), (src), __bitmask_size_in_bytes(nr_bits))
672 #undef TP_fast_assign
673 #define TP_fast_assign(args...) args
676 #define __perf_count(c) (c)
679 #define __perf_task(t) (t)
681 #undef DECLARE_EVENT_CLASS
682 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
684 static notrace void \
685 trace_event_raw_event_##call(void *__data, proto) \
687 struct trace_event_file *trace_file = __data; \
688 struct trace_event_data_offsets_##call __maybe_unused __data_offsets;\
689 struct trace_event_buffer fbuffer; \
690 struct trace_event_raw_##call *entry; \
693 if (trace_trigger_soft_disabled(trace_file)) \
696 __data_size = trace_event_get_offsets_##call(&__data_offsets, args); \
698 entry = trace_event_buffer_reserve(&fbuffer, trace_file, \
699 sizeof(*entry) + __data_size); \
708 trace_event_buffer_commit(&fbuffer); \
711 * The ftrace_test_probe is compiled out, it is only here as a build time check
712 * to make sure that if the tracepoint handling changes, the ftrace probe will
713 * fail to compile unless it too is updated.
717 #define DEFINE_EVENT(template, call, proto, args) \
718 static inline void ftrace_test_probe_##call(void) \
720 check_trace_callback_type_##call(trace_event_raw_event_##template); \
723 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
729 #undef __print_symbolic
731 #undef __print_hex_str
732 #undef __get_dynamic_array
733 #undef __get_dynamic_array_len
737 #undef __print_hex_dump
740 #define TP_printk(fmt, args...) "\"" fmt "\", " __stringify(args)
742 #undef DECLARE_EVENT_CLASS
743 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
744 _TRACE_PERF_PROTO(call, PARAMS(proto)); \
745 static char print_fmt_##call[] = print; \
746 static struct trace_event_class __used __refdata event_class_##call = { \
747 .system = TRACE_SYSTEM_STRING, \
748 .fields_array = trace_event_fields_##call, \
749 .fields = LIST_HEAD_INIT(event_class_##call.fields),\
750 .raw_init = trace_event_raw_init, \
751 .probe = trace_event_raw_event_##call, \
752 .reg = trace_event_reg, \
753 _TRACE_PERF_INIT(call) \
757 #define DEFINE_EVENT(template, call, proto, args) \
759 static struct trace_event_call __used event_##call = { \
760 .class = &event_class_##template, \
762 .tp = &__tracepoint_##call, \
764 .event.funcs = &trace_event_type_funcs_##template, \
765 .print_fmt = print_fmt_##template, \
766 .flags = TRACE_EVENT_FL_TRACEPOINT, \
768 static struct trace_event_call __used \
769 __section("_ftrace_events") *__event_##call = &event_##call
771 #undef DEFINE_EVENT_PRINT
772 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
774 static char print_fmt_##call[] = print; \
776 static struct trace_event_call __used event_##call = { \
777 .class = &event_class_##template, \
779 .tp = &__tracepoint_##call, \
781 .event.funcs = &trace_event_type_funcs_##call, \
782 .print_fmt = print_fmt_##call, \
783 .flags = TRACE_EVENT_FL_TRACEPOINT, \
785 static struct trace_event_call __used \
786 __section("_ftrace_events") *__event_##call = &event_##call
788 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)