2 #ifndef __WINE_DEBUGTOOLS_H
3 #define __WINE_DEBUGTOOLS_H
5 #ifdef __WINE__ /* Debugging interface is internal to Wine */
12 /* Internal definitions (do not use these directly) */
14 enum __DEBUG_CLASS
{ __DBCL_FIXME
, __DBCL_ERR
, __DBCL_WARN
, __DBCL_TRACE
, __DBCL_COUNT
};
17 # define __GET_DEBUGGING_TRACE(dbch) ((dbch)[0] & (1 << __DBCL_TRACE))
19 # define __GET_DEBUGGING_TRACE(dbch) 0
23 # define __GET_DEBUGGING_WARN(dbch) ((dbch)[0] & (1 << __DBCL_WARN))
24 # define __GET_DEBUGGING_FIXME(dbch) ((dbch)[0] & (1 << __DBCL_FIXME))
26 # define __GET_DEBUGGING_WARN(dbch) 0
27 # define __GET_DEBUGGING_FIXME(dbch) 0
30 /* define error macro regardless of what is configured */
31 #define __GET_DEBUGGING_ERR(dbch) ((dbch)[0] & (1 << __DBCL_ERR))
33 #define __GET_DEBUGGING(dbcl,dbch) __GET_DEBUGGING##dbcl(dbch)
34 #define __SET_DEBUGGING(dbcl,dbch,on) \
35 ((on) ? ((dbch)[0] |= 1 << (dbcl)) : ((dbch)[0] &= ~(1 << (dbcl))))
39 #define __DPRINTF(dbcl,dbch) \
40 do { if(__GET_DEBUGGING(dbcl,(dbch))) { \
41 const char * const __dbch = (dbch); \
42 const enum __DEBUG_CLASS __dbcl = __DBCL##dbcl; \
45 #define __WINE_DBG_LOG(args...) \
46 wine_dbg_log( __dbcl, __dbch, __FUNCTION__, args); } } while(0)
48 #define __PRINTF_ATTR(fmt,args) __attribute__((format (printf,fmt,args)))
52 #define __DPRINTF(dbcl,dbch) \
53 (!__GET_DEBUGGING(dbcl,(dbch)) || \
54 (wine_dbg_log(__DBCL##dbcl,(dbch),__FILE__,"%d: ",__LINE__),0)) ? \
55 (void)0 : (void)wine_dbg_printf
57 #define __PRINTF_ATTR(fmt, args)
61 /* Exported definitions and macros */
63 /* These function return a printable version of a string, including
64 quotes. The string will be valid for some time, but not indefinitely
65 as strings are re-used. */
66 extern const char *wine_dbgstr_an( const char * s
, int n
);
67 extern const char *wine_dbgstr_wn( const WCHAR
*s
, int n
);
68 extern const char *wine_dbgstr_guid( const struct _GUID
*id
);
70 extern int wine_dbg_vprintf( const char *format
, va_list args
) __PRINTF_ATTR(1,0);
71 extern int wine_dbg_printf( const char *format
, ... ) __PRINTF_ATTR(1,2);
72 extern int wine_dbg_log( enum __DEBUG_CLASS cls
, const char *ch
,
73 const char *func
, const char *format
, ... ) __PRINTF_ATTR(4,5);
75 inline static const char *debugstr_an( const char * s
, int n
) { return wine_dbgstr_an( s
, n
); }
76 inline static const char *debugstr_wn( const WCHAR
*s
, int n
) { return wine_dbgstr_wn( s
, n
); }
77 inline static const char *debugstr_guid( const struct _GUID
*id
) { return wine_dbgstr_guid(id
); }
78 inline static const char *debugstr_a( const char *s
) { return wine_dbgstr_an( s
, 80 ); }
79 inline static const char *debugstr_w( const WCHAR
*s
) { return wine_dbgstr_wn( s
, 80 ); }
80 inline static const char *debugres_a( const char *s
) { return wine_dbgstr_an( s
, 80 ); }
81 inline static const char *debugres_w( const WCHAR
*s
) { return wine_dbgstr_wn( s
, 80 ); }
83 #define TRACE __DPRINTF(_TRACE,__wine_dbch___default)
84 #define TRACE_(ch) __DPRINTF(_TRACE,__wine_dbch_##ch)
85 #define TRACE_ON(ch) __GET_DEBUGGING(_TRACE,__wine_dbch_##ch)
87 #define WARN __DPRINTF(_WARN,__wine_dbch___default)
88 #define WARN_(ch) __DPRINTF(_WARN,__wine_dbch_##ch)
89 #define WARN_ON(ch) __GET_DEBUGGING(_WARN,__wine_dbch_##ch)
91 #define FIXME __DPRINTF(_FIXME,__wine_dbch___default)
92 #define FIXME_(ch) __DPRINTF(_FIXME,__wine_dbch_##ch)
93 #define FIXME_ON(ch) __GET_DEBUGGING(_FIXME,__wine_dbch_##ch)
95 #undef ERR /* Solaris got an 'ERR' define in <sys/reg.h> */
96 #define ERR __DPRINTF(_ERR,__wine_dbch___default)
97 #define ERR_(ch) __DPRINTF(_ERR,__wine_dbch_##ch)
98 #define ERR_ON(ch) __GET_DEBUGGING(_ERR,__wine_dbch_##ch)
100 #define DECLARE_DEBUG_CHANNEL(ch) \
101 extern char __wine_dbch_##ch[]
102 #define DEFAULT_DEBUG_CHANNEL(ch) \
103 extern char __wine_dbch_##ch[]; static char * const __wine_dbch___default = __wine_dbch_##ch
105 #define DPRINTF wine_dbg_printf
106 #define MESSAGE wine_dbg_printf
108 #endif /* __WINE__ */
110 #endif /* __WINE_DEBUGTOOLS_H */