gcc/coretypes.h

   1 /* GCC core type declarations.
   2    Copyright (C) 2002-2020 Free Software Foundation, Inc.
   3
   4 This file is part of GCC.
   5
   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.
  10
  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.
  15
  16 Under Section 7 of GPL version 3, you are granted additional
  17 permissions described in the GCC Runtime Library Exception, version
  18 3.1, as published by the Free Software Foundation.
  19
  20 You should have received a copy of the GNU General Public License and
  21 a copy of the GCC Runtime Library Exception along with this program;
  22 see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
  23 <http://www.gnu.org/licenses/>.  */
  24
  25 /* Provide forward declarations of core types which are referred to by
  26    most of the compiler.  This allows header files to use these types
  27    (e.g. in function prototypes) without concern for whether the full
  28    definitions are visible.  Some other declarations that need to be
  29    universally visible are here, too.
  30
  31    In the context of tconfig.h, most of these have special definitions
  32    which prevent them from being used except in further type
  33    declarations.  This is a kludge; the right thing is to avoid
  34    including the "tm.h" header set in the context of tconfig.h, but
  35    we're not there yet.  */
  36
  37 #ifndef GCC_CORETYPES_H
  38 #define GCC_CORETYPES_H
  39
  40 #ifndef GTY
  41 #define GTY(x)  /* nothing - marker for gengtype */
  42 #endif
  43
  44 #ifndef USED_FOR_TARGET
  45
  46 typedef int64_t gcov_type;
  47 typedef uint64_t gcov_type_unsigned;
  48
  49 struct bitmap_obstack;
  50 class bitmap_head;
  51 typedef class bitmap_head *bitmap;
  52 typedef const class bitmap_head *const_bitmap;
  53 struct simple_bitmap_def;
  54 typedef struct simple_bitmap_def *sbitmap;
  55 typedef const struct simple_bitmap_def *const_sbitmap;
  56 struct rtx_def;
  57 typedef struct rtx_def *rtx;
  58 typedef const struct rtx_def *const_rtx;
  59 class scalar_mode;
  60 class scalar_int_mode;
  61 class scalar_float_mode;
  62 class complex_mode;
  63 class fixed_size_mode;
  64 template<typename> class opt_mode;
  65 typedef opt_mode<scalar_mode> opt_scalar_mode;
  66 typedef opt_mode<scalar_int_mode> opt_scalar_int_mode;
  67 typedef opt_mode<scalar_float_mode> opt_scalar_float_mode;
  68 template<typename> struct pod_mode;
  69 typedef pod_mode<scalar_mode> scalar_mode_pod;
  70 typedef pod_mode<scalar_int_mode> scalar_int_mode_pod;
  71 typedef pod_mode<fixed_size_mode> fixed_size_mode_pod;
  72
  73 /* Subclasses of rtx_def, using indentation to show the class
  74    hierarchy, along with the relevant invariant.
  75    Where possible, keep this list in the same order as in rtl.def.  */
  76 struct rtx_def;
  77   struct rtx_expr_list;           /* GET_CODE (X) == EXPR_LIST */
  78   struct rtx_insn_list;           /* GET_CODE (X) == INSN_LIST */
  79   struct rtx_sequence;            /* GET_CODE (X) == SEQUENCE */
  80   struct rtx_insn;
  81     struct rtx_debug_insn;      /* DEBUG_INSN_P (X) */
  82     struct rtx_nonjump_insn;    /* NONJUMP_INSN_P (X) */
  83     struct rtx_jump_insn;       /* JUMP_P (X) */
  84     struct rtx_call_insn;       /* CALL_P (X) */
  85     struct rtx_jump_table_data; /* JUMP_TABLE_DATA_P (X) */
  86     struct rtx_barrier;         /* BARRIER_P (X) */
  87     struct rtx_code_label;      /* LABEL_P (X) */
  88     struct rtx_note;            /* NOTE_P (X) */
  89
  90 struct rtvec_def;
  91 typedef struct rtvec_def *rtvec;
  92 typedef const struct rtvec_def *const_rtvec;
  93 struct hwivec_def;
  94 typedef struct hwivec_def *hwivec;
  95 typedef const struct hwivec_def *const_hwivec;
  96 union tree_node;
  97 typedef union tree_node *tree;
  98 typedef const union tree_node *const_tree;
  99 struct gimple;
 100 typedef gimple *gimple_seq;
 101 struct gimple_stmt_iterator;
 102
 103 /* Forward decls for leaf gimple subclasses (for individual gimple codes).
 104    Keep this in the same order as the corresponding codes in gimple.def.  */
 105
 106 struct gcond;
 107 struct gdebug;
 108 struct ggoto;
 109 struct glabel;
 110 struct gswitch;
 111 struct gassign;
 112 struct gasm;
 113 struct gcall;
 114 struct gtransaction;
 115 struct greturn;
 116 struct gbind;
 117 struct gcatch;
 118 struct geh_filter;
 119 struct geh_mnt;
 120 struct geh_else;
 121 struct gresx;
 122 struct geh_dispatch;
 123 struct gphi;
 124 struct gtry;
 125 struct gomp_atomic_load;
 126 struct gomp_atomic_store;
 127 struct gomp_continue;
 128 struct gomp_critical;
 129 struct gomp_ordered;
 130 struct gomp_for;
 131 struct gomp_parallel;
 132 struct gomp_task;
 133 struct gomp_sections;
 134 struct gomp_single;
 135 struct gomp_target;
 136 struct gomp_teams;
 137
 138 /* Subclasses of symtab_node, using indentation to show the class
 139    hierarchy.  */
 140
 141 struct symtab_node;
 142   struct cgraph_node;
 143   struct varpool_node;
 144 struct cgraph_edge;
 145
 146 union section;
 147 typedef union section section;
 148 struct gcc_options;
 149 struct cl_target_option;
 150 struct cl_optimization;
 151 struct cl_option;
 152 struct cl_decoded_option;
 153 struct cl_option_handlers;
 154 struct diagnostic_context;
 155 class pretty_printer;
 156 class diagnostic_event_id_t;
 157
 158 template<typename T> struct array_traits;
 159
 160 /* Provides a read-only bitmap view of a single integer bitmask or an
 161    array of integer bitmasks, or of a wrapper around such bitmasks.  */
 162 template<typename T, typename Traits = array_traits<T>,
 163          bool has_constant_size = Traits::has_constant_size>
 164 class bitmap_view;
 165
 166 /* Address space number for named address space support.  */
 167 typedef unsigned char addr_space_t;
 168
 169 /* The value of addr_space_t that represents the generic address space.  */
 170 #define ADDR_SPACE_GENERIC 0
 171 #define ADDR_SPACE_GENERIC_P(AS) ((AS) == ADDR_SPACE_GENERIC)
 172
 173 /* The major intermediate representations of GCC.  */
 174 enum ir_type {
 175   IR_GIMPLE,
 176   IR_RTL_CFGRTL,
 177   IR_RTL_CFGLAYOUT
 178 };
 179
 180 /* Provide forward struct declaration so that we don't have to include
 181    all of cpplib.h whenever a random prototype includes a pointer.
 182    Note that the cpp_reader and cpp_token typedefs remain part of
 183    cpplib.h.  */
 184
 185 struct cpp_reader;
 186 struct cpp_token;
 187
 188 /* The thread-local storage model associated with a given VAR_DECL
 189    or SYMBOL_REF.  This isn't used much, but both trees and RTL refer
 190    to it, so it's here.  */
 191 enum tls_model {
 192   TLS_MODEL_NONE,
 193   TLS_MODEL_EMULATED,
 194   TLS_MODEL_REAL,
 195   TLS_MODEL_GLOBAL_DYNAMIC = TLS_MODEL_REAL,
 196   TLS_MODEL_LOCAL_DYNAMIC,
 197   TLS_MODEL_INITIAL_EXEC,
 198   TLS_MODEL_LOCAL_EXEC
 199 };
 200
 201 /* Types of ABI for an offload compiler.  */
 202 enum offload_abi {
 203   OFFLOAD_ABI_UNSET,
 204   OFFLOAD_ABI_LP64,
 205   OFFLOAD_ABI_ILP32
 206 };
 207
 208 /* Types of profile update methods.  */
 209 enum profile_update {
 210   PROFILE_UPDATE_SINGLE,
 211   PROFILE_UPDATE_ATOMIC,
 212   PROFILE_UPDATE_PREFER_ATOMIC
 213 };
 214
 215 /* Type of profile reproducibility methods.  */
 216 enum profile_reproducibility {
 217     PROFILE_REPRODUCIBILITY_SERIAL,
 218     PROFILE_REPRODUCIBILITY_PARALLEL_RUNS,
 219     PROFILE_REPRODUCIBILITY_MULTITHREADED
 220 };
 221
 222 /* Type of -fstack-protector-*.  */
 223 enum stack_protector {
 224   SPCT_FLAG_DEFAULT = 1,
 225   SPCT_FLAG_ALL = 2,
 226   SPCT_FLAG_STRONG = 3,
 227   SPCT_FLAG_EXPLICIT = 4
 228 };
 229
 230 /* Types of unwind/exception handling info that can be generated.  */
 231
 232 enum unwind_info_type
 233 {
 234   UI_NONE,
 235   UI_SJLJ,
 236   UI_DWARF2,
 237   UI_TARGET,
 238   UI_SEH
 239 };
 240
 241 /* Callgraph node profile representation.  */
 242 enum node_frequency {
 243   /* This function most likely won't be executed at all.
 244      (set only when profile feedback is available or via function attribute). */
 245   NODE_FREQUENCY_UNLIKELY_EXECUTED,
 246   /* For functions that are known to be executed once (i.e. constructors, destructors
 247      and main function.  */
 248   NODE_FREQUENCY_EXECUTED_ONCE,
 249   /* The default value.  */
 250   NODE_FREQUENCY_NORMAL,
 251   /* Optimize this function hard
 252      (set only when profile feedback is available or via function attribute). */
 253   NODE_FREQUENCY_HOT
 254 };
 255
 256 /* Ways of optimizing code.  */
 257 enum optimization_type {
 258   /* Prioritize speed over size.  */
 259   OPTIMIZE_FOR_SPEED,
 260
 261   /* Only do things that are good for both size and speed.  */
 262   OPTIMIZE_FOR_BOTH,
 263
 264   /* Prioritize size over speed.  */
 265   OPTIMIZE_FOR_SIZE
 266 };
 267
 268 /* Enumerates a padding direction.  */
 269 enum pad_direction {
 270   /* No padding is required.  */
 271   PAD_NONE,
 272
 273   /* Insert padding above the data, i.e. at higher memeory addresses
 274      when dealing with memory, and at the most significant end when
 275      dealing with registers.  */
 276   PAD_UPWARD,
 277
 278   /* Insert padding below the data, i.e. at lower memeory addresses
 279      when dealing with memory, and at the least significant end when
 280      dealing with registers.  */
 281   PAD_DOWNWARD
 282 };
 283
 284 /* Possible initialization status of a variable.   When requested
 285    by the user, this information is tracked and recorded in the DWARF
 286    debug information, along with the variable's location.  */
 287 enum var_init_status
 288 {
 289   VAR_INIT_STATUS_UNKNOWN,
 290   VAR_INIT_STATUS_UNINITIALIZED,
 291   VAR_INIT_STATUS_INITIALIZED
 292 };
 293
 294 /* Names for the different levels of -Wstrict-overflow=N.  The numeric
 295    values here correspond to N.  */
 296 enum warn_strict_overflow_code
 297 {
 298   /* Overflow warning that should be issued with -Wall: a questionable
 299      construct that is easy to avoid even when using macros.  Example:
 300      folding (x + CONSTANT > x) to 1.  */
 301   WARN_STRICT_OVERFLOW_ALL = 1,
 302   /* Overflow warning about folding a comparison to a constant because
 303      of undefined signed overflow, other than cases covered by
 304      WARN_STRICT_OVERFLOW_ALL.  Example: folding (abs (x) >= 0) to 1
 305      (this is false when x == INT_MIN).  */
 306   WARN_STRICT_OVERFLOW_CONDITIONAL = 2,
 307   /* Overflow warning about changes to comparisons other than folding
 308      them to a constant.  Example: folding (x + 1 > 1) to (x > 0).  */
 309   WARN_STRICT_OVERFLOW_COMPARISON = 3,
 310   /* Overflow warnings not covered by the above cases.  Example:
 311      folding ((x * 10) / 5) to (x * 2).  */
 312   WARN_STRICT_OVERFLOW_MISC = 4,
 313   /* Overflow warnings about reducing magnitude of constants in
 314      comparison.  Example: folding (x + 2 > y) to (x + 1 >= y).  */
 315   WARN_STRICT_OVERFLOW_MAGNITUDE = 5
 316 };
 317
 318 /* The type of an alias set.  Code currently assumes that variables of
 319    this type can take the values 0 (the alias set which aliases
 320    everything) and -1 (sometimes indicating that the alias set is
 321    unknown, sometimes indicating a memory barrier) and -2 (indicating
 322    that the alias set should be set to a unique value but has not been
 323    set yet).  */
 324 typedef int alias_set_type;
 325
 326 class edge_def;
 327 typedef class edge_def *edge;
 328 typedef const class edge_def *const_edge;
 329 struct basic_block_def;
 330 typedef struct basic_block_def *basic_block;
 331 typedef const struct basic_block_def *const_basic_block;
 332
 333 #if !defined (GENERATOR_FILE)
 334 # define OBSTACK_CHUNK_SIZE     memory_block_pool::block_size
 335 # define obstack_chunk_alloc    mempool_obstack_chunk_alloc
 336 # define obstack_chunk_free     mempool_obstack_chunk_free
 337 #else
 338 # define OBSTACK_CHUNK_SIZE     0
 339 # define obstack_chunk_alloc    xmalloc
 340 # define obstack_chunk_free     free
 341 #endif
 342
 343 #define gcc_obstack_init(OBSTACK)                               \
 344   obstack_specify_allocation ((OBSTACK), OBSTACK_CHUNK_SIZE, 0, \
 345                               obstack_chunk_alloc,              \
 346                               obstack_chunk_free)
 347
 348 /* enum reg_class is target specific, so it should not appear in
 349    target-independent code or interfaces, like the target hook declarations
 350    in target.h.  */
 351 typedef int reg_class_t;
 352
 353 class rtl_opt_pass;
 354
 355 namespace gcc {
 356   class context;
 357 }
 358
 359 typedef std::pair <tree, tree> tree_pair;
 360 typedef std::pair <const char *, int> string_int_pair;
 361
 362 /* Define a name->value mapping.  */
 363 template <typename ValueType>
 364 struct kv_pair
 365 {
 366   const char *const name;       /* the name of the value */
 367   const ValueType value;        /* the value of the name */
 368 };
 369
 370 /* Iterator pair used for a collection iteration with range-based loops.  */
 371
 372 template<typename T>
 373 struct iterator_range
 374 {
 375 public:
 376   iterator_range (const T &begin, const T &end)
 377     : m_begin (begin), m_end (end) {}
 378
 379   T begin () const { return m_begin; }
 380   T end () const { return m_end; }
 381
 382 private:
 383   T m_begin;
 384   T m_end;
 385 };
 386
 387 #else
 388
 389 struct _dont_use_rtx_here_;
 390 struct _dont_use_rtvec_here_;
 391 struct _dont_use_rtx_insn_here_;
 392 union _dont_use_tree_here_;
 393 #define rtx struct _dont_use_rtx_here_ *
 394 #define const_rtx struct _dont_use_rtx_here_ *
 395 #define rtvec struct _dont_use_rtvec_here *
 396 #define const_rtvec struct _dont_use_rtvec_here *
 397 #define rtx_insn struct _dont_use_rtx_insn_here_
 398 #define tree union _dont_use_tree_here_ *
 399 #define const_tree union _dont_use_tree_here_ *
 400
 401 typedef struct scalar_mode scalar_mode;
 402 typedef struct scalar_int_mode scalar_int_mode;
 403 typedef struct scalar_float_mode scalar_float_mode;
 404 typedef struct complex_mode complex_mode;
 405
 406 #endif
 407
 408 /* Classes of functions that compiler needs to check
 409    whether they are present at the runtime or not.  */
 410 enum function_class {
 411   function_c94,
 412   function_c99_misc,
 413   function_c99_math_complex,
 414   function_sincos,
 415   function_c11_misc,
 416   function_c2x_misc
 417 };
 418
 419 /* Enumerate visibility settings.  This is deliberately ordered from most
 420    to least visibility.  */
 421 enum symbol_visibility
 422 {
 423   VISIBILITY_DEFAULT,
 424   VISIBILITY_PROTECTED,
 425   VISIBILITY_HIDDEN,
 426   VISIBILITY_INTERNAL
 427 };
 428
 429 /* enums used by the targetm.excess_precision hook.  */
 430
 431 enum flt_eval_method
 432 {
 433   FLT_EVAL_METHOD_UNPREDICTABLE = -1,
 434   FLT_EVAL_METHOD_PROMOTE_TO_FLOAT = 0,
 435   FLT_EVAL_METHOD_PROMOTE_TO_DOUBLE = 1,
 436   FLT_EVAL_METHOD_PROMOTE_TO_LONG_DOUBLE = 2,
 437   FLT_EVAL_METHOD_PROMOTE_TO_FLOAT16 = 16
 438 };
 439
 440 enum excess_precision_type
 441 {
 442   EXCESS_PRECISION_TYPE_IMPLICIT,
 443   EXCESS_PRECISION_TYPE_STANDARD,
 444   EXCESS_PRECISION_TYPE_FAST
 445 };
 446
 447 /* Level of size optimization.  */
 448
 449 enum optimize_size_level
 450 {
 451   /* Do not optimize for size.  */
 452   OPTIMIZE_SIZE_NO,
 453   /* Optimize for size but not at extreme performance costs.  */
 454   OPTIMIZE_SIZE_BALANCED,
 455   /* Optimize for size as much as possible.  */
 456   OPTIMIZE_SIZE_MAX
 457 };
 458
 459 /* Support for user-provided GGC and PCH markers.  The first parameter
 460    is a pointer to a pointer, the second a cookie.  */
 461 typedef void (*gt_pointer_operator) (void *, void *);
 462
 463 #if !defined (HAVE_UCHAR)
 464 typedef unsigned char uchar;
 465 #endif
 466
 467 /* Most source files will require the following headers.  */
 468 #if !defined (USED_FOR_TARGET)
 469 #include "insn-modes.h"
 470 #include "signop.h"
 471 #include "wide-int.h"
 472 #include "wide-int-print.h"
 473
 474 /* On targets that don't need polynomial offsets, target-specific code
 475    should be able to treat poly_int like a normal constant, with a
 476    conversion operator going from the former to the latter.  We also
 477    allow this for gencondmd.c for all targets, so that we can treat
 478    machine_modes as enums without causing build failures.  */
 479 #if (defined (IN_TARGET_CODE) \
 480      && (defined (USE_ENUM_MODES) || NUM_POLY_INT_COEFFS == 1))
 481 #define POLY_INT_CONVERSION 1
 482 #else
 483 #define POLY_INT_CONVERSION 0
 484 #endif
 485
 486 #include "poly-int.h"
 487 #include "poly-int-types.h"
 488 #include "insn-modes-inline.h"
 489 #include "machmode.h"
 490 #include "double-int.h"
 491 #include "align.h"
 492 /* Most host source files will require the following headers.  */
 493 #if !defined (GENERATOR_FILE)
 494 #include "real.h"
 495 #include "fixed-value.h"
 496 #include "hash-table.h"
 497 #include "hash-set.h"
 498 #include "input.h"
 499 #include "is-a.h"
 500 #include "memory-block.h"
 501 #include "dumpfile.h"
 502 #endif
 503 #endif /* GENERATOR_FILE && !USED_FOR_TARGET */
 504
 505 #endif /* coretypes.h */