68 lines
1.7 KiB
C
68 lines
1.7 KiB
C
/* debug.h -- debug utilities
|
|
*
|
|
* Copyright (C) 2010,2011 Olaf Bergmann <bergmann@tzi.org>
|
|
*
|
|
* This file is part of the CoAP library libcoap. Please see
|
|
* README for terms of use.
|
|
*/
|
|
|
|
#ifndef _COAP_DEBUG_H_
|
|
#define _COAP_DEBUG_H_
|
|
|
|
#include "coap_config.h"
|
|
|
|
/** Pre-defined log levels akin to what is used in \b syslog. */
|
|
typedef enum { LOG_EMERG = 0, LOG_ALERT, LOG_CRIT, LOG_WARNING,
|
|
LOG_NOTICE, LOG_INFO, LOG_DEBUG
|
|
} coap_log_t;
|
|
|
|
/** Returns the current log level. */
|
|
coap_log_t coap_get_log_level();
|
|
|
|
/** Sets the log level to the specified value. */
|
|
void coap_set_log_level(coap_log_t level);
|
|
|
|
/** Returns a zero-terminated string with the name of this library. */
|
|
const char *coap_package_name();
|
|
|
|
/** Returns a zero-terminated string with the library version. */
|
|
const char *coap_package_version();
|
|
|
|
/**
|
|
* Writes the given text to @c COAP_ERR_FD (for @p level <= @c
|
|
* LOG_CRIT) or @c COAP_DEBUG_FD (for @p level >= @c LOG_WARNING). The
|
|
* text is output only when @p level is below or equal to the log
|
|
* level that set by coap_set_log_level().
|
|
*/
|
|
void coap_log_impl(coap_log_t level, const char *format, ...);
|
|
|
|
#ifndef coap_log
|
|
#define coap_log(...) coap_log_impl(__VA_ARGS__)
|
|
#endif
|
|
|
|
#ifndef NDEBUG
|
|
|
|
/* A set of convenience macros for common log levels. */
|
|
#define info(...) coap_log(LOG_INFO, __VA_ARGS__)
|
|
#define warn(...) coap_log(LOG_WARNING, __VA_ARGS__)
|
|
#define debug(...) coap_log(LOG_DEBUG, __VA_ARGS__)
|
|
|
|
#include "pdu.h"
|
|
void coap_show_pdu(const coap_pdu_t *);
|
|
|
|
struct coap_address_t;
|
|
size_t coap_print_addr(const struct coap_address_t *, unsigned char *, size_t);
|
|
|
|
#else
|
|
|
|
#define debug(...)
|
|
#define info(...)
|
|
#define warn(...)
|
|
|
|
#define coap_show_pdu(x)
|
|
#define coap_print_addr(...)
|
|
|
|
#endif
|
|
|
|
#endif /* _COAP_DEBUG_H_ */
|