3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as published by
7 the Free Software Foundation; either version 2.1 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23 #include "exceptions.h"
30 #include "threading/mutex_auto_lock.h"
40 #include "terminal_chat_console.h"
47 void sanity_check_fn(const char *assertion, const char *file,
48 unsigned int line, const char *function)
51 g_term_console.stopAndWaitforThread();
54 errorstream << std::endl << "In thread " << std::hex
55 << std::this_thread::get_id() << ":" << std::endl;
56 errorstream << file << ":" << line << ": " << function
57 << ": An engine assumption '" << assertion << "' failed." << std::endl;
59 debug_stacks_print_to(errorstream);
64 void fatal_error_fn(const char *msg, const char *file,
65 unsigned int line, const char *function)
68 g_term_console.stopAndWaitforThread();
71 errorstream << std::endl << "In thread " << std::hex
72 << std::this_thread::get_id() << ":" << std::endl;
73 errorstream << file << ":" << line << ": " << function
74 << ": A fatal error occured: " << msg << std::endl;
76 debug_stacks_print_to(errorstream);
87 DebugStack(std::thread::id id);
88 void print(FILE *file, bool everything);
89 void print(std::ostream &os, bool everything);
91 std::thread::id thread_id;
92 char stack[DEBUG_STACK_SIZE][DEBUG_STACK_TEXT_SIZE];
93 int stack_i; // Points to the lowest empty position
94 int stack_max_i; // Highest i that was seen
97 DebugStack::DebugStack(std::thread::id id)
102 memset(stack, 0, DEBUG_STACK_SIZE*DEBUG_STACK_TEXT_SIZE);
105 void DebugStack::print(FILE *file, bool everything)
107 std::ostringstream os;
109 fprintf(file, "DEBUG STACK FOR THREAD %s:\n",
112 for (int i = 0; i < stack_max_i; i++) {
113 if (i == stack_i && everything == false)
117 fprintf(file, "#%d %s\n", i, stack[i]);
119 fprintf(file, "(Leftover data: #%d %s)\n", i, stack[i]);
122 if (stack_i == DEBUG_STACK_SIZE)
123 fprintf(file, "Probably overflown.\n");
126 void DebugStack::print(std::ostream &os, bool everything)
128 os<<"DEBUG STACK FOR THREAD "<<thread_id<<": "<<std::endl;
130 for(int i = 0; i < stack_max_i; i++) {
131 if(i == stack_i && everything == false)
135 os<<"#"<<i<<" "<<stack[i]<<std::endl;
137 os<<"(Leftover data: #"<<i<<" "<<stack[i]<<")"<<std::endl;
140 if (stack_i == DEBUG_STACK_SIZE)
141 os<<"Probably overflown."<<std::endl;
144 std::map<std::thread::id, DebugStack*> g_debug_stacks;
145 std::mutex g_debug_stacks_mutex;
147 void debug_stacks_init()
151 void debug_stacks_print_to(std::ostream &os)
153 MutexAutoLock lock(g_debug_stacks_mutex);
155 os<<"Debug stacks:"<<std::endl;
157 for (auto it : g_debug_stacks) {
158 it.second->print(os, false);
162 void debug_stacks_print()
164 debug_stacks_print_to(errorstream);
167 DebugStacker::DebugStacker(const char *text)
169 std::thread::id thread_id = std::this_thread::get_id();
171 MutexAutoLock lock(g_debug_stacks_mutex);
173 auto n = g_debug_stacks.find(thread_id);
174 if (n != g_debug_stacks.end()) {
177 /*DEBUGPRINT("Creating new debug stack for thread %x\n",
178 (unsigned int)thread_id);*/
179 m_stack = new DebugStack(thread_id);
180 g_debug_stacks[thread_id] = m_stack;
183 if (m_stack->stack_i >= DEBUG_STACK_SIZE) {
186 m_overflowed = false;
188 snprintf(m_stack->stack[m_stack->stack_i],
189 DEBUG_STACK_TEXT_SIZE, "%s", text);
191 if (m_stack->stack_i > m_stack->stack_max_i)
192 m_stack->stack_max_i = m_stack->stack_i;
196 DebugStacker::~DebugStacker()
198 MutexAutoLock lock(g_debug_stacks_mutex);
200 if (m_overflowed == true)
205 if (m_stack->stack_i == 0) {
206 std::thread::id thread_id = m_stack->thread_id;
207 /*DEBUGPRINT("Deleting debug stack for thread %x\n",
208 (unsigned int)thread_id);*/
210 g_debug_stacks.erase(thread_id);
216 const char *Win32ExceptionCodeToString(DWORD exception_code)
218 switch (exception_code) {
219 case EXCEPTION_ACCESS_VIOLATION:
220 return "Access violation";
221 case EXCEPTION_DATATYPE_MISALIGNMENT:
222 return "Misaligned data access";
223 case EXCEPTION_BREAKPOINT:
224 return "Breakpoint reached";
225 case EXCEPTION_SINGLE_STEP:
226 return "Single debug step";
227 case EXCEPTION_ARRAY_BOUNDS_EXCEEDED:
228 return "Array access out of bounds";
229 case EXCEPTION_FLT_DENORMAL_OPERAND:
230 return "Denormal floating point operand";
231 case EXCEPTION_FLT_DIVIDE_BY_ZERO:
232 return "Floating point division by zero";
233 case EXCEPTION_FLT_INEXACT_RESULT:
234 return "Inaccurate floating point result";
235 case EXCEPTION_FLT_INVALID_OPERATION:
236 return "Invalid floating point operation";
237 case EXCEPTION_FLT_OVERFLOW:
238 return "Floating point exponent overflow";
239 case EXCEPTION_FLT_STACK_CHECK:
240 return "Floating point stack overflow or underflow";
241 case EXCEPTION_FLT_UNDERFLOW:
242 return "Floating point exponent underflow";
243 case EXCEPTION_INT_DIVIDE_BY_ZERO:
244 return "Integer division by zero";
245 case EXCEPTION_INT_OVERFLOW:
246 return "Integer overflow";
247 case EXCEPTION_PRIV_INSTRUCTION:
248 return "Privileged instruction executed";
249 case EXCEPTION_IN_PAGE_ERROR:
250 return "Could not access or load page";
251 case EXCEPTION_ILLEGAL_INSTRUCTION:
252 return "Illegal instruction encountered";
253 case EXCEPTION_NONCONTINUABLE_EXCEPTION:
254 return "Attempted to continue after fatal exception";
255 case EXCEPTION_STACK_OVERFLOW:
256 return "Stack overflow";
257 case EXCEPTION_INVALID_DISPOSITION:
258 return "Invalid disposition returned to the exception dispatcher";
259 case EXCEPTION_GUARD_PAGE:
260 return "Attempted guard page access";
261 case EXCEPTION_INVALID_HANDLE:
262 return "Invalid handle";
265 return "Unknown exception";
268 long WINAPI Win32ExceptionHandler(struct _EXCEPTION_POINTERS *pExceptInfo)
271 MINIDUMP_EXCEPTION_INFORMATION mdei;
272 MINIDUMP_USER_STREAM_INFORMATION mdusi;
273 MINIDUMP_USER_STREAM mdus;
274 bool minidump_created = false;
276 std::string dumpfile = porting::path_user + DIR_DELIM PROJECT_NAME ".dmp";
278 std::string version_str(PROJECT_NAME " ");
279 version_str += g_version_hash;
281 HANDLE hFile = CreateFileA(dumpfile.c_str(), GENERIC_WRITE,
282 FILE_SHARE_WRITE, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
283 if (hFile == INVALID_HANDLE_VALUE)
284 goto minidump_failed;
286 if (SetEndOfFile(hFile) == FALSE)
287 goto minidump_failed;
289 mdei.ClientPointers = NULL;
290 mdei.ExceptionPointers = pExceptInfo;
291 mdei.ThreadId = GetCurrentThreadId();
293 mdus.Type = CommentStreamA;
294 mdus.BufferSize = version_str.size();
295 mdus.Buffer = (PVOID)version_str.c_str();
297 mdusi.UserStreamArray = &mdus;
298 mdusi.UserStreamCount = 1;
300 if (MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hFile,
301 MiniDumpNormal, &mdei, &mdusi, NULL) == FALSE)
302 goto minidump_failed;
304 minidump_created = true;
310 DWORD excode = pExceptInfo->ExceptionRecord->ExceptionCode;
311 _snprintf(buf, sizeof(buf),
312 " >> === FATAL ERROR ===\n"
313 " >> %s (Exception 0x%08X) at 0x%p\n",
314 Win32ExceptionCodeToString(excode), excode,
315 pExceptInfo->ExceptionRecord->ExceptionAddress);
318 if (minidump_created)
319 dstream << " >> Saved dump to " << dumpfile << std::endl;
321 dstream << " >> Failed to save dump" << std::endl;
323 return EXCEPTION_EXECUTE_HANDLER;
328 void debug_set_exception_handler()
331 SetUnhandledExceptionFilter(Win32ExceptionHandler);