b501dfa995c5e64d2f9c2c4f3d8ba5cff5438bee
1 /* Copyright (C) 2006-2018 Free Software Foundation, Inc.
3 This file is part of GDB.
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
19 #define ARCH_TDESC_H 1
23 struct tdesc_type_builtin
;
24 struct tdesc_type_vector
;
25 struct tdesc_type_with_fields
;
29 /* The interface to visit different elements of target description. */
31 class tdesc_element_visitor
34 virtual void visit_pre (const target_desc
*e
)
37 virtual void visit_post (const target_desc
*e
)
40 virtual void visit_pre (const tdesc_feature
*e
)
43 virtual void visit_post (const tdesc_feature
*e
)
46 virtual void visit (const tdesc_type_builtin
*e
)
49 virtual void visit (const tdesc_type_vector
*e
)
52 virtual void visit (const tdesc_type_with_fields
*e
)
55 virtual void visit (const tdesc_reg
*e
)
62 virtual void accept (tdesc_element_visitor
&v
) const = 0;
65 /* An individual register from a target description. */
67 struct tdesc_reg
: tdesc_element
69 tdesc_reg (struct tdesc_feature
*feature
, const std::string
&name_
,
70 int regnum
, int save_restore_
, const char *group_
,
71 int bitsize_
, const char *type_
);
73 virtual ~tdesc_reg () = default;
75 DISABLE_COPY_AND_ASSIGN (tdesc_reg
);
77 /* The name of this register. In standard features, it may be
78 recognized by the architecture support code, or it may be purely
82 /* The register number used by this target to refer to this
83 register. This is used for remote p/P packets and to determine
84 the ordering of registers in the remote g/G packets. */
87 /* If this flag is set, GDB should save and restore this register
88 around calls to an inferior function. */
91 /* The name of the register group containing this register, or empty
92 if the group should be automatically determined from the
93 register's type. If this is "general", "float", or "vector", the
94 corresponding "info" command should display this register's
95 value. It can be an arbitrary string, but should be limited to
96 alphanumeric characters and internal hyphens. Currently other
97 strings are ignored (treated as empty). */
100 /* The size of the register, in bits. */
103 /* The type of the register. This string corresponds to either
104 a named type from the target description or a predefined
108 /* The target-described type corresponding to TYPE, if found. */
109 struct tdesc_type
*tdesc_type
;
111 void accept (tdesc_element_visitor
&v
) const override
116 bool operator== (const tdesc_reg
&other
) const
118 return (name
== other
.name
119 && target_regnum
== other
.target_regnum
120 && save_restore
== other
.save_restore
121 && bitsize
== other
.bitsize
122 && group
== other
.group
123 && type
== other
.type
);
126 bool operator!= (const tdesc_reg
&other
) const
128 return !(*this == other
);
132 typedef std::unique_ptr
<tdesc_reg
> tdesc_reg_up
;
136 /* Predefined types. */
150 TDESC_TYPE_IEEE_SINGLE
,
151 TDESC_TYPE_IEEE_DOUBLE
,
152 TDESC_TYPE_ARM_FPA_EXT
,
155 /* Types defined by a target feature. */
163 struct tdesc_type
: tdesc_element
165 tdesc_type (const std::string
&name_
, enum tdesc_type_kind kind_
)
166 : name (name_
), kind (kind_
)
169 virtual ~tdesc_type () = default;
171 DISABLE_COPY_AND_ASSIGN (tdesc_type
);
173 /* The name of this type. */
176 /* Identify the kind of this type. */
177 enum tdesc_type_kind kind
;
179 bool operator== (const tdesc_type
&other
) const
181 return name
== other
.name
&& kind
== other
.kind
;
184 bool operator!= (const tdesc_type
&other
) const
186 return !(*this == other
);
190 typedef std::unique_ptr
<tdesc_type
> tdesc_type_up
;
192 /* A feature from a target description. Each feature is a collection
193 of other elements, e.g. registers and types. */
195 struct tdesc_feature
: tdesc_element
197 tdesc_feature (const std::string
&name_
)
201 virtual ~tdesc_feature () = default;
203 DISABLE_COPY_AND_ASSIGN (tdesc_feature
);
205 /* The name of this feature. It may be recognized by the architecture
209 /* The registers associated with this feature. */
210 std::vector
<tdesc_reg_up
> registers
;
212 /* The types associated with this feature. */
213 std::vector
<tdesc_type_up
> types
;
215 void accept (tdesc_element_visitor
&v
) const override
;
217 bool operator== (const tdesc_feature
&other
) const;
219 bool operator!= (const tdesc_feature
&other
) const
221 return !(*this == other
);
225 typedef std::unique_ptr
<tdesc_feature
> tdesc_feature_up
;
227 /* Allocate a new target_desc. */
228 target_desc
*allocate_target_description (void);
230 /* Set TARGET_DESC's architecture by NAME. */
231 void set_tdesc_architecture (target_desc
*target_desc
,
234 /* Set TARGET_DESC's osabi by NAME. */
235 void set_tdesc_osabi (target_desc
*target_desc
, const char *name
);
237 /* Return the type associated with ID in the context of FEATURE, or
239 struct tdesc_type
*tdesc_named_type (const struct tdesc_feature
*feature
,
242 /* Return the created feature named NAME in target description TDESC. */
243 struct tdesc_feature
*tdesc_create_feature (struct target_desc
*tdesc
,
245 const char *xml
= nullptr);
248 /* Return the created vector tdesc_type named NAME in FEATURE. */
249 struct tdesc_type
*tdesc_create_vector (struct tdesc_feature
*feature
,
251 struct tdesc_type
*field_type
,
254 /* Return the created struct tdesc_type named NAME in FEATURE. */
255 tdesc_type_with_fields
*tdesc_create_struct (struct tdesc_feature
*feature
,
258 /* Return the created union tdesc_type named NAME in FEATURE. */
259 tdesc_type_with_fields
*tdesc_create_union (struct tdesc_feature
*feature
,
262 /* Return the created flags tdesc_type named NAME in FEATURE. */
263 tdesc_type_with_fields
*tdesc_create_flags (struct tdesc_feature
*feature
,
267 /* Add a new field to TYPE. FIELD_NAME is its name, and FIELD_TYPE is
269 void tdesc_add_field (tdesc_type_with_fields
*type
, const char *field_name
,
270 struct tdesc_type
*field_type
);
272 /* Set the total length of TYPE. Structs which contain bitfields may
273 omit the reserved bits, so the end of the last field may not
275 void tdesc_set_struct_size (tdesc_type_with_fields
*type
, int size
);
277 /* Add a new untyped bitfield to TYPE.
278 Untyped bitfields become either uint32 or uint64 depending on the size
279 of the underlying type. */
280 void tdesc_add_bitfield (tdesc_type_with_fields
*type
, const char *field_name
,
283 /* A flag is just a typed(bool) single-bit bitfield.
284 This function is kept to minimize changes in generated files. */
285 void tdesc_add_flag (tdesc_type_with_fields
*type
, int start
,
286 const char *flag_name
);
288 /* Create a register in feature FEATURE. */
289 void tdesc_create_reg (struct tdesc_feature
*feature
, const char *name
,
290 int regnum
, int save_restore
, const char *group
,
291 int bitsize
, const char *type
);
293 #endif /* ARCH_TDESC_H */
This page took 0.033907 seconds and 3 git commands to generate.