windows-nt/Source/XPSP1/NT/base/crts/crtw32/h/crtdbg.h
2020-09-26 16:20:57 +08:00

776 lines
22 KiB
C

/***
*crtdbg.h - Supports debugging features of the C runtime library.
*
* Copyright (c) 1994-2001, Microsoft Corporation. All rights reserved.
*
*Purpose:
* Support CRT debugging features.
*
* [Public]
*
*Revision History:
* 08-16-94 CFW Module created.
* 11-28-94 CFW Add DumpClient, more params for AllocHook.
* 12-08-94 CFW Use non-win32 names.
* 01-09-95 CFW Dump client needs size, add _CrtSetBreakAlloc,
* use const state pointers.
* 01-10-95 CFW dbgint.h merge.
* 01-20-94 CFW Change unsigned chars to chars.
* 01-24-94 CFW Cleanup: remove unneeded funcs, add _CrtSetDbgFlag.
* 01-24-94 CFW _CrtDbgReport now returns 1 for debug.
* 02-11-95 CFW Add _CRTBLD to avoid users getting wrong headers.
* 02-14-95 CFW Clean up Mac merge.
* 02-17-95 CFW new() proto moved from dbgint.h.
* 02-27-95 CFW Change debug break scheme.
* 03-21-95 CFW Add _CRT_ASSERT & _delete_client, remove tracking.
* 03-23-95 JWM Restored tracking.
* 03-28-95 CFW Remove tracking, export _crtBreakAlloc.
* 04-06-95 CFW Add malloc -> _malloc_dbg macros.
* 04-10-95 CFW Define NULL.
* 03-21-95 CFW Remove _delete_client.
* 03-30-95 CFW Avoid _CRTDBG_xxx conflicts with MFC.
* 05-11-95 CFW Move C++ code to its own section.
* 05-12-95 CFW Use _CrtIsValidPointer & _CrtIsValidHeapPointer.
* 06-08-95 CFW Add return value parameter to report hook.
* 06-27-95 CFW Add win32s support for debug libs.
* 07-25-95 CFW Add win32s support for user visible debug heap variables.
* 09-01-95 GJF Moved a proto for new up slightly to avoid compiler
* error C2660 (Olympus 1015).
* 09-20-95 CFW Change _RPT0, _RPTF0 to support messages with '%' in them.
* 12-14-95 JWM Add "#pragma once".
* 01-23-97 GJF Cleaned out obsolete support for Win32s.
* 04-21-97 JWM Added 4-parameter operator delete(), required by 6.0 compiler.
* 04-29-97 JWM Made 4-parameter operator delete() #if _MSC_VER >= 1200.
* 08-14-97 GJF Strip __p_* prototypes from release version. Also,
* moved the constant and type definition out of the ifdef
* _DEBUG so they are always defined.
* 01-19-98 JWM At request of DeanM, made debug prototypes of new & delete
* #ifndef _MFC_OVERRIDES_NEW
* 05-22-98 JWM Added support for new[] & delete[], courtesy of KFrei's RTC work.
* 06-08-98 JWM Minor cleanups.
* 12-01-98 GJF More choices for calling _CrtCheckMemory than never or always.
* 12-15-98 GJF Changes for 64-bit size_t.
* 05-17-99 PML Remove all Macintosh support.
* 08-30-99 PML Get rid of unprintable character in comment.
* 10-06-99 PML Add _W64 modifier to types which are 32 bits in Win32,
* 64 bits in Win64.
* 11-02-99 PML Add extern "C++" around C++ definitions.
* 11-08-99 PML Don't mark debug operator new _CRTIMP (vs7#16060).
* 11-16-99 PML Forward-decl _CrtMemBlockHeader to work around vs7#63059
* 01-04-00 GB Added support for debug version for _aligned routines
* 02-25-00 PML _CrtDbgBreak should use __debugbreak if available.
* 05-31-00 PML Add _CrtReportBlockType (VS7#55049).
* 09-26-00 PML Fix _ASSERT*, _RPT* to compile /W4 clean (vs7#166894)
* 12-10-00 PML Non-_DEBUG macro versions of _CrtSet* should not be
* typed as void (vs7#166572).
* 03-21-01 PML Add _CrtSetReportHook2 (vs7#124998)
*
****/
#if _MSC_VER > 1000 /*IFSTRIP=IGN*/
#pragma once
#endif
#ifndef _INC_CRTDBG
#define _INC_CRTDBG
#if !defined(_WIN32)
#error ERROR: Only Win32 target supported!
#endif
#ifndef _CRTBLD
/* This version of the header files is NOT for user programs.
* It is intended for use when building the C runtimes ONLY.
* The version intended for public use will not have this message.
*/
#error ERROR: Use of C runtime library internal header file.
#endif /* _CRTBLD */
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/****************************************************************************
*
* Constants and types
*
***************************************************************************/
#if !defined(_W64)
#if !defined(__midl) && (defined(_X86_) || defined(_M_IX86)) && _MSC_VER >= 1300 /*IFSTRIP=IGN*/
#define _W64 __w64
#else
#define _W64
#endif
#endif
#ifndef _SIZE_T_DEFINED
#ifdef _WIN64
typedef unsigned __int64 size_t;
#else
typedef _W64 unsigned int size_t;
#endif
#define _SIZE_T_DEFINED
#endif
/* Define NULL pointer value */
#ifndef NULL
#ifdef __cplusplus
#define NULL 0
#else
#define NULL ((void *)0)
#endif
#endif
/****************************************************************************
*
* Debug Reporting
*
***************************************************************************/
typedef void *_HFILE; /* file handle pointer */
#define _CRT_WARN 0
#define _CRT_ERROR 1
#define _CRT_ASSERT 2
#define _CRT_ERRCNT 3
#define _CRTDBG_MODE_FILE 0x1
#define _CRTDBG_MODE_DEBUG 0x2
#define _CRTDBG_MODE_WNDW 0x4
#define _CRTDBG_REPORT_MODE -1
#define _CRTDBG_INVALID_HFILE ((_HFILE)-1)
#define _CRTDBG_HFILE_ERROR ((_HFILE)-2)
#define _CRTDBG_FILE_STDOUT ((_HFILE)-4)
#define _CRTDBG_FILE_STDERR ((_HFILE)-5)
#define _CRTDBG_REPORT_FILE ((_HFILE)-6)
typedef int (__cdecl * _CRT_REPORT_HOOK)(int, char *, int *);
#define _CRT_RPTHOOK_INSTALL 0
#define _CRT_RPTHOOK_REMOVE 1
/****************************************************************************
*
* Heap
*
***************************************************************************/
/****************************************************************************
*
* Client-defined allocation hook
*
***************************************************************************/
#define _HOOK_ALLOC 1
#define _HOOK_REALLOC 2
#define _HOOK_FREE 3
typedef int (__cdecl * _CRT_ALLOC_HOOK)(int, void *, size_t, int, long, const unsigned char *, int);
/****************************************************************************
*
* Memory management
*
***************************************************************************/
/*
* Bit values for _crtDbgFlag flag:
*
* These bitflags control debug heap behavior.
*/
#define _CRTDBG_ALLOC_MEM_DF 0x01 /* Turn on debug allocation */
#define _CRTDBG_DELAY_FREE_MEM_DF 0x02 /* Don't actually free memory */
#define _CRTDBG_CHECK_ALWAYS_DF 0x04 /* Check heap every alloc/dealloc */
#define _CRTDBG_RESERVED_DF 0x08 /* Reserved - do not use */
#define _CRTDBG_CHECK_CRT_DF 0x10 /* Leak check/diff CRT blocks */
#define _CRTDBG_LEAK_CHECK_DF 0x20 /* Leak check at program exit */
/*
* Some bit values for _crtDbgFlag which correspond to frequencies for checking
* the the heap.
*/
#define _CRTDBG_CHECK_EVERY_16_DF 0x00100000 /* check heap every 16 heap ops */
#define _CRTDBG_CHECK_EVERY_128_DF 0x00800000 /* check heap every 128 heap ops */
#define _CRTDBG_CHECK_EVERY_1024_DF 0x04000000 /* check heap every 1024 heap ops */
#define _CRTDBG_CHECK_DEFAULT_DF _CRTDBG_CHECK_EVERY_1024_DF
#define _CRTDBG_REPORT_FLAG -1 /* Query bitflag status */
#define _BLOCK_TYPE(block) (block & 0xFFFF)
#define _BLOCK_SUBTYPE(block) (block >> 16 & 0xFFFF)
/****************************************************************************
*
* Memory state
*
***************************************************************************/
/* Memory block identification */
#define _FREE_BLOCK 0
#define _NORMAL_BLOCK 1
#define _CRT_BLOCK 2
#define _IGNORE_BLOCK 3
#define _CLIENT_BLOCK 4
#define _MAX_BLOCKS 5
typedef void (__cdecl * _CRT_DUMP_CLIENT)(void *, size_t);
struct _CrtMemBlockHeader;
typedef struct _CrtMemState
{
struct _CrtMemBlockHeader * pBlockHeader;
size_t lCounts[_MAX_BLOCKS];
size_t lSizes[_MAX_BLOCKS];
size_t lHighWaterCount;
size_t lTotalCount;
} _CrtMemState;
/****************************************************************************
*
* Declarations, prototype and function-like macros
*
***************************************************************************/
#ifndef _DEBUG
/****************************************************************************
*
* Debug OFF
* Debug OFF
* Debug OFF
*
***************************************************************************/
#define _ASSERT(expr) ((void)0)
#define _ASSERTE(expr) ((void)0)
#define _RPT0(rptno, msg)
#define _RPT1(rptno, msg, arg1)
#define _RPT2(rptno, msg, arg1, arg2)
#define _RPT3(rptno, msg, arg1, arg2, arg3)
#define _RPT4(rptno, msg, arg1, arg2, arg3, arg4)
#define _RPTF0(rptno, msg)
#define _RPTF1(rptno, msg, arg1)
#define _RPTF2(rptno, msg, arg1, arg2)
#define _RPTF3(rptno, msg, arg1, arg2, arg3)
#define _RPTF4(rptno, msg, arg1, arg2, arg3, arg4)
#define _malloc_dbg(s, t, f, l) malloc(s)
#define _calloc_dbg(c, s, t, f, l) calloc(c, s)
#define _realloc_dbg(p, s, t, f, l) realloc(p, s)
#define _expand_dbg(p, s, t, f, l) _expand(p, s)
#define _free_dbg(p, t) free(p)
#define _msize_dbg(p, t) _msize(p)
#define _aligned_malloc_dbg(s, a, f, l) _aligned_malloc(s, a)
#define _aligned_realloc_dbg(p, s, a, f, l) _aligned_realloc(p, s, a)
#define _aligned_free_dbg(p) _aligned_free(p)
#define _aligned_offset_malloc_dbg(s, a, o, f, l) _aligned_offset_malloc(s, a, o)
#define _aligned_offset_realloc_dbg(p, s, a, o, f, l) _aligned_offset_realloc(p, s, a, o)
#define _CrtSetReportHook(f) ((_CRT_REPORT_HOOK)0)
#define _CrtSetReportHook2(t, f) ((int)0)
#define _CrtSetReportMode(t, f) ((int)0)
#define _CrtSetReportFile(t, f) ((_HFILE)0)
#define _CrtDbgBreak() ((void)0)
#define _CrtSetBreakAlloc(a) ((long)0)
#define _CrtSetAllocHook(f) ((_CRT_ALLOC_HOOK)0)
#define _CrtCheckMemory() ((int)1)
#define _CrtSetDbgFlag(f) ((int)0)
#define _CrtDoForAllClientObjects(f, c) ((void)0)
#define _CrtIsValidPointer(p, n, r) ((int)1)
#define _CrtIsValidHeapPointer(p) ((int)1)
#define _CrtIsMemoryBlock(p, t, r, f, l) ((int)1)
#define _CrtReportBlockType(p) ((int)-1)
#define _CrtSetDumpClient(f) ((_CRT_DUMP_CLIENT)0)
#define _CrtMemCheckpoint(s) ((void)0)
#define _CrtMemDifference(s1, s2, s3) ((int)0)
#define _CrtMemDumpAllObjectsSince(s) ((void)0)
#define _CrtMemDumpStatistics(s) ((void)0)
#define _CrtDumpMemoryLeaks() ((int)0)
#else /* _DEBUG */
/****************************************************************************
*
* Debug ON
* Debug ON
* Debug ON
*
***************************************************************************/
/* Define _CRTIMP */
#ifndef _CRTIMP
#ifdef CRTDLL
#define _CRTIMP __declspec(dllexport)
#else /* ndef CRTDLL */
#ifdef _DLL
#define _CRTIMP __declspec(dllimport)
#else /* ndef _DLL */
#define _CRTIMP
#endif /* _DLL */
#endif /* CRTDLL */
#endif /* _CRTIMP */
/****************************************************************************
*
* Debug Reporting
*
***************************************************************************/
#ifndef _INTERNAL_IFSTRIP_
#if defined(_DLL) && defined(_M_IX86)
/* Retained for compatibility with VC++ 5.0 and earlier versions */
_CRTIMP long * __cdecl __p__crtAssertBusy(void);
#endif
#endif /* _INTERNAL_IFSTRIP_ */
_CRTIMP extern long _crtAssertBusy;
_CRTIMP _CRT_REPORT_HOOK __cdecl _CrtSetReportHook(
_CRT_REPORT_HOOK
);
_CRTIMP int __cdecl _CrtSetReportHook2(
int,
_CRT_REPORT_HOOK
);
_CRTIMP int __cdecl _CrtSetReportMode(
int,
int
);
_CRTIMP _HFILE __cdecl _CrtSetReportFile(
int,
_HFILE
);
_CRTIMP int __cdecl _CrtDbgReport(
int,
const char *,
int,
const char *,
const char *,
...);
/* Asserts */
#if _MSC_VER >= 1300 || !defined(_M_IX86) || defined(_CRT_PORTABLE) /*IFSTRIP=IGN*/
#define _ASSERT_BASE(expr, msg) \
(void) ((expr) || \
(1 != _CrtDbgReport(_CRT_ASSERT, __FILE__, __LINE__, NULL, msg)) || \
(_CrtDbgBreak(), 0))
#else
#define _ASSERT_BASE(expr, msg) \
do { if (!(expr) && \
(1 == _CrtDbgReport(_CRT_ASSERT, __FILE__, __LINE__, NULL, msg))) \
_CrtDbgBreak(); } while (0)
#endif
#define _ASSERT(expr) _ASSERT_BASE((expr), NULL)
#define _ASSERTE(expr) _ASSERT_BASE((expr), #expr)
/* Reports with no file/line info */
#if _MSC_VER >= 1300 || !defined(_M_IX86) || defined(_CRT_PORTABLE) /*IFSTRIP=IGN*/
#define _RPT_BASE(args) \
(void) ((1 != _CrtDbgReport args) || \
(_CrtDbgBreak(), 0))
#else
#define _RPT_BASE(args) \
do { if ((1 == _CrtDbgReport args)) \
_CrtDbgBreak(); } while (0)
#endif
#define _RPT0(rptno, msg) \
_RPT_BASE((rptno, NULL, 0, NULL, "%s", msg))
#define _RPT1(rptno, msg, arg1) \
_RPT_BASE((rptno, NULL, 0, NULL, msg, arg1))
#define _RPT2(rptno, msg, arg1, arg2) \
_RPT_BASE((rptno, NULL, 0, NULL, msg, arg1, arg2))
#define _RPT3(rptno, msg, arg1, arg2, arg3) \
_RPT_BASE((rptno, NULL, 0, NULL, msg, arg1, arg2, arg3))
#define _RPT4(rptno, msg, arg1, arg2, arg3, arg4) \
_RPT_BASE((rptno, NULL, 0, NULL, msg, arg1, arg2, arg3, arg4))
/* Reports with file/line info */
#define _RPTF0(rptno, msg) \
_RPT_BASE((rptno, __FILE__, __LINE__, NULL, "%s", msg))
#define _RPTF1(rptno, msg, arg1) \
_RPT_BASE((rptno, __FILE__, __LINE__, NULL, msg, arg1))
#define _RPTF2(rptno, msg, arg1, arg2) \
_RPT_BASE((rptno, __FILE__, __LINE__, NULL, msg, arg1, arg2))
#define _RPTF3(rptno, msg, arg1, arg2, arg3) \
_RPT_BASE((rptno, __FILE__, __LINE__, NULL, msg, arg1, arg2, arg3))
#define _RPTF4(rptno, msg, arg1, arg2, arg3, arg4) \
_RPT_BASE((rptno, __FILE__, __LINE__, NULL, msg, arg1, arg2, arg3, arg4))
#if _MSC_VER >= 1300 && !defined(_CRT_PORTABLE) /*IFSTRIP=IGN*/
#define _CrtDbgBreak() __debugbreak()
#elif defined(_M_IX86) && !defined(_CRT_PORTABLE)
#define _CrtDbgBreak() __asm { int 3 }
#elif defined(_M_ALPHA) && !defined(_CRT_PORTABLE)
void _BPT();
#pragma intrinsic(_BPT)
#define _CrtDbgBreak() _BPT()
#elif defined(_M_IA64) && !defined(_CRT_PORTABLE)
void __break(int);
#pragma intrinsic (__break)
#define _CrtDbgBreak() __break(0x80016)
#else
_CRTIMP void __cdecl _CrtDbgBreak(
void
);
#endif
/****************************************************************************
*
* Heap routines
*
***************************************************************************/
#ifdef _CRTDBG_MAP_ALLOC
#define malloc(s) _malloc_dbg(s, _NORMAL_BLOCK, __FILE__, __LINE__)
#define calloc(c, s) _calloc_dbg(c, s, _NORMAL_BLOCK, __FILE__, __LINE__)
#define realloc(p, s) _realloc_dbg(p, s, _NORMAL_BLOCK, __FILE__, __LINE__)
#define _expand(p, s) _expand_dbg(p, s, _NORMAL_BLOCK, __FILE__, __LINE__)
#define free(p) _free_dbg(p, _NORMAL_BLOCK)
#define _msize(p) _msize_dbg(p, _NORMAL_BLOCK)
#define _aligned_malloc(s, a) _aligned_malloc_dbg(s, a, __FILE__, __LINE__)
#define _aligned_realloc(p, s, a) _aligned_realloc_dbg(p, s, a, __FILE__, __LINE__)
#define _aligned_offset_malloc(s, a, o) _aligned_offset_malloc_dbg(s, a, o, __FILE__, __LINE__)
#define _aligned_offset_realloc(p, s, a, o) _aligned_offset_realloc_dbg(p, s, a, o, __FILE__, __LINE__)
#define _aligned_free(p) _aligned_free_dbg(p)
#endif /* _CRTDBG_MAP_ALLOC */
#ifndef _INTERNAL_IFSTRIP_
#if defined(_DLL) && defined(_M_IX86)
/* Retained for compatibility with VC++ 5.0 and earlier versions */
_CRTIMP long * __cdecl __p__crtBreakAlloc(void);
#endif
#endif /* _INTERNAL_IFSTRIP_ */
_CRTIMP extern long _crtBreakAlloc; /* Break on this allocation */
_CRTIMP long __cdecl _CrtSetBreakAlloc(
long
);
/*
* Prototypes for malloc, free, realloc, etc are in malloc.h
*/
_CRTIMP void * __cdecl _malloc_dbg(
size_t,
int,
const char *,
int
);
_CRTIMP void * __cdecl _calloc_dbg(
size_t,
size_t,
int,
const char *,
int
);
_CRTIMP void * __cdecl _realloc_dbg(
void *,
size_t,
int,
const char *,
int
);
_CRTIMP void * __cdecl _expand_dbg(
void *,
size_t,
int,
const char *,
int
);
_CRTIMP void __cdecl _free_dbg(
void *,
int
);
_CRTIMP size_t __cdecl _msize_dbg (
void *,
int
);
_CRTIMP void * __cdecl _aligned_malloc_dbg(
size_t,
size_t,
const char *,
int
);
_CRTIMP void * __cdecl _aligned_realloc_dbg(
void *,
size_t,
size_t,
const char *,
int
);
_CRTIMP void * __cdecl _aligned_offset_malloc_dbg(
size_t,
size_t,
size_t,
const char *,
int
);
_CRTIMP void * __cdecl _aligned_offset_realloc_dbg(
void *,
size_t,
size_t,
size_t,
const char *,
int
);
_CRTIMP void __cdecl _aligned_free_dbg(
void *
);
/****************************************************************************
*
* Client-defined allocation hook
*
***************************************************************************/
_CRTIMP _CRT_ALLOC_HOOK __cdecl _CrtSetAllocHook(
_CRT_ALLOC_HOOK
);
/****************************************************************************
*
* Memory management
*
***************************************************************************/
/*
* Bitfield flag that controls CRT heap behavior
* Default setting is _CRTDBG_ALLOC_MEM_DF
*/
#ifndef _INTERNAL_IFSTRIP_
#if defined(_DLL) && defined(_M_IX86)
/* Retained for compatibility with VC++ 5.0 and earlier versions */
_CRTIMP int * __cdecl __p__crtDbgFlag(void);
#endif
#endif /* _INTERNAL_IFSTRIP_ */
_CRTIMP extern int _crtDbgFlag;
_CRTIMP int __cdecl _CrtCheckMemory(
void
);
_CRTIMP int __cdecl _CrtSetDbgFlag(
int
);
_CRTIMP void __cdecl _CrtDoForAllClientObjects(
void (*pfn)(void *, void *),
void *
);
_CRTIMP int __cdecl _CrtIsValidPointer(
const void *,
unsigned int,
int
);
_CRTIMP int __cdecl _CrtIsValidHeapPointer(
const void *
);
_CRTIMP int __cdecl _CrtIsMemoryBlock(
const void *,
unsigned int,
long *,
char **,
int *
);
_CRTIMP int __cdecl _CrtReportBlockType(
const void *
);
/****************************************************************************
*
* Memory state
*
***************************************************************************/
_CRTIMP _CRT_DUMP_CLIENT __cdecl _CrtSetDumpClient(
_CRT_DUMP_CLIENT
);
_CRTIMP void __cdecl _CrtMemCheckpoint(
_CrtMemState *
);
_CRTIMP int __cdecl _CrtMemDifference(
_CrtMemState *,
const _CrtMemState *,
const _CrtMemState *
);
_CRTIMP void __cdecl _CrtMemDumpAllObjectsSince(
const _CrtMemState *
);
_CRTIMP void __cdecl _CrtMemDumpStatistics(
const _CrtMemState *
);
_CRTIMP int __cdecl _CrtDumpMemoryLeaks(
void
);
#endif /* _DEBUG */
#ifdef __cplusplus
}
#ifndef _MFC_OVERRIDES_NEW
extern "C++" {
#pragma warning(disable: 4507) /* Ignore faulty warning */
#ifndef _DEBUG
/****************************************************************************
*
* Debug OFF
* Debug OFF
* Debug OFF
*
***************************************************************************/
void * __cdecl operator new[](size_t);
inline void * __cdecl operator new(size_t s, int, const char *, int)
{ return ::operator new(s); }
inline void* __cdecl operator new[](size_t s, int, const char *, int)
{ return ::operator new[](s); }
#if _MSC_VER >= 1200 /*IFSTRIP=IGN*/
void __cdecl operator delete[](void *);
inline void __cdecl operator delete(void * _P, int, const char *, int)
{ ::operator delete(_P); }
inline void __cdecl operator delete[](void * _P, int, const char *, int)
{ ::operator delete[](_P); }
#endif
#else /* _DEBUG */
/****************************************************************************
*
* Debug ON
* Debug ON
* Debug ON
*
***************************************************************************/
void * __cdecl operator new[](size_t);
void * __cdecl operator new(
size_t,
int,
const char *,
int
);
void * __cdecl operator new[](
size_t,
int,
const char *,
int
);
#if _MSC_VER >= 1200 /*IFSTRIP=IGN*/
void __cdecl operator delete[](void *);
inline void __cdecl operator delete(void * _P, int, const char *, int)
{ ::operator delete(_P); }
inline void __cdecl operator delete[](void * _P, int, const char *, int)
{ ::operator delete[](_P); }
#endif
#ifdef _CRTDBG_MAP_ALLOC
inline void * __cdecl operator new(size_t s)
{ return ::operator new(s, _NORMAL_BLOCK, __FILE__, __LINE__); }
inline void* __cdecl operator new[](size_t s)
{ return ::operator new[](s, _NORMAL_BLOCK, __FILE__, __LINE__); }
#endif /* _CRTDBG_MAP_ALLOC */
#endif /* _DEBUG */
}
#endif /* _MFC_OVERRIDES_NEW */
#endif /* __cplusplus */
#endif /* _INC_CRTDBG */