1 /* Routines for handling XML memory maps provided by target.
3 Copyright (C) 2006-2014 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "memory-map.h"
22 #include "exceptions.h"
24 #if !defined(HAVE_LIBEXPAT)
27 parse_memory_map (const char *memory_map)
29 static int have_warned;
34 warning (_("Can not parse XML memory map; XML support was disabled "
41 #else /* HAVE_LIBEXPAT */
43 #include "xml-support.h"
45 /* Internal parsing data passed to all XML callbacks. */
46 struct memory_map_parsing_data
48 VEC(mem_region_s) **memory_map;
49 char property_name[32];
52 /* Handle the start of a <memory> element. */
55 memory_map_start_memory (struct gdb_xml_parser *parser,
56 const struct gdb_xml_element *element,
57 void *user_data, VEC(gdb_xml_value_s) *attributes)
59 struct memory_map_parsing_data *data = user_data;
60 struct mem_region *r = VEC_safe_push (mem_region_s, *data->memory_map, NULL);
61 ULONGEST *start_p, *length_p, *type_p;
63 start_p = xml_find_attribute (attributes, "start")->value;
64 length_p = xml_find_attribute (attributes, "length")->value;
65 type_p = xml_find_attribute (attributes, "type")->value;
69 r->hi = r->lo + *length_p;
70 r->attrib.mode = *type_p;
71 r->attrib.blocksize = -1;
74 /* Handle the end of a <memory> element. Verify that any necessary
75 children were present. */
78 memory_map_end_memory (struct gdb_xml_parser *parser,
79 const struct gdb_xml_element *element,
80 void *user_data, const char *body_text)
82 struct memory_map_parsing_data *data = user_data;
83 struct mem_region *r = VEC_last (mem_region_s, *data->memory_map);
85 if (r->attrib.mode == MEM_FLASH && r->attrib.blocksize == -1)
86 gdb_xml_error (parser, _("Flash block size is not set"));
89 /* Handle the start of a <property> element by saving the name
90 attribute for later. */
93 memory_map_start_property (struct gdb_xml_parser *parser,
94 const struct gdb_xml_element *element,
95 void *user_data, VEC(gdb_xml_value_s) *attributes)
97 struct memory_map_parsing_data *data = user_data;
100 name = xml_find_attribute (attributes, "name")->value;
101 snprintf (data->property_name, sizeof (data->property_name), "%s", name);
104 /* Handle the end of a <property> element and its value. */
107 memory_map_end_property (struct gdb_xml_parser *parser,
108 const struct gdb_xml_element *element,
109 void *user_data, const char *body_text)
111 struct memory_map_parsing_data *data = user_data;
112 char *name = data->property_name;
114 if (strcmp (name, "blocksize") == 0)
116 struct mem_region *r = VEC_last (mem_region_s, *data->memory_map);
118 r->attrib.blocksize = gdb_xml_parse_ulongest (parser, body_text);
121 gdb_xml_debug (parser, _("Unknown property \"%s\""), name);
124 /* Discard the constructed memory map (if an error occurs). */
127 clear_result (void *p)
129 VEC(mem_region_s) **result = p;
130 VEC_free (mem_region_s, *result);
134 /* The allowed elements and attributes for an XML memory map. */
136 const struct gdb_xml_attribute property_attributes[] = {
137 { "name", GDB_XML_AF_NONE, NULL, NULL },
138 { NULL, GDB_XML_AF_NONE, NULL, NULL }
141 const struct gdb_xml_element memory_children[] = {
142 { "property", property_attributes, NULL,
143 GDB_XML_EF_REPEATABLE | GDB_XML_EF_OPTIONAL,
144 memory_map_start_property, memory_map_end_property },
145 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
148 const struct gdb_xml_enum memory_type_enum[] = {
151 { "flash", MEM_FLASH },
155 const struct gdb_xml_attribute memory_attributes[] = {
156 { "start", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL },
157 { "length", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL },
158 { "type", GDB_XML_AF_NONE, gdb_xml_parse_attr_enum, &memory_type_enum },
159 { NULL, GDB_XML_AF_NONE, NULL, NULL }
162 const struct gdb_xml_element memory_map_children[] = {
163 { "memory", memory_attributes, memory_children, GDB_XML_EF_REPEATABLE,
164 memory_map_start_memory, memory_map_end_memory },
165 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
168 const struct gdb_xml_element memory_map_elements[] = {
169 { "memory-map", NULL, memory_map_children, GDB_XML_EF_NONE,
171 { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL }
175 parse_memory_map (const char *memory_map)
177 VEC(mem_region_s) *result = NULL;
178 struct cleanup *back_to;
179 struct memory_map_parsing_data data = { NULL };
181 data.memory_map = &result;
182 back_to = make_cleanup (clear_result, &result);
183 if (gdb_xml_parse_quick (_("target memory map"), NULL, memory_map_elements,
184 memory_map, &data) == 0)
186 /* Parsed successfully, keep the result. */
187 discard_cleanups (back_to);
191 do_cleanups (back_to);
195 #endif /* HAVE_LIBEXPAT */