Skip to content

[3.8] bpo-15817: gdbinit: Document commands after defining them (GH-15021) #15744

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
merged 1 commit into from
Sep 9, 2019
Merged

[3.8] bpo-15817: gdbinit: Document commands after defining them (GH-15021) #15744

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
46 changes: 23 additions & 23 deletions Misc/gdbinit
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,30 +14,27 @@
# with embedded macros that you may find superior to what is in here.
# See Tools/gdb/libpython.py and http://bugs.python.org/issue8032.

document pyo
Prints a representation of the object to stderr, along with the
number of reference counts it currently has and the hex address the
object is allocated at. The argument must be a PyObject*
end
define pyo
# side effect of calling _PyObject_Dump is to dump the object's
# info - assigning just prevents gdb from printing the
# NULL return value
set $_unused_void = _PyObject_Dump($arg0)
end

document pyg
document pyo
Prints a representation of the object to stderr, along with the
number of reference counts it currently has and the hex address the
object is allocated at. The argument must be a PyGC_Head*
object is allocated at. The argument must be a PyObject*
end

define pyg
print _PyGC_Dump($arg0)
end

document pylocals
Print the local variables of the current frame.
document pyg
Prints a representation of the object to stderr, along with the
number of reference counts it currently has and the hex address the
object is allocated at. The argument must be a PyGC_Head*
end

define pylocals
set $_i = 0
while $_i < f->f_code->co_nlocals
Expand All @@ -50,6 +47,9 @@ define pylocals
set $_i = $_i + 1
end
end
document pylocals
Print the local variables of the current frame.
end

# A rewrite of the Python interpreter's line number calculator in GDB's
# command language
Expand All @@ -75,13 +75,13 @@ define lineno
printf "%d", $__li
end

document pyframev
Print the current frame - verbose
end
define pyframev
pyframe
pylocals
end
document pyframev
Print the current frame - verbose
end

define pyframe
set $__fn = PyUnicode_AsUTF8(f->f_code->co_filename)
Expand Down Expand Up @@ -134,9 +134,6 @@ end
# the interpreter you may will have to change the functions you compare with
# $pc.

document pystack
Print the entire Python call stack
end
define pystack
while $pc < Py_Main || $pc > Py_GetArgcArgv
if $pc > PyEval_EvalFrameEx && $pc < _PyEval_EvalFrameDefault
Expand All @@ -146,10 +143,10 @@ define pystack
end
select-frame 0
end

document pystackv
Print the entire Python call stack - verbose mode
document pystack
Print the entire Python call stack
end

define pystackv
while $pc < Py_Main || $pc > Py_GetArgcArgv
if $pc > PyEval_EvalFrameEx && $pc < _PyEval_EvalFrameDefault
Expand All @@ -159,10 +156,10 @@ define pystackv
end
select-frame 0
end

document pu
Generally useful macro to print a Unicode string
document pystackv
Print the entire Python call stack - verbose mode
end

def pu
set $uni = $arg0
set $i = 0
Expand All @@ -174,3 +171,6 @@ def pu
end
end
end
document pu
Generally useful macro to print a Unicode string
end