#ifndef LIGHTNING_LIGHTNINGD_LOG_H #define LIGHTNING_LIGHTNINGD_LOG_H #include "config.h" #include #include #include #include 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 */