GDB (xrefs)
Loading...
Searching...
No Matches
py-membuf.c
Go to the documentation of this file.
1/* Python memory buffer interface for reading inferior memory.
2
3 Copyright (C) 2009-2023 Free Software Foundation, Inc.
4
5 This file is part of GDB.
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
19
20#include "defs.h"
21#include "python-internal.h"
22
24 PyObject_HEAD
25
26 /* Pointer to the raw data, and array of gdb_bytes. */
27 void *buffer;
28
29 /* The address from where the data was read, held for mbpy_str. */
30 CORE_ADDR addr;
31
32 /* The number of octets in BUFFER. */
33 CORE_ADDR length;
34};
35
36extern PyTypeObject membuf_object_type
38
39/* Wrap BUFFER, ADDRESS, and LENGTH into a gdb.Membuf object. ADDRESS is
40 the address within the inferior that the contents of BUFFER were read,
41 and LENGTH is the number of octets in BUFFER. */
42
44gdbpy_buffer_to_membuf (gdb::unique_xmalloc_ptr<gdb_byte> buffer,
45 CORE_ADDR address,
46 ULONGEST length)
47{
48 gdbpy_ref<membuf_object> membuf_obj (PyObject_New (membuf_object,
50 if (membuf_obj == nullptr)
51 return nullptr;
52
53 membuf_obj->buffer = buffer.release ();
54 membuf_obj->addr = address;
55 membuf_obj->length = length;
56
57 return PyMemoryView_FromObject ((PyObject *) membuf_obj.get ());
58}
59
60/* Destructor for gdb.Membuf objects. */
61
62static void
64{
65 xfree (((membuf_object *) self)->buffer);
66 Py_TYPE (self)->tp_free (self);
67}
68
69/* Return a description of the gdb.Membuf object. */
70
71static PyObject *
73{
74 membuf_object *membuf_obj = (membuf_object *) self;
75
76 return PyUnicode_FromFormat (_("Memory buffer for address %s, \
77which is %s bytes long."),
79 membuf_obj->addr),
80 pulongest (membuf_obj->length));
81}
82
83static int
84get_buffer (PyObject *self, Py_buffer *buf, int flags)
85{
86 membuf_object *membuf_obj = (membuf_object *) self;
87 int ret;
88
89 ret = PyBuffer_FillInfo (buf, self, membuf_obj->buffer,
90 membuf_obj->length, 0,
91 PyBUF_CONTIG);
92
93 /* Despite the documentation saying this field is a "const char *",
94 in Python 3.4 at least, it's really a "char *". */
95 buf->format = (char *) "c";
96
97 return ret;
98}
99
100/* General Python initialization callback. */
101
104{
105 membuf_object_type.tp_new = PyType_GenericNew;
106 if (PyType_Ready (&membuf_object_type) < 0)
107 return -1;
108
109 return gdb_pymodule_addobject (gdb_module, "Membuf",
111}
112
114
115
116
117static PyBufferProcs buffer_procs =
118{
120};
121
122PyTypeObject membuf_object_type = {
123 PyVarObject_HEAD_INIT (nullptr, 0)
124 "gdb.Membuf", /*tp_name*/
125 sizeof (membuf_object), /*tp_basicsize*/
126 0, /*tp_itemsize*/
127 mbpy_dealloc, /*tp_dealloc*/
128 0, /*tp_print*/
129 0, /*tp_getattr*/
130 0, /*tp_setattr*/
131 0, /*tp_compare*/
132 0, /*tp_repr*/
133 0, /*tp_as_number*/
134 0, /*tp_as_sequence*/
135 0, /*tp_as_mapping*/
136 0, /*tp_hash */
137 0, /*tp_call*/
138 mbpy_str, /*tp_str*/
139 0, /*tp_getattro*/
140 0, /*tp_setattro*/
141 &buffer_procs, /*tp_as_buffer*/
142 Py_TPFLAGS_DEFAULT, /*tp_flags*/
143 "GDB memory buffer object", /*tp_doc*/
144 0, /* tp_traverse */
145 0, /* tp_clear */
146 0, /* tp_richcompare */
147 0, /* tp_weaklistoffset */
148 0, /* tp_iter */
149 0, /* tp_iternext */
150 0, /* tp_methods */
151 0, /* tp_members */
152 0, /* tp_getset */
153 0, /* tp_base */
154 0, /* tp_dict */
155 0, /* tp_descr_get */
156 0, /* tp_descr_set */
157 0, /* tp_dictoffset */
158 0, /* tp_init */
159 0, /* tp_alloc */
160};
void xfree(void *)
static struct gdbarch * get_gdbarch()
mach_port_t kern_return_t mach_port_t mach_msg_type_name_t msgportsPoly mach_port_t kern_return_t pid_t pid mach_port_t kern_return_t mach_port_t task mach_port_t kern_return_t int flags
Definition gnu-nat.c:1861
PyObject * gdbpy_buffer_to_membuf(gdb::unique_xmalloc_ptr< gdb_byte > buffer, CORE_ADDR address, ULONGEST length)
Definition py-membuf.c:44
static PyBufferProcs buffer_procs
Definition py-membuf.c:117
static void mbpy_dealloc(PyObject *self)
Definition py-membuf.c:63
PyTypeObject membuf_object_type
Definition py-membuf.c:122
static PyObject * mbpy_str(PyObject *self)
Definition py-membuf.c:72
static int CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION gdbpy_initialize_membuf(void)
Definition py-membuf.c:103
static int get_buffer(PyObject *self, Py_buffer *buf, int flags)
Definition py-membuf.c:84
gdb::ref_ptr< T, gdbpy_ref_policy< T > > gdbpy_ref
Definition py-ref.h:42
int gdb_pymodule_addobject(PyObject *module, const char *name, PyObject *object)
Definition py-utils.c:334
PyObject * gdb_module
#define CPYCHECKER_TYPE_OBJECT_FOR_TYPEDEF(ARG)
#define CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION
#define GDBPY_INITIALIZE_FILE(INIT,...)
PyObject_HEAD void * buffer
Definition py-membuf.c:27
CORE_ADDR length
Definition py-membuf.c:33
CORE_ADDR addr
Definition py-membuf.c:30
const char * paddress(struct gdbarch *gdbarch, CORE_ADDR addr)
Definition utils.c:3166
int PyObject
Definition varobj.c:41