terom@0: #ifndef SHARED_LOG_H
terom@0: #define SHARED_LOG_H
terom@0: 
terom@0: #include <stdarg.h>
terom@0: 
terom@0: /**
terom@0:  * Log level definitions
terom@0:  *
terom@0:  * XXX: these names conflict with <syslog.h>
terom@0:  */
terom@0: enum log_level {
terom@0:     LOG_DEBUG,
terom@0:     LOG_INFO,
terom@0:     LOG_WARN,
terom@0:     LOG_ERROR,
terom@0:     LOG_FATAL,
terom@0: };
terom@0: 
terom@0: /**
terom@0:  * List of log_level values as strings, NULL-terminated
terom@0:  */
terom@0: extern const char *log_level_names[];
terom@0: 
terom@0: /**
terom@0:  * The default log level
terom@0:  */
terom@0: #define LOG_LEVEL_DEFAULT LOG_INFO
terom@0: 
terom@0: /**
terom@0:  * Maximum length of a log message, including terminating NUL
terom@0:  */
terom@0: #define LOG_MSG_MAX 1024
terom@0: 
terom@0: /**
terom@0:  * Set the current log level to filter out messages below the given level
terom@0:  */
terom@0: void set_log_level (enum log_level level);
terom@0: /**
terom@0:  * Internal logging func, meant for using custom level tags. This performs the filtering of log levels.
terom@0:  *
terom@0:  * Format the full output line, and pass it to the log_output_func. The line will be of the form:
terom@0:  *  "[<tag>] <func> : <user_fmt> [ <log_fmt> ]"
terom@0:  */
terom@0: void log_output_tag (enum log_level level, const char *tag, const char *func, const char *user_fmt, va_list user_fmtargs, const char *log_fmt, ...)
terom@0:     __attribute__ ((format (printf, 6, 7)));
terom@0: 
terom@0: /**
terom@0:  * va_list version of log_output_tag
terom@0:  */
terom@0: void log_output_tag_va (enum log_level level, const char *tag, const char *func, const char *user_fmt, va_list user_fmtargs, const char *log_fmt, va_list log_fmtargs);
terom@0: 
terom@0: /**
terom@0:  * Log a message with the given level
terom@0:  */
terom@0: #define log_msg(level, ...) _log_msg(level, __func__, __VA_ARGS__)
terom@0: void _log_msg (enum log_level level, const char *func, const char *format, ...)
terom@0:     __attribute__ ((format (printf, 3, 4)));
terom@0: 
terom@0: /**
terom@0:  * Log a message with the given level with the given format and varargs
terom@0:  */
terom@0: #define log_msg_va2(level, fmt1, vargs1, fmt2, vargs2) _log_msg_va(level, __func__, fmt1, vargs1, fmt2, vargs2)
terom@0: void _log_msg_va2 (enum log_level level, const char *func, const char *fmt1, va_list fmtargs1, const char *fmt2, va_list fmtargs2);
terom@0: 
terom@0: 
terom@0: /**
terom@0:  * Shorthand for log_msg
terom@0:  */
terom@0: #define log_debug(...) log_msg(LOG_DEBUG, __VA_ARGS__)
terom@0: #define log_info(...)  log_msg(LOG_INFO,  __VA_ARGS__)
terom@0: #define log_warn(...)  log_msg(LOG_WARN,  __VA_ARGS__)
terom@0: #define log_error(...) log_msg(LOG_ERROR, __VA_ARGS__)
terom@0: #define log_fatal(...) log_msg(LOG_FATAL, __VA_ARGS__)
terom@0: 
terom@0: /**
terom@0:  * Log using errno.
terom@0:  */
terom@0: #define log_errno(...) _log_errno(LOG_ERROR, __func__, __VA_ARGS__)
terom@0: #define log_warn_errno(...) _log_errno(LOG_WARN, __func__, __VA_ARGS__)
terom@0: void _log_errno (enum log_level level, const char *func, const char *format, ...)
terom@0:     __attribute__ ((format (printf, 3, 4)));
terom@0: 
terom@0: /**
terom@0:  * Log with an [EXIT] tag at given level, and then exit with given exit code
terom@0:  */
terom@0: #define log_exit(level, exit_code, ...) _log_exit(level, exit_code, __func__, __VA_ARGS__)
terom@0: void _log_exit (enum log_level level, int exit_code, const char *func, const char *format, ...)
terom@0:     __attribute__ ((format (printf, 4, 5)))
terom@0:     __attribute__ ((noreturn));
terom@0: 
terom@0: // for abort()
terom@0: #include <stdlib.h>
terom@0: 
terom@0: /**
terom@0:  * log_fatal + exit failure
terom@0:  */
terom@0: #define FATAL(...) do { log_fatal(__VA_ARGS__); abort(); } while (0)
terom@0: 
terom@0: /**
terom@0:  * log_perr + exit failure
terom@0:  */
terom@0: #define FATAL_ERRNO(...) do { _log_errno(LOG_FATAL, __func__, __VA_ARGS__); abort(); } while (0)
terom@0: 
terom@0: /**
terom@0:  * Exit with given code, also logging a message at LOG_... with an [EXIT] tag
terom@0:  */
terom@0: #define EXIT_INFO(exit_code, ...)  log_exit(LOG_INFO,  exit_code, __VA_ARGS__)
terom@0: #define EXIT_WARN(exit_code, ...)  log_exit(LOG_WARN,  exit_code, __VA_ARGS__)
terom@0: #define EXIT_ERROR(exit_code, ...) log_exit(LOG_ERROR, exit_code, __VA_ARGS__)
terom@0: #define EXIT_FATAL(exit_code, ...) log_exit(LOG_FATAL, exit_code, __VA_ARGS__)
terom@0: 
terom@0: #endif /* LOG_H */