1 //===--- CodeGenOptions.def - Code generation option database ----- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
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.
16 //===----------------------------------------------------------------------===//
18 # error Define the CODEGENOPT macro to handle language options
21 #ifndef VALUE_CODEGENOPT
22 # define VALUE_CODEGENOPT(Name, Bits, Default) \
23 CODEGENOPT(Name, Bits, Default)
26 #ifndef ENUM_CODEGENOPT
27 # define ENUM_CODEGENOPT(Name, Type, Bits, Default) \
28 CODEGENOPT(Name, Bits, Default)
31 CODEGENOPT(DisableIntegratedAS, 1, 0) ///< -no-integrated-as
32 CODEGENOPT(CompressDebugSections, 1, 0) ///< -Wa,-compress-debug-sections
33 CODEGENOPT(RelaxELFRelocations, 1, 0) ///< -Wa,--mrelax-relocations
34 CODEGENOPT(AsmVerbose , 1, 0) ///< -dA, -fverbose-asm.
35 CODEGENOPT(PreserveAsmComments, 1, 1) ///< -dA, -fno-preserve-as-comments.
36 CODEGENOPT(AssumeSaneOperatorNew , 1, 1) ///< implicit __attribute__((malloc)) operator new
37 CODEGENOPT(Autolink , 1, 1) ///< -fno-autolink
38 CODEGENOPT(ObjCAutoRefCountExceptions , 1, 0) ///< Whether ARC should be EH-safe.
39 CODEGENOPT(Backchain , 1, 0) ///< -mbackchain
40 CODEGENOPT(CoverageExtraChecksum, 1, 0) ///< Whether we need a second checksum for functions in GCNO files.
41 CODEGENOPT(CoverageNoFunctionNamesInData, 1, 0) ///< Do not include function names in GCDA files.
42 CODEGENOPT(CoverageExitBlockBeforeBody, 1, 0) ///< Whether to emit the exit block before the body blocks in GCNO files.
43 CODEGENOPT(CXAAtExit , 1, 1) ///< Use __cxa_atexit for calling destructors.
44 CODEGENOPT(CXXCtorDtorAliases, 1, 0) ///< Emit complete ctors/dtors as linker
45 ///< aliases to base ctors when possible.
46 CODEGENOPT(DataSections , 1, 0) ///< Set when -fdata-sections is enabled.
47 CODEGENOPT(UniqueSectionNames, 1, 1) ///< Set for -funique-section-names.
48 CODEGENOPT(DisableFPElim , 1, 0) ///< Set when -fomit-frame-pointer is enabled.
49 CODEGENOPT(DisableFree , 1, 0) ///< Don't free memory.
50 CODEGENOPT(DiscardValueNames , 1, 0) ///< Discard Value Names from the IR (LLVMContext flag)
51 CODEGENOPT(DisableGCov , 1, 0) ///< Don't run the GCov pass, for testing.
52 CODEGENOPT(DisableLLVMPasses , 1, 0) ///< Don't run any LLVM IR passes to get
53 ///< the pristine IR generated by the
55 CODEGENOPT(DisableLifetimeMarkers, 1, 0) ///< Don't emit any lifetime markers
56 CODEGENOPT(ExperimentalNewPassManager, 1, 0) ///< Enables the new, experimental
58 CODEGENOPT(DisableRedZone , 1, 0) ///< Set when -mno-red-zone is enabled.
59 CODEGENOPT(DisableTailCalls , 1, 0) ///< Do not emit tail calls.
60 CODEGENOPT(EmitDeclMetadata , 1, 0) ///< Emit special metadata indicating what
61 ///< Decl* various IR entities came from.
62 ///< Only useful when running CodeGen as a
64 CODEGENOPT(EmitGcovArcs , 1, 0) ///< Emit coverage data files, aka. GCDA.
65 CODEGENOPT(EmitGcovNotes , 1, 0) ///< Emit coverage "notes" files, aka GCNO.
66 CODEGENOPT(EmitOpenCLArgMetadata , 1, 0) ///< Emit OpenCL kernel arg metadata.
67 CODEGENOPT(EmulatedTLS , 1, 0) ///< Set when -femulated-tls is enabled.
68 /// \brief FP_CONTRACT mode (on/off/fast).
69 ENUM_CODEGENOPT(FPContractMode, FPContractModeKind, 2, FPC_On)
70 /// \brief Embed Bitcode mode (off/all/bitcode/marker).
71 ENUM_CODEGENOPT(EmbedBitcode, EmbedBitcodeKind, 2, Embed_Off)
72 CODEGENOPT(ForbidGuardVariables , 1, 0) ///< Issue errors if C++ guard variables
74 CODEGENOPT(FunctionSections , 1, 0) ///< Set when -ffunction-sections is enabled.
75 CODEGENOPT(InstrumentFunctions , 1, 0) ///< Set when -finstrument-functions is
78 CODEGENOPT(XRayInstrumentFunctions , 1, 0) ///< Set when -fxray-instrument is
81 ///< Set the minimum number of instructions in a function to determine selective
82 ///< XRay instrumentation.
83 VALUE_CODEGENOPT(XRayInstructionThreshold , 32, 200)
85 CODEGENOPT(InstrumentForProfiling , 1, 0) ///< Set when -pg is enabled.
86 CODEGENOPT(LessPreciseFPMAD , 1, 0) ///< Enable less precise MAD instructions to
88 CODEGENOPT(PrepareForLTO , 1, 0) ///< Set when -flto is enabled on the
90 CODEGENOPT(EmitSummaryIndex, 1, 0) ///< Set when -flto=thin is enabled on the
92 CODEGENOPT(IncrementalLinkerCompatible, 1, 0) ///< Emit an object file which can
93 ///< be used with an incremental
95 CODEGENOPT(MergeAllConstants , 1, 1) ///< Merge identical constants.
96 CODEGENOPT(MergeFunctions , 1, 0) ///< Set when -fmerge-functions is enabled.
97 CODEGENOPT(MSVolatile , 1, 0) ///< Set when /volatile:ms is enabled.
98 CODEGENOPT(NoCommon , 1, 0) ///< Set when -fno-common or C++ is enabled.
99 CODEGENOPT(NoDwarfDirectoryAsm , 1, 0) ///< Set when -fno-dwarf-directory-asm is
101 CODEGENOPT(NoExecStack , 1, 0) ///< Set when -Wa,--noexecstack is enabled.
102 CODEGENOPT(FatalWarnings , 1, 0) ///< Set when -Wa,--fatal-warnings is
104 CODEGENOPT(EnableSegmentedStacks , 1, 0) ///< Set when -fsplit-stack is enabled.
105 CODEGENOPT(NoImplicitFloat , 1, 0) ///< Set when -mno-implicit-float is enabled.
106 CODEGENOPT(NoInfsFPMath , 1, 0) ///< Assume FP arguments, results not +-Inf.
107 CODEGENOPT(NoSignedZeros , 1, 0) ///< Allow ignoring the signedness of FP zero
108 CODEGENOPT(ReciprocalMath , 1, 0) ///< Allow FP divisions to be reassociated.
109 CODEGENOPT(NoTrappingMath , 1, 0) ///< Set when -fno-trapping-math is enabled.
110 CODEGENOPT(NoNaNsFPMath , 1, 0) ///< Assume FP arguments, results not NaN.
111 CODEGENOPT(FlushDenorm , 1, 0) ///< Allow FP denorm numbers to be flushed to zero
112 CODEGENOPT(CorrectlyRoundedDivSqrt, 1, 0) ///< -cl-fp32-correctly-rounded-divide-sqrt
113 CODEGENOPT(NoZeroInitializedInBSS , 1, 0) ///< -fno-zero-initialized-in-bss.
114 /// \brief Method of Objective-C dispatch to use.
115 ENUM_CODEGENOPT(ObjCDispatchMethod, ObjCDispatchMethodKind, 2, Legacy)
116 CODEGENOPT(OmitLeafFramePointer , 1, 0) ///< Set when -momit-leaf-frame-pointer is
118 VALUE_CODEGENOPT(OptimizationLevel, 2, 0) ///< The -O[0-3] option specified.
119 VALUE_CODEGENOPT(OptimizeSize, 2, 0) ///< If -Os (==1) or -Oz (==2) is specified.
121 /// \brief Choose profile instrumenation kind or no instrumentation.
122 ENUM_CODEGENOPT(ProfileInstr, ProfileInstrKind, 2, ProfileNone)
123 /// \brief Choose profile kind for PGO use compilation.
124 ENUM_CODEGENOPT(ProfileUse, ProfileInstrKind, 2, ProfileNone)
125 CODEGENOPT(CoverageMapping , 1, 0) ///< Generate coverage mapping regions to
126 ///< enable code coverage analysis.
127 CODEGENOPT(DumpCoverageMapping , 1, 0) ///< Dump the generated coverage mapping
130 /// If -fpcc-struct-return or -freg-struct-return is specified.
131 ENUM_CODEGENOPT(StructReturnConvention, StructReturnConventionKind, 2, SRCK_Default)
133 CODEGENOPT(RelaxAll , 1, 0) ///< Relax all machine code instructions.
134 CODEGENOPT(RelaxedAliasing , 1, 0) ///< Set when -fno-strict-aliasing is enabled.
135 CODEGENOPT(StructPathTBAA , 1, 0) ///< Whether or not to use struct-path TBAA.
136 CODEGENOPT(SaveTempLabels , 1, 0) ///< Save temporary labels.
137 CODEGENOPT(SanitizeAddressUseAfterScope , 1, 0) ///< Enable use-after-scope detection
138 ///< in AddressSanitizer
139 CODEGENOPT(SanitizeMemoryTrackOrigins, 2, 0) ///< Enable tracking origins in
141 CODEGENOPT(SanitizeMemoryUseAfterDtor, 1, 0) ///< Enable use-after-delete detection
142 ///< in MemorySanitizer
143 CODEGENOPT(SanitizeCfiCrossDso, 1, 0) ///< Enable cross-dso support in CFI.
144 CODEGENOPT(SanitizeCoverageType, 2, 0) ///< Type of sanitizer coverage
145 ///< instrumentation.
146 CODEGENOPT(SanitizeCoverageIndirectCalls, 1, 0) ///< Enable sanitizer coverage
147 ///< for indirect calls.
148 CODEGENOPT(SanitizeCoverageTraceBB, 1, 0) ///< Enable basic block tracing in
149 ///< in sanitizer coverage.
150 CODEGENOPT(SanitizeCoverageTraceCmp, 1, 0) ///< Enable cmp instruction tracing
151 ///< in sanitizer coverage.
152 CODEGENOPT(SanitizeCoverageTraceDiv, 1, 0) ///< Enable div instruction tracing
153 ///< in sanitizer coverage.
154 CODEGENOPT(SanitizeCoverageTraceGep, 1, 0) ///< Enable GEP instruction tracing
155 ///< in sanitizer coverage.
156 CODEGENOPT(SanitizeCoverage8bitCounters, 1, 0) ///< Use 8-bit frequency counters
157 ///< in sanitizer coverage.
158 CODEGENOPT(SanitizeCoverageTracePC, 1, 0) ///< Enable PC tracing
159 ///< in sanitizer coverage.
160 CODEGENOPT(SanitizeCoverageTracePCGuard, 1, 0) ///< Enable PC tracing with guard
161 ///< in sanitizer coverage.
162 CODEGENOPT(SanitizeStats , 1, 0) ///< Collect statistics for sanitizers.
163 CODEGENOPT(SimplifyLibCalls , 1, 1) ///< Set when -fbuiltin is enabled.
164 CODEGENOPT(SoftFloat , 1, 0) ///< -soft-float.
165 CODEGENOPT(StrictEnums , 1, 0) ///< Optimize based on strict enum definition.
166 CODEGENOPT(StrictVTablePointers, 1, 0) ///< Optimize based on the strict vtable pointers
167 CODEGENOPT(TimePasses , 1, 0) ///< Set when -ftime-report is enabled.
168 CODEGENOPT(UnrollLoops , 1, 0) ///< Control whether loops are unrolled.
169 CODEGENOPT(RerollLoops , 1, 0) ///< Control whether loops are rerolled.
170 CODEGENOPT(NoUseJumpTables , 1, 0) ///< Set when -fno-jump-tables is enabled.
171 CODEGENOPT(UnsafeFPMath , 1, 0) ///< Allow unsafe floating point optzns.
172 CODEGENOPT(UnwindTables , 1, 0) ///< Emit unwind tables.
173 CODEGENOPT(VectorizeBB , 1, 0) ///< Run basic block vectorizer.
174 CODEGENOPT(VectorizeLoop , 1, 0) ///< Run loop vectorizer.
175 CODEGENOPT(VectorizeSLP , 1, 0) ///< Run SLP vectorizer.
177 /// Attempt to use register sized accesses to bit-fields in structures, when
179 CODEGENOPT(UseRegisterSizedBitfieldAccess , 1, 0)
181 CODEGENOPT(VerifyModule , 1, 1) ///< Control whether the module should be run
182 ///< through the LLVM Verifier.
184 CODEGENOPT(StackRealignment , 1, 0) ///< Control whether to force stack
186 CODEGENOPT(UseInitArray , 1, 0) ///< Control whether to use .init_array or
188 VALUE_CODEGENOPT(StackAlignment , 32, 0) ///< Overrides default stack
189 ///< alignment, if not 0.
190 VALUE_CODEGENOPT(StackProbeSize , 32, 4096) ///< Overrides default stack
191 ///< probe size, even if 0.
192 CODEGENOPT(DebugColumnInfo, 1, 0) ///< Whether or not to use column information
195 CODEGENOPT(DebugTypeExtRefs, 1, 0) ///< Whether or not debug info should contain
196 ///< external references to a PCH or module.
198 CODEGENOPT(DebugExplicitImport, 1, 0) ///< Whether or not debug info should
199 ///< contain explicit imports for
200 ///< anonymous namespaces
201 CODEGENOPT(SplitDwarfInlining, 1, 1) ///< Whether to include inlining info in the
202 ///< skeleton CU to allow for symbolication
203 ///< of inline stack frames without .dwo files.
205 CODEGENOPT(EmitLLVMUseLists, 1, 0) ///< Control whether to serialize use-lists.
207 CODEGENOPT(WholeProgramVTables, 1, 0) ///< Whether to apply whole-program
208 /// vtable optimization.
210 /// Whether to use public LTO visibility for entities in std and stdext
211 /// namespaces. This is enabled by clang-cl's /MT and /MTd flags.
212 CODEGENOPT(LTOVisibilityPublicStd, 1, 0)
214 /// The user specified number of registers to be used for integral arguments,
215 /// or 0 if unspecified.
216 VALUE_CODEGENOPT(NumRegisterParameters, 32, 0)
218 /// The lower bound for a buffer to be considered for stack protection.
219 VALUE_CODEGENOPT(SSPBufferSize, 32, 0)
221 /// The kind of generated debug info.
222 ENUM_CODEGENOPT(DebugInfo, codegenoptions::DebugInfoKind, 3, codegenoptions::NoDebugInfo)
224 /// Tune the debug info for this debugger.
225 ENUM_CODEGENOPT(DebuggerTuning, llvm::DebuggerKind, 2,
226 llvm::DebuggerKind::Default)
228 /// Dwarf version. Version zero indicates to LLVM that no DWARF should be
230 VALUE_CODEGENOPT(DwarfVersion, 3, 0)
232 /// Whether we should emit CodeView debug information. It's possible to emit
233 /// CodeView and DWARF into the same object.
234 CODEGENOPT(EmitCodeView, 1, 0)
236 /// The kind of inlining to perform.
237 ENUM_CODEGENOPT(Inlining, InliningMethod, 2, NormalInlining)
239 // Vector functions library to use.
240 ENUM_CODEGENOPT(VecLib, VectorLibrary, 2, NoLibrary)
242 /// The default TLS model to use.
243 ENUM_CODEGENOPT(DefaultTLSModel, TLSModel, 2, GeneralDynamicTLSModel)
245 /// Number of path components to strip when emitting checks. (0 == full
247 VALUE_CODEGENOPT(EmitCheckPathComponentsToStrip, 32, 0)
249 /// Whether to report the hotness of the code region for optimization remarks.
250 CODEGENOPT(DiagnosticsWithHotness, 1, 0)
252 /// Whether copy relocations support is available when building as PIE.
253 CODEGENOPT(PIECopyRelocations, 1, 0)
255 /// Whether we should use the undefined behaviour optimization for control flow
256 /// paths that reach the end of a function without executing a required return.
257 CODEGENOPT(StrictReturn, 1, 1)
260 #undef ENUM_CODEGENOPT
261 #undef VALUE_CODEGENOPT