gdb/
[binutils-gdb.git] / gdb / tracepoint.h
index 3f3381703197e0df1affda49a751e28dfae62c82..5d2862a7b6619fde40a9138a1acfdfe30aa5b2d3 100644 (file)
@@ -1,11 +1,12 @@
 /* Data structures associated with tracepoints in GDB.
-   Copyright (C) 1997 Free Software Foundation, Inc.
+   Copyright (C) 1997, 1998, 1999, 2000, 2007, 2008, 2009, 2010
+   Free Software Foundation, Inc.
 
    This file is part of GDB.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
-   the Free Software Foundation; either version 2 of the License, or
+   the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
-   along with this program; if not, write to the Free Software
-   Foundation, Inc., 59 Temple Place - Suite 330,
-   Boston, MA 02111-1307, USA.  */
+   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
 
 #if !defined (TRACEPOINT_H)
 #define TRACEPOINT_H 1
 
-#if !defined (BREAKPOINT_H)
-enum enable
-  {
-    disabled, enabled
-  };
-#endif
 /* The data structure for an action: */
 struct action_line
   {
@@ -34,70 +27,6 @@ struct action_line
     char *action;
   };
 
-/* The data structure for a tracepoint: */
-
-struct tracepoint
-  {
-    struct tracepoint *next;
-
-    enum enable enabled;
-
-#if 0
-    /* Type of tracepoint (MVS FIXME: needed?). */
-    enum tptype type;
-
-    /* What to do with this tracepoint after we hit it MVS FIXME: needed?). */
-    enum tpdisp disposition;
-#endif
-    /* Number assigned to distinguish tracepoints.  */
-    int number;
-
-    /* Address to trace at, or NULL if not an instruction tracepoint (MVS ?). */
-    CORE_ADDR address;
-
-    /* Line number of this address.  Only matters if address is non-NULL.  */
-    int line_number;
-
-    /* Source file name of this address.  Only matters if address is non-NULL. */
-    char *source_file;
-
-    /* Number of times this tracepoint should single-step 
-       and collect additional data */
-    long step_count;
-
-    /* Number of times this tracepoint should be hit before disabling/ending. */
-    int pass_count;
-
-    /* Chain of action lines to execute when this tracepoint is hit. */
-    struct action_line *actions;
-
-    /* Conditional (MVS ?).  */
-    struct expression *cond;
-
-    /* String we used to set the tracepoint (malloc'd).  Only matters if
-       address is non-NULL.  */
-    char *addr_string;
-
-    /* Language we used to set the tracepoint.  */
-    enum language language;
-
-    /* Input radix we used to set the tracepoint.  */
-    int input_radix;
-
-    /* Count of the number of times this tracepoint was taken, dumped
-       with the info, but not used for anything else.  Useful for
-       seeing how many times you hit a tracepoint prior to the program
-       aborting, so you can back up to just before the abort.  */
-    int hit_count;
-
-    /* Thread number for thread-specific tracepoint, or -1 if don't care */
-    int thread;
-
-    /* BFD section, in case of overlays: 
-       no, I don't know if tracepoints are really gonna work with overlays.  */
-    asection *section;
-  };
-
 enum actionline_type
   {
     BADLINE = -1,
@@ -106,36 +35,50 @@ enum actionline_type
     STEPPING = 2
   };
 
+/* A trace state variable is a value managed by a target being
+   traced. A trace state variable (or tsv for short) can be accessed
+   and assigned to by tracepoint actions and conditionals, but is not
+   part of the program being traced, and it doesn't have to be
+   collected. Effectively the variables are scratch space for
+   tracepoints.  */
+
+struct trace_state_variable
+  {
+    /* The variable's name.  The user has to prefix with a dollar sign,
+       but we don't store that internally.  */
+    const char *name;
 
-/* The tracepont chain of all tracepoints */
+    /* An id number assigned by GDB, and transmitted to targets.  */
+    int number;
 
-extern struct tracepoint *tracepoint_chain;
+    /* The initial value of a variable is a 64-bit signed integer.  */
+    LONGEST initial_value;
+
+    /* 1 if the value is known, else 0.  The value is known during a
+       trace run, or in tfind mode if the variable was collected into
+       the current trace frame.  */
+    int value_known;
+
+    /* The value of a variable is a 64-bit signed integer.  */
+    LONGEST value;
+  };
 
 extern unsigned long trace_running_p;
 
-/* A hook used to notify the UI of tracepoint operations */
+extern char *default_collect;
 
-void (*create_tracepoint_hook) PARAMS ((struct tracepoint *));
-void (*delete_tracepoint_hook) PARAMS ((struct tracepoint *));
-void (*modify_tracepoint_hook) PARAMS ((struct tracepoint *));
-void (*trace_find_hook) PARAMS ((char *arg, int from_tty));
-void (*trace_start_stop_hook) PARAMS ((int start, int from_tty));
+/* A hook used to notify the UI of tracepoint operations.  */
 
-struct tracepoint *get_tracepoint_by_number PARAMS ((char **));
-int get_traceframe_number PARAMS ((void));
-void free_actions PARAMS ((struct tracepoint *));
-enum actionline_type validate_actionline PARAMS ((char **,
-                                                 struct tracepoint *));
+extern void (*deprecated_trace_find_hook) (char *arg, int from_tty);
+extern void (*deprecated_trace_start_stop_hook) (int start, int from_tty);
 
+int get_traceframe_number (void);
+void free_actions (struct breakpoint *);
+enum actionline_type validate_actionline (char **, struct breakpoint *);
 
-/* Walk the following statement or block through all tracepoints.
-   ALL_TRACEPOINTS_SAFE does so even if the statment deletes the current
-   breakpoint.  */
+extern void end_actions_pseudocommand (char *args, int from_tty);
+extern void while_stepping_pseudocommand (char *args, int from_tty);
 
-#define ALL_TRACEPOINTS(t)  for (t = tracepoint_chain; t; t = t->next)
+extern struct trace_state_variable *find_trace_state_variable (const char *name);
 
-#define ALL_TRACEPOINTS_SAFE(t,tmp)    \
-       for (t = tracepoint_chain;      \
-            t ? (tmp = t->next, 1) : 0;\
-            t = tmp)
-#endif /* TRACEPOINT_H */
+#endif /* TRACEPOINT_H */