]> git.lizzy.rs Git - minetest.git/blobdiff - src/debug.cpp
Revise bump_version.sh script to address shortcomings (#12789)
[minetest.git] / src / debug.cpp
index df8cbeb2268c7c593e0144d582e55ed88fdb93be..3c82ed9e1c23ec62e51fb5bc3e91d0c7608efa23 100644 (file)
 /*
-Minetest-c55
-Copyright (C) 2010 celeron55, Perttu Ahola <celeron55@gmail.com>
+Minetest
+Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
 
 This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation; either version 2.1 of the License, or
 (at your option) any later version.
 
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
+GNU Lesser General Public License for more details.
 
-You should have received a copy of the GNU General Public License along
+You should have received a copy of the GNU Lesser General Public License along
 with this program; if not, write to the Free Software Foundation, Inc.,
 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
 
-#include "debug.h"
-#include <stdio.h>
-#include <stdlib.h>
 #include "porting.h"
+#include "debug.h"
+#include "exceptions.h"
+#include <cstdio>
+#include <cstdlib>
+#include <cstring>
+#include <map>
+#include <sstream>
+#include <thread>
+#include "threading/mutex_auto_lock.h"
+#include "config.h"
+
+#ifdef _MSC_VER
+       #include <dbghelp.h>
+       #include "version.h"
+       #include "filesys.h"
+#endif
+
+#if USE_CURSES
+       #include "terminal_chat_console.h"
+#endif
 
 /*
-       Debug output
+       Assert
 */
 
-FILE *g_debugstreams[DEBUGSTREAM_COUNT] = {stderr, NULL};
-
-void debugstreams_init(bool disable_stderr, const char *filename)
-{
-       if(disable_stderr)
-               g_debugstreams[0] = NULL;
-
-       if(filename)
-               g_debugstreams[1] = fopen(filename, "a");
-               
-       if(g_debugstreams[1])
-       {
-               fprintf(g_debugstreams[1], "\n\n-------------\n");
-               fprintf(g_debugstreams[1],     "  Separator  \n");
-               fprintf(g_debugstreams[1],     "-------------\n\n");
-       }
-}
-
-void debugstreams_deinit()
+void sanity_check_fn(const char *assertion, const char *file,
+               unsigned int line, const char *function)
 {
-       if(g_debugstreams[1] != NULL)
-               fclose(g_debugstreams[1]);
-}
+#if USE_CURSES
+       g_term_console.stopAndWaitforThread();
+#endif
 
-Debugbuf debugbuf(false);
-std::ostream dstream(&debugbuf);
-Debugbuf debugbuf_no_stderr(true);
-std::ostream dstream_no_stderr(&debugbuf_no_stderr);
-Nullstream dummyout;
+       errorstream << std::endl << "In thread " << std::hex
+               << std::this_thread::get_id() << ":" << std::endl;
+       errorstream << file << ":" << line << ": " << function
+               << ": An engine assumption '" << assertion << "' failed." << std::endl;
 
-/*
-       Assert
-*/
+       abort();
+}
 
