1 /* Python interface to inferior events.
3 Copyright (C) 2009-2017 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"
29 /* This macro creates the following functions:
31 gdbpy_initialize_{NAME}_event
32 Used to add the newly created event type to the gdb module.
34 and the python type data structure for the event:
36 struct PyTypeObject {NAME}_event_object_type
38 NAME is the name of the event.
39 PY_PATH is a string representing the module and python name of
41 PY_NAME a string representing what the event should be called in
43 DOC Python documentation for the new event type
44 BASE the base event for this event usually just event_object_type.
47 #define GDBPY_NEW_EVENT_TYPE(name, py_path, py_name, doc, base) \
49 PyTypeObject name##_event_object_type \
50 CPYCHECKER_TYPE_OBJECT_FOR_TYPEDEF ("event_object") \
52 PyVarObject_HEAD_INIT (NULL, 0) \
53 py_path, /* tp_name */ \
54 sizeof (event_object), /* tp_basicsize */ \
55 0, /* tp_itemsize */ \
56 evpy_dealloc, /* tp_dealloc */ \
62 0, /* tp_as_number */ \
63 0, /* tp_as_sequence */ \
64 0, /* tp_as_mapping */ \
68 0, /* tp_getattro */ \
69 0, /* tp_setattro */ \
70 0, /* tp_as_buffer */ \
71 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ \
73 0, /* tp_traverse */ \
75 0, /* tp_richcompare */ \
76 0, /* tp_weaklistoffset */ \
78 0, /* tp_iternext */ \
82 &base, /* tp_base */ \
84 0, /* tp_descr_get */ \
85 0, /* tp_descr_set */ \
86 0, /* tp_dictoffset */ \
92 gdbpy_initialize_##name##_event (void) \
94 return gdbpy_initialize_event_generic (&name##_event_object_type, \
105 extern int emit_continue_event (ptid_t ptid
);
106 extern int emit_exited_event (const LONGEST
*exit_code
, struct inferior
*inf
);
108 /* For inferior function call events, discriminate whether event is
109 before or after the call. */
113 /* Before the call */
117 } inferior_call_kind
;
119 extern int emit_inferior_call_event (inferior_call_kind kind
,
120 ptid_t thread
, CORE_ADDR addr
);
121 extern int emit_register_changed_event (struct frame_info
*frame
,
123 extern int emit_memory_changed_event (CORE_ADDR addr
, ssize_t len
);
124 extern int evpy_emit_event (PyObject
*event
,
125 eventregistry_object
*registry
);
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 const char *name
, PyObject
*attr
)
135 CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION
;
136 int gdbpy_initialize_event_generic (PyTypeObject
*type
, const char *name
)
137 CPYCHECKER_NEGATIVE_RESULT_SETS_EXCEPTION
;
139 #endif /* GDB_PY_EVENT_H */