From 079a4af651f8a8e33c788c6e9b4a3545ebedb4d3 Mon Sep 17 00:00:00 2001
From: capitalistspz <keipitalists@proton.me>
Date: Wed, 17 Jun 2026 16:24:09 +0000
Subject: [PATCH] debugging: Add GDB pretty printers for common types (#1957)

By default, GDB will not autoload this for security reasons. See https://sourceware.org/gdb/current/onlinedocs/gdb.html/Auto_002dloading-safe-path.html to see how to enable it.
---
 .gdbinit | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 .gdbinit

diff --git a/.gdbinit b/.gdbinit
new file mode 100644
index 00000000..d43d8198
--- /dev/null
+++ b/.gdbinit
@@ -0,0 +1,47 @@
+python
+
+import gdb
+import re
+
+
+class BetypePrinter:
+    PATTERN = re.compile("^betype<.*>$")
+
+    def __init__(self, obj):
+        self._obj = obj
+
+    def to_string(self):
+        underlying = self._obj["m_value"]
+        reversed_bytes = bytes(reversed(underlying.bytes))
+        return gdb.Value(reversed_bytes, underlying.type)
+
+class MemptrPrinter:
+    PATTERN = re.compile("^MEMPTR<.*>$")
+
+    def __init__(self, obj):
+        self._ptr_type = obj.type.strip_typedefs().unqualified().template_argument(0).pointer()
+        self._guest_address = obj["m_value"].cast(gdb.lookup_type("uint32"))
+
+    def ptr(self):
+        if self._guest_address == 0:
+            return gdb.Value(0, self._ptr_type)
+        base_addr = gdb.parse_and_eval('memory_base', global_context=True)
+        return (self._guest_address + base_addr).reinterpret_cast(self._ptr_type)
+
+    def children(self):
+        return [("raw", self.ptr())]
+
+    def to_string(self):
+        return self._guest_address.format_string(format="x")
+
+def lookup(val):
+    tag = val.type.strip_typedefs().unqualified().tag
+    if tag is None:
+        return None
+    printers = [BetypePrinter, MemptrPrinter]
+    for printer in printers:
+        if printer.PATTERN.match(tag):
+            return printer(val)
+    return None
+
+gdb.pretty_printers.append(lookup)