2000-03-28 J.T. Conklin <jtc@redback.com>
[deliverable/binutils-gdb.git] / gdb / monitor.h
index cf1e0cef8f092ec753029689eaba273671a373df..cef907bc41debefe5c90e286e56cefb0c15f814d 100644 (file)
@@ -1,23 +1,24 @@
 /* Definitions for remote debugging interface for ROM monitors.
-    Copyright 1990, 1991, 1992, 1996 Free Software Foundation, Inc.
-    Contributed by Cygnus Support. Written by Rob Savoye for Cygnus.
-  
+   Copyright 1990, 1991, 1992, 1996 Free Software Foundation, Inc.
+   Contributed by Cygnus Support. Written by Rob Savoye for Cygnus.
+
    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
    (at your option) any later version.
-  
+
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    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.
-*/
+   Foundation, Inc., 59 Temple Place - Suite 330,
+   Boston, MA 02111-1307, USA.
+ */
 
 #include "serial.h"
 
    will also be ignored if TERM is NULL.  */
 
 struct memrw_cmd
-{
-  char *cmdb;                  /* Command to send for byte read/write */
-  char *cmdw;                  /* Command for word (16 bit) read/write */
-  char *cmdl;                  /* Command for long (32 bit) read/write */
-  char *cmdll;                 /* Command for long long (64 bit) read/write */
-  char *resp_delim;            /* String just prior to the desired value */
-  char *term;                  /* Terminating string to search for */
-  char *term_cmd;              /* String to get out of sub-mode (if necessary) */
-};
+  {
+    char *cmdb;                        /* Command to send for byte read/write */
+    char *cmdw;                        /* Command for word (16 bit) read/write */
+    char *cmdl;                        /* Command for long (32 bit) read/write */
+    char *cmdll;               /* Command for long long (64 bit) read/write */
+    char *resp_delim;          /* String just prior to the desired value */
+    char *term;                        /* Terminating string to search for */
+    char *term_cmd;            /* String to get out of sub-mode (if necessary) */
+  };
 
 struct regrw_cmd
-{
-  char *cmd;                   /* Command to send for reg read/write */
-  char *resp_delim;            /* String (actually a regexp if getmem) just
+  {
+    char *cmd;                 /* Command to send for reg read/write */
+    char *resp_delim;          /* String (actually a regexp if getmem) just
                                   prior to the desired value */
-  char *term;                  /* Terminating string to search for */
-  char *term_cmd;              /* String to get out of sub-mode (if necessary) */
-};
+    char *term;                        /* Terminating string to search for */
+    char *term_cmd;            /* String to get out of sub-mode (if necessary) */
+  };
 
 struct monitor_ops
