MIPS: Fix microMIPS instruction size determination
[deliverable/binutils-gdb.git] / gdb / python / py-infthread.c
CommitLineData
595939de
PM
1/* Python interface to inferior threads.
2
618f726f 3 Copyright (C) 2009-2016 Free Software Foundation, Inc.
595939de
PM
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"
595939de
PM
21#include "gdbthread.h"
22#include "inferior.h"
23#include "python-internal.h"
24
e36122e9 25extern PyTypeObject thread_object_type
62eec1a5 26 CPYCHECKER_TYPE_OBJECT_FOR_TYPEDEF ("thread_object");
595939de
PM
27
28/* Require that INFERIOR be a valid inferior ID. */
29#define THPY_REQUIRE_VALID(Thread) \
30 do { \
31 if (!Thread->thread) \
32 { \
33 PyErr_SetString (PyExc_RuntimeError, \
34 _("Thread no longer exists.")); \
35 return NULL; \
36 } \
37 } while (0)
38
595939de
PM
39thread_object *
40create_thread_object (struct thread_info *tp)
41{
42 thread_object *thread_obj;
43
44 thread_obj = PyObject_New (thread_object, &thread_object_type);
45 if (!thread_obj)
46 return NULL;
47
48 thread_obj->thread = tp;
dfd4cc63 49 thread_obj->inf_obj = find_inferior_object (ptid_get_pid (tp->ptid));
595939de
PM
50
51 return thread_obj;
52}
53
595939de
PM
54static void
55thpy_dealloc (PyObject *self)
56{
57 Py_DECREF (((thread_object *) self)->inf_obj);
9a27f2c6 58 Py_TYPE (self)->tp_free (self);
595939de
PM
59}
60
4694da01
TT
61static PyObject *
62thpy_get_name (PyObject *self, void *ignore)
63{
64 thread_object *thread_obj = (thread_object *) self;
73ede765 65 const char *name;
4694da01
TT
66
67 THPY_REQUIRE_VALID (thread_obj);
68
69 name = thread_obj->thread->name;
70 if (name == NULL)
71 name = target_thread_name (thread_obj->thread);
72
73 if (name == NULL)
74 Py_RETURN_NONE;
75
76 return PyString_FromString (name);
77}
78
79static int
80thpy_set_name (PyObject *self, PyObject *newvalue, void *ignore)
81{
82 thread_object *thread_obj = (thread_object *) self;
83 char *name;
84
85 if (! thread_obj->thread)
86 {
87 PyErr_SetString (PyExc_RuntimeError, _("Thread no longer exists."));
88 return -1;
89 }
90
91 if (newvalue == NULL)
92 {
256458bc 93 PyErr_SetString (PyExc_TypeError,
4694da01
TT
94 _("Cannot delete `name' attribute."));
95 return -1;
96 }
97 else if (newvalue == Py_None)
98 name = NULL;
99 else if (! gdbpy_is_string (newvalue))
100 {
101 PyErr_SetString (PyExc_TypeError,
102 _("The value of `name' must be a string."));
103 return -1;
104 }
105 else
106 {
107 name = python_string_to_host_string (newvalue);
108 if (! name)
109 return -1;
110 }
111
112 xfree (thread_obj->thread->name);
113 thread_obj->thread->name = name;
114
115 return 0;
116}
117
5d5658a1
PA
118/* Getter for InferiorThread.num. */
119
595939de
PM
120static PyObject *
121thpy_get_num (PyObject *self, void *closure)
122{
123 thread_object *thread_obj = (thread_object *) self;
124
125 THPY_REQUIRE_VALID (thread_obj);
126
5d5658a1 127 return PyLong_FromLong (thread_obj->thread->per_inf_num);
595939de
PM
128}
129
22a02324
PA
130/* Getter for InferiorThread.global_num. */
131
132static PyObject *
133thpy_get_global_num (PyObject *self, void *closure)
134{
135 thread_object *thread_obj = (thread_object *) self;
136
137 THPY_REQUIRE_VALID (thread_obj);
138
139 return PyLong_FromLong (thread_obj->thread->global_num);
140}
141
595939de
PM
142/* Getter for InferiorThread.ptid -> (pid, lwp, tid).
143 Returns a tuple with the thread's ptid components. */
007baf27 144
595939de
PM
145static PyObject *
146thpy_get_ptid (PyObject *self, void *closure)
147{
148 int pid;
149 long tid, lwp;
150 thread_object *thread_obj = (thread_object *) self;
595939de
PM
151
152 THPY_REQUIRE_VALID (thread_obj);
153
162078c8 154 return gdbpy_create_ptid_object (thread_obj->thread->ptid);
595939de
PM
155}
156
84654457
PA
157/* Getter for InferiorThread.inferior -> Inferior. */
158
159static PyObject *
160thpy_get_inferior (PyObject *self, void *ignore)
161{
162 thread_object *thread_obj = (thread_object *) self;
163
164 THPY_REQUIRE_VALID (thread_obj);
165
166 return thread_obj->inf_obj;
167}
168
595939de
PM
169/* Implementation of InferiorThread.switch ().
170 Makes this the GDB selected thread. */
007baf27 171
595939de
PM
172static PyObject *
173thpy_switch (PyObject *self, PyObject *args)
174{
175 thread_object *thread_obj = (thread_object *) self;
595939de
PM
176
177 THPY_REQUIRE_VALID (thread_obj);
178
492d29ea 179 TRY
595939de
PM
180 {
181 switch_to_thread (thread_obj->thread->ptid);
182 }
492d29ea
PA
183 CATCH (except, RETURN_MASK_ALL)
184 {
185 GDB_PY_HANDLE_EXCEPTION (except);
186 }
187 END_CATCH
595939de
PM
188
189 Py_RETURN_NONE;
190}
191
192/* Implementation of InferiorThread.is_stopped () -> Boolean.
193 Return whether the thread is stopped. */
007baf27 194
595939de
PM
195static PyObject *
196thpy_is_stopped (PyObject *self, PyObject *args)
197{
198 thread_object *thread_obj = (thread_object *) self;
199
200 THPY_REQUIRE_VALID (thread_obj);
201
202 if (is_stopped (thread_obj->thread->ptid))
203 Py_RETURN_TRUE;
204
205 Py_RETURN_FALSE;
206}
207
208/* Implementation of InferiorThread.is_running () -> Boolean.
209 Return whether the thread is running. */
007baf27 210
595939de
PM
211static PyObject *
212thpy_is_running (PyObject *self, PyObject *args)
213{
214 thread_object *thread_obj = (thread_object *) self;
215
216 THPY_REQUIRE_VALID (thread_obj);
217
218 if (is_running (thread_obj->thread->ptid))
219 Py_RETURN_TRUE;
220
221 Py_RETURN_FALSE;
222}
223
224/* Implementation of InferiorThread.is_exited () -> Boolean.
225 Return whether the thread is exited. */
007baf27 226
595939de
PM
227static PyObject *
228thpy_is_exited (PyObject *self, PyObject *args)
229{
230 thread_object *thread_obj = (thread_object *) self;
231
232 THPY_REQUIRE_VALID (thread_obj);
233
234 if (is_exited (thread_obj->thread->ptid))
235 Py_RETURN_TRUE;
236
237 Py_RETURN_FALSE;
238}
239
29703da4
PM
240/* Implementation of gdb.InfThread.is_valid (self) -> Boolean.
241 Returns True if this inferior Thread object still exists
242 in GDB. */
595939de 243
29703da4
PM
244static PyObject *
245thpy_is_valid (PyObject *self, PyObject *args)
246{
247 thread_object *thread_obj = (thread_object *) self;
248
249 if (! thread_obj->thread)
250 Py_RETURN_FALSE;
251
252 Py_RETURN_TRUE;
253}
595939de 254
162078c8
NB
255/* Return a reference to a new Python object representing a ptid_t.
256 The object is a tuple containing (pid, lwp, tid). */
257PyObject *
258gdbpy_create_ptid_object (ptid_t ptid)
259{
260 int pid;
261 long tid, lwp;
262 PyObject *ret;
263
264 ret = PyTuple_New (3);
265 if (!ret)
266 return NULL;
267
268 pid = ptid_get_pid (ptid);
269 lwp = ptid_get_lwp (ptid);
270 tid = ptid_get_tid (ptid);
271
272 PyTuple_SET_ITEM (ret, 0, PyInt_FromLong (pid));
273 PyTuple_SET_ITEM (ret, 1, PyInt_FromLong (lwp));
274 PyTuple_SET_ITEM (ret, 2, PyInt_FromLong (tid));
275
276 return ret;
277}
278
595939de
PM
279/* Implementation of gdb.selected_thread () -> gdb.InferiorThread.
280 Returns the selected thread object. */
007baf27 281
595939de
PM
282PyObject *
283gdbpy_selected_thread (PyObject *self, PyObject *args)
284{
285 PyObject *thread_obj;
286
287 thread_obj = (PyObject *) find_thread_object (inferior_ptid);
288 if (thread_obj)
289 {
290 Py_INCREF (thread_obj);
291 return thread_obj;
292 }
293
294 Py_RETURN_NONE;
295}
296
999633ed 297int
595939de
PM
298gdbpy_initialize_thread (void)
299{
300 if (PyType_Ready (&thread_object_type) < 0)
999633ed 301 return -1;
595939de 302
aa36459a
TT
303 return gdb_pymodule_addobject (gdb_module, "InferiorThread",
304 (PyObject *) &thread_object_type);
595939de
PM
305}
306
595939de
PM
307static PyGetSetDef thread_object_getset[] =
308{
4694da01
TT
309 { "name", thpy_get_name, thpy_set_name,
310 "The name of the thread, as set by the user or the OS.", NULL },
5d5658a1
PA
311 { "num", thpy_get_num, NULL,
312 "Per-inferior number of the thread, as assigned by GDB.", NULL },
22a02324
PA
313 { "global_num", thpy_get_global_num, NULL,
314 "Global number of the thread, as assigned by GDB.", NULL },
595939de
PM
315 { "ptid", thpy_get_ptid, NULL, "ID of the thread, as assigned by the OS.",
316 NULL },
84654457
PA
317 { "inferior", thpy_get_inferior, NULL,
318 "The Inferior object this thread belongs to.", NULL },
595939de
PM
319
320 { NULL }
321};
322
323static PyMethodDef thread_object_methods[] =
324{
29703da4
PM
325 { "is_valid", thpy_is_valid, METH_NOARGS,
326 "is_valid () -> Boolean.\n\
327Return true if this inferior thread is valid, false if not." },
595939de
PM
328 { "switch", thpy_switch, METH_NOARGS,
329 "switch ()\n\
330Makes this the GDB selected thread." },
331 { "is_stopped", thpy_is_stopped, METH_NOARGS,
332 "is_stopped () -> Boolean\n\
333Return whether the thread is stopped." },
334 { "is_running", thpy_is_running, METH_NOARGS,
335 "is_running () -> Boolean\n\
336Return whether the thread is running." },
337 { "is_exited", thpy_is_exited, METH_NOARGS,
338 "is_exited () -> Boolean\n\
339Return whether the thread is exited." },
340
341 { NULL }
342};
343
e36122e9 344PyTypeObject thread_object_type =
595939de 345{
9a27f2c6 346 PyVarObject_HEAD_INIT (NULL, 0)
595939de
PM
347 "gdb.InferiorThread", /*tp_name*/
348 sizeof (thread_object), /*tp_basicsize*/
349 0, /*tp_itemsize*/
350 thpy_dealloc, /*tp_dealloc*/
351 0, /*tp_print*/
352 0, /*tp_getattr*/
353 0, /*tp_setattr*/
354 0, /*tp_compare*/
355 0, /*tp_repr*/
356 0, /*tp_as_number*/
357 0, /*tp_as_sequence*/
358 0, /*tp_as_mapping*/
359 0, /*tp_hash */
360 0, /*tp_call*/
361 0, /*tp_str*/
362 0, /*tp_getattro*/
363 0, /*tp_setattro*/
364 0, /*tp_as_buffer*/
365 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_ITER, /*tp_flags*/
366 "GDB thread object", /* tp_doc */
367 0, /* tp_traverse */
368 0, /* tp_clear */
369 0, /* tp_richcompare */
370 0, /* tp_weaklistoffset */
371 0, /* tp_iter */
372 0, /* tp_iternext */
373 thread_object_methods, /* tp_methods */
374 0, /* tp_members */
375 thread_object_getset, /* tp_getset */
376 0, /* tp_base */
377 0, /* tp_dict */
378 0, /* tp_descr_get */
379 0, /* tp_descr_set */
380 0, /* tp_dictoffset */
381 0, /* tp_init */
382 0 /* tp_alloc */
383};
This page took 0.55 seconds and 4 git commands to generate.