]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - gdb/gdbtypes.h
Use GCC5/DWARF5 DW_AT_noreturn to mark functions that don't return normally.
[thirdparty/binutils-gdb.git] / gdb / gdbtypes.h
CommitLineData
80180f79 1
c906108c 2/* Internal type definitions for GDB.
1bac305b 3
32d0add0 4 Copyright (C) 1992-2015 Free Software Foundation, Inc.
1bac305b 5
c906108c
SS
6 Contributed by Cygnus Support, using pieces from other GDB modules.
7
c5aa993b 8 This file is part of GDB.
c906108c 9
c5aa993b
JM
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
a9762ec7 12 the Free Software Foundation; either version 3 of the License, or
c5aa993b 13 (at your option) any later version.
c906108c 14
c5aa993b
JM
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
c906108c 19
c5aa993b 20 You should have received a copy of the GNU General Public License
a9762ec7 21 along with this program. If not, see <http://www.gnu.org/licenses/>. */
c906108c
SS
22
23#if !defined (GDBTYPES_H)
24#define GDBTYPES_H 1
25
5e3a2c38
SS
26/* * \page gdbtypes GDB Types
27
28 GDB represents all the different kinds of types in programming
29 languages using a common representation defined in gdbtypes.h.
30
31 The main data structure is main_type; it consists of a code (such
71e50e83 32 as #TYPE_CODE_ENUM for enumeration types), a number of
5e3a2c38 33 generally-useful fields such as the printable name, and finally a
71e50e83
YQ
34 field main_type::type_specific that is a union of info specific to
35 particular languages or other special cases (such as calling
36 convention).
5e3a2c38 37
71e50e83 38 The available type codes are defined in enum #type_code. The enum
5e3a2c38
SS
39 includes codes both for types that are common across a variety
40 of languages, and for types that are language-specific.
41
71e50e83
YQ
42 Most accesses to type fields go through macros such as
43 #TYPE_CODE(thistype) and #TYPE_FN_FIELD_CONST(thisfn, n). These are
44 written such that they can be used as both rvalues and lvalues.
5e3a2c38
SS
45 */
46
ae5a43e0
DJ
47#include "hashtab.h"
48
7fc73f38 49/* Forward declarations for prototypes. */
da3331ec 50struct field;
7fc73f38 51struct block;
79a45b7d 52struct value_print_options;
e6c014f2 53struct language_defn;
7fc73f38 54
836bf454
JK
55/* These declarations are DWARF-specific as some of the gdbtypes.h data types
56 are already DWARF-specific. */
57
5e3a2c38
SS
58/* * Offset relative to the start of its containing CU (compilation
59 unit). */
836bf454
JK
60typedef struct
61{
62 unsigned int cu_off;
63} cu_offset;
64
5e3a2c38
SS
65/* * Offset relative to the start of its .debug_info or .debug_types
66 section. */
67
836bf454
JK
68typedef struct
69{
70 unsigned int sect_off;
71} sect_offset;
72
c906108c
SS
73/* Some macros for char-based bitfields. */
74
75#define B_SET(a,x) ((a)[(x)>>3] |= (1 << ((x)&7)))
76#define B_CLR(a,x) ((a)[(x)>>3] &= ~(1 << ((x)&7)))
77#define B_TST(a,x) ((a)[(x)>>3] & (1 << ((x)&7)))
78#define B_TYPE unsigned char
79#define B_BYTES(x) ( 1 + ((x)>>3) )
80#define B_CLRALL(a,x) memset ((a), 0, B_BYTES(x))
81
5e3a2c38
SS
82/* * Different kinds of data types are distinguished by the `code'
83 field. */
c906108c
SS
84
85enum type_code
c5aa993b 86 {
5e3a2c38
SS
87 TYPE_CODE_BITSTRING = -1, /**< Deprecated */
88 TYPE_CODE_UNDEF = 0, /**< Not used; catches errors */
89 TYPE_CODE_PTR, /**< Pointer type */
e6742ace 90
5e3a2c38 91 /* * Array type with lower & upper bounds.
e6742ace
JB
92
93 Regardless of the language, GDB represents multidimensional
94 array types the way C does: as arrays of arrays. So an
95 instance of a GDB array type T can always be seen as a series
96 of instances of TYPE_TARGET_TYPE (T) laid out sequentially in
97 memory.
98
99 Row-major languages like C lay out multi-dimensional arrays so
100 that incrementing the rightmost index in a subscripting
101 expression results in the smallest change in the address of the
102 element referred to. Column-major languages like Fortran lay
103 them out so that incrementing the leftmost index results in the
104 smallest change.
105
106 This means that, in column-major languages, working our way
107 from type to target type corresponds to working through indices
108 from right to left, not left to right. */
109 TYPE_CODE_ARRAY,
110
5e3a2c38
SS
111 TYPE_CODE_STRUCT, /**< C struct or Pascal record */
112 TYPE_CODE_UNION, /**< C union or Pascal variant part */
113 TYPE_CODE_ENUM, /**< Enumeration type */
114 TYPE_CODE_FLAGS, /**< Bit flags type */
115 TYPE_CODE_FUNC, /**< Function type */
116 TYPE_CODE_INT, /**< Integer type */
c5aa993b 117
5e3a2c38
SS
118 /* * Floating type. This is *NOT* a complex type. Beware, there
119 are parts of GDB which bogusly assume that TYPE_CODE_FLT can
120 mean complex. */
c5aa993b
JM
121 TYPE_CODE_FLT,
122
5e3a2c38
SS
123 /* * Void type. The length field specifies the length (probably
124 always one) which is used in pointer arithmetic involving
125 pointers to this type, but actually dereferencing such a
126 pointer is invalid; a void type has no length and no actual
127 representation in memory or registers. A pointer to a void
128 type is a generic pointer. */
c5aa993b
JM
129 TYPE_CODE_VOID,
130
5e3a2c38
SS
131 TYPE_CODE_SET, /**< Pascal sets */
132 TYPE_CODE_RANGE, /**< Range (integers within spec'd bounds). */
c5aa993b 133
5e3a2c38 134 /* * A string type which is like an array of character but prints
91101fe5
YQ
135 differently. It does not contain a length field as Pascal
136 strings (for many Pascals, anyway) do; if we want to deal with
137 such strings, we should use a new type code. */
c5aa993b
JM
138 TYPE_CODE_STRING,
139
5e3a2c38
SS
140 /* * Unknown type. The length field is valid if we were able to
141 deduce that much about the type, or 0 if we don't even know
142 that. */
c5aa993b
JM
143 TYPE_CODE_ERROR,
144
145 /* C++ */
5e3a2c38 146 TYPE_CODE_METHOD, /**< Method type */
0d5de010 147
5e3a2c38 148 /* * Pointer-to-member-function type. This describes how to access a
0d5de010
DJ
149 particular member function of a class (possibly a virtual
150 member function). The representation may vary between different
151 C++ ABIs. */
152 TYPE_CODE_METHODPTR,
153
5e3a2c38
SS
154 /* * Pointer-to-member type. This is the offset within a class to
155 some particular data member. The only currently supported
156 representation uses an unbiased offset, with -1 representing
157 NULL; this is used by the Itanium C++ ABI (used by GCC on all
158 platforms). */
0d5de010
DJ
159 TYPE_CODE_MEMBERPTR,
160
5e3a2c38 161 TYPE_CODE_REF, /**< C++ Reference types */
c5aa993b 162
5e3a2c38 163 TYPE_CODE_CHAR, /**< *real* character type */
c5aa993b 164
5e3a2c38
SS
165 /* * Boolean type. 0 is false, 1 is true, and other values are
166 non-boolean (e.g. FORTRAN "logical" used as unsigned int). */
c5aa993b
JM
167 TYPE_CODE_BOOL,
168
169 /* Fortran */
5e3a2c38 170 TYPE_CODE_COMPLEX, /**< Complex float */
c5aa993b
JM
171
172 TYPE_CODE_TYPEDEF,
c5aa993b 173
5e3a2c38 174 TYPE_CODE_NAMESPACE, /**< C++ namespace. */
7678ef8f 175
5e3a2c38 176 TYPE_CODE_DECFLOAT, /**< Decimal floating point. */
bc3b79fd 177
5e3a2c38 178 TYPE_CODE_MODULE, /**< Fortran module. */
f55ee35c 179
5e3a2c38 180 /* * Internal function type. */
e81e7f5e
SC
181 TYPE_CODE_INTERNAL_FUNCTION,
182
183 /* * Methods implemented in extension languages. */
184 TYPE_CODE_XMETHOD
c5aa993b 185 };
c906108c 186
5e3a2c38 187/* * Some constants representing each bit field in the main_type. See
876cecd0
TT
188 the bit-field-specific macros, below, for documentation of each
189 constant in this enum. These enum values are only used with
190 init_type. Note that the values are chosen not to conflict with
191 type_instance_flag_value; this lets init_type error-check its
192 input. */
193
194enum type_flag_value
195{
06d66ee9
TT
196 TYPE_FLAG_UNSIGNED = (1 << 8),
197 TYPE_FLAG_NOSIGN = (1 << 9),
198 TYPE_FLAG_STUB = (1 << 10),
199 TYPE_FLAG_TARGET_STUB = (1 << 11),
200 TYPE_FLAG_STATIC = (1 << 12),
201 TYPE_FLAG_PROTOTYPED = (1 << 13),
202 TYPE_FLAG_INCOMPLETE = (1 << 14),
203 TYPE_FLAG_VARARGS = (1 << 15),
204 TYPE_FLAG_VECTOR = (1 << 16),
205 TYPE_FLAG_FIXED_INSTANCE = (1 << 17),
206 TYPE_FLAG_STUB_SUPPORTED = (1 << 18),
207 TYPE_FLAG_GNU_IFUNC = (1 << 19),
876cecd0 208
5e3a2c38 209 /* * Used for error-checking. */
876cecd0
TT
210 TYPE_FLAG_MIN = TYPE_FLAG_UNSIGNED
211};
212
5e3a2c38
SS
213/* * Some bits for the type's instance_flags word. See the macros
214 below for documentation on each bit. Note that if you add a value
215 here, you must update the enum type_flag_value as well. */
216
876cecd0
TT
217enum type_instance_flag_value
218{
219 TYPE_INSTANCE_FLAG_CONST = (1 << 0),
220 TYPE_INSTANCE_FLAG_VOLATILE = (1 << 1),
221 TYPE_INSTANCE_FLAG_CODE_SPACE = (1 << 2),
222 TYPE_INSTANCE_FLAG_DATA_SPACE = (1 << 3),
223 TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1 = (1 << 4),
2844d6b5
KW
224 TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2 = (1 << 5),
225 TYPE_INSTANCE_FLAG_NOTTEXT = (1 << 6),
06d66ee9 226 TYPE_INSTANCE_FLAG_RESTRICT = (1 << 7)
876cecd0 227};
c906108c 228
5e3a2c38
SS
229/* * Unsigned integer type. If this is not set for a TYPE_CODE_INT,
230 the type is signed (unless TYPE_FLAG_NOSIGN (below) is set). */
c906108c 231
876cecd0 232#define TYPE_UNSIGNED(t) (TYPE_MAIN_TYPE (t)->flag_unsigned)
c906108c 233
5e3a2c38
SS
234/* * No sign for this type. In C++, "char", "signed char", and
235 "unsigned char" are distinct types; so we need an extra flag to
236 indicate the absence of a sign! */
c906108c 237
876cecd0 238#define TYPE_NOSIGN(t) (TYPE_MAIN_TYPE (t)->flag_nosign)
c906108c 239
5e3a2c38
SS
240/* * This appears in a type's flags word if it is a stub type (e.g.,
241 if someone referenced a type that wasn't defined in a source file
c906108c
SS
242 via (struct sir_not_appearing_in_this_film *)). */
243
876cecd0 244#define TYPE_STUB(t) (TYPE_MAIN_TYPE (t)->flag_stub)
c906108c 245
5e3a2c38
SS
246/* * The target type of this type is a stub type, and this type needs
247 to be updated if it gets un-stubbed in check_typedef. Used for
248 arrays and ranges, in which TYPE_LENGTH of the array/range gets set
249 based on the TYPE_LENGTH of the target type. Also, set for
250 TYPE_CODE_TYPEDEF. */
c906108c 251
876cecd0 252#define TYPE_TARGET_STUB(t) (TYPE_MAIN_TYPE (t)->flag_target_stub)
c906108c 253
5e3a2c38 254/* * Static type. If this is set, the corresponding type had
0963b4bd
MS
255 a static modifier.
256 Note: This may be unnecessary, since static data members
257 are indicated by other means (bitpos == -1). */
c906108c 258
876cecd0 259#define TYPE_STATIC(t) (TYPE_MAIN_TYPE (t)->flag_static)
c906108c 260
5e3a2c38
SS
261/* * This is a function type which appears to have a prototype. We
262 need this for function calls in order to tell us if it's necessary
263 to coerce the args, or to just do the standard conversions. This
264 is used with a short field. */
c906108c 265
876cecd0 266#define TYPE_PROTOTYPED(t) (TYPE_MAIN_TYPE (t)->flag_prototyped)
c906108c 267
5e3a2c38 268/* * This flag is used to indicate that processing for this type
c906108c 269 is incomplete.
c5aa993b 270
c906108c
SS
271 (Mostly intended for HP platforms, where class methods, for
272 instance, can be encountered before their classes in the debug
273 info; the incomplete type has to be marked so that the class and
0963b4bd 274 the method can be assigned correct types.) */
c906108c 275
876cecd0
TT
276#define TYPE_INCOMPLETE(t) (TYPE_MAIN_TYPE (t)->flag_incomplete)
277
5e3a2c38 278/* * FIXME drow/2002-06-03: Only used for methods, but applies as well
876cecd0
TT
279 to functions. */
280
281#define TYPE_VARARGS(t) (TYPE_MAIN_TYPE (t)->flag_varargs)
282
5e3a2c38 283/* * Identify a vector type. Gcc is handling this by adding an extra
876cecd0
TT
284 attribute to the array type. We slurp that in as a new flag of a
285 type. This is used only in dwarf2read.c. */
286#define TYPE_VECTOR(t) (TYPE_MAIN_TYPE (t)->flag_vector)
287
5e3a2c38
SS
288/* * The debugging formats (especially STABS) do not contain enough
289 information to represent all Ada types---especially those whose
290 size depends on dynamic quantities. Therefore, the GNAT Ada
291 compiler includes extra information in the form of additional type
292 definitions connected by naming conventions. This flag indicates
293 that the type is an ordinary (unencoded) GDB type that has been
294 created from the necessary run-time information, and does not need
295 further interpretation. Optionally marks ordinary, fixed-size GDB
296 type. */
876cecd0
TT
297
298#define TYPE_FIXED_INSTANCE(t) (TYPE_MAIN_TYPE (t)->flag_fixed_instance)
299
5e3a2c38
SS
300/* * This debug target supports TYPE_STUB(t). In the unsupported case
301 we have to rely on NFIELDS to be zero etc., see TYPE_IS_OPAQUE().
302 TYPE_STUB(t) with !TYPE_STUB_SUPPORTED(t) may exist if we only
303 guessed the TYPE_STUB(t) value (see dwarfread.c). */
876cecd0
TT
304
305#define TYPE_STUB_SUPPORTED(t) (TYPE_MAIN_TYPE (t)->flag_stub_supported)
306
5e3a2c38 307/* * Not textual. By default, GDB treats all single byte integers as
876cecd0
TT
308 characters (or elements of strings) unless this flag is set. */
309
2844d6b5 310#define TYPE_NOTTEXT(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_NOTTEXT)
876cecd0 311
5e3a2c38
SS
312/* * Used only for TYPE_CODE_FUNC where it specifies the real function
313 address is returned by this function call. TYPE_TARGET_TYPE
314 determines the final returned function type to be presented to
315 user. */
0875794a
JK
316
317#define TYPE_GNU_IFUNC(t) (TYPE_MAIN_TYPE (t)->flag_gnu_ifunc)
318
5e3a2c38 319/* * Type owner. If TYPE_OBJFILE_OWNED is true, the type is owned by
e9bb382b
UW
320 the objfile retrieved as TYPE_OBJFILE. Otherweise, the type is
321 owned by an architecture; TYPE_OBJFILE is NULL in this case. */
322
323#define TYPE_OBJFILE_OWNED(t) (TYPE_MAIN_TYPE (t)->flag_objfile_owned)
324#define TYPE_OWNER(t) TYPE_MAIN_TYPE(t)->owner
325#define TYPE_OBJFILE(t) (TYPE_OBJFILE_OWNED(t)? TYPE_OWNER(t).objfile : NULL)
326
5e3a2c38 327/* * True if this type was declared using the "class" keyword. This is
3d567982
TT
328 only valid for C++ structure and enum types. If false, a structure
329 was declared as a "struct"; if true it was declared "class". For
330 enum types, this is true when "enum class" or "enum struct" was
331 used to declare the type.. */
0cc2414c
TT
332
333#define TYPE_DECLARED_CLASS(t) (TYPE_MAIN_TYPE (t)->flag_declared_class)
334
5e3a2c38 335/* * True if this type is a "flag" enum. A flag enum is one where all
cafec441
TT
336 the values are pairwise disjoint when "and"ed together. This
337 affects how enum values are printed. */
338
339#define TYPE_FLAG_ENUM(t) (TYPE_MAIN_TYPE (t)->flag_flag_enum)
340
5e3a2c38 341/* * Constant type. If this is set, the corresponding type has a
0963b4bd 342 const modifier. */
876cecd0
TT
343
344#define TYPE_CONST(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CONST)
345
5e3a2c38 346/* * Volatile type. If this is set, the corresponding type has a
0963b4bd 347 volatile modifier. */
876cecd0 348
3e43a32a
MS
349#define TYPE_VOLATILE(t) \
350 (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_VOLATILE)
c906108c 351
5e3a2c38 352/* * Restrict type. If this is set, the corresponding type has a
06d66ee9
TT
353 restrict modifier. */
354
355#define TYPE_RESTRICT(t) \
356 (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_RESTRICT)
357
5e3a2c38 358/* * Instruction-space delimited type. This is for Harvard architectures
47663de5
MS
359 which have separate instruction and data address spaces (and perhaps
360 others).
361
362 GDB usually defines a flat address space that is a superset of the
363 architecture's two (or more) address spaces, but this is an extension
364 of the architecture's model.
365
366 If TYPE_FLAG_INST is set, an object of the corresponding type
367 resides in instruction memory, even if its address (in the extended
368 flat address space) does not reflect this.
369
370 Similarly, if TYPE_FLAG_DATA is set, then an object of the
371 corresponding type resides in the data memory space, even if
372 this is not indicated by its (flat address space) address.
373
374 If neither flag is set, the default space for functions / methods
375 is instruction space, and for data objects is data memory. */
376
876cecd0
TT
377#define TYPE_CODE_SPACE(t) \
378 (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CODE_SPACE)
47663de5 379
876cecd0
TT
380#define TYPE_DATA_SPACE(t) \
381 (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_DATA_SPACE)
f5f8a009 382
5e3a2c38
SS
383/* * Address class flags. Some environments provide for pointers
384 whose size is different from that of a normal pointer or address
385 types where the bits are interpreted differently than normal
386 addresses. The TYPE_FLAG_ADDRESS_CLASS_n flags may be used in
387 target specific ways to represent these different types of address
388 classes. */
389
8b2dbe47 390#define TYPE_ADDRESS_CLASS_1(t) (TYPE_INSTANCE_FLAGS(t) \
876cecd0 391 & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1)
8b2dbe47 392#define TYPE_ADDRESS_CLASS_2(t) (TYPE_INSTANCE_FLAGS(t) \
876cecd0
TT
393 & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2)
394#define TYPE_INSTANCE_FLAG_ADDRESS_CLASS_ALL \
395 (TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1 | TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2)
8b2dbe47 396#define TYPE_ADDRESS_CLASS_ALL(t) (TYPE_INSTANCE_FLAGS(t) \
876cecd0 397 & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_ALL)
d77b6808 398
729efb13
SA
399/* * Used to store a dynamic property. */
400
401struct dynamic_prop
402{
403 /* Determine which field of the union dynamic_prop.data is used. */
404 enum
405 {
406 PROP_UNDEFINED, /* Not defined. */
407 PROP_CONST, /* Constant. */
408 PROP_LOCEXPR, /* Location expression. */
409 PROP_LOCLIST /* Location list. */
410 } kind;
411
412 /* Storage for dynamic or static value. */
413 union data
414 {
415 /* Storage for constant property. */
416
417 LONGEST const_val;
418
419 /* Storage for dynamic property. */
420
421 void *baton;
422 } data;
423};
424
425
5e3a2c38
SS
426/* * Determine which field of the union main_type.fields[x].loc is
427 used. */
d6a843b5
JK
428
429enum field_loc_kind
430 {
5e3a2c38
SS
431 FIELD_LOC_KIND_BITPOS, /**< bitpos */
432 FIELD_LOC_KIND_ENUMVAL, /**< enumval */
433 FIELD_LOC_KIND_PHYSADDR, /**< physaddr */
434 FIELD_LOC_KIND_PHYSNAME, /**< physname */
435 FIELD_LOC_KIND_DWARF_BLOCK /**< dwarf_block */
d6a843b5
JK
436 };
437
5e3a2c38
SS
438/* * A discriminant to determine which field in the
439 main_type.type_specific union is being used, if any.
b4ba55a1
JB
440
441 For types such as TYPE_CODE_FLT or TYPE_CODE_FUNC, the use of this
442 discriminant is really redundant, as we know from the type code
443 which field is going to be used. As such, it would be possible to
444 reduce the size of this enum in order to save a bit or two for
445 other fields of struct main_type. But, since we still have extra
446 room , and for the sake of clarity and consistency, we treat all fields
447 of the union the same way. */
448
449enum type_specific_kind
450{
451 TYPE_SPECIFIC_NONE,
452 TYPE_SPECIFIC_CPLUS_STUFF,
453 TYPE_SPECIFIC_GNAT_STUFF,
454 TYPE_SPECIFIC_FLOATFORMAT,
b6cdc2c1 455 TYPE_SPECIFIC_FUNC
b4ba55a1
JB
456};
457
5e3a2c38
SS
458/* * Main structure representing a type in GDB.
459
460 This structure is space-critical. Its layout has been tweaked to
461 reduce the space used. */
0955bbf0 462
2fdde8f8
DJ
463struct main_type
464{
5e3a2c38 465 /* * Code for kind of type. */
2fdde8f8 466
0955bbf0
MC
467 ENUM_BITFIELD(type_code) code : 8;
468
5e3a2c38 469 /* * Flags about this type. These fields appear at this location
876cecd0
TT
470 because they packs nicely here. See the TYPE_* macros for
471 documentation about these fields. */
472
473 unsigned int flag_unsigned : 1;
474 unsigned int flag_nosign : 1;
475 unsigned int flag_stub : 1;
476 unsigned int flag_target_stub : 1;
477 unsigned int flag_static : 1;
478 unsigned int flag_prototyped : 1;
479 unsigned int flag_incomplete : 1;
480 unsigned int flag_varargs : 1;
481 unsigned int flag_vector : 1;
482 unsigned int flag_stub_supported : 1;
0875794a 483 unsigned int flag_gnu_ifunc : 1;
876cecd0 484 unsigned int flag_fixed_instance : 1;
e9bb382b 485 unsigned int flag_objfile_owned : 1;
5e3a2c38
SS
486
487 /* * True if this type was declared with "class" rather than
0cc2414c 488 "struct". */
5e3a2c38 489
0cc2414c 490 unsigned int flag_declared_class : 1;
876cecd0 491
5e3a2c38
SS
492 /* * True if this is an enum type with disjoint values. This
493 affects how the enum is printed. */
cafec441
TT
494
495 unsigned int flag_flag_enum : 1;
496
5e3a2c38
SS
497 /* * A discriminant telling us which field of the type_specific
498 union is being used for this type, if any. */
499
b4ba55a1
JB
500 ENUM_BITFIELD(type_specific_kind) type_specific_field : 3;
501
5e3a2c38
SS
502 /* * Number of fields described for this type. This field appears
503 at this location because it packs nicely here. */
876cecd0
TT
504
505 short nfields;
506
5e3a2c38 507 /* * Field number of the virtual function table pointer in
876cecd0
TT
508 VPTR_BASETYPE. If -1, we were unable to find the virtual
509 function table pointer in initial symbol reading, and
510 get_vptr_fieldno should be called to find it if possible.
5e3a2c38
SS
511 get_vptr_fieldno will update this field if possible. Otherwise
512 the value is left at -1.
876cecd0
TT
513
514 Unused if this type does not have virtual functions.
515
516 This field appears at this location because it packs nicely here. */
517
518 short vptr_fieldno;
519
5e3a2c38 520 /* * Name of this type, or NULL if none.
2fdde8f8 521
5e3a2c38
SS
522 This is used for printing only, except by poorly designed C++
523 code. For looking up a name, look for a symbol in the
524 VAR_DOMAIN. This is generally allocated in the objfile's
525 obstack. However coffread.c uses malloc. */
2fdde8f8 526
0d5cff50 527 const char *name;
2fdde8f8 528
5e3a2c38 529 /* * Tag name for this type, or NULL if none. This means that the
2fdde8f8
DJ
530 name of the type consists of a keyword followed by the tag name.
531 Which keyword is determined by the type code ("struct" for
5e3a2c38
SS
532 TYPE_CODE_STRUCT, etc.). As far as I know C/C++ are the only
533 languages with this feature.
2fdde8f8
DJ
534
535 This is used for printing only, except by poorly designed C++ code.
176620f1 536 For looking up a name, look for a symbol in the STRUCT_DOMAIN.
2fdde8f8
DJ
537 One more legitimate use is that if TYPE_FLAG_STUB is set, this is
538 the name to use to look for definitions in other files. */
539
0d5cff50 540 const char *tag_name;
2fdde8f8 541
5e3a2c38
SS
542 /* * Every type is now associated with a particular objfile, and the
543 type is allocated on the objfile_obstack for that objfile. One
544 problem however, is that there are times when gdb allocates new
545 types while it is not in the process of reading symbols from a
546 particular objfile. Fortunately, these happen when the type
547 being created is a derived type of an existing type, such as in
548 lookup_pointer_type(). So we can just allocate the new type
549 using the same objfile as the existing type, but to do this we
550 need a backpointer to the objfile from the existing type. Yes
551 this is somewhat ugly, but without major overhaul of the internal
552 type system, it can't be avoided for now. */
2fdde8f8 553
e9bb382b
UW
554 union type_owner
555 {
556 struct objfile *objfile;
557 struct gdbarch *gdbarch;
558 } owner;
2fdde8f8 559
5e3a2c38
SS
560 /* * For a pointer type, describes the type of object pointed to.
561 - For an array type, describes the type of the elements.
562 - For a function or method type, describes the type of the return value.
563 - For a range type, describes the type of the full range.
564 - For a complex type, describes the type of each coordinate.
565 - For a special record or union type encoding a dynamic-sized type
d09ce91e
JB
566 in GNAT, a memoized pointer to a corresponding static version of
567 the type.
5e3a2c38 568 - Unused otherwise. */
2fdde8f8
DJ
569
570 struct type *target_type;
571
5e3a2c38 572 /* * For structure and union types, a description of each field.
2fdde8f8
DJ
573 For set and pascal array types, there is one "field",
574 whose type is the domain type of the set or array.
575 For range types, there are two "fields",
576 the minimum and maximum values (both inclusive).
577 For enum types, each possible value is described by one "field".
ad2f7632 578 For a function or method type, a "field" for each parameter.
2fdde8f8
DJ
579 For C++ classes, there is one field for each base class (if it is
580 a derived class) plus one field for each class data member. Member
581 functions are recorded elsewhere.
582
583 Using a pointer to a separate array of fields
584 allows all types to have the same size, which is useful
585 because we can allocate the space for a type before
586 we know what to put in it. */
587
43bbcdc2 588 union
c5aa993b 589 {
43bbcdc2 590 struct field
2fdde8f8 591 {
43bbcdc2
PH
592 union field_location
593 {
5e3a2c38 594 /* * Position of this field, counting in bits from start of
3e43a32a
MS
595 containing structure. For gdbarch_bits_big_endian=1
596 targets, it is the bit offset to the MSB. For
597 gdbarch_bits_big_endian=0 targets, it is the bit offset to
14e75d8e 598 the LSB. */
43bbcdc2
PH
599
600 int bitpos;
601
5e3a2c38 602 /* * Enum value. */
14e75d8e
JK
603 LONGEST enumval;
604
5e3a2c38
SS
605 /* * For a static field, if TYPE_FIELD_STATIC_HAS_ADDR then
606 physaddr is the location (in the target) of the static
607 field. Otherwise, physname is the mangled label of the
608 static field. */
43bbcdc2
PH
609
610 CORE_ADDR physaddr;
ff355380 611 const char *physname;
8e3b41a9 612
5e3a2c38
SS
613 /* * The field location can be computed by evaluating the
614 following DWARF block. Its DATA is allocated on
615 objfile_obstack - no CU load is needed to access it. */
8e3b41a9
JK
616
617 struct dwarf2_locexpr_baton *dwarf_block;
43bbcdc2
PH
618 }
619 loc;
620
5e3a2c38
SS
621 /* * For a function or member type, this is 1 if the argument is
622 marked artificial. Artificial arguments should not be shown
623 to the user. For TYPE_CODE_RANGE it is set if the specific
624 bound is not defined. */
43bbcdc2
PH
625 unsigned int artificial : 1;
626
5e3a2c38 627 /* * Discriminant for union field_location. */
14e75d8e 628 ENUM_BITFIELD(field_loc_kind) loc_kind : 3;
c906108c 629
5e3a2c38 630 /* * Size of this field, in bits, or zero if not packed.
43bbcdc2
PH
631 If non-zero in an array type, indicates the element size in
632 bits (used only in Ada at the moment).
633 For an unpacked field, the field's type's length
634 says how many bytes the field occupies. */
c906108c 635
14e75d8e 636 unsigned int bitsize : 28;
d6a843b5 637
5e3a2c38
SS
638 /* * In a struct or union type, type of this field.
639 - In a function or member type, type of this argument.
640 - In an array type, the domain-type of the array. */
d6a843b5 641
43bbcdc2 642 struct type *type;
c906108c 643
5e3a2c38 644 /* * Name of field, value or argument.
43bbcdc2
PH
645 NULL for range bounds, array domains, and member function
646 arguments. */
01ad7f36 647
0d5cff50 648 const char *name;
43bbcdc2 649 } *fields;
01ad7f36 650
5e3a2c38 651 /* * Union member used for range types. */
43bbcdc2
PH
652
653 struct range_bounds
654 {
5e3a2c38 655 /* * Low bound of range. */
c906108c 656
729efb13 657 struct dynamic_prop low;
c906108c 658
5e3a2c38 659 /* * High bound of range. */
c906108c 660
729efb13 661 struct dynamic_prop high;
c451ebe5
SA
662
663 /* True if HIGH range bound contains the number of elements in the
664 subrange. This affects how the final hight bound is computed. */
665
666 int flag_upper_bound_is_count : 1;
5ecaaa66
SA
667
668 /* True if LOW or/and HIGH are resolved into a static bound from
669 a dynamic one. */
670
671 int flag_bound_evaluated : 1;
43bbcdc2 672 } *bounds;
c906108c 673
43bbcdc2 674 } flds_bnds;
c906108c 675
5e3a2c38
SS
676 /* * For types with virtual functions (TYPE_CODE_STRUCT),
677 VPTR_BASETYPE is the base class which defined the virtual
678 function table pointer.
c906108c 679
0d5de010
DJ
680 For types that are pointer to member types (TYPE_CODE_METHODPTR,
681 TYPE_CODE_MEMBERPTR), VPTR_BASETYPE is the type that this pointer
682 is a member of.
c906108c 683
2fdde8f8
DJ
684 For method types (TYPE_CODE_METHOD), VPTR_BASETYPE is the aggregate
685 type that contains the method.
c906108c 686
2fdde8f8 687 Unused otherwise. */
c906108c 688
2fdde8f8 689 struct type *vptr_basetype;
c906108c 690
5e3a2c38
SS
691 /* * Slot to point to additional language-specific fields of this
692 type. */
c906108c 693
2fdde8f8
DJ
694 union type_specific
695 {
5e3a2c38
SS
696 /* * CPLUS_STUFF is for TYPE_CODE_STRUCT. It is initialized to
697 point to cplus_struct_default, a default static instance of a
698 struct cplus_struct_type. */
c906108c 699
2fdde8f8 700 struct cplus_struct_type *cplus_stuff;
c906108c 701
5e3a2c38 702 /* * GNAT_STUFF is for types for which the GNAT Ada compiler
b4ba55a1 703 provides additional information. */
5e3a2c38 704
b4ba55a1
JB
705 struct gnat_aux_type *gnat_stuff;
706
5e3a2c38 707 /* * FLOATFORMAT is for TYPE_CODE_FLT. It is a pointer to two
8da61cc4
DJ
708 floatformat objects that describe the floating-point value
709 that resides within the type. The first is for big endian
710 targets and the second is for little endian targets. */
c906108c 711
8da61cc4 712 const struct floatformat **floatformat;
c055b101 713
5e3a2c38
SS
714 /* * For TYPE_CODE_FUNC types, */
715
b6cdc2c1 716 struct func_type *func_stuff;
2fdde8f8 717 } type_specific;
3cdcd0ce
JB
718
719 /* * Contains a location description value for the current type. Evaluating
720 this field yields to the location of the data for an object. */
721
722 struct dynamic_prop *data_location;
2fdde8f8 723};
c906108c 724
5e3a2c38 725/* * A ``struct type'' describes a particular instance of a type, with
2fdde8f8 726 some particular qualification. */
5e3a2c38 727
2fdde8f8
DJ
728struct type
729{
5e3a2c38 730 /* * Type that is a pointer to this type.
2fdde8f8
DJ
731 NULL if no such pointer-to type is known yet.
732 The debugger may add the address of such a type
733 if it has to construct one later. */
c906108c 734
2fdde8f8 735 struct type *pointer_type;
c906108c 736
5e3a2c38 737 /* * C++: also need a reference type. */
c906108c 738
2fdde8f8 739 struct type *reference_type;
c906108c 740
5e3a2c38
SS
741 /* * Variant chain. This points to a type that differs from this
742 one only in qualifiers and length. Currently, the possible
743 qualifiers are const, volatile, code-space, data-space, and
744 address class. The length may differ only when one of the
745 address class flags are set. The variants are linked in a
746 circular ring and share MAIN_TYPE. */
747
2fdde8f8 748 struct type *chain;
c906108c 749
5e3a2c38 750 /* * Flags specific to this instance of the type, indicating where
92163a10
JK
751 on the ring we are.
752
5e3a2c38
SS
753 For TYPE_CODE_TYPEDEF the flags of the typedef type should be
754 binary or-ed with the target type, with a special case for
755 address class and space class. For example if this typedef does
756 not specify any new qualifiers, TYPE_INSTANCE_FLAGS is 0 and the
757 instance flags are completely inherited from the target type. No
758 qualifiers can be cleared by the typedef. See also
759 check_typedef. */
2fdde8f8 760 int instance_flags;
701c159d 761
5e3a2c38
SS
762 /* * Length of storage for a value of this type. This is what
763 sizeof(type) would return; use it for address arithmetic, memory
764 reads and writes, etc. This size includes padding. For example,
765 an i386 extended-precision floating point value really only
766 occupies ten bytes, but most ABI's declare its size to be 12
767 bytes, to preserve alignment. A `struct type' representing such
768 a floating-point type would have a `length' value of 12, even
769 though the last two bytes are unused.
ab5d3da6
KB
770
771 There's a bit of a host/target mess here, if you're concerned
772 about machines whose bytes aren't eight bits long, or who don't
773 have byte-addressed memory. Various places pass this to memcpy
774 and such, meaning it must be in units of host bytes. Various
775 other places expect they can calculate addresses by adding it
776 and such, meaning it must be in units of target bytes. For
777 some DSP targets, in which HOST_CHAR_BIT will (presumably) be 8
778 and TARGET_CHAR_BIT will be (say) 32, this is a problem.
779
780 One fix would be to make this field in bits (requiring that it
781 always be a multiple of HOST_CHAR_BIT and TARGET_CHAR_BIT) ---
782 the other choice would be to make it consistently in units of
783 HOST_CHAR_BIT. However, this would still fail to address
784 machines based on a ternary or decimal representation. */
785
786 unsigned length;
787
5e3a2c38
SS
788 /* * Core type, shared by a group of qualified types. */
789
2fdde8f8
DJ
790 struct main_type *main_type;
791};
c906108c
SS
792
793#define NULL_TYPE ((struct type *) 0)
794
5e3a2c38
SS
795/* * C++ language-specific information for TYPE_CODE_STRUCT and
796 TYPE_CODE_UNION nodes. */
c906108c
SS
797
798struct cplus_struct_type
c5aa993b 799 {
5e3a2c38
SS
800 /* * Number of base classes this type derives from. The
801 baseclasses are stored in the first N_BASECLASSES fields
802 (i.e. the `fields' field of the struct type). I think only the
803 `type' field of such a field has any meaning. */
c906108c 804
c5aa993b 805 short n_baseclasses;
c906108c 806
5e3a2c38
SS
807 /* * Number of methods with unique names. All overloaded methods
808 with the same name count only once. */
c906108c 809
c5aa993b 810 short nfn_fields;
c906108c 811
5e3a2c38
SS
812 /* * Number of template arguments. */
813
34eaf542
TT
814 unsigned short n_template_arguments;
815
5e3a2c38 816 /* * One if this struct is a dynamic class, as defined by the
48ea67a7
TT
817 Itanium C++ ABI: if it requires a virtual table pointer,
818 because it or any of its base classes have one or more virtual
819 member functions or virtual base classes. Minus one if not
820 dynamic. Zero if not yet computed. */
5e3a2c38 821
48ea67a7 822 int is_dynamic : 2;
c5aa993b 823
5e3a2c38
SS
824 /* * Non-zero if this type came from a Java CU. */
825
eb2a6f42
TT
826 unsigned int is_java : 1;
827
5e3a2c38 828 /* * For derived classes, the number of base classes is given by
3e43a32a
MS
829 n_baseclasses and virtual_field_bits is a bit vector containing
830 one bit per base class. If the base class is virtual, the
831 corresponding bit will be set.
c5aa993b 832 I.E, given:
c906108c 833
c5aa993b
JM
834 class A{};
835 class B{};
836 class C : public B, public virtual A {};
c906108c 837
c5aa993b 838 B is a baseclass of C; A is a virtual baseclass for C.
0963b4bd 839 This is a C++ 2.0 language feature. */
c906108c 840
c5aa993b 841 B_TYPE *virtual_field_bits;
c906108c 842
5e3a2c38
SS
843 /* * For classes with private fields, the number of fields is
844 given by nfields and private_field_bits is a bit vector
845 containing one bit per field.
846
0963b4bd 847 If the field is private, the corresponding bit will be set. */
c906108c 848
c5aa993b 849 B_TYPE *private_field_bits;
c906108c 850
5e3a2c38
SS
851 /* * For classes with protected fields, the number of fields is
852 given by nfields and protected_field_bits is a bit vector
853 containing one bit per field.
854
0963b4bd 855 If the field is private, the corresponding bit will be set. */
c906108c 856
c5aa993b 857 B_TYPE *protected_field_bits;
c906108c 858
5e3a2c38
SS
859 /* * For classes with fields to be ignored, either this is
860 optimized out or this field has length 0. */
c906108c 861
c5aa993b 862 B_TYPE *ignore_field_bits;
c906108c 863
5e3a2c38
SS
864 /* * For classes, structures, and unions, a description of each
865 field, which consists of an overloaded name, followed by the
866 types of arguments that the method expects, and then the name
867 after it has been renamed to make it distinct.
c906108c 868
0963b4bd 869 fn_fieldlists points to an array of nfn_fields of these. */
c906108c 870
c5aa993b
JM
871 struct fn_fieldlist
872 {
c906108c 873
5e3a2c38 874 /* * The overloaded name.
0d5cff50
DE
875 This is generally allocated in the objfile's obstack.
876 However stabsread.c sometimes uses malloc. */
c906108c 877
0d5cff50 878 const char *name;
c906108c 879
5e3a2c38 880 /* * The number of methods with this name. */
c906108c 881
c5aa993b 882 int length;
c906108c 883
5e3a2c38 884 /* * The list of methods. */
c906108c 885
c5aa993b
JM
886 struct fn_field
887 {
c906108c 888
5e3a2c38
SS
889 /* * If is_stub is clear, this is the mangled name which
890 we can look up to find the address of the method
891 (FIXME: it would be cleaner to have a pointer to the
892 struct symbol here instead).
c906108c 893
5e3a2c38 894 If is_stub is set, this is the portion of the mangled
c5aa993b
JM
895 name which specifies the arguments. For example, "ii",
896 if there are two int arguments, or "" if there are no
5e3a2c38
SS
897 arguments. See gdb_mangle_name for the conversion from
898 this format to the one used if is_stub is clear. */
c906108c 899
1d06ead6 900 const char *physname;
c906108c 901
5e3a2c38
SS
902 /* * The function type for the method.
903
904 (This comment used to say "The return value of the
905 method", but that's wrong. The function type is
906 expected here, i.e. something with TYPE_CODE_FUNC, and
907 *not* the return-value type). */
c906108c 908
c5aa993b 909 struct type *type;
c906108c 910
5e3a2c38 911 /* * For virtual functions.
0963b4bd 912 First baseclass that defines this virtual function. */
c906108c 913
c5aa993b 914 struct type *fcontext;
c906108c 915
0963b4bd 916 /* Attributes. */
c906108c 917
c5aa993b
JM
918 unsigned int is_const:1;
919 unsigned int is_volatile:1;
920 unsigned int is_private:1;
921 unsigned int is_protected:1;
922 unsigned int is_public:1;
923 unsigned int is_abstract:1;
924 unsigned int is_static:1;
925 unsigned int is_final:1;
926 unsigned int is_synchronized:1;
927 unsigned int is_native:1;
b02dede2 928 unsigned int is_artificial:1;
c906108c 929
5e3a2c38
SS
930 /* * A stub method only has some fields valid (but they
931 are enough to reconstruct the rest of the fields). */
932
c5aa993b 933 unsigned int is_stub:1;
c906108c 934
5e3a2c38 935 /* * True if this function is a constructor, false
7d27a96d 936 otherwise. */
5e3a2c38 937
7d27a96d
TT
938 unsigned int is_constructor : 1;
939
5e3a2c38
SS
940 /* * Unused. */
941
7d27a96d 942 unsigned int dummy:3;
c906108c 943
5e3a2c38 944 /* * Index into that baseclass's virtual function table,
c5aa993b 945 minus 2; else if static: VOFFSET_STATIC; else: 0. */
c906108c 946
c5aa993b 947 unsigned int voffset:16;
c906108c 948
c5aa993b 949#define VOFFSET_STATIC 1
c906108c 950
c5aa993b
JM
951 }
952 *fn_fields;
c906108c 953
c5aa993b
JM
954 }
955 *fn_fieldlists;
c906108c 956
5e3a2c38
SS
957 /* * typedefs defined inside this class. typedef_field points to
958 an array of typedef_field_count elements. */
959
98751a41
JK
960 struct typedef_field
961 {
5e3a2c38
SS
962 /* * Unqualified name to be prefixed by owning class qualified
963 name. */
964
98751a41
JK
965 const char *name;
966
5e3a2c38
SS
967 /* * Type this typedef named NAME represents. */
968
98751a41
JK
969 struct type *type;
970 }
971 *typedef_field;
972 unsigned typedef_field_count;
34eaf542 973
5e3a2c38 974 /* * The template arguments. This is an array with
34eaf542
TT
975 N_TEMPLATE_ARGUMENTS elements. This is NULL for non-template
976 classes. */
5e3a2c38 977
34eaf542 978 struct symbol **template_arguments;
c5aa993b 979 };
c906108c 980
5e3a2c38
SS
981/* * Struct used to store conversion rankings. */
982
6403aeea
SW
983struct rank
984 {
a9d5ef47
SW
985 short rank;
986
5e3a2c38
SS
987 /* * When two conversions are of the same type and therefore have
988 the same rank, subrank is used to differentiate the two.
989
990 Eg: Two derived-class-pointer to base-class-pointer conversions
991 would both have base pointer conversion rank, but the
992 conversion with the shorter distance to the ancestor is
993 preferable. 'subrank' would be used to reflect that. */
994
a9d5ef47 995 short subrank;
6403aeea
SW
996 };
997
5e3a2c38
SS
998/* * Struct used for ranking a function for overload resolution. */
999
c5aa993b
JM
1000struct badness_vector
1001 {
1002 int length;
6403aeea 1003 struct rank *rank;
c5aa993b 1004 };
c906108c 1005
5e3a2c38
SS
1006/* * GNAT Ada-specific information for various Ada types. */
1007
b4ba55a1
JB
1008struct gnat_aux_type
1009 {
5e3a2c38 1010 /* * Parallel type used to encode information about dynamic types
b4ba55a1
JB
1011 used in Ada (such as variant records, variable-size array,
1012 etc). */
1013 struct type* descriptive_type;
1014 };
1015
5e3a2c38
SS
1016/* * For TYPE_CODE_FUNC types. */
1017
b6cdc2c1
JK
1018struct func_type
1019 {
5e3a2c38
SS
1020 /* * The calling convention for targets supporting multiple ABIs.
1021 Right now this is only fetched from the Dwarf-2
743649fd
MW
1022 DW_AT_calling_convention attribute. The value is one of the
1023 DW_CC enum dwarf_calling_convention constants. */
5e3a2c38 1024
743649fd
MW
1025 unsigned calling_convention : 8;
1026
1027 /* * Whether this function normally returns to its caller. It is
1028 set from the DW_AT_noreturn attribute if set on the
1029 DW_TAG_subprogram. */
1030
1031 unsigned int is_noreturn : 1;
bb984ff1 1032
5e3a2c38
SS
1033 /* * Only those DW_TAG_GNU_call_site's in this function that have
1034 DW_AT_GNU_tail_call set are linked in this list. Function
1035 without its tail call list complete
1036 (DW_AT_GNU_all_tail_call_sites or its superset
bb984ff1
JK
1037 DW_AT_GNU_all_call_sites) has TAIL_CALL_LIST NULL, even if some
1038 DW_TAG_GNU_call_site's exist in such function. */
5e3a2c38 1039
bb984ff1 1040 struct call_site *tail_call_list;
b6cdc2c1
JK
1041 };
1042
24c5c679
JK
1043/* struct call_site_parameter can be referenced in callees by several ways. */
1044
1045enum call_site_parameter_kind
1046{
5e3a2c38 1047 /* * Use field call_site_parameter.u.dwarf_reg. */
24c5c679
JK
1048 CALL_SITE_PARAMETER_DWARF_REG,
1049
5e3a2c38 1050 /* * Use field call_site_parameter.u.fb_offset. */
1788b2d3
JK
1051 CALL_SITE_PARAMETER_FB_OFFSET,
1052
5e3a2c38 1053 /* * Use field call_site_parameter.u.param_offset. */
1788b2d3 1054 CALL_SITE_PARAMETER_PARAM_OFFSET
24c5c679
JK
1055};
1056
5e3a2c38
SS
1057/* * A place where a function gets called from, represented by
1058 DW_TAG_GNU_call_site. It can be looked up from
1059 symtab->call_site_htab. */
8e3b41a9
JK
1060
1061struct call_site
1062 {
5e3a2c38
SS
1063 /* * Address of the first instruction after this call. It must be
1064 the first field as we overload core_addr_hash and core_addr_eq
1065 for it. */
1066
8e3b41a9
JK
1067 CORE_ADDR pc;
1068
5e3a2c38
SS
1069 /* * List successor with head in FUNC_TYPE.TAIL_CALL_LIST. */
1070
bb984ff1
JK
1071 struct call_site *tail_call_next;
1072
5e3a2c38 1073 /* * Describe DW_AT_GNU_call_site_target. Missing attribute uses
8e3b41a9 1074 FIELD_LOC_KIND_DWARF_BLOCK with FIELD_DWARF_BLOCK == NULL. */
5e3a2c38 1075
8e3b41a9
JK
1076 struct
1077 {
1078 union field_location loc;
1079
5e3a2c38
SS
1080 /* * Discriminant for union field_location. */
1081
14e75d8e 1082 ENUM_BITFIELD(field_loc_kind) loc_kind : 3;
8e3b41a9
JK
1083 }
1084 target;
1085
5e3a2c38
SS
1086 /* * Size of the PARAMETER array. */
1087
8e3b41a9
JK
1088 unsigned parameter_count;
1089
5e3a2c38
SS
1090 /* * CU of the function where the call is located. It gets used
1091 for DWARF blocks execution in the parameter array below. */
1092
8e3b41a9
JK
1093 struct dwarf2_per_cu_data *per_cu;
1094
5e3a2c38
SS
1095 /* * Describe DW_TAG_GNU_call_site's DW_TAG_formal_parameter. */
1096
8e3b41a9
JK
1097 struct call_site_parameter
1098 {
24c5c679
JK
1099 ENUM_BITFIELD (call_site_parameter_kind) kind : 2;
1100
1101 union call_site_parameter_u
1102 {
5e3a2c38
SS
1103 /* * DW_TAG_formal_parameter's DW_AT_location's DW_OP_regX
1104 as DWARF register number, for register passed
1105 parameters. */
1106
24c5c679
JK
1107 int dwarf_reg;
1108
5e3a2c38
SS
1109 /* * Offset from the callee's frame base, for stack passed
1110 parameters. This equals offset from the caller's stack
1111 pointer. */
1112
24c5c679 1113 CORE_ADDR fb_offset;
1788b2d3 1114
5e3a2c38
SS
1115 /* * Offset relative to the start of this PER_CU to
1116 DW_TAG_formal_parameter which is referenced by both
1117 caller and the callee. */
1118
1788b2d3 1119 cu_offset param_offset;
24c5c679
JK
1120 }
1121 u;
8e3b41a9 1122
5e3a2c38
SS
1123 /* * DW_TAG_formal_parameter's DW_AT_GNU_call_site_value. It
1124 is never NULL. */
1125
8e3b41a9
JK
1126 const gdb_byte *value;
1127 size_t value_size;
1128
5e3a2c38
SS
1129 /* * DW_TAG_formal_parameter's DW_AT_GNU_call_site_data_value.
1130 It may be NULL if not provided by DWARF. */
1131
8e3b41a9
JK
1132 const gdb_byte *data_value;
1133 size_t data_value_size;
1134 }
1135 parameter[1];
1136 };
1137
5e3a2c38
SS
1138/* * The default value of TYPE_CPLUS_SPECIFIC(T) points to this shared
1139 static structure. */
c906108c
SS
1140
1141extern const struct cplus_struct_type cplus_struct_default;
1142
a14ed312 1143extern void allocate_cplus_struct_type (struct type *);
c906108c
SS
1144
1145#define INIT_CPLUS_SPECIFIC(type) \
b4ba55a1 1146 (TYPE_SPECIFIC_FIELD (type) = TYPE_SPECIFIC_CPLUS_STUFF, \
3e43a32a
MS
1147 TYPE_RAW_CPLUS_SPECIFIC (type) = (struct cplus_struct_type*) \
1148 &cplus_struct_default)
b4ba55a1 1149
c906108c 1150#define ALLOCATE_CPLUS_STRUCT_TYPE(type) allocate_cplus_struct_type (type)
b4ba55a1 1151
c906108c 1152#define HAVE_CPLUS_STRUCT(type) \
b4ba55a1
JB
1153 (TYPE_SPECIFIC_FIELD (type) == TYPE_SPECIFIC_CPLUS_STUFF \
1154 && TYPE_RAW_CPLUS_SPECIFIC (type) != &cplus_struct_default)
1155
1156extern const struct gnat_aux_type gnat_aux_default;
1157
1158extern void allocate_gnat_aux_type (struct type *);
1159
1160#define INIT_GNAT_SPECIFIC(type) \
1161 (TYPE_SPECIFIC_FIELD (type) = TYPE_SPECIFIC_GNAT_STUFF, \
1162 TYPE_GNAT_SPECIFIC (type) = (struct gnat_aux_type *) &gnat_aux_default)
1163#define ALLOCATE_GNAT_AUX_TYPE(type) allocate_gnat_aux_type (type)
5e3a2c38 1164/* * A macro that returns non-zero if the type-specific data should be
b4ba55a1
JB
1165 read as "gnat-stuff". */
1166#define HAVE_GNAT_AUX_INFO(type) \
1167 (TYPE_SPECIFIC_FIELD (type) == TYPE_SPECIFIC_GNAT_STUFF)
c906108c 1168
b6cdc2c1
JK
1169#define INIT_FUNC_SPECIFIC(type) \
1170 (TYPE_SPECIFIC_FIELD (type) = TYPE_SPECIFIC_FUNC, \
1171 TYPE_MAIN_TYPE (type)->type_specific.func_stuff \
1172 = TYPE_ZALLOC (type, \
1173 sizeof (*TYPE_MAIN_TYPE (type)->type_specific.func_stuff)))
1174
2fdde8f8
DJ
1175#define TYPE_INSTANCE_FLAGS(thistype) (thistype)->instance_flags
1176#define TYPE_MAIN_TYPE(thistype) (thistype)->main_type
1177#define TYPE_NAME(thistype) TYPE_MAIN_TYPE(thistype)->name
1178#define TYPE_TAG_NAME(type) TYPE_MAIN_TYPE(type)->tag_name
1179#define TYPE_TARGET_TYPE(thistype) TYPE_MAIN_TYPE(thistype)->target_type
c906108c
SS
1180#define TYPE_POINTER_TYPE(thistype) (thistype)->pointer_type
1181#define TYPE_REFERENCE_TYPE(thistype) (thistype)->reference_type
2fdde8f8 1182#define TYPE_CHAIN(thistype) (thistype)->chain
5e3a2c38 1183/* * Note that if thistype is a TYPEDEF type, you have to call check_typedef.
c906108c
SS
1184 But check_typedef does set the TYPE_LENGTH of the TYPEDEF type,
1185 so you only have to call check_typedef once. Since allocate_value
1186 calls check_typedef, TYPE_LENGTH (VALUE_TYPE (X)) is safe. */
ab5d3da6 1187#define TYPE_LENGTH(thistype) (thistype)->length
5e3a2c38 1188/* * Note that TYPE_CODE can be TYPE_CODE_TYPEDEF, so if you want the real
0963b4bd 1189 type, you need to do TYPE_CODE (check_type (this_type)). */
2fdde8f8
DJ
1190#define TYPE_CODE(thistype) TYPE_MAIN_TYPE(thistype)->code
1191#define TYPE_NFIELDS(thistype) TYPE_MAIN_TYPE(thistype)->nfields
43bbcdc2 1192#define TYPE_FIELDS(thistype) TYPE_MAIN_TYPE(thistype)->flds_bnds.fields
c906108c
SS
1193
1194#define TYPE_INDEX_TYPE(type) TYPE_FIELD_TYPE (type, 0)
43bbcdc2 1195#define TYPE_RANGE_DATA(thistype) TYPE_MAIN_TYPE(thistype)->flds_bnds.bounds
729efb13
SA
1196#define TYPE_LOW_BOUND(range_type) \
1197 TYPE_RANGE_DATA(range_type)->low.data.const_val
1198#define TYPE_HIGH_BOUND(range_type) \
1199 TYPE_RANGE_DATA(range_type)->high.data.const_val
43bbcdc2 1200#define TYPE_LOW_BOUND_UNDEFINED(range_type) \
729efb13 1201 (TYPE_RANGE_DATA(range_type)->low.kind == PROP_UNDEFINED)
43bbcdc2 1202#define TYPE_HIGH_BOUND_UNDEFINED(range_type) \
729efb13
SA
1203 (TYPE_RANGE_DATA(range_type)->high.kind == PROP_UNDEFINED)
1204#define TYPE_HIGH_BOUND_KIND(range_type) \
1205 TYPE_RANGE_DATA(range_type)->high.kind
1206#define TYPE_LOW_BOUND_KIND(range_type) \
1207 TYPE_RANGE_DATA(range_type)->low.kind
c906108c 1208
3cdcd0ce
JB
1209/* Attribute accessors for the type data location. */
1210#define TYPE_DATA_LOCATION(thistype) \
1211 TYPE_MAIN_TYPE(thistype)->data_location
1212#define TYPE_DATA_LOCATION_BATON(thistype) \
1213 TYPE_DATA_LOCATION (thistype)->data.baton
1214#define TYPE_DATA_LOCATION_ADDR(thistype) \
1215 TYPE_DATA_LOCATION (thistype)->data.const_val
1216#define TYPE_DATA_LOCATION_KIND(thistype) \
1217 TYPE_DATA_LOCATION (thistype)->kind
1218
0963b4bd 1219/* Moto-specific stuff for FORTRAN arrays. */
c906108c 1220
d78df370 1221#define TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED(arraytype) \
43bbcdc2 1222 TYPE_HIGH_BOUND_UNDEFINED(TYPE_INDEX_TYPE(arraytype))
d78df370 1223#define TYPE_ARRAY_LOWER_BOUND_IS_UNDEFINED(arraytype) \
43bbcdc2 1224 TYPE_LOW_BOUND_UNDEFINED(TYPE_INDEX_TYPE(arraytype))
c906108c
SS
1225
1226#define TYPE_ARRAY_UPPER_BOUND_VALUE(arraytype) \
262452ec 1227 (TYPE_HIGH_BOUND(TYPE_INDEX_TYPE((arraytype))))
c906108c
SS
1228
1229#define TYPE_ARRAY_LOWER_BOUND_VALUE(arraytype) \
262452ec 1230 (TYPE_LOW_BOUND(TYPE_INDEX_TYPE((arraytype))))
c906108c
SS
1231
1232/* C++ */
1233
2fdde8f8
DJ
1234#define TYPE_VPTR_BASETYPE(thistype) TYPE_MAIN_TYPE(thistype)->vptr_basetype
1235#define TYPE_DOMAIN_TYPE(thistype) TYPE_MAIN_TYPE(thistype)->vptr_basetype
1236#define TYPE_VPTR_FIELDNO(thistype) TYPE_MAIN_TYPE(thistype)->vptr_fieldno
c906108c 1237#define TYPE_NFN_FIELDS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->nfn_fields
b4ba55a1
JB
1238#define TYPE_SPECIFIC_FIELD(thistype) \
1239 TYPE_MAIN_TYPE(thistype)->type_specific_field
2fdde8f8 1240#define TYPE_TYPE_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific
b4ba55a1
JB
1241/* We need this tap-dance with the TYPE_RAW_SPECIFIC because of the case
1242 where we're trying to print an Ada array using the C language.
1243 In that case, there is no "cplus_stuff", but the C language assumes
1244 that there is. What we do, in that case, is pretend that there is
1245 an implicit one which is the default cplus stuff. */
1246#define TYPE_CPLUS_SPECIFIC(thistype) \
1247 (!HAVE_CPLUS_STRUCT(thistype) \
1248 ? (struct cplus_struct_type*)&cplus_struct_default \
1249 : TYPE_RAW_CPLUS_SPECIFIC(thistype))
1250#define TYPE_RAW_CPLUS_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.cplus_stuff
2fdde8f8 1251#define TYPE_FLOATFORMAT(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.floatformat
b4ba55a1
JB
1252#define TYPE_GNAT_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.gnat_stuff
1253#define TYPE_DESCRIPTIVE_TYPE(thistype) TYPE_GNAT_SPECIFIC(thistype)->descriptive_type
b6cdc2c1 1254#define TYPE_CALLING_CONVENTION(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.func_stuff->calling_convention
743649fd 1255#define TYPE_NO_RETURN(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.func_stuff->is_noreturn
bb984ff1 1256#define TYPE_TAIL_CALL_LIST(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.func_stuff->tail_call_list
43bbcdc2 1257#define TYPE_BASECLASS(thistype,index) TYPE_FIELD_TYPE(thistype, index)
c906108c 1258#define TYPE_N_BASECLASSES(thistype) TYPE_CPLUS_SPECIFIC(thistype)->n_baseclasses
43bbcdc2 1259#define TYPE_BASECLASS_NAME(thistype,index) TYPE_FIELD_NAME(thistype, index)
c906108c
SS
1260#define TYPE_BASECLASS_BITPOS(thistype,index) TYPE_FIELD_BITPOS(thistype,index)
1261#define BASETYPE_VIA_PUBLIC(thistype, index) \
1262 ((!TYPE_FIELD_PRIVATE(thistype, index)) && (!TYPE_FIELD_PROTECTED(thistype, index)))
d48cc9dd 1263#define TYPE_CPLUS_DYNAMIC(thistype) TYPE_CPLUS_SPECIFIC (thistype)->is_dynamic
eb2a6f42 1264#define TYPE_CPLUS_REALLY_JAVA(thistype) TYPE_CPLUS_SPECIFIC (thistype)->is_java
c906108c
SS
1265
1266#define BASETYPE_VIA_VIRTUAL(thistype, index) \
1267 (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits == NULL ? 0 \
1268 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (index)))
1269
1270#define FIELD_TYPE(thisfld) ((thisfld).type)
1271#define FIELD_NAME(thisfld) ((thisfld).name)
d6a843b5 1272#define FIELD_LOC_KIND(thisfld) ((thisfld).loc_kind)
f41f5e61
PA
1273#define FIELD_BITPOS_LVAL(thisfld) ((thisfld).loc.bitpos)
1274#define FIELD_BITPOS(thisfld) (FIELD_BITPOS_LVAL (thisfld) + 0)
14e75d8e
JK
1275#define FIELD_ENUMVAL_LVAL(thisfld) ((thisfld).loc.enumval)
1276#define FIELD_ENUMVAL(thisfld) (FIELD_ENUMVAL_LVAL (thisfld) + 0)
d6a843b5
JK
1277#define FIELD_STATIC_PHYSNAME(thisfld) ((thisfld).loc.physname)
1278#define FIELD_STATIC_PHYSADDR(thisfld) ((thisfld).loc.physaddr)
8e3b41a9 1279#define FIELD_DWARF_BLOCK(thisfld) ((thisfld).loc.dwarf_block)
d6a843b5
JK
1280#define SET_FIELD_BITPOS(thisfld, bitpos) \
1281 (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_BITPOS, \
f41f5e61 1282 FIELD_BITPOS_LVAL (thisfld) = (bitpos))
14e75d8e
JK
1283#define SET_FIELD_ENUMVAL(thisfld, enumval) \
1284 (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_ENUMVAL, \
1285 FIELD_ENUMVAL_LVAL (thisfld) = (enumval))
d6a843b5
JK
1286#define SET_FIELD_PHYSNAME(thisfld, name) \
1287 (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_PHYSNAME, \
1288 FIELD_STATIC_PHYSNAME (thisfld) = (name))
1289#define SET_FIELD_PHYSADDR(thisfld, addr) \
1290 (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_PHYSADDR, \
1291 FIELD_STATIC_PHYSADDR (thisfld) = (addr))
8e3b41a9
JK
1292#define SET_FIELD_DWARF_BLOCK(thisfld, addr) \
1293 (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_DWARF_BLOCK, \
1294 FIELD_DWARF_BLOCK (thisfld) = (addr))
01ad7f36 1295#define FIELD_ARTIFICIAL(thisfld) ((thisfld).artificial)
c906108c 1296#define FIELD_BITSIZE(thisfld) ((thisfld).bitsize)
d6a843b5 1297
43bbcdc2 1298#define TYPE_FIELD(thistype, n) TYPE_MAIN_TYPE(thistype)->flds_bnds.fields[n]
c906108c
SS
1299#define TYPE_FIELD_TYPE(thistype, n) FIELD_TYPE(TYPE_FIELD(thistype, n))
1300#define TYPE_FIELD_NAME(thistype, n) FIELD_NAME(TYPE_FIELD(thistype, n))
d6a843b5
JK
1301#define TYPE_FIELD_LOC_KIND(thistype, n) FIELD_LOC_KIND (TYPE_FIELD (thistype, n))
1302#define TYPE_FIELD_BITPOS(thistype, n) FIELD_BITPOS (TYPE_FIELD (thistype, n))
14e75d8e 1303#define TYPE_FIELD_ENUMVAL(thistype, n) FIELD_ENUMVAL (TYPE_FIELD (thistype, n))
d6a843b5
JK
1304#define TYPE_FIELD_STATIC_PHYSNAME(thistype, n) FIELD_STATIC_PHYSNAME (TYPE_FIELD (thistype, n))
1305#define TYPE_FIELD_STATIC_PHYSADDR(thistype, n) FIELD_STATIC_PHYSADDR (TYPE_FIELD (thistype, n))
8e3b41a9 1306#define TYPE_FIELD_DWARF_BLOCK(thistype, n) FIELD_DWARF_BLOCK (TYPE_FIELD (thistype, n))
8176bb6d 1307#define TYPE_FIELD_ARTIFICIAL(thistype, n) FIELD_ARTIFICIAL(TYPE_FIELD(thistype,n))
c906108c
SS
1308#define TYPE_FIELD_BITSIZE(thistype, n) FIELD_BITSIZE(TYPE_FIELD(thistype,n))
1309#define TYPE_FIELD_PACKED(thistype, n) (FIELD_BITSIZE(TYPE_FIELD(thistype,n))!=0)
c906108c
SS
1310
1311#define TYPE_FIELD_PRIVATE_BITS(thistype) \
1312 TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits
1313#define TYPE_FIELD_PROTECTED_BITS(thistype) \
1314 TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits
1315#define TYPE_FIELD_IGNORE_BITS(thistype) \
1316 TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits
1317#define TYPE_FIELD_VIRTUAL_BITS(thistype) \
1318 TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits
1319#define SET_TYPE_FIELD_PRIVATE(thistype, n) \
1320 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n))
1321#define SET_TYPE_FIELD_PROTECTED(thistype, n) \
1322 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n))
1323#define SET_TYPE_FIELD_IGNORE(thistype, n) \
1324 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits, (n))
1325#define SET_TYPE_FIELD_VIRTUAL(thistype, n) \
1326 B_SET (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n))
1327#define TYPE_FIELD_PRIVATE(thistype, n) \
1328 (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits == NULL ? 0 \
1329 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n)))
1330#define TYPE_FIELD_PROTECTED(thistype, n) \
1331 (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits == NULL ? 0 \
1332 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n)))
1333#define TYPE_FIELD_IGNORE(thistype, n) \
1334 (TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits == NULL ? 0 \
1335 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits, (n)))
1336#define TYPE_FIELD_VIRTUAL(thistype, n) \
1337 (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits == NULL ? 0 \
1338 : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n)))
1339
c906108c
SS
1340#define TYPE_FN_FIELDLISTS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists
1341#define TYPE_FN_FIELDLIST(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n]
1342#define TYPE_FN_FIELDLIST1(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].fn_fields
1343#define TYPE_FN_FIELDLIST_NAME(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].name
1344#define TYPE_FN_FIELDLIST_LENGTH(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].length
1345
34eaf542
TT
1346#define TYPE_N_TEMPLATE_ARGUMENTS(thistype) \
1347 TYPE_CPLUS_SPECIFIC (thistype)->n_template_arguments
1348#define TYPE_TEMPLATE_ARGUMENTS(thistype) \
1349 TYPE_CPLUS_SPECIFIC (thistype)->template_arguments
1350#define TYPE_TEMPLATE_ARGUMENT(thistype, n) \
1351 TYPE_CPLUS_SPECIFIC (thistype)->template_arguments[n]
1352
c906108c
SS
1353#define TYPE_FN_FIELD(thisfn, n) (thisfn)[n]
1354#define TYPE_FN_FIELD_PHYSNAME(thisfn, n) (thisfn)[n].physname
1355#define TYPE_FN_FIELD_TYPE(thisfn, n) (thisfn)[n].type
ad2f7632 1356#define TYPE_FN_FIELD_ARGS(thisfn, n) TYPE_FIELDS ((thisfn)[n].type)
c906108c
SS
1357#define TYPE_FN_FIELD_CONST(thisfn, n) ((thisfn)[n].is_const)
1358#define TYPE_FN_FIELD_VOLATILE(thisfn, n) ((thisfn)[n].is_volatile)
1359#define TYPE_FN_FIELD_PRIVATE(thisfn, n) ((thisfn)[n].is_private)
1360#define TYPE_FN_FIELD_PROTECTED(thisfn, n) ((thisfn)[n].is_protected)
1361#define TYPE_FN_FIELD_PUBLIC(thisfn, n) ((thisfn)[n].is_public)
1362#define TYPE_FN_FIELD_STATIC(thisfn, n) ((thisfn)[n].is_static)
1363#define TYPE_FN_FIELD_FINAL(thisfn, n) ((thisfn)[n].is_final)
1364#define TYPE_FN_FIELD_SYNCHRONIZED(thisfn, n) ((thisfn)[n].is_synchronized)
1365#define TYPE_FN_FIELD_NATIVE(thisfn, n) ((thisfn)[n].is_native)
b02dede2 1366#define TYPE_FN_FIELD_ARTIFICIAL(thisfn, n) ((thisfn)[n].is_artificial)
c906108c
SS
1367#define TYPE_FN_FIELD_ABSTRACT(thisfn, n) ((thisfn)[n].is_abstract)
1368#define TYPE_FN_FIELD_STUB(thisfn, n) ((thisfn)[n].is_stub)
7d27a96d 1369#define TYPE_FN_FIELD_CONSTRUCTOR(thisfn, n) ((thisfn)[n].is_constructor)
c906108c
SS
1370#define TYPE_FN_FIELD_FCONTEXT(thisfn, n) ((thisfn)[n].fcontext)
1371#define TYPE_FN_FIELD_VOFFSET(thisfn, n) ((thisfn)[n].voffset-2)
1372#define TYPE_FN_FIELD_VIRTUAL_P(thisfn, n) ((thisfn)[n].voffset > 1)
1373#define TYPE_FN_FIELD_STATIC_P(thisfn, n) ((thisfn)[n].voffset == VOFFSET_STATIC)
1374
98751a41
JK
1375#define TYPE_TYPEDEF_FIELD_ARRAY(thistype) \
1376 TYPE_CPLUS_SPECIFIC (thistype)->typedef_field
1377#define TYPE_TYPEDEF_FIELD(thistype, n) \
1378 TYPE_CPLUS_SPECIFIC (thistype)->typedef_field[n]
1379#define TYPE_TYPEDEF_FIELD_NAME(thistype, n) \
1380 TYPE_TYPEDEF_FIELD (thistype, n).name
1381#define TYPE_TYPEDEF_FIELD_TYPE(thistype, n) \
1382 TYPE_TYPEDEF_FIELD (thistype, n).type
1383#define TYPE_TYPEDEF_FIELD_COUNT(thistype) \
1384 TYPE_CPLUS_SPECIFIC (thistype)->typedef_field_count
1385
4e4666e6
DE
1386#define TYPE_IS_OPAQUE(thistype) \
1387 (((TYPE_CODE (thistype) == TYPE_CODE_STRUCT) \
1388 || (TYPE_CODE (thistype) == TYPE_CODE_UNION)) \
1389 && (TYPE_NFIELDS (thistype) == 0) \
1390 && (!HAVE_CPLUS_STRUCT (thistype) \
1391 || TYPE_NFN_FIELDS (thistype) == 0) \
1392 && (TYPE_STUB (thistype) || !TYPE_STUB_SUPPORTED (thistype)))
c5aa993b 1393
5e3a2c38
SS
1394/* * A helper macro that returns the name of a type or "unnamed type"
1395 if the type has no name. */
1396
0a07729b
TT
1397#define TYPE_SAFE_NAME(type) \
1398 (TYPE_NAME (type) ? TYPE_NAME (type) : _("<unnamed type>"))
1399
5e3a2c38
SS
1400/* * A helper macro that returns the name of an error type. If the
1401 type has a name, it is used; otherwise, a default is used. */
1402
b00fdb78
TT
1403#define TYPE_ERROR_NAME(type) \
1404 (TYPE_NAME (type) ? TYPE_NAME (type) : _("<error type>"))
1405
000177f0
AC
1406struct builtin_type
1407{
46bf5051
UW
1408 /* Integral types. */
1409
b021a221 1410 /* Implicit size/sign (based on the architecture's ABI). */
46bf5051
UW
1411 struct type *builtin_void;
1412 struct type *builtin_char;
1413 struct type *builtin_short;
1414 struct type *builtin_int;
1415 struct type *builtin_long;
1416 struct type *builtin_signed_char;
1417 struct type *builtin_unsigned_char;
1418 struct type *builtin_unsigned_short;
1419 struct type *builtin_unsigned_int;
1420 struct type *builtin_unsigned_long;
1421 struct type *builtin_float;
1422 struct type *builtin_double;
1423 struct type *builtin_long_double;
1424 struct type *builtin_complex;
1425 struct type *builtin_double_complex;
1426 struct type *builtin_string;
1427 struct type *builtin_bool;
1428 struct type *builtin_long_long;
1429 struct type *builtin_unsigned_long_long;
1430 struct type *builtin_decfloat;
1431 struct type *builtin_decdouble;
1432 struct type *builtin_declong;
1433
69feb676
UW
1434 /* "True" character types.
1435 We use these for the '/c' print format, because c_char is just a
1436 one-byte integral type, which languages less laid back than C
1437 will print as ... well, a one-byte integral type. */
1438 struct type *builtin_true_char;
1439 struct type *builtin_true_unsigned_char;
1440
df4df182
UW
1441 /* Explicit sizes - see C9X <intypes.h> for naming scheme. The "int0"
1442 is for when an architecture needs to describe a register that has
1443 no size. */
1444 struct type *builtin_int0;
1445 struct type *builtin_int8;
1446 struct type *builtin_uint8;
1447 struct type *builtin_int16;
1448 struct type *builtin_uint16;
1449 struct type *builtin_int32;
1450 struct type *builtin_uint32;
1451 struct type *builtin_int64;
1452 struct type *builtin_uint64;
1453 struct type *builtin_int128;
1454 struct type *builtin_uint128;
1455
9a22f0d0
PM
1456 /* Wide character types. */
1457 struct type *builtin_char16;
1458 struct type *builtin_char32;
46bf5051
UW
1459
1460 /* Pointer types. */
000177f0 1461
5e3a2c38 1462 /* * `pointer to data' type. Some target platforms use an implicitly
000177f0
AC
1463 {sign,zero} -extended 32-bit ABI pointer on a 64-bit ISA. */
1464 struct type *builtin_data_ptr;
1465
5e3a2c38 1466 /* * `pointer to function (returning void)' type. Harvard
000177f0
AC
1467 architectures mean that ABI function and code pointers are not
1468 interconvertible. Similarly, since ANSI, C standards have
1469 explicitly said that pointers to functions and pointers to data
1470 are not interconvertible --- that is, you can't cast a function
1471 pointer to void * and back, and expect to get the same value.
1472 However, all function pointer types are interconvertible, so void
1473 (*) () can server as a generic function pointer. */
5e3a2c38 1474
000177f0 1475 struct type *builtin_func_ptr;
78267919 1476
5e3a2c38 1477 /* * `function returning pointer to function (returning void)' type.
0875794a 1478 The final void return type is not significant for it. */
0875794a 1479
5e3a2c38 1480 struct type *builtin_func_func;
78267919
UW
1481
1482 /* Special-purpose types. */
1483
5e3a2c38
SS
1484 /* * This type is used to represent a GDB internal function. */
1485
78267919 1486 struct type *internal_fn;
e81e7f5e
SC
1487
1488 /* * This type is used to represent an xmethod. */
1489 struct type *xmethod;
46bf5051 1490};
000177f0 1491
5e3a2c38 1492/* * Return the type table for the specified architecture. */
64c50499 1493
5e3a2c38 1494extern const struct builtin_type *builtin_type (struct gdbarch *gdbarch);
64c50499 1495
5e3a2c38 1496/* * Per-objfile types used by symbol readers. */
000177f0 1497
46bf5051
UW
1498struct objfile_type
1499{
1500 /* Basic types based on the objfile architecture. */
000177f0
AC
1501 struct type *builtin_void;
1502 struct type *builtin_char;
1503 struct type *builtin_short;
1504 struct type *builtin_int;
1505 struct type *builtin_long;
46bf5051 1506 struct type *builtin_long_long;
000177f0
AC
1507 struct type *builtin_signed_char;
1508 struct type *builtin_unsigned_char;
1509 struct type *builtin_unsigned_short;
1510 struct type *builtin_unsigned_int;
1511 struct type *builtin_unsigned_long;
46bf5051 1512 struct type *builtin_unsigned_long_long;
000177f0
AC
1513 struct type *builtin_float;
1514 struct type *builtin_double;
1515 struct type *builtin_long_double;
46bf5051 1516
5e3a2c38 1517 /* * This type is used to represent symbol addresses. */
46bf5051
UW
1518 struct type *builtin_core_addr;
1519
5e3a2c38
SS
1520 /* * This type represents a type that was unrecognized in symbol
1521 read-in. */
46bf5051
UW
1522 struct type *builtin_error;
1523
5e3a2c38 1524 /* * Types used for symbols with no debug information. */
46bf5051 1525 struct type *nodebug_text_symbol;
0875794a
JK
1526 struct type *nodebug_text_gnu_ifunc_symbol;
1527 struct type *nodebug_got_plt_symbol;
46bf5051
UW
1528 struct type *nodebug_data_symbol;
1529 struct type *nodebug_unknown_symbol;
1530 struct type *nodebug_tls_symbol;
000177f0 1531};
c5aa993b 1532
5e3a2c38 1533/* * Return the type table for the specified objfile. */
c5aa993b 1534
5e3a2c38 1535extern const struct objfile_type *objfile_type (struct objfile *objfile);
5674de60 1536
598f52df 1537/* Explicit floating-point formats. See "floatformat.h". */
f9e9243a 1538extern const struct floatformat *floatformats_ieee_half[BFD_ENDIAN_UNKNOWN];
8da61cc4
DJ
1539extern const struct floatformat *floatformats_ieee_single[BFD_ENDIAN_UNKNOWN];
1540extern const struct floatformat *floatformats_ieee_double[BFD_ENDIAN_UNKNOWN];
1541extern const struct floatformat *floatformats_ieee_double_littlebyte_bigword[BFD_ENDIAN_UNKNOWN];
1542extern const struct floatformat *floatformats_i387_ext[BFD_ENDIAN_UNKNOWN];
1543extern const struct floatformat *floatformats_m68881_ext[BFD_ENDIAN_UNKNOWN];
1544extern const struct floatformat *floatformats_arm_ext[BFD_ENDIAN_UNKNOWN];
1545extern const struct floatformat *floatformats_ia64_spill[BFD_ENDIAN_UNKNOWN];
1546extern const struct floatformat *floatformats_ia64_quad[BFD_ENDIAN_UNKNOWN];
1547extern const struct floatformat *floatformats_vax_f[BFD_ENDIAN_UNKNOWN];
1548extern const struct floatformat *floatformats_vax_d[BFD_ENDIAN_UNKNOWN];
b14d30e1 1549extern const struct floatformat *floatformats_ibm_long_double[BFD_ENDIAN_UNKNOWN];
8da61cc4 1550
fde6c819 1551
5e3a2c38
SS
1552/* * Allocate space for storing data associated with a particular
1553 type. We ensure that the space is allocated using the same
1554 mechanism that was used to allocate the space for the type
1555 structure itself. I.e. if the type is on an objfile's
1556 objfile_obstack, then the space for data associated with that type
1557 will also be allocated on the objfile_obstack. If the type is not
1558 associated with any particular objfile (such as builtin types),
1559 then the data space will be allocated with xmalloc, the same as for
1560 the type structure. */
c906108c
SS
1561
1562#define TYPE_ALLOC(t,size) \
e9bb382b 1563 (TYPE_OBJFILE_OWNED (t) \
b99607ea 1564 ? obstack_alloc (&TYPE_OBJFILE (t) -> objfile_obstack, size) \
c906108c
SS
1565 : xmalloc (size))
1566
ae5a43e0 1567#define TYPE_ZALLOC(t,size) \
e9bb382b 1568 (TYPE_OBJFILE_OWNED (t) \
ae5a43e0
DJ
1569 ? memset (obstack_alloc (&TYPE_OBJFILE (t)->objfile_obstack, size), \
1570 0, size) \
1571 : xzalloc (size))
1572
5e3a2c38
SS
1573/* Use alloc_type to allocate a type owned by an objfile. Use
1574 alloc_type_arch to allocate a type owned by an architecture. Use
1575 alloc_type_copy to allocate a type with the same owner as a
1576 pre-existing template type, no matter whether objfile or
1577 gdbarch. */
a14ed312 1578extern struct type *alloc_type (struct objfile *);
e9bb382b
UW
1579extern struct type *alloc_type_arch (struct gdbarch *);
1580extern struct type *alloc_type_copy (const struct type *);
c906108c 1581
5e3a2c38
SS
1582/* * Return the type's architecture. For types owned by an
1583 architecture, that architecture is returned. For types owned by an
1584 objfile, that objfile's architecture is returned. */
1585
e9bb382b
UW
1586extern struct gdbarch *get_type_arch (const struct type *);
1587
5e3a2c38 1588/* * This returns the target type (or NULL) of TYPE, also skipping
99ad9427 1589 past typedefs. */
5e3a2c38 1590
99ad9427
YQ
1591extern struct type *get_target_type (struct type *type);
1592
5e3a2c38
SS
1593/* * Helper function to construct objfile-owned types. */
1594
748e18ae 1595extern struct type *init_type (enum type_code, int, int, const char *,
a14ed312 1596 struct objfile *);
c906108c 1597
e9bb382b
UW
1598/* Helper functions to construct architecture-owned types. */
1599extern struct type *arch_type (struct gdbarch *, enum type_code, int, char *);
1600extern struct type *arch_integer_type (struct gdbarch *, int, int, char *);
1601extern struct type *arch_character_type (struct gdbarch *, int, int, char *);
1602extern struct type *arch_boolean_type (struct gdbarch *, int, int, char *);
1603extern struct type *arch_float_type (struct gdbarch *, int, char *,
1604 const struct floatformat **);
1605extern struct type *arch_complex_type (struct gdbarch *, char *,
1606 struct type *);
1607
0e101458 1608/* Helper functions to construct a struct or record type. An
e9bb382b 1609 initially empty type is created using arch_composite_type().
eb90ce83 1610 Fields are then added using append_composite_type_field*(). A union
0e101458
AC
1611 type has its size set to the largest field. A struct type has each
1612 field packed against the previous. */
1613
e9bb382b
UW
1614extern struct type *arch_composite_type (struct gdbarch *gdbarch,
1615 char *name, enum type_code code);
0e101458
AC
1616extern void append_composite_type_field (struct type *t, char *name,
1617 struct type *field);
4aa995e1
PA
1618extern void append_composite_type_field_aligned (struct type *t,
1619 char *name,
1620 struct type *field,
1621 int alignment);
f5dff777
DJ
1622struct field *append_composite_type_field_raw (struct type *t, char *name,
1623 struct type *field);
0e101458 1624
4f2aea11 1625/* Helper functions to construct a bit flags type. An initially empty
e9bb382b 1626 type is created using arch_flag_type(). Flags are then added using
4f2aea11 1627 append_flag_type_flag(). */
e9bb382b
UW
1628extern struct type *arch_flags_type (struct gdbarch *gdbarch,
1629 char *name, int length);
4f2aea11
MK
1630extern void append_flags_type_flag (struct type *type, int bitpos, char *name);
1631
ea37ba09 1632extern void make_vector_type (struct type *array_type);
794ac428
UW
1633extern struct type *init_vector_type (struct type *elt_type, int n);
1634
a14ed312 1635extern struct type *lookup_reference_type (struct type *);
c906108c 1636
a14ed312 1637extern struct type *make_reference_type (struct type *, struct type **);
c906108c 1638
a14ed312 1639extern struct type *make_cv_type (int, int, struct type *, struct type **);
c906108c 1640
06d66ee9
TT
1641extern struct type *make_restrict_type (struct type *);
1642
f1660027
TT
1643extern struct type *make_unqualified_type (struct type *);
1644
dd6bda65
DJ
1645extern void replace_type (struct type *, struct type *);
1646
50810684 1647extern int address_space_name_to_int (struct gdbarch *, char *);
47663de5 1648
50810684 1649extern const char *address_space_int_to_name (struct gdbarch *, int);
47663de5
MS
1650
1651extern struct type *make_type_with_address_space (struct type *type,
1652 int space_identifier);
1653
0d5de010
DJ
1654extern struct type *lookup_memberptr_type (struct type *, struct type *);
1655
1656extern struct type *lookup_methodptr_type (struct type *);
c906108c 1657
0d5de010
DJ
1658extern void smash_to_method_type (struct type *type, struct type *domain,
1659 struct type *to_type, struct field *args,
1660 int nargs, int varargs);
c906108c 1661
0d5de010
DJ
1662extern void smash_to_memberptr_type (struct type *, struct type *,
1663 struct type *);
c906108c 1664
0b92b5bb
TT
1665extern void smash_to_methodptr_type (struct type *, struct type *);
1666
a14ed312 1667extern struct type *allocate_stub_method (struct type *);
c906108c 1668
0d5cff50 1669extern const char *type_name_no_tag (const struct type *);
c906108c 1670
d8228535
JK
1671extern const char *type_name_no_tag_or_error (struct type *type);
1672
d7561cbb 1673extern struct type *lookup_struct_elt_type (struct type *, const char *, int);
c906108c 1674
a14ed312 1675extern struct type *make_pointer_type (struct type *, struct type **);
c906108c 1676
a14ed312 1677extern struct type *lookup_pointer_type (struct type *);
c906108c 1678
0c8b41f1 1679extern struct type *make_function_type (struct type *, struct type **);
c906108c 1680
a14ed312 1681extern struct type *lookup_function_type (struct type *);
c906108c 1682
71918a86
TT
1683extern struct type *lookup_function_type_with_arguments (struct type *,
1684 int,
1685 struct type **);
1686
0c9c3474
SA
1687extern struct type *create_static_range_type (struct type *, struct type *,
1688 LONGEST, LONGEST);
c906108c 1689
729efb13 1690
dc53a7ad
JB
1691extern struct type *create_array_type_with_stride
1692 (struct type *, struct type *, struct type *, unsigned int);
1693
729efb13
SA
1694extern struct type *create_range_type (struct type *, struct type *,
1695 const struct dynamic_prop *,
1696 const struct dynamic_prop *);
1697
a14ed312
KB
1698extern struct type *create_array_type (struct type *, struct type *,
1699 struct type *);
dc53a7ad 1700
63375b74 1701extern struct type *lookup_array_range_type (struct type *, LONGEST, LONGEST);
c906108c 1702
3b7538c0
UW
1703extern struct type *create_string_type (struct type *, struct type *,
1704 struct type *);
63375b74 1705extern struct type *lookup_string_range_type (struct type *, LONGEST, LONGEST);
c906108c 1706
a14ed312 1707extern struct type *create_set_type (struct type *, struct type *);
c906108c 1708
e6c014f2 1709extern struct type *lookup_unsigned_typename (const struct language_defn *,
0d5cff50 1710 struct gdbarch *, const char *);
c906108c 1711
e6c014f2 1712extern struct type *lookup_signed_typename (const struct language_defn *,
0d5cff50 1713 struct gdbarch *, const char *);
c906108c 1714
ed3ef339
DE
1715extern void get_unsigned_type_max (struct type *, ULONGEST *);
1716
1717extern void get_signed_type_minmax (struct type *, LONGEST *, LONGEST *);
1718
80180f79
SA
1719/* * Resolve all dynamic values of a type e.g. array bounds to static values.
1720 ADDR specifies the location of the variable the type is bound to.
1721 If TYPE has no dynamic properties return TYPE; otherwise a new type with
1722 static properties is returned. */
1723extern struct type *resolve_dynamic_type (struct type *type, CORE_ADDR addr);
1724
1725/* * Predicate if the type has dynamic values, which are not resolved yet. */
1726extern int is_dynamic_type (struct type *type);
1727
a14ed312 1728extern struct type *check_typedef (struct type *);
c906108c 1729
78485d59
TT
1730#define CHECK_TYPEDEF(TYPE) \
1731 do { \
1732 (TYPE) = check_typedef (TYPE); \
1733 } while (0)
c906108c 1734
de17c821 1735extern void check_stub_method_group (struct type *, int);
c906108c 1736
a14ed312 1737extern char *gdb_mangle_name (struct type *, int, int);
c906108c 1738
e6c014f2 1739extern struct type *lookup_typename (const struct language_defn *,
ddd49eee 1740 struct gdbarch *, const char *,
34eaf542 1741 const struct block *, int);
c906108c 1742
a14ed312 1743extern struct type *lookup_template_type (char *, struct type *,
270140bd 1744 const struct block *);
c906108c 1745
81fe8080 1746extern int get_vptr_fieldno (struct type *, struct type **);
c906108c 1747
a14ed312 1748extern int get_discrete_bounds (struct type *, LONGEST *, LONGEST *);
c906108c 1749
dbc98a8b
KW
1750extern int get_array_bounds (struct type *type, LONGEST *low_bound,
1751 LONGEST *high_bound);
1752
4e8f195d
TT
1753extern int class_types_same_p (const struct type *, const struct type *);
1754
a14ed312 1755extern int is_ancestor (struct type *, struct type *);
c906108c 1756
4e8f195d
TT
1757extern int is_public_ancestor (struct type *, struct type *);
1758
1759extern int is_unique_ancestor (struct type *, struct value *);
1760
c906108c
SS
1761/* Overload resolution */
1762
1763#define LENGTH_MATCH(bv) ((bv)->rank[0])
1764
5e3a2c38 1765/* * Badness if parameter list length doesn't match arg list length. */
6403aeea
SW
1766extern const struct rank LENGTH_MISMATCH_BADNESS;
1767
5e3a2c38 1768/* * Dummy badness value for nonexistent parameter positions. */
6403aeea 1769extern const struct rank TOO_FEW_PARAMS_BADNESS;
5e3a2c38 1770/* * Badness if no conversion among types. */
6403aeea
SW
1771extern const struct rank INCOMPATIBLE_TYPE_BADNESS;
1772
5e3a2c38 1773/* * Badness of an exact match. */
6403aeea 1774extern const struct rank EXACT_MATCH_BADNESS;
c906108c 1775
5e3a2c38 1776/* * Badness of integral promotion. */
6403aeea 1777extern const struct rank INTEGER_PROMOTION_BADNESS;
5e3a2c38 1778/* * Badness of floating promotion. */
6403aeea 1779extern const struct rank FLOAT_PROMOTION_BADNESS;
5e3a2c38 1780/* * Badness of converting a derived class pointer
7062b0a0 1781 to a base class pointer. */
6403aeea 1782extern const struct rank BASE_PTR_CONVERSION_BADNESS;
5e3a2c38 1783/* * Badness of integral conversion. */
6403aeea 1784extern const struct rank INTEGER_CONVERSION_BADNESS;
5e3a2c38 1785/* * Badness of floating conversion. */
6403aeea 1786extern const struct rank FLOAT_CONVERSION_BADNESS;
5e3a2c38 1787/* * Badness of integer<->floating conversions. */
6403aeea 1788extern const struct rank INT_FLOAT_CONVERSION_BADNESS;
5e3a2c38 1789/* * Badness of conversion of pointer to void pointer. */
6403aeea 1790extern const struct rank VOID_PTR_CONVERSION_BADNESS;
5e3a2c38 1791/* * Badness of conversion to boolean. */
5b4f6e25 1792extern const struct rank BOOL_CONVERSION_BADNESS;
5e3a2c38 1793/* * Badness of converting derived to base class. */
6403aeea 1794extern const struct rank BASE_CONVERSION_BADNESS;
5e3a2c38 1795/* * Badness of converting from non-reference to reference. */
6403aeea 1796extern const struct rank REFERENCE_CONVERSION_BADNESS;
5e3a2c38 1797/* * Badness of converting integer 0 to NULL pointer. */
da096638 1798extern const struct rank NULL_POINTER_CONVERSION;
7b83ea04 1799
c906108c 1800/* Non-standard conversions allowed by the debugger */
5e3a2c38
SS
1801
1802/* * Converting a pointer to an int is usually OK. */
6403aeea
SW
1803extern const struct rank NS_POINTER_CONVERSION_BADNESS;
1804
5e3a2c38 1805/* * Badness of converting a (non-zero) integer constant
a451cb65
KS
1806 to a pointer. */
1807extern const struct rank NS_INTEGER_POINTER_CONVERSION_BADNESS;
c906108c 1808
6403aeea
SW
1809extern struct rank sum_ranks (struct rank a, struct rank b);
1810extern int compare_ranks (struct rank a, struct rank b);
c906108c 1811
a14ed312 1812extern int compare_badness (struct badness_vector *, struct badness_vector *);
c906108c 1813
a14ed312 1814extern struct badness_vector *rank_function (struct type **, int,
da096638 1815 struct value **, int);
c906108c 1816
da096638
KS
1817extern struct rank rank_one_type (struct type *, struct type *,
1818 struct value *);
c906108c 1819
a14ed312 1820extern void recursive_dump_type (struct type *, int);
c906108c 1821
d6a843b5
JK
1822extern int field_is_static (struct field *);
1823
c906108c
SS
1824/* printcmd.c */
1825
79a45b7d
TT
1826extern void print_scalar_formatted (const void *, struct type *,
1827 const struct value_print_options *,
1828 int, struct ui_file *);
c906108c 1829
a14ed312 1830extern int can_dereference (struct type *);
c906108c 1831
a14ed312 1832extern int is_integral_type (struct type *);
adf40b2e 1833
e09342b5
TJB
1834extern int is_scalar_type_recursive (struct type *);
1835
6c659fc2
SC
1836extern int class_or_union_p (const struct type *);
1837
a14ed312 1838extern void maintenance_print_type (char *, int);
c906108c 1839
ae5a43e0
DJ
1840extern htab_t create_copied_types_hash (struct objfile *objfile);
1841
1842extern struct type *copy_type_recursive (struct objfile *objfile,
1843 struct type *type,
1844 htab_t copied_types);
1845
4af88198
JB
1846extern struct type *copy_type (const struct type *type);
1847
bd69fc68
TT
1848extern int types_equal (struct type *, struct type *);
1849
ca092b61
DE
1850extern int types_deeply_equal (struct type *, struct type *);
1851
c5aa993b 1852#endif /* GDBTYPES_H */