Commit | Line | Data |
---|---|---|
d57a3c85 TJB |
1 | /* Gdb/Python header for private use by Python module. |
2 | ||
4c38e0a4 | 3 | Copyright (C) 2008, 2009, 2010 Free Software Foundation, Inc. |
d57a3c85 TJB |
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 | #ifndef GDB_PYTHON_INTERNAL_H | |
21 | #define GDB_PYTHON_INTERNAL_H | |
22 | ||
8a1ea21f DE |
23 | #include <stdio.h> |
24 | ||
d57a3c85 TJB |
25 | /* Python 2.4 doesn't include stdint.h soon enough to get {u,}intptr_t |
26 | needed by pyport.h. */ | |
27 | #include <stdint.h> | |
28 | ||
29 | /* /usr/include/features.h on linux systems will define _POSIX_C_SOURCE | |
30 | if it sees _GNU_SOURCE (which config.h will define). | |
31 | pyconfig.h defines _POSIX_C_SOURCE to a different value than | |
32 | /usr/include/features.h does causing compilation to fail. | |
33 | To work around this, undef _POSIX_C_SOURCE before we include Python.h. */ | |
34 | #undef _POSIX_C_SOURCE | |
35 | ||
36 | #if HAVE_LIBPYTHON2_4 | |
37 | #include "python2.4/Python.h" | |
a6bac58e | 38 | #include "python2.4/frameobject.h" |
5171e6b3 TT |
39 | /* Py_ssize_t is not defined until 2.5. |
40 | Logical type for Py_ssize_t is Py_intptr_t, but that fails in 64-bit | |
41 | compilation due to several apparent mistakes in python2.4 API, so we | |
42 | use 'int' instead. */ | |
43 | typedef int Py_ssize_t; | |
d57a3c85 TJB |
44 | #elif HAVE_LIBPYTHON2_5 |
45 | #include "python2.5/Python.h" | |
a6bac58e | 46 | #include "python2.5/frameobject.h" |
d57a3c85 TJB |
47 | #elif HAVE_LIBPYTHON2_6 |
48 | #include "python2.6/Python.h" | |
a6bac58e | 49 | #include "python2.6/frameobject.h" |
d57a3c85 TJB |
50 | #else |
51 | #error "Unable to find usable Python.h" | |
52 | #endif | |
53 | ||
ca30a762 TT |
54 | /* If Python.h does not define WITH_THREAD, then the various |
55 | GIL-related functions will not be defined. However, | |
56 | PyGILState_STATE will be. */ | |
57 | #ifndef WITH_THREAD | |
58 | #define PyGILState_Ensure() ((PyGILState_STATE) 0) | |
548a926a | 59 | #define PyGILState_Release(ARG) ((void)(ARG)) |
ca30a762 | 60 | #define PyEval_InitThreads() 0 |
548a926a | 61 | #define PyThreadState_Swap(ARG) ((void)(ARG)) |
ca30a762 | 62 | #define PyEval_InitThreads() 0 |
f2f35b75 | 63 | #define PyEval_ReleaseLock() 0 |
ca30a762 TT |
64 | #endif |
65 | ||
9cb74f47 PM |
66 | /* In order to be able to parse symtab_and_line_to_sal_object function |
67 | a real symtab_and_line structure is needed. */ | |
68 | #include "symtab.h" | |
69 | ||
d7b32ed3 PM |
70 | /* Also needed to parse enum var_types. */ |
71 | #include "command.h" | |
72 | ||
f3e9a817 | 73 | struct block; |
a08702d6 | 74 | struct value; |
d452c4bc | 75 | struct language_defn; |
fa33c3cd | 76 | struct program_space; |
d57a3c85 TJB |
77 | |
78 | extern PyObject *gdb_module; | |
a08702d6 | 79 | extern PyTypeObject value_object_type; |
f3e9a817 PM |
80 | extern PyTypeObject block_object_type; |
81 | extern PyTypeObject symbol_object_type; | |
a08702d6 | 82 | |
595939de PM |
83 | typedef struct |
84 | { | |
85 | PyObject_HEAD | |
86 | ||
87 | /* The thread we represent. */ | |
88 | struct thread_info *thread; | |
89 | ||
90 | /* The Inferior object to which this thread belongs. */ | |
91 | PyObject *inf_obj; | |
92 | } thread_object; | |
93 | ||
8a1ea21f DE |
94 | extern struct cmd_list_element *set_python_list; |
95 | extern struct cmd_list_element *show_python_list; | |
96 | ||
08c637de | 97 | PyObject *gdbpy_history (PyObject *self, PyObject *args); |
adc36818 | 98 | PyObject *gdbpy_breakpoints (PyObject *, PyObject *); |
f8f6f20b | 99 | PyObject *gdbpy_frame_stop_reason_string (PyObject *, PyObject *); |
f3e9a817 | 100 | PyObject *gdbpy_lookup_symbol (PyObject *self, PyObject *args, PyObject *kw); |
f8f6f20b | 101 | PyObject *gdbpy_selected_frame (PyObject *self, PyObject *args); |
f3e9a817 | 102 | PyObject *gdbpy_block_for_pc (PyObject *self, PyObject *args); |
2c74e833 | 103 | PyObject *gdbpy_lookup_type (PyObject *self, PyObject *args, PyObject *kw); |
be759fcf PM |
104 | PyObject *gdbpy_create_lazy_string_object (CORE_ADDR address, long length, |
105 | const char *encoding, struct type *type); | |
595939de PM |
106 | PyObject *gdbpy_inferiors (PyObject *unused, PyObject *unused2); |
107 | PyObject *gdbpy_selected_thread (PyObject *self, PyObject *args); | |
07ca107c | 108 | PyObject *gdbpy_string_to_argv (PyObject *self, PyObject *args); |
adc36818 | 109 | PyObject *gdbpy_get_hook_function (const char *); |
d7b32ed3 PM |
110 | PyObject *gdbpy_parameter (PyObject *self, PyObject *args); |
111 | PyObject *gdbpy_parameter_value (enum var_types type, void *var); | |
112 | char *gdbpy_parse_command_name (char *text, | |
113 | struct cmd_list_element ***base_list, | |
114 | struct cmd_list_element **start_list); | |
a08702d6 | 115 | |
f3e9a817 PM |
116 | PyObject *symtab_and_line_to_sal_object (struct symtab_and_line sal); |
117 | PyObject *symtab_to_symtab_object (struct symtab *symtab); | |
118 | PyObject *symbol_to_symbol_object (struct symbol *sym); | |
119 | PyObject *block_to_block_object (struct block *block, struct objfile *objfile); | |
a08702d6 | 120 | PyObject *value_to_value_object (struct value *v); |
2c74e833 | 121 | PyObject *type_to_type_object (struct type *); |
595939de | 122 | PyObject *frame_info_to_frame_object (struct frame_info *frame); |
89c73ade | 123 | |
fa33c3cd DE |
124 | PyObject *pspace_to_pspace_object (struct program_space *); |
125 | PyObject *pspy_get_printers (PyObject *, void *); | |
126 | ||
127 | PyObject *objfile_to_objfile_object (struct objfile *); | |
89c73ade | 128 | PyObject *objfpy_get_printers (PyObject *, void *); |
a08702d6 | 129 | |
595939de PM |
130 | thread_object *create_thread_object (struct thread_info *tp); |
131 | thread_object *find_thread_object (ptid_t ptid); | |
132 | PyObject *find_inferior_object (int pid); | |
133 | ||
f3e9a817 PM |
134 | struct block *block_object_to_block (PyObject *obj); |
135 | struct symbol *symbol_object_to_symbol (PyObject *obj); | |
a6bac58e | 136 | struct value *value_object_to_value (PyObject *self); |
a08702d6 | 137 | struct value *convert_value_from_python (PyObject *obj); |
2c74e833 | 138 | struct type *type_object_to_type (PyObject *obj); |
f3e9a817 PM |
139 | struct symtab *symtab_object_to_symtab (PyObject *obj); |
140 | struct symtab_and_line *sal_object_to_symtab_and_line (PyObject *obj); | |
a08702d6 | 141 | |
8a1ea21f | 142 | void gdbpy_initialize_auto_load (void); |
a08702d6 | 143 | void gdbpy_initialize_values (void); |
f8f6f20b | 144 | void gdbpy_initialize_frames (void); |
f3e9a817 | 145 | void gdbpy_initialize_symtabs (void); |
d8906c6f | 146 | void gdbpy_initialize_commands (void); |
f3e9a817 PM |
147 | void gdbpy_initialize_symbols (void); |
148 | void gdbpy_initialize_symtabs (void); | |
149 | void gdbpy_initialize_blocks (void); | |
2c74e833 | 150 | void gdbpy_initialize_types (void); |
bc3b79fd | 151 | void gdbpy_initialize_functions (void); |
fa33c3cd | 152 | void gdbpy_initialize_pspace (void); |
89c73ade | 153 | void gdbpy_initialize_objfile (void); |
adc36818 | 154 | void gdbpy_initialize_breakpoints (void); |
be759fcf | 155 | void gdbpy_initialize_lazy_string (void); |
d7b32ed3 | 156 | void gdbpy_initialize_parameters (void); |
595939de PM |
157 | void gdbpy_initialize_thread (void); |
158 | void gdbpy_initialize_inferior (void); | |
d57a3c85 TJB |
159 | |
160 | struct cleanup *make_cleanup_py_decref (PyObject *py); | |
d452c4bc UW |
161 | |
162 | struct cleanup *ensure_python_env (struct gdbarch *gdbarch, | |
163 | const struct language_defn *language); | |
164 | ||
165 | extern struct gdbarch *python_gdbarch; | |
166 | extern const struct language_defn *python_language; | |
d57a3c85 TJB |
167 | |
168 | /* Use this after a TRY_EXCEPT to throw the appropriate Python | |
169 | exception. */ | |
170 | #define GDB_PY_HANDLE_EXCEPTION(Exception) \ | |
171 | do { \ | |
172 | if (Exception.reason < 0) \ | |
173 | return PyErr_Format (Exception.reason == RETURN_QUIT \ | |
174 | ? PyExc_KeyboardInterrupt : PyExc_RuntimeError, \ | |
175 | "%s", Exception.message); \ | |
176 | } while (0) | |
177 | ||
adc36818 PM |
178 | /* Use this after a TRY_EXCEPT to throw the appropriate Python |
179 | exception. This macro is for use inside setter functions. */ | |
180 | #define GDB_PY_SET_HANDLE_EXCEPTION(Exception) \ | |
181 | do { \ | |
182 | if (Exception.reason < 0) \ | |
183 | { \ | |
184 | PyErr_Format (Exception.reason == RETURN_QUIT \ | |
185 | ? PyExc_KeyboardInterrupt : PyExc_RuntimeError, \ | |
186 | "%s", Exception.message); \ | |
187 | return -1; \ | |
188 | } \ | |
189 | } while (0) | |
d57a3c85 TJB |
190 | |
191 | void gdbpy_print_stack (void); | |
192 | ||
8a1ea21f DE |
193 | void source_python_script_for_objfile (struct objfile *objfile, |
194 | FILE *stream, const char *file); | |
195 | ||
d57a3c85 TJB |
196 | PyObject *python_string_to_unicode (PyObject *obj); |
197 | char *unicode_to_target_string (PyObject *unicode_str); | |
198 | char *python_string_to_target_string (PyObject *obj); | |
fbb8f299 | 199 | PyObject *python_string_to_target_python_string (PyObject *obj); |
08c637de | 200 | char *python_string_to_host_string (PyObject *obj); |
b6cb8e7d | 201 | PyObject *target_string_to_unicode (const gdb_byte *str, int length); |
08c637de | 202 | int gdbpy_is_string (PyObject *obj); |
07ca107c DE |
203 | char *gdbpy_obj_to_string (PyObject *obj); |
204 | char *gdbpy_exception_to_string (PyObject *ptype, PyObject *pvalue); | |
205 | ||
be759fcf PM |
206 | int gdbpy_is_lazy_string (PyObject *result); |
207 | gdb_byte *gdbpy_extract_lazy_string (PyObject *string, | |
208 | struct type **str_type, | |
209 | long *length, char **encoding); | |
d57a3c85 | 210 | |
595939de PM |
211 | int gdbpy_is_value_object (PyObject *obj); |
212 | ||
b6313243 TT |
213 | /* Note that these are declared here, and not in python.h with the |
214 | other pretty-printer functions, because they refer to PyObject. */ | |
fbb8f299 PM |
215 | PyObject *apply_varobj_pretty_printer (PyObject *print_obj, |
216 | struct value **replacement); | |
b6313243 TT |
217 | PyObject *gdbpy_get_varobj_pretty_printer (struct value *value); |
218 | char *gdbpy_get_display_hint (PyObject *printer); | |
219 | PyObject *gdbpy_default_visualizer (PyObject *self, PyObject *args); | |
220 | ||
d8906c6f | 221 | extern PyObject *gdbpy_doc_cst; |
a6bac58e TT |
222 | extern PyObject *gdbpy_children_cst; |
223 | extern PyObject *gdbpy_to_string_cst; | |
224 | extern PyObject *gdbpy_display_hint_cst; | |
967cf477 | 225 | extern PyObject *gdbpy_enabled_cst; |
d8906c6f | 226 | |
07ca107c DE |
227 | extern PyObject *gdbpy_gdberror_exc; |
228 | ||
595939de PM |
229 | int get_addr_from_python (PyObject *obj, CORE_ADDR *addr); |
230 | ||
d57a3c85 | 231 | #endif /* GDB_PYTHON_INTERNAL_H */ |