Linux 3.12.5
[linux/fpc-iii.git] / include / trace / ftrace.h
blob712ea36067ab19ca9f19fa793ee87cc58395bc44
1 /*
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;
8 * <type> <item>;
9 * <type2> <item2>[<len>];
10 * [...]
11 * };
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
16 * in the structure.
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.
30 #undef TRACE_EVENT
31 #define TRACE_EVENT(name, proto, args, tstruct, assign, print) \
32 DECLARE_EVENT_CLASS(name, \
33 PARAMS(proto), \
34 PARAMS(args), \
35 PARAMS(tstruct), \
36 PARAMS(assign), \
37 PARAMS(print)); \
38 DEFINE_EVENT(name, name, PARAMS(proto), PARAMS(args));
41 #undef __field
42 #define __field(type, item) type item;
44 #undef __field_ext
45 #define __field_ext(type, item, filter_type) type item;
47 #undef __array
48 #define __array(type, item, len) type item[len];
50 #undef __dynamic_array
51 #define __dynamic_array(type, item, len) u32 __data_loc_##item;
53 #undef __string
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; \
63 tstruct \
64 char __data[0]; \
65 }; \
67 static struct ftrace_event_class event_class_##name;
69 #undef DEFINE_EVENT
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_FN
75 #define DEFINE_EVENT_FN(template, name, proto, args, reg, unreg) \
76 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
78 #undef DEFINE_EVENT_PRINT
79 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
80 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
82 /* Callbacks are meaningless to ftrace. */
83 #undef TRACE_EVENT_FN
84 #define TRACE_EVENT_FN(name, proto, args, tstruct, \
85 assign, print, reg, unreg) \
86 TRACE_EVENT(name, PARAMS(proto), PARAMS(args), \
87 PARAMS(tstruct), PARAMS(assign), PARAMS(print)) \
89 #undef TRACE_EVENT_FLAGS
90 #define TRACE_EVENT_FLAGS(name, value) \
91 __TRACE_EVENT_FLAGS(name, value)
93 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
97 * Stage 2 of the trace events.
99 * Include the following:
101 * struct ftrace_data_offsets_<call> {
102 * u32 <item1>;
103 * u32 <item2>;
104 * [...]
105 * };
107 * The __dynamic_array() macro will create each u32 <item>, this is
108 * to keep the offset of each array from the beginning of the event.
109 * The size of an array is also encoded, in the higher 16 bits of <item>.
112 #undef __field
113 #define __field(type, item)
115 #undef __field_ext
116 #define __field_ext(type, item, filter_type)
118 #undef __array
119 #define __array(type, item, len)
121 #undef __dynamic_array
122 #define __dynamic_array(type, item, len) u32 item;
124 #undef __string
125 #define __string(item, src) __dynamic_array(char, item, -1)
127 #undef DECLARE_EVENT_CLASS
128 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
129 struct ftrace_data_offsets_##call { \
130 tstruct; \
133 #undef DEFINE_EVENT
134 #define DEFINE_EVENT(template, name, proto, args)
136 #undef DEFINE_EVENT_PRINT
137 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
138 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
140 #undef TRACE_EVENT_FLAGS
141 #define TRACE_EVENT_FLAGS(event, flag)
143 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
146 * Stage 3 of the trace events.
148 * Override the macros in <trace/trace_events.h> to include the following:
150 * enum print_line_t
151 * ftrace_raw_output_<call>(struct trace_iterator *iter, int flags)
153 * struct trace_seq *s = &iter->seq;
154 * struct ftrace_raw_<call> *field; <-- defined in stage 1
155 * struct trace_entry *entry;
156 * struct trace_seq *p = &iter->tmp_seq;
157 * int ret;
159 * entry = iter->ent;
161 * if (entry->type != event_<call>->event.type) {
162 * WARN_ON_ONCE(1);
163 * return TRACE_TYPE_UNHANDLED;
166 * field = (typeof(field))entry;
168 * trace_seq_init(p);
169 * ret = trace_seq_printf(s, "%s: ", <call>);
170 * if (ret)
171 * ret = trace_seq_printf(s, <TP_printk> "\n");
172 * if (!ret)
173 * return TRACE_TYPE_PARTIAL_LINE;
175 * return TRACE_TYPE_HANDLED;
178 * This is the method used to print the raw event to the trace
179 * output format. Note, this is not needed if the data is read
180 * in binary.
183 #undef __entry
184 #define __entry field
186 #undef TP_printk
187 #define TP_printk(fmt, args...) fmt "\n", args
189 #undef __get_dynamic_array
190 #define __get_dynamic_array(field) \
191 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
193 #undef __get_str
194 #define __get_str(field) (char *)__get_dynamic_array(field)
196 #undef __print_flags
197 #define __print_flags(flag, delim, flag_array...) \
198 ({ \
199 static const struct trace_print_flags __flags[] = \
200 { flag_array, { -1, NULL }}; \
201 ftrace_print_flags_seq(p, delim, flag, __flags); \
204 #undef __print_symbolic
205 #define __print_symbolic(value, symbol_array...) \
206 ({ \
207 static const struct trace_print_flags symbols[] = \
208 { symbol_array, { -1, NULL }}; \
209 ftrace_print_symbols_seq(p, value, symbols); \
212 #undef __print_symbolic_u64
213 #if BITS_PER_LONG == 32
214 #define __print_symbolic_u64(value, symbol_array...) \
215 ({ \
216 static const struct trace_print_flags_u64 symbols[] = \
217 { symbol_array, { -1, NULL } }; \
218 ftrace_print_symbols_seq_u64(p, value, symbols); \
220 #else
221 #define __print_symbolic_u64(value, symbol_array...) \
222 __print_symbolic(value, symbol_array)
223 #endif
225 #undef __print_hex
226 #define __print_hex(buf, buf_len) ftrace_print_hex_seq(p, buf, buf_len)
228 #undef DECLARE_EVENT_CLASS
229 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
230 static notrace enum print_line_t \
231 ftrace_raw_output_##call(struct trace_iterator *iter, int flags, \
232 struct trace_event *trace_event) \
234 struct trace_seq *s = &iter->seq; \
235 struct trace_seq __maybe_unused *p = &iter->tmp_seq; \
236 struct ftrace_raw_##call *field; \
237 int ret; \
239 field = (typeof(field))iter->ent; \
241 ret = ftrace_raw_output_prep(iter, trace_event); \
242 if (ret) \
243 return ret; \
245 ret = trace_seq_printf(s, print); \
246 if (!ret) \
247 return TRACE_TYPE_PARTIAL_LINE; \
249 return TRACE_TYPE_HANDLED; \
251 static struct trace_event_functions ftrace_event_type_funcs_##call = { \
252 .trace = ftrace_raw_output_##call, \
255 #undef DEFINE_EVENT_PRINT
256 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
257 static notrace enum print_line_t \
258 ftrace_raw_output_##call(struct trace_iterator *iter, int flags, \
259 struct trace_event *event) \
261 struct trace_seq *s = &iter->seq; \
262 struct ftrace_raw_##template *field; \
263 struct trace_entry *entry; \
264 struct trace_seq *p = &iter->tmp_seq; \
265 int ret; \
267 entry = iter->ent; \
269 if (entry->type != event_##call.event.type) { \
270 WARN_ON_ONCE(1); \
271 return TRACE_TYPE_UNHANDLED; \
274 field = (typeof(field))entry; \
276 trace_seq_init(p); \
277 ret = trace_seq_printf(s, "%s: ", #call); \
278 if (ret) \
279 ret = trace_seq_printf(s, print); \
280 if (!ret) \
281 return TRACE_TYPE_PARTIAL_LINE; \
283 return TRACE_TYPE_HANDLED; \
285 static struct trace_event_functions ftrace_event_type_funcs_##call = { \
286 .trace = ftrace_raw_output_##call, \
289 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
291 #undef __field_ext
292 #define __field_ext(type, item, filter_type) \
293 ret = trace_define_field(event_call, #type, #item, \
294 offsetof(typeof(field), item), \
295 sizeof(field.item), \
296 is_signed_type(type), filter_type); \
297 if (ret) \
298 return ret;
300 #undef __field
301 #define __field(type, item) __field_ext(type, item, FILTER_OTHER)
303 #undef __array
304 #define __array(type, item, len) \
305 do { \
306 mutex_lock(&event_storage_mutex); \
307 BUILD_BUG_ON(len > MAX_FILTER_STR_VAL); \
308 snprintf(event_storage, sizeof(event_storage), \
309 "%s[%d]", #type, len); \
310 ret = trace_define_field(event_call, event_storage, #item, \
311 offsetof(typeof(field), item), \
312 sizeof(field.item), \
313 is_signed_type(type), FILTER_OTHER); \
314 mutex_unlock(&event_storage_mutex); \
315 if (ret) \
316 return ret; \
317 } while (0);
319 #undef __dynamic_array
320 #define __dynamic_array(type, item, len) \
321 ret = trace_define_field(event_call, "__data_loc " #type "[]", #item, \
322 offsetof(typeof(field), __data_loc_##item), \
323 sizeof(field.__data_loc_##item), \
324 is_signed_type(type), FILTER_OTHER);
326 #undef __string
327 #define __string(item, src) __dynamic_array(char, item, -1)
329 #undef DECLARE_EVENT_CLASS
330 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, func, print) \
331 static int notrace __init \
332 ftrace_define_fields_##call(struct ftrace_event_call *event_call) \
334 struct ftrace_raw_##call field; \
335 int ret; \
337 tstruct; \
339 return ret; \
342 #undef DEFINE_EVENT
343 #define DEFINE_EVENT(template, name, proto, args)
345 #undef DEFINE_EVENT_PRINT
346 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
347 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
349 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
352 * remember the offset of each array from the beginning of the event.
355 #undef __entry
356 #define __entry entry
358 #undef __field
359 #define __field(type, item)
361 #undef __field_ext
362 #define __field_ext(type, item, filter_type)
364 #undef __array
365 #define __array(type, item, len)
367 #undef __dynamic_array
368 #define __dynamic_array(type, item, len) \
369 __data_offsets->item = __data_size + \
370 offsetof(typeof(*entry), __data); \
371 __data_offsets->item |= (len * sizeof(type)) << 16; \
372 __data_size += (len) * sizeof(type);
374 #undef __string
375 #define __string(item, src) __dynamic_array(char, item, \
376 strlen((src) ? (const char *)(src) : "(null)") + 1)
378 #undef DECLARE_EVENT_CLASS
379 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
380 static inline notrace int ftrace_get_offsets_##call( \
381 struct ftrace_data_offsets_##call *__data_offsets, proto) \
383 int __data_size = 0; \
384 struct ftrace_raw_##call __maybe_unused *entry; \
386 tstruct; \
388 return __data_size; \
391 #undef DEFINE_EVENT
392 #define DEFINE_EVENT(template, name, proto, args)
394 #undef DEFINE_EVENT_PRINT
395 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
396 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
398 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
401 * Stage 4 of the trace events.
403 * Override the macros in <trace/trace_events.h> to include the following:
405 * For those macros defined with TRACE_EVENT:
407 * static struct ftrace_event_call event_<call>;
409 * static void ftrace_raw_event_<call>(void *__data, proto)
411 * struct ftrace_event_file *ftrace_file = __data;
412 * struct ftrace_event_call *event_call = ftrace_file->event_call;
413 * struct ftrace_data_offsets_<call> __maybe_unused __data_offsets;
414 * struct ring_buffer_event *event;
415 * struct ftrace_raw_<call> *entry; <-- defined in stage 1
416 * struct ring_buffer *buffer;
417 * unsigned long irq_flags;
418 * int __data_size;
419 * int pc;
421 * if (test_bit(FTRACE_EVENT_FL_SOFT_DISABLED_BIT,
422 * &ftrace_file->flags))
423 * return;
425 * local_save_flags(irq_flags);
426 * pc = preempt_count();
428 * __data_size = ftrace_get_offsets_<call>(&__data_offsets, args);
430 * event = trace_event_buffer_lock_reserve(&buffer, ftrace_file,
431 * event_<call>->event.type,
432 * sizeof(*entry) + __data_size,
433 * irq_flags, pc);
434 * if (!event)
435 * return;
436 * entry = ring_buffer_event_data(event);
438 * { <assign>; } <-- Here we assign the entries by the __field and
439 * __array macros.
441 * if (!filter_current_check_discard(buffer, event_call, entry, event))
442 * trace_nowake_buffer_unlock_commit(buffer,
443 * event, irq_flags, pc);
446 * static struct trace_event ftrace_event_type_<call> = {
447 * .trace = ftrace_raw_output_<call>, <-- stage 2
448 * };
450 * static const char print_fmt_<call>[] = <TP_printk>;
452 * static struct ftrace_event_class __used event_class_<template> = {
453 * .system = "<system>",
454 * .define_fields = ftrace_define_fields_<call>,
455 * .fields = LIST_HEAD_INIT(event_class_##call.fields),
456 * .raw_init = trace_event_raw_init,
457 * .probe = ftrace_raw_event_##call,
458 * .reg = ftrace_event_reg,
459 * };
461 * static struct ftrace_event_call event_<call> = {
462 * .name = "<call>",
463 * .class = event_class_<template>,
464 * .event = &ftrace_event_type_<call>,
465 * .print_fmt = print_fmt_<call>,
466 * };
467 * // its only safe to use pointers when doing linker tricks to
468 * // create an array.
469 * static struct ftrace_event_call __used
470 * __attribute__((section("_ftrace_events"))) *__event_<call> = &event_<call>;
474 #ifdef CONFIG_PERF_EVENTS
476 #define _TRACE_PERF_PROTO(call, proto) \
477 static notrace void \
478 perf_trace_##call(void *__data, proto);
480 #define _TRACE_PERF_INIT(call) \
481 .perf_probe = perf_trace_##call,
483 #else
484 #define _TRACE_PERF_PROTO(call, proto)
485 #define _TRACE_PERF_INIT(call)
486 #endif /* CONFIG_PERF_EVENTS */
488 #undef __entry
489 #define __entry entry
491 #undef __field
492 #define __field(type, item)
494 #undef __array
495 #define __array(type, item, len)
497 #undef __dynamic_array
498 #define __dynamic_array(type, item, len) \
499 __entry->__data_loc_##item = __data_offsets.item;
501 #undef __string
502 #define __string(item, src) __dynamic_array(char, item, -1) \
504 #undef __assign_str
505 #define __assign_str(dst, src) \
506 strcpy(__get_str(dst), (src) ? (const char *)(src) : "(null)");
508 #undef TP_fast_assign
509 #define TP_fast_assign(args...) args
511 #undef __perf_addr
512 #define __perf_addr(a) (a)
514 #undef __perf_count
515 #define __perf_count(c) (c)
517 #undef __perf_task
518 #define __perf_task(t) (t)
520 #undef DECLARE_EVENT_CLASS
521 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
523 static notrace void \
524 ftrace_raw_event_##call(void *__data, proto) \
526 struct ftrace_event_file *ftrace_file = __data; \
527 struct ftrace_event_call *event_call = ftrace_file->event_call; \
528 struct ftrace_data_offsets_##call __maybe_unused __data_offsets;\
529 struct ring_buffer_event *event; \
530 struct ftrace_raw_##call *entry; \
531 struct ring_buffer *buffer; \
532 unsigned long irq_flags; \
533 int __data_size; \
534 int pc; \
536 if (test_bit(FTRACE_EVENT_FL_SOFT_DISABLED_BIT, \
537 &ftrace_file->flags)) \
538 return; \
540 local_save_flags(irq_flags); \
541 pc = preempt_count(); \
543 __data_size = ftrace_get_offsets_##call(&__data_offsets, args); \
545 event = trace_event_buffer_lock_reserve(&buffer, ftrace_file, \
546 event_call->event.type, \
547 sizeof(*entry) + __data_size, \
548 irq_flags, pc); \
549 if (!event) \
550 return; \
551 entry = ring_buffer_event_data(event); \
553 tstruct \
555 { assign; } \
557 if (!filter_current_check_discard(buffer, event_call, entry, event)) \
558 trace_buffer_unlock_commit(buffer, event, irq_flags, pc); \
561 * The ftrace_test_probe is compiled out, it is only here as a build time check
562 * to make sure that if the tracepoint handling changes, the ftrace probe will
563 * fail to compile unless it too is updated.
566 #undef DEFINE_EVENT
567 #define DEFINE_EVENT(template, call, proto, args) \
568 static inline void ftrace_test_probe_##call(void) \
570 check_trace_callback_type_##call(ftrace_raw_event_##template); \
573 #undef DEFINE_EVENT_PRINT
574 #define DEFINE_EVENT_PRINT(template, name, proto, args, print)
576 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
578 #undef __entry
579 #define __entry REC
581 #undef __print_flags
582 #undef __print_symbolic
583 #undef __print_hex
584 #undef __get_dynamic_array
585 #undef __get_str
587 #undef TP_printk
588 #define TP_printk(fmt, args...) "\"" fmt "\", " __stringify(args)
590 #undef DECLARE_EVENT_CLASS
591 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
592 _TRACE_PERF_PROTO(call, PARAMS(proto)); \
593 static const char print_fmt_##call[] = print; \
594 static struct ftrace_event_class __used __refdata event_class_##call = { \
595 .system = __stringify(TRACE_SYSTEM), \
596 .define_fields = ftrace_define_fields_##call, \
597 .fields = LIST_HEAD_INIT(event_class_##call.fields),\
598 .raw_init = trace_event_raw_init, \
599 .probe = ftrace_raw_event_##call, \
600 .reg = ftrace_event_reg, \
601 _TRACE_PERF_INIT(call) \
604 #undef DEFINE_EVENT
605 #define DEFINE_EVENT(template, call, proto, args) \
607 static struct ftrace_event_call __used event_##call = { \
608 .name = #call, \
609 .class = &event_class_##template, \
610 .event.funcs = &ftrace_event_type_funcs_##template, \
611 .print_fmt = print_fmt_##template, \
612 }; \
613 static struct ftrace_event_call __used \
614 __attribute__((section("_ftrace_events"))) *__event_##call = &event_##call
616 #undef DEFINE_EVENT_PRINT
617 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
619 static const char print_fmt_##call[] = print; \
621 static struct ftrace_event_call __used event_##call = { \
622 .name = #call, \
623 .class = &event_class_##template, \
624 .event.funcs = &ftrace_event_type_funcs_##call, \
625 .print_fmt = print_fmt_##call, \
626 }; \
627 static struct ftrace_event_call __used \
628 __attribute__((section("_ftrace_events"))) *__event_##call = &event_##call
630 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
633 #ifdef CONFIG_PERF_EVENTS
635 #undef __entry
636 #define __entry entry
638 #undef __get_dynamic_array
639 #define __get_dynamic_array(field) \
640 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
642 #undef __get_str
643 #define __get_str(field) (char *)__get_dynamic_array(field)
645 #undef __perf_addr
646 #define __perf_addr(a) (__addr = (a))
648 #undef __perf_count
649 #define __perf_count(c) (__count = (c))
651 #undef __perf_task
652 #define __perf_task(t) (__task = (t))
654 #undef DECLARE_EVENT_CLASS
655 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
656 static notrace void \
657 perf_trace_##call(void *__data, proto) \
659 struct ftrace_event_call *event_call = __data; \
660 struct ftrace_data_offsets_##call __maybe_unused __data_offsets;\
661 struct ftrace_raw_##call *entry; \
662 struct pt_regs __regs; \
663 u64 __addr = 0, __count = 1; \
664 struct task_struct *__task = NULL; \
665 struct hlist_head *head; \
666 int __entry_size; \
667 int __data_size; \
668 int rctx; \
670 __data_size = ftrace_get_offsets_##call(&__data_offsets, args); \
672 head = this_cpu_ptr(event_call->perf_events); \
673 if (__builtin_constant_p(!__task) && !__task && \
674 hlist_empty(head)) \
675 return; \
677 __entry_size = ALIGN(__data_size + sizeof(*entry) + sizeof(u32),\
678 sizeof(u64)); \
679 __entry_size -= sizeof(u32); \
681 perf_fetch_caller_regs(&__regs); \
682 entry = perf_trace_buf_prepare(__entry_size, \
683 event_call->event.type, &__regs, &rctx); \
684 if (!entry) \
685 return; \
687 tstruct \
689 { assign; } \
691 perf_trace_buf_submit(entry, __entry_size, rctx, __addr, \
692 __count, &__regs, head, __task); \
696 * This part is compiled out, it is only here as a build time check
697 * to make sure that if the tracepoint handling changes, the
698 * perf probe will fail to compile unless it too is updated.
700 #undef DEFINE_EVENT
701 #define DEFINE_EVENT(template, call, proto, args) \
702 static inline void perf_test_probe_##call(void) \
704 check_trace_callback_type_##call(perf_trace_##template); \
708 #undef DEFINE_EVENT_PRINT
709 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
710 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
712 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
713 #endif /* CONFIG_PERF_EVENTS */