Commit | Line | Data |
---|---|---|
fbbe92c5 SDJ |
1 | /* Functions that provide the mechanism to parse a syscall XML file |
2 | and get its values. | |
3 | ||
7b6bb8da | 4 | Copyright (C) 2009, 2010, 2011 Free Software Foundation, Inc. |
fbbe92c5 SDJ |
5 | |
6 | This file is part of GDB. | |
7 | ||
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. | |
12 | ||
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. | |
17 | ||
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/>. */ | |
20 | ||
21 | #include "defs.h" | |
22 | #include "gdbtypes.h" | |
23 | #include "xml-support.h" | |
24 | #include "xml-syscall.h" | |
25 | ||
26 | /* For the struct syscall definition. */ | |
27 | #include "target.h" | |
28 | ||
29 | #include "filenames.h" | |
30 | ||
31 | #include "gdb_assert.h" | |
32 | ||
33 | #ifndef HAVE_LIBEXPAT | |
34 | ||
35 | /* Dummy functions to indicate that there's no support for fetching | |
36 | syscalls information. */ | |
37 | ||
38 | static void | |
39 | syscall_warn_user (void) | |
40 | { | |
41 | static int have_warned = 0; | |
42 | if (!have_warned) | |
43 | { | |
44 | have_warned = 1; | |
45 | warning (_("Can not parse XML syscalls information; XML support was " | |
46 | "disabled at compile time.")); | |
47 | } | |
48 | } | |
49 | ||
50 | void | |
51 | set_xml_syscall_file_name (const char *name) | |
52 | { | |
bccd0dd2 | 53 | return; |
fbbe92c5 SDJ |
54 | } |
55 | ||
56 | void | |
57 | get_syscall_by_number (int syscall_number, | |
58 | struct syscall *s) | |
59 | { | |
60 | syscall_warn_user (); | |
61 | s->number = syscall_number; | |
62 | s->name = NULL; | |
63 | } | |
64 | ||
65 | void | |
66 | get_syscall_by_name (const char *syscall_name, | |
67 | struct syscall *s) | |
68 | { | |
69 | syscall_warn_user (); | |
70 | s->number = UNKNOWN_SYSCALL; | |
71 | s->name = syscall_name; | |
72 | } | |
73 | ||
74 | const char ** | |
75 | get_syscall_names (void) | |
76 | { | |
77 | syscall_warn_user (); | |
78 | return NULL; | |
79 | } | |
80 | ||
fbbe92c5 SDJ |
81 | #else /* ! HAVE_LIBEXPAT */ |
82 | ||
626ea16d SDJ |
83 | /* Variable that will hold the last known data-directory. This is useful to |
84 | know whether we should re-read the XML info for the target. */ | |
85 | static char *my_gdb_datadir = NULL; | |
86 | ||
fbbe92c5 SDJ |
87 | /* Structure which describes a syscall. */ |
88 | typedef struct syscall_desc | |
89 | { | |
90 | /* The syscall number. */ | |
91 | ||
92 | int number; | |
93 | ||
94 | /* The syscall name. */ | |
95 | ||
96 | char *name; | |
97 | } *syscall_desc_p; | |
98 | DEF_VEC_P(syscall_desc_p); | |
99 | ||
100 | /* Structure that represents syscalls information. */ | |
101 | struct syscalls_info | |
102 | { | |
103 | /* The syscalls. */ | |
104 | ||
105 | VEC(syscall_desc_p) *syscalls; | |
106 | }; | |
107 | ||
108 | /* Callback data for syscall information parsing. */ | |
109 | struct syscall_parsing_data | |
110 | { | |
111 | /* The syscalls_info we are building. */ | |
112 | ||
113 | struct syscalls_info *sysinfo; | |
114 | }; | |
115 | ||
116 | /* Structure used to store information about the available syscalls in | |
117 | the system. */ | |
bccd0dd2 | 118 | static const struct syscalls_info *sysinfo = NULL; |
fbbe92c5 SDJ |
119 | |
120 | /* A flag to tell if we already initialized the structure above. */ | |
121 | static int have_initialized_sysinfo = 0; | |
122 | ||
123 | /* The filename of the syscall's XML. */ | |
124 | static const char *xml_syscall_file = NULL; | |
125 | ||
126 | static struct syscalls_info * | |
127 | allocate_syscalls_info (void) | |
128 | { | |
129 | return XZALLOC (struct syscalls_info); | |
130 | } | |
131 | ||
132 | static void | |
133 | sysinfo_free_syscalls_desc (struct syscall_desc *sd) | |
134 | { | |
135 | xfree (sd->name); | |
136 | } | |
137 | ||
138 | static void | |
139 | free_syscalls_info (void *arg) | |
140 | { | |
141 | struct syscalls_info *sysinfo = arg; | |
142 | struct syscall_desc *sysdesc; | |
143 | int i; | |
144 | ||
145 | for (i = 0; | |
146 | VEC_iterate (syscall_desc_p, sysinfo->syscalls, i, sysdesc); | |
147 | i++) | |
148 | sysinfo_free_syscalls_desc (sysdesc); | |
149 | VEC_free (syscall_desc_p, sysinfo->syscalls); | |
150 | ||
151 | xfree (sysinfo); | |
152 | } | |
153 | ||
154 | struct cleanup * | |
155 | make_cleanup_free_syscalls_info (struct syscalls_info *sysinfo) | |
156 | { | |
157 | return make_cleanup (free_syscalls_info, sysinfo); | |
158 | } | |
159 | ||
160 | static void | |
161 | syscall_create_syscall_desc (struct syscalls_info *sysinfo, | |
162 | const char *name, int number) | |
163 | { | |
164 | struct syscall_desc *sysdesc = XZALLOC (struct syscall_desc); | |
165 | ||
166 | sysdesc->name = xstrdup (name); | |
167 | sysdesc->number = number; | |
168 | ||
169 | VEC_safe_push (syscall_desc_p, sysinfo->syscalls, sysdesc); | |
170 | } | |
171 | ||
fbbe92c5 SDJ |
172 | /* Handle the start of a <syscall> element. */ |
173 | static void | |
174 | syscall_start_syscall (struct gdb_xml_parser *parser, | |
175 | const struct gdb_xml_element *element, | |
176 | void *user_data, VEC(gdb_xml_value_s) *attributes) | |
177 | { | |
178 | struct syscall_parsing_data *data = user_data; | |
179 | struct gdb_xml_value *attrs = VEC_address (gdb_xml_value_s, attributes); | |
180 | int len, i; | |
181 | /* syscall info. */ | |
182 | char *name = NULL; | |
183 | int number = 0; | |
184 | ||
185 | len = VEC_length (gdb_xml_value_s, attributes); | |
186 | ||
187 | for (i = 0; i < len; i++) | |
188 | { | |
189 | if (strcmp (attrs[i].name, "name") == 0) | |
190 | name = attrs[i].value; | |
191 | else if (strcmp (attrs[i].name, "number") == 0) | |
192 | number = * (ULONGEST *) attrs[i].value; | |
193 | else | |
194 | internal_error (__FILE__, __LINE__, | |
195 | _("Unknown attribute name '%s'."), attrs[i].name); | |
196 | } | |
197 | ||
198 | syscall_create_syscall_desc (data->sysinfo, name, number); | |
199 | } | |
200 | ||
201 | ||
202 | /* The elements and attributes of an XML syscall document. */ | |
203 | static const struct gdb_xml_attribute syscall_attr[] = { | |
204 | { "number", GDB_XML_AF_NONE, gdb_xml_parse_attr_ulongest, NULL }, | |
205 | { "name", GDB_XML_AF_NONE, NULL, NULL }, | |
206 | { NULL, GDB_XML_AF_NONE, NULL, NULL } | |
207 | }; | |
208 | ||
209 | static const struct gdb_xml_element syscalls_info_children[] = { | |
210 | { "syscall", syscall_attr, NULL, | |
211 | GDB_XML_EF_OPTIONAL | GDB_XML_EF_REPEATABLE, | |
212 | syscall_start_syscall, NULL }, | |
213 | { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL } | |
214 | }; | |
215 | ||
216 | static const struct gdb_xml_element syselements[] = { | |
217 | { "syscalls_info", NULL, syscalls_info_children, | |
f8e50cfe | 218 | GDB_XML_EF_NONE, NULL, NULL }, |
fbbe92c5 SDJ |
219 | { NULL, NULL, NULL, GDB_XML_EF_NONE, NULL, NULL } |
220 | }; | |
221 | ||
222 | static struct syscalls_info * | |
223 | syscall_parse_xml (const char *document, xml_fetch_another fetcher, | |
224 | void *fetcher_baton) | |
225 | { | |
226 | struct cleanup *result_cleanup; | |
fbbe92c5 | 227 | struct syscall_parsing_data data; |
fbbe92c5 | 228 | |
fbbe92c5 SDJ |
229 | data.sysinfo = allocate_syscalls_info (); |
230 | result_cleanup = make_cleanup_free_syscalls_info (data.sysinfo); | |
231 | ||
efc0eabd PA |
232 | if (gdb_xml_parse_quick (_("syscalls info"), NULL, |
233 | syselements, document, &data) == 0) | |
fbbe92c5 SDJ |
234 | { |
235 | /* Parsed successfully. */ | |
236 | discard_cleanups (result_cleanup); | |
237 | return data.sysinfo; | |
238 | } | |
239 | else | |
240 | { | |
241 | warning (_("Could not load XML syscalls info; ignoring")); | |
242 | do_cleanups (result_cleanup); | |
243 | return NULL; | |
244 | } | |
245 | } | |
246 | ||
247 | /* Function responsible for initializing the information | |
248 | about the syscalls. It reads the XML file and fills the | |
249 | struct syscalls_info with the values. | |
250 | ||
251 | Returns the struct syscalls_info if the file is valid, NULL otherwise. */ | |
252 | static const struct syscalls_info * | |
253 | xml_init_syscalls_info (const char *filename) | |
254 | { | |
255 | char *full_file; | |
256 | char *dirname; | |
257 | struct syscalls_info *sysinfo; | |
258 | struct cleanup *back_to; | |
259 | ||
260 | full_file = xml_fetch_content_from_file (filename, gdb_datadir); | |
261 | if (full_file == NULL) | |
bccd0dd2 | 262 | return NULL; |
fbbe92c5 SDJ |
263 | |
264 | back_to = make_cleanup (xfree, full_file); | |
265 | ||
266 | dirname = ldirname (filename); | |
267 | if (dirname != NULL) | |
268 | make_cleanup (xfree, dirname); | |
269 | ||
3e43a32a MS |
270 | sysinfo = syscall_parse_xml (full_file, |
271 | xml_fetch_content_from_file, dirname); | |
fbbe92c5 SDJ |
272 | do_cleanups (back_to); |
273 | ||
274 | return sysinfo; | |
275 | } | |
276 | ||
277 | /* Initializes the syscalls_info structure according to the | |
278 | architecture. */ | |
279 | static void | |
280 | init_sysinfo (void) | |
281 | { | |
626ea16d SDJ |
282 | /* Should we re-read the XML info for this target? */ |
283 | if (my_gdb_datadir && strcmp (my_gdb_datadir, gdb_datadir) != 0) | |
284 | { | |
285 | /* The data-directory changed from the last time we used it. | |
286 | It means that we have to re-read the XML info. */ | |
287 | have_initialized_sysinfo = 0; | |
288 | xfree (my_gdb_datadir); | |
289 | my_gdb_datadir = NULL; | |
290 | if (sysinfo) | |
291 | free_syscalls_info ((void *) sysinfo); | |
292 | } | |
293 | ||
fbbe92c5 SDJ |
294 | /* Did we already try to initialize the structure? */ |
295 | if (have_initialized_sysinfo) | |
296 | return; | |
fbbe92c5 | 297 | |
bccd0dd2 | 298 | sysinfo = xml_init_syscalls_info (xml_syscall_file); |
fbbe92c5 SDJ |
299 | |
300 | have_initialized_sysinfo = 1; | |
301 | ||
bccd0dd2 | 302 | if (sysinfo == NULL) |
fbbe92c5 SDJ |
303 | { |
304 | if (xml_syscall_file) | |
3e43a32a | 305 | warning (_("Could not load the syscall XML file `%s/%s'."), |
626ea16d | 306 | gdb_datadir, xml_syscall_file); |
fbbe92c5 | 307 | else |
3e43a32a | 308 | warning (_("There is no XML file to open.")); |
bccd0dd2 | 309 | |
3e43a32a MS |
310 | warning (_("GDB will not be able to display " |
311 | "syscall names nor to verify if\n" | |
312 | "any provided syscall numbers are valid.")); | |
fbbe92c5 | 313 | } |
626ea16d SDJ |
314 | |
315 | /* Saving the data-directory used to read this XML info. */ | |
316 | my_gdb_datadir = xstrdup (gdb_datadir); | |
fbbe92c5 SDJ |
317 | } |
318 | ||
319 | static int | |
320 | xml_get_syscall_number (const struct syscalls_info *sysinfo, | |
321 | const char *syscall_name) | |
322 | { | |
323 | struct syscall_desc *sysdesc; | |
324 | int i; | |
325 | ||
326 | if (sysinfo == NULL | |
327 | || syscall_name == NULL) | |
328 | return UNKNOWN_SYSCALL; | |
329 | ||
330 | for (i = 0; | |
331 | VEC_iterate(syscall_desc_p, sysinfo->syscalls, i, sysdesc); | |
332 | i++) | |
333 | if (strcmp (sysdesc->name, syscall_name) == 0) | |
334 | return sysdesc->number; | |
335 | ||
336 | return UNKNOWN_SYSCALL; | |
337 | } | |
338 | ||
339 | static const char * | |
340 | xml_get_syscall_name (const struct syscalls_info *sysinfo, | |
341 | int syscall_number) | |
342 | { | |
343 | struct syscall_desc *sysdesc; | |
344 | int i; | |
345 | ||
346 | if (sysinfo == NULL | |
347 | || syscall_number < 0) | |
348 | return NULL; | |
349 | ||
350 | for (i = 0; | |
351 | VEC_iterate(syscall_desc_p, sysinfo->syscalls, i, sysdesc); | |
352 | i++) | |
353 | if (sysdesc->number == syscall_number) | |
354 | return sysdesc->name; | |
355 | ||
356 | return NULL; | |
357 | } | |
358 | ||
fbbe92c5 SDJ |
359 | static const char ** |
360 | xml_list_of_syscalls (const struct syscalls_info *sysinfo) | |
361 | { | |
362 | struct syscall_desc *sysdesc; | |
363 | const char **names = NULL; | |
364 | int nsyscalls; | |
365 | int i; | |
366 | ||
367 | if (sysinfo == NULL) | |
368 | return NULL; | |
369 | ||
370 | nsyscalls = VEC_length (syscall_desc_p, sysinfo->syscalls); | |
371 | names = xmalloc ((nsyscalls + 1) * sizeof (char *)); | |
372 | ||
373 | for (i = 0; | |
374 | VEC_iterate (syscall_desc_p, sysinfo->syscalls, i, sysdesc); | |
375 | i++) | |
376 | names[i] = sysdesc->name; | |
377 | ||
378 | names[i] = NULL; | |
379 | ||
380 | return names; | |
381 | } | |
382 | ||
383 | void | |
384 | set_xml_syscall_file_name (const char *name) | |
385 | { | |
386 | xml_syscall_file = name; | |
387 | } | |
388 | ||
389 | void | |
390 | get_syscall_by_number (int syscall_number, | |
391 | struct syscall *s) | |
392 | { | |
393 | init_sysinfo (); | |
394 | ||
395 | s->number = syscall_number; | |
bccd0dd2 | 396 | s->name = xml_get_syscall_name (sysinfo, syscall_number); |
fbbe92c5 SDJ |
397 | } |
398 | ||
399 | void | |
400 | get_syscall_by_name (const char *syscall_name, | |
401 | struct syscall *s) | |
402 | { | |
403 | init_sysinfo (); | |
404 | ||
bccd0dd2 | 405 | s->number = xml_get_syscall_number (sysinfo, syscall_name); |
fbbe92c5 SDJ |
406 | s->name = syscall_name; |
407 | } | |
408 | ||
409 | const char ** | |
410 | get_syscall_names (void) | |
411 | { | |
412 | init_sysinfo (); | |
413 | ||
bccd0dd2 | 414 | return xml_list_of_syscalls (sysinfo); |
fbbe92c5 SDJ |
415 | } |
416 | ||
417 | #endif /* ! HAVE_LIBEXPAT */ |