1/* XML target description support for GDB.
2
3   Copyright (C) 2006-2020 Free Software Foundation, Inc.
4
5   Contributed by CodeSourcery.
6
7   This file is part of GDB.
8
9   This program is free software; you can redistribute it and/or modify
10   it under the terms of the GNU General Public License as published by
11   the Free Software Foundation; either version 3 of the License, or
12   (at your option) any later version.
13
14   This program is distributed in the hope that it will be useful,
15   but WITHOUT ANY WARRANTY; without even the implied warranty of
16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17   GNU General Public License for more details.
18
19   You should have received a copy of the GNU General Public License
20   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
21
22#ifndef XML_TDESC_H
23#define XML_TDESC_H
24
25#include "gdbsupport/gdb_optional.h"
26#include <string>
27
28struct target_ops;
29struct target_desc;
30
31/* Read an XML target description from FILENAME.  Parse it, and return
32   the parsed description.  */
33
34const struct target_desc *file_read_description_xml (const char *filename);
35
36/* Read an XML target description using OPS.  Parse it, and return the
37   parsed description.  */
38
39const struct target_desc *target_read_description_xml (struct target_ops *);
40
41/* Fetches an XML target description using OPS, processing includes,
42   but not parsing it.  Used to dump whole tdesc as a single XML file.
43   Returns the description on success, and a disengaged optional
44   otherwise.  */
45gdb::optional<std::string> target_fetch_description_xml (target_ops *ops);
46
47/* Take an xml string, parse it, and return the parsed description.  Does not
48   handle a string containing includes.  */
49
50const struct target_desc *string_read_description_xml (const char *xml);
51
52#endif /* XML_TDESC_H */
53
54