113 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2#ifndef _LINUX_MMIOTRACE_H3#define _LINUX_MMIOTRACE_H4 5#include <linux/types.h>6#include <linux/list.h>7 8struct kmmio_probe;9struct pt_regs;10 11typedef void (*kmmio_pre_handler_t)(struct kmmio_probe *,12 struct pt_regs *, unsigned long addr);13typedef void (*kmmio_post_handler_t)(struct kmmio_probe *,14 unsigned long condition, struct pt_regs *);15 16struct kmmio_probe {17 /* kmmio internal list: */18 struct list_head list;19 /* start location of the probe point: */20 unsigned long addr;21 /* length of the probe region: */22 unsigned long len;23 /* Called before addr is executed: */24 kmmio_pre_handler_t pre_handler;25 /* Called after addr is executed: */26 kmmio_post_handler_t post_handler;27 void *private;28};29 30extern unsigned int kmmio_count;31 32extern int register_kmmio_probe(struct kmmio_probe *p);33extern void unregister_kmmio_probe(struct kmmio_probe *p);34extern int kmmio_init(void);35extern void kmmio_cleanup(void);36 37#ifdef CONFIG_MMIOTRACE38/* kmmio is active by some kmmio_probes? */39static inline int is_kmmio_active(void)40{41 return kmmio_count;42}43 44/* Called from page fault handler. */45extern int kmmio_handler(struct pt_regs *regs, unsigned long addr);46 47/* Called from ioremap.c */48extern void mmiotrace_ioremap(resource_size_t offset, unsigned long size,49 void __iomem *addr);50extern void mmiotrace_iounmap(volatile void __iomem *addr);51 52/* For anyone to insert markers. Remember trailing newline. */53extern __printf(1, 2) int mmiotrace_printk(const char *fmt, ...);54#else /* !CONFIG_MMIOTRACE: */55static inline int is_kmmio_active(void)56{57 return 0;58}59 60static inline int kmmio_handler(struct pt_regs *regs, unsigned long addr)61{62 return 0;63}64 65static inline void mmiotrace_ioremap(resource_size_t offset,66 unsigned long size, void __iomem *addr)67{68}69 70static inline void mmiotrace_iounmap(volatile void __iomem *addr)71{72}73 74static inline __printf(1, 2) int mmiotrace_printk(const char *fmt, ...)75{76 return 0;77}78#endif /* CONFIG_MMIOTRACE */79 80enum mm_io_opcode {81 MMIO_READ = 0x1, /* struct mmiotrace_rw */82 MMIO_WRITE = 0x2, /* struct mmiotrace_rw */83 MMIO_PROBE = 0x3, /* struct mmiotrace_map */84 MMIO_UNPROBE = 0x4, /* struct mmiotrace_map */85 MMIO_UNKNOWN_OP = 0x5, /* struct mmiotrace_rw */86};87 88struct mmiotrace_rw {89 resource_size_t phys; /* PCI address of register */90 unsigned long value;91 unsigned long pc; /* optional program counter */92 int map_id;93 unsigned char opcode; /* one of MMIO_{READ,WRITE,UNKNOWN_OP} */94 unsigned char width; /* size of register access in bytes */95};96 97struct mmiotrace_map {98 resource_size_t phys; /* base address in PCI space */99 unsigned long virt; /* base virtual address */100 unsigned long len; /* mapping size */101 int map_id;102 unsigned char opcode; /* MMIO_PROBE or MMIO_UNPROBE */103};104 105/* in kernel/trace/trace_mmiotrace.c */106extern void enable_mmiotrace(void);107extern void disable_mmiotrace(void);108extern void mmio_trace_rw(struct mmiotrace_rw *rw);109extern void mmio_trace_mapping(struct mmiotrace_map *map);110extern __printf(1, 0) int mmio_trace_printk(const char *fmt, va_list args);111 112#endif /* _LINUX_MMIOTRACE_H */113