| 1 | /* User Interface Events. |
| 2 | |
| 3 | Copyright 1999, 2001, 2002, 2004 Free Software Foundation, Inc. |
| 4 | |
| 5 | Contributed by Cygnus Solutions. |
| 6 | |
| 7 | This file is part of GDB. |
| 8 | |
| 9 | This program is free software; you can redistribute it and/or modify |
| 10 | it under the terms of the GNU General Public License as published by |
| 11 | the Free Software Foundation; either version 2 of the License, or |
| 12 | (at your option) any later version. |
| 13 | |
| 14 | This program is distributed in the hope that it will be useful, |
| 15 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 17 | GNU General Public License for more details. |
| 18 | |
| 19 | You should have received a copy of the GNU General Public License |
| 20 | along with this program; if not, write to the Free Software |
| 21 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ |
| 22 | |
| 23 | /* Work in progress */ |
| 24 | |
| 25 | /* This file was created with the aid of ``gdb-events.sh''. |
| 26 | |
| 27 | The bourn shell script ``gdb-events.sh'' creates the files |
| 28 | ``new-gdb-events.c'' and ``new-gdb-events.h and then compares |
| 29 | them against the existing ``gdb-events.[hc]''. Any differences |
| 30 | found being reported. |
| 31 | |
| 32 | If editing this file, please also run gdb-events.sh and merge any |
| 33 | changes into that script. Conversely, when making sweeping changes |
| 34 | to this file, modifying gdb-events.sh and using its output may |
| 35 | prove easier. */ |
| 36 | |
| 37 | |
| 38 | #ifndef GDB_EVENTS_H |
| 39 | #define GDB_EVENTS_H |
| 40 | |
| 41 | #ifndef WITH_GDB_EVENTS |
| 42 | #define WITH_GDB_EVENTS 1 |
| 43 | #endif |
| 44 | |
| 45 | |
| 46 | /* COMPAT: pointer variables for old, unconverted events. |
| 47 | A call to set_gdb_events() will automatically update these. */ |
| 48 | |
| 49 | |
| 50 | |
| 51 | /* Type definition of all hook functions. |
| 52 | Recommended pratice is to first declare each hook function using |
| 53 | the below ftype and then define it. */ |
| 54 | |
| 55 | typedef void (gdb_events_breakpoint_create_ftype) (int b); |
| 56 | typedef void (gdb_events_breakpoint_delete_ftype) (int b); |
| 57 | typedef void (gdb_events_breakpoint_modify_ftype) (int b); |
| 58 | typedef void (gdb_events_tracepoint_create_ftype) (int number); |
| 59 | typedef void (gdb_events_tracepoint_delete_ftype) (int number); |
| 60 | typedef void (gdb_events_tracepoint_modify_ftype) (int number); |
| 61 | typedef void (gdb_events_architecture_changed_ftype) (void); |
| 62 | typedef void (gdb_events_target_changed_ftype) (void); |
| 63 | typedef void (gdb_events_selected_frame_level_changed_ftype) (int level); |
| 64 | typedef void (gdb_events_selected_thread_changed_ftype) (int thread_num); |
| 65 | |
| 66 | |
| 67 | /* gdb-events: object. */ |
| 68 | |
| 69 | struct gdb_events |
| 70 | { |
| 71 | gdb_events_breakpoint_create_ftype *breakpoint_create; |
| 72 | gdb_events_breakpoint_delete_ftype *breakpoint_delete; |
| 73 | gdb_events_breakpoint_modify_ftype *breakpoint_modify; |
| 74 | gdb_events_tracepoint_create_ftype *tracepoint_create; |
| 75 | gdb_events_tracepoint_delete_ftype *tracepoint_delete; |
| 76 | gdb_events_tracepoint_modify_ftype *tracepoint_modify; |
| 77 | gdb_events_architecture_changed_ftype *architecture_changed; |
| 78 | gdb_events_target_changed_ftype *target_changed; |
| 79 | gdb_events_selected_frame_level_changed_ftype *selected_frame_level_changed; |
| 80 | gdb_events_selected_thread_changed_ftype *selected_thread_changed; |
| 81 | }; |
| 82 | |
| 83 | |
| 84 | /* Interface into events functions. |
| 85 | Where a *_p() predicate is present, it must be called before |
| 86 | calling the hook proper. */ |
| 87 | extern void breakpoint_create_event (int b); |
| 88 | extern void breakpoint_delete_event (int b); |
| 89 | extern void breakpoint_modify_event (int b); |
| 90 | extern void tracepoint_create_event (int number); |
| 91 | extern void tracepoint_delete_event (int number); |
| 92 | extern void tracepoint_modify_event (int number); |
| 93 | extern void architecture_changed_event (void); |
| 94 | extern void target_changed_event (void); |
| 95 | extern void selected_frame_level_changed_event (int level); |
| 96 | extern void selected_thread_changed_event (int thread_num); |
| 97 | |
| 98 | |
| 99 | /* When GDB_EVENTS are not being used, completely disable them. */ |
| 100 | |
| 101 | #if !WITH_GDB_EVENTS |
| 102 | #define breakpoint_create_event(b) 0 |
| 103 | #define breakpoint_delete_event(b) 0 |
| 104 | #define breakpoint_modify_event(b) 0 |
| 105 | #define tracepoint_create_event(number) 0 |
| 106 | #define tracepoint_delete_event(number) 0 |
| 107 | #define tracepoint_modify_event(number) 0 |
| 108 | #define architecture_changed_event() 0 |
| 109 | #define target_changed_event() 0 |
| 110 | #define selected_frame_level_changed_event(level) 0 |
| 111 | #define selected_thread_changed_event(thread_num) 0 |
| 112 | #endif |
| 113 | |
| 114 | /* Install custom gdb-events hooks. */ |
| 115 | extern struct gdb_events *set_gdb_event_hooks (struct gdb_events *vector); |
| 116 | |
| 117 | /* Deliver any pending events. */ |
| 118 | extern void gdb_events_deliver (struct gdb_events *vector); |
| 119 | |
| 120 | /* Clear event handlers */ |
| 121 | extern void clear_gdb_event_hooks (void); |
| 122 | |
| 123 | #if !WITH_GDB_EVENTS |
| 124 | #define set_gdb_events(x) 0 |
| 125 | #define set_gdb_event_hooks(x) 0 |
| 126 | #define gdb_events_deliver(x) 0 |
| 127 | #endif |
| 128 | |
| 129 | #endif |