You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
134 lines
4.7 KiB
134 lines
4.7 KiB
#ifndef LIGHTNING_LIGHTNINGD_LOG_H
|
|
#define LIGHTNING_LIGHTNINGD_LOG_H
|
|
#include "config.h"
|
|
#include <ccan/tal/tal.h>
|
|
#include <ccan/typesafe_cb/typesafe_cb.h>
|
|
#include <common/type_to_string.h>
|
|
#include <stdarg.h>
|
|
|
|
struct timerel;
|
|
|
|
enum log_level {
|
|
/* Logging all IO. */
|
|
LOG_IO,
|
|
/* Gory details which are mainly good for debugging. */
|
|
LOG_DBG,
|
|
/* Information about what's going in. */
|
|
LOG_INFORM,
|
|
/* That's strange... */
|
|
LOG_UNUSUAL,
|
|
/* That's really bad, we're broken. */
|
|
LOG_BROKEN
|
|
};
|
|
|
|
/* We can have a single log book, with multiple logs in it. */
|
|
struct log_book *new_log_book(const tal_t *ctx,
|
|
size_t max_mem,
|
|
enum log_level printlevel);
|
|
|
|
/* With different entry points */
|
|
struct log *PRINTF_FMT(3,4)
|
|
new_log(const tal_t *ctx, struct log_book *record, const char *fmt, ...);
|
|
|
|
#define log_debug(log, ...) log_((log), LOG_DBG, __VA_ARGS__)
|
|
#define log_info(log, ...) log_((log), LOG_INFORM, __VA_ARGS__)
|
|
#define log_unusual(log, ...) log_((log), LOG_UNUSUAL, __VA_ARGS__)
|
|
#define log_broken(log, ...) log_((log), LOG_BROKEN, __VA_ARGS__)
|
|
|
|
void log_io(struct log *log, bool in, const void *data, size_t len);
|
|
|
|
void log_(struct log *log, enum log_level level, const char *fmt, ...)
|
|
PRINTF_FMT(3,4);
|
|
void log_add(struct log *log, const char *fmt, ...) PRINTF_FMT(2,3);
|
|
void logv(struct log *log, enum log_level level, const char *fmt, va_list ap);
|
|
void logv_add(struct log *log, const char *fmt, va_list ap);
|
|
|
|
void log_blob_(struct log *log, int level, const char *fmt,
|
|
size_t len, ...)
|
|
PRINTF_FMT(3,5);
|
|
|
|
/* These must have %s where the blob is to go. */
|
|
#define log_add_blob(log, fmt, blob, len) \
|
|
log_blob_((log), -1, (fmt), (len), (char *)(blob))
|
|
|
|
#define log_debug_blob(log, fmt, blob, len) \
|
|
log_blob_((log), LOG_DBG, (fmt), (len), (char *)(blob))
|
|
#define log_info_blob(log, fmt, blob, len) \
|
|
log_blob_((log), LOG_INFORM, (fmt), (len), (char *)(blob))
|
|
#define log_unusual_blob(log, fmt, blob, len) \
|
|
log_blob_((log), LOG_UNUSUAL, (fmt), (len), (char *)(blob))
|
|
#define log_broken_blob(log, fmt, blob, len) \
|
|
log_blob_((log), LOG_BROKEN, (fmt), (len), (char *)(blob))
|
|
|
|
/* Makes sure ptr is a 'structtype', makes sure it's in printable_types. */
|
|
#define log_struct_check_(log, loglevel, fmt, structtype, ptr) \
|
|
log_struct_((log), (loglevel), stringify(structtype), (fmt), \
|
|
((void)sizeof((ptr) == (structtype *)NULL), \
|
|
((union printable_types)((const structtype *)ptr)).charp_))
|
|
|
|
/* These must have %s where the struct is to go. */
|
|
#define log_add_struct(log, fmt, structtype, ptr) \
|
|
log_struct_check_((log), -1, (fmt), structtype, (ptr))
|
|
|
|
#define log_debug_struct(log, fmt, structtype, ptr) \
|
|
log_struct_check_((log), LOG_DBG, (fmt), structtype, (ptr))
|
|
#define log_info_struct(log, fmt, structtype, ptr) \
|
|
log_struct_check_((log), LOG_INFORM, (fmt), structtype, (ptr))
|
|
#define log_unusual_struct(log, fmt, structtype, ptr) \
|
|
log_struct_check_((log), LOG_UNUSUAL, (fmt), structtype, (ptr))
|
|
#define log_broken_struct(log, fmt, structtype, ptr) \
|
|
log_struct_check_((log), LOG_BROKEN, (fmt), structtype, (ptr))
|
|
|
|
void PRINTF_FMT(4,5) log_struct_(struct log *log, int level,
|
|
const char *structname,
|
|
const char *fmt, ...);
|
|
|
|
enum log_level get_log_level(struct log_book *lr);
|
|
void set_log_level(struct log_book *lr, enum log_level level);
|
|
void set_log_prefix(struct log *log, const char *prefix);
|
|
const char *log_prefix(const struct log *log);
|
|
#define set_log_outfn(lr, print, arg) \
|
|
set_log_outfn_((lr), \
|
|
typesafe_cb_preargs(void, void *, (print), (arg),\
|
|
const char *, \
|
|
enum log_level, \
|
|
bool, \
|
|
const char *), (arg))
|
|
|
|
void set_log_outfn_(struct log_book *lr,
|
|
void (*print)(const char *prefix,
|
|
enum log_level level,
|
|
bool continued,
|
|
const char *str, void *arg),
|
|
void *arg);
|
|
|
|
size_t log_max_mem(const struct log_book *lr);
|
|
size_t log_used(const struct log_book *lr);
|
|
const struct timeabs *log_init_time(const struct log_book *lr);
|
|
|
|
#define log_each_line(lr, func, arg) \
|
|
log_each_line_((lr), \
|
|
typesafe_cb_preargs(void, void *, (func), (arg), \
|
|
unsigned int, \
|
|
struct timerel, \
|
|
enum log_level, \
|
|
const char *, \
|
|
const char *), (arg))
|
|
|
|
void log_each_line_(const struct log_book *lr,
|
|
void (*func)(unsigned int skipped,
|
|
struct timerel time,
|
|
enum log_level level,
|
|
const char *prefix,
|
|
const char *log,
|
|
void *arg),
|
|
void *arg);
|
|
|
|
|
|
void log_dump_to_file(int fd, const struct log_book *lr);
|
|
void opt_register_logging(struct log *log);
|
|
void crashlog_activate(struct log *log);
|
|
|
|
/* Before the crashlog is activated, just prints to stderr. */
|
|
void NORETURN PRINTF_FMT(1,2) fatal(const char *fmt, ...);
|
|
#endif /* LIGHTNING_LIGHTNINGD_LOG_H */
|
|
|