/************************************************************************** * * Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas. * Copyright 2009-2010 Chia-I Wu <olvaffe@gmail.com> * Copyright 2010 LunarG, Inc. * All Rights Reserved. * * 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, sub license, 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. * **************************************************************************/ /** * Logging facility for debug/info messages. * _EGL_FATAL messages are printed to stderr * The EGL_LOG_LEVEL var controls the output of other warning/info/debug msgs. */ #include <stdarg.h> #include <stdio.h> #include <stdlib.h> #include "egllog.h" #include "eglstring.h" #include "eglmutex.h" #define MAXSTRING 1000 #define FALLBACK_LOG_LEVEL _EGL_WARNING static struct { _EGLMutex mutex; EGLBoolean initialized; EGLint level; _EGLLogProc logger; EGLint num_messages; } logging = { _EGL_MUTEX_INITIALIZER, EGL_FALSE, FALLBACK_LOG_LEVEL, NULL, 0 }; static const char *level_strings[] = { /* the order is important */ "fatal", "warning", "info", "debug", NULL }; /** * Set the function to be called when there is a message to log. * Note that the function will be called with an internal lock held. * Recursive logging is not allowed. */ void _eglSetLogProc(_EGLLogProc logger) { EGLint num_messages = 0; _eglLockMutex(&logging.mutex); if (logging.logger != logger) { logging.logger = logger; num_messages = logging.num_messages; logging.num_messages = 0; } _eglUnlockMutex(&logging.mutex); if (num_messages) _eglLog(_EGL_DEBUG, "New logger installed. " "Messages before the new logger might not be available."); } /** * Set the log reporting level. */ void _eglSetLogLevel(EGLint level) { switch (level) { case _EGL_FATAL: case _EGL_WARNING: case _EGL_INFO: case _EGL_DEBUG: _eglLockMutex(&logging.mutex); logging.level = level; _eglUnlockMutex(&logging.mutex); break; default: break; } } /** * The default logger. It prints the message to stderr. */ static void _eglDefaultLogger(EGLint level, const char *msg) { fprintf(stderr, "libEGL %s: %s\n", level_strings[level], msg); } /** * Initialize the logging facility. */ static void _eglInitLogger(void) { const char *log_env; EGLint i, level = -1; if (logging.initialized) return; log_env = getenv("EGL_LOG_LEVEL"); if (log_env) { for (i = 0; level_strings[i]; i++) { if (_eglstrcasecmp(log_env, level_strings[i]) == 0) { level = i; break; } } } else { level = FALLBACK_LOG_LEVEL; } logging.logger = _eglDefaultLogger; logging.level = (level >= 0) ? level : FALLBACK_LOG_LEVEL; logging.initialized = EGL_TRUE; /* it is fine to call _eglLog now */ if (log_env && level < 0) { _eglLog(_EGL_WARNING, "Unrecognized EGL_LOG_LEVEL environment variable value. " "Expected one of \"fatal\", \"warning\", \"info\", \"debug\". " "Got \"%s\". Falling back to \"%s\".", log_env, level_strings[FALLBACK_LOG_LEVEL]); } } /** * Log a message with message logger. * \param level one of _EGL_FATAL, _EGL_WARNING, _EGL_INFO, _EGL_DEBUG. */ void _eglLog(EGLint level, const char *fmtStr, ...) { va_list args; char msg[MAXSTRING]; int ret; /* one-time initialization; a little race here is fine */ if (!logging.initialized) _eglInitLogger(); if (level > logging.level || level < 0) return; _eglLockMutex(&logging.mutex); if (logging.logger) { va_start(args, fmtStr); ret = vsnprintf(msg, MAXSTRING, fmtStr, args); if (ret < 0 || ret >= MAXSTRING) strcpy(msg, "<message truncated>"); va_end(args); logging.logger(level, msg); logging.num_messages++; } _eglUnlockMutex(&logging.mutex); if (level == _EGL_FATAL) exit(1); /* or abort()? */ }