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