]> git.lizzy.rs Git - dragonfireclient.git/blobdiff - src/script/common/c_internal.cpp
HUD: Reject and warn on invalid stat types (#11548)
[dragonfireclient.git] / src / script / common / c_internal.cpp
index 90846676ffebcecc6d33a1083b25b88927df5846..66f6a9b9865bccfed13035bdf3d6b0fcf17358f5 100644 (file)
@@ -18,41 +18,20 @@ with this program; if not, write to the Free Software Foundation, Inc.,
 */
 
 #include "common/c_internal.h"
+#include "util/numeric.h"
 #include "debug.h"
+#include "log.h"
+#include "porting.h"
+#include "settings.h"
+#include <algorithm> // std::find
 
 std::string script_get_backtrace(lua_State *L)
 {
-       std::string s;
-       lua_getglobal(L, "debug");
-       if(lua_istable(L, -1)){
-               lua_getfield(L, -1, "traceback");
-               if(lua_isfunction(L, -1)) {
-                       lua_call(L, 0, 1);
-                       if(lua_isstring(L, -1)){
-                               s = lua_tostring(L, -1);
-                       }
-               }
-               lua_pop(L, 1);
-       }
+       lua_rawgeti(L, LUA_REGISTRYINDEX, CUSTOM_RIDX_BACKTRACE);
+       lua_call(L, 0, 1);
+       std::string result = luaL_checkstring(L, -1);
        lua_pop(L, 1);
-       return s;
-}
-
-int script_error_handler(lua_State *L) {
-       lua_getglobal(L, "debug");
-       if (!lua_istable(L, -1)) {
-               lua_pop(L, 1);
-               return 1;
-       }
-       lua_getfield(L, -1, "traceback");
-       if (!lua_isfunction(L, -1)) {
-               lua_pop(L, 2);
-               return 1;
-       }
-       lua_pushvalue(L, 1);
-       lua_pushinteger(L, 2);
-       lua_call(L, 2, 1);
-       return 1;
+       return result;
 }
 
 int script_exception_wrapper(lua_State *L, lua_CFunction f)
@@ -61,17 +40,65 @@ int script_exception_wrapper(lua_State *L, lua_CFunction f)
                return f(L);  // Call wrapped function and return result.
        } catch (const char *s) {  // Catch and convert exceptions.
                lua_pushstring(L, s);
-       } catch (LuaError& e) {
+       } catch (std::exception &e) {
                lua_pushstring(L, e.what());
        }
        return lua_error(L);  // Rethrow as a Lua error.
 }
 
-void script_error(lua_State *L)
+/*
+ * Note that we can't get tracebacks for LUA_ERRMEM or LUA_ERRERR (without
+ * hacking Lua internals).  For LUA_ERRMEM, this is because memory errors will
+ * not execute the error handler, and by the time lua_pcall returns the
+ * execution stack will have already been unwound.  For LUA_ERRERR, there was
+ * another error while trying to generate a backtrace from a LUA_ERRRUN.  It is
+ * presumed there is an error with the internal Lua state and thus not possible
+ * to gather a coherent backtrace.  Realistically, the best we can do here is
+ * print which C function performed the failing pcall.
+ */
+void script_error(lua_State *L, int pcall_result, const char *mod, const char *fxn)
 {
-       const char *s = lua_tostring(L, -1);
-       std::string str(s ? s : "");
-       throw LuaError(NULL, str);
+       if (pcall_result == 0)
+               return;
+
+       const char *err_type;
+       switch (pcall_result) {
+       case LUA_ERRRUN:
+               err_type = "Runtime";
+               break;
+       case LUA_ERRMEM:
+               err_type = "OOM";
+               break;
+       case LUA_ERRERR:
+               err_type = "Double fault";
+               break;
+       default:
+               err_type = "Unknown";
+       }
+
+       if (!mod)
+               mod = "??";
+
+       if (!fxn)
+               fxn = "??";
+
+       const char *err_descr = lua_tostring(L, -1);
+       if (!err_descr)
+               err_descr = "<no description>";
+
+       char buf[256];
+       porting::mt_snprintf(buf, sizeof(buf), "%s error from mod '%s' in callback %s(): ",
+               err_type, mod, fxn);
+
+       std::string err_msg(buf);
+       err_msg += err_descr;
+
+       if (pcall_result == LUA_ERRMEM) {
+               err_msg += "\nCurrent Lua memory usage: "
+                       + itos(lua_gc(L, LUA_GCCOUNT, 0) >> 10) + " MB";
+       }
+
+       throw LuaError(err_msg);
 }
 
 // Push the list of callbacks (a lua table).
