2 * trace_ksym.c - Kernel Symbol Tracer
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18 * Copyright (C) IBM Corporation, 2009
21 #include <linux/kallsyms.h>
22 #include <linux/uaccess.h>
23 #include <linux/debugfs.h>
24 #include <linux/ftrace.h>
25 #include <linux/module.h>
28 #include "trace_output.h"
29 #include "trace_stat.h"
32 #include <linux/hw_breakpoint.h>
33 #include <asm/hw_breakpoint.h>
36 * For now, let us restrict the no. of symbols traced simultaneously to number
37 * of available hardware breakpoint registers.
39 #define KSYM_TRACER_MAX HBP_NUM
41 #define KSYM_TRACER_OP_LEN 3 /* rw- */
44 struct perf_event **ksym_hbp;
45 unsigned long ksym_addr;
48 #ifdef CONFIG_PROFILE_KSYM_TRACER
49 unsigned long counter;
51 struct hlist_node ksym_hlist;
54 static struct trace_array *ksym_trace_array;
56 static unsigned int ksym_filter_entry_count;
57 static unsigned int ksym_tracing_enabled;
59 static HLIST_HEAD(ksym_filter_head);
61 static DEFINE_MUTEX(ksym_tracer_mutex);
63 #ifdef CONFIG_PROFILE_KSYM_TRACER
65 #define MAX_UL_INT 0xffffffff
67 void ksym_collect_stats(unsigned long hbp_hit_addr)
69 struct hlist_node *node;
70 struct trace_ksym *entry;
73 hlist_for_each_entry_rcu(entry, node, &ksym_filter_head, ksym_hlist) {
74 if ((entry->ksym_addr == hbp_hit_addr) &&
75 (entry->counter <= MAX_UL_INT)) {
82 #endif /* CONFIG_PROFILE_KSYM_TRACER */
84 void ksym_hbp_handler(struct perf_event *hbp, void *data)
86 struct ring_buffer_event *event;
87 struct ksym_trace_entry *entry;
88 struct pt_regs *regs = data;
89 struct ring_buffer *buffer;
92 if (!ksym_tracing_enabled)
95 buffer = ksym_trace_array->buffer;
99 event = trace_buffer_lock_reserve(buffer, TRACE_KSYM,
100 sizeof(*entry), 0, pc);
104 entry = ring_buffer_event_data(event);
105 entry->ip = instruction_pointer(regs);
106 entry->type = hw_breakpoint_type(hbp);
107 entry->addr = hw_breakpoint_addr(hbp);
108 strlcpy(entry->cmd, current->comm, TASK_COMM_LEN);
110 #ifdef CONFIG_PROFILE_KSYM_TRACER
111 ksym_collect_stats(hw_breakpoint_addr(hbp));
112 #endif /* CONFIG_PROFILE_KSYM_TRACER */
114 trace_buffer_unlock_commit(buffer, event, 0, pc);
117 /* Valid access types are represented as
119 * rw- : Set Read/Write Access Breakpoint
120 * -w- : Set Write Access Breakpoint
121 * --- : Clear Breakpoints
122 * --x : Set Execution Break points (Not available yet)
125 static int ksym_trace_get_access_type(char *str)
130 access |= HW_BREAKPOINT_R;
133 access |= HW_BREAKPOINT_W;
136 access |= HW_BREAKPOINT_X;
139 case HW_BREAKPOINT_R:
140 case HW_BREAKPOINT_W:
141 case HW_BREAKPOINT_W | HW_BREAKPOINT_R:
149 * There can be several possible malformed requests and we attempt to capture
150 * all of them. We enumerate some of the rules
151 * 1. We will not allow kernel symbols with ':' since it is used as a delimiter.
152 * i.e. multiple ':' symbols disallowed. Possible uses are of the form
153 * <module>:<ksym_name>:<op>.
154 * 2. No delimiter symbol ':' in the input string
155 * 3. Spurious operator symbols or symbols not in their respective positions
156 * 4. <ksym_name>:--- i.e. clear breakpoint request when ksym_name not in file
157 * 5. Kernel symbol not a part of /proc/kallsyms
158 * 6. Duplicate requests
160 static int parse_ksym_trace_str(char *input_string, char **ksymname,
165 *ksymname = strsep(&input_string, ":");
166 *addr = kallsyms_lookup_name(*ksymname);
168 /* Check for malformed request: (2), (1) and (5) */
169 if ((!input_string) ||
170 (strlen(input_string) != KSYM_TRACER_OP_LEN) ||
174 ret = ksym_trace_get_access_type(input_string);
179 int process_new_ksym_entry(char *ksymname, int op, unsigned long addr)
181 struct trace_ksym *entry;
184 if (ksym_filter_entry_count >= KSYM_TRACER_MAX) {
185 printk(KERN_ERR "ksym_tracer: Maximum limit:(%d) reached. No"
186 " new requests for tracing can be accepted now.\n",
191 entry = kzalloc(sizeof(struct trace_ksym), GFP_KERNEL);
196 entry->ksym_addr = addr;
197 entry->len = HW_BREAKPOINT_LEN_4;
200 entry->ksym_hbp = register_wide_hw_breakpoint(entry->ksym_addr,
201 entry->len, entry->type,
202 ksym_hbp_handler, true);
203 if (IS_ERR(entry->ksym_hbp)) {
204 entry->ksym_hbp = NULL;
205 ret = PTR_ERR(entry->ksym_hbp);
208 if (!entry->ksym_hbp) {
209 printk(KERN_INFO "ksym_tracer request failed. Try again"
214 hlist_add_head_rcu(&(entry->ksym_hlist), &ksym_filter_head);
215 ksym_filter_entry_count++;
225 static ssize_t ksym_trace_filter_read(struct file *filp, char __user *ubuf,
226 size_t count, loff_t *ppos)
228 struct trace_ksym *entry;
229 struct hlist_node *node;
234 s = kmalloc(sizeof(*s), GFP_KERNEL);
239 mutex_lock(&ksym_tracer_mutex);
241 hlist_for_each_entry(entry, node, &ksym_filter_head, ksym_hlist) {
242 ret = trace_seq_printf(s, "%pS:", (void *)entry->ksym_addr);
243 if (entry->type == HW_BREAKPOINT_R)
244 ret = trace_seq_puts(s, "r--\n");
245 else if (entry->type == HW_BREAKPOINT_W)
246 ret = trace_seq_puts(s, "-w-\n");
247 else if (entry->type == (HW_BREAKPOINT_W | HW_BREAKPOINT_R))
248 ret = trace_seq_puts(s, "rw-\n");
252 cnt = simple_read_from_buffer(ubuf, count, ppos, s->buffer, s->len);
254 mutex_unlock(&ksym_tracer_mutex);
261 static void __ksym_trace_reset(void)
263 struct trace_ksym *entry;
264 struct hlist_node *node, *node1;
266 mutex_lock(&ksym_tracer_mutex);
267 hlist_for_each_entry_safe(entry, node, node1, &ksym_filter_head,
269 unregister_wide_hw_breakpoint(entry->ksym_hbp);
270 ksym_filter_entry_count--;
271 hlist_del_rcu(&(entry->ksym_hlist));
275 mutex_unlock(&ksym_tracer_mutex);
278 static ssize_t ksym_trace_filter_write(struct file *file,
279 const char __user *buffer,
280 size_t count, loff_t *ppos)
282 struct trace_ksym *entry;
283 struct hlist_node *node;
284 char *input_string, *ksymname = NULL;
285 unsigned long ksym_addr = 0;
286 int ret, op, changed = 0;
288 input_string = kzalloc(count + 1, GFP_KERNEL);
292 if (copy_from_user(input_string, buffer, count)) {
296 input_string[count] = '\0';
298 strstrip(input_string);
301 * Clear all breakpoints if:
302 * 1: echo > ksym_trace_filter
303 * 2: echo 0 > ksym_trace_filter
304 * 3: echo "*:---" > ksym_trace_filter
306 if (!input_string[0] || !strcmp(input_string, "0") ||
307 !strcmp(input_string, "*:---")) {
308 __ksym_trace_reset();
313 ret = op = parse_ksym_trace_str(input_string, &ksymname, &ksym_addr);
319 mutex_lock(&ksym_tracer_mutex);
322 hlist_for_each_entry(entry, node, &ksym_filter_head, ksym_hlist) {
323 if (entry->ksym_addr == ksym_addr) {
324 /* Check for malformed request: (6) */
325 if (entry->type != op)
333 unregister_wide_hw_breakpoint(entry->ksym_hbp);
337 register_wide_hw_breakpoint(entry->ksym_addr,
338 entry->len, entry->type,
339 ksym_hbp_handler, true);
340 if (IS_ERR(entry->ksym_hbp))
341 entry->ksym_hbp = NULL;
343 /* modified without problem */
344 if (entry->ksym_hbp) {
351 /* Error or "symbol:---" case: drop it */
352 ksym_filter_entry_count--;
353 hlist_del_rcu(&(entry->ksym_hlist));
358 /* Check for malformed request: (4) */
361 ret = process_new_ksym_entry(ksymname, op, ksym_addr);
364 mutex_unlock(&ksym_tracer_mutex);
373 static const struct file_operations ksym_tracing_fops = {
374 .open = tracing_open_generic,
375 .read = ksym_trace_filter_read,
376 .write = ksym_trace_filter_write,
379 static void ksym_trace_reset(struct trace_array *tr)
381 ksym_tracing_enabled = 0;
382 __ksym_trace_reset();
385 static int ksym_trace_init(struct trace_array *tr)
389 for_each_online_cpu(cpu)
390 tracing_reset(tr, cpu);
391 ksym_tracing_enabled = 1;
392 ksym_trace_array = tr;
397 static void ksym_trace_print_header(struct seq_file *m)
400 "# TASK-PID CPU# Symbol "
407 static enum print_line_t ksym_trace_output(struct trace_iterator *iter)
409 struct trace_entry *entry = iter->ent;
410 struct trace_seq *s = &iter->seq;
411 struct ksym_trace_entry *field;
412 char str[KSYM_SYMBOL_LEN];
415 if (entry->type != TRACE_KSYM)
416 return TRACE_TYPE_UNHANDLED;
418 trace_assign_type(field, entry);
420 ret = trace_seq_printf(s, "%11s-%-5d [%03d] %pS", field->cmd,
421 entry->pid, iter->cpu, (char *)field->addr);
423 return TRACE_TYPE_PARTIAL_LINE;
425 switch (field->type) {
426 case HW_BREAKPOINT_R:
427 ret = trace_seq_printf(s, " R ");
429 case HW_BREAKPOINT_W:
430 ret = trace_seq_printf(s, " W ");
432 case HW_BREAKPOINT_R | HW_BREAKPOINT_W:
433 ret = trace_seq_printf(s, " RW ");
436 return TRACE_TYPE_PARTIAL_LINE;
440 return TRACE_TYPE_PARTIAL_LINE;
442 sprint_symbol(str, field->ip);
443 ret = trace_seq_printf(s, "%s\n", str);
445 return TRACE_TYPE_PARTIAL_LINE;
447 return TRACE_TYPE_HANDLED;
450 struct tracer ksym_tracer __read_mostly =
452 .name = "ksym_tracer",
453 .init = ksym_trace_init,
454 .reset = ksym_trace_reset,
455 #ifdef CONFIG_FTRACE_SELFTEST
456 .selftest = trace_selftest_startup_ksym,
458 .print_header = ksym_trace_print_header,
459 .print_line = ksym_trace_output
462 __init static int init_ksym_trace(void)
464 struct dentry *d_tracer;
465 struct dentry *entry;
467 d_tracer = tracing_init_dentry();
468 ksym_filter_entry_count = 0;
470 entry = debugfs_create_file("ksym_trace_filter", 0644, d_tracer,
471 NULL, &ksym_tracing_fops);
473 pr_warning("Could not create debugfs "
474 "'ksym_trace_filter' file\n");
476 return register_tracer(&ksym_tracer);
478 device_initcall(init_ksym_trace);
481 #ifdef CONFIG_PROFILE_KSYM_TRACER
482 static int ksym_tracer_stat_headers(struct seq_file *m)
484 seq_puts(m, " Access Type ");
485 seq_puts(m, " Symbol Counter\n");
486 seq_puts(m, " ----------- ");
487 seq_puts(m, " ------ -------\n");
491 static int ksym_tracer_stat_show(struct seq_file *m, void *v)
493 struct hlist_node *stat = v;
494 struct trace_ksym *entry;
496 char fn_name[KSYM_NAME_LEN];
498 entry = hlist_entry(stat, struct trace_ksym, ksym_hlist);
500 access_type = entry->type;
502 switch (access_type) {
503 case HW_BREAKPOINT_R:
506 case HW_BREAKPOINT_W:
509 case HW_BREAKPOINT_R | HW_BREAKPOINT_W:
516 if (lookup_symbol_name(entry->ksym_addr, fn_name) >= 0)
517 seq_printf(m, " %-36s", fn_name);
519 seq_printf(m, " %-36s", "<NA>");
520 seq_printf(m, " %15lu\n", entry->counter);
525 static void *ksym_tracer_stat_start(struct tracer_stat *trace)
527 return ksym_filter_head.first;
531 ksym_tracer_stat_next(void *v, int idx)
533 struct hlist_node *stat = v;
538 static struct tracer_stat ksym_tracer_stats = {
539 .name = "ksym_tracer",
540 .stat_start = ksym_tracer_stat_start,
541 .stat_next = ksym_tracer_stat_next,
542 .stat_headers = ksym_tracer_stat_headers,
543 .stat_show = ksym_tracer_stat_show
546 __init static int ksym_tracer_stat_init(void)
550 ret = register_stat_tracer(&ksym_tracer_stats);
552 printk(KERN_WARNING "Warning: could not register "
553 "ksym tracer stats\n");
559 fs_initcall(ksym_tracer_stat_init);
560 #endif /* CONFIG_PROFILE_KSYM_TRACER */