gcc/flag-types.h

   1 /* Compilation switch flag type definitions for GCC.
   2    Copyright (C) 1987-2024 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 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/>.  */
  19
  20 #ifndef GCC_FLAG_TYPES_H
  21 #define GCC_FLAG_TYPES_H
  22
  23 #if !defined(IN_LIBGCC2) && !defined(IN_TARGET_LIBS) && !defined(IN_RTS)
  24
  25 enum debug_info_type
  26 {
  27   DINFO_TYPE_NONE,                /* No debug info.  */
  28   DINFO_TYPE_DWARF2,              /* Dwarf v2 debug info.  */
  29   DINFO_TYPE_VMS,                 /* VMS debug info.  */
  30   DINFO_TYPE_CTF,                 /* CTF debug info.  */
  31   DINFO_TYPE_BTF,                 /* BTF debug info.  */
  32   DINFO_TYPE_BTF_WITH_CORE,       /* BTF debug info with CO-RE relocations.  */
  33   DINFO_TYPE_MAX = DINFO_TYPE_BTF_WITH_CORE /* Marker only.  */
  34 };
  35
  36 #define NO_DEBUG      (0U)
  37 /* Write DWARF2 debug info (using dwarf2out.cc).  */
  38 #define DWARF2_DEBUG  (1U << DINFO_TYPE_DWARF2)
  39 /* Write VMS debug info (using vmsdbgout.cc).  */
  40 #define VMS_DEBUG     (1U << DINFO_TYPE_VMS)
  41 /* Write CTF debug info (using ctfout.cc).  */
  42 #define CTF_DEBUG     (1U << DINFO_TYPE_CTF)
  43 /* Write BTF debug info (using btfout.cc).  */
  44 #define BTF_DEBUG     (1U << DINFO_TYPE_BTF)
  45 /* Write BTF debug info for BPF CO-RE usecase (using btfout.cc).  */
  46 #define BTF_WITH_CORE_DEBUG     (1U << DINFO_TYPE_BTF_WITH_CORE)
  47
  48 /* Note: Adding new definitions to handle -combination- of debug formats,
  49    like VMS_AND_DWARF2_DEBUG is not recommended.  This definition remains
  50    here for historical reasons.  */
  51 /* Write VMS debug info (using vmsdbgout.cc) and DWARF v2 debug info (using
  52    dwarf2out.cc).  */
  53 #define VMS_AND_DWARF2_DEBUG  ((VMS_DEBUG | DWARF2_DEBUG))
  54
  55 enum debug_info_levels
  56 {
  57   DINFO_LEVEL_NONE,     /* Write no debugging info.  */
  58   DINFO_LEVEL_TERSE,    /* Write minimal info to support tracebacks only.  */
  59   DINFO_LEVEL_NORMAL,   /* Write info for all declarations (and line table).  */
  60   DINFO_LEVEL_VERBOSE   /* Write normal info plus #define/#undef info.  */
  61 };
  62
  63 /* CTF debug info levels.
  64    CTF debug info levels are untied with DWARF debug info levels because CTF
  65    may co-exist with DWARF.  */
  66 enum ctf_debug_info_levels
  67 {
  68   CTFINFO_LEVEL_NONE = 0,     /* Write no CTF debug info.  */
  69   CTFINFO_LEVEL_TERSE = 1,    /* Write CTF information to support tracebacks
  70                                  only.  Not Implemented.  */
  71   CTFINFO_LEVEL_NORMAL = 2    /* Write CTF type information for all entities
  72                                  (functions, data objects, variables etc.)
  73                                  at file-scope or global-scope only.  */
  74 };
  75
  76 /* A major contribution to object and executable size is debug
  77    information size.  A major contribution to debug information
  78    size is struct descriptions replicated in several object files.
  79    The following function determines whether or not debug information
  80    should be generated for a given struct.  The indirect parameter
  81    indicates that the struct is being handled indirectly, via
  82    a pointer.  See opts.cc for the implementation. */
  83
  84 enum debug_info_usage
  85 {
  86   DINFO_USAGE_DFN,      /* A struct definition. */
  87   DINFO_USAGE_DIR_USE,  /* A direct use, such as the type of a variable. */
  88   DINFO_USAGE_IND_USE,  /* An indirect use, such as through a pointer. */
  89   DINFO_USAGE_NUM_ENUMS /* The number of enumerators. */
  90 };
  91
  92 /* A major contribution to object and executable size is debug
  93    information size.  A major contribution to debug information size
  94    is struct descriptions replicated in several object files. The
  95    following flags attempt to reduce this information.  The basic
  96    idea is to not emit struct debugging information in the current
  97    compilation unit when that information will be generated by
  98    another compilation unit.
  99
 100    Debug information for a struct defined in the current source
 101    file should be generated in the object file.  Likewise the
 102    debug information for a struct defined in a header should be
 103    generated in the object file of the corresponding source file.
 104    Both of these case are handled when the base name of the file of
 105    the struct definition matches the base name of the source file
 106    of the current compilation unit.  This matching emits minimal
 107    struct debugging information.
 108
 109    The base file name matching rule above will fail to emit debug
 110    information for structs defined in system headers.  So a second
 111    category of files includes system headers in addition to files
 112    with matching bases.
 113
 114    The remaining types of files are library headers and application
 115    headers.  We cannot currently distinguish these two types.  */
 116
 117 enum debug_struct_file
 118 {
 119   DINFO_STRUCT_FILE_NONE,   /* Debug no structs. */
 120   DINFO_STRUCT_FILE_BASE,   /* Debug structs defined in files with the
 121                                same base name as the compilation unit. */
 122   DINFO_STRUCT_FILE_SYS,    /* Also debug structs defined in system
 123                                header files.  */
 124   DINFO_STRUCT_FILE_ANY     /* Debug structs defined in all files. */
 125 };
 126
 127 /* Balance between GNAT encodings and standard DWARF to emit.  */
 128
 129 enum dwarf_gnat_encodings
 130 {
 131   DWARF_GNAT_ENCODINGS_ALL = 0,     /* Emit all GNAT encodings, then emit as
 132                                        much standard DWARF as possible so it
 133                                        does not conflict with GNAT
 134                                        encodings.  */
 135   DWARF_GNAT_ENCODINGS_GDB = 1,     /* Emit as much standard DWARF as possible
 136                                        as long as GDB handles them.  Emit GNAT
 137                                        encodings for the rest.  */
 138   DWARF_GNAT_ENCODINGS_MINIMAL = 2  /* Emit all the standard DWARF we can.
 139                                        Emit GNAT encodings for the rest.  */
 140 };
 141
 142 /* Enumerate Objective-c instance variable visibility settings. */
 143
 144 enum ivar_visibility
 145 {
 146   IVAR_VISIBILITY_PRIVATE,
 147   IVAR_VISIBILITY_PROTECTED,
 148   IVAR_VISIBILITY_PUBLIC,
 149   IVAR_VISIBILITY_PACKAGE
 150 };
 151
 152 /* The stack reuse level.  */
 153 enum stack_reuse_level
 154 {
 155   SR_NONE,
 156   SR_NAMED_VARS,
 157   SR_ALL
 158 };
 159
 160 /* Control Flow Redundancy hardening options for noreturn calls.  */
 161 enum hardcfr_noret
 162 {
 163   HCFRNR_NEVER,
 164   HCFRNR_NOTHROW,
 165   HCFRNR_NO_XTHROW,
 166   HCFRNR_UNSPECIFIED,
 167   HCFRNR_ALWAYS,
 168 };
 169
 170 /* The live patching level.  */
 171 enum live_patching_level
 172 {
 173   LIVE_PATCHING_NONE = 0,
 174   LIVE_PATCHING_INLINE_ONLY_STATIC,
 175   LIVE_PATCHING_INLINE_CLONE
 176 };
 177
 178 /* The algorithm used for basic block reordering.  */
 179 enum reorder_blocks_algorithm
 180 {
 181   REORDER_BLOCKS_ALGORITHM_SIMPLE,
 182   REORDER_BLOCKS_ALGORITHM_STC
 183 };
 184
 185 /* The algorithm used for the integrated register allocator (IRA).  */
 186 enum ira_algorithm
 187 {
 188   IRA_ALGORITHM_CB,
 189   IRA_ALGORITHM_PRIORITY
 190 };
 191
 192 /* The regions used for the integrated register allocator (IRA).  */
 193 enum ira_region
 194 {
 195   IRA_REGION_ONE,
 196   IRA_REGION_ALL,
 197   IRA_REGION_MIXED,
 198 };
 199
 200 /* The options for excess precision.  */
 201 enum excess_precision
 202 {
 203   EXCESS_PRECISION_DEFAULT,
 204   EXCESS_PRECISION_FAST,
 205   EXCESS_PRECISION_STANDARD,
 206   EXCESS_PRECISION_FLOAT16
 207 };
 208
 209 /* The options for which values of FLT_EVAL_METHOD are permissible.  */
 210 enum permitted_flt_eval_methods
 211 {
 212   PERMITTED_FLT_EVAL_METHODS_DEFAULT,
 213   PERMITTED_FLT_EVAL_METHODS_TS_18661,
 214   PERMITTED_FLT_EVAL_METHODS_C11
 215 };
 216
 217 /* Type of stack check.
 218
 219    Stack checking is designed to detect infinite recursion and stack
 220    overflows for Ada programs.  Furthermore stack checking tries to ensure
 221    in that scenario that enough stack space is left to run a signal handler.
 222
 223    -fstack-check= does not prevent stack-clash style attacks.  For that
 224    you want -fstack-clash-protection.  */
 225 enum stack_check_type
 226 {
 227   /* Do not check the stack.  */
 228   NO_STACK_CHECK = 0,
 229
 230   /* Check the stack generically, i.e. assume no specific support
 231      from the target configuration files.  */
 232   GENERIC_STACK_CHECK,
 233
 234   /* Check the stack and rely on the target configuration files to
 235      check the static frame of functions, i.e. use the generic
 236      mechanism only for dynamic stack allocations.  */
 237   STATIC_BUILTIN_STACK_CHECK,
 238
 239   /* Check the stack and entirely rely on the target configuration
 240      files, i.e. do not use the generic mechanism at all.  */
 241   FULL_BUILTIN_STACK_CHECK
 242 };
 243
 244 /* Type of callgraph information.  */
 245 enum callgraph_info_type
 246 {
 247   /* No information.  */
 248   NO_CALLGRAPH_INFO = 0,
 249
 250   /* Naked callgraph.  */
 251   CALLGRAPH_INFO_NAKED = 1,
 252
 253   /* Callgraph decorated with stack usage information.  */
 254   CALLGRAPH_INFO_STACK_USAGE = 2,
 255
 256   /* Callgraph decoration with dynamic allocation information.  */
 257   CALLGRAPH_INFO_DYNAMIC_ALLOC = 4
 258 };
 259
 260 /* Floating-point contraction mode.  */
 261 enum fp_contract_mode {
 262   FP_CONTRACT_OFF = 0,
 263   FP_CONTRACT_ON = 1,
 264   FP_CONTRACT_FAST = 2
 265 };
 266
 267 /* Scalar storage order kind.  */
 268 enum scalar_storage_order_kind {
 269   SSO_NATIVE = 0,
 270   SSO_BIG_ENDIAN,
 271   SSO_LITTLE_ENDIAN
 272 };
 273
 274 /* Vectorizer cost-model.  Except for DEFAULT, the values are ordered from
 275    the most conservative to the least conservative.  */
 276 enum vect_cost_model {
 277   VECT_COST_MODEL_VERY_CHEAP = -3,
 278   VECT_COST_MODEL_CHEAP = -2,
 279   VECT_COST_MODEL_DYNAMIC = -1,
 280   VECT_COST_MODEL_UNLIMITED = 0,
 281   VECT_COST_MODEL_DEFAULT = 1
 282 };
 283
 284 /* Automatic variable initialization type.  */
 285 enum auto_init_type {
 286   AUTO_INIT_UNINITIALIZED = 0,
 287   AUTO_INIT_PATTERN = 1,
 288   AUTO_INIT_ZERO = 2
 289 };
 290
 291 /* Different instrumentation modes.  */
 292 enum sanitize_code {
 293   /* AddressSanitizer.  */
 294   SANITIZE_ADDRESS = 1UL << 0,
 295   SANITIZE_USER_ADDRESS = 1UL << 1,
 296   SANITIZE_KERNEL_ADDRESS = 1UL << 2,
 297   /* ThreadSanitizer.  */
 298   SANITIZE_THREAD = 1UL << 3,
 299   /* LeakSanitizer.  */
 300   SANITIZE_LEAK = 1UL << 4,
 301   /* UndefinedBehaviorSanitizer.  */
 302   SANITIZE_SHIFT_BASE = 1UL << 5,
 303   SANITIZE_SHIFT_EXPONENT = 1UL << 6,
 304   SANITIZE_DIVIDE = 1UL << 7,
 305   SANITIZE_UNREACHABLE = 1UL << 8,
 306   SANITIZE_VLA = 1UL << 9,
 307   SANITIZE_NULL = 1UL << 10,
 308   SANITIZE_RETURN = 1UL << 11,
 309   SANITIZE_SI_OVERFLOW = 1UL << 12,
 310   SANITIZE_BOOL = 1UL << 13,
 311   SANITIZE_ENUM = 1UL << 14,
 312   SANITIZE_FLOAT_DIVIDE = 1UL << 15,
 313   SANITIZE_FLOAT_CAST = 1UL << 16,
 314   SANITIZE_BOUNDS = 1UL << 17,
 315   SANITIZE_ALIGNMENT = 1UL << 18,
 316   SANITIZE_NONNULL_ATTRIBUTE = 1UL << 19,
 317   SANITIZE_RETURNS_NONNULL_ATTRIBUTE = 1UL << 20,
 318   SANITIZE_OBJECT_SIZE = 1UL << 21,
 319   SANITIZE_VPTR = 1UL << 22,
 320   SANITIZE_BOUNDS_STRICT = 1UL << 23,
 321   SANITIZE_POINTER_OVERFLOW = 1UL << 24,
 322   SANITIZE_BUILTIN = 1UL << 25,
 323   SANITIZE_POINTER_COMPARE = 1UL << 26,
 324   SANITIZE_POINTER_SUBTRACT = 1UL << 27,
 325   SANITIZE_HWADDRESS = 1UL << 28,
 326   SANITIZE_USER_HWADDRESS = 1UL << 29,
 327   SANITIZE_KERNEL_HWADDRESS = 1UL << 30,
 328   /* Shadow Call Stack.  */
 329   SANITIZE_SHADOW_CALL_STACK = 1UL << 31,
 330   SANITIZE_SHIFT = SANITIZE_SHIFT_BASE | SANITIZE_SHIFT_EXPONENT,
 331   SANITIZE_UNDEFINED = SANITIZE_SHIFT | SANITIZE_DIVIDE | SANITIZE_UNREACHABLE
 332                        | SANITIZE_VLA | SANITIZE_NULL | SANITIZE_RETURN
 333                        | SANITIZE_SI_OVERFLOW | SANITIZE_BOOL | SANITIZE_ENUM
 334                        | SANITIZE_BOUNDS | SANITIZE_ALIGNMENT
 335                        | SANITIZE_NONNULL_ATTRIBUTE
 336                        | SANITIZE_RETURNS_NONNULL_ATTRIBUTE
 337                        | SANITIZE_OBJECT_SIZE | SANITIZE_VPTR
 338                        | SANITIZE_POINTER_OVERFLOW | SANITIZE_BUILTIN,
 339   SANITIZE_UNDEFINED_NONDEFAULT = SANITIZE_FLOAT_DIVIDE | SANITIZE_FLOAT_CAST
 340                                   | SANITIZE_BOUNDS_STRICT
 341 };
 342
 343 /* Different settings for zeroing subset of registers.  */
 344 namespace zero_regs_flags {
 345   const unsigned int UNSET = 0;
 346   const unsigned int SKIP = 1UL << 0;
 347   const unsigned int ONLY_USED = 1UL << 1;
 348   const unsigned int ONLY_GPR = 1UL << 2;
 349   const unsigned int ONLY_ARG = 1UL << 3;
 350   const unsigned int ENABLED = 1UL << 4;
 351   const unsigned int LEAFY_MODE = 1UL << 5;
 352   const unsigned int USED_GPR_ARG = ENABLED | ONLY_USED | ONLY_GPR | ONLY_ARG;
 353   const unsigned int USED_GPR = ENABLED | ONLY_USED | ONLY_GPR;
 354   const unsigned int USED_ARG = ENABLED | ONLY_USED | ONLY_ARG;
 355   const unsigned int USED = ENABLED | ONLY_USED;
 356   const unsigned int ALL_GPR_ARG = ENABLED | ONLY_GPR | ONLY_ARG;
 357   const unsigned int ALL_GPR = ENABLED | ONLY_GPR;
 358   const unsigned int ALL_ARG = ENABLED | ONLY_ARG;
 359   const unsigned int ALL = ENABLED;
 360   const unsigned int LEAFY_GPR_ARG = ENABLED | LEAFY_MODE | ONLY_GPR | ONLY_ARG;
 361   const unsigned int LEAFY_GPR = ENABLED | LEAFY_MODE | ONLY_GPR;
 362   const unsigned int LEAFY_ARG = ENABLED | LEAFY_MODE | ONLY_ARG;
 363   const unsigned int LEAFY = ENABLED | LEAFY_MODE;
 364 }
 365
 366 /* Settings of flag_incremental_link.  */
 367 enum incremental_link {
 368   INCREMENTAL_LINK_NONE,
 369   /* Do incremental linking and produce binary.  */
 370   INCREMENTAL_LINK_NOLTO,
 371   /* Do incremental linking and produce IL.  */
 372   INCREMENTAL_LINK_LTO
 373 };
 374
 375 /* Different trace modes.  */
 376 enum sanitize_coverage_code {
 377   /* Trace PC.  */
 378   SANITIZE_COV_TRACE_PC = 1 << 0,
 379   /* Trace Comparison.  */
 380   SANITIZE_COV_TRACE_CMP = 1 << 1
 381 };
 382
 383 /* flag_vtable_verify initialization levels. */
 384 enum vtv_priority {
 385   VTV_NO_PRIORITY       = 0,  /* i.E. Do NOT do vtable verification. */
 386   VTV_STANDARD_PRIORITY = 1,
 387   VTV_PREINIT_PRIORITY  = 2
 388 };
 389
 390 /* flag_lto_partition initialization values.  */
 391 enum lto_partition_model {
 392   LTO_PARTITION_NONE = 0,
 393   LTO_PARTITION_ONE = 1,
 394   LTO_PARTITION_BALANCED = 2,
 395   LTO_PARTITION_1TO1 = 3,
 396   LTO_PARTITION_MAX = 4
 397 };
 398
 399 /* flag_lto_linker_output initialization values.  */
 400 enum lto_linker_output {
 401   LTO_LINKER_OUTPUT_UNKNOWN,
 402   LTO_LINKER_OUTPUT_REL,
 403   LTO_LINKER_OUTPUT_NOLTOREL,
 404   LTO_LINKER_OUTPUT_DYN,
 405   LTO_LINKER_OUTPUT_PIE,
 406   LTO_LINKER_OUTPUT_EXEC
 407 };
 408
 409 /* gfortran -finit-real= values.  */
 410
 411 enum gfc_init_local_real
 412 {
 413   GFC_INIT_REAL_OFF = 0,
 414   GFC_INIT_REAL_ZERO,
 415   GFC_INIT_REAL_NAN,
 416   GFC_INIT_REAL_SNAN,
 417   GFC_INIT_REAL_INF,
 418   GFC_INIT_REAL_NEG_INF
 419 };
 420
 421 /* gfortran -fcoarray= values.  */
 422
 423 enum gfc_fcoarray
 424 {
 425   GFC_FCOARRAY_NONE = 0,
 426   GFC_FCOARRAY_SINGLE,
 427   GFC_FCOARRAY_LIB
 428 };
 429
 430
 431 /* gfortran -fconvert= values; used for unformatted I/O.
 432    Keep in sync with GFC_CONVERT_* in gcc/fortran/libgfortran.h.   */
 433 enum gfc_convert
 434 {
 435   GFC_FLAG_CONVERT_NATIVE = 0,
 436   GFC_FLAG_CONVERT_SWAP,
 437   GFC_FLAG_CONVERT_BIG,
 438   GFC_FLAG_CONVERT_LITTLE,
 439   GFC_FLAG_CONVERT_R16_IEEE = 4,
 440   GFC_FLAG_CONVERT_R16_IEEE_SWAP,
 441   GFC_FLAG_CONVERT_R16_IEEE_BIG,
 442   GFC_FLAG_CONVERT_R16_IEEE_LITTLE,
 443   GFC_FLAG_CONVERT_R16_IBM = 8,
 444   GFC_FLAG_CONVERT_R16_IBM_SWAP,
 445   GFC_FLAG_CONVERT_R16_IBM_BIG,
 446   GFC_FLAG_CONVERT_R16_IBM_LITTLE,
 447 };
 448
 449
 450 /* Inline String Operations functions.  */
 451 enum ilsop_fn
 452 {
 453   ILSOP_NONE = 0,
 454   ILSOP_MEMSET = 1 << 0,
 455   ILSOP_MEMCPY = 1 << 1,
 456   ILSOP_MEMMOVE = 1 << 2,
 457   ILSOP_MEMCMP = 1 << 3,
 458   ILSOP_ALL = -1
 459 };
 460
 461 /* Control-Flow Protection values.  */
 462 enum cf_protection_level
 463 {
 464   CF_NONE = 0,
 465   CF_BRANCH = 1 << 0,
 466   CF_RETURN = 1 << 1,
 467   CF_FULL = CF_BRANCH | CF_RETURN,
 468   CF_SET = 1 << 2,
 469   CF_CHECK = 1 << 3
 470 };
 471
 472 /* Parloops schedule type.  */
 473 enum parloops_schedule_type
 474 {
 475   PARLOOPS_SCHEDULE_STATIC = 0,
 476   PARLOOPS_SCHEDULE_DYNAMIC,
 477   PARLOOPS_SCHEDULE_GUIDED,
 478   PARLOOPS_SCHEDULE_AUTO,
 479   PARLOOPS_SCHEDULE_RUNTIME
 480 };
 481
 482 /* Ranger debug mode.  */
 483 enum ranger_debug
 484 {
 485   RANGER_DEBUG_NONE = 0,
 486   RANGER_DEBUG_TRACE = 1,
 487   RANGER_DEBUG_CACHE = 2,
 488   RANGER_DEBUG_GORI = 4,
 489   RANGER_DEBUG_TRACE_GORI = (RANGER_DEBUG_TRACE | RANGER_DEBUG_GORI),
 490   RANGER_DEBUG_TRACE_CACHE = (RANGER_DEBUG_TRACE | RANGER_DEBUG_CACHE),
 491   RANGER_DEBUG_ALL = (RANGER_DEBUG_GORI | RANGER_DEBUG_CACHE
 492                       | RANGER_DEBUG_TRACE)
 493 };
 494
 495 /* Jump threader verbose dumps.  */
 496 enum threader_debug
 497 {
 498   THREADER_DEBUG_NONE = 0,
 499   THREADER_DEBUG_ALL = 1
 500 };
 501
 502 /* Modes of OpenACC 'kernels' constructs handling.  */
 503 enum openacc_kernels
 504 {
 505   OPENACC_KERNELS_DECOMPOSE,
 506   OPENACC_KERNELS_PARLOOPS
 507 };
 508
 509 /* Modes of OpenACC privatization diagnostics.  */
 510 enum openacc_privatization
 511 {
 512   OPENACC_PRIVATIZATION_QUIET,
 513   OPENACC_PRIVATIZATION_NOISY
 514 };
 515
 516 /* Targets for -fopenmp-target-simd-clone.  */
 517 enum omp_target_simd_clone_device_kind
 518 {
 519   OMP_TARGET_SIMD_CLONE_NONE = 0,
 520   OMP_TARGET_SIMD_CLONE_HOST = 1,
 521   OMP_TARGET_SIMD_CLONE_NOHOST = 2,
 522   OMP_TARGET_SIMD_CLONE_ANY = 3
 523 };
 524
 525 #endif
 526
 527 #endif /* ! GCC_FLAG_TYPES_H */