gdb/

[binutils.git] / gdb / memattr.h

diff --git a/gdb/memattr.h b/gdb/memattr.h
index 75b5f781c1dbafd9deaa629c6cd7dbe14631c195..dbee1d11a85cc8ae4280a263a8128dc606bebd73 100644 (file)
--- a/gdb/memattr.h
+++ b/gdb/memattr.h
@@ -1,12 +1,36 @@
-/* memattr.h */
+/* Memory attributes support, for GDB.
+
+   Copyright (C) 2001, 2006-2012 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 3 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, see <http://www.gnu.org/licenses/>.  */
+
 #ifndef MEMATTR_H
 #define MEMATTR_H
 
+#include "vec.h"
+
 enum mem_access_mode
 {
+  MEM_NONE,                     /* Memory that is not physically present.  */
   MEM_RW,                      /* read/write */
   MEM_RO,                      /* read only */
-  MEM_WO                       /* write only */
+  MEM_WO,                      /* write only */
+
+  /* Read/write, but special steps are required to write to it.  */
+  MEM_FLASH
 };
 
 enum mem_access_width
@@ -26,7 +50,7 @@ enum mem_access_width
    the mem_region structure.
 
    FIXME: It would be useful if there was a mechanism for targets to
-   add their own attributes.  For example, the number of wait states. */
+   add their own attributes.  For example, the number of wait states.  */
  
 struct mem_attrib 
 {
@@ -41,32 +65,45 @@ struct mem_attrib
   /* enables host-side caching of memory region data */
   int cache;
   
-  /* enables memory verification.  after a write, memory is re-read
-     to verify that the write was successful. */
-  int verify; 
+  /* Enables memory verification.  After a write, memory is re-read
+     to verify that the write was successful.  */
+  int verify;
+
+  /* Block size.  Only valid if mode == MEM_FLASH.  */
+  int blocksize;
 };
 
 struct mem_region 
 {
-  /* FIXME: memory regions are stored in an unsorted singly-linked
-     list.  This probably won't scale to handle hundreds of memory
-     regions --- that many could be needed to describe the allowed
-     access modes for memory mapped i/o device registers. */
-  struct mem_region *next;
-  
+  /* Lowest address in the region.  */
   CORE_ADDR lo;
+  /* Address past the highest address of the region. 
+     If 0, upper bound is "infinity".  */
   CORE_ADDR hi;
 
-  /* Item number of this memory region. */
+  /* Item number of this memory region.  */
   int number;
 
-  /* Status of this memory region (enabled or disabled) */
-  int status;
+  /* Status of this memory region (enabled if non-zero, otherwise
+     disabled).  */
+  int enabled_p;
 
-  /* Attributes for this region */
+  /* Attributes for this region.  */
   struct mem_attrib attrib;
 };
 
+/* Declare a vector type for a group of mem_region structures.  The
+   typedef is necessary because vec.h can not handle a struct tag.
+   Except during construction, these vectors are kept sorted.  */
+typedef struct mem_region mem_region_s;
+DEF_VEC_O(mem_region_s);
+
 extern struct mem_region *lookup_mem_region(CORE_ADDR);
 
+void invalidate_target_mem_regions (void);
+
+void mem_region_init (struct mem_region *);
+
+int mem_region_cmp (const void *, const void *);
+
 #endif /* MEMATTR_H */