2013-10-11 Marc Glisse <marc.glisse@inria.fr>
[official-gcc.git] / gcc / tree-core.h
bloba14c7e079b30d50c5294cf813fdfc0fb76320ece
1 /* Core data structures for the 'tree' type.
2 Copyright (C) 1989-2013 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 #ifndef GCC_TREE_CORE_H
21 #define GCC_TREE_CORE_H
23 #include "hashtab.h"
24 #include "machmode.h"
25 #include "input.h"
26 #include "statistics.h"
27 #include "vec.h"
28 #include "double-int.h"
29 #include "real.h"
30 #include "fixed-value.h"
31 #include "alias.h"
32 #include "flags.h"
33 #include "symtab.h"
35 /* This file contains all the data structures that define the 'tree' type.
36 There are no accessor macros nor functions in this file. Only the
37 basic data structures, extern declarations and type definitions. */
39 /*---------------------------------------------------------------------------
40 Forward type declarations. Mostly to avoid including unnecessary headers
41 ---------------------------------------------------------------------------*/
42 struct function;
43 struct real_value;
44 struct fixed_value;
45 struct ptr_info_def;
46 struct range_info_def;
47 struct die_struct;
48 struct pointer_set_t;
51 /*---------------------------------------------------------------------------
52 #defined constants
53 ---------------------------------------------------------------------------*/
54 /* Nonzero if this is a call to a function whose return value depends
55 solely on its arguments, has no side effects, and does not read
56 global memory. This corresponds to TREE_READONLY for function
57 decls. */
58 #define ECF_CONST (1 << 0)
60 /* Nonzero if this is a call to "pure" function (like const function,
61 but may read memory. This corresponds to DECL_PURE_P for function
62 decls. */
63 #define ECF_PURE (1 << 1)
65 /* Nonzero if this is ECF_CONST or ECF_PURE but cannot be proven to no
66 infinite loop. This corresponds to DECL_LOOPING_CONST_OR_PURE_P
67 for function decls.*/
68 #define ECF_LOOPING_CONST_OR_PURE (1 << 2)
70 /* Nonzero if this call will never return. */
71 #define ECF_NORETURN (1 << 3)
73 /* Nonzero if this is a call to malloc or a related function. */
74 #define ECF_MALLOC (1 << 4)
76 /* Nonzero if it is plausible that this is a call to alloca. */
77 #define ECF_MAY_BE_ALLOCA (1 << 5)
79 /* Nonzero if this is a call to a function that won't throw an exception. */
80 #define ECF_NOTHROW (1 << 6)
82 /* Nonzero if this is a call to setjmp or a related function. */
83 #define ECF_RETURNS_TWICE (1 << 7)
85 /* Nonzero if this call replaces the current stack frame. */
86 #define ECF_SIBCALL (1 << 8)
88 /* Function does not read or write memory (but may have side effects, so
89 it does not necessarily fit ECF_CONST). */
90 #define ECF_NOVOPS (1 << 9)
92 /* The function does not lead to calls within current function unit. */
93 #define ECF_LEAF (1 << 10)
95 /* Nonzero if this call does not affect transactions. */
96 #define ECF_TM_PURE (1 << 11)
98 /* Nonzero if this call is into the transaction runtime library. */
99 #define ECF_TM_BUILTIN (1 << 12)
101 /* Call argument flags. */
102 /* Nonzero if the argument is not dereferenced recursively, thus only
103 directly reachable memory is read or written. */
104 #define EAF_DIRECT (1 << 0)
106 /* Nonzero if memory reached by the argument is not clobbered. */
107 #define EAF_NOCLOBBER (1 << 1)
109 /* Nonzero if the argument does not escape. */
110 #define EAF_NOESCAPE (1 << 2)
112 /* Nonzero if the argument is not used by the function. */
113 #define EAF_UNUSED (1 << 3)
115 /* Call return flags. */
116 /* Mask for the argument number that is returned. Lower two bits of
117 the return flags, encodes argument slots zero to three. */
118 #define ERF_RETURN_ARG_MASK (3)
120 /* Nonzero if the return value is equal to the argument number
121 flags & ERF_RETURN_ARG_MASK. */
122 #define ERF_RETURNS_ARG (1 << 2)
124 /* Nonzero if the return value does not alias with anything. Functions
125 with the malloc attribute have this set on their return value. */
126 #define ERF_NOALIAS (1 << 3)
129 /*---------------------------------------------------------------------------
130 Enumerations
131 ---------------------------------------------------------------------------*/
132 /* Codes of tree nodes. */
133 #define DEFTREECODE(SYM, STRING, TYPE, NARGS) SYM,
134 #define END_OF_BASE_TREE_CODES LAST_AND_UNUSED_TREE_CODE,
136 enum tree_code {
137 #include "all-tree.def"
138 MAX_TREE_CODES
141 #undef DEFTREECODE
142 #undef END_OF_BASE_TREE_CODES
144 /* Number of language-independent tree codes. */
145 #define NUM_TREE_CODES \
146 ((int) LAST_AND_UNUSED_TREE_CODE)
148 #define CODE_CONTAINS_STRUCT(CODE, STRUCT) \
149 (tree_contains_struct[(CODE)][(STRUCT)])
152 /* Classify which part of the compiler has defined a given builtin function.
153 Note that we assume below that this is no more than two bits. */
154 enum built_in_class {
155 NOT_BUILT_IN = 0,
156 BUILT_IN_FRONTEND,
157 BUILT_IN_MD,
158 BUILT_IN_NORMAL
161 /* Last marker used for LTO stremaing of built_in_class. We can not add it
162 to the enum since we need the enumb to fit in 2 bits. */
163 #define BUILT_IN_LAST (BUILT_IN_NORMAL + 1)
165 /* Codes that identify the various built in functions
166 so that expand_call can identify them quickly. */
167 #define DEF_BUILTIN(ENUM, N, C, T, LT, B, F, NA, AT, IM, COND) ENUM,
168 enum built_in_function {
169 #include "builtins.def"
171 /* Complex division routines in libgcc. These are done via builtins
172 because emit_library_call_value can't handle complex values. */
173 BUILT_IN_COMPLEX_MUL_MIN,
174 BUILT_IN_COMPLEX_MUL_MAX
175 = BUILT_IN_COMPLEX_MUL_MIN
176 + MAX_MODE_COMPLEX_FLOAT
177 - MIN_MODE_COMPLEX_FLOAT,
179 BUILT_IN_COMPLEX_DIV_MIN,
180 BUILT_IN_COMPLEX_DIV_MAX
181 = BUILT_IN_COMPLEX_DIV_MIN
182 + MAX_MODE_COMPLEX_FLOAT
183 - MIN_MODE_COMPLEX_FLOAT,
185 /* Upper bound on non-language-specific builtins. */
186 END_BUILTINS
188 #undef DEF_BUILTIN
190 /* Tree code classes. Each tree_code has an associated code class
191 represented by a TREE_CODE_CLASS. */
192 enum tree_code_class {
193 tcc_exceptional, /* An exceptional code (fits no category). */
194 tcc_constant, /* A constant. */
195 /* Order of tcc_type and tcc_declaration is important. */
196 tcc_type, /* A type object code. */
197 tcc_declaration, /* A declaration (also serving as variable refs). */
198 tcc_reference, /* A reference to storage. */
199 tcc_comparison, /* A comparison expression. */
200 tcc_unary, /* A unary arithmetic expression. */
201 tcc_binary, /* A binary arithmetic expression. */
202 tcc_statement, /* A statement expression, which have side effects
203 but usually no interesting value. */
204 tcc_vl_exp, /* A function call or other expression with a
205 variable-length operand vector. */
206 tcc_expression /* Any other expression. */
209 /* OMP_CLAUSE codes. Do not reorder, as this is used to index into
210 the tables omp_clause_num_ops and omp_clause_code_name. */
211 enum omp_clause_code {
212 /* Clause zero is special-cased inside the parser
213 (c_parser_omp_variable_list). */
214 OMP_CLAUSE_ERROR = 0,
216 /* OpenMP clause: private (variable_list). */
217 OMP_CLAUSE_PRIVATE,
219 /* OpenMP clause: shared (variable_list). */
220 OMP_CLAUSE_SHARED,
222 /* OpenMP clause: firstprivate (variable_list). */
223 OMP_CLAUSE_FIRSTPRIVATE,
225 /* OpenMP clause: lastprivate (variable_list). */
226 OMP_CLAUSE_LASTPRIVATE,
228 /* OpenMP clause: reduction (operator:variable_list).
229 OMP_CLAUSE_REDUCTION_CODE: The tree_code of the operator.
230 Operand 1: OMP_CLAUSE_REDUCTION_INIT: Stmt-list to initialize the var.
231 Operand 2: OMP_CLAUSE_REDUCTION_MERGE: Stmt-list to merge private var
232 into the shared one.
233 Operand 3: OMP_CLAUSE_REDUCTION_PLACEHOLDER: A dummy VAR_DECL
234 placeholder used in OMP_CLAUSE_REDUCTION_{INIT,MERGE}. */
235 OMP_CLAUSE_REDUCTION,
237 /* OpenMP clause: copyin (variable_list). */
238 OMP_CLAUSE_COPYIN,
240 /* OpenMP clause: copyprivate (variable_list). */
241 OMP_CLAUSE_COPYPRIVATE,
243 /* OpenMP clause: linear (variable-list[:linear-step]). */
244 OMP_CLAUSE_LINEAR,
246 /* OpenMP clause: aligned (variable-list[:alignment]). */
247 OMP_CLAUSE_ALIGNED,
249 /* OpenMP clause: depend ({in,out,inout}:variable-list). */
250 OMP_CLAUSE_DEPEND,
252 /* OpenMP clause: uniform (argument-list). */
253 OMP_CLAUSE_UNIFORM,
255 /* OpenMP clause: from (variable-list). */
256 OMP_CLAUSE_FROM,
258 /* OpenMP clause: to (variable-list). */
259 OMP_CLAUSE_TO,
261 /* OpenMP clause: map ({alloc:,to:,from:,tofrom:,}variable-list). */
262 OMP_CLAUSE_MAP,
264 /* Internal clause: temporary for combined loops expansion. */
265 OMP_CLAUSE__LOOPTEMP_,
267 /* OpenMP clause: if (scalar-expression). */
268 OMP_CLAUSE_IF,
270 /* OpenMP clause: num_threads (integer-expression). */
271 OMP_CLAUSE_NUM_THREADS,
273 /* OpenMP clause: schedule. */
274 OMP_CLAUSE_SCHEDULE,
276 /* OpenMP clause: nowait. */
277 OMP_CLAUSE_NOWAIT,
279 /* OpenMP clause: ordered. */
280 OMP_CLAUSE_ORDERED,
282 /* OpenMP clause: default. */
283 OMP_CLAUSE_DEFAULT,
285 /* OpenMP clause: collapse (constant-integer-expression). */
286 OMP_CLAUSE_COLLAPSE,
288 /* OpenMP clause: untied. */
289 OMP_CLAUSE_UNTIED,
291 /* OpenMP clause: final (scalar-expression). */
292 OMP_CLAUSE_FINAL,
294 /* OpenMP clause: mergeable. */
295 OMP_CLAUSE_MERGEABLE,
297 /* OpenMP clause: device (integer-expression). */
298 OMP_CLAUSE_DEVICE,
300 /* OpenMP clause: dist_schedule (static[:chunk-size]). */
301 OMP_CLAUSE_DIST_SCHEDULE,
303 /* OpenMP clause: inbranch. */
304 OMP_CLAUSE_INBRANCH,
306 /* OpenMP clause: notinbranch. */
307 OMP_CLAUSE_NOTINBRANCH,
309 /* OpenMP clause: num_teams(integer-expression). */
310 OMP_CLAUSE_NUM_TEAMS,
312 /* OpenMP clause: thread_limit(integer-expression). */
313 OMP_CLAUSE_THREAD_LIMIT,
315 /* OpenMP clause: proc_bind ({master,close,spread}). */
316 OMP_CLAUSE_PROC_BIND,
318 /* OpenMP clause: safelen (constant-integer-expression). */
319 OMP_CLAUSE_SAFELEN,
321 /* OpenMP clause: simdlen (constant-integer-expression). */
322 OMP_CLAUSE_SIMDLEN,
324 /* OpenMP clause: for. */
325 OMP_CLAUSE_FOR,
327 /* OpenMP clause: parallel. */
328 OMP_CLAUSE_PARALLEL,
330 /* OpenMP clause: sections. */
331 OMP_CLAUSE_SECTIONS,
333 /* OpenMP clause: taskgroup. */
334 OMP_CLAUSE_TASKGROUP,
336 /* Internally used only clause, holding SIMD uid. */
337 OMP_CLAUSE__SIMDUID_
340 #undef DEFTREESTRUCT
341 #define DEFTREESTRUCT(ENUM, NAME) ENUM,
342 enum tree_node_structure_enum {
343 #include "treestruct.def"
344 LAST_TS_ENUM
346 #undef DEFTREESTRUCT
348 enum omp_clause_schedule_kind {
349 OMP_CLAUSE_SCHEDULE_STATIC,
350 OMP_CLAUSE_SCHEDULE_DYNAMIC,
351 OMP_CLAUSE_SCHEDULE_GUIDED,
352 OMP_CLAUSE_SCHEDULE_AUTO,
353 OMP_CLAUSE_SCHEDULE_RUNTIME
356 enum omp_clause_default_kind {
357 OMP_CLAUSE_DEFAULT_UNSPECIFIED,
358 OMP_CLAUSE_DEFAULT_SHARED,
359 OMP_CLAUSE_DEFAULT_NONE,
360 OMP_CLAUSE_DEFAULT_PRIVATE,
361 OMP_CLAUSE_DEFAULT_FIRSTPRIVATE
364 /* There is a TYPE_QUAL value for each type qualifier. They can be
365 combined by bitwise-or to form the complete set of qualifiers for a
366 type. */
367 enum cv_qualifier {
368 TYPE_UNQUALIFIED = 0x0,
369 TYPE_QUAL_CONST = 0x1,
370 TYPE_QUAL_VOLATILE = 0x2,
371 TYPE_QUAL_RESTRICT = 0x4
374 /* Enumerate visibility settings. */
375 #ifndef SYMBOL_VISIBILITY_DEFINED
376 #define SYMBOL_VISIBILITY_DEFINED
377 enum symbol_visibility {
378 VISIBILITY_DEFAULT,
379 VISIBILITY_PROTECTED,
380 VISIBILITY_HIDDEN,
381 VISIBILITY_INTERNAL
383 #endif // SYMBOL_VISIBILITY_DEFINED
385 /* Standard named or nameless data types of the C compiler. */
386 enum tree_index {
387 TI_ERROR_MARK,
388 TI_INTQI_TYPE,
389 TI_INTHI_TYPE,
390 TI_INTSI_TYPE,
391 TI_INTDI_TYPE,
392 TI_INTTI_TYPE,
394 TI_UINTQI_TYPE,
395 TI_UINTHI_TYPE,
396 TI_UINTSI_TYPE,
397 TI_UINTDI_TYPE,
398 TI_UINTTI_TYPE,
400 TI_UINT16_TYPE,
401 TI_UINT32_TYPE,
402 TI_UINT64_TYPE,
404 TI_INTEGER_ZERO,
405 TI_INTEGER_ONE,
406 TI_INTEGER_THREE,
407 TI_INTEGER_MINUS_ONE,
408 TI_NULL_POINTER,
410 TI_SIZE_ZERO,
411 TI_SIZE_ONE,
413 TI_BITSIZE_ZERO,
414 TI_BITSIZE_ONE,
415 TI_BITSIZE_UNIT,
417 TI_PUBLIC,
418 TI_PROTECTED,
419 TI_PRIVATE,
421 TI_BOOLEAN_FALSE,
422 TI_BOOLEAN_TRUE,
424 TI_COMPLEX_INTEGER_TYPE,
425 TI_COMPLEX_FLOAT_TYPE,
426 TI_COMPLEX_DOUBLE_TYPE,
427 TI_COMPLEX_LONG_DOUBLE_TYPE,
429 TI_FLOAT_TYPE,
430 TI_DOUBLE_TYPE,
431 TI_LONG_DOUBLE_TYPE,
433 TI_FLOAT_PTR_TYPE,
434 TI_DOUBLE_PTR_TYPE,
435 TI_LONG_DOUBLE_PTR_TYPE,
436 TI_INTEGER_PTR_TYPE,
438 TI_VOID_TYPE,
439 TI_PTR_TYPE,
440 TI_CONST_PTR_TYPE,
441 TI_SIZE_TYPE,
442 TI_PID_TYPE,
443 TI_PTRDIFF_TYPE,
444 TI_VA_LIST_TYPE,
445 TI_VA_LIST_GPR_COUNTER_FIELD,
446 TI_VA_LIST_FPR_COUNTER_FIELD,
447 TI_BOOLEAN_TYPE,
448 TI_FILEPTR_TYPE,
449 TI_POINTER_SIZED_TYPE,
451 TI_DFLOAT32_TYPE,
452 TI_DFLOAT64_TYPE,
453 TI_DFLOAT128_TYPE,
454 TI_DFLOAT32_PTR_TYPE,
455 TI_DFLOAT64_PTR_TYPE,
456 TI_DFLOAT128_PTR_TYPE,
458 TI_VOID_LIST_NODE,
460 TI_MAIN_IDENTIFIER,
462 TI_SAT_SFRACT_TYPE,
463 TI_SAT_FRACT_TYPE,
464 TI_SAT_LFRACT_TYPE,
465 TI_SAT_LLFRACT_TYPE,
466 TI_SAT_USFRACT_TYPE,
467 TI_SAT_UFRACT_TYPE,
468 TI_SAT_ULFRACT_TYPE,
469 TI_SAT_ULLFRACT_TYPE,
470 TI_SFRACT_TYPE,
471 TI_FRACT_TYPE,
472 TI_LFRACT_TYPE,
473 TI_LLFRACT_TYPE,
474 TI_USFRACT_TYPE,
475 TI_UFRACT_TYPE,
476 TI_ULFRACT_TYPE,
477 TI_ULLFRACT_TYPE,
478 TI_SAT_SACCUM_TYPE,
479 TI_SAT_ACCUM_TYPE,
480 TI_SAT_LACCUM_TYPE,
481 TI_SAT_LLACCUM_TYPE,
482 TI_SAT_USACCUM_TYPE,
483 TI_SAT_UACCUM_TYPE,
484 TI_SAT_ULACCUM_TYPE,
485 TI_SAT_ULLACCUM_TYPE,
486 TI_SACCUM_TYPE,
487 TI_ACCUM_TYPE,
488 TI_LACCUM_TYPE,
489 TI_LLACCUM_TYPE,
490 TI_USACCUM_TYPE,
491 TI_UACCUM_TYPE,
492 TI_ULACCUM_TYPE,
493 TI_ULLACCUM_TYPE,
494 TI_QQ_TYPE,
495 TI_HQ_TYPE,
496 TI_SQ_TYPE,
497 TI_DQ_TYPE,
498 TI_TQ_TYPE,
499 TI_UQQ_TYPE,
500 TI_UHQ_TYPE,
501 TI_USQ_TYPE,
502 TI_UDQ_TYPE,
503 TI_UTQ_TYPE,
504 TI_SAT_QQ_TYPE,
505 TI_SAT_HQ_TYPE,
506 TI_SAT_SQ_TYPE,
507 TI_SAT_DQ_TYPE,
508 TI_SAT_TQ_TYPE,
509 TI_SAT_UQQ_TYPE,
510 TI_SAT_UHQ_TYPE,
511 TI_SAT_USQ_TYPE,
512 TI_SAT_UDQ_TYPE,
513 TI_SAT_UTQ_TYPE,
514 TI_HA_TYPE,
515 TI_SA_TYPE,
516 TI_DA_TYPE,
517 TI_TA_TYPE,
518 TI_UHA_TYPE,
519 TI_USA_TYPE,
520 TI_UDA_TYPE,
521 TI_UTA_TYPE,
522 TI_SAT_HA_TYPE,
523 TI_SAT_SA_TYPE,
524 TI_SAT_DA_TYPE,
525 TI_SAT_TA_TYPE,
526 TI_SAT_UHA_TYPE,
527 TI_SAT_USA_TYPE,
528 TI_SAT_UDA_TYPE,
529 TI_SAT_UTA_TYPE,
531 TI_OPTIMIZATION_DEFAULT,
532 TI_OPTIMIZATION_CURRENT,
533 TI_TARGET_OPTION_DEFAULT,
534 TI_TARGET_OPTION_CURRENT,
535 TI_CURRENT_TARGET_PRAGMA,
536 TI_CURRENT_OPTIMIZE_PRAGMA,
538 TI_MAX
541 /* An enumeration of the standard C integer types. These must be
542 ordered so that shorter types appear before longer ones, and so
543 that signed types appear before unsigned ones, for the correct
544 functioning of interpret_integer() in c-lex.c. */
545 enum integer_type_kind {
546 itk_char,
547 itk_signed_char,
548 itk_unsigned_char,
549 itk_short,
550 itk_unsigned_short,
551 itk_int,
552 itk_unsigned_int,
553 itk_long,
554 itk_unsigned_long,
555 itk_long_long,
556 itk_unsigned_long_long,
557 itk_int128,
558 itk_unsigned_int128,
559 itk_none
562 /* A pointer-to-function member type looks like:
564 struct {
565 __P __pfn;
566 ptrdiff_t __delta;
569 If __pfn is NULL, it is a NULL pointer-to-member-function.
571 (Because the vtable is always the first thing in the object, we
572 don't need its offset.) If the function is virtual, then PFN is
573 one plus twice the index into the vtable; otherwise, it is just a
574 pointer to the function.
576 Unfortunately, using the lowest bit of PFN doesn't work in
577 architectures that don't impose alignment requirements on function
578 addresses, or that use the lowest bit to tell one ISA from another,
579 for example. For such architectures, we use the lowest bit of
580 DELTA instead of the lowest bit of the PFN, and DELTA will be
581 multiplied by 2. */
582 enum ptrmemfunc_vbit_where_t {
583 ptrmemfunc_vbit_in_pfn,
584 ptrmemfunc_vbit_in_delta
587 /* Flags that may be passed in the third argument of decl_attributes, and
588 to handler functions for attributes. */
589 enum attribute_flags {
590 /* The type passed in is the type of a DECL, and any attributes that
591 should be passed in again to be applied to the DECL rather than the
592 type should be returned. */
593 ATTR_FLAG_DECL_NEXT = 1,
594 /* The type passed in is a function return type, and any attributes that
595 should be passed in again to be applied to the function type rather
596 than the return type should be returned. */
597 ATTR_FLAG_FUNCTION_NEXT = 2,
598 /* The type passed in is an array element type, and any attributes that
599 should be passed in again to be applied to the array type rather
600 than the element type should be returned. */
601 ATTR_FLAG_ARRAY_NEXT = 4,
602 /* The type passed in is a structure, union or enumeration type being
603 created, and should be modified in place. */
604 ATTR_FLAG_TYPE_IN_PLACE = 8,
605 /* The attributes are being applied by default to a library function whose
606 name indicates known behavior, and should be silently ignored if they
607 are not in fact compatible with the function type. */
608 ATTR_FLAG_BUILT_IN = 16,
609 /* A given attribute has been parsed as a C++-11 attribute. */
610 ATTR_FLAG_CXX11 = 32
613 /* Types used to represent sizes. */
614 enum size_type_kind {
615 stk_sizetype, /* Normal representation of sizes in bytes. */
616 stk_ssizetype, /* Signed representation of sizes in bytes. */
617 stk_bitsizetype, /* Normal representation of sizes in bits. */
618 stk_sbitsizetype, /* Signed representation of sizes in bits. */
619 stk_type_kind_last
622 enum operand_equal_flag {
623 OEP_ONLY_CONST = 1,
624 OEP_PURE_SAME = 2,
625 OEP_CONSTANT_ADDRESS_OF = 4
628 /* Enum and arrays used for tree allocation stats.
629 Keep in sync with tree.c:tree_node_kind_names. */
630 enum tree_node_kind {
631 d_kind,
632 t_kind,
633 b_kind,
634 s_kind,
635 r_kind,
636 e_kind,
637 c_kind,
638 id_kind,
639 vec_kind,
640 binfo_kind,
641 ssa_name_kind,
642 constr_kind,
643 x_kind,
644 lang_decl,
645 lang_type,
646 omp_clause_kind,
647 all_kinds
651 /*---------------------------------------------------------------------------
652 Type definitions
653 ---------------------------------------------------------------------------*/
654 /* When processing aliases at the symbol table level, we need the
655 declaration of target. For this reason we need to queue aliases and
656 process them after all declarations has been produced. */
657 typedef struct GTY(()) alias_pair {
658 tree decl;
659 tree target;
660 } alias_pair;
662 /* An initialization priority. */
663 typedef unsigned short priority_type;
665 /* The type of a callback function for walking over tree structure. */
666 typedef tree (*walk_tree_fn) (tree *, int *, void *);
668 /* The type of a callback function that represents a custom walk_tree. */
669 typedef tree (*walk_tree_lh) (tree *, int *, tree (*) (tree *, int *, void *),
670 void *, struct pointer_set_t*);
673 /*---------------------------------------------------------------------------
674 Main data structures
675 ---------------------------------------------------------------------------*/
676 /* A tree node can represent a data type, a variable, an expression
677 or a statement. Each node has a TREE_CODE which says what kind of
678 thing it represents. Some common codes are:
679 INTEGER_TYPE -- represents a type of integers.
680 ARRAY_TYPE -- represents a type of pointer.
681 VAR_DECL -- represents a declared variable.
682 INTEGER_CST -- represents a constant integer value.
683 PLUS_EXPR -- represents a sum (an expression).
685 As for the contents of a tree node: there are some fields
686 that all nodes share. Each TREE_CODE has various special-purpose
687 fields as well. The fields of a node are never accessed directly,
688 always through accessor macros. */
690 /* Every kind of tree node starts with this structure,
691 so all nodes have these fields.
693 See the accessor macros, defined below, for documentation of the
694 fields, and the table below which connects the fields and the
695 accessor macros. */
697 struct GTY(()) tree_base {
698 ENUM_BITFIELD(tree_code) code : 16;
700 unsigned side_effects_flag : 1;
701 unsigned constant_flag : 1;
702 unsigned addressable_flag : 1;
703 unsigned volatile_flag : 1;
704 unsigned readonly_flag : 1;
705 unsigned asm_written_flag: 1;
706 unsigned nowarning_flag : 1;
707 unsigned visited : 1;
709 unsigned used_flag : 1;
710 unsigned nothrow_flag : 1;
711 unsigned static_flag : 1;
712 unsigned public_flag : 1;
713 unsigned private_flag : 1;
714 unsigned protected_flag : 1;
715 unsigned deprecated_flag : 1;
716 unsigned default_def_flag : 1;
718 union {
719 /* The bits in the following structure should only be used with
720 accessor macros that constrain inputs with tree checking. */
721 struct {
722 unsigned lang_flag_0 : 1;
723 unsigned lang_flag_1 : 1;
724 unsigned lang_flag_2 : 1;
725 unsigned lang_flag_3 : 1;
726 unsigned lang_flag_4 : 1;
727 unsigned lang_flag_5 : 1;
728 unsigned lang_flag_6 : 1;
729 unsigned saturating_flag : 1;
731 unsigned unsigned_flag : 1;
732 unsigned packed_flag : 1;
733 unsigned user_align : 1;
734 unsigned nameless_flag : 1;
735 unsigned spare0 : 4;
737 unsigned spare1 : 8;
739 /* This field is only used with TREE_TYPE nodes; the only reason it is
740 present in tree_base instead of tree_type is to save space. The size
741 of the field must be large enough to hold addr_space_t values. */
742 unsigned address_space : 8;
743 } bits;
744 /* The following fields are present in tree_base to save space. The
745 nodes using them do not require any of the flags above and so can
746 make better use of the 4-byte sized word. */
747 /* VEC length. This field is only used with TREE_VEC. */
748 int length;
749 /* SSA version number. This field is only used with SSA_NAME. */
750 unsigned int version;
751 } GTY((skip(""))) u;
754 /* The following table lists the uses of each of the above flags and
755 for which types of nodes they are defined.
757 addressable_flag:
759 TREE_ADDRESSABLE in
760 VAR_DECL, PARM_DECL, RESULT_DECL, FUNCTION_DECL, LABEL_DECL
761 SSA_NAME
762 all types
763 CONSTRUCTOR, IDENTIFIER_NODE
764 STMT_EXPR
766 CALL_EXPR_TAILCALL in
767 CALL_EXPR
769 CASE_LOW_SEEN in
770 CASE_LABEL_EXPR
772 PREDICT_EXPR_OUTCOME in
773 PREDICT_EXPR
775 static_flag:
777 TREE_STATIC in
778 VAR_DECL, FUNCTION_DECL
779 CONSTRUCTOR
781 TREE_NO_TRAMPOLINE in
782 ADDR_EXPR
784 BINFO_VIRTUAL_P in
785 TREE_BINFO
787 TREE_SYMBOL_REFERENCED in
788 IDENTIFIER_NODE
790 CLEANUP_EH_ONLY in
791 TARGET_EXPR, WITH_CLEANUP_EXPR
793 TRY_CATCH_IS_CLEANUP in
794 TRY_CATCH_EXPR
796 ASM_INPUT_P in
797 ASM_EXPR
799 TYPE_REF_CAN_ALIAS_ALL in
800 POINTER_TYPE, REFERENCE_TYPE
802 CASE_HIGH_SEEN in
803 CASE_LABEL_EXPR
805 ENUM_IS_SCOPED in
806 ENUMERAL_TYPE
808 TRANSACTION_EXPR_OUTER in
809 TRANSACTION_EXPR
811 public_flag:
813 TREE_OVERFLOW in
814 INTEGER_CST, REAL_CST, COMPLEX_CST, VECTOR_CST
816 TREE_PUBLIC in
817 VAR_DECL, FUNCTION_DECL
818 IDENTIFIER_NODE
820 ASM_VOLATILE_P in
821 ASM_EXPR
823 CALL_EXPR_VA_ARG_PACK in
824 CALL_EXPR
826 TYPE_CACHED_VALUES_P in
827 all types
829 SAVE_EXPR_RESOLVED_P in
830 SAVE_EXPR
832 OMP_CLAUSE_LASTPRIVATE_FIRSTPRIVATE in
833 OMP_CLAUSE_LASTPRIVATE
835 OMP_CLAUSE_PRIVATE_DEBUG in
836 OMP_CLAUSE_PRIVATE
838 OMP_CLAUSE_LINEAR_NO_COPYIN in
839 OMP_CLAUSE_LINEAR
841 OMP_CLAUSE_MAP_ZERO_BIAS_ARRAY_SECTION in
842 OMP_CLAUSE_MAP
844 OMP_CLAUSE_REDUCTION_OMP_ORIG_REF in
845 OMP_CLAUSE_REDUCTION
847 TRANSACTION_EXPR_RELAXED in
848 TRANSACTION_EXPR
850 private_flag:
852 TREE_PRIVATE in
853 all decls
855 CALL_EXPR_RETURN_SLOT_OPT in
856 CALL_EXPR
858 OMP_SECTION_LAST in
859 OMP_SECTION
861 OMP_PARALLEL_COMBINED in
862 OMP_PARALLEL
864 OMP_ATOMIC_SEQ_CST in
865 OMP_ATOMIC*
867 OMP_CLAUSE_PRIVATE_OUTER_REF in
868 OMP_CLAUSE_PRIVATE
870 OMP_CLAUSE_LINEAR_NO_COPYOUT in
871 OMP_CLAUSE_LINEAR
873 TYPE_REF_IS_RVALUE in
874 REFERENCE_TYPE
876 ENUM_IS_OPAQUE in
877 ENUMERAL_TYPE
879 protected_flag:
881 TREE_PROTECTED in
882 BLOCK
883 all decls
885 CALL_FROM_THUNK_P and
886 CALL_ALLOCA_FOR_VAR_P in
887 CALL_EXPR
889 side_effects_flag:
891 TREE_SIDE_EFFECTS in
892 all expressions
893 all decls
894 all constants
896 FORCED_LABEL in
897 LABEL_DECL
899 volatile_flag:
901 TREE_THIS_VOLATILE in
902 all expressions
903 all decls
905 TYPE_VOLATILE in
906 all types
908 readonly_flag:
910 TREE_READONLY in
911 all expressions
912 all decls
914 TYPE_READONLY in
915 all types
917 constant_flag:
919 TREE_CONSTANT in
920 all expressions
921 all decls
922 all constants
924 TYPE_SIZES_GIMPLIFIED in
925 all types
927 unsigned_flag:
929 TYPE_UNSIGNED in
930 all types
932 DECL_UNSIGNED in
933 all decls
935 asm_written_flag:
937 TREE_ASM_WRITTEN in
938 VAR_DECL, FUNCTION_DECL, TYPE_DECL
939 RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE
940 BLOCK, STRING_CST
942 SSA_NAME_OCCURS_IN_ABNORMAL_PHI in
943 SSA_NAME
945 used_flag:
947 TREE_USED in
948 all expressions
949 all decls
950 IDENTIFIER_NODE
952 nothrow_flag:
954 TREE_NOTHROW in
955 CALL_EXPR
956 FUNCTION_DECL
958 TYPE_ALIGN_OK in
959 all types
961 TREE_THIS_NOTRAP in
962 INDIRECT_REF, MEM_REF, TARGET_MEM_REF, ARRAY_REF, ARRAY_RANGE_REF
964 SSA_NAME_IN_FREELIST in
965 SSA_NAME
967 deprecated_flag:
969 TREE_DEPRECATED in
970 all decls
971 all types
973 IDENTIFIER_TRANSPARENT_ALIAS in
974 IDENTIFIER_NODE
976 visited:
978 TREE_VISITED in
979 all trees (used liberally by many passes)
981 saturating_flag:
983 TYPE_SATURATING in
984 all types
986 VAR_DECL_IS_VIRTUAL_OPERAND in
987 VAR_DECL
989 nowarning_flag:
991 TREE_NO_WARNING in
992 all expressions
993 all decls
995 TYPE_ARTIFICIAL in
996 all types
998 default_def_flag:
1000 TYPE_VECTOR_OPAQUE in
1001 VECTOR_TYPE
1003 SSA_NAME_IS_DEFAULT_DEF in
1004 SSA_NAME
1006 DECL_NONLOCAL_FRAME in
1007 VAR_DECL
1009 TYPE_FINAL_P in
1010 RECORD_TYPE, UNION_TYPE and QUAL_UNION_TYPE
1013 struct GTY(()) tree_typed {
1014 struct tree_base base;
1015 tree type;
1018 struct GTY(()) tree_common {
1019 struct tree_typed typed;
1020 tree chain;
1023 struct GTY(()) tree_int_cst {
1024 struct tree_typed typed;
1025 double_int int_cst;
1029 struct GTY(()) tree_real_cst {
1030 struct tree_typed typed;
1031 struct real_value * real_cst_ptr;
1034 struct GTY(()) tree_fixed_cst {
1035 struct tree_typed typed;
1036 struct fixed_value * fixed_cst_ptr;
1039 struct GTY(()) tree_string {
1040 struct tree_typed typed;
1041 int length;
1042 char str[1];
1045 struct GTY(()) tree_complex {
1046 struct tree_typed typed;
1047 tree real;
1048 tree imag;
1051 struct GTY(()) tree_vector {
1052 struct tree_typed typed;
1053 tree GTY ((length ("TYPE_VECTOR_SUBPARTS (TREE_TYPE ((tree)&%h))"))) elts[1];
1056 struct GTY(()) tree_identifier {
1057 struct tree_common common;
1058 struct ht_identifier id;
1061 struct GTY(()) tree_list {
1062 struct tree_common common;
1063 tree purpose;
1064 tree value;
1067 struct GTY(()) tree_vec {
1068 struct tree_common common;
1069 tree GTY ((length ("TREE_VEC_LENGTH ((tree)&%h)"))) a[1];
1072 /* A single element of a CONSTRUCTOR. VALUE holds the actual value of the
1073 element. INDEX can optionally design the position of VALUE: in arrays,
1074 it is the index where VALUE has to be placed; in structures, it is the
1075 FIELD_DECL of the member. */
1076 typedef struct GTY(()) constructor_elt_d {
1077 tree index;
1078 tree value;
1079 } constructor_elt;
1081 struct GTY(()) tree_constructor {
1082 struct tree_typed typed;
1083 vec<constructor_elt, va_gc> *elts;
1086 enum omp_clause_depend_kind
1088 OMP_CLAUSE_DEPEND_IN,
1089 OMP_CLAUSE_DEPEND_OUT,
1090 OMP_CLAUSE_DEPEND_INOUT
1093 enum omp_clause_map_kind
1095 OMP_CLAUSE_MAP_ALLOC,
1096 OMP_CLAUSE_MAP_TO,
1097 OMP_CLAUSE_MAP_FROM,
1098 OMP_CLAUSE_MAP_TOFROM,
1099 /* The following kind is an internal only map kind, used for pointer based
1100 array sections. OMP_CLAUSE_SIZE for these is not the pointer size,
1101 which is implicitly POINTER_SIZE / BITS_PER_UNIT, but the bias. */
1102 OMP_CLAUSE_MAP_POINTER
1105 enum omp_clause_proc_bind_kind
1107 /* Numbers should match omp_proc_bind_t enum in omp.h. */
1108 OMP_CLAUSE_PROC_BIND_FALSE = 0,
1109 OMP_CLAUSE_PROC_BIND_TRUE = 1,
1110 OMP_CLAUSE_PROC_BIND_MASTER = 2,
1111 OMP_CLAUSE_PROC_BIND_CLOSE = 3,
1112 OMP_CLAUSE_PROC_BIND_SPREAD = 4
1115 struct GTY(()) tree_exp {
1116 struct tree_typed typed;
1117 location_t locus;
1118 tree GTY ((special ("tree_exp"),
1119 desc ("TREE_CODE ((tree) &%0)")))
1120 operands[1];
1123 /* Immediate use linking structure. This structure is used for maintaining
1124 a doubly linked list of uses of an SSA_NAME. */
1125 typedef struct GTY(()) ssa_use_operand_d {
1126 struct ssa_use_operand_d* GTY((skip(""))) prev;
1127 struct ssa_use_operand_d* GTY((skip(""))) next;
1128 /* Immediate uses for a given SSA name are maintained as a cyclic
1129 list. To recognize the root of this list, the location field
1130 needs to point to the original SSA name. Since statements and
1131 SSA names are of different data types, we need this union. See
1132 the explanation in struct immediate_use_iterator_d. */
1133 union { gimple stmt; tree ssa_name; } GTY((skip(""))) loc;
1134 tree *GTY((skip(""))) use;
1135 } ssa_use_operand_t;
1137 struct GTY(()) tree_ssa_name {
1138 struct tree_typed typed;
1140 /* _DECL wrapped by this SSA name. */
1141 tree var;
1143 /* Statement that defines this SSA name. */
1144 gimple def_stmt;
1146 /* Value range information. */
1147 union ssa_name_info_type {
1148 /* Pointer attributes used for alias analysis. */
1149 struct GTY ((tag ("0"))) ptr_info_def *ptr_info;
1150 /* Value range attributes used for zero/sign extension elimination. */
1151 struct GTY ((tag ("1"))) range_info_def *range_info;
1152 } GTY ((desc ("%1.typed.type ?" \
1153 "!POINTER_TYPE_P (TREE_TYPE ((tree)&%1)) : 2"))) info;
1155 /* Immediate uses list for this SSA_NAME. */
1156 struct ssa_use_operand_d imm_uses;
1159 struct GTY(()) phi_arg_d {
1160 /* imm_use MUST be the first element in struct because we do some
1161 pointer arithmetic with it. See phi_arg_index_from_use. */
1162 struct ssa_use_operand_d imm_use;
1163 tree def;
1164 location_t locus;
1167 struct GTY(()) tree_omp_clause {
1168 struct tree_common common;
1169 location_t locus;
1170 enum omp_clause_code code;
1171 union omp_clause_subcode {
1172 enum omp_clause_default_kind default_kind;
1173 enum omp_clause_schedule_kind schedule_kind;
1174 enum omp_clause_depend_kind depend_kind;
1175 enum omp_clause_map_kind map_kind;
1176 enum omp_clause_proc_bind_kind proc_bind_kind;
1177 enum tree_code reduction_code;
1178 } GTY ((skip)) subcode;
1180 /* The gimplification of OMP_CLAUSE_REDUCTION_{INIT,MERGE} for omp-low's
1181 usage. */
1182 gimple_seq gimple_reduction_init;
1183 gimple_seq gimple_reduction_merge;
1185 tree GTY ((length ("omp_clause_num_ops[OMP_CLAUSE_CODE ((tree)&%h)]")))
1186 ops[1];
1189 struct GTY(()) tree_block {
1190 struct tree_base base;
1191 tree chain;
1193 unsigned abstract_flag : 1;
1194 unsigned block_num : 31;
1196 location_t locus;
1198 tree vars;
1199 vec<tree, va_gc> *nonlocalized_vars;
1201 tree subblocks;
1202 tree supercontext;
1203 tree abstract_origin;
1204 tree fragment_origin;
1205 tree fragment_chain;
1208 struct GTY(()) tree_type_common {
1209 struct tree_common common;
1210 tree size;
1211 tree size_unit;
1212 tree attributes;
1213 unsigned int uid;
1215 unsigned int precision : 10;
1216 unsigned no_force_blk_flag : 1;
1217 unsigned needs_constructing_flag : 1;
1218 unsigned transparent_aggr_flag : 1;
1219 unsigned restrict_flag : 1;
1220 unsigned contains_placeholder_bits : 2;
1222 ENUM_BITFIELD(machine_mode) mode : 8;
1224 unsigned string_flag : 1;
1225 unsigned lang_flag_0 : 1;
1226 unsigned lang_flag_1 : 1;
1227 unsigned lang_flag_2 : 1;
1228 unsigned lang_flag_3 : 1;
1229 unsigned lang_flag_4 : 1;
1230 unsigned lang_flag_5 : 1;
1231 unsigned lang_flag_6 : 1;
1233 unsigned int align;
1234 alias_set_type alias_set;
1235 tree pointer_to;
1236 tree reference_to;
1237 union tree_type_symtab {
1238 int GTY ((tag ("TYPE_SYMTAB_IS_ADDRESS"))) address;
1239 const char * GTY ((tag ("TYPE_SYMTAB_IS_POINTER"))) pointer;
1240 struct die_struct * GTY ((tag ("TYPE_SYMTAB_IS_DIE"))) die;
1241 } GTY ((desc ("debug_hooks->tree_type_symtab_field"))) symtab;
1242 tree name;
1243 tree next_variant;
1244 tree main_variant;
1245 tree context;
1246 tree canonical;
1249 struct GTY(()) tree_type_with_lang_specific {
1250 struct tree_type_common common;
1251 /* Points to a structure whose details depend on the language in use. */
1252 struct lang_type *lang_specific;
1255 struct GTY(()) tree_type_non_common {
1256 struct tree_type_with_lang_specific with_lang_specific;
1257 tree values;
1258 tree minval;
1259 tree maxval;
1260 tree binfo;
1263 struct GTY (()) tree_binfo {
1264 struct tree_common common;
1266 tree offset;
1267 tree vtable;
1268 tree virtuals;
1269 tree vptr_field;
1270 vec<tree, va_gc> *base_accesses;
1271 tree inheritance;
1273 tree vtt_subvtt;
1274 tree vtt_vptr;
1276 vec<tree, va_gc> base_binfos;
1279 struct GTY(()) tree_decl_minimal {
1280 struct tree_common common;
1281 location_t locus;
1282 unsigned int uid;
1283 tree name;
1284 tree context;
1287 struct GTY(()) tree_decl_common {
1288 struct tree_decl_minimal common;
1289 tree size;
1291 ENUM_BITFIELD(machine_mode) mode : 8;
1293 unsigned nonlocal_flag : 1;
1294 unsigned virtual_flag : 1;
1295 unsigned ignored_flag : 1;
1296 unsigned abstract_flag : 1;
1297 unsigned artificial_flag : 1;
1298 unsigned preserve_flag: 1;
1299 unsigned debug_expr_is_from : 1;
1301 unsigned lang_flag_0 : 1;
1302 unsigned lang_flag_1 : 1;
1303 unsigned lang_flag_2 : 1;
1304 unsigned lang_flag_3 : 1;
1305 unsigned lang_flag_4 : 1;
1306 unsigned lang_flag_5 : 1;
1307 unsigned lang_flag_6 : 1;
1308 unsigned lang_flag_7 : 1;
1309 unsigned lang_flag_8 : 1;
1311 /* In VAR_DECL and PARM_DECL, this is DECL_REGISTER. */
1312 unsigned decl_flag_0 : 1;
1313 /* In FIELD_DECL, this is DECL_BIT_FIELD
1314 In VAR_DECL and FUNCTION_DECL, this is DECL_EXTERNAL.
1315 In TYPE_DECL, this is TYPE_DECL_SUPPRESS_DEBUG. */
1316 unsigned decl_flag_1 : 1;
1317 /* In FIELD_DECL, this is DECL_NONADDRESSABLE_P
1318 In VAR_DECL, PARM_DECL and RESULT_DECL, this is
1319 DECL_HAS_VALUE_EXPR_P. */
1320 unsigned decl_flag_2 : 1;
1321 /* 1 bit unused. */
1322 unsigned decl_flag_3 : 1;
1323 /* Logically, these two would go in a theoretical base shared by var and
1324 parm decl. */
1325 unsigned gimple_reg_flag : 1;
1326 /* In VAR_DECL, PARM_DECL and RESULT_DECL, this is DECL_BY_REFERENCE. */
1327 unsigned decl_by_reference_flag : 1;
1328 /* In a VAR_DECL and PARM_DECL, this is DECL_READ_P. */
1329 unsigned decl_read_flag : 1;
1330 /* In a VAR_DECL or RESULT_DECL, this is DECL_NONSHAREABLE. */
1331 unsigned decl_nonshareable_flag : 1;
1333 /* DECL_OFFSET_ALIGN, used only for FIELD_DECLs. */
1334 unsigned int off_align : 8;
1336 /* 24 bits unused. */
1338 /* DECL_ALIGN. It should have the same size as TYPE_ALIGN. */
1339 unsigned int align;
1341 /* UID for points-to sets, stable over copying from inlining. */
1342 unsigned int pt_uid;
1344 tree size_unit;
1345 tree initial;
1346 tree attributes;
1347 tree abstract_origin;
1349 /* Points to a structure whose details depend on the language in use. */
1350 struct lang_decl *lang_specific;
1353 struct GTY(()) tree_decl_with_rtl {
1354 struct tree_decl_common common;
1355 rtx rtl;
1358 struct GTY(()) tree_field_decl {
1359 struct tree_decl_common common;
1361 tree offset;
1362 tree bit_field_type;
1363 tree qualifier;
1364 tree bit_offset;
1365 tree fcontext;
1368 struct GTY(()) tree_label_decl {
1369 struct tree_decl_with_rtl common;
1370 int label_decl_uid;
1371 int eh_landing_pad_nr;
1374 struct GTY(()) tree_result_decl {
1375 struct tree_decl_with_rtl common;
1378 struct GTY(()) tree_const_decl {
1379 struct tree_decl_common common;
1382 struct GTY(()) tree_parm_decl {
1383 struct tree_decl_with_rtl common;
1384 rtx incoming_rtl;
1387 struct GTY(()) tree_decl_with_vis {
1388 struct tree_decl_with_rtl common;
1389 tree assembler_name;
1390 tree section_name;
1391 tree comdat_group;
1393 /* Belong to VAR_DECL exclusively. */
1394 unsigned defer_output : 1;
1395 unsigned hard_register : 1;
1396 unsigned common_flag : 1;
1397 unsigned in_text_section : 1;
1398 unsigned in_constant_pool : 1;
1399 unsigned dllimport_flag : 1;
1400 /* Don't belong to VAR_DECL exclusively. */
1401 unsigned weak_flag : 1;
1402 /* When SECTION_NAME is implied by -ffunction-section. */
1403 unsigned implicit_section_name_p : 1;
1405 unsigned seen_in_bind_expr : 1;
1406 unsigned comdat_flag : 1;
1407 ENUM_BITFIELD(symbol_visibility) visibility : 2;
1408 unsigned visibility_specified : 1;
1409 /* Belongs to VAR_DECL exclusively. */
1410 ENUM_BITFIELD(tls_model) tls_model : 3;
1412 /* Belong to FUNCTION_DECL exclusively. */
1413 unsigned init_priority_p : 1;
1414 /* Used by C++ only. Might become a generic decl flag. */
1415 unsigned shadowed_for_var_p : 1;
1416 /* Belong to FUNCTION_DECL exclusively. */
1417 unsigned cxx_constructor : 1;
1418 /* Belong to FUNCTION_DECL exclusively. */
1419 unsigned cxx_destructor : 1;
1420 /* Belong to FUNCTION_DECL exclusively. */
1421 unsigned final : 1;
1422 /* 11 unused bits. */
1425 struct GTY(()) tree_var_decl {
1426 struct tree_decl_with_vis common;
1429 struct GTY(()) tree_decl_non_common {
1430 struct tree_decl_with_vis common;
1431 /* C++ uses this in namespaces. */
1432 tree saved_tree;
1433 /* C++ uses this in templates. */
1434 tree arguments;
1435 /* Almost all FE's use this. */
1436 tree result;
1437 /* C++ uses this in namespaces and function_decls. */
1438 tree vindex;
1441 /* FUNCTION_DECL inherits from DECL_NON_COMMON because of the use of the
1442 arguments/result/saved_tree fields by front ends. It was either inherit
1443 FUNCTION_DECL from non_common, or inherit non_common from FUNCTION_DECL,
1444 which seemed a bit strange. */
1446 struct GTY(()) tree_function_decl {
1447 struct tree_decl_non_common common;
1449 struct function *f;
1451 /* The personality function. Used for stack unwinding. */
1452 tree personality;
1454 /* Function specific options that are used by this function. */
1455 tree function_specific_target; /* target options */
1456 tree function_specific_optimization; /* optimization options */
1458 /* In a FUNCTION_DECL for which DECL_BUILT_IN holds, this is
1459 DECL_FUNCTION_CODE. Otherwise unused.
1460 ??? The bitfield needs to be able to hold all target function
1461 codes as well. */
1462 ENUM_BITFIELD(built_in_function) function_code : 11;
1463 ENUM_BITFIELD(built_in_class) built_in_class : 2;
1465 unsigned static_ctor_flag : 1;
1466 unsigned static_dtor_flag : 1;
1467 unsigned uninlinable : 1;
1469 unsigned possibly_inlined : 1;
1470 unsigned novops_flag : 1;
1471 unsigned returns_twice_flag : 1;
1472 unsigned malloc_flag : 1;
1473 unsigned operator_new_flag : 1;
1474 unsigned declared_inline_flag : 1;
1475 unsigned regdecl_flag : 1;
1476 unsigned no_inline_warning_flag : 1;
1478 unsigned no_instrument_function_entry_exit : 1;
1479 unsigned no_limit_stack : 1;
1480 unsigned disregard_inline_limits : 1;
1481 unsigned pure_flag : 1;
1482 unsigned looping_const_or_pure_flag : 1;
1483 unsigned has_debug_args_flag : 1;
1484 unsigned tm_clone_flag : 1;
1485 unsigned versioned_function : 1;
1486 /* No bits left. */
1489 struct GTY(()) tree_translation_unit_decl {
1490 struct tree_decl_common common;
1491 /* Source language of this translation unit. Used for DWARF output. */
1492 const char * GTY((skip(""))) language;
1493 /* TODO: Non-optimization used to build this translation unit. */
1494 /* TODO: Root of a partial DWARF tree for global types and decls. */
1497 struct GTY(()) tree_type_decl {
1498 struct tree_decl_non_common common;
1502 struct GTY ((chain_next ("%h.next"), chain_prev ("%h.prev"))) tree_statement_list_node
1504 struct tree_statement_list_node *prev;
1505 struct tree_statement_list_node *next;
1506 tree stmt;
1509 struct GTY(()) tree_statement_list
1511 struct tree_typed typed;
1512 struct tree_statement_list_node *head;
1513 struct tree_statement_list_node *tail;
1517 /* Optimization options used by a function. */
1519 struct GTY(()) tree_optimization_option {
1520 struct tree_common common;
1522 /* The optimization options used by the user. */
1523 struct cl_optimization opts;
1525 /* Target optabs for this set of optimization options. This is of
1526 type `struct target_optabs *'. */
1527 unsigned char *GTY ((atomic)) optabs;
1529 /* The value of this_target_optabs against which the optabs above were
1530 generated. */
1531 struct target_optabs *GTY ((skip)) base_optabs;
1534 /* Target options used by a function. */
1536 struct GTY(()) tree_target_option {
1537 struct tree_common common;
1539 /* The optimization options used by the user. */
1540 struct cl_target_option opts;
1543 /* Define the overall contents of a tree node.
1544 It may be any of the structures declared above
1545 for various types of node. */
1546 union GTY ((ptr_alias (union lang_tree_node),
1547 desc ("tree_node_structure (&%h)"), variable_size)) tree_node {
1548 struct tree_base GTY ((tag ("TS_BASE"))) base;
1549 struct tree_typed GTY ((tag ("TS_TYPED"))) typed;
1550 struct tree_common GTY ((tag ("TS_COMMON"))) common;
1551 struct tree_int_cst GTY ((tag ("TS_INT_CST"))) int_cst;
1552 struct tree_real_cst GTY ((tag ("TS_REAL_CST"))) real_cst;
1553 struct tree_fixed_cst GTY ((tag ("TS_FIXED_CST"))) fixed_cst;
1554 struct tree_vector GTY ((tag ("TS_VECTOR"))) vector;
1555 struct tree_string GTY ((tag ("TS_STRING"))) string;
1556 struct tree_complex GTY ((tag ("TS_COMPLEX"))) complex;
1557 struct tree_identifier GTY ((tag ("TS_IDENTIFIER"))) identifier;
1558 struct tree_decl_minimal GTY((tag ("TS_DECL_MINIMAL"))) decl_minimal;
1559 struct tree_decl_common GTY ((tag ("TS_DECL_COMMON"))) decl_common;
1560 struct tree_decl_with_rtl GTY ((tag ("TS_DECL_WRTL"))) decl_with_rtl;
1561 struct tree_decl_non_common GTY ((tag ("TS_DECL_NON_COMMON")))
1562 decl_non_common;
1563 struct tree_parm_decl GTY ((tag ("TS_PARM_DECL"))) parm_decl;
1564 struct tree_decl_with_vis GTY ((tag ("TS_DECL_WITH_VIS"))) decl_with_vis;
1565 struct tree_var_decl GTY ((tag ("TS_VAR_DECL"))) var_decl;
1566 struct tree_field_decl GTY ((tag ("TS_FIELD_DECL"))) field_decl;
1567 struct tree_label_decl GTY ((tag ("TS_LABEL_DECL"))) label_decl;
1568 struct tree_result_decl GTY ((tag ("TS_RESULT_DECL"))) result_decl;
1569 struct tree_const_decl GTY ((tag ("TS_CONST_DECL"))) const_decl;
1570 struct tree_type_decl GTY ((tag ("TS_TYPE_DECL"))) type_decl;
1571 struct tree_function_decl GTY ((tag ("TS_FUNCTION_DECL"))) function_decl;
1572 struct tree_translation_unit_decl GTY ((tag ("TS_TRANSLATION_UNIT_DECL")))
1573 translation_unit_decl;
1574 struct tree_type_common GTY ((tag ("TS_TYPE_COMMON"))) type_common;
1575 struct tree_type_with_lang_specific GTY ((tag ("TS_TYPE_WITH_LANG_SPECIFIC")))
1576 type_with_lang_specific;
1577 struct tree_type_non_common GTY ((tag ("TS_TYPE_NON_COMMON")))
1578 type_non_common;
1579 struct tree_list GTY ((tag ("TS_LIST"))) list;
1580 struct tree_vec GTY ((tag ("TS_VEC"))) vec;
1581 struct tree_exp GTY ((tag ("TS_EXP"))) exp;
1582 struct tree_ssa_name GTY ((tag ("TS_SSA_NAME"))) ssa_name;
1583 struct tree_block GTY ((tag ("TS_BLOCK"))) block;
1584 struct tree_binfo GTY ((tag ("TS_BINFO"))) binfo;
1585 struct tree_statement_list GTY ((tag ("TS_STATEMENT_LIST"))) stmt_list;
1586 struct tree_constructor GTY ((tag ("TS_CONSTRUCTOR"))) constructor;
1587 struct tree_omp_clause GTY ((tag ("TS_OMP_CLAUSE"))) omp_clause;
1588 struct tree_optimization_option GTY ((tag ("TS_OPTIMIZATION"))) optimization;
1589 struct tree_target_option GTY ((tag ("TS_TARGET_OPTION"))) target_option;
1592 /* Structure describing an attribute and a function to handle it. */
1593 struct attribute_spec {
1594 /* The name of the attribute (without any leading or trailing __),
1595 or NULL to mark the end of a table of attributes. */
1596 const char *name;
1597 /* The minimum length of the list of arguments of the attribute. */
1598 int min_length;
1599 /* The maximum length of the list of arguments of the attribute
1600 (-1 for no maximum). */
1601 int max_length;
1602 /* Whether this attribute requires a DECL. If it does, it will be passed
1603 from types of DECLs, function return types and array element types to
1604 the DECLs, function types and array types respectively; but when
1605 applied to a type in any other circumstances, it will be ignored with
1606 a warning. (If greater control is desired for a given attribute,
1607 this should be false, and the flags argument to the handler may be
1608 used to gain greater control in that case.) */
1609 bool decl_required;
1610 /* Whether this attribute requires a type. If it does, it will be passed
1611 from a DECL to the type of that DECL. */
1612 bool type_required;
1613 /* Whether this attribute requires a function (or method) type. If it does,
1614 it will be passed from a function pointer type to the target type,
1615 and from a function return type (which is not itself a function
1616 pointer type) to the function type. */
1617 bool function_type_required;
1618 /* Function to handle this attribute. NODE points to the node to which
1619 the attribute is to be applied. If a DECL, it should be modified in
1620 place; if a TYPE, a copy should be created. NAME is the name of the
1621 attribute (possibly with leading or trailing __). ARGS is the TREE_LIST
1622 of the arguments (which may be NULL). FLAGS gives further information
1623 about the context of the attribute. Afterwards, the attributes will
1624 be added to the DECL_ATTRIBUTES or TYPE_ATTRIBUTES, as appropriate,
1625 unless *NO_ADD_ATTRS is set to true (which should be done on error,
1626 as well as in any other cases when the attributes should not be added
1627 to the DECL or TYPE). Depending on FLAGS, any attributes to be
1628 applied to another type or DECL later may be returned;
1629 otherwise the return value should be NULL_TREE. This pointer may be
1630 NULL if no special handling is required beyond the checks implied
1631 by the rest of this structure. */
1632 tree (*handler) (tree *node, tree name, tree args,
1633 int flags, bool *no_add_attrs);
1634 /* Specifies if attribute affects type's identity. */
1635 bool affects_type_identity;
1638 /* These functions allow a front-end to perform a manual layout of a
1639 RECORD_TYPE. (For instance, if the placement of subsequent fields
1640 depends on the placement of fields so far.) Begin by calling
1641 start_record_layout. Then, call place_field for each of the
1642 fields. Then, call finish_record_layout. See layout_type for the
1643 default way in which these functions are used. */
1644 typedef struct record_layout_info_s {
1645 /* The RECORD_TYPE that we are laying out. */
1646 tree t;
1647 /* The offset into the record so far, in bytes, not including bits in
1648 BITPOS. */
1649 tree offset;
1650 /* The last known alignment of SIZE. */
1651 unsigned int offset_align;
1652 /* The bit position within the last OFFSET_ALIGN bits, in bits. */
1653 tree bitpos;
1654 /* The alignment of the record so far, in bits. */
1655 unsigned int record_align;
1656 /* The alignment of the record so far, ignoring #pragma pack and
1657 __attribute__ ((packed)), in bits. */
1658 unsigned int unpacked_align;
1659 /* The previous field laid out. */
1660 tree prev_field;
1661 /* The static variables (i.e., class variables, as opposed to
1662 instance variables) encountered in T. */
1663 vec<tree, va_gc> *pending_statics;
1664 /* Bits remaining in the current alignment group */
1665 int remaining_in_alignment;
1666 /* True if we've seen a packed field that didn't have normal
1667 alignment anyway. */
1668 int packed_maybe_necessary;
1669 } *record_layout_info;
1671 /* Iterator for going through the function arguments. */
1672 struct function_args_iterator {
1673 tree next; /* TREE_LIST pointing to the next argument */
1676 /* Structures to map from a tree to another tree. */
1677 struct GTY(()) tree_map_base {
1678 tree from;
1681 /* Map from a tree to another tree. */
1683 struct GTY(()) tree_map {
1684 struct tree_map_base base;
1685 unsigned int hash;
1686 tree to;
1689 /* Map from a decl tree to another tree. */
1690 struct GTY(()) tree_decl_map {
1691 struct tree_map_base base;
1692 tree to;
1695 /* Map from a tree to an int. */
1696 struct GTY(()) tree_int_map {
1697 struct tree_map_base base;
1698 unsigned int to;
1701 /* Map from a tree to initialization/finalization priorities. */
1702 struct GTY(()) tree_priority_map {
1703 struct tree_map_base base;
1704 priority_type init;
1705 priority_type fini;
1708 /* Map from a decl tree to a tree vector. */
1709 struct GTY(()) tree_vec_map {
1710 struct tree_map_base base;
1711 vec<tree, va_gc> *to;
1714 /* Abstract iterators for CALL_EXPRs. These static inline definitions
1715 have to go towards the end of tree.h so that union tree_node is fully
1716 defined by this point. */
1718 /* Structure containing iterator state. */
1719 struct call_expr_arg_iterator {
1720 tree t; /* the call_expr */
1721 int n; /* argument count */
1722 int i; /* next argument index */
1725 struct const_call_expr_arg_iterator {
1726 const_tree t; /* the call_expr */
1727 int n; /* argument count */
1728 int i; /* next argument index */
1731 /* The builtin_info structure holds the FUNCTION_DECL of the standard builtin
1732 function, and a flag that says if the function is available implicitly, or
1733 whether the user has to code explicit calls to __builtin_<xxx>. */
1734 struct GTY(()) builtin_info_type {
1735 tree decl[(int)END_BUILTINS];
1736 bool implicit_p[(int)END_BUILTINS];
1740 /*---------------------------------------------------------------------------
1741 Global variables
1742 ---------------------------------------------------------------------------*/
1743 /* Matrix describing the structures contained in a given tree code. */
1744 extern unsigned char tree_contains_struct[MAX_TREE_CODES][64];
1746 /* Class of tree given its code. */
1747 extern const enum tree_code_class tree_code_type[];
1749 /* Each tree code class has an associated string representation.
1750 These must correspond to the tree_code_class entries. */
1751 extern const char *const tree_code_class_strings[];
1753 /* Number of argument-words in each kind of tree-node. */
1754 extern const unsigned char tree_code_length[];
1756 /* Names of tree components. */
1757 extern const char *const tree_code_name[];
1759 /* Vector of all alias pairs for global symbols. */
1760 extern GTY(()) vec<alias_pair, va_gc> *alias_pairs;
1762 /* Names of all the built_in classes. */
1763 extern const char *const built_in_class_names[BUILT_IN_LAST];
1765 /* Names of all the built_in functions. */
1766 extern const char * built_in_names[(int) END_BUILTINS];
1768 /* Number of operands and names for each OMP_CLAUSE node. */
1769 extern unsigned const char omp_clause_num_ops[];
1770 extern const char * const omp_clause_code_name[];
1772 /* A vector of all translation-units. */
1773 extern GTY (()) vec<tree, va_gc> *all_translation_units;
1775 /* Vector of standard trees used by the C compiler. */
1776 extern GTY(()) tree global_trees[TI_MAX];
1778 /* The standard C integer types. Use integer_type_kind to index into
1779 this array. */
1780 extern GTY(()) tree integer_types[itk_none];
1782 /* Types used to represent sizes. */
1783 extern GTY(()) tree sizetype_tab[(int) stk_type_kind_last];
1785 /* Arrays for keeping track of tree node statistics. */
1786 extern int tree_node_counts[];
1787 extern int tree_node_sizes[];
1789 /* True if we are in gimple form and the actions of the folders need to
1790 be restricted. False if we are not in gimple form and folding is not
1791 restricted to creating gimple expressions. */
1792 extern bool in_gimple_form;
1794 /* Functional interface to the builtin functions. */
1795 extern GTY(()) builtin_info_type builtin_info;
1797 /* If nonzero, an upper limit on alignment of structure fields, in bits, */
1798 extern unsigned int maximum_field_alignment;
1800 /* Nonzero means lvalues are limited to those valid in pedantic ANSI C.
1801 Zero means allow extended lvalues. */
1802 extern int pedantic_lvalues;
1804 /* Points to the FUNCTION_DECL of the function whose body we are reading. */
1805 extern GTY(()) tree current_function_decl;
1807 /* Nonzero means a FUNC_BEGIN label was emitted. */
1808 extern GTY(()) const char * current_function_func_begin_label;
1810 #endif // GCC_TREE_CORE_H