/* * This is a stable interface of wlroots. Future changes will be limited to: * * - New functions * - New struct members * - New enum members * * Note that wlroots does not make an ABI compatibility promise - in the future, * the layout and size of structs used by wlroots may change, requiring code * depending on this header to be recompiled (but not edited). * * Breaking changes are announced in the release notes and follow a 1-year * deprecation schedule. */ #ifndef WLR_UTIL_LOG_H #define WLR_UTIL_LOG_H #include #include #include #include enum wlr_log_importance { WLR_SILENT = 0, WLR_ERROR = 1, WLR_INFO = 2, WLR_DEBUG = 3, WLR_LOG_IMPORTANCE_LAST, }; typedef void (*wlr_log_func_t)(enum wlr_log_importance importance, const char *fmt, va_list args); // Will log all messages less than or equal to `verbosity` // If `callback` is NULL, wlr will use its default logger. // The function can be called multiple times to update the verbosity or // callback function. void wlr_log_init(enum wlr_log_importance verbosity, wlr_log_func_t callback); // Returns the log verbosity provided to wlr_log_init enum wlr_log_importance wlr_log_get_verbosity(void); #ifdef __GNUC__ #define _WLR_ATTRIB_PRINTF(start, end) __attribute__((format(printf, start, end))) #else #define _WLR_ATTRIB_PRINTF(start, end) #endif void _wlr_log(enum wlr_log_importance verbosity, const char *format, ...) _WLR_ATTRIB_PRINTF(2, 3); void _wlr_vlog(enum wlr_log_importance verbosity, const char *format, va_list args) _WLR_ATTRIB_PRINTF(2, 0); #ifdef WLR_REL_SRC_DIR // strip prefix from __FILE__, leaving the path relative to the project root #define _WLR_FILENAME ((const char *)__FILE__ + sizeof(WLR_REL_SRC_DIR) - 1) #else #define _WLR_FILENAME __FILE__ #endif #define wlr_log(verb, fmt, ...) \ _wlr_log(verb, "[%s:%d] " fmt, _WLR_FILENAME, __LINE__, ##__VA_ARGS__) #define wlr_vlog(verb, fmt, args) \ _wlr_vlog(verb, "[%s:%d] " fmt, _WLR_FILENAME, __LINE__, args) #define wlr_log_errno(verb, fmt, ...) \ wlr_log(verb, fmt ": %s", ##__VA_ARGS__, strerror(errno)) #endif