@@ -80,33 +107,98 @@ void script_error(lua_State *L)
 // - runs the callbacks
 // - replaces the table and arguments with the return value,
 //     computed depending on mode
-void script_run_callbacks(lua_State *L, int nargs, RunCallbacksMode mode)
+void script_run_callbacks_f(lua_State *L, int nargs,
+       RunCallbacksMode mode, const char *fxn)
 {
-       assert(lua_gettop(L) >= nargs + 1);
+       FATAL_ERROR_IF(lua_gettop(L) < nargs + 1, "Not enough arguments");
 
        // Insert error handler
-       lua_pushcfunction(L, script_error_handler);
-       int errorhandler = lua_gettop(L) - nargs - 1;
-       lua_insert(L, errorhandler);
+       PUSH_ERROR_HANDLER(L);
+       int error_handler = lua_gettop(L) - nargs - 1;
+       lua_insert(L, error_handler);
 
-       // Insert minetest.run_callbacks between error handler and table
-       lua_getglobal(L, "minetest");
+       // Insert run_callbacks between error handler and table
+       lua_getglobal(L, "core");
        lua_getfield(L, -1, "run_callbacks");
        lua_remove(L, -2);
-       lua_insert(L, errorhandler + 1);
+       lua_insert(L, error_handler + 1);
 
        // Insert mode after table
        lua_pushnumber(L, (int) mode);
-       lua_insert(L, errorhandler + 3);
+       lua_insert(L, error_handler + 3);
 
        // Stack now looks like this:
        // ... <error handler> <run_callbacks> <table> <mode> <arg#1> <arg#2> ... <arg#n>
 
-       if (lua_pcall(L, nargs + 2, 1, errorhandler)) {
-               script_error(L);
+       int result = lua_pcall(L, nargs + 2, 1, error_handler);
+       if (result != 0)
+               script_error(L, result, NULL, fxn);
+
+       lua_remove(L, error_handler);
+}
+
+static void script_log_add_source(lua_State *L, std::string &message, int stack_depth)
+{
+       lua_Debug ar;
+
+       if (lua_getstack(L, stack_depth, &ar)) {
+               FATAL_ERROR_IF(!lua_getinfo(L, "Sl", &ar), "lua_getinfo() failed");
+               message.append(" (at " + std::string(ar.short_src) + ":"
+                       + std::to_string(ar.currentline) + ")");
+       } else {
+               message.append(" (at ?:?)");
+       }
+}
+
+bool script_log_unique(lua_State *L, std::string message, std::ostream &log_to,
+       int stack_depth)
+{
+       thread_local std::vector<u64> logged_messages;
+
+       script_log_add_source(L, message, stack_depth);
+       u64 hash = murmur_hash_64_ua(message.data(), message.length(), 0xBADBABE);
+
+       if (std::find(logged_messages.begin(), logged_messages.end(), hash)
+                       == logged_messages.end()) {
+
+               logged_messages.emplace_back(hash);
+               log_to << message << std::endl;
+               return true;
+       }
+       return false;
+}
+
+DeprecatedHandlingMode get_deprecated_handling_mode()
+{
+       static thread_local bool configured = false;
+       static thread_local DeprecatedHandlingMode ret = DeprecatedHandlingMode::Ignore;
+
+       // Only read settings on first call
+       if (!configured) {
+               std::string value = g_settings->get("deprecated_lua_api_handling");
+               if (value == "log") {
+                       ret = DeprecatedHandlingMode::Log;
+               } else if (value == "error") {
+                       ret = DeprecatedHandlingMode::Error;
+               }
+               configured = true;
        }
 
-       lua_remove(L, -2); // Remove error handler
+       return ret;
 }
 
+void log_deprecated(lua_State *L, std::string message, int stack_depth)
+{
+       DeprecatedHandlingMode mode = get_deprecated_handling_mode();
+       if (mode == DeprecatedHandlingMode::Ignore)
+               return;
+
+       script_log_add_source(L, message, stack_depth);
+       warningstream << message << std::endl;
+
+       if (mode == DeprecatedHandlingMode::Error)
+               script_error(L, LUA_ERRRUN, NULL, NULL);
+       else
+               infostream << script_get_backtrace(L) << std::endl;
+}