]> git.lizzy.rs Git - minetest.git/blobdiff - src/debug.cpp
Simple decorations: Fix range check for deco->deco_param2
[minetest.git] / src / debug.cpp
index 278902a081b7fa2836063ace205771cbbcd4c871..8647160b1bed7c20cae3dae6e035bfc23bef521e 100644 (file)
@@ -18,6 +18,7 @@ with this program; if not, write to the Free Software Foundation, Inc.,
 */
 
 
+#include "porting.h"
 #include "debug.h"
 #include "exceptions.h"
 #include "threads.h"
@@ -25,115 +26,55 @@ with this program; if not, write to the Free Software Foundation, Inc.,
 #include <stdlib.h>
 #include <cstring>
 #include <map>
-#include "jthread/jmutex.h"
-#include "jthread/jmutexautolock.h"
+#include <sstream>
+#include "threading/mutex.h"
+#include "threading/mutex_auto_lock.h"
+#include "config.h"
 
-/*
-       Debug output
-*/
-
-#define DEBUGSTREAM_COUNT 2
-
-FILE *g_debugstreams[DEBUGSTREAM_COUNT] = {stderr, NULL};
-
-#define DEBUGPRINT(...)\
-{\
-       for(int i=0; i<DEBUGSTREAM_COUNT; i++)\
-       {\
-               if(g_debugstreams[i] != NULL){\
-                       fprintf(g_debugstreams[i], __VA_ARGS__);\
-                       fflush(g_debugstreams[i]);\
-               }\
-       }\
-}
-
-void debugstreams_init(bool disable_stderr, const char *filename)
-{
-       if(disable_stderr)
-               g_debugstreams[0] = NULL;
-       else
-               g_debugstreams[0] = stderr;
+#ifdef _MSC_VER
+       #include <dbghelp.h>
+       #include "version.h"
+       #include "filesys.h"
+#endif
 
-       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");
-       }
-}
+#if USE_CURSES
+       #include "terminal_chat_console.h"
+#endif
 
-void debugstreams_deinit()
-{
-       if(g_debugstreams[1] != NULL)
-               fclose(g_debugstreams[1]);
-}
+/*
+       Assert
+*/
 
-class Debugbuf : public std::streambuf
+void sanity_check_fn(const char *assertion, const char *file,
+               unsigned int line, const char *function)
 {
-public:
-       Debugbuf(bool disable_stderr)
-       {
-               m_disable_stderr = disable_stderr;
-       }
+#if USE_CURSES
+       g_term_console.stopAndWaitforThread();
+#endif
 
-       int overflow(int c)
-       {
-               for(int i=0; i<DEBUGSTREAM_COUNT; i++)
-               {
-                       if(g_debugstreams[i] == stderr && m_disable_stderr)
-                               continue;
-                       if(g_debugstreams[i] != NULL)
-                               (void)fwrite(&c, 1, 1, g_debugstreams[i]);
-                       //TODO: Is this slow?
-                       fflush(g_debugstreams[i]);
-               }
-               
-               return c;
-       }
-       std::streamsize xsputn(const char *s, std::streamsize n)
-       {
-               for(int i=0; i<DEBUGSTREAM_COUNT; i++)
-               {
-                       if(g_debugstreams[i] == stderr && m_disable_stderr)
-                               continue;
-                       if(g_debugstreams[i] != NULL)
-                               (void)fwrite(s, 1, n, g_debugstreams[i]);
-                       //TODO: Is this slow?
-                       fflush(g_debugstreams[i]);
-               }
-
-               return n;
-       }
-       
-private:
-       bool m_disable_stderr;
-};
+       errorstream << std::endl << "In thread " << std::hex
+               << thr_get_current_thread_id() << ":" << std::endl;
+       errorstream << file << ":" << line << ": " << function
+               << ": An engine assumption '" << assertion << "' failed." << std::endl;
 
