1 /* Python interface to inferior events.
3 Copyright (C) 2009-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/>. */
20 #ifndef GDB_PY_EVENT_H
21 #define GDB_PY_EVENT_H
23 #include "py-events.h"
25 #include "python-internal.h"
28 /* This macro creates the following functions:
30 gdbpy_initialize_{NAME}_event
31 Used to add the newly created event type to the gdb module.
33 and the python type data structure for the event:
35 struct PyTypeObject {NAME}_event_object_type
37 NAME is the name of the event.
38 PY_PATH is a string representing the module and python name of
40 PY_NAME a string representing what the event should be called in
42 DOC Python documentation for the new event type
43 BASE the base event for this event usually just event_object_type.
46 #define GDBPY_NEW_EVENT_TYPE(name, py_path, py_name, doc, base) \
48 PyTypeObject name##_event_object_type \
49 CPYCHECKER_TYPE_OBJECT_FOR_TYPEDEF ("event_object") \
51 PyVarObject_HEAD_INIT (NULL, 0) \
52 py_path, /* tp_name */ \
53 sizeof (event_object), /* tp_basicsize */ \
54 0, /* tp_itemsize */ \
55 evpy_dealloc, /* tp_dealloc */ \
61 0, /* tp_as_number */ \
62 0, /* tp_as_sequence */ \
63 0, /* tp_as_mapping */ \
67 0, /* tp_getattro */ \
68 0, /* tp_setattro */ \
69 0, /* tp_as_buffer */ \
70 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ \
72 0, /* tp_traverse */ \
74 0, /* tp_richcompare */ \
75 0, /* tp_weaklistoffset */ \
77 0, /* tp_iternext */ \
81 &base, /* tp_base */ \
83 0, /* tp_descr_get */ \
84 0, /* tp_descr_set */ \
85 0, /* tp_dictoffset */ \
91 gdbpy_initialize_##name##_event (void) \
93 return gdbpy_initialize_event_generic (&name##_event_object_type, \
104 extern int emit_continue_event (ptid_t ptid
);
105 extern int emit_exited_event (const LONGEST
*exit_code
, struct inferior
*inf
);
107 /* For inferior function call events, discriminate whether event is
108 before or after the call. */
112 /* Before the call */
116 } inferior_call_kind
;
118 extern int emit_inferior_call_event (inferior_call_kind kind
,
119 ptid_t thread
, CORE_ADDR addr
);
120 extern int emit_register_changed_event (struct frame_info
*frame
,
122 extern int emit_memory_changed_event (CORE_ADDR addr
, ssize_t len
);
123 extern int evpy_emit_event (PyObject
*event
,
124 eventregistry_object
*registry
)
125 CPYCHECKER_STEALS_REFERENCE_TO_ARG (1);
127 extern PyObject
*create_event_object (PyTypeObject
*py_type
);
128 extern PyObject
*create_thread_event_object (PyTypeObject
*py_type
);
129 extern int emit_new_objfile_event (struct objfile
*objfile
);
130 extern int emit_clear_objfiles_event (void);
132 extern void evpy_dealloc (PyObject
*self
);
133 extern int evpy_add_attribute (PyObject
*event
,
134 char *name
, PyObject
*attr
)
135 CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION
;
136 int gdbpy_initialize_event_generic (PyTypeObject
*type
, char *name
)
137 CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION
;
139 #endif /* GDB_PY_EVENT_H */