2 Copyright (c) 2004 Andrei Polushin
4 Permission is hereby granted, free of charge, to any person obtaining a copy
5 of this software and associated documentation files (the "Software"), to deal
6 in the Software without restriction, including without limitation the rights
7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 copies of the Software, and to permit persons to whom the Software is
9 furnished to do so, subject to the following conditions:
11 The above copyright notice and this permission notice shall be included in
12 all copies or substantial portions of the Software.
14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23 #if !defined(_M_AMD64) && defined(_MSC_VER)
25 /* X86_64 is currently missing some meachine-dependent code below. */
27 #include "private/msvc_dbg.h"
31 #define WIN32_LEAN_AND_MEAN
38 #pragma comment(lib, "dbghelp.lib")
39 #pragma optimize("gy", off)
42 #define GC_ULONG_PTR word
45 typedef GC_ULONG_PTR ULONG_ADDR;
47 typedef ULONG ULONG_ADDR;
50 static HANDLE GetSymHandle()
52 static HANDLE symHandle = NULL;
54 BOOL bRet = SymInitialize(symHandle = GetCurrentProcess(), NULL, FALSE);
56 DWORD dwOptions = SymGetOptions();
57 dwOptions &= ~SYMOPT_UNDNAME;
58 dwOptions |= SYMOPT_LOAD_LINES;
59 SymSetOptions(dwOptions);
65 static void* CALLBACK FunctionTableAccess(HANDLE hProcess,
66 ULONG_ADDR dwAddrBase)
68 return SymFunctionTableAccess(hProcess, dwAddrBase);
71 static ULONG_ADDR CALLBACK GetModuleBase(HANDLE hProcess, ULONG_ADDR dwAddress)
73 MEMORY_BASIC_INFORMATION memoryInfo;
74 ULONG_ADDR dwAddrBase = SymGetModuleBase(hProcess, dwAddress);
78 if (VirtualQueryEx(hProcess, (void*)(GC_ULONG_PTR)dwAddress, &memoryInfo,
79 sizeof(memoryInfo))) {
80 char filePath[_MAX_PATH];
81 char curDir[_MAX_PATH];
82 char exePath[_MAX_PATH];
83 DWORD size = GetModuleFileNameA((HINSTANCE)memoryInfo.AllocationBase,
84 filePath, sizeof(filePath));
86 /* Save and restore current directory around SymLoadModule, see KB */
87 /* article Q189780. */
88 GetCurrentDirectoryA(sizeof(curDir), curDir);
89 GetModuleFileNameA(NULL, exePath, sizeof(exePath));
90 #if defined(_MSC_VER) && _MSC_VER == 1200
91 /* use strcat for VC6 */
92 strcat(exePath, "\\..");
94 strcat_s(exePath, sizeof(exePath), "\\..");
95 #endif /* _MSC_VER >= 1200 */
96 SetCurrentDirectoryA(exePath);
98 GetCurrentDirectoryA(sizeof(exePath), exePath);
100 SymLoadModule(hProcess, NULL, size ? filePath : NULL, NULL,
101 (ULONG_ADDR)(GC_ULONG_PTR)memoryInfo.AllocationBase, 0);
102 SetCurrentDirectoryA(curDir);
104 return (ULONG_ADDR)(GC_ULONG_PTR)memoryInfo.AllocationBase;
107 static ULONG_ADDR CheckAddress(void* address)
109 ULONG_ADDR dwAddress = (ULONG_ADDR)(GC_ULONG_PTR)address;
110 GetModuleBase(GetSymHandle(), dwAddress);
114 size_t GetStackFrames(size_t skip, void* frames[], size_t maxFrames)
116 HANDLE hProcess = GetSymHandle();
117 HANDLE hThread = GetCurrentThread();
119 context.ContextFlags = CONTEXT_FULL;
120 if (!GetThreadContext(hThread, &context)) {
123 /* GetThreadContext might return invalid context for the current thread. */
125 __asm mov context.Ebp, ebp
127 return GetStackFramesFromContext(hProcess, hThread, &context, skip + 1,
131 size_t GetStackFramesFromContext(HANDLE hProcess, HANDLE hThread,
132 CONTEXT* context, size_t skip,
133 void* frames[], size_t maxFrames)
137 STACKFRAME stackFrame = { 0 };
138 stackFrame.AddrPC.Mode = AddrModeFlat;
140 machineType = IMAGE_FILE_MACHINE_I386;
141 stackFrame.AddrPC.Offset = context->Eip;
142 stackFrame.AddrStack.Mode = AddrModeFlat;
143 stackFrame.AddrStack.Offset = context->Esp;
144 stackFrame.AddrFrame.Mode = AddrModeFlat;
145 stackFrame.AddrFrame.Offset = context->Ebp;
146 #elif defined(_M_MRX000)
147 machineType = IMAGE_FILE_MACHINE_R4000;
148 stackFrame.AddrPC.Offset = context->Fir;
149 #elif defined(_M_ALPHA)
150 machineType = IMAGE_FILE_MACHINE_ALPHA;
151 stackFrame.AddrPC.Offset = (unsigned long)context->Fir;
152 #elif defined(_M_PPC)
153 machineType = IMAGE_FILE_MACHINE_POWERPC;
154 stackFrame.AddrPC.Offset = context->Iar;
155 #elif defined(_M_IA64)
156 machineType = IMAGE_FILE_MACHINE_IA64;
157 stackFrame.AddrPC.Offset = context->StIIP;
158 #elif defined(_M_ALPHA64)
159 machineType = IMAGE_FILE_MACHINE_ALPHA64;
160 stackFrame.AddrPC.Offset = context->Fir;
164 for (frameIndex = 0; frameIndex < maxFrames; ) {
165 BOOL bRet = StackWalk(machineType, hProcess, hThread, &stackFrame,
166 &context, NULL, FunctionTableAccess, GetModuleBase, NULL);
173 frames[frameIndex++] = (void*)(GC_ULONG_PTR)stackFrame.AddrPC.Offset;
179 size_t GetModuleNameFromAddress(void* address, char* moduleName, size_t size)
181 if (size) *moduleName = 0;
183 const char* sourceName;
184 IMAGEHLP_MODULE moduleInfo = { sizeof (moduleInfo) };
185 if (!SymGetModuleInfo(GetSymHandle(), CheckAddress(address),
189 sourceName = strrchr(moduleInfo.ImageName, '\\');
193 sourceName = moduleInfo.ImageName;
196 strncpy(moduleName, sourceName, size)[size - 1] = 0;
198 return strlen(sourceName);
202 size_t GetModuleNameFromStack(size_t skip, char* moduleName, size_t size)
204 void* address = NULL;
205 GetStackFrames(skip + 1, &address, 1);
207 return GetModuleNameFromAddress(address, moduleName, size);
212 size_t GetSymbolNameFromAddress(void* address, char* symbolName, size_t size,
215 if (size) *symbolName = 0;
216 if (offsetBytes) *offsetBytes = 0;
218 ULONG_ADDR dwOffset = 0;
221 char symNameBuffer[sizeof(IMAGEHLP_SYMBOL) + MAX_SYM_NAME];
223 u.sym.SizeOfStruct = sizeof(u.sym);
224 u.sym.MaxNameLength = sizeof(u.symNameBuffer) - sizeof(u.sym);
226 if (!SymGetSymFromAddr(GetSymHandle(), CheckAddress(address), &dwOffset,
230 const char* sourceName = u.sym.Name;
232 if (UnDecorateSymbolName(u.sym.Name, undName, sizeof(undName),
233 UNDNAME_NO_MS_KEYWORDS | UNDNAME_NO_ACCESS_SPECIFIERS)) {
234 sourceName = undName;
235 } else if (SymUnDName(&u.sym, undName, sizeof(undName))) {
236 sourceName = undName;
239 *offsetBytes = dwOffset;
242 strncpy(symbolName, sourceName, size)[size - 1] = 0;
244 return strlen(sourceName);
246 } __except (EXCEPTION_EXECUTE_HANDLER) {
247 SetLastError(GetExceptionCode());
252 size_t GetSymbolNameFromStack(size_t skip, char* symbolName, size_t size,
255 void* address = NULL;
256 GetStackFrames(skip + 1, &address, 1);
258 return GetSymbolNameFromAddress(address, symbolName, size, offsetBytes);
263 size_t GetFileLineFromAddress(void* address, char* fileName, size_t size,
264 size_t* lineNumber, size_t* offsetBytes)
266 if (size) *fileName = 0;
267 if (lineNumber) *lineNumber = 0;
268 if (offsetBytes) *offsetBytes = 0;
271 IMAGEHLP_LINE line = { sizeof (line) };
272 GC_ULONG_PTR dwOffset = 0;
273 if (!SymGetLineFromAddr(GetSymHandle(), CheckAddress(address), &dwOffset,
278 *lineNumber = line.LineNumber;
281 *offsetBytes = dwOffset;
283 sourceName = line.FileName;
284 /* TODO: resolve relative filenames, found in 'source directories' */
285 /* registered with MSVC IDE. */
287 strncpy(fileName, sourceName, size)[size - 1] = 0;
289 return strlen(sourceName);
293 size_t GetFileLineFromStack(size_t skip, char* fileName, size_t size,
294 size_t* lineNumber, size_t* offsetBytes)
296 void* address = NULL;
297 GetStackFrames(skip + 1, &address, 1);
299 return GetFileLineFromAddress(address, fileName, size, lineNumber,
305 size_t GetDescriptionFromAddress(void* address, const char* format,
306 char* buffer, size_t size)
308 char*const begin = buffer;
309 char*const end = buffer + size;
310 size_t line_number = 0;
316 buffer += GetFileLineFromAddress(address, buffer, size, &line_number, NULL);
317 size = end < buffer ? 0 : end - buffer;
320 wsprintf(str, "(%d) : ", line_number);
322 strncpy(buffer, str, size)[size - 1] = 0;
324 buffer += strlen(str);
325 size = end < buffer ? 0 : end - buffer;
329 strncpy(buffer, "at ", size)[size - 1] = 0;
331 buffer += strlen("at ");
332 size = end < buffer ? 0 : end - buffer;
334 buffer += GetSymbolNameFromAddress(address, buffer, size, NULL);
335 size = end < buffer ? 0 : end - buffer;
338 strncpy(buffer, " in ", size)[size - 1] = 0;
340 buffer += strlen(" in ");
341 size = end < buffer ? 0 : end - buffer;
343 buffer += GetModuleNameFromAddress(address, buffer, size);
344 size = end < buffer ? 0 : end - buffer;
346 return buffer - begin;
349 size_t GetDescriptionFromStack(void* const frames[], size_t count,
350 const char* format, char* description[],
353 char*const begin = (char*)description;
354 char*const end = begin + size;
355 char* buffer = begin + (count + 1) * sizeof(char*);
357 for (i = 0; i < count; ++i) {
358 if (description) description[i] = buffer;
359 size = end < buffer ? 0 : end - buffer;
360 buffer += 1 + GetDescriptionFromAddress(frames[i], NULL, buffer, size);
362 if (description) description[count] = NULL;
363 return buffer - begin;
366 /* Compatibility with <execinfo.h> */
368 int backtrace(void* addresses[], int count)
370 return GetStackFrames(1, addresses, count);
373 char** backtrace_symbols(void*const* addresses, int count)
375 size_t size = GetDescriptionFromStack(addresses, count, NULL, NULL, 0);
376 char** symbols = (char**)malloc(size);
377 GetDescriptionFromStack(addresses, count, NULL, symbols, size);
381 #endif /* !_M_AMD64 */