u_debug.h revision b618827fac84ca12a354da5808f30e96bedbc92a
1f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/************************************************************************** 2f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 3f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas. 4f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * All Rights Reserved. 5f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 6f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Permission is hereby granted, free of charge, to any person obtaining a 7f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * copy of this software and associated documentation files (the 8f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * "Software"), to deal in the Software without restriction, including 9f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * without limitation the rights to use, copy, modify, merge, publish, 10f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * distribute, sub license, and/or sell copies of the Software, and to 11f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * permit persons to whom the Software is furnished to do so, subject to 12f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * the following conditions: 13f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 14f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * The above copyright notice and this permission notice (including the 15f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * next paragraph) shall be included in all copies or substantial portions 16f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * of the Software. 17f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 18f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 22f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 26f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org **************************************************************************/ 27f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 28f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 29f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * @file 30f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Cross-platform debugging helpers. 31f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 32f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * For now it just has assert and printf replacements, but it might be extended 33f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * with stack trace reports and more advanced logging in the near future. 34f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 35f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * @author Jose Fonseca <jrfonseca@tungstengraphics.com> 36f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 37f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 38f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifndef U_DEBUG_H_ 39f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define U_DEBUG_H_ 40f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 41f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 42f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#include <stdarg.h> 43f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 44f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#include "pipe/p_compiler.h" 45f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 46f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 47f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef __cplusplus 48f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgextern "C" { 49f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 50f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 51f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 52f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#if defined(DBG) || defined(DEBUG) 53f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifndef DEBUG 54f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define DEBUG 1 55f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 56f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else 57f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifndef NDEBUG 58f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define NDEBUG 1 59f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 60f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 61f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 62f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 63f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/* MSVC bebore VC7 does not have the __FUNCTION__ macro */ 64f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#if defined(_MSC_VER) && _MSC_VER < 1300 65f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define __FUNCTION__ "???" 66f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 67f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 68f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 69f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgvoid _debug_vprintf(const char *format, va_list ap); 70f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 71f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 72f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstatic INLINE void 73f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org_debug_printf(const char *format, ...) 74f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org{ 75f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org va_list ap; 76f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org va_start(ap, format); 77f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org _debug_vprintf(format, ap); 78f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org va_end(ap); 79f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org} 80f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 81f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 82f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 83f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Print debug messages. 84f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 85f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * The actual channel used to output debug message is platform specific. To 86f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * avoid misformating or truncation, follow these rules of thumb: 87f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * - output whole lines 88f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * - avoid outputing large strings (512 bytes is the current maximum length 89f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * that is guaranteed to be printed in all platforms) 90f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 91f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgstatic INLINE void 92f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgdebug_printf(const char *format, ...) 93f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org{ 94f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef DEBUG 95f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org va_list ap; 96f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org va_start(ap, format); 97f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org _debug_vprintf(format, ap); 98f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org va_end(ap); 99f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else 100f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org (void) format; /* silence warning */ 101f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 102f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org} 103f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 104f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 105f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/* 106f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * ... isn't portable so we need to pass arguments in parentheses. 107f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 108f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * usage: 109f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * debug_printf_once(("awnser: %i\n", 42)); 110f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 111f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_printf_once(args) \ 112f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org do { \ 113f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org static boolean once = TRUE; \ 114f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org if (once) { \ 115f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org once = FALSE; \ 116f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org debug_printf args; \ 117f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org } \ 118f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org } while (0) 119f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 120f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 121f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef DEBUG 122f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_vprintf(_format, _ap) _debug_vprintf(_format, _ap) 123f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else 124f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_vprintf(_format, _ap) ((void)0) 125f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 126f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 127f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 128f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef DEBUG 129f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 130f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Dump a blob in hex to the same place that debug_printf sends its 131f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * messages. 132f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 133f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgvoid debug_print_blob( const char *name, const void *blob, unsigned size ); 134f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 135f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/* Print a message along with a prettified format string 136f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 137f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgvoid debug_print_format(const char *msg, unsigned fmt ); 138f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else 139f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_print_blob(_name, _blob, _size) ((void)0) 140f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_print_format(_msg, _fmt) ((void)0) 141f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 142f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 143f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 144f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 145f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Hard-coded breakpoint. 146f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 147f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef DEBUG 148f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#if (defined(PIPE_ARCH_X86) || defined(PIPE_ARCH_X86_64)) && defined(PIPE_CC_GCC) 149f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_break() __asm("int3") 150f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#elif defined(PIPE_CC_MSVC) 151f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_break() __debugbreak() 152f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else 153f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgvoid debug_break(void); 154f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 155f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else /* !DEBUG */ 156f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_break() ((void)0) 157f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif /* !DEBUG */ 158f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 159f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 160f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orglong 161f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgdebug_get_num_option(const char *name, long dfault); 162f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 163f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.orgvoid _debug_assert_fail(const char *expr, 164f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org const char *file, 165f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org unsigned line, 166f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org const char *function); 167f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 168f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 169f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 170f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Assert macro 171f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * 172f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Do not expect that the assert call terminates -- errors must be handled 173f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * regardless of assert behavior. 174f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org */ 175f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef DEBUG 176f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_assert(expr) ((expr) ? (void)0 : _debug_assert_fail(#expr, __FILE__, __LINE__, __FUNCTION__)) 177f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#else 178f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define debug_assert(expr) ((void)(expr)) 179f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 180f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 181f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 182f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** Override standard assert macro */ 183f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#ifdef assert 184f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#undef assert 185f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#endif 186f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org#define assert(expr) debug_assert(expr) 187f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 188f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org 189f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org/** 190f2ba7591b1407a7ee9209f842c50696914dc2dedkbr@chromium.org * Output the current function name. 191 */ 192#ifdef DEBUG 193#define debug_checkpoint() \ 194 _debug_printf("%s\n", __FUNCTION__) 195#else 196#define debug_checkpoint() \ 197 ((void)0) 198#endif 199 200 201/** 202 * Output the full source code position. 203 */ 204#ifdef DEBUG 205#define debug_checkpoint_full() \ 206 _debug_printf("%s:%u:%s", __FILE__, __LINE__, __FUNCTION__) 207#else 208#define debug_checkpoint_full() \ 209 ((void)0) 210#endif 211 212 213/** 214 * Output a warning message. Muted on release version. 215 */ 216#ifdef DEBUG 217#define debug_warning(__msg) \ 218 _debug_printf("%s:%u:%s: warning: %s\n", __FILE__, __LINE__, __FUNCTION__, __msg) 219#else 220#define debug_warning(__msg) \ 221 ((void)0) 222#endif 223 224 225/** 226 * Output an error message. Not muted on release version. 227 */ 228#ifdef DEBUG 229#define debug_error(__msg) \ 230 _debug_printf("%s:%u:%s: error: %s\n", __FILE__, __LINE__, __FUNCTION__, __msg) 231#else 232#define debug_error(__msg) \ 233 _debug_printf("error: %s\n", __msg) 234#endif 235 236 237/** 238 * Used by debug_dump_enum and debug_dump_flags to describe symbols. 239 */ 240struct debug_named_value 241{ 242 const char *name; 243 unsigned long value; 244}; 245 246 247/** 248 * Some C pre-processor magic to simplify creating named values. 249 * 250 * Example: 251 * @code 252 * static const debug_named_value my_names[] = { 253 * DEBUG_NAMED_VALUE(MY_ENUM_VALUE_X), 254 * DEBUG_NAMED_VALUE(MY_ENUM_VALUE_Y), 255 * DEBUG_NAMED_VALUE(MY_ENUM_VALUE_Z), 256 * DEBUG_NAMED_VALUE_END 257 * }; 258 * 259 * ... 260 * debug_printf("%s = %s\n", 261 * name, 262 * debug_dump_enum(my_names, my_value)); 263 * ... 264 * @endcode 265 */ 266#define DEBUG_NAMED_VALUE(__symbol) {#__symbol, (unsigned long)__symbol} 267#define DEBUG_NAMED_VALUE_END {NULL, 0} 268 269 270/** 271 * Convert a enum value to a string. 272 */ 273const char * 274debug_dump_enum(const struct debug_named_value *names, 275 unsigned long value); 276 277const char * 278debug_dump_enum_noprefix(const struct debug_named_value *names, 279 const char *prefix, 280 unsigned long value); 281 282 283/** 284 * Convert binary flags value to a string. 285 */ 286const char * 287debug_dump_flags(const struct debug_named_value *names, 288 unsigned long value); 289 290 291/** 292 * Get option. 293 * 294 * It is an alias for getenv on Linux. 295 * 296 * On Windows it reads C:\gallium.cfg, which is a text file with CR+LF line 297 * endings with one option per line as 298 * 299 * NAME=value 300 * 301 * This file must be terminated with an extra empty line. 302 */ 303const char * 304debug_get_option(const char *name, const char *dfault); 305 306boolean 307debug_get_bool_option(const char *name, boolean dfault); 308 309long 310debug_get_num_option(const char *name, long dfault); 311 312unsigned long 313debug_get_flags_option(const char *name, 314 const struct debug_named_value *flags, 315 unsigned long dfault); 316 317 318void * 319debug_malloc(const char *file, unsigned line, const char *function, 320 size_t size); 321 322void 323debug_free(const char *file, unsigned line, const char *function, 324 void *ptr); 325 326void * 327debug_calloc(const char *file, unsigned line, const char *function, 328 size_t count, size_t size ); 329 330void * 331debug_realloc(const char *file, unsigned line, const char *function, 332 void *old_ptr, size_t old_size, size_t new_size ); 333 334unsigned long 335debug_memory_begin(void); 336 337void 338debug_memory_end(unsigned long beginning); 339 340 341#if defined(PROFILE) && defined(PIPE_SUBSYSTEM_WINDOWS_DISPLAY) 342 343void 344debug_profile_start(void); 345 346void 347debug_profile_stop(void); 348 349#endif 350 351 352#ifdef DEBUG 353struct pipe_surface; 354struct pipe_transfer; 355void debug_dump_image(const char *prefix, 356 unsigned format, unsigned cpp, 357 unsigned width, unsigned height, 358 unsigned stride, 359 const void *data); 360void debug_dump_surface(const char *prefix, 361 struct pipe_surface *surface); 362void debug_dump_surface_bmp(const char *filename, 363 struct pipe_surface *surface); 364void debug_dump_transfer_bmp(const char *filename, 365 struct pipe_transfer *transfer); 366void debug_dump_float_rgba_bmp(const char *filename, 367 unsigned width, unsigned height, 368 float *rgba, unsigned stride); 369#else 370#define debug_dump_image(prefix, format, cpp, width, height, stride, data) ((void)0) 371#define debug_dump_surface(prefix, surface) ((void)0) 372#define debug_dump_surface_bmp(filename, surface) ((void)0) 373#define debug_dump_transfer_bmp(filename, transfer) ((void)0) 374#define debug_dump_rgba_float_bmp(filename, width, height, rgba, stride) ((void)0) 375#endif 376 377 378#ifdef __cplusplus 379} 380#endif 381 382#endif /* U_DEBUG_H_ */ 383