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 #define TRACE_FORMAT(call, proto, args, fmt)
25 #define __array(type, item, len) type item[len];
28 #define __field(type, item) type item;
30 #undef TP_STRUCT__entry
31 #define TP_STRUCT__entry(args...) args
34 #define TRACE_EVENT(name, proto, args, tstruct, assign, print) \
35 struct ftrace_raw_##name { \
36 struct trace_entry ent; \
39 static struct ftrace_event_call event_##name
41 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
44 * Stage 2 of the trace events.
46 * Override the macros in <trace/trace_events.h> to include the following:
49 * ftrace_raw_output_<call>(struct trace_iterator *iter, int flags)
51 * struct trace_seq *s = &iter->seq;
52 * struct ftrace_raw_<call> *field; <-- defined in stage 1
53 * struct trace_entry *entry;
58 * if (entry->type != event_<call>.id) {
60 * return TRACE_TYPE_UNHANDLED;
63 * field = (typeof(field))entry;
65 * ret = trace_seq_printf(s, <TP_printk> "\n");
67 * return TRACE_TYPE_PARTIAL_LINE;
69 * return TRACE_TYPE_HANDLED;
72 * This is the method used to print the raw event to the trace
73 * output format. Note, this is not needed if the data is read
81 #define TP_printk(fmt, args...) fmt "\n", args
84 #define TRACE_EVENT(call, proto, args, tstruct, assign, print) \
86 ftrace_raw_output_##call(struct trace_iterator *iter, int flags) \
88 struct trace_seq *s = &iter->seq; \
89 struct ftrace_raw_##call *field; \
90 struct trace_entry *entry; \
95 if (entry->type != event_##call.id) { \
97 return TRACE_TYPE_UNHANDLED; \
100 field = (typeof(field))entry; \
102 ret = trace_seq_printf(s, #call ": " print); \
104 return TRACE_TYPE_PARTIAL_LINE; \
106 return TRACE_TYPE_HANDLED; \
109 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
112 * Setup the showing format of trace point.
115 * ftrace_format_##call(struct trace_seq *s)
117 * struct ftrace_raw_##call field;
120 * ret = trace_seq_printf(s, #type " " #item ";"
121 * " offset:%u; size:%u;\n",
122 * offsetof(struct ftrace_raw_##call, item),
123 * sizeof(field.type));
128 #undef TP_STRUCT__entry
129 #define TP_STRUCT__entry(args...) args
132 #define __field(type, item) \
133 ret = trace_seq_printf(s, "\tfield:" #type " " #item ";\t" \
134 "offset:%u;\tsize:%u;\n", \
135 (unsigned int)offsetof(typeof(field), item), \
136 (unsigned int)sizeof(field.item)); \
141 #define __array(type, item, len) \
142 ret = trace_seq_printf(s, "\tfield:" #type " " #item "[" #len "];\t" \
143 "offset:%u;\tsize:%u;\n", \
144 (unsigned int)offsetof(typeof(field), item), \
145 (unsigned int)sizeof(field.item)); \
153 #define TP_printk(fmt, args...) "%s, %s\n", #fmt, __stringify(args)
155 #undef TP_fast_assign
156 #define TP_fast_assign(args...) args
159 #define TRACE_EVENT(call, proto, args, tstruct, func, print) \
161 ftrace_format_##call(struct trace_seq *s) \
163 struct ftrace_raw_##call field __attribute__((unused)); \
168 trace_seq_printf(s, "\nprint fmt: " print); \
173 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
176 #define __field(type, item) \
177 ret = trace_define_field(event_call, #type, #item, \
178 offsetof(typeof(field), item), \
179 sizeof(field.item)); \
184 #define __array(type, item, len) \
185 BUILD_BUG_ON(len > MAX_FILTER_STR_VAL); \
186 ret = trace_define_field(event_call, #type "[" #len "]", #item, \
187 offsetof(typeof(field), item), \
188 sizeof(field.item)); \
193 #define TRACE_EVENT(call, proto, args, tstruct, func, print) \
195 ftrace_define_fields_##call(void) \
197 struct ftrace_raw_##call field; \
198 struct ftrace_event_call *event_call = &event_##call; \
201 __common_field(unsigned char, type); \
202 __common_field(unsigned char, flags); \
203 __common_field(unsigned char, preempt_count); \
204 __common_field(int, pid); \
205 __common_field(int, tgid); \
212 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
215 * Stage 3 of the trace events.
217 * Override the macros in <trace/trace_events.h> to include the following:
219 * static void ftrace_event_<call>(proto)
221 * event_trace_printk(_RET_IP_, "<call>: " <fmt>);
224 * static int ftrace_reg_event_<call>(void)
228 * ret = register_trace_<call>(ftrace_event_<call>);
230 * pr_info("event trace: Could not activate trace point "
231 * "probe to <call>");
235 * static void ftrace_unreg_event_<call>(void)
237 * unregister_trace_<call>(ftrace_event_<call>);
240 * For those macros defined with TRACE_FORMAT:
242 * static struct ftrace_event_call __used
243 * __attribute__((__aligned__(4)))
244 * __attribute__((section("_ftrace_events"))) event_<call> = {
246 * .regfunc = ftrace_reg_event_<call>,
247 * .unregfunc = ftrace_unreg_event_<call>,
251 * For those macros defined with TRACE_EVENT:
253 * static struct ftrace_event_call event_<call>;
255 * static void ftrace_raw_event_<call>(proto)
257 * struct ring_buffer_event *event;
258 * struct ftrace_raw_<call> *entry; <-- defined in stage 1
259 * unsigned long irq_flags;
262 * local_save_flags(irq_flags);
263 * pc = preempt_count();
265 * event = trace_current_buffer_lock_reserve(event_<call>.id,
266 * sizeof(struct ftrace_raw_<call>),
270 * entry = ring_buffer_event_data(event);
272 * <assign>; <-- Here we assign the entries by the __field and
275 * trace_current_buffer_unlock_commit(event, irq_flags, pc);
278 * static int ftrace_raw_reg_event_<call>(void)
282 * ret = register_trace_<call>(ftrace_raw_event_<call>);
284 * pr_info("event trace: Could not activate trace point "
285 * "probe to <call>");
289 * static void ftrace_unreg_event_<call>(void)
291 * unregister_trace_<call>(ftrace_raw_event_<call>);
294 * static struct trace_event ftrace_event_type_<call> = {
295 * .trace = ftrace_raw_output_<call>, <-- stage 2
298 * static int ftrace_raw_init_event_<call>(void)
302 * id = register_ftrace_event(&ftrace_event_type_<call>);
305 * event_<call>.id = id;
309 * static struct ftrace_event_call __used
310 * __attribute__((__aligned__(4)))
311 * __attribute__((section("_ftrace_events"))) event_<call> = {
313 * .system = "<system>",
314 * .raw_init = ftrace_raw_init_event_<call>,
315 * .regfunc = ftrace_reg_event_<call>,
316 * .unregfunc = ftrace_unreg_event_<call>,
317 * .show_format = ftrace_format_<call>,
323 #define TP_FMT(fmt, args...) fmt "\n", ##args
325 #ifdef CONFIG_EVENT_PROFILE
326 #define _TRACE_PROFILE(call, proto, args) \
327 static void ftrace_profile_##call(proto) \
329 extern void perf_tpcounter_event(int); \
330 perf_tpcounter_event(event_##call.id); \
333 static int ftrace_profile_enable_##call(struct ftrace_event_call *call) \
337 if (!atomic_inc_return(&call->profile_count)) \
338 ret = register_trace_##call(ftrace_profile_##call); \
343 static void ftrace_profile_disable_##call(struct ftrace_event_call *call) \
345 if (atomic_add_negative(-1, &call->profile_count)) \
346 unregister_trace_##call(ftrace_profile_##call); \
349 #define _TRACE_PROFILE_INIT(call) \
350 .profile_count = ATOMIC_INIT(-1), \
351 .profile_enable = ftrace_profile_enable_##call, \
352 .profile_disable = ftrace_profile_disable_##call,
355 #define _TRACE_PROFILE(call, proto, args)
356 #define _TRACE_PROFILE_INIT(call)
359 #define _TRACE_FORMAT(call, proto, args, fmt) \
360 static void ftrace_event_##call(proto) \
362 event_trace_printk(_RET_IP_, #call ": " fmt); \
365 static int ftrace_reg_event_##call(void) \
369 ret = register_trace_##call(ftrace_event_##call); \
371 pr_info("event trace: Could not activate trace point " \
372 "probe to " #call "\n"); \
376 static void ftrace_unreg_event_##call(void) \
378 unregister_trace_##call(ftrace_event_##call); \
381 static struct ftrace_event_call event_##call; \
383 static int ftrace_init_event_##call(void) \
387 id = register_ftrace_event(NULL); \
390 event_##call.id = id; \
395 #define TRACE_FORMAT(call, proto, args, fmt) \
396 _TRACE_FORMAT(call, PARAMS(proto), PARAMS(args), PARAMS(fmt)) \
397 _TRACE_PROFILE(call, PARAMS(proto), PARAMS(args)) \
398 static struct ftrace_event_call __used \
399 __attribute__((__aligned__(4))) \
400 __attribute__((section("_ftrace_events"))) event_##call = { \
402 .system = __stringify(TRACE_SYSTEM), \
403 .raw_init = ftrace_init_event_##call, \
404 .regfunc = ftrace_reg_event_##call, \
405 .unregfunc = ftrace_unreg_event_##call, \
406 _TRACE_PROFILE_INIT(call) \
410 #define __entry entry
413 #define TRACE_EVENT(call, proto, args, tstruct, assign, print) \
414 _TRACE_PROFILE(call, PARAMS(proto), PARAMS(args)) \
416 static struct ftrace_event_call event_##call; \
418 static void ftrace_raw_event_##call(proto) \
420 struct ftrace_event_call *call = &event_##call; \
421 struct ring_buffer_event *event; \
422 struct ftrace_raw_##call *entry; \
423 unsigned long irq_flags; \
426 local_save_flags(irq_flags); \
427 pc = preempt_count(); \
429 event = trace_current_buffer_lock_reserve(event_##call.id, \
430 sizeof(struct ftrace_raw_##call), \
434 entry = ring_buffer_event_data(event); \
438 if (!filter_current_check_discard(call, entry, event)) \
439 trace_nowake_buffer_unlock_commit(event, irq_flags, pc); \
442 static int ftrace_raw_reg_event_##call(void) \
446 ret = register_trace_##call(ftrace_raw_event_##call); \
448 pr_info("event trace: Could not activate trace point " \
449 "probe to " #call "\n"); \
453 static void ftrace_raw_unreg_event_##call(void) \
455 unregister_trace_##call(ftrace_raw_event_##call); \
458 static struct trace_event ftrace_event_type_##call = { \
459 .trace = ftrace_raw_output_##call, \
462 static int ftrace_raw_init_event_##call(void) \
466 id = register_ftrace_event(&ftrace_event_type_##call); \
469 event_##call.id = id; \
470 INIT_LIST_HEAD(&event_##call.fields); \
471 init_preds(&event_##call); \
475 static struct ftrace_event_call __used \
476 __attribute__((__aligned__(4))) \
477 __attribute__((section("_ftrace_events"))) event_##call = { \
479 .system = __stringify(TRACE_SYSTEM), \
480 .event = &ftrace_event_type_##call, \
481 .raw_init = ftrace_raw_init_event_##call, \
482 .regfunc = ftrace_raw_reg_event_##call, \
483 .unregfunc = ftrace_raw_unreg_event_##call, \
484 .show_format = ftrace_format_##call, \
485 .define_fields = ftrace_define_fields_##call, \
486 _TRACE_PROFILE_INIT(call) \
489 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
491 #undef _TRACE_PROFILE
492 #undef _TRACE_PROFILE_INIT