mirror of
https://github.com/eclipse/tinydtls.git
synced 2025-05-09 03:51:02 +08:00
014c0a4978
tinydtls uses some stack space for HMAC calculations etc. This may cause trouble on platforms where the stack is very small. For example, the platform mbxxx (using an STM32 CPU) has reserved 1280 bytes for this. During tests, I found that this is too limited for a complete handshake. check_stack() shows that around 2 KiB should work.
144 lines
4.4 KiB
C
144 lines
4.4 KiB
C
/* debug.h -- debug utilities
|
|
*
|
|
* Copyright (C) 2011--2012 Olaf Bergmann <bergmann@tzi.org>
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person
|
|
* obtaining a copy of this software and associated documentation
|
|
* files (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use, copy,
|
|
* modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
* of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*/
|
|
|
|
#ifndef _DTLS_DEBUG_H_
|
|
#define _DTLS_DEBUG_H_
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include "dtls_config.h"
|
|
#include "global.h"
|
|
#include "session.h"
|
|
|
|
#ifdef WITH_CONTIKI
|
|
# ifndef DEBUG
|
|
# define DEBUG DEBUG_PRINT
|
|
# endif /* DEBUG */
|
|
#include "net/ip/uip-debug.h"
|
|
|
|
#ifdef CONTIKI_TARGET_MBXXX
|
|
extern char __Stack_Init, _estack;
|
|
|
|
static inline void check_stack() {
|
|
const char *p = &__Stack_Init;
|
|
while (p < &_estack && *p == 0x38) {
|
|
p++;
|
|
}
|
|
|
|
PRINTF("Stack: %d bytes used (%d free)\n", &_estack - p, p - &__Stack_Init);
|
|
}
|
|
#else /* CONTIKI_TARGET_MBXXX */
|
|
static inline void check_stack() {
|
|
}
|
|
#endif /* CONTIKI_TARGET_MBXXX */
|
|
#else /* WITH_CONTKI */
|
|
#define PRINTF(...)
|
|
|
|
static inline void check_stack() {
|
|
}
|
|
#endif
|
|
|
|
struct __session_t;
|
|
|
|
/** Pre-defined log levels akin to what is used in \b syslog. */
|
|
typedef enum { DTLS_LOG_EMERG=0, DTLS_LOG_ALERT, DTLS_LOG_CRIT, DTLS_LOG_WARN,
|
|
DTLS_LOG_NOTICE, DTLS_LOG_INFO, DTLS_LOG_DEBUG
|
|
} log_t;
|
|
|
|
/** Returns a zero-terminated string with the name of this library. */
|
|
const char *dtls_package_name();
|
|
|
|
/** Returns a zero-terminated string with the library version. */
|
|
const char *dtls_package_version();
|
|
|
|
#ifndef NDEBUG
|
|
/** Returns the current log level. */
|
|
log_t dtls_get_log_level();
|
|
|
|
/** Sets the log level to the specified value. */
|
|
void dtls_set_log_level(log_t level);
|
|
|
|
/**
|
|
* Writes the given text to \c stdout. The text is output only when \p
|
|
* level is below or equal to the log level that set by
|
|
* set_log_level(). */
|
|
#ifdef HAVE_VPRINTF
|
|
void dsrv_log(log_t level, char *format, ...);
|
|
#else
|
|
#define dsrv_log(level, format, ...) PRINTF(format, ##__VA_ARGS__)
|
|
#endif
|
|
|
|
/** dumps packets in usual hexdump format */
|
|
void hexdump(const unsigned char *packet, int length);
|
|
|
|
/** dump as narrow string of hex digits */
|
|
void dump(unsigned char *buf, size_t len);
|
|
|
|
void dtls_dsrv_hexdump_log(log_t level, const char *name, const unsigned char *buf, size_t length, int extend);
|
|
|
|
void dtls_dsrv_log_addr(log_t level, const char *name, const session_t *addr);
|
|
|
|
#else /* NDEBUG */
|
|
|
|
static inline log_t dtls_get_log_level()
|
|
{
|
|
return DTLS_LOG_EMERG;
|
|
}
|
|
|
|
static inline void dtls_set_log_level(log_t level)
|
|
{}
|
|
|
|
static inline void dsrv_log(log_t level, char *format, ...)
|
|
{}
|
|
|
|
static inline void hexdump(const unsigned char *packet, int length)
|
|
{}
|
|
|
|
static inline void dump(unsigned char *buf, size_t len)
|
|
{}
|
|
|
|
static inline void
|
|
dtls_dsrv_hexdump_log(log_t level, const char *name, const unsigned char *buf, size_t length, int extend)
|
|
{}
|
|
|
|
static inline void
|
|
dtls_dsrv_log_addr(log_t level, const char *name, const struct __session_t *addr)
|
|
{}
|
|
|
|
#endif /* NDEBUG */
|
|
|
|
/* A set of convenience macros for common log levels. */
|
|
#define dtls_emerg(...) dsrv_log(DTLS_LOG_EMERG, __VA_ARGS__)
|
|
#define dtls_alert(...) dsrv_log(DTLS_LOG_ALERT, __VA_ARGS__)
|
|
#define dtls_crit(...) dsrv_log(DTLS_LOG_CRIT, __VA_ARGS__)
|
|
#define dtls_warn(...) dsrv_log(DTLS_LOG_WARN, __VA_ARGS__)
|
|
#define dtls_notice(...) dsrv_log(DTLS_LOG_NOTICE, __VA_ARGS__)
|
|
#define dtls_info(...) dsrv_log(DTLS_LOG_INFO, __VA_ARGS__)
|
|
#define dtls_debug(...) dsrv_log(DTLS_LOG_DEBUG, __VA_ARGS__)
|
|
#define dtls_debug_hexdump(name, buf, length) dtls_dsrv_hexdump_log(DTLS_LOG_DEBUG, name, buf, length, 1)
|
|
#define dtls_debug_dump(name, buf, length) dtls_dsrv_hexdump_log(DTLS_LOG_DEBUG, name, buf, length, 0)
|
|
|
|
#endif /* _DTLS_DEBUG_H_ */
|