[4/7] Add gdb.Frame.static_link method
Checks
Context |
Check |
Description |
linaro-tcwg-bot/tcwg_gdb_build--master-aarch64 |
success
|
Testing passed
|
linaro-tcwg-bot/tcwg_gdb_check--master-aarch64 |
success
|
Testing passed
|
linaro-tcwg-bot/tcwg_gdb_check--master-arm |
success
|
Testing passed
|
linaro-tcwg-bot/tcwg_gdb_build--master-arm |
success
|
Testing passed
|
Commit Message
This adds a new gdb.Frame.static_link method to the gdb Python layer.
This can be used to find the static link frame for a given frame.
---
gdb/NEWS | 3 +++
gdb/doc/python.texi | 10 ++++++++++
gdb/python/py-frame.c | 26 ++++++++++++++++++++++++++
3 files changed, 39 insertions(+)
Comments
> From: Tom Tromey <tromey@adacore.com>
> Date: Wed, 01 Nov 2023 11:09:36 -0600
>
> This adds a new gdb.Frame.static_link method to the gdb Python layer.
> This can be used to find the static link frame for a given frame.
> ---
> gdb/NEWS | 3 +++
> gdb/doc/python.texi | 10 ++++++++++
> gdb/python/py-frame.c | 26 ++++++++++++++++++++++++++
> 3 files changed, 39 insertions(+)
The documentation parts of this patch are okay. Thanks.
Reviewed-By: Eli Zaretskii <eliz@gnu.org>
@@ -17,6 +17,9 @@
** New read/write attribute gdb.Value.bytes that contains a bytes
object holding the contents of this value.
+ ** New method gdb.Frame.static_link that returns the outer frame
+ of a nested function frame.
+
*** Changes in GDB 14
* GDB now supports the AArch64 Scalable Matrix Extension 2 (SME2), which
@@ -5732,6 +5732,16 @@ Set this frame to be the selected frame. @xref{Stack, ,Examining the
Stack}.
@end defun
+@defun Frame.static_link ()
+In some languages (e.g., Ada, but also a GNU C extension), a nested
+function can access the variables in the outer scope. This is done
+via a ``static link'', which is a reference from the nested frame to
+the appropriate outer frame.
+
+This method returns this frame's static link frame, if one exists. If
+there is no static link, this method returns @code{None}.
+@end defun
+
@defun Frame.level ()
Return an integer, the stack frame level for this frame. @xref{Frames, ,Stack Frames}.
@end defun
@@ -622,6 +622,30 @@ frapy_language (PyObject *self, PyObject *args)
Py_RETURN_NONE;
}
+/* The static link for this frame. */
+
+static PyObject *
+frapy_static_link (PyObject *self, PyObject *args)
+{
+ frame_info_ptr link;
+
+ try
+ {
+ FRAPY_REQUIRE_VALID (self, link);
+
+ link = frame_follow_static_link (link);
+ }
+ catch (const gdb_exception &except)
+ {
+ GDB_PY_HANDLE_EXCEPTION (except);
+ }
+
+ if (link == nullptr)
+ Py_RETURN_NONE;
+
+ return frame_info_to_frame_object (link);
+}
+
/* Implementation of gdb.newest_frame () -> gdb.Frame.
Returns the newest frame object. */
@@ -800,6 +824,8 @@ Return the value of the variable in this frame." },
"The stack level of this frame." },
{ "language", frapy_language, METH_NOARGS,
"The language of this frame." },
+ { "static_link", frapy_static_link, METH_NOARGS,
+ "The static link of this frame, or None." },
{NULL} /* Sentinel */
};