Thanks to visit codestin.com
Credit goes to github.com

Skip to content

gh-142095: Use thread local frame info in py-bt and py-bt-full when available #143371

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
colesbury merged 10 commits into from
Jan 8, 2026
Merged

gh-142095: Use thread local frame info in py-bt and py-bt-full when available #143371

Changes from 1 commit
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
5072ec0
gh-142095: Add py-bt-tss command to python-gdb.py
vstinner Dec 18, 2025
e37a049
Merge command into py-bt and fix free threaded build
colesbury Jan 2, 2026
92b5c73
Add blurb
colesbury Jan 2, 2026
64a5436
More fixes and refactoring
colesbury Jan 2, 2026
9d0e6ba
Remove type hint
colesbury Jan 3, 2026
a44b2a7
Support older versions of Python
colesbury Jan 5, 2026
972ea0f
Update Tools/gdb/libpython.py
colesbury Jan 7, 2026
ef13286
Update Tools/gdb/libpython.py
colesbury Jan 7, 2026
bda098e
Update Tools/gdb/libpython.py
colesbury Jan 7, 2026
32b353e
Flatten code
colesbury Jan 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
More fixes and refactoring
  • Loading branch information
@colesbury
colesbury committed Jan 2, 2026
commit 64a5436b7e9d0c9da8780b61e781dd0badb27871
153 changes: 74 additions & 79 deletions Tools/gdb/libpython.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1039,12 +1039,6 @@ def write_repr(self, out, visited):
return
return self._frame.write_repr(out, visited)

def print_traceback(self):
if self.is_optimized_out():
sys.stdout.write(' %s\n' % FRAME_INFO_OPTIMIZED_OUT)
return
return self._frame.print_traceback()

class PyFramePtr:

def __init__(self, gdbval):
Expand All @@ -1061,6 +1055,17 @@ def __init__(self, gdbval):
pnames = self.co.field('co_localsplusnames')
self.co_localsplusnames = PyTupleObjectPtr.from_pyobject_ptr(pnames)

@staticmethod
def get_thread_local_frame():
try:
return PyFramePtr(gdb.parse_and_eval('_Py_tss_gilstate->current_frame'))
except gdb.error:
pass
try:
return PyFramePtr(gdb.parse_and_eval('_Py_tss_tstate->current_frame'))
except gdb.error:
return None

def is_optimized_out(self):
return self._gdbval.is_optimized_out

Expand Down Expand Up @@ -1247,6 +1252,26 @@ def print_traceback(self):
lineno,
self.co_name.proxyval(visited)))

def print_traceback_until_shim(self, frame_index: int | None = None):
# Print traceback for _PyInterpreterFrame and return previous frame
interp_frame = self
while True:
if not interp_frame:
sys.stdout.write(' (unable to read python frame information)\n')
return None
elif interp_frame.is_shim():
return interp_frame.previous()
Comment thread
colesbury marked this conversation as resolved.
if frame_index is not None:
line = interp_frame.get_truncated_repr(MAX_OUTPUT_LEN)
sys.stdout.write('#%i %s\n' % (frame_index, line))
else:
interp_frame.print_traceback()
if not interp_frame.is_optimized_out():
line = interp_frame.current_line()
if line is not None:
sys.stdout.write(' %s\n' % line.strip())
interp_frame = interp_frame.previous()