-Debugbuf debugbuf(false);
-std::ostream dstream(&debugbuf);
-Debugbuf debugbuf_no_stderr(true);
-std::ostream dstream_no_stderr(&debugbuf_no_stderr);
-Nullstream dummyout;
+       debug_stacks_print_to(errorstream);
 
-/*
-       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 %lx:\n"
-                       "%s:%d: %s: Assertion '%s' failed.\n",
-                       (unsigned long)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]);
+       errorstream << std::endl << "In thread " << std::hex
+               << thr_get_current_thread_id() << ":" << std::endl;
+       errorstream << file << ":" << line << ": " << function
+               << ": A fatal error occured: " << msg << std::endl;
+
+       debug_stacks_print_to(errorstream);
 
        abort();
 }
@@ -147,7 +88,7 @@ struct DebugStack
        DebugStack(threadid_t id);
        void print(FILE *file, bool everything);
        void print(std::ostream &os, bool everything);
-       
+
        threadid_t threadid;
        char stack[DEBUG_STACK_SIZE][DEBUG_STACK_TEXT_SIZE];
        int stack_i; // Points to the lowest empty position
@@ -164,8 +105,10 @@ DebugStack::DebugStack(threadid_t id)
 
 void DebugStack::print(FILE *file, bool everything)
 {
-       fprintf(file, "DEBUG STACK FOR THREAD %lx:\n",
-                       (unsigned long)threadid);
+       std::ostringstream os;
+       os << threadid;
+       fprintf(file, "DEBUG STACK FOR THREAD %s:\n",
+               os.str().c_str());
 
        for(int i=0; i<stack_max_i; i++)
        {
@@ -184,7 +127,7 @@ void DebugStack::print(FILE *file, bool everything)
 
 void DebugStack::print(std::ostream &os, bool everything)
 {
-       os<<"DEBUG STACK FOR THREAD "<<(unsigned long)threadid<<": "<<std::endl;
+       os<<"DEBUG STACK FOR THREAD "<<threadid<<": "<<std::endl;
 
        for(int i=0; i<stack_max_i; i++)
        {
@@ -201,8 +144,15 @@ void DebugStack::print(std::ostream &os, bool everything)
                os<<"Probably overflown."<<std::endl;
 }
 
+// Note:  Using pthread_t (that is, threadid_t on POSIX platforms) as the key to
+// a std::map is naughty.  Formally, a pthread_t may only be compared using
+// pthread_equal() - pthread_t lacks the well-ordered property needed for
+// comparisons in binary searches.  This should be fixed at some point by
+// defining a custom comparator with an arbitrary but stable ordering of
+// pthread_t, but it isn't too important since none of our supported platforms
+// implement pthread_t as a non-ordinal type.
 std::map<threadid_t, DebugStack*> g_debug_stacks;
-JMutex g_debug_stacks_mutex;
+Mutex g_debug_stacks_mutex;
 
 void debug_stacks_init()
 {
@@ -210,7 +160,7 @@ void debug_stacks_init()
 
 void debug_stacks_print_to(std::ostream &os)
 {
-       JMutexAutoLock lock(g_debug_stacks_mutex);
+       MutexAutoLock lock(g_debug_stacks_mutex);
 
        os<<"Debug stacks:"<<std::endl;
 
@@ -224,29 +174,14 @@ void debug_stacks_print_to(std::ostream &os)
 
 void debug_stacks_print()
 {
-       JMutexAutoLock lock(g_debug_stacks_mutex);
-
-       DEBUGPRINT("Debug stacks:\n");
-
-       for(std::map<threadid_t, DebugStack*>::iterator
-                       i = g_debug_stacks.begin();
-                       i != g_debug_stacks.end(); ++i)
-       {
-               DebugStack *stack = i->second;
-
-               for(int i=0; i<DEBUGSTREAM_COUNT; i++)
-               {
-                       if(g_debugstreams[i] != NULL)
-                               stack->print(g_debugstreams[i], true);
-               }
-       }
+       debug_stacks_print_to(errorstream);
 }
 
 DebugStacker::DebugStacker(const char *text)
 {
-       threadid_t threadid = get_current_thread_id();
+       threadid_t threadid = thr_get_current_thread_id();
 
-       JMutexAutoLock lock(g_debug_stacks_mutex);
+       MutexAutoLock lock(g_debug_stacks_mutex);
 
        std::map<threadid_t, DebugStack*>::iterator n;
        n = g_debug_stacks.find(threadid);
@@ -280,11 +215,11 @@ DebugStacker::DebugStacker(const char *text)
 
 DebugStacker::~DebugStacker()
 {
-       JMutexAutoLock lock(g_debug_stacks_mutex);
-       
+       MutexAutoLock lock(g_debug_stacks_mutex);
+
        if(m_overflowed == true)
                return;
-       
+
        m_stack->stack_i--;
 
        if(m_stack->stack_i == 0)
@@ -297,35 +232,124 @@ DebugStacker::~DebugStacker()
        }
 }
 
-
 #ifdef _MSC_VER
-#if CATCH_UNHANDLED_EXCEPTIONS == 1
-void se_trans_func(unsigned int u, EXCEPTION_POINTERS* pExp)
+
+const char *Win32ExceptionCodeToString(DWORD exception_code)
 {
-       dstream<<"In trans_func.\n";
-       if(u == EXCEPTION_ACCESS_VIOLATION)
-       {
-               PEXCEPTION_RECORD r = pExp->ExceptionRecord;
-               dstream<<"Access violation at "<<r->ExceptionAddress
-                               <<" write?="<<r->ExceptionInformation[0]
-                               <<" address="<<r->ExceptionInformation[1]
-                               <<std::endl;
-               throw FatalSystemException
-               ("Access violation");
-       }
-       if(u == EXCEPTION_STACK_OVERFLOW)
-       {
-               throw FatalSystemException
-               ("Stack overflow");
-       }
-       if(u == EXCEPTION_ILLEGAL_INSTRUCTION)
-       {
-               throw FatalSystemException
-               ("Illegal instruction");
+       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";
 }
-#endif
-#endif
 
+long WINAPI Win32ExceptionHandler(struct _EXCEPTION_POINTERS *pExceptInfo)
+{
+       char buf[512];
+       MINIDUMP_EXCEPTION_INFORMATION mdei;
+       MINIDUMP_USER_STREAM_INFORMATION mdusi;
+       MINIDUMP_USER_STREAM mdus;
+       bool minidump_created = false;
+
+       std::string dumpfile = porting::path_user + DIR_DELIM PROJECT_NAME ".dmp";
+
+       std::string version_str(PROJECT_NAME " ");
+       version_str += g_version_hash;
 
+       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;
+
+       if (SetEndOfFile(hFile) == FALSE)
+               goto minidump_failed;
+
+       mdei.ClientPointers        = NULL;
+       mdei.ExceptionPointers = pExceptInfo;
+       mdei.ThreadId              = GetCurrentThreadId();
+
+       mdus.Type       = CommentStreamA;
+       mdus.BufferSize = version_str.size();
+       mdus.Buffer     = (PVOID)version_str.c_str();
+
+       mdusi.UserStreamArray = &mdus;
+       mdusi.UserStreamCount = 1;
+
+       if (MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hFile,
+                       MiniDumpNormal, &mdei, &mdusi, NULL) == FALSE)
+               goto minidump_failed;
+
+       minidump_created = true;
+
+minidump_failed:
+
+       CloseHandle(hFile);
+
+       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
+               dstream << " >> Failed to save dump" << std::endl;
+
+       return EXCEPTION_EXECUTE_HANDLER;
+}
+
+#endif
+
+void debug_set_exception_handler()
+{
+#ifdef _MSC_VER
+       SetUnhandledExceptionFilter(Win32ExceptionHandler);
+#endif
+}