gdb/gdbtypes.h

   1 /* Internal type definitions for GDB.
   2
   3    Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
   4    2002, 2003, 2004, 2006, 2007, 2008, 2009 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 #include "hashtab.h"
  27
  28 /* Forward declarations for prototypes.  */
  29 struct field;
  30 struct block;
  31 struct value_print_options;
  32
  33 /* Some macros for char-based bitfields.  */
  34
  35 #define B_SET(a,x)      ((a)[(x)>>3] |= (1 << ((x)&7)))
  36 #define B_CLR(a,x)      ((a)[(x)>>3] &= ~(1 << ((x)&7)))
  37 #define B_TST(a,x)      ((a)[(x)>>3] & (1 << ((x)&7)))
  38 #define B_TYPE          unsigned char
  39 #define B_BYTES(x)      ( 1 + ((x)>>3) )
  40 #define B_CLRALL(a,x)   memset ((a), 0, B_BYTES(x))
  41
  42 /* Different kinds of data types are distinguished by the `code' field.  */
  43
  44 enum type_code
  45   {
  46     TYPE_CODE_UNDEF,            /* Not used; catches errors */
  47     TYPE_CODE_PTR,              /* Pointer type */
  48
  49     /* Array type with lower & upper bounds.
  50
  51        Regardless of the language, GDB represents multidimensional
  52        array types the way C does: as arrays of arrays.  So an
  53        instance of a GDB array type T can always be seen as a series
  54        of instances of TYPE_TARGET_TYPE (T) laid out sequentially in
  55        memory.
  56
  57        Row-major languages like C lay out multi-dimensional arrays so
  58        that incrementing the rightmost index in a subscripting
  59        expression results in the smallest change in the address of the
  60        element referred to.  Column-major languages like Fortran lay
  61        them out so that incrementing the leftmost index results in the
  62        smallest change.
  63
  64        This means that, in column-major languages, working our way
  65        from type to target type corresponds to working through indices
  66        from right to left, not left to right.  */
  67     TYPE_CODE_ARRAY,
  68
  69     TYPE_CODE_STRUCT,           /* C struct or Pascal record */
  70     TYPE_CODE_UNION,            /* C union or Pascal variant part */
  71     TYPE_CODE_ENUM,             /* Enumeration type */
  72     TYPE_CODE_FLAGS,            /* Bit flags type */
  73     TYPE_CODE_FUNC,             /* Function type */
  74     TYPE_CODE_INT,              /* Integer type */
  75
  76     /* Floating type.  This is *NOT* a complex type.  Beware, there are parts
  77        of GDB which bogusly assume that TYPE_CODE_FLT can mean complex.  */
  78     TYPE_CODE_FLT,
  79
  80     /* Void type.  The length field specifies the length (probably always
  81        one) which is used in pointer arithmetic involving pointers to
  82        this type, but actually dereferencing such a pointer is invalid;
  83        a void type has no length and no actual representation in memory
  84        or registers.  A pointer to a void type is a generic pointer.  */
  85     TYPE_CODE_VOID,
  86
  87     TYPE_CODE_SET,              /* Pascal sets */
  88     TYPE_CODE_RANGE,            /* Range (integers within spec'd bounds) */
  89
  90     /* A string type which is like an array of character but prints
  91        differently (at least for (the deleted) CHILL).  It does not
  92        contain a length field as Pascal strings (for many Pascals,
  93        anyway) do; if we want to deal with such strings, we should use
  94        a new type code.  */
  95     TYPE_CODE_STRING,
  96
  97     /* String of bits; like TYPE_CODE_SET but prints differently (at
  98        least for (the deleted) CHILL).  */
  99     TYPE_CODE_BITSTRING,
 100
 101     /* Unknown type.  The length field is valid if we were able to
 102        deduce that much about the type, or 0 if we don't even know that.  */
 103     TYPE_CODE_ERROR,
 104
 105     /* C++ */
 106     TYPE_CODE_METHOD,           /* Method type */
 107
 108     /* Pointer-to-member-function type.  This describes how to access a
 109        particular member function of a class (possibly a virtual
 110        member function).  The representation may vary between different
 111        C++ ABIs.  */
 112     TYPE_CODE_METHODPTR,
 113
 114     /* Pointer-to-member type.  This is the offset within a class to some
 115        particular data member.  The only currently supported representation
 116        uses an unbiased offset, with -1 representing NULL; this is used
 117        by the Itanium C++ ABI (used by GCC on all platforms).  */
 118     TYPE_CODE_MEMBERPTR,
 119
 120     TYPE_CODE_REF,              /* C++ Reference types */
 121
 122     TYPE_CODE_CHAR,             /* *real* character type */
 123
 124     /* Boolean type.  0 is false, 1 is true, and other values are non-boolean
 125        (e.g. FORTRAN "logical" used as unsigned int).  */
 126     TYPE_CODE_BOOL,
 127
 128     /* Fortran */
 129     TYPE_CODE_COMPLEX,          /* Complex float */
 130
 131     TYPE_CODE_TYPEDEF,
 132     TYPE_CODE_TEMPLATE,         /* C++ template */
 133     TYPE_CODE_TEMPLATE_ARG,     /* C++ template arg */
 134
 135     TYPE_CODE_NAMESPACE,        /* C++ namespace.  */
 136
 137     TYPE_CODE_DECFLOAT,         /* Decimal floating point.  */
 138
 139     /* Internal function type.  */
 140     TYPE_CODE_INTERNAL_FUNCTION
 141   };
 142
 143 /* For now allow source to use TYPE_CODE_CLASS for C++ classes, as an
 144    alias for TYPE_CODE_STRUCT.  This is for DWARF, which has a distinct
 145    "class" attribute.  Perhaps we should actually have a separate TYPE_CODE
 146    so that we can print "class" or "struct" depending on what the debug
 147    info said.  It's not clear we should bother.  */
 148
 149 #define TYPE_CODE_CLASS TYPE_CODE_STRUCT
 150
 151 /* Some constants representing each bit field in the main_type.  See
 152    the bit-field-specific macros, below, for documentation of each
 153    constant in this enum.  These enum values are only used with
 154    init_type.  Note that the values are chosen not to conflict with
 155    type_instance_flag_value; this lets init_type error-check its
 156    input.  */
 157
 158 enum type_flag_value
 159 {
 160   TYPE_FLAG_UNSIGNED = (1 << 6),
 161   TYPE_FLAG_NOSIGN = (1 << 7),
 162   TYPE_FLAG_STUB = (1 << 8),
 163   TYPE_FLAG_TARGET_STUB = (1 << 9),
 164   TYPE_FLAG_STATIC = (1 << 10),
 165   TYPE_FLAG_PROTOTYPED = (1 << 11),
 166   TYPE_FLAG_INCOMPLETE = (1 << 12),
 167   TYPE_FLAG_VARARGS = (1 << 13),
 168   TYPE_FLAG_VECTOR = (1 << 14),
 169   TYPE_FLAG_FIXED_INSTANCE = (1 << 15),
 170   TYPE_FLAG_STUB_SUPPORTED = (1 << 16),
 171   TYPE_FLAG_NOTTEXT = (1 << 17),
 172
 173   /* Used for error-checking.  */
 174   TYPE_FLAG_MIN = TYPE_FLAG_UNSIGNED
 175 };
 176
 177 /* Some bits for the type's instance_flags word.  See the macros below
 178    for documentation on each bit.  Note that if you add a value here,
 179    you must update the enum type_flag_value as well.  */
 180 enum type_instance_flag_value
 181 {
 182   TYPE_INSTANCE_FLAG_CONST = (1 << 0),
 183   TYPE_INSTANCE_FLAG_VOLATILE = (1 << 1),
 184   TYPE_INSTANCE_FLAG_CODE_SPACE = (1 << 2),
 185   TYPE_INSTANCE_FLAG_DATA_SPACE = (1 << 3),
 186   TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1 = (1 << 4),
 187   TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2 = (1 << 5)
 188 };
 189
 190 /* Unsigned integer type.  If this is not set for a TYPE_CODE_INT, the
 191    type is signed (unless TYPE_FLAG_NOSIGN (below) is set). */
 192
 193 #define TYPE_UNSIGNED(t)        (TYPE_MAIN_TYPE (t)->flag_unsigned)
 194
 195 /* No sign for this type.  In C++, "char", "signed char", and "unsigned
 196    char" are distinct types; so we need an extra flag to indicate the
 197    absence of a sign! */
 198
 199 #define TYPE_NOSIGN(t)          (TYPE_MAIN_TYPE (t)->flag_nosign)
 200
 201 /* This appears in a type's flags word if it is a stub type (e.g., if
 202    someone referenced a type that wasn't defined in a source file
 203    via (struct sir_not_appearing_in_this_film *)).  */
 204
 205 #define TYPE_STUB(t)            (TYPE_MAIN_TYPE (t)->flag_stub)
 206
 207 /* The target type of this type is a stub type, and this type needs to
 208    be updated if it gets un-stubbed in check_typedef.
 209    Used for arrays and ranges, in which TYPE_LENGTH of the array/range
 210    gets set based on the TYPE_LENGTH of the target type.
 211    Also, set for TYPE_CODE_TYPEDEF. */
 212
 213 #define TYPE_TARGET_STUB(t)     (TYPE_MAIN_TYPE (t)->flag_target_stub)
 214
 215 /* Static type.  If this is set, the corresponding type had
 216  * a static modifier.
 217  * Note: This may be unnecessary, since static data members
 218  * are indicated by other means (bitpos == -1)
 219  */
 220
 221 #define TYPE_STATIC(t)          (TYPE_MAIN_TYPE (t)->flag_static)
 222
 223 /* This is a function type which appears to have a prototype.  We need this
 224    for function calls in order to tell us if it's necessary to coerce the args,
 225    or to just do the standard conversions.  This is used with a short field. */
 226
 227 #define TYPE_PROTOTYPED(t)      (TYPE_MAIN_TYPE (t)->flag_prototyped)
 228
 229 /* This flag is used to indicate that processing for this type
 230    is incomplete.
 231
 232    (Mostly intended for HP platforms, where class methods, for
 233    instance, can be encountered before their classes in the debug
 234    info; the incomplete type has to be marked so that the class and
 235    the method can be assigned correct types.) */
 236
 237 #define TYPE_INCOMPLETE(t)      (TYPE_MAIN_TYPE (t)->flag_incomplete)
 238
 239 /* FIXME drow/2002-06-03:  Only used for methods, but applies as well
 240    to functions.  */
 241
 242 #define TYPE_VARARGS(t)         (TYPE_MAIN_TYPE (t)->flag_varargs)
 243
 244 /* Identify a vector type.  Gcc is handling this by adding an extra
 245    attribute to the array type.  We slurp that in as a new flag of a
 246    type.  This is used only in dwarf2read.c.  */
 247 #define TYPE_VECTOR(t)          (TYPE_MAIN_TYPE (t)->flag_vector)
 248
 249 /* The debugging formats (especially STABS) do not contain enough information
 250    to represent all Ada types---especially those whose size depends on
 251    dynamic quantities.  Therefore, the GNAT Ada compiler includes
 252    extra information in the form of additional type definitions
 253    connected by naming conventions.  This flag indicates that the
 254    type is an ordinary (unencoded) GDB type that has been created from
 255    the necessary run-time information, and does not need further
 256    interpretation. Optionally marks ordinary, fixed-size GDB type. */
 257
 258 #define TYPE_FIXED_INSTANCE(t) (TYPE_MAIN_TYPE (t)->flag_fixed_instance)
 259
 260 /* This debug target supports TYPE_STUB(t).  In the unsupported case we have to
 261    rely on NFIELDS to be zero etc., see TYPE_IS_OPAQUE ().
 262    TYPE_STUB(t) with !TYPE_STUB_SUPPORTED(t) may exist if we only guessed
 263    the TYPE_STUB(t) value (see dwarfread.c).  */
 264
 265 #define TYPE_STUB_SUPPORTED(t)   (TYPE_MAIN_TYPE (t)->flag_stub_supported)
 266
 267 /* Not textual.  By default, GDB treats all single byte integers as
 268    characters (or elements of strings) unless this flag is set.  */
 269
 270 #define TYPE_NOTTEXT(t)         (TYPE_MAIN_TYPE (t)->flag_nottext)
 271
 272 /* Constant type.  If this is set, the corresponding type has a
 273  * const modifier.
 274  */
 275
 276 #define TYPE_CONST(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CONST)
 277
 278 /* Volatile type.  If this is set, the corresponding type has a
 279  * volatile modifier.
 280  */
 281
 282 #define TYPE_VOLATILE(t) (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_VOLATILE)
 283
 284 /* Instruction-space delimited type.  This is for Harvard architectures
 285    which have separate instruction and data address spaces (and perhaps
 286    others).
 287
 288    GDB usually defines a flat address space that is a superset of the
 289    architecture's two (or more) address spaces, but this is an extension
 290    of the architecture's model.
 291
 292    If TYPE_FLAG_INST is set, an object of the corresponding type
 293    resides in instruction memory, even if its address (in the extended
 294    flat address space) does not reflect this.
 295
 296    Similarly, if TYPE_FLAG_DATA is set, then an object of the
 297    corresponding type resides in the data memory space, even if
 298    this is not indicated by its (flat address space) address.
 299
 300    If neither flag is set, the default space for functions / methods
 301    is instruction space, and for data objects is data memory.  */
 302
 303 #define TYPE_CODE_SPACE(t) \
 304   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_CODE_SPACE)
 305
 306 #define TYPE_DATA_SPACE(t) \
 307   (TYPE_INSTANCE_FLAGS (t) & TYPE_INSTANCE_FLAG_DATA_SPACE)
 308
 309 /* Address class flags.  Some environments provide for pointers whose
 310    size is different from that of a normal pointer or address types
 311    where the bits are interpreted differently than normal addresses.  The
 312    TYPE_FLAG_ADDRESS_CLASS_n flags may be used in target specific
 313    ways to represent these different types of address classes.  */
 314 #define TYPE_ADDRESS_CLASS_1(t) (TYPE_INSTANCE_FLAGS(t) \
 315                                  & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1)
 316 #define TYPE_ADDRESS_CLASS_2(t) (TYPE_INSTANCE_FLAGS(t) \
 317                                  & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2)
 318 #define TYPE_INSTANCE_FLAG_ADDRESS_CLASS_ALL \
 319   (TYPE_INSTANCE_FLAG_ADDRESS_CLASS_1 | TYPE_INSTANCE_FLAG_ADDRESS_CLASS_2)
 320 #define TYPE_ADDRESS_CLASS_ALL(t) (TYPE_INSTANCE_FLAGS(t) \
 321                                    & TYPE_INSTANCE_FLAG_ADDRESS_CLASS_ALL)
 322
 323 /* Determine which field of the union main_type.fields[x].loc is used.  */
 324
 325 enum field_loc_kind
 326   {
 327     FIELD_LOC_KIND_BITPOS,      /* bitpos */
 328     FIELD_LOC_KIND_PHYSADDR,    /* physaddr */
 329     FIELD_LOC_KIND_PHYSNAME,    /* physname */
 330     FIELD_LOC_KIND_DWARF_BLOCK  /* dwarf_block */
 331   };
 332
 333 /* This structure is space-critical.
 334    Its layout has been tweaked to reduce the space used.  */
 335
 336 struct main_type
 337 {
 338   /* Code for kind of type */
 339
 340   ENUM_BITFIELD(type_code) code : 8;
 341
 342   /* Flags about this type.  These fields appear at this location
 343      because they packs nicely here.  See the TYPE_* macros for
 344      documentation about these fields.  */
 345
 346   unsigned int flag_unsigned : 1;
 347   unsigned int flag_nosign : 1;
 348   unsigned int flag_stub : 1;
 349   unsigned int flag_target_stub : 1;
 350   unsigned int flag_static : 1;
 351   unsigned int flag_prototyped : 1;
 352   unsigned int flag_incomplete : 1;
 353   unsigned int flag_varargs : 1;
 354   unsigned int flag_vector : 1;
 355   unsigned int flag_stub_supported : 1;
 356   unsigned int flag_nottext : 1;
 357   unsigned int flag_fixed_instance : 1;
 358
 359   /* Number of fields described for this type.  This field appears at
 360      this location because it packs nicely here.  */
 361
 362   short nfields;
 363
 364   /* Field number of the virtual function table pointer in
 365      VPTR_BASETYPE.  If -1, we were unable to find the virtual
 366      function table pointer in initial symbol reading, and
 367      get_vptr_fieldno should be called to find it if possible.
 368      get_vptr_fieldno will update this field if possible.
 369      Otherwise the value is left at -1.
 370
 371      Unused if this type does not have virtual functions.
 372
 373      This field appears at this location because it packs nicely here.  */
 374
 375   short vptr_fieldno;
 376
 377   /* Name of this type, or NULL if none.
 378
 379      This is used for printing only, except by poorly designed C++ code.
 380      For looking up a name, look for a symbol in the VAR_DOMAIN.  */
 381
 382   char *name;
 383
 384   /* Tag name for this type, or NULL if none.  This means that the
 385      name of the type consists of a keyword followed by the tag name.
 386      Which keyword is determined by the type code ("struct" for
 387      TYPE_CODE_STRUCT, etc.).  As far as I know C/C++ are the only languages
 388      with this feature.
 389
 390      This is used for printing only, except by poorly designed C++ code.
 391      For looking up a name, look for a symbol in the STRUCT_DOMAIN.
 392      One more legitimate use is that if TYPE_FLAG_STUB is set, this is
 393      the name to use to look for definitions in other files.  */
 394
 395   char *tag_name;
 396
 397   /* Every type is now associated with a particular objfile, and the
 398      type is allocated on the objfile_obstack for that objfile.  One problem
 399      however, is that there are times when gdb allocates new types while
 400      it is not in the process of reading symbols from a particular objfile.
 401      Fortunately, these happen when the type being created is a derived
 402      type of an existing type, such as in lookup_pointer_type().  So
 403      we can just allocate the new type using the same objfile as the
 404      existing type, but to do this we need a backpointer to the objfile
 405      from the existing type.  Yes this is somewhat ugly, but without
 406      major overhaul of the internal type system, it can't be avoided
 407      for now. */
 408
 409   struct objfile *objfile;
 410
 411   /* For a pointer type, describes the type of object pointed to.
 412      For an array type, describes the type of the elements.
 413      For a function or method type, describes the type of the return value.
 414      For a range type, describes the type of the full range.
 415      For a complex type, describes the type of each coordinate.
 416      Unused otherwise.  */
 417
 418   struct type *target_type;
 419
 420   /* For structure and union types, a description of each field.
 421      For set and pascal array types, there is one "field",
 422      whose type is the domain type of the set or array.
 423      For range types, there are two "fields",
 424      the minimum and maximum values (both inclusive).
 425      For enum types, each possible value is described by one "field".
 426      For a function or method type, a "field" for each parameter.
 427      For C++ classes, there is one field for each base class (if it is
 428      a derived class) plus one field for each class data member.  Member
 429      functions are recorded elsewhere.
 430
 431      Using a pointer to a separate array of fields
 432      allows all types to have the same size, which is useful
 433      because we can allocate the space for a type before
 434      we know what to put in it.  */
 435
 436   struct field
 437   {
 438     union field_location
 439     {
 440       /* Position of this field, counting in bits from start of
 441          containing structure.
 442          For gdbarch_bits_big_endian=1 targets, it is the bit offset to the MSB.
 443          For gdbarch_bits_big_endian=0 targets, it is the bit offset to the LSB.
 444          For a range bound or enum value, this is the value itself. */
 445
 446       int bitpos;
 447
 448       /* For a static field, if TYPE_FIELD_STATIC_HAS_ADDR then physaddr
 449          is the location (in the target) of the static field.
 450          Otherwise, physname is the mangled label of the static field. */
 451
 452       CORE_ADDR physaddr;
 453       char *physname;
 454
 455       /* The field location can be computed by evaluating the following DWARF
 456          block.  This can be used in Fortran variable-length arrays, for
 457          instance.  */
 458
 459       struct dwarf2_locexpr_baton *dwarf_block;
 460     }
 461     loc;
 462
 463     /* For a function or member type, this is 1 if the argument is marked
 464        artificial.  Artificial arguments should not be shown to the
 465        user.  For TYPE_CODE_RANGE it is set if the specific bound is not
 466        defined.  */
 467     unsigned int artificial : 1;
 468
 469     /* Discriminant for union field_location.  */
 470     ENUM_BITFIELD(field_loc_kind) loc_kind : 2;
 471
 472     /* Size of this field, in bits, or zero if not packed.
 473        For an unpacked field, the field's type's length
 474        says how many bytes the field occupies.  */
 475
 476     unsigned int bitsize : 29;
 477
 478     /* In a struct or union type, type of this field.
 479        In a function or member type, type of this argument.
 480        In an array type, the domain-type of the array.  */
 481
 482     struct type *type;
 483
 484     /* Name of field, value or argument.
 485        NULL for range bounds, array domains, and member function
 486        arguments.  */
 487
 488     char *name;
 489
 490   } *fields;
 491
 492   /* For types with virtual functions (TYPE_CODE_STRUCT), VPTR_BASETYPE
 493      is the base class which defined the virtual function table pointer.
 494
 495      For types that are pointer to member types (TYPE_CODE_METHODPTR,
 496      TYPE_CODE_MEMBERPTR), VPTR_BASETYPE is the type that this pointer
 497      is a member of.
 498
 499      For method types (TYPE_CODE_METHOD), VPTR_BASETYPE is the aggregate
 500      type that contains the method.
 501
 502      Unused otherwise.  */
 503
 504   struct type *vptr_basetype;
 505
 506   /* Slot to point to additional language-specific fields of this type.  */
 507
 508   union type_specific
 509   {
 510     /* CPLUS_STUFF is for TYPE_CODE_STRUCT.  It is initialized to point to
 511        cplus_struct_default, a default static instance of a struct
 512        cplus_struct_type. */
 513
 514     struct cplus_struct_type *cplus_stuff;
 515
 516     /* FLOATFORMAT is for TYPE_CODE_FLT.  It is a pointer to two
 517        floatformat objects that describe the floating-point value
 518        that resides within the type.  The first is for big endian
 519        targets and the second is for little endian targets.  */
 520
 521     const struct floatformat **floatformat;
 522
 523     /* For TYPE_CODE_FUNC types, the calling convention for targets
 524        supporting multiple ABIs.  Right now this is only fetched from
 525        the Dwarf-2 DW_AT_calling_convention attribute.  */
 526     unsigned calling_convention;
 527   } type_specific;
 528 };
 529
 530 /* A ``struct type'' describes a particular instance of a type, with
 531    some particular qualification.  */
 532 struct type
 533 {
 534   /* Type that is a pointer to this type.
 535      NULL if no such pointer-to type is known yet.
 536      The debugger may add the address of such a type
 537      if it has to construct one later.  */
 538
 539   struct type *pointer_type;
 540
 541   /* C++: also need a reference type.  */
 542
 543   struct type *reference_type;
 544
 545   /* Variant chain.  This points to a type that differs from this one only
 546      in qualifiers and length.  Currently, the possible qualifiers are
 547      const, volatile, code-space, data-space, and address class.  The
 548      length may differ only when one of the address class flags are set.
 549      The variants are linked in a circular ring and share MAIN_TYPE.  */
 550   struct type *chain;
 551
 552   /* Flags specific to this instance of the type, indicating where
 553      on the ring we are.  */
 554   int instance_flags;
 555
 556   /* Length of storage for a value of this type.  This is what
 557      sizeof(type) would return; use it for address arithmetic,
 558      memory reads and writes, etc.  This size includes padding.  For
 559      example, an i386 extended-precision floating point value really
 560      only occupies ten bytes, but most ABI's declare its size to be
 561      12 bytes, to preserve alignment.  A `struct type' representing
 562      such a floating-point type would have a `length' value of 12,
 563      even though the last two bytes are unused.
 564
 565      There's a bit of a host/target mess here, if you're concerned
 566      about machines whose bytes aren't eight bits long, or who don't
 567      have byte-addressed memory.  Various places pass this to memcpy
 568      and such, meaning it must be in units of host bytes.  Various
 569      other places expect they can calculate addresses by adding it
 570      and such, meaning it must be in units of target bytes.  For
 571      some DSP targets, in which HOST_CHAR_BIT will (presumably) be 8
 572      and TARGET_CHAR_BIT will be (say) 32, this is a problem.
 573
 574      One fix would be to make this field in bits (requiring that it
 575      always be a multiple of HOST_CHAR_BIT and TARGET_CHAR_BIT) ---
 576      the other choice would be to make it consistently in units of
 577      HOST_CHAR_BIT.  However, this would still fail to address
 578      machines based on a ternary or decimal representation.  */
 579
 580   unsigned length;
 581
 582   /* Core type, shared by a group of qualified types.  */
 583   struct main_type *main_type;
 584 };
 585
 586 #define NULL_TYPE ((struct type *) 0)
 587
 588 /* C++ language-specific information for TYPE_CODE_STRUCT and TYPE_CODE_UNION
 589    nodes.  */
 590
 591 struct cplus_struct_type
 592   {
 593     /* Number of base classes this type derives from.  The baseclasses are
 594        stored in the first N_BASECLASSES fields (i.e. the `fields' field of
 595        the struct type).  I think only the `type' field of such a field has
 596        any meaning.  */
 597
 598     short n_baseclasses;
 599
 600     /* Number of methods with unique names.  All overloaded methods with
 601        the same name count only once. */
 602
 603     short nfn_fields;
 604
 605     /* Number of methods described for this type, not including the
 606        methods that it derives from.  */
 607
 608     short nfn_fields_total;
 609
 610     /* The "declared_type" field contains a code saying how the
 611        user really declared this type, e.g., "class s", "union s",
 612        "struct s".
 613        The 3 above things come out from the C++ compiler looking like classes,
 614        but we keep track of the real declaration so we can give
 615        the correct information on "ptype". (Note: TEMPLATE may not
 616        belong in this list...)  */
 617
 618 #define DECLARED_TYPE_CLASS 0
 619 #define DECLARED_TYPE_UNION 1
 620 #define DECLARED_TYPE_STRUCT 2
 621 #define DECLARED_TYPE_TEMPLATE 3
 622     short declared_type;        /* One of the above codes */
 623
 624     /* For derived classes, the number of base classes is given by n_baseclasses
 625        and virtual_field_bits is a bit vector containing one bit per base class.
 626        If the base class is virtual, the corresponding bit will be set.
 627        I.E, given:
 628
 629        class A{};
 630        class B{};
 631        class C : public B, public virtual A {};
 632
 633        B is a baseclass of C; A is a virtual baseclass for C.
 634        This is a C++ 2.0 language feature. */
 635
 636     B_TYPE *virtual_field_bits;
 637
 638     /* For classes with private fields, the number of fields is given by
 639        nfields and private_field_bits is a bit vector containing one bit
 640        per field.
 641        If the field is private, the corresponding bit will be set. */
 642
 643     B_TYPE *private_field_bits;
 644
 645     /* For classes with protected fields, the number of fields is given by
 646        nfields and protected_field_bits is a bit vector containing one bit
 647        per field.
 648        If the field is private, the corresponding bit will be set. */
 649
 650     B_TYPE *protected_field_bits;
 651
 652     /* for classes with fields to be ignored, either this is optimized out
 653        or this field has length 0 */
 654
 655     B_TYPE *ignore_field_bits;
 656
 657     /* For classes, structures, and unions, a description of each field,
 658        which consists of an overloaded name, followed by the types of
 659        arguments that the method expects, and then the name after it
 660        has been renamed to make it distinct.
 661
 662        fn_fieldlists points to an array of nfn_fields of these. */
 663
 664     struct fn_fieldlist
 665       {
 666
 667         /* The overloaded name.  */
 668
 669         char *name;
 670
 671         /* The number of methods with this name.  */
 672
 673         int length;
 674
 675         /* The list of methods.  */
 676
 677         struct fn_field
 678           {
 679
 680             /* If is_stub is clear, this is the mangled name which we can
 681                look up to find the address of the method (FIXME: it would
 682                be cleaner to have a pointer to the struct symbol here
 683                instead).  */
 684
 685             /* If is_stub is set, this is the portion of the mangled
 686                name which specifies the arguments.  For example, "ii",
 687                if there are two int arguments, or "" if there are no
 688                arguments.  See gdb_mangle_name for the conversion from this
 689                format to the one used if is_stub is clear.  */
 690
 691             char *physname;
 692
 693             /* The function type for the method.
 694                (This comment used to say "The return value of the method",
 695                but that's wrong. The function type
 696                is expected here, i.e. something with TYPE_CODE_FUNC,
 697                and *not* the return-value type). */
 698
 699             struct type *type;
 700
 701             /* For virtual functions.
 702                First baseclass that defines this virtual function.   */
 703
 704             struct type *fcontext;
 705
 706             /* Attributes. */
 707
 708             unsigned int is_const:1;
 709             unsigned int is_volatile:1;
 710             unsigned int is_private:1;
 711             unsigned int is_protected:1;
 712             unsigned int is_public:1;
 713             unsigned int is_abstract:1;
 714             unsigned int is_static:1;
 715             unsigned int is_final:1;
 716             unsigned int is_synchronized:1;
 717             unsigned int is_native:1;
 718             unsigned int is_artificial:1;
 719
 720             /* A stub method only has some fields valid (but they are enough
 721                to reconstruct the rest of the fields).  */
 722             unsigned int is_stub:1;
 723
 724             /* Unused.  */
 725             unsigned int dummy:4;
 726
 727             /* Index into that baseclass's virtual function table,
 728                minus 2; else if static: VOFFSET_STATIC; else: 0.  */
 729
 730             unsigned int voffset:16;
 731
 732 #define VOFFSET_STATIC 1
 733
 734           }
 735          *fn_fields;
 736
 737       }
 738      *fn_fieldlists;
 739
 740     /* If this "struct type" describes a template, then it
 741      * has arguments. "template_args" points to an array of
 742      * template arg descriptors, of length "ntemplate_args".
 743      * The only real information in each of these template arg descriptors
 744      * is a name. "type" will typically just point to a "struct type" with
 745      * the placeholder TYPE_CODE_TEMPLATE_ARG type.
 746      */
 747     short ntemplate_args;
 748     struct template_arg
 749       {
 750         char *name;
 751         struct type *type;
 752       }
 753      *template_args;
 754
 755     /* Pointer to information about enclosing scope, if this is a
 756      * local type.  If it is not a local type, this is NULL
 757      */
 758     struct local_type_info
 759       {
 760         char *file;
 761         int line;
 762       }
 763      *localtype_ptr;
 764   };
 765
 766 /* Struct used in computing virtual base list */
 767 struct vbase
 768   {
 769     struct type *vbasetype;     /* pointer to virtual base */
 770     struct vbase *next;         /* next in chain */
 771   };
 772
 773 /* Struct used for ranking a function for overload resolution */
 774 struct badness_vector
 775   {
 776     int length;
 777     int *rank;
 778   };
 779
 780 /* The default value of TYPE_CPLUS_SPECIFIC(T) points to the
 781    this shared static structure. */
 782
 783 extern const struct cplus_struct_type cplus_struct_default;
 784
 785 extern void allocate_cplus_struct_type (struct type *);
 786
 787 #define INIT_CPLUS_SPECIFIC(type) \
 788   (TYPE_CPLUS_SPECIFIC(type)=(struct cplus_struct_type*)&cplus_struct_default)
 789 #define ALLOCATE_CPLUS_STRUCT_TYPE(type) allocate_cplus_struct_type (type)
 790 #define HAVE_CPLUS_STRUCT(type) \
 791   (TYPE_CPLUS_SPECIFIC(type) != &cplus_struct_default)
 792
 793 #define TYPE_INSTANCE_FLAGS(thistype) (thistype)->instance_flags
 794 #define TYPE_MAIN_TYPE(thistype) (thistype)->main_type
 795 #define TYPE_NAME(thistype) TYPE_MAIN_TYPE(thistype)->name
 796 #define TYPE_TAG_NAME(type) TYPE_MAIN_TYPE(type)->tag_name
 797 #define TYPE_TARGET_TYPE(thistype) TYPE_MAIN_TYPE(thistype)->target_type
 798 #define TYPE_POINTER_TYPE(thistype) (thistype)->pointer_type
 799 #define TYPE_REFERENCE_TYPE(thistype) (thistype)->reference_type
 800 #define TYPE_CHAIN(thistype) (thistype)->chain
 801 /* Note that if thistype is a TYPEDEF type, you have to call check_typedef.
 802    But check_typedef does set the TYPE_LENGTH of the TYPEDEF type,
 803    so you only have to call check_typedef once.  Since allocate_value
 804    calls check_typedef, TYPE_LENGTH (VALUE_TYPE (X)) is safe.  */
 805 #define TYPE_LENGTH(thistype) (thistype)->length
 806 #define TYPE_OBJFILE(thistype) TYPE_MAIN_TYPE(thistype)->objfile
 807 /* Note that TYPE_CODE can be TYPE_CODE_TYPEDEF, so if you want the real
 808    type, you need to do TYPE_CODE (check_type (this_type)). */
 809 #define TYPE_CODE(thistype) TYPE_MAIN_TYPE(thistype)->code
 810 #define TYPE_NFIELDS(thistype) TYPE_MAIN_TYPE(thistype)->nfields
 811 #define TYPE_FIELDS(thistype) TYPE_MAIN_TYPE(thistype)->fields
 812 #define TYPE_TEMPLATE_ARGS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->template_args
 813
 814 #define TYPE_INDEX_TYPE(type) TYPE_FIELD_TYPE (type, 0)
 815 #define TYPE_LOW_BOUND(range_type) TYPE_FIELD_BITPOS (range_type, 0)
 816 #define TYPE_HIGH_BOUND(range_type) TYPE_FIELD_BITPOS (range_type, 1)
 817
 818 /* Moto-specific stuff for FORTRAN arrays */
 819
 820 #define TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED(arraytype) \
 821    (TYPE_FIELD_ARTIFICIAL(TYPE_INDEX_TYPE((arraytype)),1))
 822 #define TYPE_ARRAY_LOWER_BOUND_IS_UNDEFINED(arraytype) \
 823    (TYPE_FIELD_ARTIFICIAL(TYPE_INDEX_TYPE((arraytype)),0))
 824
 825 #define TYPE_ARRAY_UPPER_BOUND_VALUE(arraytype) \
 826    (TYPE_HIGH_BOUND(TYPE_INDEX_TYPE((arraytype))))
 827
 828 #define TYPE_ARRAY_LOWER_BOUND_VALUE(arraytype) \
 829    (TYPE_LOW_BOUND(TYPE_INDEX_TYPE((arraytype))))
 830
 831 /* C++ */
 832
 833 #define TYPE_VPTR_BASETYPE(thistype) TYPE_MAIN_TYPE(thistype)->vptr_basetype
 834 #define TYPE_DOMAIN_TYPE(thistype) TYPE_MAIN_TYPE(thistype)->vptr_basetype
 835 #define TYPE_VPTR_FIELDNO(thistype) TYPE_MAIN_TYPE(thistype)->vptr_fieldno
 836 #define TYPE_FN_FIELDS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->fn_fields
 837 #define TYPE_NFN_FIELDS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->nfn_fields
 838 #define TYPE_NFN_FIELDS_TOTAL(thistype) TYPE_CPLUS_SPECIFIC(thistype)->nfn_fields_total
 839 #define TYPE_NTEMPLATE_ARGS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->ntemplate_args
 840 #define TYPE_DECLARED_TYPE(thistype) TYPE_CPLUS_SPECIFIC(thistype)->declared_type
 841 #define TYPE_TYPE_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific
 842 #define TYPE_CPLUS_SPECIFIC(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.cplus_stuff
 843 #define TYPE_FLOATFORMAT(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.floatformat
 844 #define TYPE_CALLING_CONVENTION(thistype) TYPE_MAIN_TYPE(thistype)->type_specific.calling_convention
 845 #define TYPE_BASECLASS(thistype,index) TYPE_MAIN_TYPE(thistype)->fields[index].type
 846 #define TYPE_N_BASECLASSES(thistype) TYPE_CPLUS_SPECIFIC(thistype)->n_baseclasses
 847 #define TYPE_BASECLASS_NAME(thistype,index) TYPE_MAIN_TYPE(thistype)->fields[index].name
 848 #define TYPE_BASECLASS_BITPOS(thistype,index) TYPE_FIELD_BITPOS(thistype,index)
 849 #define BASETYPE_VIA_PUBLIC(thistype, index) \
 850   ((!TYPE_FIELD_PRIVATE(thistype, index)) && (!TYPE_FIELD_PROTECTED(thistype, index)))
 851
 852 #define BASETYPE_VIA_VIRTUAL(thistype, index) \
 853   (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits == NULL ? 0 \
 854     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (index)))
 855
 856 #define FIELD_TYPE(thisfld) ((thisfld).type)
 857 #define FIELD_NAME(thisfld) ((thisfld).name)
 858 #define FIELD_LOC_KIND(thisfld) ((thisfld).loc_kind)
 859 #define FIELD_BITPOS(thisfld) ((thisfld).loc.bitpos)
 860 #define FIELD_STATIC_PHYSNAME(thisfld) ((thisfld).loc.physname)
 861 #define FIELD_STATIC_PHYSADDR(thisfld) ((thisfld).loc.physaddr)
 862 #define FIELD_DWARF_BLOCK(thisfld) ((thisfld).loc.dwarf_block)
 863 #define SET_FIELD_BITPOS(thisfld, bitpos)                       \
 864   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_BITPOS,            \
 865    FIELD_BITPOS (thisfld) = (bitpos))
 866 #define SET_FIELD_PHYSNAME(thisfld, name)                       \
 867   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_PHYSNAME,          \
 868    FIELD_STATIC_PHYSNAME (thisfld) = (name))
 869 #define SET_FIELD_PHYSADDR(thisfld, addr)                       \
 870   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_PHYSADDR,          \
 871    FIELD_STATIC_PHYSADDR (thisfld) = (addr))
 872 #define SET_FIELD_DWARF_BLOCK(thisfld, addr)                    \
 873   (FIELD_LOC_KIND (thisfld) = FIELD_LOC_KIND_DWARF_BLOCK,       \
 874    FIELD_DWARF_BLOCK (thisfld) = (addr))
 875 #define FIELD_ARTIFICIAL(thisfld) ((thisfld).artificial)
 876 #define FIELD_BITSIZE(thisfld) ((thisfld).bitsize)
 877
 878 #define TYPE_FIELD(thistype, n) TYPE_MAIN_TYPE(thistype)->fields[n]
 879 #define TYPE_FIELD_TYPE(thistype, n) FIELD_TYPE(TYPE_FIELD(thistype, n))
 880 #define TYPE_FIELD_NAME(thistype, n) FIELD_NAME(TYPE_FIELD(thistype, n))
 881 #define TYPE_FIELD_LOC_KIND(thistype, n) FIELD_LOC_KIND (TYPE_FIELD (thistype, n))
 882 #define TYPE_FIELD_BITPOS(thistype, n) FIELD_BITPOS (TYPE_FIELD (thistype, n))
 883 #define TYPE_FIELD_STATIC_PHYSNAME(thistype, n) FIELD_STATIC_PHYSNAME (TYPE_FIELD (thistype, n))
 884 #define TYPE_FIELD_STATIC_PHYSADDR(thistype, n) FIELD_STATIC_PHYSADDR (TYPE_FIELD (thistype, n))
 885 #define TYPE_FIELD_DWARF_BLOCK(thistype, n) FIELD_DWARF_BLOCK (TYPE_FIELD (thistype, n))
 886 #define TYPE_FIELD_ARTIFICIAL(thistype, n) FIELD_ARTIFICIAL(TYPE_FIELD(thistype,n))
 887 #define TYPE_FIELD_BITSIZE(thistype, n) FIELD_BITSIZE(TYPE_FIELD(thistype,n))
 888 #define TYPE_FIELD_PACKED(thistype, n) (FIELD_BITSIZE(TYPE_FIELD(thistype,n))!=0)
 889 #define TYPE_TEMPLATE_ARG(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->template_args[n]
 890
 891 #define TYPE_FIELD_PRIVATE_BITS(thistype) \
 892   TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits
 893 #define TYPE_FIELD_PROTECTED_BITS(thistype) \
 894   TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits
 895 #define TYPE_FIELD_IGNORE_BITS(thistype) \
 896   TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits
 897 #define TYPE_FIELD_VIRTUAL_BITS(thistype) \
 898   TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits
 899 #define SET_TYPE_FIELD_PRIVATE(thistype, n) \
 900   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n))
 901 #define SET_TYPE_FIELD_PROTECTED(thistype, n) \
 902   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n))
 903 #define SET_TYPE_FIELD_IGNORE(thistype, n) \
 904   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits, (n))
 905 #define SET_TYPE_FIELD_VIRTUAL(thistype, n) \
 906   B_SET (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n))
 907 #define TYPE_FIELD_PRIVATE(thistype, n) \
 908   (TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits == NULL ? 0 \
 909     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->private_field_bits, (n)))
 910 #define TYPE_FIELD_PROTECTED(thistype, n) \
 911   (TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits == NULL ? 0 \
 912     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->protected_field_bits, (n)))
 913 #define TYPE_FIELD_IGNORE(thistype, n) \
 914   (TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits == NULL ? 0 \
 915     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->ignore_field_bits, (n)))
 916 #define TYPE_FIELD_VIRTUAL(thistype, n) \
 917   (TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits == NULL ? 0 \
 918     : B_TST(TYPE_CPLUS_SPECIFIC(thistype)->virtual_field_bits, (n)))
 919
 920 #define TYPE_FN_FIELDLISTS(thistype) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists
 921 #define TYPE_FN_FIELDLIST(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n]
 922 #define TYPE_FN_FIELDLIST1(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].fn_fields
 923 #define TYPE_FN_FIELDLIST_NAME(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].name
 924 #define TYPE_FN_FIELDLIST_LENGTH(thistype, n) TYPE_CPLUS_SPECIFIC(thistype)->fn_fieldlists[n].length
 925
 926 #define TYPE_FN_FIELD(thisfn, n) (thisfn)[n]
 927 #define TYPE_FN_FIELD_PHYSNAME(thisfn, n) (thisfn)[n].physname
 928 #define TYPE_FN_FIELD_TYPE(thisfn, n) (thisfn)[n].type
 929 #define TYPE_FN_FIELD_ARGS(thisfn, n) TYPE_FIELDS ((thisfn)[n].type)
 930 #define TYPE_FN_FIELD_CONST(thisfn, n) ((thisfn)[n].is_const)
 931 #define TYPE_FN_FIELD_VOLATILE(thisfn, n) ((thisfn)[n].is_volatile)
 932 #define TYPE_FN_FIELD_PRIVATE(thisfn, n) ((thisfn)[n].is_private)
 933 #define TYPE_FN_FIELD_PROTECTED(thisfn, n) ((thisfn)[n].is_protected)
 934 #define TYPE_FN_FIELD_PUBLIC(thisfn, n) ((thisfn)[n].is_public)
 935 #define TYPE_FN_FIELD_STATIC(thisfn, n) ((thisfn)[n].is_static)
 936 #define TYPE_FN_FIELD_FINAL(thisfn, n) ((thisfn)[n].is_final)
 937 #define TYPE_FN_FIELD_SYNCHRONIZED(thisfn, n) ((thisfn)[n].is_synchronized)
 938 #define TYPE_FN_FIELD_NATIVE(thisfn, n) ((thisfn)[n].is_native)
 939 #define TYPE_FN_FIELD_ARTIFICIAL(thisfn, n) ((thisfn)[n].is_artificial)
 940 #define TYPE_FN_FIELD_ABSTRACT(thisfn, n) ((thisfn)[n].is_abstract)
 941 #define TYPE_FN_FIELD_STUB(thisfn, n) ((thisfn)[n].is_stub)
 942 #define TYPE_FN_FIELD_FCONTEXT(thisfn, n) ((thisfn)[n].fcontext)
 943 #define TYPE_FN_FIELD_VOFFSET(thisfn, n) ((thisfn)[n].voffset-2)
 944 #define TYPE_FN_FIELD_VIRTUAL_P(thisfn, n) ((thisfn)[n].voffset > 1)
 945 #define TYPE_FN_FIELD_STATIC_P(thisfn, n) ((thisfn)[n].voffset == VOFFSET_STATIC)
 946
 947 #define TYPE_LOCALTYPE_PTR(thistype) (TYPE_CPLUS_SPECIFIC(thistype)->localtype_ptr)
 948 #define TYPE_LOCALTYPE_FILE(thistype) (TYPE_CPLUS_SPECIFIC(thistype)->localtype_ptr->file)
 949 #define TYPE_LOCALTYPE_LINE(thistype) (TYPE_CPLUS_SPECIFIC(thistype)->localtype_ptr->line)
 950
 951 #define TYPE_IS_OPAQUE(thistype) (((TYPE_CODE (thistype) == TYPE_CODE_STRUCT) ||        \
 952                                    (TYPE_CODE (thistype) == TYPE_CODE_UNION))        && \
 953                                   (TYPE_NFIELDS (thistype) == 0)                     && \
 954                                   (TYPE_CPLUS_SPECIFIC (thistype) && (TYPE_NFN_FIELDS (thistype) == 0)) && \
 955                                   (TYPE_STUB (thistype) || !TYPE_STUB_SUPPORTED (thistype)))
 956
 957 struct builtin_type
 958 {
 959   /* Address/pointer types.  */
 960
 961   /* `pointer to data' type.  Some target platforms use an implicitly
 962      {sign,zero} -extended 32-bit ABI pointer on a 64-bit ISA.  */
 963   struct type *builtin_data_ptr;
 964
 965   /* `pointer to function (returning void)' type.  Harvard
 966      architectures mean that ABI function and code pointers are not
 967      interconvertible.  Similarly, since ANSI, C standards have
 968      explicitly said that pointers to functions and pointers to data
 969      are not interconvertible --- that is, you can't cast a function
 970      pointer to void * and back, and expect to get the same value.
 971      However, all function pointer types are interconvertible, so void
 972      (*) () can server as a generic function pointer.  */
 973   struct type *builtin_func_ptr;
 974
 975   /* The target CPU's address type.  This is the ISA address size.  */
 976   struct type *builtin_core_addr;
 977
 978
 979   /* Types used for symbols with no debug information.  */
 980   struct type *nodebug_text_symbol;
 981   struct type *nodebug_data_symbol;
 982   struct type *nodebug_unknown_symbol;
 983   struct type *nodebug_tls_symbol;
 984
 985
 986   /* Integral types.  */
 987
 988   /* Implicit size/sign (based on the the architecture's ABI).  */
 989   struct type *builtin_void;
 990   struct type *builtin_char;
 991   struct type *builtin_short;
 992   struct type *builtin_int;
 993   struct type *builtin_long;
 994   struct type *builtin_signed_char;
 995   struct type *builtin_unsigned_char;
 996   struct type *builtin_unsigned_short;
 997   struct type *builtin_unsigned_int;
 998   struct type *builtin_unsigned_long;
 999   struct type *builtin_float;
1000   struct type *builtin_double;
1001   struct type *builtin_long_double;
1002   struct type *builtin_complex;
1003   struct type *builtin_double_complex;
1004   struct type *builtin_string;
1005   struct type *builtin_bool;
1006   struct type *builtin_long_long;
1007   struct type *builtin_unsigned_long_long;
1008   struct type *builtin_decfloat;
1009   struct type *builtin_decdouble;
1010   struct type *builtin_declong;
1011 };
1012
1013 /* Return the type table for the specified architecture.  */
1014 extern const struct builtin_type *builtin_type (struct gdbarch *gdbarch);
1015
1016
1017 /* Explicit sizes - see C9X <intypes.h> for naming scheme.  The "int0"
1018    is for when an architecture needs to describe a register that has
1019    no size.  */
1020 extern struct type *builtin_type_int0;
1021 extern struct type *builtin_type_int8;
1022 extern struct type *builtin_type_uint8;
1023 extern struct type *builtin_type_int16;
1024 extern struct type *builtin_type_uint16;
1025 extern struct type *builtin_type_int32;
1026 extern struct type *builtin_type_uint32;
1027 extern struct type *builtin_type_int64;
1028 extern struct type *builtin_type_uint64;
1029 extern struct type *builtin_type_int128;
1030 extern struct type *builtin_type_uint128;
1031
1032 /* Explicit floating-point formats.  See "floatformat.h".  */
1033 extern const struct floatformat *floatformats_ieee_single[BFD_ENDIAN_UNKNOWN];
1034 extern const struct floatformat *floatformats_ieee_double[BFD_ENDIAN_UNKNOWN];
1035 extern const struct floatformat *floatformats_ieee_double_littlebyte_bigword[BFD_ENDIAN_UNKNOWN];
1036 extern const struct floatformat *floatformats_i387_ext[BFD_ENDIAN_UNKNOWN];
1037 extern const struct floatformat *floatformats_m68881_ext[BFD_ENDIAN_UNKNOWN];
1038 extern const struct floatformat *floatformats_arm_ext[BFD_ENDIAN_UNKNOWN];
1039 extern const struct floatformat *floatformats_ia64_spill[BFD_ENDIAN_UNKNOWN];
1040 extern const struct floatformat *floatformats_ia64_quad[BFD_ENDIAN_UNKNOWN];
1041 extern const struct floatformat *floatformats_vax_f[BFD_ENDIAN_UNKNOWN];
1042 extern const struct floatformat *floatformats_vax_d[BFD_ENDIAN_UNKNOWN];
1043 extern const struct floatformat *floatformats_ibm_long_double[BFD_ENDIAN_UNKNOWN];
1044
1045 extern struct type *builtin_type_ieee_single;
1046 extern struct type *builtin_type_ieee_double;
1047 extern struct type *builtin_type_i387_ext;
1048 extern struct type *builtin_type_m68881_ext;
1049 extern struct type *builtin_type_arm_ext;
1050 extern struct type *builtin_type_ia64_spill;
1051 extern struct type *builtin_type_ia64_quad;
1052
1053 /* Platform-neutral void type.  Never attempt to construct a pointer
1054    or reference type to this, because those cannot be platform-neutral.
1055    You must use builtin_type (...)->builtin_void in those cases.  */
1056 extern struct type *builtin_type_void;
1057
1058 /* Platform-neutral character types.
1059    We use these for the '/c' print format, because c_char is just a
1060    one-byte integral type, which languages less laid back than C
1061    will print as ... well, a one-byte integral type.  */
1062 extern struct type *builtin_type_true_char;
1063 extern struct type *builtin_type_true_unsigned_char;
1064
1065
1066 /* This type represents a type that was unrecognized in symbol
1067    read-in.  */
1068 extern struct type *builtin_type_error;
1069
1070
1071 /* RTTI for C++ */
1072 /* extern struct type *builtin_type_cxx_typeinfo; */
1073
1074 /* Maximum and minimum values of built-in types */
1075
1076 #define MAX_OF_TYPE(t)  \
1077    (TYPE_UNSIGNED(t) ? UMAX_OF_SIZE(TYPE_LENGTH(t)) \
1078     : MAX_OF_SIZE(TYPE_LENGTH(t)))
1079
1080 #define MIN_OF_TYPE(t)  \
1081    (TYPE_UNSIGNED(t) ? UMIN_OF_SIZE(TYPE_LENGTH(t)) \
1082     : MIN_OF_SIZE(TYPE_LENGTH(t)))
1083
1084 /* Allocate space for storing data associated with a particular type.
1085    We ensure that the space is allocated using the same mechanism that
1086    was used to allocate the space for the type structure itself.  I.E.
1087    if the type is on an objfile's objfile_obstack, then the space for data
1088    associated with that type will also be allocated on the objfile_obstack.
1089    If the type is not associated with any particular objfile (such as
1090    builtin types), then the data space will be allocated with xmalloc,
1091    the same as for the type structure. */
1092
1093 #define TYPE_ALLOC(t,size)  \
1094    (TYPE_OBJFILE (t) != NULL  \
1095     ? obstack_alloc (&TYPE_OBJFILE (t) -> objfile_obstack, size) \
1096     : xmalloc (size))
1097
1098 #define TYPE_ZALLOC(t,size)  \
1099    (TYPE_OBJFILE (t) != NULL  \
1100     ? memset (obstack_alloc (&TYPE_OBJFILE (t)->objfile_obstack, size),  \
1101               0, size)  \
1102     : xzalloc (size))
1103
1104 extern struct type *alloc_type (struct objfile *);
1105
1106 extern struct type *init_type (enum type_code, int, int, char *,
1107                                struct objfile *);
1108
1109 /* Helper functions to construct a struct or record type.  An
1110    initially empty type is created using init_composite_type().
1111    Fields are then added using append_struct_type_field().  A union
1112    type has its size set to the largest field.  A struct type has each
1113    field packed against the previous.  */
1114
1115 extern struct type *init_composite_type (char *name, enum type_code code);
1116 extern void append_composite_type_field (struct type *t, char *name,
1117                                          struct type *field);
1118 extern void append_composite_type_field_aligned (struct type *t,
1119                                                  char *name,
1120                                                  struct type *field,
1121                                                  int alignment);
1122
1123 /* Helper functions to construct a bit flags type.  An initially empty
1124    type is created using init_flag_type().  Flags are then added using
1125    append_flag_type_flag().  */
1126 extern struct type *init_flags_type (char *name, int length);
1127 extern void append_flags_type_flag (struct type *type, int bitpos, char *name);
1128
1129 extern void make_vector_type (struct type *array_type);
1130 extern struct type *init_vector_type (struct type *elt_type, int n);
1131
1132 extern struct type *lookup_reference_type (struct type *);
1133
1134 extern struct type *make_reference_type (struct type *, struct type **);
1135
1136 extern struct type *make_cv_type (int, int, struct type *, struct type **);
1137
1138 extern void replace_type (struct type *, struct type *);
1139
1140 extern int address_space_name_to_int (char *);
1141
1142 extern const char *address_space_int_to_name (int);
1143
1144 extern struct type *make_type_with_address_space (struct type *type,
1145                                                   int space_identifier);
1146
1147 extern struct type *lookup_memberptr_type (struct type *, struct type *);
1148
1149 extern struct type *lookup_methodptr_type (struct type *);
1150
1151 extern void smash_to_method_type (struct type *type, struct type *domain,
1152                                   struct type *to_type, struct field *args,
1153                                   int nargs, int varargs);
1154
1155 extern void smash_to_memberptr_type (struct type *, struct type *,
1156                                      struct type *);
1157
1158 extern struct type *allocate_stub_method (struct type *);
1159
1160 extern char *type_name_no_tag (const struct type *);
1161
1162 extern struct type *lookup_struct_elt_type (struct type *, char *, int);
1163
1164 extern struct type *make_pointer_type (struct type *, struct type **);
1165
1166 extern struct type *lookup_pointer_type (struct type *);
1167
1168 extern struct type *make_function_type (struct type *, struct type **,
1169                                         struct objfile *);
1170
1171 extern struct type *lookup_function_type (struct type *);
1172
1173 extern struct type *create_range_type (struct type *, struct type *, int,
1174                                        int);
1175
1176 extern struct type *create_array_type (struct type *, struct type *,
1177                                        struct type *);
1178
1179 extern struct type *create_string_type (struct type *, struct type *);
1180
1181 extern struct type *create_set_type (struct type *, struct type *);
1182
1183 extern struct type *lookup_unsigned_typename (char *);
1184
1185 extern struct type *lookup_signed_typename (char *);
1186
1187 extern struct type *check_typedef (struct type *);
1188
1189 #define CHECK_TYPEDEF(TYPE)                     \
1190   do {                                          \
1191     (TYPE) = check_typedef (TYPE);              \
1192   } while (0)
1193
1194 extern void check_stub_method_group (struct type *, int);
1195
1196 extern char *gdb_mangle_name (struct type *, int, int);
1197
1198 extern struct type *lookup_typename (char *, struct block *, int);
1199
1200 extern struct type *lookup_template_type (char *, struct type *,
1201                                           struct block *);
1202
1203 extern int get_vptr_fieldno (struct type *, struct type **);
1204
1205 extern int get_destructor_fn_field (struct type *, int *, int *);
1206
1207 extern int get_discrete_bounds (struct type *, LONGEST *, LONGEST *);
1208
1209 extern int is_ancestor (struct type *, struct type *);
1210
1211 /* Overload resolution */
1212
1213 #define LENGTH_MATCH(bv) ((bv)->rank[0])
1214
1215 /* Badness if parameter list length doesn't match arg list length */
1216 #define LENGTH_MISMATCH_BADNESS      100
1217 /* Dummy badness value for nonexistent parameter positions */
1218 #define TOO_FEW_PARAMS_BADNESS       100
1219 /* Badness if no conversion among types */
1220 #define INCOMPATIBLE_TYPE_BADNESS    100
1221
1222 /* Badness of integral promotion */
1223 #define INTEGER_PROMOTION_BADNESS      1
1224 /* Badness of floating promotion */
1225 #define FLOAT_PROMOTION_BADNESS        1
1226 /* Badness of integral conversion */
1227 #define INTEGER_CONVERSION_BADNESS     2
1228 /* Badness of floating conversion */
1229 #define FLOAT_CONVERSION_BADNESS       2
1230 /* Badness of integer<->floating conversions */
1231 #define INT_FLOAT_CONVERSION_BADNESS   2
1232 /* Badness of converting to a boolean */
1233 #define BOOLEAN_CONVERSION_BADNESS     2
1234 /* Badness of pointer conversion */
1235 #define POINTER_CONVERSION_BADNESS     2
1236 /* Badness of conversion of pointer to void pointer */
1237 #define VOID_PTR_CONVERSION_BADNESS    2
1238 /* Badness of converting derived to base class */
1239 #define BASE_CONVERSION_BADNESS        2
1240 /* Badness of converting from non-reference to reference */
1241 #define REFERENCE_CONVERSION_BADNESS   2
1242
1243 /* Non-standard conversions allowed by the debugger */
1244 /* Converting a pointer to an int is usually OK */
1245 #define NS_POINTER_CONVERSION_BADNESS 10
1246
1247
1248 extern int compare_badness (struct badness_vector *, struct badness_vector *);
1249
1250 extern struct badness_vector *rank_function (struct type **, int,
1251                                              struct type **, int);
1252
1253 extern int rank_one_type (struct type *, struct type *);
1254
1255 extern void recursive_dump_type (struct type *, int);
1256
1257 extern int field_is_static (struct field *);
1258
1259 /* printcmd.c */
1260
1261 extern void print_scalar_formatted (const void *, struct type *,
1262                                     const struct value_print_options *,
1263                                     int, struct ui_file *);
1264
1265 extern int can_dereference (struct type *);
1266
1267 extern int is_integral_type (struct type *);
1268
1269 extern void maintenance_print_type (char *, int);
1270
1271 extern htab_t create_copied_types_hash (struct objfile *objfile);
1272
1273 extern struct type *copy_type_recursive (struct objfile *objfile,
1274                                          struct type *type,
1275                                          htab_t copied_types);
1276
1277 extern struct type *copy_type (const struct type *type);
1278
1279 #endif /* GDBTYPES_H */