mirror of
https://github.com/PCSX2/pcsx2.git
synced 2025-04-02 10:52:54 -04:00
9c22dc4f73
* Fixed a bug that caused all but the first stackframe walk to fail with an error. * Improved thread safety of stack walking. DevNotes: When walking stackframes multiple times from the same process, only the first stackframe walk would work and all others would fail with an error because of calling SymInitialize multiple times. So now SymInitialize is only called once and SymRefreshModuleList is used prior to walking, if available. (only available in winDbgHlp.dll v6.5 or later) git-svn-id: http://pcsx2.googlecode.com/svn/trunk@3546 96395faa-99c1-11dd-bbfe-3dabce05a288
241 lines
8.7 KiB
C++
241 lines
8.7 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/msw/wrapdbgh.h
|
|
// Purpose: wraps dbghelp.h standard file
|
|
// Author: Vadim Zeitlin
|
|
// Modified by:
|
|
// Created: 2005-01-08 (extracted from msw/crashrpt.cpp)
|
|
// RCS-ID: $Id: debughlp.h 31443 2005-01-18 10:10:23Z ABX $
|
|
// Copyright: (c) 2003-2005 Vadim Zeitlin <vadim@wxwindows.org>
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_MSW_DEBUGHLPH_H_
|
|
#define _WX_MSW_DEBUGHLPH_H_
|
|
|
|
#include "wx/dynlib.h"
|
|
|
|
#include "wx/msw/wrapwin.h"
|
|
#ifndef __WXWINCE__
|
|
#include <imagehlp.h>
|
|
#endif // __WXWINCE__
|
|
#include "wx/msw/private.h"
|
|
|
|
// we need to determine whether we have the declarations for the function in
|
|
// debughlp.dll version 5.81 (at least) and we check for DBHLPAPI to test this
|
|
//
|
|
// reasons:
|
|
// - VC6 version of imagehlp.h doesn't define it
|
|
// - VC7 one does
|
|
// - testing for compiler version doesn't work as you can install and use
|
|
// the new SDK headers with VC6
|
|
//
|
|
// in any case, the user may override by defining wxUSE_DBGHELP himself
|
|
#ifndef wxUSE_DBGHELP
|
|
#ifdef DBHLPAPI
|
|
#define wxUSE_DBGHELP 1
|
|
#else
|
|
#define wxUSE_DBGHELP 0
|
|
#endif
|
|
#endif
|
|
|
|
#if wxUSE_DBGHELP
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxDbgHelpDLL: dynamically load dbghelp.dll functions
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wrapper for some functions from dbghelp.dll
|
|
//
|
|
// MT note: this class is not MT safe and should be only used from a single
|
|
// thread at a time (this is so because dbghelp.dll is not MT-safe
|
|
// itself anyhow)
|
|
class wxDbgHelpDLL
|
|
{
|
|
public:
|
|
// some useful constants not present in debughlp.h (stolen from DIA SDK)
|
|
enum BasicType
|
|
{
|
|
BASICTYPE_NOTYPE = 0,
|
|
BASICTYPE_VOID = 1,
|
|
BASICTYPE_CHAR = 2,
|
|
BASICTYPE_WCHAR = 3,
|
|
BASICTYPE_INT = 6,
|
|
BASICTYPE_UINT = 7,
|
|
BASICTYPE_FLOAT = 8,
|
|
BASICTYPE_BCD = 9,
|
|
BASICTYPE_BOOL = 10,
|
|
BASICTYPE_LONG = 13,
|
|
BASICTYPE_ULONG = 14,
|
|
BASICTYPE_CURRENCY = 25,
|
|
BASICTYPE_DATE = 26,
|
|
BASICTYPE_VARIANT = 27,
|
|
BASICTYPE_COMPLEX = 28,
|
|
BASICTYPE_BIT = 29,
|
|
BASICTYPE_BSTR = 30,
|
|
BASICTYPE_HRESULT = 31,
|
|
BASICTYPE_MAX
|
|
};
|
|
|
|
enum SymbolTag
|
|
{
|
|
SYMBOL_TAG_NULL,
|
|
SYMBOL_TAG_EXE,
|
|
SYMBOL_TAG_COMPILAND,
|
|
SYMBOL_TAG_COMPILAND_DETAILS,
|
|
SYMBOL_TAG_COMPILAND_ENV,
|
|
SYMBOL_TAG_FUNCTION,
|
|
SYMBOL_TAG_BLOCK,
|
|
SYMBOL_TAG_DATA,
|
|
SYMBOL_TAG_ANNOTATION,
|
|
SYMBOL_TAG_LABEL,
|
|
SYMBOL_TAG_PUBLIC_SYMBOL,
|
|
SYMBOL_TAG_UDT,
|
|
SYMBOL_TAG_ENUM,
|
|
SYMBOL_TAG_FUNCTION_TYPE,
|
|
SYMBOL_TAG_POINTER_TYPE,
|
|
SYMBOL_TAG_ARRAY_TYPE,
|
|
SYMBOL_TAG_BASE_TYPE,
|
|
SYMBOL_TAG_TYPEDEF,
|
|
SYMBOL_TAG_BASE_CLASS,
|
|
SYMBOL_TAG_FRIEND,
|
|
SYMBOL_TAG_FUNCTION_ARG_TYPE,
|
|
SYMBOL_TAG_FUNC_DEBUG_START,
|
|
SYMBOL_TAG_FUNC_DEBUG_END,
|
|
SYMBOL_TAG_USING_NAMESPACE,
|
|
SYMBOL_TAG_VTABLE_SHAPE,
|
|
SYMBOL_TAG_VTABLE,
|
|
SYMBOL_TAG_CUSTOM,
|
|
SYMBOL_TAG_THUNK,
|
|
SYMBOL_TAG_CUSTOM_TYPE,
|
|
SYMBOL_TAG_MANAGED_TYPE,
|
|
SYMBOL_TAG_DIMENSION,
|
|
SYMBOL_TAG_MAX
|
|
};
|
|
|
|
enum DataKind
|
|
{
|
|
DATA_UNKNOWN,
|
|
DATA_LOCAL,
|
|
DATA_STATIC_LOCAL,
|
|
DATA_PARAM,
|
|
DATA_OBJECT_PTR, // "this" pointer
|
|
DATA_FILE_STATIC,
|
|
DATA_GLOBAL,
|
|
DATA_MEMBER,
|
|
DATA_STATIC_MEMBER,
|
|
DATA_CONSTANT,
|
|
DATA_MAX
|
|
};
|
|
|
|
enum UdtKind
|
|
{
|
|
UDT_STRUCT,
|
|
UDT_CLASS,
|
|
UDT_UNION,
|
|
UDT_MAX
|
|
};
|
|
|
|
|
|
// function types
|
|
typedef DWORD (WINAPI *SymGetOptions_t)();
|
|
typedef DWORD (WINAPI *SymSetOptions_t)(DWORD);
|
|
typedef BOOL (WINAPI *SymInitialize_t)(HANDLE, LPSTR, BOOL);
|
|
typedef BOOL (WINAPI *SymRefreshModuleList_t)(HANDLE);
|
|
typedef BOOL (WINAPI *StackWalk_t)(DWORD, HANDLE, HANDLE, LPSTACKFRAME,
|
|
LPVOID, PREAD_PROCESS_MEMORY_ROUTINE,
|
|
PFUNCTION_TABLE_ACCESS_ROUTINE,
|
|
PGET_MODULE_BASE_ROUTINE,
|
|
PTRANSLATE_ADDRESS_ROUTINE);
|
|
typedef BOOL (WINAPI *SymFromAddr_t)(HANDLE, DWORD64, PDWORD64, PSYMBOL_INFO);
|
|
typedef LPVOID (WINAPI *SymFunctionTableAccess_t)(HANDLE, DWORD);
|
|
typedef DWORD (WINAPI *SymGetModuleBase_t)(HANDLE, DWORD);
|
|
typedef BOOL (WINAPI *SymGetLineFromAddr_t)(HANDLE, DWORD,
|
|
PDWORD, PIMAGEHLP_LINE);
|
|
typedef BOOL (WINAPI *SymSetContext_t)(HANDLE, PIMAGEHLP_STACK_FRAME,
|
|
PIMAGEHLP_CONTEXT);
|
|
typedef BOOL (WINAPI *SymEnumSymbols_t)(HANDLE, ULONG64, PCSTR,
|
|
PSYM_ENUMERATESYMBOLS_CALLBACK, PVOID);
|
|
typedef BOOL (WINAPI *SymGetTypeInfo_t)(HANDLE, DWORD64, ULONG,
|
|
IMAGEHLP_SYMBOL_TYPE_INFO, PVOID);
|
|
typedef BOOL (WINAPI *SymCleanup_t)(HANDLE);
|
|
typedef BOOL (WINAPI *EnumerateLoadedModules_t)(HANDLE, PENUMLOADED_MODULES_CALLBACK, PVOID);
|
|
typedef BOOL (WINAPI *MiniDumpWriteDump_t)(HANDLE, DWORD, HANDLE,
|
|
MINIDUMP_TYPE,
|
|
CONST PMINIDUMP_EXCEPTION_INFORMATION,
|
|
CONST PMINIDUMP_USER_STREAM_INFORMATION,
|
|
CONST PMINIDUMP_CALLBACK_INFORMATION);
|
|
|
|
#define wxDO_FOR_ALL_SYM_FUNCS(what) \
|
|
what(SymGetOptions); \
|
|
what(SymSetOptions); \
|
|
what(SymInitialize); \
|
|
what(StackWalk); \
|
|
what(SymFromAddr); \
|
|
what(SymFunctionTableAccess); \
|
|
what(SymGetModuleBase); \
|
|
what(SymGetLineFromAddr); \
|
|
what(SymSetContext); \
|
|
what(SymEnumSymbols); \
|
|
what(SymGetTypeInfo); \
|
|
what(SymCleanup); \
|
|
what(EnumerateLoadedModules); \
|
|
what(MiniDumpWriteDump)
|
|
|
|
#define wxDECLARE_SYM_FUNCTION(func) static func ## _t func
|
|
|
|
wxDO_FOR_ALL_SYM_FUNCS(wxDECLARE_SYM_FUNCTION);
|
|
|
|
// load all functions from DLL, return true if ok
|
|
static bool Init();
|
|
|
|
// *PCSX2* Should be called before performing a stack trace, as apps may load/unload plugins during
|
|
// program execution.
|
|
static bool RefreshModuleList(HANDLE hProcess);
|
|
|
|
// return the string with the error message explaining why Init() failed
|
|
static const wxString& GetErrorMessage();
|
|
|
|
// log error returned by the given function to debug output
|
|
static void LogError(const wxChar *func);
|
|
|
|
// return textual representation of the value of given symbol
|
|
static wxString DumpSymbol(PSYMBOL_INFO pSymInfo, void *pVariable);
|
|
|
|
// return the name of the symbol with given type index
|
|
static wxString GetSymbolName(PSYMBOL_INFO pSymInfo);
|
|
|
|
private:
|
|
// Declared separately since it requires an especially new version of WinDbgHlp
|
|
// (v6.5 or later).
|
|
wxDECLARE_SYM_FUNCTION(SymRefreshModuleList);
|
|
|
|
static bool DoInit();
|
|
|
|
static bool BindFunctions(const wxDynamicLibrary& dllDbgHelp);
|
|
|
|
// dereference the given symbol, i.e. return symbol which is not a
|
|
// pointer/reference any more
|
|
//
|
|
// if ppData != NULL, dereference the pointer as many times as we
|
|
// dereferenced the symbol
|
|
//
|
|
// return the tag of the dereferenced symbol
|
|
static SymbolTag DereferenceSymbol(PSYMBOL_INFO pSymInfo, void **ppData);
|
|
|
|
static wxString DumpField(PSYMBOL_INFO pSymInfo,
|
|
void *pVariable,
|
|
unsigned level);
|
|
|
|
static wxString DumpBaseType(BasicType bt, DWORD64 length, void *pVariable);
|
|
|
|
static wxString DumpUDT(PSYMBOL_INFO pSymInfo,
|
|
void *pVariable,
|
|
unsigned level = 0);
|
|
};
|
|
|
|
#undef wxDECLARE_SYM_FUNCTION
|
|
|
|
#endif // wxUSE_DBGHELP
|
|
|
|
#endif // _WX_MSW_DEBUGHLPH_H_
|
|
|