OMAPDSS: HDMI: support larger register offsets for OMAP5 HDMI core
[linux-2.6/btrfs-unstable.git] / include / trace / ftrace.h
blob0a1a4f7caf095154c43aa901de0eca61be2b0208
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 #undef TRACE_EVENT_PERF_PERM
94 #define TRACE_EVENT_PERF_PERM(name, expr...) \
95 __TRACE_EVENT_PERF_PERM(name, expr)
97 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
101 * Stage 2 of the trace events.
103 * Include the following:
105 * struct ftrace_data_offsets_<call> {
106 * u32 <item1>;
107 * u32 <item2>;
108 * [...]
109 * };
111 * The __dynamic_array() macro will create each u32 <item>, this is
112 * to keep the offset of each array from the beginning of the event.
113 * The size of an array is also encoded, in the higher 16 bits of <item>.
116 #undef __field
117 #define __field(type, item)
119 #undef __field_ext
120 #define __field_ext(type, item, filter_type)
122 #undef __array
123 #define __array(type, item, len)
125 #undef __dynamic_array
126 #define __dynamic_array(type, item, len) u32 item;
128 #undef __string
129 #define __string(item, src) __dynamic_array(char, item, -1)
131 #undef DECLARE_EVENT_CLASS
132 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
133 struct ftrace_data_offsets_##call { \
134 tstruct; \
137 #undef DEFINE_EVENT
138 #define DEFINE_EVENT(template, name, proto, args)
140 #undef DEFINE_EVENT_PRINT
141 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
142 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
144 #undef TRACE_EVENT_FLAGS
145 #define TRACE_EVENT_FLAGS(event, flag)
147 #undef TRACE_EVENT_PERF_PERM
148 #define TRACE_EVENT_PERF_PERM(event, expr...)
150 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
153 * Stage 3 of the trace events.
155 * Override the macros in <trace/trace_events.h> to include the following:
157 * enum print_line_t
158 * ftrace_raw_output_<call>(struct trace_iterator *iter, int flags)
160 * struct trace_seq *s = &iter->seq;
161 * struct ftrace_raw_<call> *field; <-- defined in stage 1
162 * struct trace_entry *entry;
163 * struct trace_seq *p = &iter->tmp_seq;
164 * int ret;
166 * entry = iter->ent;
168 * if (entry->type != event_<call>->event.type) {
169 * WARN_ON_ONCE(1);
170 * return TRACE_TYPE_UNHANDLED;
173 * field = (typeof(field))entry;
175 * trace_seq_init(p);
176 * ret = trace_seq_printf(s, "%s: ", <call>);
177 * if (ret)
178 * ret = trace_seq_printf(s, <TP_printk> "\n");
179 * if (!ret)
180 * return TRACE_TYPE_PARTIAL_LINE;
182 * return TRACE_TYPE_HANDLED;
185 * This is the method used to print the raw event to the trace
186 * output format. Note, this is not needed if the data is read
187 * in binary.
190 #undef __entry
191 #define __entry field
193 #undef TP_printk
194 #define TP_printk(fmt, args...) fmt "\n", args
196 #undef __get_dynamic_array
197 #define __get_dynamic_array(field) \
198 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
200 #undef __get_str
201 #define __get_str(field) (char *)__get_dynamic_array(field)
203 #undef __print_flags
204 #define __print_flags(flag, delim, flag_array...) \
205 ({ \
206 static const struct trace_print_flags __flags[] = \
207 { flag_array, { -1, NULL }}; \
208 ftrace_print_flags_seq(p, delim, flag, __flags); \
211 #undef __print_symbolic
212 #define __print_symbolic(value, symbol_array...) \
213 ({ \
214 static const struct trace_print_flags symbols[] = \
215 { symbol_array, { -1, NULL }}; \
216 ftrace_print_symbols_seq(p, value, symbols); \
219 #undef __print_symbolic_u64
220 #if BITS_PER_LONG == 32
221 #define __print_symbolic_u64(value, symbol_array...) \
222 ({ \
223 static const struct trace_print_flags_u64 symbols[] = \
224 { symbol_array, { -1, NULL } }; \
225 ftrace_print_symbols_seq_u64(p, value, symbols); \
227 #else
228 #define __print_symbolic_u64(value, symbol_array...) \
229 __print_symbolic(value, symbol_array)
230 #endif
232 #undef __print_hex
233 #define __print_hex(buf, buf_len) ftrace_print_hex_seq(p, buf, buf_len)
235 #undef DECLARE_EVENT_CLASS
236 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
237 static notrace enum print_line_t \
238 ftrace_raw_output_##call(struct trace_iterator *iter, int flags, \
239 struct trace_event *trace_event) \
241 struct trace_seq *s = &iter->seq; \
242 struct trace_seq __maybe_unused *p = &iter->tmp_seq; \
243 struct ftrace_raw_##call *field; \
244 int ret; \
246 field = (typeof(field))iter->ent; \
248 ret = ftrace_raw_output_prep(iter, trace_event); \
249 if (ret) \
250 return ret; \
252 ret = trace_seq_printf(s, print); \
253 if (!ret) \
254 return TRACE_TYPE_PARTIAL_LINE; \
256 return TRACE_TYPE_HANDLED; \
258 static struct trace_event_functions ftrace_event_type_funcs_##call = { \
259 .trace = ftrace_raw_output_##call, \
262 #undef DEFINE_EVENT_PRINT
263 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
264 static notrace enum print_line_t \
265 ftrace_raw_output_##call(struct trace_iterator *iter, int flags, \
266 struct trace_event *event) \
268 struct ftrace_raw_##template *field; \
269 struct trace_entry *entry; \
270 struct trace_seq *p = &iter->tmp_seq; \
272 entry = iter->ent; \
274 if (entry->type != event_##call.event.type) { \
275 WARN_ON_ONCE(1); \
276 return TRACE_TYPE_UNHANDLED; \
279 field = (typeof(field))entry; \
281 trace_seq_init(p); \
282 return ftrace_output_call(iter, #call, print); \
284 static struct trace_event_functions ftrace_event_type_funcs_##call = { \
285 .trace = ftrace_raw_output_##call, \
288 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
290 #undef __field_ext
291 #define __field_ext(type, item, filter_type) \
292 ret = trace_define_field(event_call, #type, #item, \
293 offsetof(typeof(field), item), \
294 sizeof(field.item), \
295 is_signed_type(type), filter_type); \
296 if (ret) \
297 return ret;
299 #undef __field
300 #define __field(type, item) __field_ext(type, item, FILTER_OTHER)
302 #undef __array
303 #define __array(type, item, len) \
304 do { \
305 char *type_str = #type"["__stringify(len)"]"; \
306 BUILD_BUG_ON(len > MAX_FILTER_STR_VAL); \
307 ret = trace_define_field(event_call, type_str, #item, \
308 offsetof(typeof(field), item), \
309 sizeof(field.item), \
310 is_signed_type(type), FILTER_OTHER); \
311 if (ret) \
312 return ret; \
313 } while (0);
315 #undef __dynamic_array
316 #define __dynamic_array(type, item, len) \
317 ret = trace_define_field(event_call, "__data_loc " #type "[]", #item, \
318 offsetof(typeof(field), __data_loc_##item), \
319 sizeof(field.__data_loc_##item), \
320 is_signed_type(type), FILTER_OTHER);
322 #undef __string
323 #define __string(item, src) __dynamic_array(char, item, -1)
325 #undef DECLARE_EVENT_CLASS
326 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, func, print) \
327 static int notrace __init \
328 ftrace_define_fields_##call(struct ftrace_event_call *event_call) \
330 struct ftrace_raw_##call field; \
331 int ret; \
333 tstruct; \
335 return ret; \
338 #undef DEFINE_EVENT
339 #define DEFINE_EVENT(template, name, proto, args)
341 #undef DEFINE_EVENT_PRINT
342 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
343 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
345 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
348 * remember the offset of each array from the beginning of the event.
351 #undef __entry
352 #define __entry entry
354 #undef __field
355 #define __field(type, item)
357 #undef __field_ext
358 #define __field_ext(type, item, filter_type)
360 #undef __array
361 #define __array(type, item, len)
363 #undef __dynamic_array
364 #define __dynamic_array(type, item, len) \
365 __item_length = (len) * sizeof(type); \
366 __data_offsets->item = __data_size + \
367 offsetof(typeof(*entry), __data); \
368 __data_offsets->item |= __item_length << 16; \
369 __data_size += __item_length;
371 #undef __string
372 #define __string(item, src) __dynamic_array(char, item, \
373 strlen((src) ? (const char *)(src) : "(null)") + 1)
375 #undef DECLARE_EVENT_CLASS
376 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
377 static inline notrace int ftrace_get_offsets_##call( \
378 struct ftrace_data_offsets_##call *__data_offsets, proto) \
380 int __data_size = 0; \
381 int __maybe_unused __item_length; \
382 struct ftrace_raw_##call __maybe_unused *entry; \
384 tstruct; \
386 return __data_size; \
389 #undef DEFINE_EVENT
390 #define DEFINE_EVENT(template, name, proto, args)
392 #undef DEFINE_EVENT_PRINT
393 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
394 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
396 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
399 * Stage 4 of the trace events.
401 * Override the macros in <trace/trace_events.h> to include the following:
403 * For those macros defined with TRACE_EVENT:
405 * static struct ftrace_event_call event_<call>;
407 * static void ftrace_raw_event_<call>(void *__data, proto)
409 * struct ftrace_event_file *ftrace_file = __data;
410 * struct ftrace_event_call *event_call = ftrace_file->event_call;
411 * struct ftrace_data_offsets_<call> __maybe_unused __data_offsets;
412 * unsigned long eflags = ftrace_file->flags;
413 * enum event_trigger_type __tt = ETT_NONE;
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 (!(eflags & FTRACE_EVENT_FL_TRIGGER_COND)) {
422 * if (eflags & FTRACE_EVENT_FL_TRIGGER_MODE)
423 * event_triggers_call(ftrace_file, NULL);
424 * if (eflags & FTRACE_EVENT_FL_SOFT_DISABLED)
425 * return;
428 * local_save_flags(irq_flags);
429 * pc = preempt_count();
431 * __data_size = ftrace_get_offsets_<call>(&__data_offsets, args);
433 * event = trace_event_buffer_lock_reserve(&buffer, ftrace_file,
434 * event_<call>->event.type,
435 * sizeof(*entry) + __data_size,
436 * irq_flags, pc);
437 * if (!event)
438 * return;
439 * entry = ring_buffer_event_data(event);
441 * { <assign>; } <-- Here we assign the entries by the __field and
442 * __array macros.
444 * if (eflags & FTRACE_EVENT_FL_TRIGGER_COND)
445 * __tt = event_triggers_call(ftrace_file, entry);
447 * if (test_bit(FTRACE_EVENT_FL_SOFT_DISABLED_BIT,
448 * &ftrace_file->flags))
449 * ring_buffer_discard_commit(buffer, event);
450 * else if (!filter_check_discard(ftrace_file, entry, buffer, event))
451 * trace_buffer_unlock_commit(buffer, event, irq_flags, pc);
453 * if (__tt)
454 * event_triggers_post_call(ftrace_file, __tt);
457 * static struct trace_event ftrace_event_type_<call> = {
458 * .trace = ftrace_raw_output_<call>, <-- stage 2
459 * };
461 * static const char print_fmt_<call>[] = <TP_printk>;
463 * static struct ftrace_event_class __used event_class_<template> = {
464 * .system = "<system>",
465 * .define_fields = ftrace_define_fields_<call>,
466 * .fields = LIST_HEAD_INIT(event_class_##call.fields),
467 * .raw_init = trace_event_raw_init,
468 * .probe = ftrace_raw_event_##call,
469 * .reg = ftrace_event_reg,
470 * };
472 * static struct ftrace_event_call event_<call> = {
473 * .class = event_class_<template>,
475 * .tp = &__tracepoint_<call>,
476 * },
477 * .event = &ftrace_event_type_<call>,
478 * .print_fmt = print_fmt_<call>,
479 * .flags = TRACE_EVENT_FL_TRACEPOINT,
480 * };
481 * // its only safe to use pointers when doing linker tricks to
482 * // create an array.
483 * static struct ftrace_event_call __used
484 * __attribute__((section("_ftrace_events"))) *__event_<call> = &event_<call>;
488 #ifdef CONFIG_PERF_EVENTS
490 #define _TRACE_PERF_PROTO(call, proto) \
491 static notrace void \
492 perf_trace_##call(void *__data, proto);
494 #define _TRACE_PERF_INIT(call) \
495 .perf_probe = perf_trace_##call,
497 #else
498 #define _TRACE_PERF_PROTO(call, proto)
499 #define _TRACE_PERF_INIT(call)
500 #endif /* CONFIG_PERF_EVENTS */
502 #undef __entry
503 #define __entry entry
505 #undef __field
506 #define __field(type, item)
508 #undef __array
509 #define __array(type, item, len)
511 #undef __dynamic_array
512 #define __dynamic_array(type, item, len) \
513 __entry->__data_loc_##item = __data_offsets.item;
515 #undef __string
516 #define __string(item, src) __dynamic_array(char, item, -1) \
518 #undef __assign_str
519 #define __assign_str(dst, src) \
520 strcpy(__get_str(dst), (src) ? (const char *)(src) : "(null)");
522 #undef TP_fast_assign
523 #define TP_fast_assign(args...) args
525 #undef __perf_addr
526 #define __perf_addr(a) (a)
528 #undef __perf_count
529 #define __perf_count(c) (c)
531 #undef __perf_task
532 #define __perf_task(t) (t)
534 #undef DECLARE_EVENT_CLASS
535 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
537 static notrace void \
538 ftrace_raw_event_##call(void *__data, proto) \
540 struct ftrace_event_file *ftrace_file = __data; \
541 struct ftrace_data_offsets_##call __maybe_unused __data_offsets;\
542 struct ftrace_event_buffer fbuffer; \
543 struct ftrace_raw_##call *entry; \
544 int __data_size; \
546 if (ftrace_trigger_soft_disabled(ftrace_file)) \
547 return; \
549 __data_size = ftrace_get_offsets_##call(&__data_offsets, args); \
551 entry = ftrace_event_buffer_reserve(&fbuffer, ftrace_file, \
552 sizeof(*entry) + __data_size); \
554 if (!entry) \
555 return; \
557 tstruct \
559 { assign; } \
561 ftrace_event_buffer_commit(&fbuffer); \
564 * The ftrace_test_probe is compiled out, it is only here as a build time check
565 * to make sure that if the tracepoint handling changes, the ftrace probe will
566 * fail to compile unless it too is updated.
569 #undef DEFINE_EVENT
570 #define DEFINE_EVENT(template, call, proto, args) \
571 static inline void ftrace_test_probe_##call(void) \
573 check_trace_callback_type_##call(ftrace_raw_event_##template); \
576 #undef DEFINE_EVENT_PRINT
577 #define DEFINE_EVENT_PRINT(template, name, proto, args, print)
579 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
581 #undef __entry
582 #define __entry REC
584 #undef __print_flags
585 #undef __print_symbolic
586 #undef __print_hex
587 #undef __get_dynamic_array
588 #undef __get_str
590 #undef TP_printk
591 #define TP_printk(fmt, args...) "\"" fmt "\", " __stringify(args)
593 #undef DECLARE_EVENT_CLASS
594 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
595 _TRACE_PERF_PROTO(call, PARAMS(proto)); \
596 static const char print_fmt_##call[] = print; \
597 static struct ftrace_event_class __used __refdata event_class_##call = { \
598 .system = __stringify(TRACE_SYSTEM), \
599 .define_fields = ftrace_define_fields_##call, \
600 .fields = LIST_HEAD_INIT(event_class_##call.fields),\
601 .raw_init = trace_event_raw_init, \
602 .probe = ftrace_raw_event_##call, \
603 .reg = ftrace_event_reg, \
604 _TRACE_PERF_INIT(call) \
607 #undef DEFINE_EVENT
608 #define DEFINE_EVENT(template, call, proto, args) \
610 static struct ftrace_event_call __used event_##call = { \
611 .class = &event_class_##template, \
613 .tp = &__tracepoint_##call, \
614 }, \
615 .event.funcs = &ftrace_event_type_funcs_##template, \
616 .print_fmt = print_fmt_##template, \
617 .flags = TRACE_EVENT_FL_TRACEPOINT, \
618 }; \
619 static struct ftrace_event_call __used \
620 __attribute__((section("_ftrace_events"))) *__event_##call = &event_##call
622 #undef DEFINE_EVENT_PRINT
623 #define DEFINE_EVENT_PRINT(template, call, proto, args, print) \
625 static const char print_fmt_##call[] = print; \
627 static struct ftrace_event_call __used event_##call = { \
628 .class = &event_class_##template, \
630 .tp = &__tracepoint_##call, \
631 }, \
632 .event.funcs = &ftrace_event_type_funcs_##call, \
633 .print_fmt = print_fmt_##call, \
634 .flags = TRACE_EVENT_FL_TRACEPOINT, \
635 }; \
636 static struct ftrace_event_call __used \
637 __attribute__((section("_ftrace_events"))) *__event_##call = &event_##call
639 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
642 #ifdef CONFIG_PERF_EVENTS
644 #undef __entry
645 #define __entry entry
647 #undef __get_dynamic_array
648 #define __get_dynamic_array(field) \
649 ((void *)__entry + (__entry->__data_loc_##field & 0xffff))
651 #undef __get_str
652 #define __get_str(field) (char *)__get_dynamic_array(field)
654 #undef __perf_addr
655 #define __perf_addr(a) (__addr = (a))
657 #undef __perf_count
658 #define __perf_count(c) (__count = (c))
660 #undef __perf_task
661 #define __perf_task(t) (__task = (t))
663 #undef DECLARE_EVENT_CLASS
664 #define DECLARE_EVENT_CLASS(call, proto, args, tstruct, assign, print) \
665 static notrace void \
666 perf_trace_##call(void *__data, proto) \
668 struct ftrace_event_call *event_call = __data; \
669 struct ftrace_data_offsets_##call __maybe_unused __data_offsets;\
670 struct ftrace_raw_##call *entry; \
671 struct pt_regs __regs; \
672 u64 __addr = 0, __count = 1; \
673 struct task_struct *__task = NULL; \
674 struct hlist_head *head; \
675 int __entry_size; \
676 int __data_size; \
677 int rctx; \
679 __data_size = ftrace_get_offsets_##call(&__data_offsets, args); \
681 head = this_cpu_ptr(event_call->perf_events); \
682 if (__builtin_constant_p(!__task) && !__task && \
683 hlist_empty(head)) \
684 return; \
686 __entry_size = ALIGN(__data_size + sizeof(*entry) + sizeof(u32),\
687 sizeof(u64)); \
688 __entry_size -= sizeof(u32); \
690 perf_fetch_caller_regs(&__regs); \
691 entry = perf_trace_buf_prepare(__entry_size, \
692 event_call->event.type, &__regs, &rctx); \
693 if (!entry) \
694 return; \
696 tstruct \
698 { assign; } \
700 perf_trace_buf_submit(entry, __entry_size, rctx, __addr, \
701 __count, &__regs, head, __task); \
705 * This part is compiled out, it is only here as a build time check
706 * to make sure that if the tracepoint handling changes, the
707 * perf probe will fail to compile unless it too is updated.
709 #undef DEFINE_EVENT
710 #define DEFINE_EVENT(template, call, proto, args) \
711 static inline void perf_test_probe_##call(void) \
713 check_trace_callback_type_##call(perf_trace_##template); \
717 #undef DEFINE_EVENT_PRINT
718 #define DEFINE_EVENT_PRINT(template, name, proto, args, print) \
719 DEFINE_EVENT(template, name, PARAMS(proto), PARAMS(args))
721 #include TRACE_INCLUDE(TRACE_INCLUDE_FILE)
722 #endif /* CONFIG_PERF_EVENTS */