You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
852 lines
31 KiB
852 lines
31 KiB
//===== Copyright (c) Valve Corporation, All rights reserved. ========//
|
|
//
|
|
// Purpose:
|
|
//
|
|
// $NoKeywords: $
|
|
//
|
|
//====================================================================//
|
|
#ifndef DBG_H
|
|
#define DBG_H
|
|
|
|
#if !defined(__SPU__)
|
|
|
|
|
|
#ifdef _WIN32
|
|
#pragma once
|
|
#endif
|
|
|
|
#include "tier0/platform.h"
|
|
#include "tier0/basetypes.h"
|
|
#include "dbgflag.h"
|
|
#include "logging.h"
|
|
#include <math.h>
|
|
#include <stdio.h>
|
|
#include <stdarg.h>
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// dll export stuff
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#ifdef TIER0_DLL_EXPORT
|
|
#define DBG_INTERFACE DLL_EXPORT
|
|
#define DBG_OVERLOAD DLL_GLOBAL_EXPORT
|
|
#define DBG_CLASS DLL_CLASS_EXPORT
|
|
#else
|
|
#define DBG_INTERFACE DLL_IMPORT
|
|
#define DBG_OVERLOAD DLL_GLOBAL_IMPORT
|
|
#define DBG_CLASS DLL_CLASS_IMPORT
|
|
#endif
|
|
|
|
class Color;
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Usage model for the Dbg library
|
|
//
|
|
// 1. Assertions.
|
|
//
|
|
// Assertions are used to detect and warn about invalid states
|
|
//
|
|
// To use an assertion, use
|
|
//
|
|
// Assert( (f == 5) );
|
|
// AssertMsg( (f == 5), ("F needs to be %d here!\n", 5) );
|
|
// AssertFunc( (f == 5), BadFunc() );
|
|
// AssertEquals( f, 5 );
|
|
// AssertFloatEquals( f, 5.0f, 1e-3 );
|
|
//
|
|
// The first will simply report that an assertion failed on a particular
|
|
// code file and line. The second version will display a print-f formatted message
|
|
// along with the file and line, the third will display a generic message and
|
|
// will also cause the function BadFunc to be executed, and the last two
|
|
// will report an error if f is not equal to 5 (the last one asserts within
|
|
// a particular tolerance).
|
|
//
|
|
// 2. Code activation
|
|
//
|
|
// To cause code to be run only in debug builds, use DBG_CODE:
|
|
// An example is below.
|
|
//
|
|
// DBG_CODE(
|
|
// {
|
|
// int x = 5;
|
|
// ++x;
|
|
// }
|
|
// );
|
|
//
|
|
// Code can be activated based on the dynamic spew groups also. Use
|
|
//
|
|
// DBG_DCODE( "group", level,
|
|
// { int x = 5; ++x; }
|
|
// );
|
|
//
|
|
// 3. Breaking into the debugger.
|
|
//
|
|
// To cause an unconditional break into the debugger in debug builds only, use DBG_BREAK
|
|
//
|
|
// DBG_BREAK();
|
|
//
|
|
// You can force a break in any build (release or debug) using
|
|
//
|
|
// DebuggerBreak();
|
|
//-----------------------------------------------------------------------------
|
|
|
|
PLATFORM_INTERFACE void _ExitOnFatalAssert( const tchar* pFile, int line );
|
|
|
|
#if defined( DBGFLAG_STRINGS_STRIP )
|
|
#define DbgFlagMacro_ExitOnFatalAssert( pFile, line ) _ExitOnFatalAssert( "", 0 )
|
|
#else
|
|
#define DbgFlagMacro_ExitOnFatalAssert( pFile, line ) _ExitOnFatalAssert( pFile, line )
|
|
#endif
|
|
|
|
PLATFORM_INTERFACE bool ShouldUseNewAssertDialog();
|
|
|
|
PLATFORM_INTERFACE bool SetupWin32ConsoleIO();
|
|
|
|
// Returns true if they want to break in the debugger.
|
|
PLATFORM_INTERFACE bool DoNewAssertDialog( const tchar *pFile, int line, const tchar *pExpression );
|
|
|
|
#if defined( DBGFLAG_STRINGS_STRIP )
|
|
#define DbgFlagMacro_DoNewAssertDialog( pFile, line, pExpression ) DoNewAssertDialog( "", 0, "" )
|
|
#else
|
|
#define DbgFlagMacro_DoNewAssertDialog( pFile, line, pExpression ) DoNewAssertDialog( pFile, line, pExpression )
|
|
#endif
|
|
|
|
// Allows the assert dialogs to be turned off from code
|
|
PLATFORM_INTERFACE bool AreAllAssertsDisabled();
|
|
PLATFORM_INTERFACE void SetAllAssertsDisabled( bool bAssertsEnabled );
|
|
|
|
PLATFORM_INTERFACE bool IsAssertDialogDisabled();
|
|
PLATFORM_INTERFACE void SetAssertDialogDisabled( bool bAssertDialogDisabled );
|
|
|
|
// Provides a callback that is called on asserts regardless of spew levels
|
|
typedef void (*AssertFailedNotifyFunc_t)( const char *pchFile, int nLine, const char *pchMessage );
|
|
PLATFORM_INTERFACE void SetAssertFailedNotifyFunc( AssertFailedNotifyFunc_t func );
|
|
PLATFORM_INTERFACE void CallAssertFailedNotifyFunc( const char *pchFile, int nLine, const char *pchMessage );
|
|
|
|
#if defined( LINUX )
|
|
PLATFORM_INTERFACE void SetAssertDialogParent( struct SDL_Window *window );
|
|
PLATFORM_INTERFACE struct SDL_Window * GetAssertDialogParent();
|
|
#endif
|
|
|
|
/* Used to define macros, never use these directly. */
|
|
|
|
#ifdef _PREFAST_
|
|
// When doing /analyze builds define _AssertMsg to be __analysis_assume. This tells
|
|
// the compiler to assume that the condition is true, which helps to suppress many
|
|
// warnings. This define is done in debug and release builds.
|
|
// The unfortunate !! is necessary because otherwise /analyze is incapable of evaluating
|
|
// all of the logical expressions that the regular compiler can handle.
|
|
// Include _msg in the macro so that format errors in it are detected.
|
|
#define _AssertMsg( _exp, _msg, _executeExp, _bFatal ) do { __analysis_assume( !!(_exp) ); _msg; } while (0)
|
|
#define _AssertMsgOnce( _exp, _msg, _bFatal ) do { __analysis_assume( !!(_exp) ); _msg; } while (0)
|
|
// Force asserts on for /analyze so that we get a __analysis_assume of all of the constraints.
|
|
#define DBGFLAG_ASSERT
|
|
#define DBGFLAG_ASSERTFATAL
|
|
#define DBGFLAG_ASSERTDEBUG
|
|
|
|
// Define the Q_ASSERT macro to override the QT assert macro so that its asserts
|
|
// suppress warnings instead of causing them.
|
|
#define Q_ASSERT( _exp ) _AssertMsg( _exp, _T("Assertion Failed: ") _T(#_exp), ((void)0), false )
|
|
#else
|
|
#define _AssertMsg( _exp, _msg, _executeExp, _bFatal ) \
|
|
do { \
|
|
if (!(_exp)) \
|
|
{ \
|
|
LoggingResponse_t ret = Log_Assert( "%s (%d) : %s\n", __TFILE__, __LINE__, static_cast<const char*>( _msg ) ); \
|
|
CallAssertFailedNotifyFunc( __TFILE__, __LINE__, _msg ); \
|
|
_executeExp; \
|
|
if ( ret == LR_DEBUGGER ) \
|
|
{ \
|
|
if ( ShouldUseNewAssertDialog() ) \
|
|
{ \
|
|
if ( DbgFlagMacro_DoNewAssertDialog( __TFILE__, __LINE__, _msg ) ) \
|
|
DebuggerBreak(); \
|
|
} \
|
|
if ( _bFatal ) \
|
|
DbgFlagMacro_ExitOnFatalAssert( __TFILE__, __LINE__ ); \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
|
|
#define _AssertMsgOnce( _exp, _msg, _bFatal ) \
|
|
do { \
|
|
static bool fAsserted; \
|
|
if (!fAsserted ) \
|
|
{ \
|
|
_AssertMsg( _exp, _msg, (fAsserted = true), _bFatal ); \
|
|
} \
|
|
} while (0)
|
|
#endif
|
|
|
|
/* Spew macros... */
|
|
|
|
// AssertFatal macros
|
|
// AssertFatal is used to detect an unrecoverable error condition.
|
|
// If enabled, it may display an assert dialog (if DBGFLAG_ASSERTDLG is turned on or running under the debugger),
|
|
// and always terminates the application
|
|
|
|
#ifdef DBGFLAG_ASSERTFATAL
|
|
|
|
#define AssertFatal( _exp ) _AssertMsg( _exp, _T("Assertion Failed: ") _T(#_exp), ((void)0), true )
|
|
#define AssertFatalOnce( _exp ) _AssertMsgOnce( _exp, _T("Assertion Failed: ") _T(#_exp), true )
|
|
#define AssertFatalMsg( _exp, _msg ) _AssertMsg( _exp, _msg, ((void)0), true )
|
|
#define AssertFatalMsgOnce( _exp, _msg ) _AssertMsgOnce( _exp, _msg, true )
|
|
#define AssertFatalFunc( _exp, _f ) _AssertMsg( _exp, _T("Assertion Failed: " _T(#_exp), _f, true )
|
|
#define AssertFatalEquals( _exp, _expectedValue ) AssertFatalMsg2( (_exp) == (_expectedValue), _T("Expected %d but got %d!"), (_expectedValue), (_exp) )
|
|
#define AssertFatalFloatEquals( _exp, _expectedValue, _tol ) AssertFatalMsg2( fabs((_exp) - (_expectedValue)) <= (_tol), _T("Expected %f but got %f!"), (_expectedValue), (_exp) )
|
|
#define VerifyFatal( _exp ) AssertFatal( _exp )
|
|
#define VerifyEqualsFatal( _exp, _expectedValue ) AssertFatalEquals( _exp, _expectedValue )
|
|
#define DbgVerifyFatal( _exp ) AssertFatal( _exp )
|
|
|
|
#define AssertFatalMsg1( _exp, _msg, a1 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1 )))
|
|
#define AssertFatalMsg2( _exp, _msg, a1, a2 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2 )))
|
|
#define AssertFatalMsg3( _exp, _msg, a1, a2, a3 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3 )))
|
|
#define AssertFatalMsg4( _exp, _msg, a1, a2, a3, a4 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4 )))
|
|
#define AssertFatalMsg5( _exp, _msg, a1, a2, a3, a4, a5 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4, a5 )))
|
|
#define AssertFatalMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4, a5, a6 )))
|
|
#define AssertFatalMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4, a5, a6 )))
|
|
#define AssertFatalMsg7( _exp, _msg, a1, a2, a3, a4, a5, a6, a7 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4, a5, a6, a7 )))
|
|
#define AssertFatalMsg8( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4, a5, a6, a7, a8 )))
|
|
#define AssertFatalMsg9( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 ) AssertFatalMsg( _exp, (const tchar *)(CDbgFmtMsg( _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 )))
|
|
|
|
#else // DBGFLAG_ASSERTFATAL
|
|
|
|
#define AssertFatal( _exp ) ((void)0)
|
|
#define AssertFatalOnce( _exp ) ((void)0)
|
|
#define AssertFatalMsg( _exp, _msg ) ((void)0)
|
|
#define AssertFatalMsgOnce( _exp, _msg ) ((void)0)
|
|
#define AssertFatalFunc( _exp, _f ) ((void)0)
|
|
#define AssertFatalEquals( _exp, _expectedValue ) ((void)0)
|
|
#define AssertFatalFloatEquals( _exp, _expectedValue, _tol ) ((void)0)
|
|
#define VerifyFatal( _exp ) (_exp)
|
|
#define VerifyEqualsFatal( _exp, _expectedValue ) (_exp)
|
|
#define DbgVerifyFatal( _exp ) (_exp)
|
|
|
|
#define AssertFatalMsg1( _exp, _msg, a1 ) ((void)0)
|
|
#define AssertFatalMsg2( _exp, _msg, a1, a2 ) ((void)0)
|
|
#define AssertFatalMsg3( _exp, _msg, a1, a2, a3 ) ((void)0)
|
|
#define AssertFatalMsg4( _exp, _msg, a1, a2, a3, a4 ) ((void)0)
|
|
#define AssertFatalMsg5( _exp, _msg, a1, a2, a3, a4, a5 ) ((void)0)
|
|
#define AssertFatalMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertFatalMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertFatalMsg7( _exp, _msg, a1, a2, a3, a4, a5, a6, a7 ) ((void)0)
|
|
#define AssertFatalMsg8( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8 ) ((void)0)
|
|
#define AssertFatalMsg9( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 ) ((void)0)
|
|
|
|
#endif // DBGFLAG_ASSERTFATAL
|
|
|
|
// lightweight assert macros: in theory, can be run in release without slowing it down
|
|
#if defined(_CERT) || defined(_RETAIL)
|
|
#define AssertAligned(PTR)
|
|
#define AssertAlignedWidth(PTR, width)
|
|
#define AssertAlignedConsole(PTR)
|
|
#else
|
|
# if defined( _X360 )
|
|
# define AssertAlignedWidth( PTR, width ) __twnei( intp(PTR) & ( width - 1 ), 0 ) // trap if not equal to immediate value (from width mask); unsigned comparison
|
|
# define AssertAligned( PTR ) AssertAlignedWidth( PTR, 16 ) // Call above with 16 width defined
|
|
# define AssertAlignedConsole( PTR ) AssertAlignedWidth( PTR, 4 ) // Call above with 4 width defined (xbox only for now)
|
|
# elif defined( DBGFLAG_ASSERT )
|
|
# define AssertAlignedWidth( adr, width ) Assert( ( ( ( intp ) ( adr ) ) & ( width - 1 ) ) == 0 )
|
|
# define AssertAligned( adr ) AssertAlignedWidth( adr, 16 )
|
|
# define AssertAlignedConsole(adr) // XBox only for now.
|
|
# else
|
|
# define AssertAlignedWidth(PTR, width)
|
|
# define AssertAligned(PTR)
|
|
# define AssertAlignedConsole(PTR)
|
|
# endif
|
|
#endif
|
|
|
|
// Assert macros
|
|
// Assert is used to detect an important but survivable error.
|
|
// It's only turned on when DBGFLAG_ASSERT is true.
|
|
|
|
#ifdef DBGFLAG_ASSERT
|
|
|
|
#define Assert( _exp ) _AssertMsg( _exp, _T("Assertion Failed: ") _T(#_exp), ((void)0), false )
|
|
#define AssertMsg_( _exp, _msg ) _AssertMsg( _exp, _msg, ((void)0), false )
|
|
#define AssertOnce( _exp ) _AssertMsgOnce( _exp, _T("Assertion Failed: ") _T(#_exp), false )
|
|
#define AssertMsgOnce( _exp, _msg ) _AssertMsgOnce( _exp, _msg, false )
|
|
#define AssertFunc( _exp, _f ) _AssertMsg( _exp, _T("Assertion Failed: ") _T(#_exp), _f, false )
|
|
#define AssertEquals( _exp, _expectedValue ) AssertMsg2( (_exp) == (_expectedValue), _T("Expected %d but got %d!"), (_expectedValue), (_exp) )
|
|
#define AssertFloatEquals( _exp, _expectedValue, _tol ) AssertMsg2( fabs((_exp) - (_expectedValue)) <= (_tol), _T("Expected %f but got %f!"), (_expectedValue), (_exp) )
|
|
#define Verify( _exp ) ( _exp )
|
|
#define VerifyEquals( _exp, _expectedValue ) AssertEquals( _exp, _expectedValue )
|
|
#ifndef DbgVerify
|
|
#define DbgVerify( _exp ) Assert( _exp )
|
|
#endif
|
|
|
|
#ifdef _DEBUG
|
|
#define DbgAssert( _exp ) Assert( _exp )
|
|
#else
|
|
#define DbgAssert( _exp ) ((void)0)
|
|
#endif
|
|
|
|
#ifdef _DEBUG
|
|
#define DbgAssert( _exp ) Assert( _exp )
|
|
#else
|
|
#define DbgAssert( _exp ) ((void)0)
|
|
#endif
|
|
|
|
#define AssertMsg( _exp, _msg ) AssertMsg_( _exp, _T( _msg ) )
|
|
#define AssertMsg1( _exp, _msg, a1 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1 )) )
|
|
#define AssertMsg2( _exp, _msg, a1, a2 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2 )) )
|
|
#define AssertMsg3( _exp, _msg, a1, a2, a3 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3 )) )
|
|
#define AssertMsg4( _exp, _msg, a1, a2, a3, a4 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3, a4 )) )
|
|
#define AssertMsg5( _exp, _msg, a1, a2, a3, a4, a5 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3, a4, a5 )) )
|
|
#define AssertMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3, a4, a5, a6 )) )
|
|
#define AssertMsg7( _exp, _msg, a1, a2, a3, a4, a5, a6, a7 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3, a4, a5, a6, a7 )) )
|
|
#define AssertMsg8( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3, a4, a5, a6, a7, a8 )) )
|
|
#define AssertMsg9( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 ) AssertMsg_( _exp, (const tchar *)(CDbgFmtMsg( _T( _msg ), a1, a2, a3, a4, a5, a6, a7, a8, a9 )) )
|
|
|
|
#else // DBGFLAG_ASSERT
|
|
|
|
#define Assert( _exp ) ((void)0)
|
|
#define AssertOnce( _exp ) ((void)0)
|
|
#define AssertMsg( _exp, _msg ) ((void)0)
|
|
#define AssertMsgOnce( _exp, _msg ) ((void)0)
|
|
#define AssertFunc( _exp, _f ) ((void)0)
|
|
#define AssertEquals( _exp, _expectedValue ) ((void)0)
|
|
#define AssertFloatEquals( _exp, _expectedValue, _tol ) ((void)0)
|
|
#define Verify( _exp ) (_exp)
|
|
#define VerifyEquals( _exp, _expectedValue ) (_exp)
|
|
#ifndef DbgVerify
|
|
#define DbgVerify( _exp ) (_exp)
|
|
#endif
|
|
#define DbgAssert( _exp ) ((void)0)
|
|
|
|
#define AssertMsg1( _exp, _msg, a1 ) ((void)0)
|
|
#define AssertMsg2( _exp, _msg, a1, a2 ) ((void)0)
|
|
#define AssertMsg3( _exp, _msg, a1, a2, a3 ) ((void)0)
|
|
#define AssertMsg4( _exp, _msg, a1, a2, a3, a4 ) ((void)0)
|
|
#define AssertMsg5( _exp, _msg, a1, a2, a3, a4, a5 ) ((void)0)
|
|
#define AssertMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertMsg7( _exp, _msg, a1, a2, a3, a4, a5, a6, a7 ) ((void)0)
|
|
#define AssertMsg8( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8 ) ((void)0)
|
|
#define AssertMsg9( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 ) ((void)0)
|
|
|
|
#endif // DBGFLAG_ASSERT
|
|
|
|
// Source2 compatibility macro
|
|
#define AssertDbg( X ) DbgAssert( X )
|
|
|
|
|
|
// Use AssertAnalyze when the main purpose is to work around /analyze bugs by
|
|
// telling the compiler that a condition is impossible. If DBGFLAG_ASSERT is set
|
|
// then these will still be Asserts (just in case). The use of a different macro
|
|
// is in order to indicate their purpose.
|
|
#define AssertAnalyze( _exp ) Assert( _exp )
|
|
#define STRINGIFY_INTERNAL(x) #x
|
|
#define STRINGIFY(x) STRINGIFY_INTERNAL(x)
|
|
|
|
// The Always version of the assert macros are defined even when DBGFLAG_ASSERT is not,
|
|
// so they will be available even in release.
|
|
#define AssertAlways( _exp ) _AssertMsg( _exp, _T("Assertion Failed: ") _T(#_exp), ((void)0), false )
|
|
#define AssertMsgAlways( _exp, _msg ) _AssertMsg( _exp, _msg, ((void)0), false )
|
|
|
|
|
|
#define FILE_LINE_FUNCTION_STRING __FILE__ "(" STRINGIFY(__LINE__) "):" __FUNCTION__ ":"
|
|
#define FILE_LINE_STRING __FILE__ "(" STRINGIFY(__LINE__) "):"
|
|
#define FUNCTION_LINE_STRING __FUNCTION__ "(" STRINGIFY(__LINE__) "): "
|
|
|
|
|
|
// Handy define for inserting clickable messages into the build output.
|
|
// Use like this:
|
|
// #pragma MESSAGE("Some message")
|
|
#define MESSAGE(msg) message(__FILE__ "(" FUNCTION_LINE_TOSTRING(__LINE__) "): " msg)
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
// Legacy Logging System
|
|
//////////////////////////////////////////////////////////////////////////
|
|
|
|
// Channels which map the legacy logging system to the new system.
|
|
|
|
// Channel for all default Msg/Warning/Error commands.
|
|
PLATFORM_INTERFACE LoggingChannelID_t LOG_GENERAL;
|
|
|
|
// Channel for all asserts.
|
|
DECLARE_LOGGING_CHANNEL( LOG_ASSERT );
|
|
// Channel for all ConMsg and ConColorMsg commands.
|
|
DECLARE_LOGGING_CHANNEL( LOG_CONSOLE );
|
|
// Channel for all DevMsg and DevWarning commands with level < 2.
|
|
DECLARE_LOGGING_CHANNEL( LOG_DEVELOPER );
|
|
// Channel for ConDMsg commands.
|
|
DECLARE_LOGGING_CHANNEL( LOG_DEVELOPER_CONSOLE );
|
|
// Channel for all DevMsg and DevWarning commands with level >= 2.
|
|
DECLARE_LOGGING_CHANNEL( LOG_DEVELOPER_VERBOSE );
|
|
|
|
// Legacy logging functions
|
|
|
|
// These functions do not return.
|
|
PLATFORM_INTERFACE void Error( PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
PLATFORM_INTERFACE void Error_SpewCallStack( int iMaxCallStackLength, PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
#define Plat_FatalError( ... ) do { Log_Error( LOG_GENERAL, ##__VA_ARGS__ ); Plat_ExitProcess( EXIT_FAILURE ); } while( 0 )
|
|
|
|
#if defined( DBGFLAG_STRINGS_STRIP )
|
|
|
|
#define Msg( ... ) ((void)0)
|
|
#define Warning( ... ) ((void)0)
|
|
#define Warning_SpewCallStack( ... ) ((void)0)
|
|
#define DevMsg( ... ) ((void)0)
|
|
#define DevWarning( ... ) ((void)0)
|
|
#define ConColorMsg( ... ) ((void)0)
|
|
#define ConMsg( ... ) ((void)0)
|
|
#define ConDMsg( ... ) ((void)0)
|
|
#define COM_TimestampedLog( ... ) ((void)0)
|
|
|
|
#else // DBGFLAG_STRINGS_STRIP
|
|
|
|
PLATFORM_INTERFACE void Msg( PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
PLATFORM_INTERFACE void Warning( PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
PLATFORM_INTERFACE void Warning_SpewCallStack( int iMaxCallStackLength, PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
|
|
#ifdef _PS3
|
|
|
|
PLATFORM_OVERLOAD void DevMsg( int level, PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
PLATFORM_OVERLOAD void DevWarning( int level, PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
|
|
PLATFORM_INTERFACE void DevMsg( PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
PLATFORM_INTERFACE void DevWarning( PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
|
|
PLATFORM_INTERFACE void ConColorMsg( const Color& clr, PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
PLATFORM_INTERFACE void ConMsg( PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
|
|
#else // !_PS3
|
|
|
|
PLATFORM_INTERFACE void DevMsg( int level, PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
PLATFORM_INTERFACE void DevWarning( int level, PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
|
|
PLATFORM_OVERLOAD void DevMsg( PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
PLATFORM_OVERLOAD void DevWarning( PRINTF_FORMAT_STRING const tchar *pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
|
|
PLATFORM_OVERLOAD void ConColorMsg( const Color& clr, PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 2, 3 );
|
|
PLATFORM_OVERLOAD void ConMsg( PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
|
|
#endif // _PS3
|
|
|
|
PLATFORM_INTERFACE void ConDMsg( PRINTF_FORMAT_STRING const tchar* pMsg, ... ) FMTFUNCTION( 1, 2 );
|
|
|
|
PLATFORM_INTERFACE void COM_TimestampedLog( PRINTF_FORMAT_STRING char const *fmt, ... ) FMTFUNCTION( 1, 2 );
|
|
|
|
#endif // DBGFLAG_STRINGS_STRIP
|
|
|
|
// You can use this macro like a runtime assert macro.
|
|
// If the condition fails, then Error is called with the message. This macro is called
|
|
// like AssertMsg, where msg must be enclosed in parenthesis:
|
|
//
|
|
// ErrorIfNot( bCondition, ("a b c %d %d %d", 1, 2, 3) );
|
|
#define ErrorIfNot( condition, msg ) \
|
|
if ( (condition) ) \
|
|
; \
|
|
else \
|
|
{ \
|
|
Error msg; \
|
|
}
|
|
|
|
#ifdef _DEBUG
|
|
#define DebugMsg(...) DevMsg(__VA_ARGS__)
|
|
#else
|
|
#define DebugMsg(...)
|
|
#endif
|
|
|
|
// @TODO: these callstack spew functions are currently disabled in the new logging system. Need to add support for these if desired.
|
|
PLATFORM_INTERFACE void _Warning_AlwaysSpewCallStack_Enable( bool bEnable );
|
|
PLATFORM_INTERFACE void _Warning_AlwaysSpewCallStack_Length( int iMaxCallStackLength );
|
|
|
|
PLATFORM_INTERFACE void _Error_AlwaysSpewCallStack_Enable( bool bEnable );
|
|
PLATFORM_INTERFACE void _Error_AlwaysSpewCallStack_Length( int iMaxCallStackLength );
|
|
|
|
|
|
/* Code macros, debugger interface */
|
|
|
|
#ifdef _DEBUG
|
|
|
|
#define DBG_CODE( _code ) if (0) ; else { _code }
|
|
#define DBG_CODE_NOSCOPE( _code ) _code
|
|
#define DBG_DCODE( _g, _l, _code ) if (IsSpewActive( _g, _l )) { _code } else {}
|
|
#define DBG_BREAK() DebuggerBreak() /* defined in platform.h */
|
|
|
|
#else /* not _DEBUG */
|
|
|
|
#define DBG_CODE( _code ) ((void)0)
|
|
#define DBG_CODE_NOSCOPE( _code )
|
|
#define DBG_DCODE( _g, _l, _code ) ((void)0)
|
|
#define DBG_BREAK() ((void)0)
|
|
|
|
#endif /* _DEBUG */
|
|
|
|
|
|
#ifdef _DEBUG
|
|
template<typename DEST_POINTER_TYPE, typename SOURCE_POINTER_TYPE>
|
|
inline DEST_POINTER_TYPE assert_cast(SOURCE_POINTER_TYPE* pSource)
|
|
{
|
|
Assert( static_cast<DEST_POINTER_TYPE>(pSource) == dynamic_cast<DEST_POINTER_TYPE>(pSource) );
|
|
return static_cast<DEST_POINTER_TYPE>(pSource);
|
|
}
|
|
#else
|
|
#define assert_cast static_cast
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Templates to assist in validating pointers:
|
|
|
|
// Have to use these stubs so we don't have to include windows.h here.
|
|
PLATFORM_INTERFACE void _AssertValidReadPtr( void* ptr, int count = 1 );
|
|
PLATFORM_INTERFACE void _AssertValidWritePtr( void* ptr, int count = 1 );
|
|
PLATFORM_INTERFACE void _AssertValidReadWritePtr( void* ptr, int count = 1 );
|
|
PLATFORM_INTERFACE void _AssertValidStringPtr( const tchar* ptr, int maxchar );
|
|
|
|
#ifdef DBGFLAG_ASSERT
|
|
inline void AssertValidStringPtr( const tchar* ptr, int maxchar = 0xFFFFFF ) { _AssertValidStringPtr( ptr, maxchar ); }
|
|
template<class T> inline void AssertValidReadPtr( T* ptr, int count = 1 ) { _AssertValidReadPtr( (void*)ptr, count ); }
|
|
template<class T> inline void AssertValidWritePtr( T* ptr, int count = 1 ) { _AssertValidWritePtr( (void*)ptr, count ); }
|
|
template<class T> inline void AssertValidReadWritePtr( T* ptr, int count = 1 ) { _AssertValidReadWritePtr( (void*)ptr, count ); }
|
|
#define AssertValidThis() AssertValidReadWritePtr(this,sizeof(*this))
|
|
|
|
#else
|
|
|
|
inline void AssertValidStringPtr( const tchar* ptr, int maxchar = 0xFFFFFF ) { }
|
|
template<class T> inline void AssertValidReadPtr( T* ptr, int count = 1 ) { }
|
|
template<class T> inline void AssertValidWritePtr( T* ptr, int count = 1 ) { }
|
|
template<class T> inline void AssertValidReadWritePtr( T* ptr, int count = 1 ) { }
|
|
#define AssertValidThis()
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Macro to protect functions that are not reentrant
|
|
|
|
#ifdef _DEBUG
|
|
class CReentryGuard
|
|
{
|
|
public:
|
|
CReentryGuard(int *pSemaphore)
|
|
: m_pSemaphore(pSemaphore)
|
|
{
|
|
++(*m_pSemaphore);
|
|
}
|
|
|
|
~CReentryGuard()
|
|
{
|
|
--(*m_pSemaphore);
|
|
}
|
|
|
|
private:
|
|
int *m_pSemaphore;
|
|
};
|
|
|
|
#define ASSERT_NO_REENTRY() \
|
|
static int fSemaphore##__LINE__; \
|
|
Assert( !fSemaphore##__LINE__ ); \
|
|
CReentryGuard ReentryGuard##__LINE__( &fSemaphore##__LINE__ )
|
|
#else
|
|
#define ASSERT_NO_REENTRY()
|
|
#endif
|
|
|
|
// Tier0 uses these for string functions since this abstraction is normally done in tier1.
|
|
#ifdef POSIX
|
|
#define Tier0Internal_sntprintf snprintf
|
|
#define Tier0Internal_vsntprintf vsnprintf
|
|
#define Tier0Internal_vsnprintf vsnprintf
|
|
#else
|
|
#define Tier0Internal_sntprintf _sntprintf
|
|
#define Tier0Internal_vsntprintf _vsntprintf
|
|
#define Tier0Internal_vsnprintf _vsnprintf
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
//
|
|
// Purpose: Inline string formatter
|
|
//
|
|
|
|
#include "tier0/valve_off.h"
|
|
class CDbgFmtMsg
|
|
{
|
|
public:
|
|
CDbgFmtMsg(PRINTF_FORMAT_STRING const tchar *pszFormat, ...)
|
|
{
|
|
va_list arg_ptr;
|
|
|
|
va_start(arg_ptr, pszFormat);
|
|
Tier0Internal_vsntprintf(m_szBuf, sizeof(m_szBuf)-1, pszFormat, arg_ptr);
|
|
va_end(arg_ptr);
|
|
|
|
m_szBuf[sizeof(m_szBuf)-1] = 0;
|
|
}
|
|
|
|
operator const tchar *() const
|
|
{
|
|
return m_szBuf;
|
|
}
|
|
|
|
private:
|
|
tchar m_szBuf[256];
|
|
};
|
|
#include "tier0/valve_on.h"
|
|
|
|
//-----------------------------------------------------------------------------
|
|
//
|
|
// Purpose: Embed debug info in each file.
|
|
//
|
|
#if defined( _WIN32 ) && !defined( _X360 )
|
|
|
|
#ifdef _DEBUG
|
|
#pragma comment(compiler)
|
|
#endif
|
|
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
//
|
|
// Purpose: Wrap around a variable to create a simple place to put a breakpoint
|
|
//
|
|
|
|
#ifdef _DEBUG
|
|
|
|
template< class Type >
|
|
class CDataWatcher
|
|
{
|
|
public:
|
|
const Type& operator=( const Type &val )
|
|
{
|
|
return Set( val );
|
|
}
|
|
|
|
const Type& operator=( const CDataWatcher<Type> &val )
|
|
{
|
|
return Set( val.m_Value );
|
|
}
|
|
|
|
const Type& Set( const Type &val )
|
|
{
|
|
// Put your breakpoint here
|
|
m_Value = val;
|
|
return m_Value;
|
|
}
|
|
|
|
Type& GetForModify()
|
|
{
|
|
return m_Value;
|
|
}
|
|
|
|
const Type& operator+=( const Type &val )
|
|
{
|
|
return Set( m_Value + val );
|
|
}
|
|
|
|
const Type& operator-=( const Type &val )
|
|
{
|
|
return Set( m_Value - val );
|
|
}
|
|
|
|
const Type& operator/=( const Type &val )
|
|
{
|
|
return Set( m_Value / val );
|
|
}
|
|
|
|
const Type& operator*=( const Type &val )
|
|
{
|
|
return Set( m_Value * val );
|
|
}
|
|
|
|
const Type& operator^=( const Type &val )
|
|
{
|
|
return Set( m_Value ^ val );
|
|
}
|
|
|
|
const Type& operator|=( const Type &val )
|
|
{
|
|
return Set( m_Value | val );
|
|
}
|
|
|
|
const Type& operator++()
|
|
{
|
|
return (*this += 1);
|
|
}
|
|
|
|
Type operator--()
|
|
{
|
|
return (*this -= 1);
|
|
}
|
|
|
|
Type operator++( int ) // postfix version..
|
|
{
|
|
Type val = m_Value;
|
|
(*this += 1);
|
|
return val;
|
|
}
|
|
|
|
Type operator--( int ) // postfix version..
|
|
{
|
|
Type val = m_Value;
|
|
(*this -= 1);
|
|
return val;
|
|
}
|
|
|
|
// For some reason the compiler only generates type conversion warnings for this operator when used like
|
|
// CNetworkVarBase<unsigned tchar> = 0x1
|
|
// (it warns about converting from an int to an unsigned char).
|
|
template< class C >
|
|
const Type& operator&=( C val )
|
|
{
|
|
return Set( m_Value & val );
|
|
}
|
|
|
|
operator const Type&() const
|
|
{
|
|
return m_Value;
|
|
}
|
|
|
|
const Type& Get() const
|
|
{
|
|
return m_Value;
|
|
}
|
|
|
|
const Type* operator->() const
|
|
{
|
|
return &m_Value;
|
|
}
|
|
|
|
Type m_Value;
|
|
|
|
};
|
|
|
|
#else
|
|
|
|
template< class Type >
|
|
class CDataWatcher
|
|
{
|
|
private:
|
|
CDataWatcher(); // refuse to compile in non-debug builds
|
|
};
|
|
|
|
#endif
|
|
|
|
// Code for programmatically setting/unsetting hardware breakpoints (there's probably a 360 and
|
|
#ifdef IS_WINDOWS_PC
|
|
|
|
typedef void * HardwareBreakpointHandle_t;
|
|
|
|
enum EHardwareBreakpointType
|
|
{
|
|
BREAKPOINT_EXECUTE = 0,
|
|
BREAKPOINT_WRITE,
|
|
BREAKPOINT_READWRITE,
|
|
};
|
|
|
|
enum EHardwareBreakpointSize
|
|
{
|
|
BREAKPOINT_SIZE_1 = 1,
|
|
BREAKPOINT_SIZE_2 = 2,
|
|
BREAKPOINT_SIZE_4 = 4,
|
|
BREAKPOINT_SIZE_8 = 8,
|
|
};
|
|
|
|
PLATFORM_INTERFACE HardwareBreakpointHandle_t SetHardwareBreakpoint( EHardwareBreakpointType eType, EHardwareBreakpointSize eSize, const void *pvLocation );
|
|
PLATFORM_INTERFACE bool ClearHardwareBreakpoint( HardwareBreakpointHandle_t handle );
|
|
|
|
class CHardwareBreakPointScopeGuard
|
|
{
|
|
public:
|
|
CHardwareBreakPointScopeGuard( const void *pvLocation, size_t nLocationSize, EHardwareBreakpointType eType = BREAKPOINT_WRITE )
|
|
{
|
|
EHardwareBreakpointSize eSize = BREAKPOINT_SIZE_4;
|
|
switch ( nLocationSize )
|
|
{
|
|
case 1:
|
|
eSize = BREAKPOINT_SIZE_1;
|
|
break;
|
|
case 2:
|
|
eSize = BREAKPOINT_SIZE_2;
|
|
break;
|
|
case 4:
|
|
eSize = BREAKPOINT_SIZE_4;
|
|
break;
|
|
case 8:
|
|
eSize = BREAKPOINT_SIZE_8;
|
|
break;
|
|
default:
|
|
Warning( _T( "SetHardwareBreakpoint can only work with 1, 2, 4 or 8 byte data fields." ) );
|
|
break;
|
|
}
|
|
|
|
m_hBreakPoint = SetHardwareBreakpoint( eType, eSize, pvLocation );
|
|
m_bActive = m_hBreakPoint != (HardwareBreakpointHandle_t)0;
|
|
}
|
|
|
|
~CHardwareBreakPointScopeGuard()
|
|
{
|
|
Release();
|
|
}
|
|
|
|
void Release()
|
|
{
|
|
if ( !m_bActive )
|
|
return;
|
|
ClearHardwareBreakpoint( m_hBreakPoint );
|
|
}
|
|
|
|
private:
|
|
bool m_bActive;
|
|
HardwareBreakpointHandle_t m_hBreakPoint;
|
|
};
|
|
|
|
#endif // IS_WINDOWS_PC
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
|
#else //#if !defined(__SPU__)
|
|
|
|
// void these for now
|
|
|
|
#define Assert( _exp ) ((void)0)
|
|
#define AssertOnce( _exp ) ((void)0)
|
|
#define AssertMsg( _exp, _msg ) ((void)0)
|
|
#define AssertMsgOnce( _exp, _msg ) ((void)0)
|
|
#define AssertFunc( _exp, _f ) ((void)0)
|
|
#define AssertEquals( _exp, _expectedValue ) ((void)0)
|
|
#define AssertFloatEquals( _exp, _expectedValue, _tol ) ((void)0)
|
|
#define Verify( _exp ) (_exp)
|
|
#define VerifyEquals( _exp, _expectedValue ) (_exp)
|
|
|
|
#define AssertMsg1( _exp, _msg, a1 ) ((void)0)
|
|
#define AssertMsg2( _exp, _msg, a1, a2 ) ((void)0)
|
|
#define AssertMsg3( _exp, _msg, a1, a2, a3 ) ((void)0)
|
|
#define AssertMsg4( _exp, _msg, a1, a2, a3, a4 ) ((void)0)
|
|
#define AssertMsg5( _exp, _msg, a1, a2, a3, a4, a5 ) ((void)0)
|
|
#define AssertMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertMsg7( _exp, _msg, a1, a2, a3, a4, a5, a6, a7 ) ((void)0)
|
|
#define AssertMsg8( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8 ) ((void)0)
|
|
#define AssertMsg9( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 ) ((void)0)
|
|
|
|
#define COMPILE_TIME_ASSERT( pred )
|
|
#define ASSERT_INVARIANT( pred )
|
|
|
|
#define AssertFatal( _exp ) ((void)0)
|
|
#define AssertFatalOnce( _exp ) ((void)0)
|
|
#define AssertFatalMsg( _exp, _msg ) ((void)0)
|
|
#define AssertFatalMsgOnce( _exp, _msg ) ((void)0)
|
|
#define AssertFatalFunc( _exp, _f ) ((void)0)
|
|
#define AssertFatalEquals( _exp, _expectedValue ) ((void)0)
|
|
#define AssertFatalFloatEquals( _exp, _expectedValue, _tol ) ((void)0)
|
|
#define VerifyFatal( _exp ) (_exp)
|
|
#define VerifyEqualsFatal( _exp, _expectedValue ) (_exp)
|
|
|
|
#define AssertFatalMsg1( _exp, _msg, a1 ) ((void)0)
|
|
#define AssertFatalMsg2( _exp, _msg, a1, a2 ) ((void)0)
|
|
#define AssertFatalMsg3( _exp, _msg, a1, a2, a3 ) ((void)0)
|
|
#define AssertFatalMsg4( _exp, _msg, a1, a2, a3, a4 ) ((void)0)
|
|
#define AssertFatalMsg5( _exp, _msg, a1, a2, a3, a4, a5 ) ((void)0)
|
|
#define AssertFatalMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertFatalMsg6( _exp, _msg, a1, a2, a3, a4, a5, a6 ) ((void)0)
|
|
#define AssertFatalMsg7( _exp, _msg, a1, a2, a3, a4, a5, a6, a7 ) ((void)0)
|
|
#define AssertFatalMsg8( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8 ) ((void)0)
|
|
#define AssertFatalMsg9( _exp, _msg, a1, a2, a3, a4, a5, a6, a7, a8, a9 ) ((void)0)
|
|
|
|
#define AssertAligned(PTR)
|
|
|
|
#endif
|
|
|
|
|
|
#endif /* DBG_H */
|