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