def get_truncated_repr(self, maxlen):
'''
Get a repr-like string for the data, but truncate it at "maxlen" bytes
Expand Down Expand Up @@ -1859,50 +1884,17 @@ def get_selected_bytecode_frame(cls):
def print_summary(self):
if self.is_evalframe():
interp_frame = self.get_pyop()
while True:
if interp_frame:
if interp_frame.is_shim():
break
line = interp_frame.get_truncated_repr(MAX_OUTPUT_LEN)
sys.stdout.write('#%i %s\n' % (self.get_index(), line))
if not interp_frame.is_optimized_out():
line = interp_frame.current_line()
if line is not None:
sys.stdout.write(' %s\n' % line.strip())
else:
sys.stdout.write('#%i (unable to read python frame information)\n' % self.get_index())
break
interp_frame = interp_frame.previous()
if interp_frame:
interp_frame.print_traceback_until_shim(self.get_index())
else:
sys.stdout.write('#%i (unable to read python frame information)\n' % self.get_index())
else:
info = self.is_other_python_frame()
if info:
sys.stdout.write('#%i %s\n' % (self.get_index(), info))
else:
sys.stdout.write('#%i\n' % self.get_index())

def print_traceback(self):
if self.is_evalframe():
interp_frame = self.get_pyop()
while True:
if interp_frame:
if interp_frame.is_shim():
break
interp_frame.print_traceback()
if not interp_frame.is_optimized_out():
line = interp_frame.current_line()
if line is not None:
sys.stdout.write(' %s\n' % line.strip())
else:
sys.stdout.write(' (unable to read python frame information)\n')
break
interp_frame = interp_frame.previous()
else:
info = self.is_other_python_frame()
if info:
sys.stdout.write(' %s\n' % info)
else:
sys.stdout.write(' (not a python frame)\n')

class PyList(gdb.Command):
'''List the current Python source code, if any

Expand Down Expand Up @@ -2046,6 +2038,43 @@ def invoke(self, args, from_tty):
PyUp()
PyDown()


def print_traceback_helper(full_info):
frame = Frame.get_selected_python_frame()
interp_frame = PyFramePtr.get_thread_local_frame()
if not frame and not interp_frame:
print('Unable to locate python frame')
return

sys.stdout.write('Traceback (most recent call first):\n')
if frame:
while frame:
frame_index = frame.get_index() if full_info else None
if frame.is_evalframe():
pyop = frame.get_pyop()
if pyop is not None:
# Use the _PyInterpreterFrame from the gdb frame
interp_frame = pyop
if interp_frame:
interp_frame = interp_frame.print_traceback_until_shim(frame_index)
else:
sys.stdout.write(' (unable to read python frame information)\n')
else:
info = frame.is_other_python_frame()
if full_info:
if info:
sys.stdout.write('#%i %s\n' % (frame_index, info))
else:
sys.stdout.write('#%i\n' % frame_index)
Comment thread
colesbury marked this conversation as resolved.
Outdated
elif info:
sys.stdout.write(' %s\n' % info)
frame = frame.older()
else:
# Fall back to just using the thread-local frame
while interp_frame:
interp_frame = interp_frame.print_traceback_until_shim()


class PyBacktraceFull(gdb.Command):
'Display the current python frame and all the frames within its call stack (if any)'
def __init__(self):
Expand All @@ -2056,15 +2085,7 @@ def __init__(self):


def invoke(self, args, from_tty):
frame = Frame.get_selected_python_frame()
if not frame:
print('Unable to locate python frame')
return

while frame:
if frame.is_python_frame():
frame.print_summary()
frame = frame.older()
print_traceback_helper(full_info=True)

PyBacktraceFull()

Expand All @@ -2076,34 +2097,8 @@ def __init__(self):
gdb.COMMAND_STACK,
gdb.COMPLETE_NONE)

@staticmethod
def get_interp_frame():
try:
return PyFramePtr(gdb.parse_and_eval('_Py_tss_gilstate->current_frame'))
except gdb.error:
pass
try:
return PyFramePtr(gdb.parse_and_eval('_Py_tss_tstate->current_frame'))
except gdb.error:
return None

def invoke(self, args, from_tty):
if iframe := PyBacktrace.get_interp_frame():
# Use the _PyInterpreterFrame in thread local state
print('Traceback (most recent call first):')
while iframe:
if not iframe.is_shim():
iframe.print_traceback()
iframe = iframe.previous()
elif frame := Frame.get_selected_python_frame():
# Try the selected frame route
sys.stdout.write('Traceback (most recent call first):\n')
while frame:
if frame.is_python_frame():
frame.print_traceback()
frame = frame.older()
else:
print('Unable to locate python frame')
print_traceback_helper(full_info=False)

PyBacktrace()

Expand Down
Loading