logging.h

Go to the documentation of this file.

#pragma once
 
#include <stdarg.h>
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
 
 
typedef enum microstrain_log_level
{
    MICROSTRAIN_LOG_LEVEL_OFF   = 0,  
    MICROSTRAIN_LOG_LEVEL_FATAL = 1,  
    MICROSTRAIN_LOG_LEVEL_ERROR = 2,  
    MICROSTRAIN_LOG_LEVEL_WARN  = 3,  
    MICROSTRAIN_LOG_LEVEL_INFO  = 4,  
    MICROSTRAIN_LOG_LEVEL_DEBUG = 5,  
    MICROSTRAIN_LOG_LEVEL_TRACE = 6,  
} microstrain_log_level;
 
typedef void (*microstrain_log_callback)(void* user, const microstrain_log_level level, const char* fmt, va_list args);
 
void microstrain_logging_init(const microstrain_log_callback callback, const microstrain_log_level level, void* user);
 
microstrain_log_callback microstrain_logging_callback(void);
 
microstrain_log_level microstrain_logging_level(void);
 
void* microstrain_logging_user_data(void);
 
void microstrain_logging_log_v(const microstrain_log_level level, const char* fmt, va_list args);
 
void microstrain_logging_log(const microstrain_log_level level, const char* fmt, ...);
 
const char* microstrain_logging_level_name(const microstrain_log_level level);
 
void microstrain_log_bytes(const microstrain_log_level level, const char* msg, const uint8_t* data, size_t length);
 
#ifdef MICROSTRAIN_ENABLE_LOGGING
#define MICROSTRAIN_LOG_INIT(callback, level, user) microstrain_logging_init(callback, level, user)
#else
#define MICROSTRAIN_LOG_INIT(callback, level, user) (void)0
#endif
 
#ifdef MICROSTRAIN_ENABLE_LOGGING
#define MICROSTRAIN_LOG_LOG(level, ...) microstrain_logging_log(level, __VA_ARGS__)
#define MICROSTRAIN_LOG_LOG_V(level, fmt, args) microstrain_logging_log_v(level, fmt, args)
#else
#define MICROSTRAIN_LOG_LOG(level, ...) (void)0
#define MICROSTRAIN_LOG_LOG_V(level, fmt, args) (void)0
#endif
 
#ifndef MICROSTRAIN_LOGGING_MAX_LEVEL
#define MICROSTRAIN_LOGGING_MAX_LEVEL MICROSTRAIN_LOG_LEVEL_WARN
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_FATAL
#define MICROSTRAIN_LOG_FATAL(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_FATAL, __VA_ARGS__)
#define MICROSTRAIN_LOG_FATAL_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_FATAL, fmt, args)
#else
#define MICROSTRAIN_LOG_FATAL(...) (void)0
#define MICROSTRAIN_LOG_FATAL_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_ERROR
#define MICROSTRAIN_LOG_ERROR(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_ERROR, __VA_ARGS__)
#define MICROSTRAIN_LOG_ERROR_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_ERROR, fmt, args)
#else
#define MICROSTRAIN_LOG_ERROR(...) (void)0
#define MICROSTRAIN_LOG_ERROR_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_WARN
#define MICROSTRAIN_LOG_WARN(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_WARN, __VA_ARGS__)
#define MICROSTRAIN_LOG_WARN_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_WARN, fmt, args)
#else
#define MICROSTRAIN_LOG_WARN(...) (void)0
#define MICROSTRAIN_LOG_WARN_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_INFO
#define MICROSTRAIN_LOG_INFO(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_INFO, __VA_ARGS__)
#define MICROSTRAIN_LOG_INFO_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_INFO, fmt, args)
#else
#define MICROSTRAIN_LOG_INFO(...) (void)0
#define MICROSTRAIN_LOG_INFO_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_DEBUG
#define MICROSTRAIN_LOG_DEBUG(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_DEBUG, __VA_ARGS__)
#define MICROSTRAIN_LOG_DEBUG_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_DEBUG, fmt, args)
#else
#define MICROSTRAIN_LOG_DEBUG(...) (void)0
#define MICROSTRAIN_LOG_DEBUG_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_TRACE
#define MICROSTRAIN_LOG_TRACE(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_TRACE, __VA_ARGS__)
#define MICROSTRAIN_LOG_TRACE_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_TRACE, fmt, args)
#else
#define MICROSTRAIN_LOG_TRACE(...) (void)0
#define MICROSTRAIN_LOG_TRACE_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_ENABLE_LOGGING
#define MICROSTRAIN_LOG_BYTES(level, msg, data, length) microstrain_log_bytes(level, msg, data, length)
#else
#define MICROSTRAIN_LOG_BYTES(level, msg, data, length) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_TRACE
#define MICROSTRAIN_LOG_BYTES_TRACE(msg, data, length) microstrain_log_bytes(MICROSTRAIN_LOG_LEVEL_TRACE, msg, data, length)
#else
#define MICROSTRAIN_LOG_BYTES_TRACE(msg, data, length) (void)0
#endif
 
 
#define MICROSTRAIN_LOG_ERROR_WITH_ERRNO(msg) MICROSTRAIN_LOG_ERROR(msg ": %d %s\n", errno, strerror(errno))
 
#define MICROSTRAIN_LOG_ERROR_WITH_ERRNO_EX(msg, ...) MICROSTRAIN_LOG_ERROR(msg ": %d %s\n", __VA_ARGS__, errno, strerror(errno))
 
 
#ifdef __cplusplus
} // extern "C"
#endif