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