* TODO: Note abstraction layer violation where "ocd reset" command
[deliverable/binutils-gdb.git] / gdb / monitor.h
index 48e83ba82e23503f5ab73dfa355580c68fab3b29..562c19e8dd2d7f80f55a2fca2e2731bf8cab6979 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) (char *name, int namelen, char *val, int vallen);
+    void (*load_routine) (serial_t desc, char *file,
+                         int hashmark);        /* Download routine */
+    int (*dumpregs) (void);    /* routine to dump all registers */
+    int (*continue_hook) (void);       /* Emit the continue command */
+    int (*wait_filter) (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. */
@@ -205,19 +216,33 @@ struct monitor_ops
 
 #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,
-                                 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 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 void monitor_open (char *args, struct monitor_ops *ops, int from_tty);
+extern void monitor_close (int quitting);
+extern char *monitor_supply_register (int regno, char *valstr);
+extern int monitor_expect (char *prompt, char *buf, int buflen);
+extern int monitor_expect_prompt (char *buf, int buflen);
+extern void monitor_printf (char *, ...) ATTR_FORMAT (printf, 1, 2);
+extern void
+monitor_printf_noecho (char *, ...)
+ATTR_FORMAT (printf, 1, 2);
+extern void monitor_write (char *buf, int buflen);
+extern int monitor_readchar (void);
+extern char *monitor_get_dev_name (void);
+extern void init_monitor_ops (struct target_ops *);
+extern int monitor_dump_reg_block (char *dump_cmd);
This page took 0.02827 seconds and 4 git commands to generate.