| 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
| 2 | #ifndef _LINUX_NET_DEBUG_H |
| 3 | #define _LINUX_NET_DEBUG_H |
| 4 | |
| 5 | #include <linux/bug.h> |
| 6 | #include <linux/kern_levels.h> |
| 7 | |
| 8 | struct net_device; |
| 9 | |
| 10 | __printf(3, 4) __cold |
| 11 | void netdev_printk(const char *level, const struct net_device *dev, |
| 12 | const char *format, ...); |
| 13 | __printf(2, 3) __cold |
| 14 | void netdev_emerg(const struct net_device *dev, const char *format, ...); |
| 15 | __printf(2, 3) __cold |
| 16 | void netdev_alert(const struct net_device *dev, const char *format, ...); |
| 17 | __printf(2, 3) __cold |
| 18 | void netdev_crit(const struct net_device *dev, const char *format, ...); |
| 19 | __printf(2, 3) __cold |
| 20 | void netdev_err(const struct net_device *dev, const char *format, ...); |
| 21 | __printf(2, 3) __cold |
| 22 | void netdev_warn(const struct net_device *dev, const char *format, ...); |
| 23 | __printf(2, 3) __cold |
| 24 | void netdev_notice(const struct net_device *dev, const char *format, ...); |
| 25 | __printf(2, 3) __cold |
| 26 | void netdev_info(const struct net_device *dev, const char *format, ...); |
| 27 | |
| 28 | #define netdev_level_once(level, dev, fmt, ...) \ |
| 29 | do { \ |
| 30 | static bool __section(".data..once") __print_once; \ |
| 31 | \ |
| 32 | if (!__print_once) { \ |
| 33 | __print_once = true; \ |
| 34 | netdev_printk(level, dev, fmt, ##__VA_ARGS__); \ |
| 35 | } \ |
| 36 | } while (0) |
| 37 | |
| 38 | #define netdev_emerg_once(dev, fmt, ...) \ |
| 39 | netdev_level_once(KERN_EMERG, dev, fmt, ##__VA_ARGS__) |
| 40 | #define netdev_alert_once(dev, fmt, ...) \ |
| 41 | netdev_level_once(KERN_ALERT, dev, fmt, ##__VA_ARGS__) |
| 42 | #define netdev_crit_once(dev, fmt, ...) \ |
| 43 | netdev_level_once(KERN_CRIT, dev, fmt, ##__VA_ARGS__) |
| 44 | #define netdev_err_once(dev, fmt, ...) \ |
| 45 | netdev_level_once(KERN_ERR, dev, fmt, ##__VA_ARGS__) |
| 46 | #define netdev_warn_once(dev, fmt, ...) \ |
| 47 | netdev_level_once(KERN_WARNING, dev, fmt, ##__VA_ARGS__) |
| 48 | #define netdev_notice_once(dev, fmt, ...) \ |
| 49 | netdev_level_once(KERN_NOTICE, dev, fmt, ##__VA_ARGS__) |
| 50 | #define netdev_info_once(dev, fmt, ...) \ |
| 51 | netdev_level_once(KERN_INFO, dev, fmt, ##__VA_ARGS__) |
| 52 | |
| 53 | #if defined(CONFIG_DYNAMIC_DEBUG) || \ |
| 54 | (defined(CONFIG_DYNAMIC_DEBUG_CORE) && defined(DYNAMIC_DEBUG_MODULE)) |
| 55 | #define netdev_dbg(__dev, format, args...) \ |
| 56 | do { \ |
| 57 | dynamic_netdev_dbg(__dev, format, ##args); \ |
| 58 | } while (0) |
| 59 | #elif defined(DEBUG) |
| 60 | #define netdev_dbg(__dev, format, args...) \ |
| 61 | netdev_printk(KERN_DEBUG, __dev, format, ##args) |
| 62 | #else |
| 63 | #define netdev_dbg(__dev, format, args...) \ |
| 64 | ({ \ |
| 65 | if (0) \ |
| 66 | netdev_printk(KERN_DEBUG, __dev, format, ##args); \ |
| 67 | }) |
| 68 | #endif |
| 69 | |
| 70 | #if defined(VERBOSE_DEBUG) |
| 71 | #define netdev_vdbg netdev_dbg |
| 72 | #else |
| 73 | |
| 74 | #define netdev_vdbg(dev, format, args...) \ |
| 75 | ({ \ |
| 76 | if (0) \ |
| 77 | netdev_printk(KERN_DEBUG, dev, format, ##args); \ |
| 78 | 0; \ |
| 79 | }) |
| 80 | #endif |
| 81 | |
| 82 | /* netif printk helpers, similar to netdev_printk */ |
| 83 | |
| 84 | #define netif_printk(priv, type, level, dev, fmt, args...) \ |
| 85 | do { \ |
| 86 | if (netif_msg_##type(priv)) \ |
| 87 | netdev_printk(level, (dev), fmt, ##args); \ |
| 88 | } while (0) |
| 89 | |
| 90 | #define netif_level(level, priv, type, dev, fmt, args...) \ |
| 91 | do { \ |
| 92 | if (netif_msg_##type(priv)) \ |
| 93 | netdev_##level(dev, fmt, ##args); \ |
| 94 | } while (0) |
| 95 | |
| 96 | #define netif_emerg(priv, type, dev, fmt, args...) \ |
| 97 | netif_level(emerg, priv, type, dev, fmt, ##args) |
| 98 | #define netif_alert(priv, type, dev, fmt, args...) \ |
| 99 | netif_level(alert, priv, type, dev, fmt, ##args) |
| 100 | #define netif_crit(priv, type, dev, fmt, args...) \ |
| 101 | netif_level(crit, priv, type, dev, fmt, ##args) |
| 102 | #define netif_err(priv, type, dev, fmt, args...) \ |
| 103 | netif_level(err, priv, type, dev, fmt, ##args) |
| 104 | #define netif_warn(priv, type, dev, fmt, args...) \ |
| 105 | netif_level(warn, priv, type, dev, fmt, ##args) |
| 106 | #define netif_notice(priv, type, dev, fmt, args...) \ |
| 107 | netif_level(notice, priv, type, dev, fmt, ##args) |
| 108 | #define netif_info(priv, type, dev, fmt, args...) \ |
| 109 | netif_level(info, priv, type, dev, fmt, ##args) |
| 110 | |
| 111 | #if defined(CONFIG_DYNAMIC_DEBUG) || \ |
| 112 | (defined(CONFIG_DYNAMIC_DEBUG_CORE) && defined(DYNAMIC_DEBUG_MODULE)) |
| 113 | #define netif_dbg(priv, type, netdev, format, args...) \ |
| 114 | do { \ |
| 115 | if (netif_msg_##type(priv)) \ |
| 116 | dynamic_netdev_dbg(netdev, format, ##args); \ |
| 117 | } while (0) |
| 118 | #elif defined(DEBUG) |
| 119 | #define netif_dbg(priv, type, dev, format, args...) \ |
| 120 | netif_printk(priv, type, KERN_DEBUG, dev, format, ##args) |
| 121 | #else |
| 122 | #define netif_dbg(priv, type, dev, format, args...) \ |
| 123 | ({ \ |
| 124 | if (0) \ |
| 125 | netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \ |
| 126 | 0; \ |
| 127 | }) |
| 128 | #endif |
| 129 | |
| 130 | /* if @cond then downgrade to debug, else print at @level */ |
| 131 | #define netif_cond_dbg(priv, type, netdev, cond, level, fmt, args...) \ |
| 132 | do { \ |
| 133 | if (cond) \ |
| 134 | netif_dbg(priv, type, netdev, fmt, ##args); \ |
| 135 | else \ |
| 136 | netif_ ## level(priv, type, netdev, fmt, ##args); \ |
| 137 | } while (0) |
| 138 | |
| 139 | #if defined(VERBOSE_DEBUG) |
| 140 | #define netif_vdbg netif_dbg |
| 141 | #else |
| 142 | #define netif_vdbg(priv, type, dev, format, args...) \ |
| 143 | ({ \ |
| 144 | if (0) \ |
| 145 | netif_printk(priv, type, KERN_DEBUG, dev, format, ##args); \ |
| 146 | 0; \ |
| 147 | }) |
| 148 | #endif |
| 149 | |
| 150 | |
| 151 | #if defined(CONFIG_DEBUG_NET) |
| 152 | #define DEBUG_NET_WARN_ON_ONCE(cond) ((void)WARN_ON_ONCE(cond)) |
| 153 | #define DEBUG_NET_WARN_ONCE(cond, format...) ((void)WARN_ONCE(cond, format)) |
| 154 | #else |
| 155 | #define DEBUG_NET_WARN_ON_ONCE(cond) BUILD_BUG_ON_INVALID(cond) |
| 156 | #define DEBUG_NET_WARN_ONCE(cond, format...) BUILD_BUG_ON_INVALID(cond) |
| 157 | #endif |
| 158 | |
| 159 | #endif /* _LINUX_NET_DEBUG_H */ |
| 160 | |