contrib/gdb/gdb/gdb-events.h

   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