Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 1 | #ifndef _DYNAMIC_DEBUG_H |
| 2 | #define _DYNAMIC_DEBUG_H |
| 3 | |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 4 | /* |
| 5 | * An instance of this structure is created in a special |
| 6 | * ELF section at every dynamic debug callsite. At runtime, |
| 7 | * the special section is treated as an array of these. |
| 8 | */ |
| 9 | struct _ddebug { |
| 10 | /* |
| 11 | * These fields are used to drive the user interface |
| 12 | * for selecting and displaying debug callsites. |
| 13 | */ |
| 14 | const char *modname; |
| 15 | const char *function; |
| 16 | const char *filename; |
| 17 | const char *format; |
Jim Cromie | e703ddae | 2011-12-19 17:12:59 -0500 | [diff] [blame] | 18 | unsigned int lineno:18; |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 19 | /* |
Jim Cromie | 3faa286 | 2012-04-27 14:30:33 -0600 | [diff] [blame] | 20 | * The flags field controls the behaviour at the callsite. |
| 21 | * The bits here are changed dynamically when the user |
Florian Ragwitz | 2b2f68b | 2010-05-24 14:33:21 -0700 | [diff] [blame] | 22 | * writes commands to <debugfs>/dynamic_debug/control |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 23 | */ |
Jim Cromie | 5ca7d2a | 2011-12-19 17:12:44 -0500 | [diff] [blame] | 24 | #define _DPRINTK_FLAGS_NONE 0 |
| 25 | #define _DPRINTK_FLAGS_PRINT (1<<0) /* printk() a message using the format */ |
Bart Van Assche | 8ba6ebf | 2011-01-23 17:17:24 +0100 | [diff] [blame] | 26 | #define _DPRINTK_FLAGS_INCL_MODNAME (1<<1) |
| 27 | #define _DPRINTK_FLAGS_INCL_FUNCNAME (1<<2) |
| 28 | #define _DPRINTK_FLAGS_INCL_LINENO (1<<3) |
| 29 | #define _DPRINTK_FLAGS_INCL_TID (1<<4) |
Jim Cromie | b558c96 | 2011-12-19 17:11:18 -0500 | [diff] [blame] | 30 | #if defined DEBUG |
| 31 | #define _DPRINTK_FLAGS_DEFAULT _DPRINTK_FLAGS_PRINT |
| 32 | #else |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 33 | #define _DPRINTK_FLAGS_DEFAULT 0 |
Jim Cromie | b558c96 | 2011-12-19 17:11:18 -0500 | [diff] [blame] | 34 | #endif |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 35 | unsigned int flags:8; |
| 36 | } __attribute__((aligned(8))); |
| 37 | |
| 38 | |
| 39 | int ddebug_add_module(struct _ddebug *tab, unsigned int n, |
| 40 | const char *modname); |
| 41 | |
| 42 | #if defined(CONFIG_DYNAMIC_DEBUG) |
Yehuda Sadeh | ff49d74 | 2010-07-03 13:07:35 +1000 | [diff] [blame] | 43 | extern int ddebug_remove_module(const char *mod_name); |
Joe Perches | b9075fa | 2011-10-31 17:11:33 -0700 | [diff] [blame] | 44 | extern __printf(2, 3) |
| 45 | int __dynamic_pr_debug(struct _ddebug *descriptor, const char *fmt, ...); |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 46 | |
Jim Cromie | b48420c | 2012-04-27 14:30:35 -0600 | [diff] [blame] | 47 | extern int ddebug_dyndbg_module_param_cb(char *param, char *val, |
| 48 | const char *modname); |
| 49 | |
Joe Perches | cbc4663 | 2011-08-11 14:36:21 -0400 | [diff] [blame] | 50 | struct device; |
| 51 | |
Joe Perches | b9075fa | 2011-10-31 17:11:33 -0700 | [diff] [blame] | 52 | extern __printf(3, 4) |
| 53 | int __dynamic_dev_dbg(struct _ddebug *descriptor, const struct device *dev, |
| 54 | const char *fmt, ...); |
Joe Perches | cbc4663 | 2011-08-11 14:36:21 -0400 | [diff] [blame] | 55 | |
Jason Baron | ffa10cb | 2011-08-11 14:36:48 -0400 | [diff] [blame] | 56 | struct net_device; |
| 57 | |
Joe Perches | b9075fa | 2011-10-31 17:11:33 -0700 | [diff] [blame] | 58 | extern __printf(3, 4) |
| 59 | int __dynamic_netdev_dbg(struct _ddebug *descriptor, |
| 60 | const struct net_device *dev, |
| 61 | const char *fmt, ...); |
Jason Baron | ffa10cb | 2011-08-11 14:36:48 -0400 | [diff] [blame] | 62 | |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 63 | #define DEFINE_DYNAMIC_DEBUG_METADATA(name, fmt) \ |
Joe Perches | c0d2af6 | 2012-10-18 12:07:03 -0700 | [diff] [blame] | 64 | static struct _ddebug __aligned(8) \ |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 65 | __attribute__((section("__verbose"))) name = { \ |
| 66 | .modname = KBUILD_MODNAME, \ |
| 67 | .function = __func__, \ |
| 68 | .filename = __FILE__, \ |
| 69 | .format = (fmt), \ |
| 70 | .lineno = __LINE__, \ |
| 71 | .flags = _DPRINTK_FLAGS_DEFAULT, \ |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 72 | } |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 73 | |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 74 | #define dynamic_pr_debug(fmt, ...) \ |
| 75 | do { \ |
| 76 | DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, fmt); \ |
Jim Cromie | 87e6f96 | 2011-12-19 17:11:13 -0500 | [diff] [blame] | 77 | if (unlikely(descriptor.flags & _DPRINTK_FLAGS_PRINT)) \ |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 78 | __dynamic_pr_debug(&descriptor, pr_fmt(fmt), \ |
| 79 | ##__VA_ARGS__); \ |
| 80 | } while (0) |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 81 | |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 82 | #define dynamic_dev_dbg(dev, fmt, ...) \ |
| 83 | do { \ |
Jim Cromie | 87e6f96 | 2011-12-19 17:11:13 -0500 | [diff] [blame] | 84 | DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, fmt); \ |
| 85 | if (unlikely(descriptor.flags & _DPRINTK_FLAGS_PRINT)) \ |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 86 | __dynamic_dev_dbg(&descriptor, dev, fmt, \ |
| 87 | ##__VA_ARGS__); \ |
| 88 | } while (0) |
| 89 | |
| 90 | #define dynamic_netdev_dbg(dev, fmt, ...) \ |
| 91 | do { \ |
| 92 | DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, fmt); \ |
Jim Cromie | 87e6f96 | 2011-12-19 17:11:13 -0500 | [diff] [blame] | 93 | if (unlikely(descriptor.flags & _DPRINTK_FLAGS_PRINT)) \ |
Jason Baron | 07613b0 | 2011-10-04 14:13:15 -0700 | [diff] [blame] | 94 | __dynamic_netdev_dbg(&descriptor, dev, fmt, \ |
| 95 | ##__VA_ARGS__); \ |
| 96 | } while (0) |
Jason Baron | ffa10cb | 2011-08-11 14:36:48 -0400 | [diff] [blame] | 97 | |
Vladimir Kondratiev | 7a55561 | 2012-12-05 16:48:27 -0500 | [diff] [blame] | 98 | #define dynamic_hex_dump(prefix_str, prefix_type, rowsize, \ |
| 99 | groupsize, buf, len, ascii) \ |
| 100 | do { \ |
| 101 | DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, \ |
| 102 | __builtin_constant_p(prefix_str) ? prefix_str : "hexdump");\ |
| 103 | if (unlikely(descriptor.flags & _DPRINTK_FLAGS_PRINT)) \ |
| 104 | print_hex_dump(KERN_DEBUG, prefix_str, \ |
| 105 | prefix_type, rowsize, groupsize, \ |
| 106 | buf, len, ascii); \ |
| 107 | } while (0) |
| 108 | |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 109 | #else |
| 110 | |
Jim Cromie | b48420c | 2012-04-27 14:30:35 -0600 | [diff] [blame] | 111 | #include <linux/string.h> |
| 112 | #include <linux/errno.h> |
| 113 | |
Yehuda Sadeh | ff49d74 | 2010-07-03 13:07:35 +1000 | [diff] [blame] | 114 | static inline int ddebug_remove_module(const char *mod) |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 115 | { |
| 116 | return 0; |
| 117 | } |
| 118 | |
Jim Cromie | b48420c | 2012-04-27 14:30:35 -0600 | [diff] [blame] | 119 | static inline int ddebug_dyndbg_module_param_cb(char *param, char *val, |
| 120 | const char *modname) |
| 121 | { |
| 122 | if (strstr(param, "dyndbg")) { |
Jim Cromie | 516cf1b | 2012-05-01 05:23:12 -0600 | [diff] [blame] | 123 | /* avoid pr_warn(), which wants pr_fmt() fully defined */ |
| 124 | printk(KERN_WARNING "dyndbg param is supported only in " |
Jim Cromie | b48420c | 2012-04-27 14:30:35 -0600 | [diff] [blame] | 125 | "CONFIG_DYNAMIC_DEBUG builds\n"); |
| 126 | return 0; /* allow and ignore */ |
| 127 | } |
| 128 | return -EINVAL; |
| 129 | } |
| 130 | |
Joe Perches | 00b5586 | 2009-12-14 18:00:14 -0800 | [diff] [blame] | 131 | #define dynamic_pr_debug(fmt, ...) \ |
| 132 | do { if (0) printk(KERN_DEBUG pr_fmt(fmt), ##__VA_ARGS__); } while (0) |
Philipp Reisner | be70e26 | 2010-10-14 11:58:20 +0200 | [diff] [blame] | 133 | #define dynamic_dev_dbg(dev, fmt, ...) \ |
Joe Perches | 00b5586 | 2009-12-14 18:00:14 -0800 | [diff] [blame] | 134 | do { if (0) dev_printk(KERN_DEBUG, dev, fmt, ##__VA_ARGS__); } while (0) |
Jason Baron | e9d376f | 2009-02-05 11:51:38 -0500 | [diff] [blame] | 135 | #endif |
| 136 | |
| 137 | #endif |