/*

  * LIBOIL - Library of Optimized Inner Loops

  * Copyright (c) 2003,2004 David A. Schleef <ds@schleef.org>

  * All rights reserved.

  *

  * Redistribution and use in source and binary forms, with or without

  * modification, are permitted provided that the following conditions

  * are met:

  * 1. Redistributions of source code must retain the above copyright

  *    notice, this list of conditions and the following disclaimer.

  * 2. Redistributions in binary form must reproduce the above copyright

  *    notice, this list of conditions and the following disclaimer in the

  *    documentation and/or other materials provided with the distribution.

  * 

  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR

  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,

  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING

  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

  * POSSIBILITY OF SUCH DAMAGE.

  */

 #ifndef _LIBOIL_DEBUG_H_

 #define _LIBOIL_DEBUG_H_

 #include <stdarg.h>

 #include <liboil/liboilutils.h>

 OIL_BEGIN_DECLS

 #ifdef OIL_ENABLE_UNSTABLE_API

 /**

  * OilDebugPrintFunc:

  * @level: the debug level

  * @file: name of the file where the debug message occurs

  * @func: name of the function where the debug message occurs

  * @line: line in the file where the debug message occurs

  * @format: a printf format

  * @varargs: varargs for the printf format

  *

  * Typedef describing functions that can be registered using

  * oil_debug_set_print_function() so that it is called to

  * print debugging messages.

  */

 typedef void (*OilDebugPrintFunc) (int level, const char *file,

     const char *func, int line, const char *format, va_list varargs);

 /**

  * OilDebugLevel:

  *

  * Enumeration describing debug levels in Liboil.

  */

 typedef enum {

   OIL_DEBUG_NONE = 0,

   OIL_DEBUG_ERROR,

   OIL_DEBUG_WARNING,

   OIL_DEBUG_INFO,

   OIL_DEBUG_DEBUG,

   OIL_DEBUG_LOG

 } OilDebugLevel;

 /**

  * OIL_ERROR:

  *

  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_ERROR.

  */

 #define OIL_ERROR(args...) OIL_DEBUG_PRINT(OIL_DEBUG_ERROR, ##args)

 /**

  * OIL_WARNING:

  *

  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_WARNING.

  */

 #define OIL_WARNING(args...) OIL_DEBUG_PRINT(OIL_DEBUG_WARNING, ##args)

 /**

  * OIL_INFO:

  *

  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_INFO.

  */

 #define OIL_INFO(args...) OIL_DEBUG_PRINT(OIL_DEBUG_INFO, ##args)

 /**

  * OIL_DEBUG:

  *

  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_DEBUG.

  */

 #define OIL_DEBUG(args...) OIL_DEBUG_PRINT(OIL_DEBUG_DEBUG, ##args)

 /**

  * OIL_LOG:

  *

  * Macro to call OIL_DEBUG_PRINT() with a level of #OIL_DEBUG_LOG.

  */

 #define OIL_LOG(args...) OIL_DEBUG_PRINT(OIL_DEBUG_LOG, ##args)

 /**

  * OIL_FUNCTION:

  *

  * Internal macro that points to __PRETTY_FUNCTION__ or __func__

  * if the former is not available.

  */

 #if defined (__GNUC__) || defined (__PRETTY_FUNCTION__)

 #define OIL_FUNCTION __PRETTY_FUNCTION__

 #elif defined(__func__)

 #define OIL_FUNCTION __func__

 #else

 #define OIL_FUNCTION ""

 #endif

 /**

  * OIL_DEBUG_PRINT:

  * @level:

  * @...:

  *

  * Macro to call oil_debug_print() with the correct values for

  * the name of the source file, line of source file, and function.

  */

 #define OIL_DEBUG_PRINT(level, args...) do { \

   oil_debug_print((level), __FILE__, OIL_FUNCTION, __LINE__, ##args); \

 }while(0)

 IMPORT_C void oil_debug_set_print_function (OilDebugPrintFunc func);

 IMPORT_C int oil_debug_get_level (void);

 IMPORT_C void oil_debug_set_level (int level);

 void _oil_debug_init (void);

 IMPORT_C void oil_debug_print (int level, const char *file, const char *func,

     int line, const char *format, ...);

 #endif

 OIL_END_DECLS

 #endif