1 /* Routines for handling XML memory maps provided by target.
3 Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "memory-map.h"
23 #include "gdb_assert.h"
24 #include "exceptions.h"
26 #include "gdb_string.h"
28 #if !defined(HAVE_LIBEXPAT)
31 parse_memory_map (const char *memory_map
)
33 static int have_warned
;
38 warning (_("Can not parse XML memory map; XML support was disabled "
45 #else /* HAVE_LIBEXPAT */
47 #include "xml-support.h"
49 /* Internal parsing data passed to all XML callbacks. */
50 struct memory_map_parsing_data
52 VEC(mem_region_s
) **memory_map
;
53 char property_name
[32];
56 /* Handle the start of a <memory> element. */
59 memory_map_start_memory (struct gdb_xml_parser
*parser
,
60 const struct gdb_xml_element
*element
,
61 void *user_data
, VEC(gdb_xml_value_s
) *attributes
)
63 struct memory_map_parsing_data
*data
= user_data
;
64 struct mem_region
*r
= VEC_safe_push (mem_region_s
, *data
->memory_map
, NULL
);
65 ULONGEST
*start_p
, *length_p
, *type_p
;
67 start_p
= VEC_index (gdb_xml_value_s
, attributes
, 0)->value
;
68 length_p
= VEC_index (gdb_xml_value_s
, attributes
, 1)->value
;
69 type_p
= VEC_index (gdb_xml_value_s
, attributes
, 2)->value
;
73 r
->hi
= r
->lo
+ *length_p
;
74 r
->attrib
.mode
= *type_p
;
75 r
->attrib
.blocksize
= -1;
78 /* Handle the end of a <memory> element. Verify that any necessary
79 children were present. */
82 memory_map_end_memory (struct gdb_xml_parser
*parser
,
83 const struct gdb_xml_element
*element
,
84 void *user_data
, const char *body_text
)
86 struct memory_map_parsing_data
*data
= user_data
;
87 struct mem_region
*r
= VEC_last (mem_region_s
, *data
->memory_map
);
89 if (r
->attrib
.mode
== MEM_FLASH
&& r
->attrib
.blocksize
== -1)
90 gdb_xml_error (parser
, _("Flash block size is not set"));
93 /* Handle the start of a <property> element by saving the name
94 attribute for later. */
97 memory_map_start_property (struct gdb_xml_parser
*parser
,
98 const struct gdb_xml_element
*element
,
99 void *user_data
, VEC(gdb_xml_value_s
) *attributes
)
101 struct memory_map_parsing_data
*data
= user_data
;
104 name
= VEC_index (gdb_xml_value_s
, attributes
, 0)->value
;
105 snprintf (data
->property_name
, sizeof (data
->property_name
), "%s", name
);
108 /* Handle the end of a <property> element and its value. */
111 memory_map_end_property (struct gdb_xml_parser
*parser
,
112 const struct gdb_xml_element
*element
,
113 void *user_data
, const char *body_text
)
115 struct memory_map_parsing_data
*data
= user_data
;
116 char *name
= data
->property_name
;
118 if (strcmp (name
, "blocksize") == 0)
120 struct mem_region
*r
= VEC_last (mem_region_s
, *data
->memory_map
);
122 r
->attrib
.blocksize
= gdb_xml_parse_ulongest (parser
, body_text
);
125 gdb_xml_debug (parser
, _("Unknown property \"%s\""), name
);
128 /* Discard the constructed memory map (if an error occurs). */
131 clear_result (void *p
)
133 VEC(mem_region_s
) **result
= p
;
134 VEC_free (mem_region_s
, *result
);
138 /* The allowed elements and attributes for an XML memory map. */
140 const struct gdb_xml_attribute property_attributes
[] = {
141 { "name", GDB_XML_AF_NONE
, NULL
, NULL
},
142 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
145 const struct gdb_xml_element memory_children
[] = {
146 { "property", property_attributes
, NULL
,
147 GDB_XML_EF_REPEATABLE
| GDB_XML_EF_OPTIONAL
,
148 memory_map_start_property
, memory_map_end_property
},
149 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
152 const struct gdb_xml_enum memory_type_enum
[] = {
155 { "flash", MEM_FLASH
},
159 const struct gdb_xml_attribute memory_attributes
[] = {
160 { "start", GDB_XML_AF_NONE
, gdb_xml_parse_attr_ulongest
, NULL
},
161 { "length", GDB_XML_AF_NONE
, gdb_xml_parse_attr_ulongest
, NULL
},
162 { "type", GDB_XML_AF_NONE
, gdb_xml_parse_attr_enum
, &memory_type_enum
},
163 { NULL
, GDB_XML_AF_NONE
, NULL
, NULL
}
166 const struct gdb_xml_element memory_map_children
[] = {
167 { "memory", memory_attributes
, memory_children
, GDB_XML_EF_REPEATABLE
,
168 memory_map_start_memory
, memory_map_end_memory
},
169 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
172 const struct gdb_xml_element memory_map_elements
[] = {
173 { "memory-map", NULL
, memory_map_children
, GDB_XML_EF_NONE
,
175 { NULL
, NULL
, NULL
, GDB_XML_EF_NONE
, NULL
, NULL
}
179 parse_memory_map (const char *memory_map
)
181 struct gdb_xml_parser
*parser
;
182 VEC(mem_region_s
) *result
= NULL
;
183 struct cleanup
*before_deleting_result
, *back_to
;
184 struct memory_map_parsing_data data
= { NULL
};
186 back_to
= make_cleanup (null_cleanup
, NULL
);
187 parser
= gdb_xml_create_parser_and_cleanup (_("target memory map"),
188 memory_map_elements
, &data
);
190 /* Note: 'clear_result' will zero 'result'. */
191 before_deleting_result
= make_cleanup (clear_result
, &result
);
192 data
.memory_map
= &result
;
194 if (gdb_xml_parse (parser
, memory_map
) == 0)
195 /* Parsed successfully, don't need to delete the result. */
196 discard_cleanups (before_deleting_result
);
198 do_cleanups (back_to
);
202 #endif /* HAVE_LIBEXPAT */