log.h

Go to the documentation of this file.

#ifndef JABBERWERX_UTIL_LOG_H
#define JABBERWERX_UTIL_LOG_H

#include <stdarg.h>
#include <stdio.h>
#include "../dom.h"
#include "mem.h"


#define JW_LOG_TRACE_FUNCTION_NO_ARGS \
        jw_log(JW_LOG_TRACE, "entering: %s", __func__)

#define JW_LOG_TRACE_FUNCTION(fmt, ...) \
        jw_log(JW_LOG_TRACE, "entering: %s; args=("fmt")", \
        __func__ , __VA_ARGS__)

#define JW_LOG_DOM_REF(level, dom, caption)\
    jw_log_dom((level), (dom), "%s(context: %p, ref: %p)", \
               (caption) ? (caption) : "",\
               (dom) ? (void *)jw_dom_get_context((dom)) : NULL, \
               (void *)(dom));


typedef enum
{
    JW_LOG_NONE = 0,
    JW_LOG_ERROR,
    JW_LOG_WARN,
    JW_LOG_INFO,
    JW_LOG_VERBOSE,
    JW_LOG_DEBUG,
    JW_LOG_TRACE,
    JW_LOG_MEMTRACE
} jw_loglevel;

typedef void (*jw_log_generator_fn)(
        const char **chunk, size_t *len, jw_data_free_func *free_fn, void *arg);


#ifdef __cplusplus
extern "C"
{
#endif

JABBERWERX_API const char *jw_log_level_name(jw_loglevel level);

typedef int (*jw_log_vararg_function)(
                FILE *stream, const char *format, va_list ap);

JABBERWERX_API void jw_log_set_function(jw_log_vararg_function fn);

JABBERWERX_API void jw_log_set_level(jw_loglevel level);

JABBERWERX_API jw_loglevel jw_log_get_level();

JABBERWERX_API void jw_log_set_ndc_enabled(bool enabled);

JABBERWERX_API int jw_log_push_ndc(const char *fmt, ...)
        __attribute__ ((__format__ (__printf__, 1, 2)));

JABBERWERX_API void jw_log_pop_ndc(int ndc_depth);

JABBERWERX_API void jw_log(jw_loglevel level, const char *fmt, ...)
        __attribute__ ((__format__ (__printf__, 2, 3)));

JABBERWERX_API void jw_log_err(jw_loglevel level, jw_err *err,
        const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));

JABBERWERX_API void jw_log_dom(jw_loglevel level, jw_dom_node *dom,
        const char *fmt, ...) __attribute__ ((__format__ (__printf__, 3, 4)));

JABBERWERX_API void jw_log_chunked(jw_loglevel level,
        jw_log_generator_fn generator_fn, void *arg,
        const char *fmt, ...) __attribute__ ((__format__ (__printf__, 4, 5)));

#ifdef __cplusplus
}
#endif

#endif  /* JABBERWERX_UTIL_LOG_H */