mmiotrace.h 3.0 KB

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