binutils-gdb/gdb/testsuite/gdb.python/py-arch-reg-names.exp

122 lines
3.7 KiB
Plaintext
Raw Normal View History

# Copyright 2020-2021 Free Software Foundation, Inc.
gdb/python: Add gdb.Architecture.registers method This commit adds a new method gdb.Architecture.registers that returns an object of the new type gdb.RegisterDescriptorIterator. This iterator returns objects of the new type gdb.RegisterDescriptor. A RegisterDescriptor is not a way to read the value of a register, this is already covered by Frame.read_register, a RegisterDescriptor is simply a way to discover from Python, which registers are available for a given architecture. I did consider just returning a string, the name of each register, instead of a RegisterDescriptor, however, I'm aware that it we don't want to break the existing Python API in any way, so if I return just a string now, but in the future we want more information about a register then we would have to add a second API to get that information. By going straight to a descriptor object now, it is easy to add additional properties in the future should we wish to. Right now the only property of a register that a user can access is the name of the register. In future we might want to be able to ask the register about is register groups, or its type. gdb/ChangeLog: * Makefile.in (SUBDIR_PYTHON_SRCS): Add py-registers.c * python/py-arch.c (archpy_registers): New function. (arch_object_methods): Add 'registers' method. * python/py-registers.c: New file. * python/python-internal.h (gdbpy_new_register_descriptor_iterator): Declare. (gdbpy_initialize_registers): Declare. * python/python.c (do_start_initialization): Call gdbpy_initialize_registers. * NEWS: Mention additions to the Python API. gdb/testsuite/ChangeLog: * gdb.python/py-arch-reg-names.exp: New file. gdb/doc/ChangeLog: * python.texi (Python API): Add new section the menu. (Frames In Python): Add new @anchor. (Architectures In Python): Document new registers method. (Registers In Python): New section.
2020-06-06 00:52:10 +08:00
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
# Check the gdb.Architecture.registers functionality.
load_lib gdb-python.exp
standard_testfile py-arch.c
if { [prepare_for_testing "failed to prepare" ${testfile} ${srcfile}] } {
return -1
}
# Skip all tests if Python scripting is not enabled.
if { [skip_python_tests] } { continue }
if ![runto_main] {
return -1
}
# First, use 'info registers' to get a list of register names.
set regs {}
gdb_test_multiple "info registers general" "info registers general" {
-re "^info registers general\r\n" {
exp_continue
}
-re "^(\[^ \t\]+)\[ \t\]+\[^\r\n\]+\r\n" {
set reg $expect_out(1,string)
lappend regs $reg
exp_continue
}
-re "^$gdb_prompt " {
}
}
gdb_assert {[llength $regs] > 0} \
"Found at least one register"
# Now get the same register names using Python API.
gdb_py_test_silent_cmd \
"python frame = gdb.selected_frame()" "get frame" 0
gdb_py_test_silent_cmd \
"python arch = frame.architecture()" "get arch" 0
gdb_py_test_silent_cmd \
"python regs = list (arch.registers (\"general\"))" \
"get general registers" 0
gdb_py_test_silent_cmd \
"python regs = map (lambda r : r.name, regs)" \
"get names of general registers" 0
set py_regs {}
gdb_test_multiple "python print (\"\\n\".join (regs))" \
"general register from python" {
-re "^python print \[^\r\n\]+\r\n" {
exp_continue
}
-re "^(\[^\r\n\]+)\r\n" {
set reg $expect_out(1,string)
lappend py_regs $reg
exp_continue
}
-re "^$gdb_prompt " {
}
}
gdb_assert {[llength $py_regs] > 0} \
"Found at least one register from python"
gdb_assert {[llength $py_regs] == [llength $regs]} \
"Same numnber of registers found"
set found_non_match 0
for { set i 0 } { $i < [llength $regs] } { incr i } {
if {[lindex $regs $i] != [lindex $py_regs $i]} {
set found_non_match 1
}
}
gdb_assert { $found_non_match == 0 } "all registers match"
# Check that we get the same register descriptors from two different
# iterators.
gdb_py_test_silent_cmd \
"python iter1 = arch.registers ()" \
"get first all register iterator" 0
gdb_py_test_silent_cmd \
"python iter2 = arch.registers ()" \
"get second all register iterator" 0
gdb_py_test_silent_cmd \
[multi_line_input \
"python" \
"for r1, r2 in zip(iter1, iter2):" \
" if (r1.name != r2.name):"\
" raise gdb.GdbError (\"miss-matched names\")" \
" if (r1 != r2):" \
" raise gdb.GdbError (\"miss-matched objects\")" \
"\004" ] \
"check names and objects match" 1
# Ensure that the '.find' method on the iterator returns the same
# Python object as we got from the iterator's list of descriptors.
gdb_py_test_silent_cmd \
[multi_line \
"python" \
"def check_regs (arch, regs):" \
" for r in (regs):" \
" if (arch.registers ().find (r.name) != r):" \
" raise gdb.GdbError (\"object miss-match\")" \
"end" ] \
"build check_obj function" 0
gdb_py_test_silent_cmd \
"python check_regs (arch, arch.registers (\"general\"))" \
"ensure find gets expected descriptors" 1