contrib/llvm/tools/clang/include/clang/Frontend/CodeGenOptions.def

   1 //===--- CodeGenOptions.def - Code generation option database ----- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This file defines the code generation options. Users of this file
  11 // must define the CODEGENOPT macro to make use of this information.
  12 // Optionally, the user may also define ENUM_CODEGENOPT (for options
  13 // that have enumeration type and VALUE_CODEGENOPT is a code
  14 // generation option that describes a value rather than a flag.
  15 //
  16 //===----------------------------------------------------------------------===//
  17 #ifndef CODEGENOPT
  18 #  error Define the CODEGENOPT macro to handle language options
  19 #endif
  20
  21 #ifndef VALUE_CODEGENOPT
  22 #  define VALUE_CODEGENOPT(Name, Bits, Default) \
  23 CODEGENOPT(Name, Bits, Default)
  24 #endif
  25
  26 #ifndef ENUM_CODEGENOPT
  27 #  define ENUM_CODEGENOPT(Name, Type, Bits, Default) \
  28 CODEGENOPT(Name, Bits, Default)
  29 #endif
  30
  31 CODEGENOPT(DisableIntegratedAS, 1, 0) ///< -no-integrated-as
  32 ENUM_CODEGENOPT(CompressDebugSections, llvm::DebugCompressionType, 2,
  33                 llvm::DebugCompressionType::None)
  34 CODEGENOPT(RelaxELFRelocations, 1, 0) ///< -Wa,--mrelax-relocations
  35 CODEGENOPT(AsmVerbose        , 1, 0) ///< -dA, -fverbose-asm.
  36 CODEGENOPT(PreserveAsmComments, 1, 1) ///< -dA, -fno-preserve-as-comments.
  37 CODEGENOPT(AssumeSaneOperatorNew , 1, 1) ///< implicit __attribute__((malloc)) operator new
  38 CODEGENOPT(Autolink          , 1, 1) ///< -fno-autolink
  39 CODEGENOPT(ObjCAutoRefCountExceptions , 1, 0) ///< Whether ARC should be EH-safe.
  40 CODEGENOPT(Backchain         , 1, 0) ///< -mbackchain
  41 CODEGENOPT(ControlFlowGuard  , 1, 0) ///< -cfguard
  42 CODEGENOPT(CoverageExtraChecksum, 1, 0) ///< Whether we need a second checksum for functions in GCNO files.
  43 CODEGENOPT(CoverageNoFunctionNamesInData, 1, 0) ///< Do not include function names in GCDA files.
  44 CODEGENOPT(CoverageExitBlockBeforeBody, 1, 0) ///< Whether to emit the exit block before the body blocks in GCNO files.
  45 CODEGENOPT(CXAAtExit         , 1, 1) ///< Use __cxa_atexit for calling destructors.
  46 CODEGENOPT(RegisterGlobalDtorsWithAtExit, 1, 1) ///< Use atexit or __cxa_atexit to register global destructors.
  47 CODEGENOPT(CXXCtorDtorAliases, 1, 0) ///< Emit complete ctors/dtors as linker
  48                                      ///< aliases to base ctors when possible.
  49 CODEGENOPT(DataSections      , 1, 0) ///< Set when -fdata-sections is enabled.
  50 CODEGENOPT(UniqueSectionNames, 1, 1) ///< Set for -funique-section-names.
  51 CODEGENOPT(DisableFPElim     , 1, 0) ///< Set when -fomit-frame-pointer is enabled.
  52 CODEGENOPT(DisableFree       , 1, 0) ///< Don't free memory.
  53 CODEGENOPT(DiscardValueNames , 1, 0) ///< Discard Value Names from the IR (LLVMContext flag)
  54 CODEGENOPT(DisableGCov       , 1, 0) ///< Don't run the GCov pass, for testing.
  55 CODEGENOPT(DisableLLVMPasses , 1, 0) ///< Don't run any LLVM IR passes to get
  56                                      ///< the pristine IR generated by the
  57                                      ///< frontend.
  58 CODEGENOPT(DisableLifetimeMarkers, 1, 0) ///< Don't emit any lifetime markers
  59 CODEGENOPT(DisableO0ImplyOptNone , 1, 0) ///< Don't annonate function with optnone at O0
  60 CODEGENOPT(ExperimentalNewPassManager, 1, 0) ///< Enables the new, experimental
  61                                              ///< pass manager.
  62 CODEGENOPT(DebugPassManager, 1, 0) ///< Prints debug information for the new
  63                                    ///< pass manager.
  64 CODEGENOPT(DisableRedZone    , 1, 0) ///< Set when -mno-red-zone is enabled.
  65 CODEGENOPT(DisableTailCalls  , 1, 0) ///< Do not emit tail calls.
  66 CODEGENOPT(NoEscapingBlockTailCalls, 1, 0) ///< Do not emit tail calls from
  67                                            ///< escaping blocks.
  68 CODEGENOPT(EmitDeclMetadata  , 1, 0) ///< Emit special metadata indicating what
  69                                      ///< Decl* various IR entities came from.
  70                                      ///< Only useful when running CodeGen as a
  71                                      ///< subroutine.
  72 CODEGENOPT(EmitVersionIdentMetadata , 1, 1) ///< Emit compiler version metadata.
  73 CODEGENOPT(EmitGcovArcs      , 1, 0) ///< Emit coverage data files, aka. GCDA.
  74 CODEGENOPT(EmitGcovNotes     , 1, 0) ///< Emit coverage "notes" files, aka GCNO.
  75 CODEGENOPT(EmitOpenCLArgMetadata , 1, 0) ///< Emit OpenCL kernel arg metadata.
  76 CODEGENOPT(EmulatedTLS       , 1, 0) ///< Set by default or -f[no-]emulated-tls.
  77 CODEGENOPT(ExplicitEmulatedTLS , 1, 0) ///< Set if -f[no-]emulated-tls is used.
  78 /// Embed Bitcode mode (off/all/bitcode/marker).
  79 ENUM_CODEGENOPT(EmbedBitcode, EmbedBitcodeKind, 2, Embed_Off)
  80 CODEGENOPT(ForbidGuardVariables , 1, 0) ///< Issue errors if C++ guard variables
  81                                         ///< are required.
  82 CODEGENOPT(FunctionSections  , 1, 0) ///< Set when -ffunction-sections is enabled.
  83 CODEGENOPT(InstrumentFunctions , 1, 0) ///< Set when -finstrument-functions is
  84                                        ///< enabled.
  85 CODEGENOPT(InstrumentFunctionsAfterInlining , 1, 0) ///< Set when
  86                           ///< -finstrument-functions-after-inlining is enabled.
  87 CODEGENOPT(InstrumentFunctionEntryBare , 1, 0) ///< Set when
  88                                ///< -finstrument-function-entry-bare is enabled.
  89 CODEGENOPT(CFProtectionReturn , 1, 0) ///< if -fcf-protection is
  90                                       ///< set to full or return.
  91 CODEGENOPT(CFProtectionBranch , 1, 0) ///< if -fcf-protection is
  92                                       ///< set to full or branch.
  93 CODEGENOPT(XRayInstrumentFunctions , 1, 0) ///< Set when -fxray-instrument is
  94                                            ///< enabled.
  95 CODEGENOPT(StackSizeSection  , 1, 0) ///< Set when -fstack-size-section is enabled.
  96
  97 ///< Set when -fxray-always-emit-customevents is enabled.
  98 CODEGENOPT(XRayAlwaysEmitCustomEvents , 1, 0)
  99
 100 ///< Set when -fxray-always-emit-typedevents is enabled.
 101 CODEGENOPT(XRayAlwaysEmitTypedEvents , 1, 0)
 102
 103 ///< Set the minimum number of instructions in a function to determine selective
 104 ///< XRay instrumentation.
 105 VALUE_CODEGENOPT(XRayInstructionThreshold , 32, 200)
 106
 107 CODEGENOPT(InstrumentForProfiling , 1, 0) ///< Set when -pg is enabled.
 108 CODEGENOPT(CallFEntry , 1, 0) ///< Set when -mfentry is enabled.
 109 CODEGENOPT(LessPreciseFPMAD  , 1, 0) ///< Enable less precise MAD instructions to
 110                                      ///< be generated.
 111 CODEGENOPT(PrepareForLTO     , 1, 0) ///< Set when -flto is enabled on the
 112                                      ///< compile step.
 113 CODEGENOPT(PrepareForThinLTO , 1, 0) ///< Set when -flto=thin is enabled on the
 114                                      ///< compile step.
 115 CODEGENOPT(LTOUnit, 1, 0) ///< Emit IR to support LTO unit features (CFI, whole
 116                           ///< program vtable opt).
 117 CODEGENOPT(IncrementalLinkerCompatible, 1, 0) ///< Emit an object file which can
 118                                               ///< be used with an incremental
 119                                               ///< linker.
 120 CODEGENOPT(MergeAllConstants , 1, 1) ///< Merge identical constants.
 121 CODEGENOPT(MergeFunctions    , 1, 0) ///< Set when -fmerge-functions is enabled.
 122 CODEGENOPT(MSVolatile        , 1, 0) ///< Set when /volatile:ms is enabled.
 123 CODEGENOPT(NoCommon          , 1, 0) ///< Set when -fno-common or C++ is enabled.
 124 CODEGENOPT(NoDwarfDirectoryAsm , 1, 0) ///< Set when -fno-dwarf-directory-asm is
 125                                        ///< enabled.
 126 CODEGENOPT(NoExecStack       , 1, 0) ///< Set when -Wa,--noexecstack is enabled.
 127 CODEGENOPT(FatalWarnings     , 1, 0) ///< Set when -Wa,--fatal-warnings is
 128                                      ///< enabled.
 129 CODEGENOPT(EnableSegmentedStacks , 1, 0) ///< Set when -fsplit-stack is enabled.
 130 CODEGENOPT(NoImplicitFloat   , 1, 0) ///< Set when -mno-implicit-float is enabled.
 131 CODEGENOPT(NoInfsFPMath      , 1, 0) ///< Assume FP arguments, results not +-Inf.
 132 CODEGENOPT(NoSignedZeros     , 1, 0) ///< Allow ignoring the signedness of FP zero
 133 CODEGENOPT(NullPointerIsValid , 1, 0) ///< Assume Null pointer deference is defined.
 134 CODEGENOPT(Reassociate       , 1, 0) ///< Allow reassociation of FP math ops
 135 CODEGENOPT(ReciprocalMath    , 1, 0) ///< Allow FP divisions to be reassociated.
 136 CODEGENOPT(NoTrappingMath    , 1, 0) ///< Set when -fno-trapping-math is enabled.
 137 CODEGENOPT(NoNaNsFPMath      , 1, 0) ///< Assume FP arguments, results not NaN.
 138 CODEGENOPT(FlushDenorm       , 1, 0) ///< Allow FP denorm numbers to be flushed to zero
 139 CODEGENOPT(CorrectlyRoundedDivSqrt, 1, 0) ///< -cl-fp32-correctly-rounded-divide-sqrt
 140
 141 /// When false, this attempts to generate code as if the result of an
 142 /// overflowing conversion matches the overflowing behavior of a target's native
 143 /// float-to-int conversion instructions.
 144 CODEGENOPT(StrictFloatCastOverflow, 1, 1)
 145
 146 CODEGENOPT(UniformWGSize     , 1, 0) ///< -cl-uniform-work-group-size
 147 CODEGENOPT(NoZeroInitializedInBSS , 1, 0) ///< -fno-zero-initialized-in-bss.
 148 /// Method of Objective-C dispatch to use.
 149 ENUM_CODEGENOPT(ObjCDispatchMethod, ObjCDispatchMethodKind, 2, Legacy)
 150 CODEGENOPT(OmitLeafFramePointer , 1, 0) ///< Set when -momit-leaf-frame-pointer is
 151                                         ///< enabled.
 152
 153 VALUE_CODEGENOPT(OptimizationLevel, 2, 0) ///< The -O[0-3] option specified.
 154 VALUE_CODEGENOPT(OptimizeSize, 2, 0) ///< If -Os (==1) or -Oz (==2) is specified.
 155
 156 /// Choose profile instrumenation kind or no instrumentation.
 157 ENUM_CODEGENOPT(ProfileInstr, ProfileInstrKind, 2, ProfileNone)
 158 /// Choose profile kind for PGO use compilation.
 159 ENUM_CODEGENOPT(ProfileUse, ProfileInstrKind, 2, ProfileNone)
 160 CODEGENOPT(CoverageMapping , 1, 0) ///< Generate coverage mapping regions to
 161                                    ///< enable code coverage analysis.
 162 CODEGENOPT(DumpCoverageMapping , 1, 0) ///< Dump the generated coverage mapping
 163                                        ///< regions.
 164
 165   /// If -fpcc-struct-return or -freg-struct-return is specified.
 166 ENUM_CODEGENOPT(StructReturnConvention, StructReturnConventionKind, 2, SRCK_Default)
 167
 168 CODEGENOPT(RelaxAll          , 1, 0) ///< Relax all machine code instructions.
 169 CODEGENOPT(RelaxedAliasing   , 1, 0) ///< Set when -fno-strict-aliasing is enabled.
 170 CODEGENOPT(StructPathTBAA    , 1, 0) ///< Whether or not to use struct-path TBAA.
 171 CODEGENOPT(NewStructPathTBAA , 1, 0) ///< Whether or not to use enhanced struct-path TBAA.
 172 CODEGENOPT(SaveTempLabels    , 1, 0) ///< Save temporary labels.
 173 CODEGENOPT(SanitizeAddressUseAfterScope , 1, 0) ///< Enable use-after-scope detection
 174                                                 ///< in AddressSanitizer
 175 CODEGENOPT(SanitizeAddressPoisonClassMemberArrayNewCookie, 1,
 176            0) ///< Enable poisoning operator new[] which is not a replaceable
 177               ///< global allocation function in AddressSanitizer
 178 CODEGENOPT(SanitizeAddressGlobalsDeadStripping, 1, 0) ///< Enable linker dead stripping
 179                                                       ///< of globals in AddressSanitizer
 180 CODEGENOPT(SanitizeMemoryTrackOrigins, 2, 0) ///< Enable tracking origins in
 181                                              ///< MemorySanitizer
 182 CODEGENOPT(SanitizeMemoryUseAfterDtor, 1, 0) ///< Enable use-after-delete detection
 183                                              ///< in MemorySanitizer
 184 CODEGENOPT(SanitizeCfiCrossDso, 1, 0) ///< Enable cross-dso support in CFI.
 185 CODEGENOPT(SanitizeMinimalRuntime, 1, 0) ///< Use "_minimal" sanitizer runtime for
 186                                          ///< diagnostics.
 187 CODEGENOPT(SanitizeCfiICallGeneralizePointers, 1, 0) ///< Generalize pointer types in
 188                                                      ///< CFI icall function signatures
 189 CODEGENOPT(SanitizeCoverageType, 2, 0) ///< Type of sanitizer coverage
 190                                        ///< instrumentation.
 191 CODEGENOPT(SanitizeCoverageIndirectCalls, 1, 0) ///< Enable sanitizer coverage
 192                                                 ///< for indirect calls.
 193 CODEGENOPT(SanitizeCoverageTraceBB, 1, 0) ///< Enable basic block tracing in
 194                                           ///< in sanitizer coverage.
 195 CODEGENOPT(SanitizeCoverageTraceCmp, 1, 0) ///< Enable cmp instruction tracing
 196                                            ///< in sanitizer coverage.
 197 CODEGENOPT(SanitizeCoverageTraceDiv, 1, 0) ///< Enable div instruction tracing
 198                                            ///< in sanitizer coverage.
 199 CODEGENOPT(SanitizeCoverageTraceGep, 1, 0) ///< Enable GEP instruction tracing
 200                                            ///< in sanitizer coverage.
 201 CODEGENOPT(SanitizeCoverage8bitCounters, 1, 0) ///< Use 8-bit frequency counters
 202                                                ///< in sanitizer coverage.
 203 CODEGENOPT(SanitizeCoverageTracePC, 1, 0) ///< Enable PC tracing
 204                                           ///< in sanitizer coverage.
 205 CODEGENOPT(SanitizeCoverageTracePCGuard, 1, 0) ///< Enable PC tracing with guard
 206                                                ///< in sanitizer coverage.
 207 CODEGENOPT(SanitizeCoverageInline8bitCounters, 1, 0) ///< Use inline 8bit counters.
 208 CODEGENOPT(SanitizeCoveragePCTable, 1, 0) ///< Create a PC Table.
 209 CODEGENOPT(SanitizeCoverageNoPrune, 1, 0) ///< Disable coverage pruning.
 210 CODEGENOPT(SanitizeCoverageStackDepth, 1, 0) ///< Enable max stack depth tracing
 211 CODEGENOPT(SanitizeStats     , 1, 0) ///< Collect statistics for sanitizers.
 212 CODEGENOPT(SimplifyLibCalls  , 1, 1) ///< Set when -fbuiltin is enabled.
 213 CODEGENOPT(SoftFloat         , 1, 0) ///< -soft-float.
 214 CODEGENOPT(FineGrainedBitfieldAccesses, 1, 0) ///< Enable fine-grained bitfield accesses.
 215 CODEGENOPT(StrictEnums       , 1, 0) ///< Optimize based on strict enum definition.
 216 CODEGENOPT(StrictVTablePointers, 1, 0) ///< Optimize based on the strict vtable pointers
 217 CODEGENOPT(TimePasses        , 1, 0) ///< Set when -ftime-report is enabled.
 218 CODEGENOPT(UnrollLoops       , 1, 0) ///< Control whether loops are unrolled.
 219 CODEGENOPT(RerollLoops       , 1, 0) ///< Control whether loops are rerolled.
 220 CODEGENOPT(NoUseJumpTables   , 1, 0) ///< Set when -fno-jump-tables is enabled.
 221 CODEGENOPT(UnsafeFPMath      , 1, 0) ///< Allow unsafe floating point optzns.
 222 CODEGENOPT(UnwindTables      , 1, 0) ///< Emit unwind tables.
 223 CODEGENOPT(VectorizeLoop     , 1, 0) ///< Run loop vectorizer.
 224 CODEGENOPT(VectorizeSLP      , 1, 0) ///< Run SLP vectorizer.
 225 CODEGENOPT(ProfileSampleAccurate, 1, 0) ///< Sample profile is accurate.
 226
 227   /// Attempt to use register sized accesses to bit-fields in structures, when
 228   /// possible.
 229 CODEGENOPT(UseRegisterSizedBitfieldAccess , 1, 0)
 230
 231 CODEGENOPT(VerifyModule      , 1, 1) ///< Control whether the module should be run
 232                                      ///< through the LLVM Verifier.
 233
 234 CODEGENOPT(StackRealignment  , 1, 0) ///< Control whether to force stack
 235                                      ///< realignment.
 236 CODEGENOPT(UseInitArray      , 1, 0) ///< Control whether to use .init_array or
 237                                      ///< .ctors.
 238 VALUE_CODEGENOPT(StackAlignment    , 32, 0) ///< Overrides default stack
 239                                             ///< alignment, if not 0.
 240 VALUE_CODEGENOPT(StackProbeSize    , 32, 4096) ///< Overrides default stack
 241                                                ///< probe size, even if 0.
 242 CODEGENOPT(NoStackArgProbe, 1, 0) ///< Set when -mno-stack-arg-probe is used
 243 CODEGENOPT(DebugColumnInfo, 1, 0) ///< Whether or not to use column information
 244                                   ///< in debug info.
 245
 246 CODEGENOPT(DebugTypeExtRefs, 1, 0) ///< Whether or not debug info should contain
 247                                    ///< external references to a PCH or module.
 248
 249 CODEGENOPT(DebugExplicitImport, 1, 0)  ///< Whether or not debug info should
 250                                        ///< contain explicit imports for
 251                                        ///< anonymous namespaces
 252 CODEGENOPT(EnableSplitDwarf, 1, 0) ///< Whether to enable split DWARF
 253 CODEGENOPT(SplitDwarfInlining, 1, 1) ///< Whether to include inlining info in the
 254                                      ///< skeleton CU to allow for symbolication
 255                                      ///< of inline stack frames without .dwo files.
 256 CODEGENOPT(DebugFwdTemplateParams, 1, 0) ///< Whether to emit complete
 257                                          ///< template parameter descriptions in
 258                                          ///< forward declarations (versus just
 259                                          ///< including them in the name).
 260
 261 CODEGENOPT(EmitLLVMUseLists, 1, 0) ///< Control whether to serialize use-lists.
 262
 263 CODEGENOPT(WholeProgramVTables, 1, 0) ///< Whether to apply whole-program
 264                                       ///  vtable optimization.
 265
 266 /// Whether to use public LTO visibility for entities in std and stdext
 267 /// namespaces. This is enabled by clang-cl's /MT and /MTd flags.
 268 CODEGENOPT(LTOVisibilityPublicStd, 1, 0)
 269
 270 /// The user specified number of registers to be used for integral arguments,
 271 /// or 0 if unspecified.
 272 VALUE_CODEGENOPT(NumRegisterParameters, 32, 0)
 273
 274 /// The lower bound for a buffer to be considered for stack protection.
 275 VALUE_CODEGENOPT(SSPBufferSize, 32, 0)
 276
 277 /// The kind of generated debug info.
 278 ENUM_CODEGENOPT(DebugInfo, codegenoptions::DebugInfoKind, 3, codegenoptions::NoDebugInfo)
 279
 280 /// Whether to generate macro debug info.
 281 CODEGENOPT(MacroDebugInfo, 1, 0)
 282
 283 /// Tune the debug info for this debugger.
 284 ENUM_CODEGENOPT(DebuggerTuning, llvm::DebuggerKind, 2,
 285                 llvm::DebuggerKind::Default)
 286
 287 /// Dwarf version. Version zero indicates to LLVM that no DWARF should be
 288 /// emitted.
 289 VALUE_CODEGENOPT(DwarfVersion, 3, 0)
 290
 291 /// Whether we should emit CodeView debug information. It's possible to emit
 292 /// CodeView and DWARF into the same object.
 293 CODEGENOPT(EmitCodeView, 1, 0)
 294
 295 /// The kind of inlining to perform.
 296 ENUM_CODEGENOPT(Inlining, InliningMethod, 2, NormalInlining)
 297
 298 // Vector functions library to use.
 299 ENUM_CODEGENOPT(VecLib, VectorLibrary, 2, NoLibrary)
 300
 301 /// The default TLS model to use.
 302 ENUM_CODEGENOPT(DefaultTLSModel, TLSModel, 2, GeneralDynamicTLSModel)
 303
 304 /// Number of path components to strip when emitting checks. (0 == full
 305 /// filename)
 306 VALUE_CODEGENOPT(EmitCheckPathComponentsToStrip, 32, 0)
 307
 308 /// Whether to report the hotness of the code region for optimization remarks.
 309 CODEGENOPT(DiagnosticsWithHotness, 1, 0)
 310
 311 /// The minimum hotness value a diagnostic needs in order to be included in
 312 /// optimization diagnostics.
 313 VALUE_CODEGENOPT(DiagnosticsHotnessThreshold, 32, 0)
 314
 315 /// Whether copy relocations support is available when building as PIE.
 316 CODEGENOPT(PIECopyRelocations, 1, 0)
 317
 318 /// Whether we should use the undefined behaviour optimization for control flow
 319 /// paths that reach the end of a function without executing a required return.
 320 CODEGENOPT(StrictReturn, 1, 1)
 321
 322 /// Whether emit extra debug info for sample pgo profile collection.
 323 CODEGENOPT(DebugInfoForProfiling, 1, 0)
 324
 325 /// Whether 3-component vector type is preserved.
 326 CODEGENOPT(PreserveVec3Type, 1, 0)
 327
 328 /// Whether to emit .debug_gnu_pubnames section instead of .debug_pubnames.
 329 CODEGENOPT(GnuPubnames, 1, 0)
 330
 331 CODEGENOPT(NoPLT, 1, 0)
 332
 333 /// Whether to embed source in DWARF debug line section.
 334 CODEGENOPT(EmbedSource, 1, 0)
 335
 336 /// Whether to emit all vtables
 337 CODEGENOPT(ForceEmitVTables, 1, 0)
 338
 339 /// Whether to emit an address-significance table into the object file.
 340 CODEGENOPT(Addrsig, 1, 0)
 341
 342
 343 #undef CODEGENOPT
 344 #undef ENUM_CODEGENOPT
 345 #undef VALUE_CODEGENOPT
 346