GDBserver

tdesc.h
Go to the documentation of this file.
1 /* Target description definitions for remote server for GDB.
2 Copyright (C) 2012-2018 Free Software Foundation, Inc.
3
4 This file is part of GDB.
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
18
19 #ifndef TDESC_H
20 #define TDESC_H
21
22 #include "arch/tdesc.h"
23
24 #include "regdef.h"
25 #include <vector>
26
27 struct tdesc_feature
28 {};
29
30 /* A target description. Inherit from tdesc_feature so that target_desc
31 can be used as tdesc_feature. */
32
33 struct target_desc : tdesc_feature
34 {
35 /* A vector of elements of register definitions that
36 describe the inferior's register set. */
37 std::vector<struct reg *> reg_defs;
38
39 /* The register cache size, in bytes. */
40 int registers_size;
41
42 #ifndef IN_PROCESS_AGENT
43 /* An array of register names. These are the "expedite" registers:
44 registers whose values are sent along with stop replies. */
45 const char **expedite_regs = NULL;
46
47 /* Defines what to return when looking for the "target.xml" file in
48 response to qXfer:features:read. Its contents can either be
49 verbatim XML code (prefixed with a '@') or else the name of the
50 actual XML file to be used in place of "target.xml".
51
52 It can be NULL, then, its content is got from the following three
53 fields features, arch, and osabi in tdesc_get_features_xml. */
54 const char *xmltarget = NULL;
55
56 /* XML features in this target description. */
57 VEC (char_ptr) *features = NULL;
58
59 /* The value of <architecture> element in the XML, replying GDB. */
60 const char *arch = NULL;
61
62 /* The value of <osabi> element in the XML, replying GDB. */
63 const char *osabi = NULL;
64
65 public:
66 target_desc ()
67 : registers_size (0)
68 {}
69
70 ~target_desc ()
71 {
72 int i;
73
74 for (reg *reg : reg_defs)
75 xfree (reg);
76
77 xfree ((char *) arch);
78 xfree ((char *) osabi);
79
80 char *f;
81
82 for (i = 0; VEC_iterate (char_ptr, features, i, f); i++)
83 xfree (f);
84 VEC_free (char_ptr, features);
85 }
86
87 bool operator== (const target_desc &other) const
88 {
89 if (reg_defs.size () != other.reg_defs.size ())
90 return false;
91
92 for (int i = 0; i < reg_defs.size (); ++i)
93 {
94 struct reg *reg = reg_defs[i];
95 struct reg *reg2 = other.reg_defs[i];
96
97 if (reg != reg2 && *reg != *reg2)
98 return false;
99 }
100
101 /* Compare expedite_regs. */
102 int i = 0;
103 for (; expedite_regs[i] != NULL; i++)
104 {
105 if (strcmp (expedite_regs[i], other.expedite_regs[i]) != 0)
106 return false;
107 }
108 if (other.expedite_regs[i] != NULL)
109 return false;
110
111 return true;
112 }
113
114 bool operator!= (const target_desc &other) const
115 {
116 return !(*this == other);
117 }
118 #endif
119 };
120
121 /* Copy target description SRC to DEST. */
122
123 void copy_target_description (struct target_desc *dest,
124 const struct target_desc *src);
125
126 /* Initialize TDESC. */
127
128 void init_target_desc (struct target_desc *tdesc);
129
130 /* Return the current inferior's target description. Never returns
131 NULL. */
132
133 const struct target_desc *current_target_desc (void);
134
135 #ifndef IN_PROCESS_AGENT
136 const char *tdesc_get_features_xml (struct target_desc *tdesc);
137 #endif
138
139 #endif /* TDESC_H */
target_desc::arch
const char * arch
Definition: tdesc.h:60
xfree
static void xfree(T *ptr)
Definition: common-utils.h:54
target_desc::VEC
VEC(char_ptr) *features
target_desc::expedite_regs
const char ** expedite_regs
Definition: tdesc.h:45
init_target_desc
void init_target_desc(struct target_desc *tdesc)
Definition: tdesc.c:23
target_desc::operator!=
bool operator!=(const target_desc &other) const
Definition: tdesc.h:114
tdesc_get_features_xml
const char * tdesc_get_features_xml(struct target_desc *tdesc)
Definition: tdesc.c:90
target_desc::xmltarget
const char * xmltarget
Definition: tdesc.h:54
char_ptr
char * char_ptr
Definition: gdb_vecs.h:25
target_desc::target_desc
target_desc()
Definition: tdesc.h:66
VEC_iterate
#define VEC_iterate(T, V, I, P)
Definition: vec.h:181
current_target_desc
const struct target_desc * current_target_desc(void)
Definition: tdesc.c:61
target_desc::operator==
bool operator==(const target_desc &other) const
Definition: tdesc.h:87
tdesc_feature
Definition: tdesc.h:27
target_desc::reg_defs
std::vector< struct reg * > reg_defs
Definition: tdesc.h:37
target_desc::registers_size
int registers_size
Definition: tdesc.h:40
target_desc
Definition: tdesc.h:33
copy_target_description
void copy_target_description(struct target_desc *dest, const struct target_desc *src)
Definition: tdesc.c:51
VEC_free
#define VEC_free(T, V)
Definition: vec.h:196
target_desc::~target_desc
~target_desc()
Definition: tdesc.h:70
target_desc::osabi
const char * osabi
Definition: tdesc.h:63