sl@0: /*
sl@0:  * LIBOIL - Library of Optimized Inner Loops
sl@0:  * Copyright (c) 2003,2004 David A. Schleef <ds@schleef.org>
sl@0:  * All rights reserved.
sl@0:  *
sl@0:  * Redistribution and use in source and binary forms, with or without
sl@0:  * modification, are permitted provided that the following conditions
sl@0:  * are met:
sl@0:  * 1. Redistributions of source code must retain the above copyright
sl@0:  *    notice, this list of conditions and the following disclaimer.
sl@0:  * 2. Redistributions in binary form must reproduce the above copyright
sl@0:  *    notice, this list of conditions and the following disclaimer in the
sl@0:  *    documentation and/or other materials provided with the distribution.
sl@0:  * 
sl@0:  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
sl@0:  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
sl@0:  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
sl@0:  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
sl@0:  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
sl@0:  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
sl@0:  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
sl@0:  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
sl@0:  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
sl@0:  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
sl@0:  * POSSIBILITY OF SUCH DAMAGE.
sl@0:  */
sl@0: 
sl@0: #ifndef _LIBOIL_DEBUG_H_
sl@0: #define _LIBOIL_DEBUG_H_
sl@0: 
sl@0: #include <stdarg.h>
sl@0: #include <liboil/liboilutils.h>
sl@0: 
sl@0: OIL_BEGIN_DECLS
sl@0: 
sl@0: #ifdef OIL_ENABLE_UNSTABLE_API
sl@0: 
sl@0: /**
sl@0:  * OilDebugPrintFunc:
sl@0:  * @level: the debug level
sl@0:  * @file: name of the file where the debug message occurs
sl@0:  * @func: name of the function where the debug message occurs
sl@0:  * @line: line in the file where the debug message occurs
sl@0:  * @format: a printf format
sl@0:  * @varargs: varargs for the printf format
sl@0:  *
sl@0:  * Typedef describing functions that can be registered using
sl@0:  * oil_debug_set_print_function() so that it is called to
sl@0:  * print debugging messages.
sl@0:  */
sl@0: typedef void (*OilDebugPrintFunc) (int level, const char *file,
sl@0:     const char *func, int line, const char *format, va_list varargs);
sl@0: 
sl@0: /**
sl@0:  * OilDebugLevel:
sl@0:  *
sl@0:  * Enumeration describing debug levels in Liboil.
sl@0:  */
sl@0: typedef enum {
sl@0:   OIL_DEBUG_NONE = 0,
sl@0:   OIL_DEBUG_ERROR,
sl@0:   OIL_DEBUG_WARNING,
sl@0:   OIL_DEBUG_INFO,
sl@0:   OIL_DEBUG_DEBUG,
sl@0:   OIL_DEBUG_LOG
sl@0: } OilDebugLevel;
sl@0: 
sl@0: /**
sl@0:  * OIL_ERROR:
sl@0:  *
sl@0:  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_ERROR.
sl@0:  */
sl@0: #define OIL_ERROR(args...) OIL_DEBUG_PRINT(OIL_DEBUG_ERROR, ##args)
sl@0: /**
sl@0:  * OIL_WARNING:
sl@0:  *
sl@0:  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_WARNING.
sl@0:  */
sl@0: #define OIL_WARNING(args...) OIL_DEBUG_PRINT(OIL_DEBUG_WARNING, ##args)
sl@0: /**
sl@0:  * OIL_INFO:
sl@0:  *
sl@0:  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_INFO.
sl@0:  */
sl@0: #define OIL_INFO(args...) OIL_DEBUG_PRINT(OIL_DEBUG_INFO, ##args)
sl@0: /**
sl@0:  * OIL_DEBUG:
sl@0:  *
sl@0:  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_DEBUG.
sl@0:  */
sl@0: #define OIL_DEBUG(args...) OIL_DEBUG_PRINT(OIL_DEBUG_DEBUG, ##args)
sl@0: /**
sl@0:  * OIL_LOG:
sl@0:  *
sl@0:  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_LOG.
sl@0:  */
sl@0: #define OIL_LOG(args...) OIL_DEBUG_PRINT(OIL_DEBUG_LOG, ##args)
sl@0: 
sl@0: /**
sl@0:  * OIL_FUNCTION:
sl@0:  *
sl@0:  * Internal macro that points to __PRETTY_FUNCTION__ or __func__
sl@0:  * if the former is not available.
sl@0:  */
sl@0: #if defined (__GNUC__) || defined (__PRETTY_FUNCTION__)
sl@0: #define OIL_FUNCTION __PRETTY_FUNCTION__
sl@0: #elif defined(__func__)
sl@0: #define OIL_FUNCTION __func__
sl@0: #else
sl@0: #define OIL_FUNCTION ""
sl@0: #endif
sl@0: 
sl@0: /**
sl@0:  * OIL_DEBUG_PRINT:
sl@0:  * @level:
sl@0:  * @...:
sl@0:  *
sl@0:  * Macro to call oil_debug_print() with the correct values for
sl@0:  * the name of the source file, line of source file, and function.
sl@0:  */
sl@0: #define OIL_DEBUG_PRINT(level, args...) do { \
sl@0:   oil_debug_print((level), __FILE__, OIL_FUNCTION, __LINE__, ##args); \
sl@0: }while(0)
sl@0: 
sl@0: IMPORT_C void oil_debug_set_print_function (OilDebugPrintFunc func);
sl@0: IMPORT_C int oil_debug_get_level (void);
sl@0: IMPORT_C void oil_debug_set_level (int level);
sl@0: 
sl@0: void _oil_debug_init (void);
sl@0: 
sl@0: IMPORT_C void oil_debug_print (int level, const char *file, const char *func,
sl@0:     int line, const char *format, ...);
sl@0: 
sl@0: #endif
sl@0: 
sl@0: OIL_END_DECLS
sl@0: 
sl@0: #endif
sl@0: