4 * Copyright (C) 2008 Red Hat Inc, Steven Rostedt <srostedt@redhat.com>
6 * - Added format output of fields of the trace point.
7 * This was based off of work by Tom Zanussi <tzanussi@gmail.com>.
11 #include <linux/workqueue.h>
12 #include <linux/spinlock.h>
13 #include <linux/kthread.h>
14 #include <linux/debugfs.h>
15 #include <linux/uaccess.h>
16 #include <linux/module.h>
17 #include <linux/ctype.h>
18 #include <linux/delay.h>
20 #include "trace_output.h"
22 #define TRACE_SYSTEM "TRACE_SYSTEM"
24 static DEFINE_MUTEX(event_mutex);
26 LIST_HEAD(ftrace_events);
28 int trace_define_field(struct ftrace_event_call *call, char *type,
29 char *name, int offset, int size)
31 struct ftrace_event_field *field;
33 field = kzalloc(sizeof(*field), GFP_KERNEL);
37 field->name = kstrdup(name, GFP_KERNEL);
41 field->type = kstrdup(type, GFP_KERNEL);
45 field->offset = offset;
47 list_add(&field->link, &call->fields);
60 EXPORT_SYMBOL_GPL(trace_define_field);
62 static void ftrace_clear_events(void)
64 struct ftrace_event_call *call;
66 list_for_each_entry(call, &ftrace_events, list) {
75 static void ftrace_event_enable_disable(struct ftrace_event_call *call,
95 static int ftrace_set_clr_event(char *buf, int set)
97 struct ftrace_event_call *call;
98 char *event = NULL, *sub = NULL, *match;
102 * The buf format can be <subsystem>:<event-name>
103 * *:<event-name> means any event by that name.
104 * :<event-name> is the same.
106 * <subsystem>:* means all events in that subsystem
107 * <subsystem>: means the same.
109 * <name> (no ':') means all events in a subsystem with
110 * the name <name> or any event that matches <name>
113 match = strsep(&buf, ":");
119 if (!strlen(sub) || strcmp(sub, "*") == 0)
121 if (!strlen(event) || strcmp(event, "*") == 0)
125 mutex_lock(&event_mutex);
126 list_for_each_entry(call, &ftrace_events, list) {
128 if (!call->name || !call->regfunc)
132 strcmp(match, call->name) != 0 &&
133 strcmp(match, call->system) != 0)
136 if (sub && strcmp(sub, call->system) != 0)
139 if (event && strcmp(event, call->name) != 0)
142 ftrace_event_enable_disable(call, set);
146 mutex_unlock(&event_mutex);
151 /* 128 should be much more than enough */
152 #define EVENT_BUF_SIZE 127
155 ftrace_event_write(struct file *file, const char __user *ubuf,
156 size_t cnt, loff_t *ppos)
167 ret = tracing_update_buffers();
171 ret = get_user(ch, ubuf++);
177 /* skip white space */
178 while (cnt && isspace(ch)) {
179 ret = get_user(ch, ubuf++);
186 /* Only white space found? */
193 buf = kmalloc(EVENT_BUF_SIZE+1, GFP_KERNEL);
197 if (cnt > EVENT_BUF_SIZE)
198 cnt = EVENT_BUF_SIZE;
201 while (cnt && !isspace(ch)) {
207 ret = get_user(ch, ubuf++);
217 ret = ftrace_set_clr_event(buf, set);
230 t_next(struct seq_file *m, void *v, loff_t *pos)
232 struct list_head *list = m->private;
233 struct ftrace_event_call *call;
238 if (list == &ftrace_events)
241 call = list_entry(list, struct ftrace_event_call, list);
244 * The ftrace subsystem is for showing formats only.
245 * They can not be enabled or disabled via the event files.
253 m->private = list->next;
258 static void *t_start(struct seq_file *m, loff_t *pos)
260 return t_next(m, NULL, pos);
264 s_next(struct seq_file *m, void *v, loff_t *pos)
266 struct list_head *list = m->private;
267 struct ftrace_event_call *call;
272 if (list == &ftrace_events)
275 call = list_entry(list, struct ftrace_event_call, list);
277 if (!call->enabled) {
282 m->private = list->next;
287 static void *s_start(struct seq_file *m, loff_t *pos)
289 return s_next(m, NULL, pos);
292 static int t_show(struct seq_file *m, void *v)
294 struct ftrace_event_call *call = v;
296 if (strcmp(call->system, TRACE_SYSTEM) != 0)
297 seq_printf(m, "%s:", call->system);
298 seq_printf(m, "%s\n", call->name);
303 static void t_stop(struct seq_file *m, void *p)
308 ftrace_event_seq_open(struct inode *inode, struct file *file)
311 const struct seq_operations *seq_ops;
313 if ((file->f_mode & FMODE_WRITE) &&
314 !(file->f_flags & O_APPEND))
315 ftrace_clear_events();
317 seq_ops = inode->i_private;
318 ret = seq_open(file, seq_ops);
320 struct seq_file *m = file->private_data;
322 m->private = ftrace_events.next;
328 event_enable_read(struct file *filp, char __user *ubuf, size_t cnt,
331 struct ftrace_event_call *call = filp->private_data;
339 return simple_read_from_buffer(ubuf, cnt, ppos, buf, 2);
343 event_enable_write(struct file *filp, const char __user *ubuf, size_t cnt,
346 struct ftrace_event_call *call = filp->private_data;
351 if (cnt >= sizeof(buf))
354 if (copy_from_user(&buf, ubuf, cnt))
359 ret = strict_strtoul(buf, 10, &val);
363 ret = tracing_update_buffers();
370 mutex_lock(&event_mutex);
371 ftrace_event_enable_disable(call, val);
372 mutex_unlock(&event_mutex);
384 extern char *__bad_type_size(void);
387 #define FIELD(type, name) \
388 sizeof(type) != sizeof(field.name) ? __bad_type_size() : \
389 #type, "common_" #name, offsetof(typeof(field), name), \
392 static int trace_write_header(struct trace_seq *s)
394 struct trace_entry field;
396 /* struct trace_entry */
397 return trace_seq_printf(s,
398 "\tfield:%s %s;\toffset:%zu;\tsize:%zu;\n"
399 "\tfield:%s %s;\toffset:%zu;\tsize:%zu;\n"
400 "\tfield:%s %s;\toffset:%zu;\tsize:%zu;\n"
401 "\tfield:%s %s;\toffset:%zu;\tsize:%zu;\n"
402 "\tfield:%s %s;\toffset:%zu;\tsize:%zu;\n"
404 FIELD(unsigned short, type),
405 FIELD(unsigned char, flags),
406 FIELD(unsigned char, preempt_count),
412 event_format_read(struct file *filp, char __user *ubuf, size_t cnt,
415 struct ftrace_event_call *call = filp->private_data;
423 s = kmalloc(sizeof(*s), GFP_KERNEL);
429 /* If any of the first writes fail, so will the show_format. */
431 trace_seq_printf(s, "name: %s\n", call->name);
432 trace_seq_printf(s, "ID: %d\n", call->id);
433 trace_seq_printf(s, "format:\n");
434 trace_write_header(s);
436 r = call->show_format(s);
439 * ug! The format output is bigger than a PAGE!!
441 buf = "FORMAT TOO BIG\n";
442 r = simple_read_from_buffer(ubuf, cnt, ppos,
447 r = simple_read_from_buffer(ubuf, cnt, ppos,
455 event_id_read(struct file *filp, char __user *ubuf, size_t cnt, loff_t *ppos)
457 struct ftrace_event_call *call = filp->private_data;
464 s = kmalloc(sizeof(*s), GFP_KERNEL);
469 trace_seq_printf(s, "%d\n", call->id);
471 r = simple_read_from_buffer(ubuf, cnt, ppos,
478 event_filter_read(struct file *filp, char __user *ubuf, size_t cnt,
481 struct ftrace_event_call *call = filp->private_data;
488 s = kmalloc(sizeof(*s), GFP_KERNEL);
494 filter_print_preds(call, s);
495 r = simple_read_from_buffer(ubuf, cnt, ppos, s->buffer, s->len);
503 event_filter_write(struct file *filp, const char __user *ubuf, size_t cnt,
506 struct ftrace_event_call *call = filp->private_data;
507 char buf[64], *pbuf = buf;
508 struct filter_pred *pred;
511 if (cnt >= sizeof(buf))
514 if (copy_from_user(&buf, ubuf, cnt))
518 pred = kzalloc(sizeof(*pred), GFP_KERNEL);
522 err = filter_parse(&pbuf, pred);
524 filter_free_pred(pred);
529 filter_disable_preds(call);
530 filter_free_pred(pred);
534 err = filter_add_pred(call, pred);
536 filter_free_pred(pred);
540 filter_free_pred(pred);
548 subsystem_filter_read(struct file *filp, char __user *ubuf, size_t cnt,
551 struct event_subsystem *system = filp->private_data;
558 s = kmalloc(sizeof(*s), GFP_KERNEL);
564 filter_print_subsystem_preds(system, s);
565 r = simple_read_from_buffer(ubuf, cnt, ppos, s->buffer, s->len);
573 subsystem_filter_write(struct file *filp, const char __user *ubuf, size_t cnt,
576 struct event_subsystem *system = filp->private_data;
577 char buf[64], *pbuf = buf;
578 struct filter_pred *pred;
581 if (cnt >= sizeof(buf))
584 if (copy_from_user(&buf, ubuf, cnt))
588 pred = kzalloc(sizeof(*pred), GFP_KERNEL);
592 err = filter_parse(&pbuf, pred);
594 filter_free_pred(pred);
599 filter_free_subsystem_preds(system);
600 filter_free_pred(pred);
604 err = filter_add_subsystem_pred(system, pred);
606 filter_free_pred(pred);
616 show_header(struct file *filp, char __user *ubuf, size_t cnt, loff_t *ppos)
618 int (*func)(struct trace_seq *s) = filp->private_data;
625 s = kmalloc(sizeof(*s), GFP_KERNEL);
632 r = simple_read_from_buffer(ubuf, cnt, ppos, s->buffer, s->len);
639 static const struct seq_operations show_event_seq_ops = {
646 static const struct seq_operations show_set_event_seq_ops = {
653 static const struct file_operations ftrace_avail_fops = {
654 .open = ftrace_event_seq_open,
657 .release = seq_release,
660 static const struct file_operations ftrace_set_event_fops = {
661 .open = ftrace_event_seq_open,
663 .write = ftrace_event_write,
665 .release = seq_release,
668 static const struct file_operations ftrace_enable_fops = {
669 .open = tracing_open_generic,
670 .read = event_enable_read,
671 .write = event_enable_write,
674 static const struct file_operations ftrace_event_format_fops = {
675 .open = tracing_open_generic,
676 .read = event_format_read,
679 static const struct file_operations ftrace_event_id_fops = {
680 .open = tracing_open_generic,
681 .read = event_id_read,
684 static const struct file_operations ftrace_event_filter_fops = {
685 .open = tracing_open_generic,
686 .read = event_filter_read,
687 .write = event_filter_write,
690 static const struct file_operations ftrace_subsystem_filter_fops = {
691 .open = tracing_open_generic,
692 .read = subsystem_filter_read,
693 .write = subsystem_filter_write,
696 static const struct file_operations ftrace_show_header_fops = {
697 .open = tracing_open_generic,
701 static struct dentry *event_trace_events_dir(void)
703 static struct dentry *d_tracer;
704 static struct dentry *d_events;
709 d_tracer = tracing_init_dentry();
713 d_events = debugfs_create_dir("events", d_tracer);
715 pr_warning("Could not create debugfs "
716 "'events' directory\n");
721 static LIST_HEAD(event_subsystems);
723 static struct dentry *
724 event_subsystem_dir(const char *name, struct dentry *d_events)
726 struct event_subsystem *system;
727 struct dentry *entry;
729 /* First see if we did not already create this dir */
730 list_for_each_entry(system, &event_subsystems, list) {
731 if (strcmp(system->name, name) == 0)
732 return system->entry;
735 /* need to create new entry */
736 system = kmalloc(sizeof(*system), GFP_KERNEL);
738 pr_warning("No memory to create event subsystem %s\n",
743 system->entry = debugfs_create_dir(name, d_events);
744 if (!system->entry) {
745 pr_warning("Could not create event subsystem %s\n",
751 system->name = kstrdup(name, GFP_KERNEL);
753 debugfs_remove(system->entry);
758 list_add(&system->list, &event_subsystems);
760 system->filter = NULL;
762 entry = debugfs_create_file("filter", 0644, system->entry, system,
763 &ftrace_subsystem_filter_fops);
765 pr_warning("Could not create debugfs "
766 "'%s/filter' entry\n", name);
768 return system->entry;
772 event_create_dir(struct ftrace_event_call *call, struct dentry *d_events,
773 const struct file_operations *id,
774 const struct file_operations *enable,
775 const struct file_operations *filter,
776 const struct file_operations *format)
778 struct dentry *entry;
782 * If the trace point header did not define TRACE_SYSTEM
783 * then the system would be called "TRACE_SYSTEM".
785 if (strcmp(call->system, TRACE_SYSTEM) != 0)
786 d_events = event_subsystem_dir(call->system, d_events);
788 if (call->raw_init) {
789 ret = call->raw_init();
791 pr_warning("Could not initialize trace point"
792 " events/%s\n", call->name);
797 call->dir = debugfs_create_dir(call->name, d_events);
799 pr_warning("Could not create debugfs "
800 "'%s' directory\n", call->name);
805 entry = trace_create_file("enable", 0644, call->dir, call,
809 entry = trace_create_file("id", 0444, call->dir, call,
812 if (call->define_fields) {
813 ret = call->define_fields();
815 pr_warning("Could not initialize trace point"
816 " events/%s\n", call->name);
819 entry = trace_create_file("filter", 0644, call->dir, call,
823 /* A trace may not want to export its format */
824 if (!call->show_format)
827 entry = trace_create_file("format", 0444, call->dir, call,
833 #define for_each_event(event, start, end) \
834 for (event = start; \
835 (unsigned long)event < (unsigned long)end; \
838 #ifdef CONFIG_MODULES
840 static LIST_HEAD(ftrace_module_file_list);
843 * Modules must own their file_operations to keep up with
844 * reference counting.
846 struct ftrace_module_file_ops {
847 struct list_head list;
849 struct file_operations id;
850 struct file_operations enable;
851 struct file_operations format;
852 struct file_operations filter;
855 static struct ftrace_module_file_ops *
856 trace_create_file_ops(struct module *mod)
858 struct ftrace_module_file_ops *file_ops;
861 * This is a bit of a PITA. To allow for correct reference
862 * counting, modules must "own" their file_operations.
863 * To do this, we allocate the file operations that will be
864 * used in the event directory.
867 file_ops = kmalloc(sizeof(*file_ops), GFP_KERNEL);
873 file_ops->id = ftrace_event_id_fops;
874 file_ops->id.owner = mod;
876 file_ops->enable = ftrace_enable_fops;
877 file_ops->enable.owner = mod;
879 file_ops->filter = ftrace_event_filter_fops;
880 file_ops->filter.owner = mod;
882 file_ops->format = ftrace_event_format_fops;
883 file_ops->format.owner = mod;
885 list_add(&file_ops->list, &ftrace_module_file_list);
890 static void trace_module_add_events(struct module *mod)
892 struct ftrace_module_file_ops *file_ops = NULL;
893 struct ftrace_event_call *call, *start, *end;
894 struct dentry *d_events;
896 start = mod->trace_events;
897 end = mod->trace_events + mod->num_trace_events;
902 d_events = event_trace_events_dir();
906 for_each_event(call, start, end) {
907 /* The linker may leave blanks */
912 * This module has events, create file ops for this module
913 * if not already done.
916 file_ops = trace_create_file_ops(mod);
921 list_add(&call->list, &ftrace_events);
922 event_create_dir(call, d_events,
923 &file_ops->id, &file_ops->enable,
924 &file_ops->filter, &file_ops->format);
928 static void trace_module_remove_events(struct module *mod)
930 struct ftrace_module_file_ops *file_ops;
931 struct ftrace_event_call *call, *p;
933 list_for_each_entry_safe(call, p, &ftrace_events, list) {
934 if (call->mod == mod) {
940 unregister_ftrace_event(call->event);
941 debugfs_remove_recursive(call->dir);
942 list_del(&call->list);
946 /* Now free the file_operations */
947 list_for_each_entry(file_ops, &ftrace_module_file_list, list) {
948 if (file_ops->mod == mod)
951 if (&file_ops->list != &ftrace_module_file_list) {
952 list_del(&file_ops->list);
957 static int trace_module_notify(struct notifier_block *self,
958 unsigned long val, void *data)
960 struct module *mod = data;
962 mutex_lock(&event_mutex);
964 case MODULE_STATE_COMING:
965 trace_module_add_events(mod);
967 case MODULE_STATE_GOING:
968 trace_module_remove_events(mod);
971 mutex_unlock(&event_mutex);
976 static int trace_module_notify(struct notifier_block *self,
977 unsigned long val, void *data)
981 #endif /* CONFIG_MODULES */
983 struct notifier_block trace_module_nb = {
984 .notifier_call = trace_module_notify,
988 extern struct ftrace_event_call __start_ftrace_events[];
989 extern struct ftrace_event_call __stop_ftrace_events[];
991 static __init int event_trace_init(void)
993 struct ftrace_event_call *call;
994 struct dentry *d_tracer;
995 struct dentry *entry;
996 struct dentry *d_events;
999 d_tracer = tracing_init_dentry();
1003 entry = debugfs_create_file("available_events", 0444, d_tracer,
1004 (void *)&show_event_seq_ops,
1005 &ftrace_avail_fops);
1007 pr_warning("Could not create debugfs "
1008 "'available_events' entry\n");
1010 entry = debugfs_create_file("set_event", 0644, d_tracer,
1011 (void *)&show_set_event_seq_ops,
1012 &ftrace_set_event_fops);
1014 pr_warning("Could not create debugfs "
1015 "'set_event' entry\n");
1017 d_events = event_trace_events_dir();
1021 /* ring buffer internal formats */
1022 trace_create_file("header_page", 0444, d_events,
1023 ring_buffer_print_page_header,
1024 &ftrace_show_header_fops);
1026 trace_create_file("header_event", 0444, d_events,
1027 ring_buffer_print_entry_header,
1028 &ftrace_show_header_fops);
1030 for_each_event(call, __start_ftrace_events, __stop_ftrace_events) {
1031 /* The linker may leave blanks */
1034 list_add(&call->list, &ftrace_events);
1035 event_create_dir(call, d_events, &ftrace_event_id_fops,
1036 &ftrace_enable_fops, &ftrace_event_filter_fops,
1037 &ftrace_event_format_fops);
1040 ret = register_module_notifier(&trace_module_nb);
1042 pr_warning("Failed to register trace events module notifier\n");
1046 fs_initcall(event_trace_init);
1048 #ifdef CONFIG_FTRACE_STARTUP_TEST
1050 static DEFINE_SPINLOCK(test_spinlock);
1051 static DEFINE_SPINLOCK(test_spinlock_irq);
1052 static DEFINE_MUTEX(test_mutex);
1054 static __init void test_work(struct work_struct *dummy)
1056 spin_lock(&test_spinlock);
1057 spin_lock_irq(&test_spinlock_irq);
1059 spin_unlock_irq(&test_spinlock_irq);
1060 spin_unlock(&test_spinlock);
1062 mutex_lock(&test_mutex);
1064 mutex_unlock(&test_mutex);
1067 static __init int event_test_thread(void *unused)
1071 test_malloc = kmalloc(1234, GFP_KERNEL);
1073 pr_info("failed to kmalloc\n");
1075 schedule_on_each_cpu(test_work);
1079 set_current_state(TASK_INTERRUPTIBLE);
1080 while (!kthread_should_stop())
1087 * Do various things that may trigger events.
1089 static __init void event_test_stuff(void)
1091 struct task_struct *test_thread;
1093 test_thread = kthread_run(event_test_thread, NULL, "test-events");
1095 kthread_stop(test_thread);
1099 * For every trace event defined, we will test each trace point separately,
1100 * and then by groups, and finally all trace points.
1102 static __init void event_trace_self_tests(void)
1104 struct ftrace_event_call *call;
1105 struct event_subsystem *system;
1109 pr_info("Running tests on trace events:\n");
1111 list_for_each_entry(call, &ftrace_events, list) {
1113 /* Only test those that have a regfunc */
1117 pr_info("Testing event %s: ", call->name);
1120 * If an event is already enabled, someone is using
1121 * it and the self test should not be on.
1123 if (call->enabled) {
1124 pr_warning("Enabled event during self test!\n");
1140 /* Now test at the sub system level */
1142 pr_info("Running tests on trace event systems:\n");
1144 list_for_each_entry(system, &event_subsystems, list) {
1146 /* the ftrace system is special, skip it */
1147 if (strcmp(system->name, "ftrace") == 0)
1150 pr_info("Testing event system %s: ", system->name);
1152 /* ftrace_set_clr_event can modify the name passed in. */
1153 sysname = kstrdup(system->name, GFP_KERNEL);
1154 if (WARN_ON(!sysname)) {
1155 pr_warning("Can't allocate memory, giving up!\n");
1158 ret = ftrace_set_clr_event(sysname, 1);
1160 if (WARN_ON_ONCE(ret)) {
1161 pr_warning("error enabling system %s\n",
1168 sysname = kstrdup(system->name, GFP_KERNEL);
1169 if (WARN_ON(!sysname)) {
1170 pr_warning("Can't allocate memory, giving up!\n");
1173 ret = ftrace_set_clr_event(sysname, 0);
1176 if (WARN_ON_ONCE(ret))
1177 pr_warning("error disabling system %s\n",
1183 /* Test with all events enabled */
1185 pr_info("Running tests on all trace events:\n");
1186 pr_info("Testing all events: ");
1188 sysname = kmalloc(4, GFP_KERNEL);
1189 if (WARN_ON(!sysname)) {
1190 pr_warning("Can't allocate memory, giving up!\n");
1193 memcpy(sysname, "*:*", 4);
1194 ret = ftrace_set_clr_event(sysname, 1);
1195 if (WARN_ON_ONCE(ret)) {
1197 pr_warning("error enabling all events\n");
1204 memcpy(sysname, "*:*", 4);
1205 ret = ftrace_set_clr_event(sysname, 0);
1208 if (WARN_ON_ONCE(ret)) {
1209 pr_warning("error disabling all events\n");
1216 #ifdef CONFIG_FUNCTION_TRACER
1218 static DEFINE_PER_CPU(atomic_t, test_event_disable);
1221 function_test_events_call(unsigned long ip, unsigned long parent_ip)
1223 struct ring_buffer_event *event;
1224 struct ftrace_entry *entry;
1225 unsigned long flags;
1231 pc = preempt_count();
1232 resched = ftrace_preempt_disable();
1233 cpu = raw_smp_processor_id();
1234 disabled = atomic_inc_return(&per_cpu(test_event_disable, cpu));
1239 local_save_flags(flags);
1241 event = trace_current_buffer_lock_reserve(TRACE_FN, sizeof(*entry),
1245 entry = ring_buffer_event_data(event);
1247 entry->parent_ip = parent_ip;
1249 trace_nowake_buffer_unlock_commit(event, flags, pc);
1252 atomic_dec(&per_cpu(test_event_disable, cpu));
1253 ftrace_preempt_enable(resched);
1256 static struct ftrace_ops trace_ops __initdata =
1258 .func = function_test_events_call,
1261 static __init void event_trace_self_test_with_function(void)
1263 register_ftrace_function(&trace_ops);
1264 pr_info("Running tests again, along with the function tracer\n");
1265 event_trace_self_tests();
1266 unregister_ftrace_function(&trace_ops);
1269 static __init void event_trace_self_test_with_function(void)
1274 static __init int event_trace_self_tests_init(void)
1277 event_trace_self_tests();
1279 event_trace_self_test_with_function();
1284 late_initcall(event_trace_self_tests_init);