diff options
author | Andrew Burgess <andrew.burgess@embecosm.com> | 2020-06-05 17:52:10 +0100 |
---|---|---|
committer | Andrew Burgess <andrew.burgess@embecosm.com> | 2020-07-06 15:06:06 +0100 |
commit | 0f767f942b027df6de60c42ed0e4a1dac7d0fd4b (patch) | |
tree | 8622c96b1d3daffec478f33519bf2011c87e63ac /gdb/doc/ChangeLog | |
parent | 87dbc77459930f8f65a6d7d1e1db498da4aa74d6 (diff) | |
download | gdb-0f767f942b027df6de60c42ed0e4a1dac7d0fd4b.zip gdb-0f767f942b027df6de60c42ed0e4a1dac7d0fd4b.tar.gz gdb-0f767f942b027df6de60c42ed0e4a1dac7d0fd4b.tar.bz2 |
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.
Diffstat (limited to 'gdb/doc/ChangeLog')
-rw-r--r-- | gdb/doc/ChangeLog | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 82ed257..d513d74 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,5 +1,12 @@ 2020-07-06 Andrew Burgess <andrew.burgess@embecosm.com> + * python.texi (Python API): Add new section to the menu. + (Frames In Python): Add new @anchor. + (Architectures In Python): Document new registers method. + (Registers In Python): New section. + +2020-07-06 Andrew Burgess <andrew.burgess@embecosm.com> + * python.texi (Unwinding Frames in Python): Document PendingFrame.architecture method. |