gdb/gdbtypes.h

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