/* Copyright (C) 2012 Serval Project Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #ifndef __SERVAL_DNA__LOG_H #define __SERVAL_DNA__LOG_H #include // for size_t #include // for NULL #include #include #include #include "whence.h" #ifndef __SERVAL_LOG_INLINE # if __GNUC__ && !__GNUC_STDC_INLINE__ # define __SERVAL_LOG_INLINE extern inline # else # define __SERVAL_LOG_INLINE inline # endif #endif // Logging levels. #define LOG_LEVEL_INVALID (-1) #define LOG_LEVEL_SILENT (0) #define LOG_LEVEL_DEBUG (1) #define LOG_LEVEL_INFO (2) #define LOG_LEVEL_HINT (3) #define LOG_LEVEL_WARN (4) #define LOG_LEVEL_ERROR (5) #define LOG_LEVEL_FATAL (6) #define LOG_LEVEL_NONE (127) const char *log_level_as_string(int level); int string_to_log_level(const char *text); // Log output control. extern int logLevel_NoLogFileConfigured; void close_log_file(); void disable_log_stderr(); void logFlush(); void logConfigChanged(); // Logging context string. struct strbuf; extern struct strbuf log_context; // Logging primitives. void vlogMessage(int level, struct __sourceloc whence, const char *fmt, va_list); int logBacktrace(int level, struct __sourceloc whence); __SERVAL_LOG_INLINE void logMessage(int level, struct __sourceloc whence, const char *fmt, ...) { va_list ap; va_start(ap, fmt); vlogMessage(level, whence, fmt, ap); va_end(ap); } // Useful logging primitive macros. #define LOGF(L,F,...) logMessage(L, __WHENCE__, F, ##__VA_ARGS__) #define LOGF_perror(L,F,...) logMessage_perror(L, __WHENCE__, F, ##__VA_ARGS__) #define LOG_perror(L,X) LOGF_perror(L, "%s", (X)) #define logMessage_perror(L,whence,F,...) (logMessage(L, whence, F ": %s [errno=%d]", ##__VA_ARGS__, strerror(errno), errno)) #define NOWHENCE(LOGSTMT) do { const struct __sourceloc __whence = __NOWHENCE__; LOGSTMT; } while (0) #define BACKTRACE logBacktrace(LOG_LEVEL_FATAL, __WHENCE__) #define FATALF(F,...) do { LOGF(LOG_LEVEL_FATAL, F, ##__VA_ARGS__); abort(); exit(-1); } while (1) #define FATAL(X) FATALF("%s", (X)) #define FATALF_perror(F,...) FATALF(F ": %s [errno=%d]", ##__VA_ARGS__, strerror(errno), errno) #define FATAL_perror(X) FATALF_perror("%s", (X)) #define WHYF(F,...) (LOGF(LOG_LEVEL_ERROR, F, ##__VA_ARGS__), -1) #define WHY(X) WHYF("%s", (X)) #define WHYFNULL(F,...) (LOGF(LOG_LEVEL_ERROR, F, ##__VA_ARGS__), NULL) #define WHYNULL(X) (WHYFNULL("%s", (X))) #define WHYF_perror(F,...) (LOGF_perror(LOG_LEVEL_ERROR, F, ##__VA_ARGS__), -1) #define WHY_perror(X) WHYF_perror("%s", (X)) #define WHY_argv(X,ARGC,ARGV) logArgv(LOG_LEVEL_ERROR, __WHENCE__, (X), (ARGC), (ARGV)) #define WARNF(F,...) LOGF(LOG_LEVEL_WARN, F, ##__VA_ARGS__) #define WARN(X) WARNF("%s", (X)) #define WARNF_perror(F,...) LOGF_perror(LOG_LEVEL_WARN, F, ##__VA_ARGS__) #define WARN_perror(X) WARNF_perror("%s", (X)) #define HINTF(F,...) LOGF(LOG_LEVEL_HINT, F, ##__VA_ARGS__) #define HINT(X) HINTF("%s", (X)) #define HINT_argv(X,ARGC,ARGV) logArgv(LOG_LEVEL_HINT, __WHENCE__, (X), (ARGC), (ARGV)) #define INFOF(F,...) LOGF(LOG_LEVEL_INFO, F, ##__VA_ARGS__) #define INFO(X) INFOF("%s", (X)) #define _DEBUGF(F,...) LOGF(LOG_LEVEL_DEBUG, F, ##__VA_ARGS__) #define _DEBUG(X) _DEBUGF("%s", (X)) #define _DEBUGF_perror(F,...) LOGF_perror(LOG_LEVEL_DEBUG, F, ##__VA_ARGS__) #define _DEBUG_perror(X) _DEBUGF_perror("%s", (X)) #define _DEBUG_argv(X,ARGC,ARGV) logArgv(LOG_LEVEL_DEBUG, __WHENCE__, (X), (ARGC), (ARGV)) #define _DEBUGF_TAG(TAG,F,...) _DEBUGF("{%s} " F, (TAG), ##__VA_ARGS__) #define _DEBUGF_TAG_perror(TAG,F,...) _DEBUGF_perror("{%s} " F, (TAG), ##__VA_ARGS__) #define _DEBUGF_TAG_argv(TAG,X,ARGC,ARGV) _DEBUGF_argv("{" TAG "} " X, (ARGC), (ARGV)) #define DEBUGF(FLAG,F,...) do { if (IF_DEBUG(FLAG)) _DEBUGF_TAG(#FLAG, F, ##__VA_ARGS__); } while (0) #define DEBUGF2(FLAG1,FLAG2,F,...) do { if (IF_DEBUG(FLAG1) || IF_DEBUG(FLAG2)) _DEBUGF_TAG((IF_DEBUG(FLAG1) ? #FLAG1 : #FLAG2), F, ##__VA_ARGS__); } while (0) #define DEBUG(FLAG,X) DEBUGF(FLAG, "%s", (X)) #define DEBUGF_perror(FLAG,F,...) do { if (IF_DEBUG(FLAG)) _DEBUGF_TAG_perror(#FLAG, F, ##__VA_ARGS__); } while (0) #define DEBUG_perror(FLAG,X) DEBUGF_perror(FLAG, "%s", (X)) #define DEBUG_argv(FLAG,X,ARGC,ARGV) do { if (IF_DEBUG(FLAG)) _DEBUG_TAG_argv(#FLAG, X, (ARGC), (ARGV)); } while (0) #define dump(X,A,N) logDump(LOG_LEVEL_DEBUG, __WHENCE__, (X), (const unsigned char *)(A), (size_t)(N)) #define D (DEBUG("D"), 1) #define T (IF_DEBUG(trace) ? (DEBUG("T"), 1) : 1) // Utility functions, defined in terms of above primitives. void logArgv(int level, struct __sourceloc whence, const char *label, int argc, const char *const *argv); int logDump(int level, struct __sourceloc whence, char *name, const unsigned char *addr, size_t len); void logString(int level, struct __sourceloc whence, const char *str); #endif // __SERVAL_DNA__LOG_H