contrib/wpa/src/utils/wpa_debug.h

   1 /*
   2  * wpa_supplicant/hostapd / Debug prints
   3  * Copyright (c) 2002-2007, Jouni Malinen <j@w1.fi>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License version 2 as
   7  * published by the Free Software Foundation.
   8  *
   9  * Alternatively, this software may be distributed under the terms of BSD
  10  * license.
  11  *
  12  * See README and COPYING for more details.
  13  */
  14
  15 #ifndef WPA_DEBUG_H
  16 #define WPA_DEBUG_H
  17
  18 #include "wpabuf.h"
  19
  20 /* Debugging function - conditional printf and hex dump. Driver wrappers can
  21  * use these for debugging purposes. */
  22
  23 enum { MSG_MSGDUMP, MSG_DEBUG, MSG_INFO, MSG_WARNING, MSG_ERROR };
  24
  25 #ifdef CONFIG_NO_STDOUT_DEBUG
  26
  27 #define wpa_debug_print_timestamp() do { } while (0)
  28 #define wpa_printf(args...) do { } while (0)
  29 #define wpa_hexdump(l,t,b,le) do { } while (0)
  30 #define wpa_hexdump_buf(l,t,b) do { } while (0)
  31 #define wpa_hexdump_key(l,t,b,le) do { } while (0)
  32 #define wpa_hexdump_buf_key(l,t,b) do { } while (0)
  33 #define wpa_hexdump_ascii(l,t,b,le) do { } while (0)
  34 #define wpa_hexdump_ascii_key(l,t,b,le) do { } while (0)
  35 #define wpa_debug_open_file(p) do { } while (0)
  36 #define wpa_debug_close_file() do { } while (0)
  37
  38 #else /* CONFIG_NO_STDOUT_DEBUG */
  39
  40 int wpa_debug_open_file(const char *path);
  41 void wpa_debug_close_file(void);
  42
  43 /**
  44  * wpa_debug_printf_timestamp - Print timestamp for debug output
  45  *
  46  * This function prints a timestamp in seconds_from_1970.microsoconds
  47  * format if debug output has been configured to include timestamps in debug
  48  * messages.
  49  */
  50 void wpa_debug_print_timestamp(void);
  51
  52 /**
  53  * wpa_printf - conditional printf
  54  * @level: priority level (MSG_*) of the message
  55  * @fmt: printf format string, followed by optional arguments
  56  *
  57  * This function is used to print conditional debugging and error messages. The
  58  * output may be directed to stdout, stderr, and/or syslog based on
  59  * configuration.
  60  *
  61  * Note: New line '\n' is added to the end of the text when printing to stdout.
  62  */
  63 void wpa_printf(int level, char *fmt, ...)
  64 PRINTF_FORMAT(2, 3);
  65
  66 /**
  67  * wpa_hexdump - conditional hex dump
  68  * @level: priority level (MSG_*) of the message
  69  * @title: title of for the message
  70  * @buf: data buffer to be dumped
  71  * @len: length of the buf
  72  *
  73  * This function is used to print conditional debugging and error messages. The
  74  * output may be directed to stdout, stderr, and/or syslog based on
  75  * configuration. The contents of buf is printed out has hex dump.
  76  */
  77 void wpa_hexdump(int level, const char *title, const u8 *buf, size_t len);
  78
  79 static inline void wpa_hexdump_buf(int level, const char *title,
  80                                    const struct wpabuf *buf)
  81 {
  82         wpa_hexdump(level, title, wpabuf_head(buf), wpabuf_len(buf));
  83 }
  84
  85 /**
  86  * wpa_hexdump_key - conditional hex dump, hide keys
  87  * @level: priority level (MSG_*) of the message
  88  * @title: title of for the message
  89  * @buf: data buffer to be dumped
  90  * @len: length of the buf
  91  *
  92  * This function is used to print conditional debugging and error messages. The
  93  * output may be directed to stdout, stderr, and/or syslog based on
  94  * configuration. The contents of buf is printed out has hex dump. This works
  95  * like wpa_hexdump(), but by default, does not include secret keys (passwords,
  96  * etc.) in debug output.
  97  */
  98 void wpa_hexdump_key(int level, const char *title, const u8 *buf, size_t len);
  99
 100 static inline void wpa_hexdump_buf_key(int level, const char *title,
 101                                        const struct wpabuf *buf)
 102 {
 103         wpa_hexdump_key(level, title, wpabuf_head(buf), wpabuf_len(buf));
 104 }
 105
 106 /**
 107  * wpa_hexdump_ascii - conditional hex dump
 108  * @level: priority level (MSG_*) of the message
 109  * @title: title of for the message
 110  * @buf: data buffer to be dumped
 111  * @len: length of the buf
 112  *
 113  * This function is used to print conditional debugging and error messages. The
 114  * output may be directed to stdout, stderr, and/or syslog based on
 115  * configuration. The contents of buf is printed out has hex dump with both
 116  * the hex numbers and ASCII characters (for printable range) are shown. 16
 117  * bytes per line will be shown.
 118  */
 119 void wpa_hexdump_ascii(int level, const char *title, const u8 *buf,
 120                        size_t len);
 121
 122 /**
 123  * wpa_hexdump_ascii_key - conditional hex dump, hide keys
 124  * @level: priority level (MSG_*) of the message
 125  * @title: title of for the message
 126  * @buf: data buffer to be dumped
 127  * @len: length of the buf
 128  *
 129  * This function is used to print conditional debugging and error messages. The
 130  * output may be directed to stdout, stderr, and/or syslog based on
 131  * configuration. The contents of buf is printed out has hex dump with both
 132  * the hex numbers and ASCII characters (for printable range) are shown. 16
 133  * bytes per line will be shown. This works like wpa_hexdump_ascii(), but by
 134  * default, does not include secret keys (passwords, etc.) in debug output.
 135  */
 136 void wpa_hexdump_ascii_key(int level, const char *title, const u8 *buf,
 137                            size_t len);
 138
 139 #endif /* CONFIG_NO_STDOUT_DEBUG */
 140
 141
 142 #ifdef CONFIG_NO_WPA_MSG
 143 #define wpa_msg(args...) do { } while (0)
 144 #define wpa_msg_register_cb(f) do { } while (0)
 145 #else /* CONFIG_NO_WPA_MSG */
 146 /**
 147  * wpa_msg - Conditional printf for default target and ctrl_iface monitors
 148  * @ctx: Pointer to context data; this is the ctx variable registered
 149  *      with struct wpa_driver_ops::init()
 150  * @level: priority level (MSG_*) of the message
 151  * @fmt: printf format string, followed by optional arguments
 152  *
 153  * This function is used to print conditional debugging and error messages. The
 154  * output may be directed to stdout, stderr, and/or syslog based on
 155  * configuration. This function is like wpa_printf(), but it also sends the
 156  * same message to all attached ctrl_iface monitors.
 157  *
 158  * Note: New line '\n' is added to the end of the text when printing to stdout.
 159  */
 160 void wpa_msg(void *ctx, int level, char *fmt, ...) PRINTF_FORMAT(3, 4);
 161
 162 typedef void (*wpa_msg_cb_func)(void *ctx, int level, const char *txt,
 163                                 size_t len);
 164
 165 /**
 166  * wpa_msg_register_cb - Register callback function for wpa_msg() messages
 167  * @func: Callback function (%NULL to unregister)
 168  */
 169 void wpa_msg_register_cb(wpa_msg_cb_func func);
 170 #endif /* CONFIG_NO_WPA_MSG */
 171
 172
 173 #ifdef CONFIG_NO_HOSTAPD_LOGGER
 174 #define hostapd_logger(args...) do { } while (0)
 175 #define hostapd_logger_register_cb(f) do { } while (0)
 176 #else /* CONFIG_NO_HOSTAPD_LOGGER */
 177 void hostapd_logger(void *ctx, const u8 *addr, unsigned int module, int level,
 178                     const char *fmt, ...) PRINTF_FORMAT(5, 6);
 179
 180 typedef void (*hostapd_logger_cb_func)(void *ctx, const u8 *addr,
 181                                        unsigned int module, int level,
 182                                        const char *txt, size_t len);
 183
 184 /**
 185  * hostapd_logger_register_cb - Register callback function for hostapd_logger()
 186  * @func: Callback function (%NULL to unregister)
 187  */
 188 void hostapd_logger_register_cb(hostapd_logger_cb_func func);
 189 #endif /* CONFIG_NO_HOSTAPD_LOGGER */
 190
 191 #define HOSTAPD_MODULE_IEEE80211        0x00000001
 192 #define HOSTAPD_MODULE_IEEE8021X        0x00000002
 193 #define HOSTAPD_MODULE_RADIUS           0x00000004
 194 #define HOSTAPD_MODULE_WPA              0x00000008
 195 #define HOSTAPD_MODULE_DRIVER           0x00000010
 196 #define HOSTAPD_MODULE_IAPP             0x00000020
 197 #define HOSTAPD_MODULE_MLME             0x00000040
 198
 199 enum hostapd_logger_level {
 200         HOSTAPD_LEVEL_DEBUG_VERBOSE = 0,
 201         HOSTAPD_LEVEL_DEBUG = 1,
 202         HOSTAPD_LEVEL_INFO = 2,
 203         HOSTAPD_LEVEL_NOTICE = 3,
 204         HOSTAPD_LEVEL_WARNING = 4
 205 };
 206
 207
 208
 209 #ifdef EAPOL_TEST
 210 #define WPA_ASSERT(a)                                                  \
 211         do {                                                           \
 212                 if (!(a)) {                                            \
 213                         printf("WPA_ASSERT FAILED '" #a "' "           \
 214                                "%s %s:%d\n",                           \
 215                                __FUNCTION__, __FILE__, __LINE__);      \
 216                         exit(1);                                       \
 217                 }                                                      \
 218         } while (0)
 219 #else
 220 #define WPA_ASSERT(a) do { } while (0)
 221 #endif
 222
 223 #endif /* WPA_DEBUG_H */