8sa1-binutils-gdb/gdb/testsuite/gdb.python
Andrew Burgess 0f767f942b 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-07-06 15:06:06 +01:00
..
amd64-py-framefilter-invalidarg.S Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
lib-types.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
lib-types.exp [gdb/testsuite] Fix xpass in gdb.python/lib-types.exp 2020-02-19 22:57:19 +01:00
py-arch-reg-names.exp gdb/python: Add gdb.Architecture.registers method 2020-07-06 15:06:06 +01:00
py-arch.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-arch.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-as-string.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-as-string.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-bad-printers.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-bad-printers.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-bad-printers.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-block.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-block.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-breakpoint-create-fail.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-breakpoint-create-fail.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-breakpoint-create-fail.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-breakpoint.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-breakpoint.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-caller-is.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-caller-is.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-cmd.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-cmd.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-completion.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-completion.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-error.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-error.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-events-shlib.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-events.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-events.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-events.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-evsignal.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-evthreads.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-evthreads.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-explore-cc.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-explore.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-explore.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-explore.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-finish-breakpoint2.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-finish-breakpoint2.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-finish-breakpoint2.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-finish-breakpoint.c Fix "control reaches end of non-void function" errors in testsuite 2020-05-15 15:03:42 +01:00
py-finish-breakpoint.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-finish-breakpoint.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-format-string.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-format-string.exp Fix TCL error in gdb.python/py-format-string.exp. 2020-06-17 13:43:32 -07:00
py-format-string.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-frame-args.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-frame-args.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-frame-args.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-frame-inline.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-frame-inline.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-frame.c
py-frame.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter-gdb.py.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter-invalidarg-gdb.py.in Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter-invalidarg.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter-invalidarg.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter-mi.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter-mi.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-framefilter.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-function.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-inferior.c
py-inferior.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-infthread.c
py-infthread.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-lazy-string.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-lazy-string.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-linetable.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-linetable.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-linetable.S Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-lookup-type.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-events-gdb.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-events.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-events.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-objfile-gdb.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-objfile.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-objfile.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-var-info-path-expression.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-var-info-path-expression.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi-var-info-path-expression.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-mi.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-nested-maps.c Add two missing return values in gdb.python/py-nested-maps.c 2020-06-16 12:41:28 +01:00
py-nested-maps.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-nested-maps.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-objfile-script-gdb.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-objfile-script.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-objfile-script.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-objfile.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-objfile.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-parameter.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-pp-integral.c Improve -Wunused-value testcase build failures fix 2020-06-23 15:11:27 +01:00
py-pp-integral.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-integral.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-maint.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-maint.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-maint.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-re-notag.c Improve -Wunused-value testcase build failures fix 2020-06-23 15:11:27 +01:00
py-pp-re-notag.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-re-notag.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-registration.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-registration.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-pp-registration.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-prettyprint.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-prettyprint.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-prettyprint.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-progspace.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-progspace.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-prompt.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-prompt.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-rbreak-func2.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-rbreak.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-rbreak.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-record-btrace-threads.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-record-btrace-threads.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-record-btrace.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-record-btrace.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-record-full.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-record-full.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-recurse-unwind.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-recurse-unwind.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-recurse-unwind.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-rvalue-ref-value-cc.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-rvalue-ref-value-cc.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-section-script.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-section-script.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-section-script.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-shared-sl.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-shared.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-shared.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-strfns.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-strfns.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-symbol-2.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-symbol.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-symbol.exp Use the linkage name if it exists 2020-04-24 15:35:03 -06:00
py-symtab.exp [gdb/testsuite] Add xfails for PR gcc/90232 2020-04-29 13:22:21 +02:00
py-sync-interp.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-sync-interp.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-template.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-template.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-thrhandle.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-thrhandle.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-type.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-type.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-typeprint.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-typeprint.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-typeprint.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-unwind-maint.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-unwind-maint.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-unwind-maint.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-unwind.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-unwind.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-unwind.py gdb/python: Add architecture method to gdb.PendingFrame 2020-07-06 15:06:05 +01:00
py-value-cc.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-value-cc.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-value.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-value.exp Fix test breakages caused by removal of gdb_py_test_multiple. 2020-06-30 18:40:21 +02:00
py-xmethods.cc Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-xmethods.exp Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
py-xmethods.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
python-1.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
python.c Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
python.exp Make test names unique in python.exp and guile.exp 2020-06-26 22:04:46 +02:00
source1 Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
source2.py Update copyright year range in all GDB files. 2020-01-01 10:20:53 +04:00
tui-window.exp Fix crash when TUI window creation fails 2020-06-16 17:48:38 -06:00
tui-window.py Fix crash when TUI window creation fails 2020-06-16 17:48:38 -06:00