1 /* Python interface to inferior threads.
3 Copyright (C) 2009-2014 Free Software Foundation, Inc.
5 This file is part of GDB.
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.
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.
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/>. */
21 #include "gdbthread.h"
23 #include "python-internal.h"
25 static PyTypeObject thread_object_type
26 CPYCHECKER_TYPE_OBJECT_FOR_TYPEDEF ("thread_object");
28 /* Require that INFERIOR be a valid inferior ID. */
29 #define THPY_REQUIRE_VALID(Thread) \
31 if (!Thread->thread) \
33 PyErr_SetString (PyExc_RuntimeError, \
34 _("Thread no longer exists.")); \
42 create_thread_object (struct thread_info *tp)
44 thread_object *thread_obj;
46 thread_obj = PyObject_New (thread_object, &thread_object_type);
50 thread_obj->thread = tp;
51 thread_obj->inf_obj = find_inferior_object (ptid_get_pid (tp->ptid));
59 thpy_dealloc (PyObject *self)
61 Py_DECREF (((thread_object *) self)->inf_obj);
62 Py_TYPE (self)->tp_free (self);
66 thpy_get_name (PyObject *self, void *ignore)
68 thread_object *thread_obj = (thread_object *) self;
71 THPY_REQUIRE_VALID (thread_obj);
73 name = thread_obj->thread->name;
75 name = target_thread_name (thread_obj->thread);
80 return PyString_FromString (name);
84 thpy_set_name (PyObject *self, PyObject *newvalue, void *ignore)
86 thread_object *thread_obj = (thread_object *) self;
89 if (! thread_obj->thread)
91 PyErr_SetString (PyExc_RuntimeError, _("Thread no longer exists."));
97 PyErr_SetString (PyExc_TypeError,
98 _("Cannot delete `name' attribute."));
101 else if (newvalue == Py_None)
103 else if (! gdbpy_is_string (newvalue))
105 PyErr_SetString (PyExc_TypeError,
106 _("The value of `name' must be a string."));
111 name = python_string_to_host_string (newvalue);
116 xfree (thread_obj->thread->name);
117 thread_obj->thread->name = name;
123 thpy_get_num (PyObject *self, void *closure)
125 thread_object *thread_obj = (thread_object *) self;
127 THPY_REQUIRE_VALID (thread_obj);
129 return PyLong_FromLong (thread_obj->thread->num);
132 /* Getter for InferiorThread.ptid -> (pid, lwp, tid).
133 Returns a tuple with the thread's ptid components. */
135 thpy_get_ptid (PyObject *self, void *closure)
139 thread_object *thread_obj = (thread_object *) self;
142 THPY_REQUIRE_VALID (thread_obj);
144 ret = PyTuple_New (3);
148 pid = ptid_get_pid (thread_obj->thread->ptid);
149 lwp = ptid_get_lwp (thread_obj->thread->ptid);
150 tid = ptid_get_tid (thread_obj->thread->ptid);
152 PyTuple_SET_ITEM (ret, 0, PyInt_FromLong (pid));
153 PyTuple_SET_ITEM (ret, 1, PyInt_FromLong (lwp));
154 PyTuple_SET_ITEM (ret, 2, PyInt_FromLong (tid));
159 /* Implementation of InferiorThread.switch ().
160 Makes this the GDB selected thread. */
162 thpy_switch (PyObject *self, PyObject *args)
164 thread_object *thread_obj = (thread_object *) self;
165 volatile struct gdb_exception except;
167 THPY_REQUIRE_VALID (thread_obj);
169 TRY_CATCH (except, RETURN_MASK_ALL)
171 switch_to_thread (thread_obj->thread->ptid);
173 GDB_PY_HANDLE_EXCEPTION (except);
178 /* Implementation of InferiorThread.is_stopped () -> Boolean.
179 Return whether the thread is stopped. */
181 thpy_is_stopped (PyObject *self, PyObject *args)
183 thread_object *thread_obj = (thread_object *) self;
185 THPY_REQUIRE_VALID (thread_obj);
187 if (is_stopped (thread_obj->thread->ptid))
193 /* Implementation of InferiorThread.is_running () -> Boolean.
194 Return whether the thread is running. */
196 thpy_is_running (PyObject *self, PyObject *args)
198 thread_object *thread_obj = (thread_object *) self;
200 THPY_REQUIRE_VALID (thread_obj);
202 if (is_running (thread_obj->thread->ptid))
208 /* Implementation of InferiorThread.is_exited () -> Boolean.
209 Return whether the thread is exited. */
211 thpy_is_exited (PyObject *self, PyObject *args)
213 thread_object *thread_obj = (thread_object *) self;
215 THPY_REQUIRE_VALID (thread_obj);
217 if (is_exited (thread_obj->thread->ptid))
223 /* Implementation of gdb.InfThread.is_valid (self) -> Boolean.
224 Returns True if this inferior Thread object still exists
228 thpy_is_valid (PyObject *self, PyObject *args)
230 thread_object *thread_obj = (thread_object *) self;
232 if (! thread_obj->thread)
238 /* Implementation of gdb.selected_thread () -> gdb.InferiorThread.
239 Returns the selected thread object. */
241 gdbpy_selected_thread (PyObject *self, PyObject *args)
243 PyObject *thread_obj;
245 thread_obj = (PyObject *) find_thread_object (inferior_ptid);
248 Py_INCREF (thread_obj);
258 gdbpy_initialize_thread (void)
260 if (PyType_Ready (&thread_object_type) < 0)
263 return gdb_pymodule_addobject (gdb_module, "InferiorThread",
264 (PyObject *) &thread_object_type);
269 static PyGetSetDef thread_object_getset[] =
271 { "name", thpy_get_name, thpy_set_name,
272 "The name of the thread, as set by the user or the OS.", NULL },
273 { "num", thpy_get_num, NULL, "ID of the thread, as assigned by GDB.", NULL },
274 { "ptid", thpy_get_ptid, NULL, "ID of the thread, as assigned by the OS.",
280 static PyMethodDef thread_object_methods[] =
282 { "is_valid", thpy_is_valid, METH_NOARGS,
283 "is_valid () -> Boolean.\n\
284 Return true if this inferior thread is valid, false if not." },
285 { "switch", thpy_switch, METH_NOARGS,
287 Makes this the GDB selected thread." },
288 { "is_stopped", thpy_is_stopped, METH_NOARGS,
289 "is_stopped () -> Boolean\n\
290 Return whether the thread is stopped." },
291 { "is_running", thpy_is_running, METH_NOARGS,
292 "is_running () -> Boolean\n\
293 Return whether the thread is running." },
294 { "is_exited", thpy_is_exited, METH_NOARGS,
295 "is_exited () -> Boolean\n\
296 Return whether the thread is exited." },
301 static PyTypeObject thread_object_type =
303 PyVarObject_HEAD_INIT (NULL, 0)
304 "gdb.InferiorThread", /*tp_name*/
305 sizeof (thread_object), /*tp_basicsize*/
307 thpy_dealloc, /*tp_dealloc*/
314 0, /*tp_as_sequence*/
322 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_ITER, /*tp_flags*/
323 "GDB thread object", /* tp_doc */
326 0, /* tp_richcompare */
327 0, /* tp_weaklistoffset */
330 thread_object_methods, /* tp_methods */
332 thread_object_getset, /* tp_getset */
335 0, /* tp_descr_get */
336 0, /* tp_descr_set */
337 0, /* tp_dictoffset */