/* Simple Plugin API * * Copyright © 2018 Wim Taymans * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice (including the next * paragraph) shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. */ #ifndef __SPA_LOG_H__ #define __SPA_LOG_H__ #ifdef __cplusplus extern "C" { #endif #include #include enum spa_log_level { SPA_LOG_LEVEL_NONE = 0, SPA_LOG_LEVEL_ERROR, SPA_LOG_LEVEL_WARN, SPA_LOG_LEVEL_INFO, SPA_LOG_LEVEL_DEBUG, SPA_LOG_LEVEL_TRACE, }; /** * The Log interface */ struct spa_log { /** the version of this log. This can be used to expand this * structure in the future */ #define SPA_VERSION_LOG 0 uint32_t version; /** * Extra information about the log */ const struct spa_dict *info; /** * Logging level, everything above this level is not logged */ enum spa_log_level level; /** * Log a message with the given log level. * * \param log a spa_log * \param level a spa_log_level * \param file the file name * \param line the line number * \param func the function name * \param fmt printf style format * \param ... format arguments */ void (*log) (struct spa_log *log, enum spa_log_level level, const char *file, int line, const char *func, const char *fmt, ...) SPA_PRINTF_FUNC(6, 7); /** * Log a message with the given log level. * * \param log a spa_log * \param level a spa_log_level * \param file the file name * \param line the line number * \param func the function name * \param fmt printf style format * \param args format arguments */ void (*logv) (struct spa_log *log, enum spa_log_level level, const char *file, int line, const char *func, const char *fmt, va_list args) SPA_PRINTF_FUNC(6, 0); }; #define spa_log_level_enabled(l,lev) ((l) && (l)->level >= (lev)) #if defined(__USE_ISOC11) || defined(__USE_ISOC99) || \ (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) #define spa_log_log(l,lev,...) \ ({ \ if (SPA_UNLIKELY (spa_log_level_enabled (l, lev))) \ (l)->log((l),lev,__VA_ARGS__); \ }) #define spa_log_error(l,...) spa_log_log(l,SPA_LOG_LEVEL_ERROR,__FILE__,__LINE__,__func__,__VA_ARGS__) #define spa_log_warn(l,...) spa_log_log(l,SPA_LOG_LEVEL_WARN,__FILE__,__LINE__,__func__,__VA_ARGS__) #define spa_log_info(l,...) spa_log_log(l,SPA_LOG_LEVEL_INFO,__FILE__,__LINE__,__func__,__VA_ARGS__) #define spa_log_debug(l,...) spa_log_log(l,SPA_LOG_LEVEL_DEBUG,__FILE__,__LINE__,__func__,__VA_ARGS__) #define spa_log_trace(l,...) spa_log_log(l,SPA_LOG_LEVEL_TRACE,__FILE__,__LINE__,__func__,__VA_ARGS__) #else #define SPA_LOG_FUNC(name,lev) \ static inline void spa_log_##name (struct spa_log *l, const char *format, ...) \ { \ if (SPA_UNLIKELY (spa_log_level_enabled (l, lev))) { \ va_list varargs; \ va_start (varargs, format); \ (l)->logv((l),lev,__FILE__,__LINE__,__func__,format,varargs); \ va_end (varargs); \ } \ } SPA_LOG_FUNC(error, SPA_LOG_LEVEL_ERROR) SPA_LOG_FUNC(warn, SPA_LOG_LEVEL_WARN) SPA_LOG_FUNC(info, SPA_LOG_LEVEL_INFO) SPA_LOG_FUNC(debug, SPA_LOG_LEVEL_DEBUG) SPA_LOG_FUNC(trace, SPA_LOG_LEVEL_TRACE) #endif #ifdef __cplusplus } /* extern "C" */ #endif #endif /* __SPA_LOG_H__ */