//==========================================================================; // // THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY // KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR // PURPOSE. // // Copyright (c) 1992 - 1997 Microsoft Corporation. All Rights Reserved. // //--------------------------------------------------------------------------; // For every module and executable we store a debugging level and flags // for the types of output that are desired. Constants for the types are // defined in WXDEBUG.H and more can be added. // The keys are stored in the registry under the // HKEY_LOCAL_MACHINE\SOFTWARE\Debug\\Type and // HKEY_LOCAL_MACHINE\SOFTWARE\Debug\\Level key values // // There are also global values under SOFTWARE\Debug\Global which are loaded // after the module-specific values. The Types specified there are OR'ed with // the module specific types and m_dwLevel is set to the greater of the global // and the module specific settings. #if defined(_DEBUG) && defined(_WIN32) #include #include #include "extdll.h" #include "util.h" #include "wxdebug.h" #include void WINAPI DbgInitModuleName(void); void WINAPI DbgInitModuleSettings(void); void WINAPI DbgInitGlobalSettings(void); void WINAPI DbgInitLogTo(HKEY hKey); void WINAPI DbgInitKeyLevels(HKEY hKey, DWORD *pdwTypes, DWORD *pdwLevel); const INT iDEBUGINFO = 512; // Used to format strings HINSTANCE m_hInst; // Module instance handle TCHAR m_ModuleName[iDEBUGINFO]; // Cut down module name //CRITICAL_SECTION m_CSDebug; // Controls access to list BOOL m_bInit = FALSE; // Have we been initialised HANDLE m_hOutput = INVALID_HANDLE_VALUE; // Optional output written here DWORD m_dwTypes = 0; DWORD m_dwLevel = 0; const TCHAR *m_pBaseKey = TEXT("SOFTWARE\\Debug"); const TCHAR *m_pGlobalKey = TEXT("GLOBAL"); TCHAR *pKeyNames[] = { TEXT("Types"), TEXT("Level") }; // DbgInitialize // This sets the instance handle that the debug library uses to find // the module's file name from the Win32 GetModuleFileName function void WINAPI DbgInitialise(HINSTANCE hInst) { if (!m_bInit) { //InitializeCriticalSection(&m_CSDebug); m_bInit = TRUE; m_hInst = hInst; DbgInitModuleName(); DbgInitModuleSettings(); DbgInitGlobalSettings(); } } // DbgTerminate // This is called to clear up any resources the debug library uses - at the // moment we delete our critical section and the handle of the output file. void WINAPI DbgTerminate() { if (m_bInit) { if (m_hOutput != INVALID_HANDLE_VALUE) { DBGASSERTEXECUTE(CloseHandle(m_hOutput)); m_hOutput = INVALID_HANDLE_VALUE; } //DeleteCriticalSection(&m_CSDebug); m_bInit = FALSE; } } // DbgInitModuleName // Initialise the module file name void WINAPI DbgInitModuleName() { TCHAR FullName[iDEBUGINFO]; // Load the full path and module name TCHAR *pName; // Searches from the end for a backslash GetModuleFileName(m_hInst,FullName,iDEBUGINFO); pName = _tcsrchr(FullName,'\\'); if (pName == NULL) { pName = FullName; } else { pName++; } lstrcpy(m_ModuleName,pName); } // DbgInitModuleSettings // Retrieve the module-specific settings void WINAPI DbgInitModuleSettings() { LONG lReturn; // Create key return value TCHAR szInfo[iDEBUGINFO]; // Constructs key names HKEY hModuleKey; // Module key handle // Construct the base key name wsprintf(szInfo,TEXT("%s\\%s"),m_pBaseKey,m_ModuleName); // Create or open the key for this module lReturn = RegCreateKeyEx(HKEY_LOCAL_MACHINE, // Handle of an open key szInfo, // Address of subkey name (DWORD)0, // Reserved value NULL, // Address of class name (DWORD)0, // Special options flags KEY_ALL_ACCESS, // Desired security access NULL, // Key security descriptor &hModuleKey, // Opened handle buffer NULL); // What really happened if (lReturn != ERROR_SUCCESS) { DbgLogInfo(LOG_ERROR, 0, TEXT("Could not access module key")); return; } DbgInitLogTo(hModuleKey); DbgInitKeyLevels(hModuleKey, &m_dwTypes, &m_dwLevel); RegCloseKey(hModuleKey); } // DbgInitGlobalSettings // This is called by DbgInitialize to read the global debug settings for // Level and Type from the registry. The Types are OR'ed together and m_dwLevel // is set to the greater of the global and module-specific values. void WINAPI DbgInitGlobalSettings() { LONG lReturn; // Create key return value TCHAR szInfo[iDEBUGINFO]; // Constructs key names HKEY hGlobalKey; // Global override key DWORD dwTypes = 0; DWORD dwLevel = 0; // Construct the global base key name wsprintf(szInfo,TEXT("%s\\%s"),m_pBaseKey,m_pGlobalKey); // Create or open the key for this module lReturn = RegCreateKeyEx(HKEY_LOCAL_MACHINE, // Handle of an open key szInfo, // Address of subkey name (DWORD)0, // Reserved value NULL, // Address of class name (DWORD)0, // Special options flags KEY_ALL_ACCESS, // Desired security access NULL, // Key security descriptor &hGlobalKey, // Opened handle buffer NULL); // What really happened if (lReturn != ERROR_SUCCESS) { DbgLogInfo(LOG_ERROR, 0, TEXT("Could not access GLOBAL module key")); return; } DbgInitKeyLevels(hGlobalKey, &dwTypes, &dwLevel); RegCloseKey(hGlobalKey); m_dwTypes |= dwTypes; if (dwLevel > m_dwLevel) m_dwLevel = dwLevel; } // DbgInitLogTo // Called by DbgInitModuleSettings to setup alternate logging destinations void WINAPI DbgInitLogTo(HKEY hKey) { LONG lReturn; DWORD dwKeyType; DWORD dwKeySize; TCHAR szFile[MAX_PATH] = {0}; static const TCHAR cszKey[] = TEXT("LogToFile"); dwKeySize = MAX_PATH; lReturn = RegQueryValueEx( hKey, // Handle to an open key cszKey, // Subkey name derivation NULL, // Reserved field &dwKeyType, // Returns the field type (LPBYTE) szFile, // Returns the field's value &dwKeySize); // Number of bytes transferred // create an empty key if it does not already exist if (lReturn != ERROR_SUCCESS || dwKeyType != REG_SZ) { dwKeySize = 1; lReturn = RegSetValueEx( hKey, // Handle of an open key cszKey, // Address of subkey name (DWORD) 0, // Reserved field REG_SZ, // Type of the key field (PBYTE)szFile, // Value for the field dwKeySize); // Size of the field buffer } // if an output-to was specified. try to open it. if (m_hOutput != INVALID_HANDLE_VALUE) { DBGASSERTEXECUTE(CloseHandle(m_hOutput)); m_hOutput = INVALID_HANDLE_VALUE; } if (szFile[0] != 0) { if (!lstrcmpi(szFile, TEXT("Console"))) { m_hOutput = GetStdHandle(STD_OUTPUT_HANDLE); if (m_hOutput == INVALID_HANDLE_VALUE) { AllocConsole(); m_hOutput = GetStdHandle(STD_OUTPUT_HANDLE); } SetConsoleTitle (TEXT("Valve Debug Output")); } else if (szFile[0] && lstrcmpi(szFile, TEXT("Debug")) && lstrcmpi(szFile, TEXT("Debugger")) && lstrcmpi(szFile, TEXT("Deb"))) { m_hOutput = CreateFile(szFile, GENERIC_WRITE, FILE_SHARE_READ, NULL, OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); if (INVALID_HANDLE_VALUE != m_hOutput) { static const TCHAR cszBar[] = TEXT("\r\n\r\n=====DbgInitialize()=====\r\n\r\n"); SetFilePointer (m_hOutput, 0, NULL, FILE_END); DbgOutString (cszBar); } } } } // DbgInitKeyLevels // This is called by DbgInitModuleSettings and DbgInitGlobalSettings to read // settings for Types and Level from the registry void WINAPI DbgInitKeyLevels(HKEY hKey, DWORD *pdwTypes, DWORD *pdwLevel) { LONG lReturn; // Create key return value DWORD dwKeySize; // Size of the key value DWORD dwKeyType; // Receives it's type // Get the Types value dwKeySize = sizeof(DWORD); lReturn = RegQueryValueEx( hKey, // Handle to an open key pKeyNames[0], // Subkey name derivation NULL, // Reserved field &dwKeyType, // Returns the field type (LPBYTE)pdwTypes, // Returns the field's value &dwKeySize ); // Number of bytes transferred // If either the key was not available or it was not a DWORD value // then we ensure only the high priority debug logging is output // but we try and update the field to a zero filled DWORD value if (lReturn != ERROR_SUCCESS || dwKeyType != REG_DWORD) { *pdwTypes = 0; lReturn = RegSetValueEx( hKey, // Handle of an open key pKeyNames[0], // Address of subkey name (DWORD)0, // Reserved field REG_DWORD, // Type of the key field (PBYTE)pdwTypes, // Value for the field sizeof(DWORD)); // Size of the field buffer if (lReturn != ERROR_SUCCESS) { DbgLogInfo(LOG_ERROR, 0, TEXT("Could not create subkey %s"),pKeyNames[0]); *pdwTypes = 0; } } // Get the Level value dwKeySize = sizeof(DWORD); lReturn = RegQueryValueEx( hKey, // Handle to an open key pKeyNames[1], // Subkey name derivation NULL, // Reserved field &dwKeyType, // Returns the field type (LPBYTE)pdwLevel, // Returns the field's value &dwKeySize ); // Number of bytes transferred // If either the key was not available or it was not a DWORD value // then we ensure only the high priority debug logging is output // but we try and update the field to a zero filled DWORD value if (lReturn != ERROR_SUCCESS || dwKeyType != REG_DWORD) { *pdwLevel = 0; lReturn = RegSetValueEx( hKey, // Handle of an open key pKeyNames[1], // Address of subkey name (DWORD)0, // Reserved field REG_DWORD, // Type of the key field (PBYTE)pdwLevel, // Value for the field sizeof(DWORD)); // Size of the field buffer if (lReturn != ERROR_SUCCESS) { DbgLogInfo(LOG_ERROR, 0, TEXT("Could not create subkey %s"),pKeyNames[1]); *pdwLevel = 0; } } } // DbgOutString void WINAPI DbgOutString(LPCTSTR psz) { if (!m_bInit) return; if (m_hOutput != INVALID_HANDLE_VALUE) { UINT cb = lstrlen(psz); DWORD dw; WriteFile (m_hOutput, psz, cb, &dw, NULL); } else { OutputDebugString (psz); } } // DbgLogInfo // Print a formatted string to the debugger prefixed with this module's name // Because the debug code is linked statically every module loaded will // have its own copy of this code. It therefore helps if the module name is // included on the output so that the offending code can be easily found void WINAPI DbgLogInfo(DWORD Type, DWORD Level, const TCHAR *pFormat,...) { if (!m_bInit) return; // Check the current level for this type combination */ if (((Type & m_dwTypes) == 0) || (m_dwLevel < Level)) return; TCHAR szInfo[2000]; // Format the variable length parameter list va_list va; va_start(va, pFormat); //lstrcpy(szInfo, m_ModuleName); //lstrcat(szInfo, TEXT(": ")); wvsprintf(szInfo /* + lstrlen(szInfo) */, pFormat, va); //lstrcat(szInfo, TEXT("\r\n")); DbgOutString(szInfo); va_end(va); } // DbgKernelAssert // If we are executing as a pure kernel filter we cannot display message // boxes to the user, this provides an alternative which puts the error // condition on the debugger output with a suitable eye catching message void WINAPI DbgKernelAssert(const TCHAR *pCondition, const TCHAR *pFileName, INT iLine) { if (!m_bInit) return; DbgLogInfo(LOG_ERROR, 0, TEXT(m_ModuleName)); DbgLogInfo(LOG_ERROR, 0, TEXT(": Assertion FAILED (%s) at line %d in file %s\r\n"), pCondition, iLine, pFileName); DebugBreak(); } #endif // _DEBUG