[Tarantool-patches] [PATCH luajit 3/4] dbg: display fast function name along with ffid

Mikhail Elhimov m.elhimov at vk.team
Fri Nov 13 02:42:24 MSK 2026


Part of tarantool/tarantool#4808
---
 src/luajit_dbg.py                             |  22 +++-
 .../debug-extension-tests.py                  | 121 ++++++++++++++----
 2 files changed, 109 insertions(+), 34 deletions(-)

diff --git a/src/luajit_dbg.py b/src/luajit_dbg.py
index ceba4c58..db4b3f04 100644
--- a/src/luajit_dbg.py
+++ b/src/luajit_dbg.py
@@ -1178,6 +1178,11 @@ def frames(L):
 # LuaJIT macro implementations and structure access.
 
 
+# Get FastFunc enum members and replace any single '_' with '.'.
+FF_NAMES = EnumBasedList('FF__MAX', 'FastFunc', lambda x:
+                         re.sub('(?<!_)_', '.', cut_prefix(x, 'FF_')))
+
+
 def mref(typename, obj):
     return dbg.cast(typename, obj['ptr64'] if LJ_GC64 else obj['ptr32'])
 
@@ -1757,6 +1762,11 @@ def ir_kint64(ir):
 
 # Dumpers.
 
+def dump_fast_function(ffid):
+    ffname = FF_NAMES[ffid] if ffid < len(FF_NAMES) else 'unknown'
+    return 'fast function {} (#{})'.format(ffname, ffid)
+
+
 # GCobj dumpers.
 
 def dump_lj_gco_str(gcobj):
@@ -1780,7 +1790,7 @@ def dump_lj_gco_proto(gcobj):
 
 def dump_lj_gco_func(gcobj):
     func = dbg.cast('struct GCfuncC *', gcobj)
-    ffid = func['ffid']
+    ffid = int(func['ffid'])
 
     if ffid == 0:
         pt = funcproto(func)
@@ -1793,7 +1803,7 @@ def dump_lj_gco_func(gcobj):
     elif ffid == 1:
         return 'C function @ {}'.format(strx64(func['f']))
     else:
-        return 'fast function #{}'.format(int(ffid))
+        return dump_fast_function(ffid)
 
 
 def dump_lj_gco_trace(gcobj):
@@ -2143,7 +2153,7 @@ def dump_proto(proto):
 
 
 def dump_func(func):
-    ffid = func['ffid']
+    ffid = int(func['ffid'])
 
     if ffid == 0:
         pt = funcproto(func)
@@ -2151,7 +2161,7 @@ def dump_func(func):
     elif ffid == 1:
         return 'C function @ {}'.format(strx64(func['f']))
     else:
-        return 'fast function #{}'.format(int(ffid))
+        return dump_fast_function(ffid)
 
 
 # FFI dumpers.
@@ -2779,7 +2789,7 @@ the type and some info related to it.
 * LJ_TFUNC: <LFUNC|CFUNC|FFUNC>
   <LFUNC>: Lua function @ <gcr>, <nupvals> upvalues, <chunk:line>
   <CFUNC>: C function <mcode address>
