1 /* Python interface to objfiles.
3 Copyright (C) 2008-2015 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 "python-internal.h"
33 /* The corresponding objfile. */
34 struct objfile
*objfile
;
36 /* Dictionary holding user-added attributes.
37 This is the __dict__ attribute of the object. */
40 /* The pretty-printer list of functions. */
43 /* The frame filter list of functions. */
44 PyObject
*frame_filters
;
46 /* The list of frame unwinders. */
47 PyObject
*frame_unwinders
;
49 /* The type-printer list. */
50 PyObject
*type_printers
;
52 /* The debug method matcher list. */
56 extern PyTypeObject objfile_object_type
57 CPYCHECKER_TYPE_OBJECT_FOR_TYPEDEF ("objfile_object");
59 static const struct objfile_data
*objfpy_objfile_data_key
;
61 /* Require that OBJF be a valid objfile. */
62 #define OBJFPY_REQUIRE_VALID(obj) \
64 if (!(obj)->objfile) \
66 PyErr_SetString (PyExc_RuntimeError, \
67 _("Objfile no longer exists.")); \
74 /* An Objfile method which returns the objfile's file name, or None. */
77 objfpy_get_filename (PyObject
*self
, void *closure
)
79 objfile_object
*obj
= (objfile_object
*) self
;
82 return PyString_Decode (objfile_name (obj
->objfile
),
83 strlen (objfile_name (obj
->objfile
)),
84 host_charset (), NULL
);
88 /* An Objfile method which returns the objfile's file name, as specified
89 by the user, or None. */
92 objfpy_get_username (PyObject
*self
, void *closure
)
94 objfile_object
*obj
= (objfile_object
*) self
;
98 const char *username
= obj
->objfile
->original_name
;
100 return PyString_Decode (username
, strlen (username
),
101 host_charset (), NULL
);
107 /* If SELF is a separate debug-info file, return the "backlink" field.
108 Otherwise return None. */
111 objfpy_get_owner (PyObject
*self
, void *closure
)
113 objfile_object
*obj
= (objfile_object
*) self
;
114 struct objfile
*objfile
= obj
->objfile
;
115 struct objfile
*owner
;
117 OBJFPY_REQUIRE_VALID (obj
);
119 owner
= objfile
->separate_debug_objfile_backlink
;
122 PyObject
*result
= objfile_to_objfile_object (owner
);
130 /* An Objfile method which returns the objfile's build id, or None. */
133 objfpy_get_build_id (PyObject
*self
, void *closure
)
135 objfile_object
*obj
= (objfile_object
*) self
;
136 struct objfile
*objfile
= obj
->objfile
;
137 const struct elf_build_id
*build_id
= NULL
;
139 OBJFPY_REQUIRE_VALID (obj
);
143 build_id
= build_id_bfd_get (objfile
->obfd
);
145 CATCH (except
, RETURN_MASK_ALL
)
147 GDB_PY_HANDLE_EXCEPTION (except
);
151 if (build_id
!= NULL
)
153 char *hex_form
= make_hex_string (build_id
->data
, build_id
->size
);
156 result
= PyString_Decode (hex_form
, strlen (hex_form
),
157 host_charset (), NULL
);
165 /* An Objfile method which returns the objfile's progspace, or None. */
168 objfpy_get_progspace (PyObject
*self
, void *closure
)
170 objfile_object
*obj
= (objfile_object
*) self
;
174 PyObject
*pspace
= pspace_to_pspace_object (obj
->objfile
->pspace
);
184 objfpy_dealloc (PyObject
*o
)
186 objfile_object
*self
= (objfile_object
*) o
;
188 Py_XDECREF (self
->dict
);
189 Py_XDECREF (self
->printers
);
190 Py_XDECREF (self
->frame_filters
);
191 Py_XDECREF (self
->frame_unwinders
);
192 Py_XDECREF (self
->type_printers
);
193 Py_XDECREF (self
->xmethods
);
194 Py_TYPE (self
)->tp_free (self
);
197 /* Initialize an objfile_object.
198 The result is a boolean indicating success. */
201 objfpy_initialize (objfile_object
*self
)
203 self
->objfile
= NULL
;
206 self
->printers
= PyList_New (0);
207 if (self
->printers
== NULL
)
210 self
->frame_filters
= PyDict_New ();
211 if (self
->frame_filters
== NULL
)
214 self
->frame_unwinders
= PyList_New (0);
215 if (self
->frame_unwinders
== NULL
)
218 self
->type_printers
= PyList_New (0);
219 if (self
->type_printers
== NULL
)
222 self
->xmethods
= PyList_New (0);
223 if (self
->xmethods
== NULL
)
230 objfpy_new (PyTypeObject
*type
, PyObject
*args
, PyObject
*keywords
)
232 objfile_object
*self
= (objfile_object
*) type
->tp_alloc (type
, 0);
236 if (!objfpy_initialize (self
))
243 return (PyObject
*) self
;
247 objfpy_get_printers (PyObject
*o
, void *ignore
)
249 objfile_object
*self
= (objfile_object
*) o
;
251 Py_INCREF (self
->printers
);
252 return self
->printers
;
256 objfpy_set_printers (PyObject
*o
, PyObject
*value
, void *ignore
)
259 objfile_object
*self
= (objfile_object
*) o
;
263 PyErr_SetString (PyExc_TypeError
,
264 _("Cannot delete the pretty_printers attribute."));
268 if (! PyList_Check (value
))
270 PyErr_SetString (PyExc_TypeError
,
271 _("The pretty_printers attribute must be a list."));
275 /* Take care in case the LHS and RHS are related somehow. */
276 tmp
= self
->printers
;
278 self
->printers
= value
;
284 /* Return the Python dictionary attribute containing frame filters for
287 objfpy_get_frame_filters (PyObject
*o
, void *ignore
)
289 objfile_object
*self
= (objfile_object
*) o
;
291 Py_INCREF (self
->frame_filters
);
292 return self
->frame_filters
;
295 /* Set this object file's frame filters dictionary to FILTERS. */
297 objfpy_set_frame_filters (PyObject
*o
, PyObject
*filters
, void *ignore
)
300 objfile_object
*self
= (objfile_object
*) o
;
304 PyErr_SetString (PyExc_TypeError
,
305 _("Cannot delete the frame filters attribute."));
309 if (! PyDict_Check (filters
))
311 PyErr_SetString (PyExc_TypeError
,
312 _("The frame_filters attribute must be a dictionary."));
316 /* Take care in case the LHS and RHS are related somehow. */
317 tmp
= self
->frame_filters
;
319 self
->frame_filters
= filters
;
325 /* Return the frame unwinders attribute for this object file. */
328 objfpy_get_frame_unwinders (PyObject
*o
, void *ignore
)
330 objfile_object
*self
= (objfile_object
*) o
;
332 Py_INCREF (self
->frame_unwinders
);
333 return self
->frame_unwinders
;
336 /* Set this object file's frame unwinders list to UNWINDERS. */
339 objfpy_set_frame_unwinders (PyObject
*o
, PyObject
*unwinders
, void *ignore
)
342 objfile_object
*self
= (objfile_object
*) o
;
346 PyErr_SetString (PyExc_TypeError
,
347 _("Cannot delete the frame unwinders attribute."));
351 if (!PyList_Check (unwinders
))
353 PyErr_SetString (PyExc_TypeError
,
354 _("The frame_unwinders attribute must be a list."));
358 /* Take care in case the LHS and RHS are related somehow. */
359 tmp
= self
->frame_unwinders
;
360 Py_INCREF (unwinders
);
361 self
->frame_unwinders
= unwinders
;
367 /* Get the 'type_printers' attribute. */
370 objfpy_get_type_printers (PyObject
*o
, void *ignore
)
372 objfile_object
*self
= (objfile_object
*) o
;
374 Py_INCREF (self
->type_printers
);
375 return self
->type_printers
;
378 /* Get the 'xmethods' attribute. */
381 objfpy_get_xmethods (PyObject
*o
, void *ignore
)
383 objfile_object
*self
= (objfile_object
*) o
;
385 Py_INCREF (self
->xmethods
);
386 return self
->xmethods
;
389 /* Set the 'type_printers' attribute. */
392 objfpy_set_type_printers (PyObject
*o
, PyObject
*value
, void *ignore
)
395 objfile_object
*self
= (objfile_object
*) o
;
399 PyErr_SetString (PyExc_TypeError
,
400 _("Cannot delete the type_printers attribute."));
404 if (! PyList_Check (value
))
406 PyErr_SetString (PyExc_TypeError
,
407 _("The type_printers attribute must be a list."));
411 /* Take care in case the LHS and RHS are related somehow. */
412 tmp
= self
->type_printers
;
414 self
->type_printers
= value
;
420 /* Implementation of gdb.Objfile.is_valid (self) -> Boolean.
421 Returns True if this object file still exists in GDB. */
424 objfpy_is_valid (PyObject
*self
, PyObject
*args
)
426 objfile_object
*obj
= (objfile_object
*) self
;
434 /* Implementation of gdb.Objfile.add_separate_debug_file (self) -> Boolean. */
437 objfpy_add_separate_debug_file (PyObject
*self
, PyObject
*args
, PyObject
*kw
)
439 static char *keywords
[] = { "file_name", NULL
};
440 objfile_object
*obj
= (objfile_object
*) self
;
441 const char *file_name
;
442 int symfile_flags
= 0;
444 OBJFPY_REQUIRE_VALID (obj
);
446 if (!PyArg_ParseTupleAndKeywords (args
, kw
, "s", keywords
, &file_name
))
451 bfd
*abfd
= symfile_bfd_open (file_name
);
453 symbol_file_add_separate (abfd
, file_name
, symfile_flags
, obj
->objfile
);
455 CATCH (except
, RETURN_MASK_ALL
)
457 GDB_PY_HANDLE_EXCEPTION (except
);
464 /* Subroutine of gdbpy_lookup_objfile_by_build_id to simplify it.
465 Return non-zero if STRING is a potentially valid build id. */
468 objfpy_build_id_ok (const char *string
)
470 size_t i
, n
= strlen (string
);
474 for (i
= 0; i
< n
; ++i
)
476 if (!isxdigit (string
[i
]))
482 /* Subroutine of gdbpy_lookup_objfile_by_build_id to simplify it.
483 Returns non-zero if BUILD_ID matches STRING.
484 It is assumed that objfpy_build_id_ok (string) returns TRUE. */
487 objfpy_build_id_matches (const struct elf_build_id
*build_id
,
492 if (strlen (string
) != 2 * build_id
->size
)
495 for (i
= 0; i
< build_id
->size
; ++i
)
497 char c1
= string
[i
* 2], c2
= string
[i
* 2 + 1];
498 int byte
= (host_hex_value (c1
) << 4) | host_hex_value (c2
);
500 if (byte
!= build_id
->data
[i
])
507 /* Subroutine of gdbpy_lookup_objfile to simplify it.
508 Look up an objfile by its file name. */
510 static struct objfile
*
511 objfpy_lookup_objfile_by_name (const char *name
)
513 struct objfile
*objfile
;
515 ALL_OBJFILES (objfile
)
517 const char *filename
;
519 if ((objfile
->flags
& OBJF_NOT_FILENAME
) != 0)
521 /* Don't return separate debug files. */
522 if (objfile
->separate_debug_objfile_backlink
!= NULL
)
525 filename
= objfile_filename (objfile
);
526 if (filename
!= NULL
&& compare_filenames_for_search (filename
, name
))
528 if (compare_filenames_for_search (objfile
->original_name
, name
))
535 /* Subroutine of gdbpy_lookup_objfile to simplify it.
536 Look up an objfile by its build id. */
538 static struct objfile
*
539 objfpy_lookup_objfile_by_build_id (const char *build_id
)
541 struct objfile
*objfile
;
543 ALL_OBJFILES (objfile
)
545 const struct elf_build_id
*obfd_build_id
;
547 if (objfile
->obfd
== NULL
)
549 /* Don't return separate debug files. */
550 if (objfile
->separate_debug_objfile_backlink
!= NULL
)
552 obfd_build_id
= build_id_bfd_get (objfile
->obfd
);
553 if (obfd_build_id
== NULL
)
555 if (objfpy_build_id_matches (obfd_build_id
, build_id
))
562 /* Implementation of gdb.lookup_objfile. */
565 gdbpy_lookup_objfile (PyObject
*self
, PyObject
*args
, PyObject
*kw
)
567 static char *keywords
[] = { "name", "by_build_id", NULL
};
569 PyObject
*by_build_id_obj
= NULL
;
571 struct objfile
*objfile
;
573 if (! PyArg_ParseTupleAndKeywords (args
, kw
, "s|O!", keywords
,
574 &name
, &PyBool_Type
, &by_build_id_obj
))
578 if (by_build_id_obj
!= NULL
)
580 int cmp
= PyObject_IsTrue (by_build_id_obj
);
589 if (!objfpy_build_id_ok (name
))
591 PyErr_SetString (PyExc_TypeError
, _("Not a valid build id."));
594 objfile
= objfpy_lookup_objfile_by_build_id (name
);
597 objfile
= objfpy_lookup_objfile_by_name (name
);
601 PyObject
*result
= objfile_to_objfile_object (objfile
);
607 PyErr_SetString (PyExc_ValueError
, _("Objfile not found."));
613 /* Clear the OBJFILE pointer in an Objfile object and remove the
616 py_free_objfile (struct objfile
*objfile
, void *datum
)
618 struct cleanup
*cleanup
;
619 objfile_object
*object
= datum
;
621 cleanup
= ensure_python_env (get_objfile_arch (objfile
), current_language
);
622 object
->objfile
= NULL
;
623 Py_DECREF ((PyObject
*) object
);
624 do_cleanups (cleanup
);
627 /* Return a borrowed reference to the Python object of type Objfile
628 representing OBJFILE. If the object has already been created,
629 return it. Otherwise, create it. Return NULL and set the Python
633 objfile_to_objfile_object (struct objfile
*objfile
)
635 objfile_object
*object
;
637 object
= objfile_data (objfile
, objfpy_objfile_data_key
);
640 object
= PyObject_New (objfile_object
, &objfile_object_type
);
643 if (!objfpy_initialize (object
))
649 object
->objfile
= objfile
;
650 set_objfile_data (objfile
, objfpy_objfile_data_key
, object
);
654 return (PyObject
*) object
;
658 gdbpy_initialize_objfile (void)
660 objfpy_objfile_data_key
661 = register_objfile_data_with_cleanup (NULL
, py_free_objfile
);
663 if (PyType_Ready (&objfile_object_type
) < 0)
666 return gdb_pymodule_addobject (gdb_module
, "Objfile",
667 (PyObject
*) &objfile_object_type
);
672 static PyMethodDef objfile_object_methods
[] =
674 { "is_valid", objfpy_is_valid
, METH_NOARGS
,
675 "is_valid () -> Boolean.\n\
676 Return true if this object file is valid, false if not." },
678 { "add_separate_debug_file", (PyCFunction
) objfpy_add_separate_debug_file
,
679 METH_VARARGS
| METH_KEYWORDS
,
680 "add_separate_debug_file (file_name).\n\
681 Add FILE_NAME to the list of files containing debug info for the objfile." },
686 static PyGetSetDef objfile_getset
[] =
688 { "__dict__", gdb_py_generic_dict
, NULL
,
689 "The __dict__ for this objfile.", &objfile_object_type
},
690 { "filename", objfpy_get_filename
, NULL
,
691 "The objfile's filename, or None.", NULL
},
692 { "username", objfpy_get_username
, NULL
,
693 "The name of the objfile as provided by the user, or None.", NULL
},
694 { "owner", objfpy_get_owner
, NULL
,
695 "The objfile owner of separate debug info objfiles, or None.",
697 { "build_id", objfpy_get_build_id
, NULL
,
698 "The objfile's build id, or None.", NULL
},
699 { "progspace", objfpy_get_progspace
, NULL
,
700 "The objfile's progspace, or None.", NULL
},
701 { "pretty_printers", objfpy_get_printers
, objfpy_set_printers
,
702 "Pretty printers.", NULL
},
703 { "frame_filters", objfpy_get_frame_filters
,
704 objfpy_set_frame_filters
, "Frame Filters.", NULL
},
705 { "frame_unwinders", objfpy_get_frame_unwinders
,
706 objfpy_set_frame_unwinders
, "Frame Unwinders", NULL
},
707 { "type_printers", objfpy_get_type_printers
, objfpy_set_type_printers
,
708 "Type printers.", NULL
},
709 { "xmethods", objfpy_get_xmethods
, NULL
,
710 "Debug methods.", NULL
},
714 PyTypeObject objfile_object_type
=
716 PyVarObject_HEAD_INIT (NULL
, 0)
717 "gdb.Objfile", /*tp_name*/
718 sizeof (objfile_object
), /*tp_basicsize*/
720 objfpy_dealloc
, /*tp_dealloc*/
727 0, /*tp_as_sequence*/
735 Py_TPFLAGS_DEFAULT
, /*tp_flags*/
736 "GDB objfile object", /* tp_doc */
739 0, /* tp_richcompare */
740 0, /* tp_weaklistoffset */
743 objfile_object_methods
, /* tp_methods */
745 objfile_getset
, /* tp_getset */
748 0, /* tp_descr_get */
749 0, /* tp_descr_set */
750 offsetof (objfile_object
, dict
), /* tp_dictoffset */
753 objfpy_new
, /* tp_new */