2 * Stage 1 of the trace events.
4 * Override the macros in <trace/trace_events.h> to include the following:
6 * struct ftrace_raw_<call> {
7 * struct trace_entry ent;
9 * <type2> <item2>[<len>];
13 * The <type> <item> is created by the __field(type, item) macro or
14 * the __array(type2, item2, len) macro.
15 * We simply do "type item;", and that will create the fields
19 #include <linux/ftrace_event.h>
22 * DECLARE_EVENT_CLASS can be used to add a generic function
23 * handlers for events. That is, if all events have the same
24 * parameters and just have distinct trace points.
25 * Each tracepoint can be defined with DEFINE_EVENT and that
26 * will map the DECLARE_EVENT_CLASS to the tracepoint.
28 * TRACE_EVENT is a one to one mapping between tracepoint and template.
31 #define TRACE_EVENT(name, proto, args, tstruct, assign, print) \
32 DECLARE_EVENT_CLASS(name, \
38 DEFINE_EVENT(name, name, PARAMS(proto), PARAMS(args));
42 #define __field(type, item) type item;
45 #define __field_ext(type, item, filter_type) type item;
48 #define __array(type, item, len) type item[len];
50 #undef __dynamic_array
51 #define __dynamic_array(type, item, len) u32 __data_loc_##item;
54 #define __string(item, src) __dynamic_array(char, item, -1)
56 #undef TP_STRUCT__entry
57 #define TP_STRUCT__entry(args...) args
59 #undef DECLARE_EVENT_CLASS
60 #define DECLARE_EVENT_CLASS(name, proto, args, tstruct, assign, print) \
61 struct ftrace_raw_##name { \
62 struct trace_entry ent; \
67 static struct ftrace_event_class event_class_##name;
70 #define DEFINE_EVENT(template, name, proto, args) \
71 static struct ftrace_event_call __used \
72 __attribute__((__aligned__(4))) event_##name
74 #undef DEFINE_EVENT_PRINT
75 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
76 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
79 #define __cpparg(arg...) arg
81 /* Callbacks are meaningless to ftrace. */
83 #define TRACE_EVENT_FN(name, proto, args, tstruct, \
84 assign, print, reg, unreg) \
85 TRACE_EVENT(name, __cpparg(proto), __cpparg(args), \
86 __cpparg(tstruct), __cpparg(assign), __cpparg(print)) \
88 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
92 * Stage 2 of the trace events.
94 * Include the following:
96 * struct ftrace_data_offsets_<call> {
102 * The __dynamic_array() macro will create each u32 <item>, this is
103 * to keep the offset of each array from the beginning of the event.
104 * The size of an array is also encoded, in the higher 16 bits of <item>.
108 #define __field(type, item)
111 #define __field_ext(type, item, filter_type)
114 #define __array(type, item, len)
116 #undef __dynamic_array
117 #define __dynamic_array(type, item, len) u32 item;
120 #define __string(item, src) __dynamic_array(char, item, -1)
122 #undef DECLARE_EVENT_CLASS
123 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
124 struct ftrace_data_offsets_##call { \
129 #define DEFINE_EVENT(template, name, proto, args)
131 #undef DEFINE_EVENT_PRINT
132 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
133 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
135 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
138 * Stage 3 of the trace events.
140 * Override the macros in <trace/trace_events.h> to include the following:
143 * ftrace_raw_output_<call>(struct trace_iterator *iter, int flags)
145 * struct trace_seq *s = &iter->seq;
146 * struct ftrace_raw_<call> *field; <-- defined in stage 1
147 * struct trace_entry *entry;
148 * struct trace_seq *p;
153 * if (entry->type != event_<call>->event.type) {
155 * return TRACE_TYPE_UNHANDLED;
158 * field = (typeof(field))entry;
160 * p = &get_cpu_var(ftrace_event_seq);
162 * ret = trace_seq_printf(s, "%s: ", <call>);
164 * ret = trace_seq_printf(s, <TP_printk> "\n");
167 * return TRACE_TYPE_PARTIAL_LINE;
169 * return TRACE_TYPE_HANDLED;
172 * This is the method used to print the raw event to the trace
173 * output format. Note, this is not needed if the data is read
178 #define __entry field
181 #define TP_printk(fmt, args...) fmt "\n", args
183 #undef __get_dynamic_array
184 #define __get_dynamic_array(field) \
185 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
188 #define __get_str(field) (char *)__get_dynamic_array(field)
191 #define __print_flags(flag, delim, flag_array...) \
193 static const struct trace_print_flags __flags[] = \
194 { flag_array, { -1, NULL }}; \
195 ftrace_print_flags_seq(p, delim, flag, __flags); \
198 #undef __print_symbolic
199 #define __print_symbolic(value, symbol_array...) \
201 static const struct trace_print_flags symbols[] = \
202 { symbol_array, { -1, NULL }}; \
203 ftrace_print_symbols_seq(p, value, symbols); \
207 #define __print_hex(buf, buf_len) ftrace_print_hex_seq(p, buf, buf_len)
209 #undef DECLARE_EVENT_CLASS
210 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
211 static notrace enum print_line_t \
212 ftrace_raw_output_##call(struct trace_iterator *iter, int flags, \
213 struct trace_event *trace_event) \
215 struct ftrace_event_call *event; \
216 struct trace_seq *s = &iter->seq; \
217 struct ftrace_raw_##call *field; \
218 struct trace_entry *entry; \
219 struct trace_seq *p; \
222 event = container_of(trace_event, struct ftrace_event_call, \
227 if (entry->type != event->event.type) { \
229 return TRACE_TYPE_UNHANDLED; \
232 field = (typeof(field))entry; \
234 p = &get_cpu_var(ftrace_event_seq); \
236 ret = trace_seq_printf(s, "%s: ", event->name); \
238 ret = trace_seq_printf(s, print); \
241 return TRACE_TYPE_PARTIAL_LINE; \
243 return TRACE_TYPE_HANDLED; \
245 static struct trace_event_functions ftrace_event_type_funcs_##call = { \
246 .trace = ftrace_raw_output_##call, \
249 #undef DEFINE_EVENT_PRINT
250 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
251 static notrace enum print_line_t \
252 ftrace_raw_output_##call(struct trace_iterator *iter, int flags, \
253 struct trace_event *event) \
255 struct trace_seq *s = &iter->seq; \
256 struct ftrace_raw_##template *field; \
257 struct trace_entry *entry; \
258 struct trace_seq *p; \
263 if (entry->type != event_##call.event.type) { \
265 return TRACE_TYPE_UNHANDLED; \
268 field = (typeof(field))entry; \
270 p = &get_cpu_var(ftrace_event_seq); \
272 ret = trace_seq_printf(s, "%s: ", #call); \
274 ret = trace_seq_printf(s, print); \
277 return TRACE_TYPE_PARTIAL_LINE; \
279 return TRACE_TYPE_HANDLED; \
281 static struct trace_event_functions ftrace_event_type_funcs_##call = { \
282 .trace = ftrace_raw_output_##call, \
285 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
288 #define __field_ext(type, item, filter_type) \
289 ret = trace_define_field(event_call, #type, #item, \
290 offsetof(typeof(field), item), \
291 sizeof(field.item), \
292 is_signed_type(type), filter_type); \
297 #define __field(type, item) __field_ext(type, item, FILTER_OTHER)
300 #define __array(type, item, len) \
301 BUILD_BUG_ON(len > MAX_FILTER_STR_VAL); \
302 ret = trace_define_field(event_call, #type "[" #len "]", #item, \
303 offsetof(typeof(field), item), \
304 sizeof(field.item), \
305 is_signed_type(type), FILTER_OTHER); \
309 #undef __dynamic_array
310 #define __dynamic_array(type, item, len) \
311 ret = trace_define_field(event_call, "__data_loc " #type "[]", #item, \
312 offsetof(typeof(field), __data_loc_##item), \
313 sizeof(field.__data_loc_##item), \
314 is_signed_type(type), FILTER_OTHER);
317 #define __string(item, src) __dynamic_array(char, item, -1)
319 #undef DECLARE_EVENT_CLASS
320 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, func, print) \
322 ftrace_define_fields_##call(struct ftrace_event_call *event_call) \
324 struct ftrace_raw_##call field; \
333 #define DEFINE_EVENT(template, name, proto, args)
335 #undef DEFINE_EVENT_PRINT
336 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
337 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
339 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
342 * remember the offset of each array from the beginning of the event.
346 #define __entry entry
349 #define __field(type, item)
352 #define __field_ext(type, item, filter_type)
355 #define __array(type, item, len)
357 #undef __dynamic_array
358 #define __dynamic_array(type, item, len) \
359 __data_offsets->item = __data_size + \
360 offsetof(typeof(*entry), __data); \
361 __data_offsets->item |= (len * sizeof(type)) << 16; \
362 __data_size += (len) * sizeof(type);
365 #define __string(item, src) __dynamic_array(char, item, strlen(src) + 1)
367 #undef DECLARE_EVENT_CLASS
368 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
369 static inline notrace int ftrace_get_offsets_##call( \
370 struct ftrace_data_offsets_##call *__data_offsets, proto) \
372 int __data_size = 0; \
373 struct ftrace_raw_##call __maybe_unused *entry; \
377 return __data_size; \
381 #define DEFINE_EVENT(template, name, proto, args)
383 #undef DEFINE_EVENT_PRINT
384 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
385 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
387 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
390 * Stage 4 of the trace events.
392 * Override the macros in <trace/trace_events.h> to include the following:
394 * For those macros defined with TRACE_EVENT:
396 * static struct ftrace_event_call event_<call>;
398 * static void ftrace_raw_event_<call>(void *__data, proto)
400 * struct ftrace_event_call *event_call = __data;
401 * struct ftrace_data_offsets_<call> __maybe_unused __data_offsets;
402 * struct ring_buffer_event *event;
403 * struct ftrace_raw_<call> *entry; <-- defined in stage 1
404 * struct ring_buffer *buffer;
405 * unsigned long irq_flags;
409 * local_save_flags(irq_flags);
410 * pc = preempt_count();
412 * __data_size = ftrace_get_offsets_<call>(&__data_offsets, args);
414 * event = trace_current_buffer_lock_reserve(&buffer,
415 * event_<call>->event.type,
416 * sizeof(*entry) + __data_size,
420 * entry = ring_buffer_event_data(event);
422 * { <assign>; } <-- Here we assign the entries by the __field and
425 * if (!filter_current_check_discard(buffer, event_call, entry, event))
426 * trace_current_buffer_unlock_commit(buffer,
427 * event, irq_flags, pc);
430 * static struct trace_event ftrace_event_type_<call> = {
431 * .trace = ftrace_raw_output_<call>, <-- stage 2
434 * static const char print_fmt_<call>[] = <TP_printk>;
436 * static struct ftrace_event_class __used event_class_<template> = {
437 * .system = "<system>",
438 * .define_fields = ftrace_define_fields_<call>,
439 * .fields = LIST_HEAD_INIT(event_class_##call.fields),
440 * .raw_init = trace_event_raw_init,
441 * .probe = ftrace_raw_event_##call,
444 * static struct ftrace_event_call __used
445 * __attribute__((__aligned__(4)))
446 * __attribute__((section("_ftrace_events"))) event_<call> = {
448 * .class = event_class_<template>,
449 * .event = &ftrace_event_type_<call>,
450 * .print_fmt = print_fmt_<call>,
455 #ifdef CONFIG_PERF_EVENTS
457 #define _TRACE_PERF_PROTO(call, proto) \
458 static notrace void \
459 perf_trace_##call(void *__data, proto);
461 #define _TRACE_PERF_INIT(call) \
462 .perf_probe = perf_trace_##call,
465 #define _TRACE_PERF_PROTO(call, proto)
466 #define _TRACE_PERF_INIT(call)
467 #endif /* CONFIG_PERF_EVENTS */
470 #define __entry entry
473 #define __field(type, item)
476 #define __array(type, item, len)
478 #undef __dynamic_array
479 #define __dynamic_array(type, item, len) \
480 __entry->__data_loc_##item = __data_offsets.item;
483 #define __string(item, src) __dynamic_array(char, item, -1) \
486 #define __assign_str(dst, src) \
487 strcpy(__get_str(dst), src);
489 #undef TP_fast_assign
490 #define TP_fast_assign(args...) args
492 #undef TP_perf_assign
493 #define TP_perf_assign(args...)
495 #undef DECLARE_EVENT_CLASS
496 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
498 static notrace void \
499 ftrace_raw_event_##call(void *__data, proto) \
501 struct ftrace_event_call *event_call = __data; \
502 struct ftrace_data_offsets_##call __maybe_unused __data_offsets;\
503 struct ring_buffer_event *event; \
504 struct ftrace_raw_##call *entry; \
505 struct ring_buffer *buffer; \
506 unsigned long irq_flags; \
510 local_save_flags(irq_flags); \
511 pc = preempt_count(); \
513 __data_size = ftrace_get_offsets_##call(&__data_offsets, args); \
515 event = trace_current_buffer_lock_reserve(&buffer, \
516 event_call->event.type, \
517 sizeof(*entry) + __data_size, \
521 entry = ring_buffer_event_data(event); \
527 if (!filter_current_check_discard(buffer, event_call, entry, event)) \
528 trace_nowake_buffer_unlock_commit(buffer, \
529 event, irq_flags, pc); \
532 * The ftrace_test_probe is compiled out, it is only here as a build time check
533 * to make sure that if the tracepoint handling changes, the ftrace probe will
534 * fail to compile unless it too is updated.
538 #define DEFINE_EVENT(template, call, proto, args) \
539 static inline void ftrace_test_probe_##call(void) \
541 check_trace_callback_type_##call(ftrace_raw_event_##template); \
544 #undef DEFINE_EVENT_PRINT
545 #define DEFINE_EVENT_PRINT(template, name, proto, args, print)
547 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
553 #undef __print_symbolic
554 #undef __get_dynamic_array
558 #define TP_printk(fmt, args...) "\"" fmt "\", " __stringify(args)
560 #undef DECLARE_EVENT_CLASS
561 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
562 _TRACE_PERF_PROTO(call, PARAMS(proto)); \
563 static const char print_fmt_##call[] = print; \
564 static struct ftrace_event_class __used event_class_##call = { \
565 .system = __stringify(TRACE_SYSTEM), \
566 .define_fields = ftrace_define_fields_##call, \
567 .fields = LIST_HEAD_INIT(event_class_##call.fields),\
568 .raw_init = trace_event_raw_init, \
569 .probe = ftrace_raw_event_##call, \
570 _TRACE_PERF_INIT(call) \
574 #define DEFINE_EVENT(template, call, proto, args) \
576 static struct ftrace_event_call __used \
577 __attribute__((__aligned__(4))) \
578 __attribute__((section("_ftrace_events"))) event_##call = { \
580 .class = &event_class_##template, \
581 .event.funcs = &ftrace_event_type_funcs_##template, \
582 .print_fmt = print_fmt_##template, \
585 #undef DEFINE_EVENT_PRINT
586 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
588 static const char print_fmt_##call[] = print; \
590 static struct ftrace_event_call __used \
591 __attribute__((__aligned__(4))) \
592 __attribute__((section("_ftrace_events"))) event_##call = { \
594 .class = &event_class_##template, \
595 .event.funcs = &ftrace_event_type_funcs_##call, \
596 .print_fmt = print_fmt_##call, \
599 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
602 * Define the insertion callback to perf events
604 * The job is very similar to ftrace_raw_event_<call> except that we don't
605 * insert in the ring buffer but in a perf counter.
607 * static void ftrace_perf_<call>(proto)
609 * struct ftrace_data_offsets_<call> __maybe_unused __data_offsets;
610 * struct ftrace_event_call *event_call = &event_<call>;
611 * extern void perf_tp_event(int, u64, u64, void *, int);
612 * struct ftrace_raw_##call *entry;
613 * struct perf_trace_buf *trace_buf;
614 * u64 __addr = 0, __count = 1;
615 * unsigned long irq_flags;
616 * struct trace_entry *ent;
622 * pc = preempt_count();
624 * __data_size = ftrace_get_offsets_<call>(&__data_offsets, args);
626 * // Below we want to get the aligned size by taking into account
627 * // the u32 field that will later store the buffer size
628 * __entry_size = ALIGN(__data_size + sizeof(*entry) + sizeof(u32),
630 * __entry_size -= sizeof(u32);
632 * // Protect the non nmi buffer
633 * // This also protects the rcu read side
634 * local_irq_save(irq_flags);
635 * __cpu = smp_processor_id();
638 * trace_buf = rcu_dereference_sched(perf_trace_buf_nmi);
640 * trace_buf = rcu_dereference_sched(perf_trace_buf);
645 * trace_buf = per_cpu_ptr(trace_buf, __cpu);
647 * // Avoid recursion from perf that could mess up the buffer
648 * if (trace_buf->recursion++)
649 * goto end_recursion;
651 * raw_data = trace_buf->buf;
653 * // Make recursion update visible before entering perf_tp_event
654 * // so that we protect from perf recursions.
658 * //zero dead bytes from alignment to avoid stack leak to userspace:
659 * *(u64 *)(&raw_data[__entry_size - sizeof(u64)]) = 0ULL;
660 * entry = (struct ftrace_raw_<call> *)raw_data;
662 * tracing_generic_entry_update(ent, irq_flags, pc);
663 * ent->type = event_call->id;
665 * <tstruct> <- do some jobs with dynamic arrays
667 * <assign> <- affect our values
669 * perf_tp_event(event_call->id, __addr, __count, entry,
670 * __entry_size); <- submit them to perf counter
675 #ifdef CONFIG_PERF_EVENTS
678 #define __entry entry
680 #undef __get_dynamic_array
681 #define __get_dynamic_array(field) \
682 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
685 #define __get_str(field) (char *)__get_dynamic_array(field)
688 #define __perf_addr(a) __addr = (a)
691 #define __perf_count(c) __count = (c)
693 #undef DECLARE_EVENT_CLASS
694 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
695 static notrace void \
696 perf_trace_##call(void *__data, proto) \
698 struct ftrace_event_call *event_call = __data; \
699 struct ftrace_data_offsets_##call __maybe_unused __data_offsets;\
700 struct ftrace_raw_##call *entry; \
701 struct pt_regs __regs; \
702 u64 __addr = 0, __count = 1; \
703 struct hlist_head *head; \
708 perf_fetch_caller_regs(&__regs, 1); \
710 __data_size = ftrace_get_offsets_##call(&__data_offsets, args); \
711 __entry_size = ALIGN(__data_size + sizeof(*entry) + sizeof(u32),\
713 __entry_size -= sizeof(u32); \
715 if (WARN_ONCE(__entry_size > PERF_MAX_TRACE_SIZE, \
716 "profile buffer not large enough")) \
719 entry = (struct ftrace_raw_##call *)perf_trace_buf_prepare( \
720 __entry_size, event_call->event.type, &__regs, &rctx); \
728 head = this_cpu_ptr(event_call->perf_events); \
729 perf_trace_buf_submit(entry, __entry_size, rctx, __addr, \
730 __count, &__regs, head); \
734 * This part is compiled out, it is only here as a build time check
735 * to make sure that if the tracepoint handling changes, the
736 * perf probe will fail to compile unless it too is updated.
739 #define DEFINE_EVENT(template, call, proto, args) \
740 static inline void perf_test_probe_##call(void) \
742 check_trace_callback_type_##call(perf_trace_##template); \
746 #undef DEFINE_EVENT_PRINT
747 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
748 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
750 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
751 #endif /* CONFIG_PERF_EVENTS */
753 #undef _TRACE_PROFILE_INIT