-  <FFUNC>: fast function #<ffid>
+  <FFUNC>: fast function <ffname> (#<ffid>)
 * LJ_TTRACE: trace <traceno> @ <gcr>
 * LJ_TCDATA: cdata @ <gcr>
 * LJ_TTAB: table @ <gcr> (asize: <asize>, hmask: <hmask>)
@@ -2997,7 +3007,7 @@ the type and some info related to it.
 * LJ_TFUNC: <LFUNC|CFUNC|FFUNC>
   <LFUNC>: Lua function @ <gcr>, <nupvals> upvalues, <chunk:line>
   <CFUNC>: C function <mcode address>
-  <FFUNC>: fast function #<ffid>
+  <FFUNC>: fast function <ffname> (#<ffid>)
 * LJ_TTRACE: trace <traceno> @ <gcr>
 * LJ_TCDATA: cdata @ <gcr>
 * LJ_TTAB: table @ <gcr> (asize: <asize>, hmask: <hmask>)
diff --git a/test/tarantool-debugger-tests/debug-extension-tests.py b/test/tarantool-debugger-tests/debug-extension-tests.py
index 8a3ef96a..9237d3f1 100644
--- a/test/tarantool-debugger-tests/debug-extension-tests.py
+++ b/test/tarantool-debugger-tests/debug-extension-tests.py
@@ -92,6 +92,9 @@ if LLDB:
     SET_EXEC = 'target create ' + LUAJIT_BINARY
     SET_RUN_ARGS = 'settings set target.run-args'
 
+    def modify_obj_cmd(obj, val):
+        return 'expression {} = {}'.format(obj, val)
+
     def execute_process(cmd, timeout=TIMEOUT):
         # While executing extension commands LLDB might produce
         # errors that cannot be caught in extension. The internal
@@ -128,6 +131,9 @@ else:
     SET_RUN_ARGS = 'set args'
     execute_process = execute_process_raw
 
+    def modify_obj_cmd(obj, val):
+        return 'set var {} = {}'.format(obj, val)
+
 IS_DUALNUM = execute_process([
     LUAJIT_BINARY, '-e', "print(require('ffi').abi('dualnum'))"
 ]).strip() == 'true'
@@ -361,13 +367,31 @@ class TestLJStackFunc(TestCaseBase):
     pattern = STACK_RX
 
 
+FFUNC_ARGS = (
+    'print,\n'
+    'math.min,\n'
+    'getmetatable(io.stdout).close,\n'
+    'getmetatable(io.stdout).__gc,\n'
+    'getmetatable(io.stdout).__tostring,\n'
+)
+
+
+FFUNC_RX = (
+    r'fast function print \(#[0-9]+\)\n'
+    r'fast function math.min \(#[0-9]+\)\n'
+    r'fast function io.method.close \(#[0-9]+\)\n'
+    r'fast function io.method.__gc \(#[0-9]+\)\n'
+    r'fast function io.method.__tostring \(#[0-9]+\)\n'
+)
+
+
 # Sorted in LJT order.
 GCO_ARGS = (
     '"hello",\n'
     'coroutine.create(function() end),\n'
     'function() end,\n'
-    'require,\n'
-    'print,\n'
+    'require,\n' +
+    FFUNC_ARGS +
     'ffi.new("int*"),\n'
     '{1},\n'
     'newproxy(),\n'
@@ -378,8 +402,8 @@ GCO_RX = (
     r'string \"hello\" @ ' + RX_ADDR + r'\n'
     r'thread @ ' + RX_ADDR + r'\n'
     r'Lua function @ ' + RX_ADDR + r', [0-9]+ upvalues, .+:[0-9]+\n'
-    r'C function @ ' + RX_ADDR + r'\n'
-    r'fast function #[0-9]+\n'
+    r'C function @ ' + RX_ADDR + r'\n' +
+    FFUNC_RX +
     r'cdata @ ' + RX_ADDR + r' \[\d+\] <int \*> 0x0\n'
     r'table @ ' + RX_ADDR + r' \(asize: \d+, hmask: ' + RX_HASH + r'\)\n'
     r'userdata @ ' + RX_ADDR + r'\n'
@@ -388,21 +412,9 @@ GCO_RX = (
 
 class TestLJTV(TestCaseBase):
     location = 'lj_cf_print'
-    extension_cmds = (
-        'lj-tv L->base\n'
-        'lj-tv L->base + 1\n'
-        'lj-tv L->base + 2\n'
-        'lj-tv L->base + 3\n'
-        'lj-tv L->base + 4\n'
-        'lj-tv L->base + 5\n'
-        'lj-tv L->base + 6\n'
-        'lj-tv L->base + 7\n'
-        'lj-tv L->base + 8\n'
-        'lj-tv L->base + 9\n'
-        'lj-tv L->base + 10\n'
-        'lj-tv L->base + 11\n'
-        'lj-tv L->base + 12\n'
-        'lj-tv L->base + 13\n'
+    extension_cmds = ''.join(
+        ('lj-tv L->base+{}\n'.format(i)
+         for i in range(4 + GCO_ARGS.count('\n') + 2))
     )
 
     # Sorted in LJT order.
@@ -463,15 +475,9 @@ class TestLJTab(TestCaseBase):
 
 class TestLJGCo(TestCaseBase):
     location = 'lj_cf_print'
-    extension_cmds = (
-        'lj-gco ' + gcval('L->base + 0') + '\n'
-        'lj-gco ' + gcval('L->base + 1') + '\n'
-        'lj-gco ' + gcval('L->base + 2') + '\n'
-        'lj-gco ' + gcval('L->base + 3') + '\n'
-        'lj-gco ' + gcval('L->base + 4') + '\n'
-        'lj-gco ' + gcval('L->base + 5') + '\n'
-        'lj-gco ' + gcval('L->base + 6') + '\n'
-        'lj-gco ' + gcval('L->base + 7') + '\n'
+    extension_cmds = ''.join(
+        ('lj-gco ' + gcval('L->base + {}'.format(i)) + '\n'
+         for i in range(GCO_ARGS.count('\n')))
     )
 
     lua_script = (
@@ -485,6 +491,65 @@ class TestLJGCo(TestCaseBase):
     pattern = GCO_RX
 
 
+class TestLJGCoFFUnknown(TestCaseBase):
+    location = 'lj_cf_print'
+
+    val = '((GCfuncC *)' + gcval('L->base') + ')'
+    extension_cmds = (
+        'lj-gco ' + val + '\n' +
+        modify_obj_cmd(val + '->ffid', 242) + '\n'
+        'lj-gco ' + val + '\n' +
+        modify_obj_cmd(val + '->ffid', 253) + '\n'
+        'lj-gco ' + val + '\n'
+    )
+
+    lua_script = 'print(pcall)'
+
+    pattern = (
+        r'fast function pcall \(#[0-9]+\)\n'
+        r'fast function unknown \(#242\)\n'
+        r'fast function unknown \(#253\)\n'
+    )
+
+
+class TestLJFuncFFKnown(TestCaseBase):
+    location = 'lj_cf_print'
+    extension_cmds = ''.join(
+        ('lj-func ' + gcval('L->base + {}'.format(i)) + '\n'
+         for i in range(FFUNC_ARGS.count('\n')))
+    )
+
+    lua_script = (
+        'print(\n' +
+        FFUNC_ARGS +
+        '  1\n'  # Stub for the pattern.
+        ')\n'
+    )
+
+    pattern = FFUNC_RX
+
+
+class TestLJFuncFFUnknown(TestCaseBase):
+    location = 'lj_cf_print'
+
+    val = '((GCfuncC *)' + gcval('L->base') + ')'
+    extension_cmds = (
+        'lj-func ' + val + '\n' +
+        modify_obj_cmd(val + '->ffid', 242) + '\n'
+        'lj-func ' + val + '\n' +
+        modify_obj_cmd(val + '->ffid', 253) + '\n'
+        'lj-func ' + val + '\n'
+    )
+
+    lua_script = 'print(pcall)'
+
+    pattern = (
+        r'fast function pcall \(#[0-9]+\)\n'
+        r'fast function unknown \(#242\)\n'
+        r'fast function unknown \(#253\)\n'
+    )
+
+
 PROTO_FUNC_SCRIPT = (
     'local uvname = false\n'
     'local function testf(...)\n'
-- 
2.55.0



More information about the Tarantool-patches mailing list