2 * This program is free software; you can redistribute it and/or modify
3 * it under the terms of the GNU General Public License as published by
4 * the Free Software Foundation; either version 2 of the License, or
5 * (at your option) any later version.
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
12 * You should have received a copy of the GNU General Public License
13 * along with this program; if not, write to the Free Software
14 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
16 * Copyright (C) IBM Corporation, 2005
17 * Jeff Muizelaar, 2006, 2007
18 * Pekka Paalanen, 2008 <pq@iki.fi>
20 * Derived from the read-mod example from relay-examples by Tom Zanussi.
22 #include <linux/module.h>
23 #include <linux/relay.h>
24 #include <linux/debugfs.h>
25 #include <linux/proc_fs.h>
27 #include <linux/version.h>
28 #include <linux/kallsyms.h>
29 #include <asm/pgtable.h>
30 #include <linux/mmiotrace.h>
31 #include <asm/e820.h> /* for ISA_START_ADDRESS */
32 #include <asm/atomic.h>
33 #include <linux/percpu.h>
37 /* This app's relay channel files will appear in /debug/mmio-trace */
38 #define APP_DIR "mmio-trace"
39 /* the marker injection file in /proc */
40 #define MARKER_FILE "mmio-marker"
42 #define MODULE_NAME "mmiotrace"
47 enum reason_type type;
51 /* Accessed per-cpu. */
52 static DEFINE_PER_CPU(struct trap_reason, pf_reason);
53 static DEFINE_PER_CPU(struct mm_io_header_rw, cpu_trace);
55 /* Access to this is not per-cpu. */
56 static DEFINE_PER_CPU(atomic_t, dropped);
58 static struct file_operations mmio_fops = {
62 static const size_t subbuf_size = 256*1024;
63 static struct rchan *chan;
64 static struct dentry *dir;
65 static struct proc_dir_entry *proc_marker_file;
67 /* module parameters */
68 static unsigned int n_subbufs = 32*4;
69 static unsigned long filter_offset;
70 static int nommiotrace;
74 module_param(n_subbufs, uint, 0);
75 module_param(filter_offset, ulong, 0);
76 module_param(nommiotrace, bool, 0);
77 module_param(ISA_trace, bool, 0);
78 module_param(trace_pc, bool, 0);
80 MODULE_PARM_DESC(n_subbufs, "Number of 256kB buffers, default 128.");
81 MODULE_PARM_DESC(filter_offset, "Start address of traced mappings.");
82 MODULE_PARM_DESC(nommiotrace, "Disable actual MMIO tracing.");
83 MODULE_PARM_DESC(ISA_trace, "Do not exclude the low ISA range.");
84 MODULE_PARM_DESC(trace_pc, "Record address of faulting instructions.");
86 static void record_timestamp(struct mm_io_header *header)
91 header->sec = now.tv_sec;
92 header->nsec = now.tv_nsec;
96 * Write callback for the /proc entry:
97 * Read a marker and write it to the mmio trace log
99 static int write_marker(struct file *file, const char __user *buffer,
100 unsigned long count, void *data)
103 struct mm_io_header *headp;
104 int len = (count > 65535) ? 65535 : count;
106 event = kzalloc(sizeof(*headp) + len, GFP_KERNEL);
110 headp = (struct mm_io_header *)event;
111 headp->type = MMIO_MAGIC | (MMIO_MARKER << MMIO_OPCODE_SHIFT);
112 headp->data_len = len;
113 record_timestamp(headp);
115 if (copy_from_user(event + sizeof(*headp), buffer, len)) {
120 relay_write(chan, event, sizeof(*headp) + len);
125 static void print_pte(unsigned long address)
128 pte_t *pte = lookup_address(address, &level);
131 pr_err(MODULE_NAME ": Error in %s: no pte for page 0x%08lx\n",
136 if (level == PG_LEVEL_2M) {
137 pr_emerg(MODULE_NAME ": 4MB pages are not currently "
138 "supported: %lx\n", address);
141 pr_info(MODULE_NAME ": pte for 0x%lx: 0x%lx 0x%lx\n",
142 address, pte_val(*pte),
143 pte_val(*pte) & _PAGE_PRESENT);
147 * For some reason the pre/post pairs have been called in an
148 * unmatched order. Report and die.
150 static void die_kmmio_nesting_error(struct pt_regs *regs, unsigned long addr)
152 const struct trap_reason *my_reason = &get_cpu_var(pf_reason);
153 pr_emerg(MODULE_NAME ": unexpected fault for address: %lx, "
154 "last fault for address: %lx\n",
155 addr, my_reason->addr);
158 print_symbol(KERN_EMERG "faulting EIP is at %s\n", regs->ip);
159 print_symbol(KERN_EMERG "last faulting EIP was at %s\n",
161 pr_emerg("eax: %08lx ebx: %08lx ecx: %08lx edx: %08lx\n",
162 regs->ax, regs->bx, regs->cx, regs->dx);
163 pr_emerg("esi: %08lx edi: %08lx ebp: %08lx esp: %08lx\n",
164 regs->si, regs->di, regs->bp, regs->sp);
166 print_symbol(KERN_EMERG "faulting RIP is at %s\n", regs->ip);
167 print_symbol(KERN_EMERG "last faulting RIP was at %s\n",
169 pr_emerg("rax: %016lx rcx: %016lx rdx: %016lx\n",
170 regs->ax, regs->cx, regs->dx);
171 pr_emerg("rsi: %016lx rdi: %016lx rbp: %016lx rsp: %016lx\n",
172 regs->si, regs->di, regs->bp, regs->sp);
174 put_cpu_var(pf_reason);
178 static void pre(struct kmmio_probe *p, struct pt_regs *regs,
181 struct trap_reason *my_reason = &get_cpu_var(pf_reason);
182 struct mm_io_header_rw *my_trace = &get_cpu_var(cpu_trace);
183 const unsigned long instptr = instruction_pointer(regs);
184 const enum reason_type type = get_ins_type(instptr);
186 /* it doesn't make sense to have more than one active trace per cpu */
187 if (my_reason->active_traces)
188 die_kmmio_nesting_error(regs, addr);
190 my_reason->active_traces++;
192 my_reason->type = type;
193 my_reason->addr = addr;
194 my_reason->ip = instptr;
196 my_trace->header.type = MMIO_MAGIC;
197 my_trace->header.pid = 0;
198 my_trace->header.data_len = sizeof(struct mm_io_rw);
199 my_trace->rw.address = addr;
202 * Only record the program counter when requested.
203 * It may taint clean-room reverse engineering.
206 my_trace->rw.pc = instptr;
210 record_timestamp(&my_trace->header);
214 my_trace->header.type |=
215 (MMIO_READ << MMIO_OPCODE_SHIFT) |
216 (get_ins_mem_width(instptr) << MMIO_WIDTH_SHIFT);
219 my_trace->header.type |=
220 (MMIO_WRITE << MMIO_OPCODE_SHIFT) |
221 (get_ins_mem_width(instptr) << MMIO_WIDTH_SHIFT);
222 my_trace->rw.value = get_ins_reg_val(instptr, regs);
225 my_trace->header.type |=
226 (MMIO_WRITE << MMIO_OPCODE_SHIFT) |
227 (get_ins_mem_width(instptr) << MMIO_WIDTH_SHIFT);
228 my_trace->rw.value = get_ins_imm_val(instptr);
232 unsigned char *ip = (unsigned char *)instptr;
233 my_trace->header.type |=
234 (MMIO_UNKNOWN_OP << MMIO_OPCODE_SHIFT);
235 my_trace->rw.value = (*ip) << 16 | *(ip + 1) << 8 |
239 put_cpu_var(cpu_trace);
240 put_cpu_var(pf_reason);
243 static void post(struct kmmio_probe *p, unsigned long condition,
244 struct pt_regs *regs)
246 struct trap_reason *my_reason = &get_cpu_var(pf_reason);
247 struct mm_io_header_rw *my_trace = &get_cpu_var(cpu_trace);
250 * XXX: This might not get called, if the probe is removed while
251 * trace hit is on flight.
254 /* this should always return the active_trace count to 0 */
255 my_reason->active_traces--;
256 if (my_reason->active_traces) {
257 pr_emerg(MODULE_NAME ": unexpected post handler");
261 switch (my_reason->type) {
263 my_trace->rw.value = get_ins_reg_val(my_reason->ip, regs);
268 relay_write(chan, my_trace, sizeof(*my_trace));
269 put_cpu_var(cpu_trace);
270 put_cpu_var(pf_reason);
274 * subbuf_start() relay callback.
276 * Defined so that we know when events are dropped due to the buffer-full
279 static int subbuf_start_handler(struct rchan_buf *buf, void *subbuf,
280 void *prev_subbuf, size_t prev_padding)
282 unsigned int cpu = buf->cpu;
283 atomic_t *drop = &per_cpu(dropped, cpu);
285 if (relay_buf_full(buf)) {
286 if (atomic_inc_return(drop) == 1)
287 pr_err(MODULE_NAME ": cpu %d buffer full!\n", cpu);
290 count = atomic_read(drop);
292 pr_err(MODULE_NAME ": cpu %d buffer no longer full, "
293 "missed %d events.\n",
295 atomic_sub(count, drop);
301 /* file_create() callback. Creates relay file in debugfs. */
302 static struct dentry *create_buf_file_handler(const char *filename,
303 struct dentry *parent,
305 struct rchan_buf *buf,
308 struct dentry *buf_file;
310 mmio_fops.read = relay_file_operations.read;
311 mmio_fops.open = relay_file_operations.open;
312 mmio_fops.poll = relay_file_operations.poll;
313 mmio_fops.mmap = relay_file_operations.mmap;
314 mmio_fops.release = relay_file_operations.release;
315 mmio_fops.splice_read = relay_file_operations.splice_read;
317 buf_file = debugfs_create_file(filename, mode, parent, buf,
323 /* file_remove() default callback. Removes relay file in debugfs. */
324 static int remove_buf_file_handler(struct dentry *dentry)
326 debugfs_remove(dentry);
330 static struct rchan_callbacks relay_callbacks = {
331 .subbuf_start = subbuf_start_handler,
332 .create_buf_file = create_buf_file_handler,
333 .remove_buf_file = remove_buf_file_handler,
337 * create_channel - creates channel /debug/APP_DIR/cpuXXX
338 * Returns channel on success, NULL otherwise
340 static struct rchan *create_channel(unsigned size, unsigned n)
342 return relay_open("cpu", dir, size, n, &relay_callbacks, NULL);
345 /* destroy_channel - destroys channel /debug/APP_DIR/cpuXXX */
346 static void destroy_channel(void)
355 struct list_head list;
356 struct kmmio_probe probe;
358 static LIST_HEAD(trace_list);
359 static DEFINE_SPINLOCK(trace_list_lock);
361 static void do_ioremap_trace_core(unsigned long offset, unsigned long size,
364 struct remap_trace *trace = kmalloc(sizeof(*trace), GFP_KERNEL);
365 struct mm_io_header_map event = {
368 (MMIO_PROBE << MMIO_OPCODE_SHIFT),
372 .data_len = sizeof(struct mm_io_map)
376 .addr = (unsigned long)addr,
381 record_timestamp(&event.header);
383 *trace = (struct remap_trace) {
385 .addr = (unsigned long)addr,
388 .post_handler = post,
392 relay_write(chan, &event, sizeof(event));
393 spin_lock(&trace_list_lock);
394 list_add_tail(&trace->list, &trace_list);
395 spin_unlock(&trace_list_lock);
397 register_kmmio_probe(&trace->probe);
400 static void ioremap_trace_core(unsigned long offset, unsigned long size,
403 if ((filter_offset) && (offset != filter_offset))
406 /* Don't trace the low PCI/ISA area, it's always mapped.. */
407 if (!ISA_trace && (offset < ISA_END_ADDRESS) &&
408 (offset + size > ISA_START_ADDRESS)) {
409 pr_notice(MODULE_NAME ": Ignoring map of low PCI/ISA area "
411 offset, offset + size);
414 do_ioremap_trace_core(offset, size, addr);
417 void __iomem *ioremap_cache_trace(unsigned long offset, unsigned long size)
419 void __iomem *p = ioremap_cache(offset, size);
420 pr_debug(MODULE_NAME ": ioremap_cache(0x%lx, 0x%lx) = %p\n",
422 ioremap_trace_core(offset, size, p);
425 EXPORT_SYMBOL(ioremap_cache_trace);
427 void __iomem *ioremap_nocache_trace(unsigned long offset, unsigned long size)
429 void __iomem *p = ioremap_nocache(offset, size);
430 pr_debug(MODULE_NAME ": ioremap_nocache(0x%lx, 0x%lx) = %p\n",
432 ioremap_trace_core(offset, size, p);
435 EXPORT_SYMBOL(ioremap_nocache_trace);
437 void iounmap_trace(volatile void __iomem *addr)
439 struct mm_io_header_map event = {
442 (MMIO_UNPROBE << MMIO_OPCODE_SHIFT),
446 .data_len = sizeof(struct mm_io_map)
450 .addr = (unsigned long)addr,
455 struct remap_trace *trace;
456 struct remap_trace *tmp;
457 pr_debug(MODULE_NAME ": Unmapping %p.\n", addr);
458 record_timestamp(&event.header);
460 spin_lock(&trace_list_lock);
461 list_for_each_entry_safe(trace, tmp, &trace_list, list) {
462 if ((unsigned long)addr == trace->probe.addr) {
464 unregister_kmmio_probe(&trace->probe);
465 list_del(&trace->list);
470 spin_unlock(&trace_list_lock);
471 relay_write(chan, &event, sizeof(event));
474 EXPORT_SYMBOL(iounmap_trace);
476 static void clear_trace_list(void)
478 struct remap_trace *trace;
479 struct remap_trace *tmp;
481 spin_lock(&trace_list_lock);
482 list_for_each_entry_safe(trace, tmp, &trace_list, list) {
483 pr_warning(MODULE_NAME ": purging non-iounmapped "
484 "trace @0x%08lx, size 0x%lx.\n",
485 trace->probe.addr, trace->probe.len);
487 unregister_kmmio_probe(&trace->probe);
488 list_del(&trace->list);
492 spin_unlock(&trace_list_lock);
495 static int __init init(void)
500 dir = debugfs_create_dir(APP_DIR, NULL);
502 pr_err(MODULE_NAME ": Couldn't create relay app directory.\n");
506 chan = create_channel(subbuf_size, n_subbufs);
509 pr_err(MODULE_NAME ": relay app channel creation failed\n");
515 proc_marker_file = create_proc_entry(MARKER_FILE, 0, NULL);
516 if (proc_marker_file)
517 proc_marker_file->write_proc = write_marker;
519 pr_debug(MODULE_NAME ": loaded.\n");
521 pr_info(MODULE_NAME ": MMIO tracing disabled.\n");
523 pr_warning(MODULE_NAME ": Warning! low ISA range will be "
528 static void __exit cleanup(void)
530 pr_debug(MODULE_NAME ": unload...\n");
533 remove_proc_entry(MARKER_FILE, NULL);
540 module_exit(cleanup);
541 MODULE_LICENSE("GPL");