-{
-  int flags;                   /* See below */
-  char **init;                 /* List of init commands.  NULL terminated. */
-  char *cont;                  /* continue command */
-  char *step;                  /* single step */
-  char *stop;                  /* Interrupt program string */
-  char *set_break;             /* set a breakpoint */
-  char *clr_break;             /* clear a breakpoint */
-  char *clr_all_break;         /* Clear all breakpoints */
-  char *fill;                  /* Memory fill cmd (addr len val) */
-  struct memrw_cmd setmem;     /* set memory to a value */
-  struct memrw_cmd getmem;     /* display memory */
-  struct regrw_cmd setreg;     /* set a register */
-  struct regrw_cmd getreg;     /* get a register */
-                               /* Some commands can dump a bunch of registers
-                                  at once.  This comes as a set of REG=VAL
-                                  pairs.  This should be called for each pair
-                                  of registers that we can parse to supply
-                                  GDB with the value of a register.  */
-  char *dump_registers;                /* Command to dump all regs at once */
-  char *register_pattern;      /* Pattern that picks out register from reg dump */
-  void (*supply_register) PARAMS ((char *name, int namelen, char *val, int vallen));
-  void (*load_routine) PARAMS ((serial_t desc, char *file, int hashmark)); /* Download routine */
-  char *load;                  /* load command */
-  char *loadresp;              /* Response to load command */
-  char *prompt;                        /* monitor command prompt */
-  char *line_term;             /* end-of-command delimitor */
-  char *cmd_end;               /* optional command terminator */
-  struct target_ops *target;   /* target operations */
-  int stopbits;                        /* number of stop bits */
-  char **regnames;             /* array of register names in ascii */
-  int magic;                   /* Check value */
-};
+  {
+    int flags;                 /* See below */
+    char **init;               /* List of init commands.  NULL terminated. */
+    char *cont;                        /* continue command */
+    char *step;                        /* single step */
+    char *stop;                        /* Interrupt program string */
+    char *set_break;           /* set a breakpoint. If NULL, monitor implementation
+                                  sets its own to_insert_breakpoint method. */
+    char *clr_break;           /* clear a breakpoint */
+    char *clr_all_break;       /* Clear all breakpoints */
+    char *fill;                        /* Memory fill cmd (addr len val) */
+    struct memrw_cmd setmem;   /* set memory to a value */
+    struct memrw_cmd getmem;   /* display memory */
+    struct regrw_cmd setreg;   /* set a register */
+    struct regrw_cmd getreg;   /* get a register */
+    /* Some commands can dump a bunch of registers
+       at once.  This comes as a set of REG=VAL
+       pairs.  This should be called for each pair
+       of registers that we can parse to supply
+       GDB with the value of a register.  */
+    char *dump_registers;      /* Command to dump all regs at once */
+    char *register_pattern;    /* Pattern that picks out register from reg dump */
+    void (*supply_register) PARAMS ((char *name, int namelen,
+                                    char *val, int vallen));
+    void (*load_routine) PARAMS ((serial_t desc, char *file,
+                                 int hashmark));       /* Download routine */
+    int (*dumpregs) PARAMS ((void));   /* routine to dump all registers */
+    int (*continue_hook) PARAMS ((void));      /* Emit the continue command */
+    int (*wait_filter) PARAMS ((char *buf,     /* Maybe contains registers */
+                               int bufmax,
+                               int *response_length,
+                               struct target_waitstatus * status));
+    char *load;                        /* load command */
+    char *loadresp;            /* Response to load command */
+    char *prompt;              /* monitor command prompt */
+    char *line_term;           /* end-of-command delimitor */
+    char *cmd_end;             /* optional command terminator */
+    struct target_ops *target; /* target operations */
+    int stopbits;              /* number of stop bits */
+    char **regnames;           /* array of register names in ascii */
+    int num_breakpoints;       /* If set_break != NULL, number of supported
+                                  breakpoints */
+    int magic;                 /* Check value */
+  };
 
 /* The monitor ops magic number, used to detect if an ops structure doesn't
    have the right number of entries filled in. */
@@ -197,17 +209,44 @@ struct monitor_ops
 
 #define MO_SREC_ACK_ROTATE 0x80000
 
+/* If set, then remove useless address bits from memory addresses.  */
+
+#define MO_ADDR_BITS_REMOVE 0x100000
+
+/* If set, then display target program output if prefixed by ^O.  */
+
+#define MO_PRINT_PROGRAM_OUTPUT 0x200000
+
+/* Some dump bytes commands align the first data with the preceeding
+   16 byte boundary. Some print blanks and start at the exactly the
+   requested boundary. */
+
+#define MO_EXACT_DUMPADDR 0x400000
+
+/* Rather entering and exiting the write memory dialog for each word byte,
+   we can save time by transferring the whole block without exiting
+   the memory editing mode. You only need to worry about this
+   if you are doing memory downloading.
+   This engages a new write function registered with dcache.
+ */
+#define MO_HAS_BLOCKWRITES 0x800000
+
 #define SREC_SIZE 160
 
-extern void monitor_open PARAMS ((char *args, struct monitor_ops *ops,
+extern void monitor_open PARAMS ((char *args, struct monitor_ops * ops,
                                  int from_tty));
 extern void monitor_close PARAMS ((int quitting));
 extern char *monitor_supply_register PARAMS ((int regno, char *valstr));
 extern int monitor_expect PARAMS ((char *prompt, char *buf, int buflen));
 extern int monitor_expect_prompt PARAMS ((char *buf, int buflen));
-extern void monitor_printf PARAMS ((char *, ...))
-     ATTR_FORMAT(printf, 1, 2);
-extern void monitor_printf_noecho PARAMS ((char *, ...))
-     ATTR_FORMAT(printf, 1, 2);
-extern char *monitor_get_dev_name PARAMS ((void));
-extern void init_monitor_ops PARAMS ((struct target_ops *));
+extern void monitor_printf
+PARAMS ((char *,...))
+ATTR_FORMAT (printf, 1, 2);
+     extern void monitor_printf_noecho PARAMS ((char *,...))
+  ATTR_FORMAT (printf, 1, 2);
+     extern void monitor_write PARAMS ((char *buf, int buflen));
+     extern int monitor_readchar PARAMS ((void));
+     extern char *monitor_get_dev_name PARAMS ((void));
+     extern void init_monitor_ops PARAMS ((struct target_ops *));
+     extern int monitor_dump_reg_block PARAMS ((char *dump_cmd));
+     extern void flush_monitor_dcache PARAMS ((void));
This page took 0.027483 seconds and 4 git commands to generate.