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