-void assert_fail(const char *assertion, const char *file,
+void fatal_error_fn(const char *msg, const char *file,
                unsigned int line, const char *function)
 {
-       DEBUGPRINT("\nIn thread %x:\n"
-                       "%s:%d: %s: Assertion '%s' failed.\n",
-                       (unsigned int)get_current_thread_id(),
-                       file, line, function, assertion);
-       
-       debug_stacks_print();
+#if USE_CURSES
+       g_term_console.stopAndWaitforThread();
+#endif
 
-       if(g_debugstreams[1])
-               fclose(g_debugstreams[1]);
-
-       //sleep_ms(3000);
+       errorstream << std::endl << "In thread " << std::hex
+               << std::this_thread::get_id() << ":" << std::endl;
+       errorstream << file << ":" << line << ": " << function
+               << ": A fatal error occurred: " << msg << std::endl;
 
        abort();
 }
 
-/*
-       DebugStack
-*/
+#ifdef _MSC_VER
 
-DebugStack::DebugStack(threadid_t id)
+const char *Win32ExceptionCodeToString(DWORD exception_code)
 {
-       threadid = id;
-       stack_i = 0;
-       stack_max_i = 0;
+       switch (exception_code) {
+       case EXCEPTION_ACCESS_VIOLATION:
+               return "Access violation";
+       case EXCEPTION_DATATYPE_MISALIGNMENT:
+               return "Misaligned data access";
+       case EXCEPTION_BREAKPOINT:
+               return "Breakpoint reached";
+       case EXCEPTION_SINGLE_STEP:
+               return "Single debug step";
+       case EXCEPTION_ARRAY_BOUNDS_EXCEEDED:
+               return "Array access out of bounds";
+       case EXCEPTION_FLT_DENORMAL_OPERAND:
+               return "Denormal floating point operand";
+       case EXCEPTION_FLT_DIVIDE_BY_ZERO:
+               return "Floating point division by zero";
+       case EXCEPTION_FLT_INEXACT_RESULT:
+               return "Inaccurate floating point result";
+       case EXCEPTION_FLT_INVALID_OPERATION:
+               return "Invalid floating point operation";
+       case EXCEPTION_FLT_OVERFLOW:
+               return "Floating point exponent overflow";
+       case EXCEPTION_FLT_STACK_CHECK:
+               return "Floating point stack overflow or underflow";
+       case EXCEPTION_FLT_UNDERFLOW:
+               return "Floating point exponent underflow";
+       case EXCEPTION_INT_DIVIDE_BY_ZERO:
+               return "Integer division by zero";
+       case EXCEPTION_INT_OVERFLOW:
+               return "Integer overflow";
+       case EXCEPTION_PRIV_INSTRUCTION:
+               return "Privileged instruction executed";
+       case EXCEPTION_IN_PAGE_ERROR:
+               return "Could not access or load page";
+       case EXCEPTION_ILLEGAL_INSTRUCTION:
+               return "Illegal instruction encountered";
+       case EXCEPTION_NONCONTINUABLE_EXCEPTION:
+               return "Attempted to continue after fatal exception";
+       case EXCEPTION_STACK_OVERFLOW:
+               return "Stack overflow";
+       case EXCEPTION_INVALID_DISPOSITION:
+               return "Invalid disposition returned to the exception dispatcher";
+       case EXCEPTION_GUARD_PAGE:
+               return "Attempted guard page access";
+       case EXCEPTION_INVALID_HANDLE:
+               return "Invalid handle";
+       }
+
+       return "Unknown exception";
 }
 
-void DebugStack::print(FILE *file, bool everything)
+long WINAPI Win32ExceptionHandler(struct _EXCEPTION_POINTERS *pExceptInfo)
 {
-       fprintf(file, "DEBUG STACK FOR THREAD %x:\n",
-                       (unsigned int)threadid);
-
-       for(int i=0; i<stack_max_i; i++)
-       {
-               if(i == stack_i && everything == false)
-                       continue;
-
-               if(i < stack_i)
-                       fprintf(file, "#%d  %s\n", i, stack[i]);
-               else
-                       fprintf(file, "(Leftover data: #%d  %s)\n", i, stack[i]);
-       }
+       char buf[512];
+       MINIDUMP_EXCEPTION_INFORMATION mdei;
+       MINIDUMP_USER_STREAM_INFORMATION mdusi;
+       MINIDUMP_USER_STREAM mdus;
+       bool minidump_created = false;
 
-       if(stack_i == DEBUG_STACK_SIZE)
-               fprintf(file, "Probably overflown.\n");
-}
+       std::string dumpfile = porting::path_user + DIR_DELIM PROJECT_NAME ".dmp";
 
+       std::string version_str(PROJECT_NAME " ");
+       version_str += g_version_hash;
 
-core::map<threadid_t, DebugStack*> g_debug_stacks;
-JMutex g_debug_stacks_mutex;
+       HANDLE hFile = CreateFileA(dumpfile.c_str(), GENERIC_WRITE,
+               FILE_SHARE_WRITE, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
+       if (hFile == INVALID_HANDLE_VALUE)
+               goto minidump_failed;
 
-void debug_stacks_init()
-{
-       g_debug_stacks_mutex.Init();
-}
+       if (SetEndOfFile(hFile) == FALSE)
+               goto minidump_failed;
 
-void debug_stacks_print()
-{
-       JMutexAutoLock lock(g_debug_stacks_mutex);
+       mdei.ClientPointers        = NULL;
+       mdei.ExceptionPointers = pExceptInfo;
+       mdei.ThreadId              = GetCurrentThreadId();
 
-       DEBUGPRINT("Debug stacks:\n");
+       mdus.Type       = CommentStreamA;
+       mdus.BufferSize = version_str.size();
+       mdus.Buffer     = (PVOID)version_str.c_str();
 
-       for(core::map<threadid_t, DebugStack*>::Iterator
-                       i = g_debug_stacks.getIterator();
-                       i.atEnd() == false; i++)
-       {
-               DebugStack *stack = i.getNode()->getValue();
+       mdusi.UserStreamArray = &mdus;
+       mdusi.UserStreamCount = 1;
 
-               for(int i=0; i<DEBUGSTREAM_COUNT; i++)
-               {
-                       if(g_debugstreams[i] != NULL)
-                               stack->print(g_debugstreams[i], true);
-               }
-       }
-}
+       if (MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hFile,
+                       MiniDumpNormal, &mdei, &mdusi, NULL) == FALSE)
+               goto minidump_failed;
 
-DebugStacker::DebugStacker(const char *text)
-{
-       threadid_t threadid = get_current_thread_id();
+       minidump_created = true;
 
-       JMutexAutoLock lock(g_debug_stacks_mutex);
+minidump_failed:
 
-       core::map<threadid_t, DebugStack*>::Node *n;
-       n = g_debug_stacks.find(threadid);
-       if(n != NULL)
-       {
-               m_stack = n->getValue();
-       }
-       else
-       {
-               /*DEBUGPRINT("Creating new debug stack for thread %x\n",
-                               (unsigned int)threadid);*/
-               m_stack = new DebugStack(threadid);
-               g_debug_stacks.insert(threadid, m_stack);
-       }
+       CloseHandle(hFile);
 
-       if(m_stack->stack_i >= DEBUG_STACK_SIZE)
-       {
-               m_overflowed = true;
-       }
+       DWORD excode = pExceptInfo->ExceptionRecord->ExceptionCode;
+       _snprintf(buf, sizeof(buf),
+               " >> === FATAL ERROR ===\n"
+               " >> %s (Exception 0x%08X) at 0x%p\n",
+               Win32ExceptionCodeToString(excode), excode,
+               pExceptInfo->ExceptionRecord->ExceptionAddress);
+       dstream << buf;
+
+       if (minidump_created)
+               dstream << " >> Saved dump to " << dumpfile << std::endl;
        else
-       {
-               m_overflowed = false;
-
-               snprintf(m_stack->stack[m_stack->stack_i],
-                               DEBUG_STACK_TEXT_SIZE, "%s", text);
-               m_stack->stack_i++;
-               if(m_stack->stack_i > m_stack->stack_max_i)
-                       m_stack->stack_max_i = m_stack->stack_i;
-       }
+               dstream << " >> Failed to save dump" << std::endl;
+
+       return EXCEPTION_EXECUTE_HANDLER;
 }
 
-DebugStacker::~DebugStacker()
+#endif
+
+void debug_set_exception_handler()
 {
-       JMutexAutoLock lock(g_debug_stacks_mutex);
-       
-       if(m_overflowed == true)
-               return;
-       
-       m_stack->stack_i--;
-
-       if(m_stack->stack_i == 0)
-       {
-               threadid_t threadid = m_stack->threadid;
-               /*DEBUGPRINT("Deleting debug stack for thread %x\n",
-                               (unsigned int)threadid);*/
-               delete m_stack;
-               g_debug_stacks.remove(threadid);
-       }
+#ifdef _MSC_VER
+       SetUnhandledExceptionFilter(Win32ExceptionHandler);
+#endif
 }