1 //===--- LangOptions.def - Language 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 language options. Users of this file must
11 // define the LANGOPT macro to make use of this information.
13 // Optionally, the user may also define:
15 // BENIGN_LANGOPT: for options that don't affect the construction of the AST in
16 // any way (that is, the value can be different between an implicit module
17 // and the user of that module).
19 // COMPATIBLE_LANGOPT: for options that affect the construction of the AST in
20 // a way that doesn't prevent interoperability (that is, the value can be
21 // different between an explicit module and the user of that module).
23 // ENUM_LANGOPT: for options that have enumeration, rather than unsigned, type.
25 // VALUE_LANGOPT: for options that describe a value rather than a flag.
27 // BENIGN_ENUM_LANGOPT, COMPATIBLE_ENUM_LANGOPT,
28 // BENIGN_VALUE_LANGOPT, COMPATIBLE_VALUE_LANGOPT: combinations of the above.
30 // FIXME: Clients should be able to more easily select whether they want
31 // different levels of compatibility versus how to handle different kinds
34 // The Description field should be a noun phrase, for instance "frobbing all
35 // widgets" or "C's implicit blintz feature".
36 //===----------------------------------------------------------------------===//
39 # error Define the LANGOPT macro to handle language options
42 #ifndef COMPATIBLE_LANGOPT
43 # define COMPATIBLE_LANGOPT(Name, Bits, Default, Description) \
44 LANGOPT(Name, Bits, Default, Description)
47 #ifndef BENIGN_LANGOPT
48 # define BENIGN_LANGOPT(Name, Bits, Default, Description) \
49 COMPATIBLE_LANGOPT(Name, Bits, Default, Description)
53 # define ENUM_LANGOPT(Name, Type, Bits, Default, Description) \
54 LANGOPT(Name, Bits, Default, Description)
57 #ifndef COMPATIBLE_ENUM_LANGOPT
58 # define COMPATIBLE_ENUM_LANGOPT(Name, Type, Bits, Default, Description) \
59 ENUM_LANGOPT(Name, Type, Bits, Default, Description)
62 #ifndef BENIGN_ENUM_LANGOPT
63 # define BENIGN_ENUM_LANGOPT(Name, Type, Bits, Default, Description) \
64 COMPATIBLE_ENUM_LANGOPT(Name, Type, Bits, Default, Description)
68 # define VALUE_LANGOPT(Name, Bits, Default, Description) \
69 LANGOPT(Name, Bits, Default, Description)
72 #ifndef COMPATIBLE_VALUE_LANGOPT
73 # define COMPATIBLE_VALUE_LANGOPT(Name, Bits, Default, Description) \
74 VALUE_LANGOPT(Name, Bits, Default, Description)
77 #ifndef BENIGN_VALUE_LANGOPT
78 # define BENIGN_VALUE_LANGOPT(Name, Bits, Default, Description) \
79 COMPATIBLE_VALUE_LANGOPT(Name, Bits, Default, Description)
82 // FIXME: A lot of the BENIGN_ options should be COMPATIBLE_ instead.
83 LANGOPT(C99 , 1, 0, "C99")
84 LANGOPT(C11 , 1, 0, "C11")
85 LANGOPT(MSVCCompat , 1, 0, "Microsoft Visual C++ full compatibility mode")
86 LANGOPT(MicrosoftExt , 1, 0, "Microsoft C++ extensions")
87 LANGOPT(AsmBlocks , 1, 0, "Microsoft inline asm blocks")
88 LANGOPT(Borland , 1, 0, "Borland extensions")
89 LANGOPT(CPlusPlus , 1, 0, "C++")
90 LANGOPT(CPlusPlus11 , 1, 0, "C++11")
91 LANGOPT(CPlusPlus14 , 1, 0, "C++14")
92 LANGOPT(CPlusPlus1z , 1, 0, "C++1z")
93 LANGOPT(ObjC1 , 1, 0, "Objective-C 1")
94 LANGOPT(ObjC2 , 1, 0, "Objective-C 2")
95 BENIGN_LANGOPT(ObjCDefaultSynthProperties , 1, 0,
96 "Objective-C auto-synthesized properties")
97 BENIGN_LANGOPT(EncodeExtendedBlockSig , 1, 0,
98 "Encoding extended block type signature")
99 BENIGN_LANGOPT(ObjCInferRelatedResultType , 1, 1,
100 "Objective-C related result type inference")
101 LANGOPT(AppExt , 1, 0, "Objective-C App Extension")
102 LANGOPT(Trigraphs , 1, 0,"trigraphs")
103 LANGOPT(LineComment , 1, 0, "'//' comments")
104 LANGOPT(Bool , 1, 0, "bool, true, and false keywords")
105 LANGOPT(Half , 1, 0, "half keyword")
106 LANGOPT(WChar , 1, CPlusPlus, "wchar_t keyword")
107 LANGOPT(DeclSpecKeyword , 1, 0, "__declspec keyword")
108 BENIGN_LANGOPT(DollarIdents , 1, 1, "'$' in identifiers")
109 BENIGN_LANGOPT(AsmPreprocessor, 1, 0, "preprocessor in asm mode")
110 LANGOPT(GNUMode , 1, 1, "GNU extensions")
111 LANGOPT(GNUKeywords , 1, 1, "GNU keywords")
112 BENIGN_LANGOPT(ImplicitInt, 1, !C99 && !CPlusPlus, "C89 implicit 'int'")
113 LANGOPT(Digraphs , 1, 0, "digraphs")
114 BENIGN_LANGOPT(HexFloats , 1, C99, "C99 hexadecimal float constants")
115 LANGOPT(CXXOperatorNames , 1, 0, "C++ operator name keywords")
116 LANGOPT(AppleKext , 1, 0, "Apple kext support")
117 BENIGN_LANGOPT(PascalStrings, 1, 0, "Pascal string support")
118 LANGOPT(WritableStrings , 1, 0, "writable string support")
119 LANGOPT(ConstStrings , 1, 0, "const-qualified string support")
120 LANGOPT(LaxVectorConversions , 1, 1, "lax vector conversions")
121 LANGOPT(AltiVec , 1, 0, "AltiVec-style vector initializers")
122 LANGOPT(ZVector , 1, 0, "System z vector extensions")
123 LANGOPT(Exceptions , 1, 0, "exception handling")
124 LANGOPT(ObjCExceptions , 1, 0, "Objective-C exceptions")
125 LANGOPT(CXXExceptions , 1, 0, "C++ exceptions")
126 LANGOPT(SjLjExceptions , 1, 0, "setjmp-longjump exception handling")
127 LANGOPT(ExternCNoUnwind , 1, 0, "Assume extern C functions don't unwind")
128 LANGOPT(TraditionalCPP , 1, 0, "traditional CPP emulation")
129 LANGOPT(RTTI , 1, 1, "run-time type information")
130 LANGOPT(RTTIData , 1, 1, "emit run-time type information data")
131 LANGOPT(MSBitfields , 1, 0, "Microsoft-compatible structure layout")
132 LANGOPT(Freestanding, 1, 0, "freestanding implementation")
133 LANGOPT(NoBuiltin , 1, 0, "disable builtin functions")
134 LANGOPT(NoMathBuiltin , 1, 0, "disable math builtin functions")
135 LANGOPT(GNUAsm , 1, 1, "GNU-style inline assembly")
136 LANGOPT(CoroutinesTS , 1, 0, "C++ coroutines TS")
137 LANGOPT(RelaxedTemplateTemplateArgs, 1, 0, "C++17 relaxed matching of template template arguments")
139 BENIGN_LANGOPT(ThreadsafeStatics , 1, 1, "thread-safe static initializers")
140 LANGOPT(POSIXThreads , 1, 0, "POSIX thread support")
141 LANGOPT(Blocks , 1, 0, "blocks extension to C")
142 BENIGN_LANGOPT(EmitAllDecls , 1, 0, "emitting all declarations")
143 LANGOPT(MathErrno , 1, 1, "errno in math functions")
144 BENIGN_LANGOPT(HeinousExtensions , 1, 0, "extensions that we really don't like and may be ripped out at any time")
145 LANGOPT(Modules , 1, 0, "modules extension to C")
146 COMPATIBLE_LANGOPT(ModulesTS , 1, 0, "C++ Modules TS")
147 BENIGN_ENUM_LANGOPT(CompilingModule, CompilingModuleKind, 2, CMK_None,
148 "compiling a module interface")
149 BENIGN_LANGOPT(CompilingPCH, 1, 0, "building a pch")
150 COMPATIBLE_LANGOPT(ModulesDeclUse , 1, 0, "require declaration of module uses")
151 BENIGN_LANGOPT(ModulesSearchAll , 1, 1, "searching even non-imported modules to find unresolved references")
152 COMPATIBLE_LANGOPT(ModulesStrictDeclUse, 1, 0, "requiring declaration of module uses and all headers to be in modules")
153 BENIGN_LANGOPT(ModulesErrorRecovery, 1, 1, "automatically importing modules as needed when performing error recovery")
154 BENIGN_LANGOPT(ImplicitModules, 1, 1, "building modules that are not specified via -fmodule-file")
155 COMPATIBLE_LANGOPT(ModulesLocalVisibility, 1, 0, "local submodule visibility")
156 COMPATIBLE_LANGOPT(Optimize , 1, 0, "__OPTIMIZE__ predefined macro")
157 COMPATIBLE_LANGOPT(OptimizeSize , 1, 0, "__OPTIMIZE_SIZE__ predefined macro")
158 COMPATIBLE_LANGOPT(Static , 1, 0, "__STATIC__ predefined macro (as opposed to __DYNAMIC__)")
159 VALUE_LANGOPT(PackStruct , 32, 0,
160 "default struct packing maximum alignment")
161 VALUE_LANGOPT(MaxTypeAlign , 32, 0,
162 "default maximum alignment for types")
163 VALUE_LANGOPT(AlignDouble , 1, 0, "Controls if doubles should be aligned to 8 bytes (x86 only)")
164 COMPATIBLE_VALUE_LANGOPT(PICLevel , 2, 0, "__PIC__ level")
165 COMPATIBLE_VALUE_LANGOPT(PIE , 1, 0, "is pie")
166 COMPATIBLE_LANGOPT(GNUInline , 1, 0, "GNU inline semantics")
167 COMPATIBLE_LANGOPT(NoInlineDefine , 1, 0, "__NO_INLINE__ predefined macro")
168 COMPATIBLE_LANGOPT(Deprecated , 1, 0, "__DEPRECATED predefined macro")
169 COMPATIBLE_LANGOPT(FastMath , 1, 0, "fast FP math optimizations, and __FAST_MATH__ predefined macro")
170 COMPATIBLE_LANGOPT(FiniteMathOnly , 1, 0, "__FINITE_MATH_ONLY__ predefined macro")
171 COMPATIBLE_LANGOPT(UnsafeFPMath , 1, 0, "Unsafe Floating Point Math")
173 BENIGN_LANGOPT(ObjCGCBitmapPrint , 1, 0, "printing of GC's bitmap layout for __weak/__strong ivars")
175 BENIGN_LANGOPT(AccessControl , 1, 1, "C++ access control")
176 LANGOPT(CharIsSigned , 1, 1, "signed char")
177 LANGOPT(ShortWChar , 1, 0, "unsigned short wchar_t")
178 ENUM_LANGOPT(MSPointerToMemberRepresentationMethod, PragmaMSPointersToMembersKind, 2, PPTMK_BestCase, "member-pointer representation method")
179 ENUM_LANGOPT(DefaultCallingConv, DefaultCallingConvention, 3, DCC_None, "default calling convention")
181 LANGOPT(ShortEnums , 1, 0, "short enum types")
183 LANGOPT(OpenCL , 1, 0, "OpenCL")
184 LANGOPT(OpenCLVersion , 32, 0, "OpenCL version")
185 LANGOPT(NativeHalfType , 1, 0, "Native half type support")
186 LANGOPT(NativeHalfArgsAndReturns, 1, 0, "Native half args and returns")
187 LANGOPT(HalfArgsAndReturns, 1, 0, "half args and returns")
188 LANGOPT(CUDA , 1, 0, "CUDA")
189 LANGOPT(OpenMP , 32, 0, "OpenMP support and version of OpenMP (31, 40 or 45)")
190 LANGOPT(OpenMPUseTLS , 1, 0, "Use TLS for threadprivates or runtime calls")
191 LANGOPT(OpenMPIsDevice , 1, 0, "Generate code only for OpenMP target device")
192 LANGOPT(RenderScript , 1, 0, "RenderScript")
194 LANGOPT(CUDAIsDevice , 1, 0, "compiling for CUDA device")
195 LANGOPT(CUDAAllowVariadicFunctions, 1, 0, "allowing variadic functions in CUDA device code")
196 LANGOPT(CUDAHostDeviceConstexpr, 1, 1, "treating unattributed constexpr functions as __host__ __device__")
197 LANGOPT(CUDADeviceFlushDenormalsToZero, 1, 0, "flushing denormals to zero")
198 LANGOPT(CUDADeviceApproxTranscendentals, 1, 0, "using approximate transcendental functions")
200 LANGOPT(SizedDeallocation , 1, 0, "sized deallocation")
201 LANGOPT(AlignedAllocation , 1, 0, "aligned allocation")
202 LANGOPT(NewAlignOverride , 32, 0, "maximum alignment guaranteed by '::operator new(size_t)'")
203 LANGOPT(ConceptsTS , 1, 0, "enable C++ Extensions for Concepts")
204 BENIGN_LANGOPT(ModulesCodegen , 1, 0, "Modules code generation")
205 BENIGN_LANGOPT(ModulesDebugInfo , 1, 0, "Modules debug info")
206 BENIGN_LANGOPT(ElideConstructors , 1, 1, "C++ copy constructor elision")
207 BENIGN_LANGOPT(DumpRecordLayouts , 1, 0, "dumping the layout of IRgen'd records")
208 BENIGN_LANGOPT(DumpRecordLayoutsSimple , 1, 0, "dumping the layout of IRgen'd records in a simple form")
209 BENIGN_LANGOPT(DumpVTableLayouts , 1, 0, "dumping the layouts of emitted vtables")
210 LANGOPT(NoConstantCFStrings , 1, 0, "no constant CoreFoundation strings")
211 BENIGN_LANGOPT(InlineVisibilityHidden , 1, 0, "hidden default visibility for inline C++ methods")
212 BENIGN_LANGOPT(ParseUnknownAnytype, 1, 0, "__unknown_anytype")
213 BENIGN_LANGOPT(DebuggerSupport , 1, 0, "debugger support")
214 BENIGN_LANGOPT(DebuggerCastResultToId, 1, 0, "for 'po' in the debugger, cast the result to id if it is of unknown type")
215 BENIGN_LANGOPT(DebuggerObjCLiteral , 1, 0, "debugger Objective-C literals and subscripting support")
217 BENIGN_LANGOPT(SpellChecking , 1, 1, "spell-checking")
218 LANGOPT(SinglePrecisionConstants , 1, 0, "treating double-precision floating point constants as single precision constants")
219 LANGOPT(FastRelaxedMath , 1, 0, "OpenCL fast relaxed math")
220 /// \brief FP_CONTRACT mode (on/off/fast).
221 ENUM_LANGOPT(DefaultFPContractMode, FPContractModeKind, 2, FPC_Off, "FP contraction type")
222 LANGOPT(NoBitFieldTypeAlign , 1, 0, "bit-field type alignment")
223 LANGOPT(HexagonQdsp6Compat , 1, 0, "hexagon-qdsp6 backward compatibility")
224 LANGOPT(ObjCAutoRefCount , 1, 0, "Objective-C automated reference counting")
225 LANGOPT(ObjCWeakRuntime , 1, 0, "__weak support in the ARC runtime")
226 LANGOPT(ObjCWeak , 1, 0, "Objective-C __weak in ARC and MRC files")
227 LANGOPT(ObjCSubscriptingLegacyRuntime , 1, 0, "Subscripting support in legacy ObjectiveC runtime")
228 LANGOPT(FakeAddressSpaceMap , 1, 0, "OpenCL fake address space map")
229 ENUM_LANGOPT(AddressSpaceMapMangling , AddrSpaceMapMangling, 2, ASMM_Target, "OpenCL address space map mangling mode")
230 LANGOPT(IncludeDefaultHeader, 1, 0, "Include default header file for OpenCL")
231 BENIGN_LANGOPT(DelayedTemplateParsing , 1, 0, "delayed template parsing")
232 LANGOPT(BlocksRuntimeOptional , 1, 0, "optional blocks runtime")
234 ENUM_LANGOPT(GC, GCMode, 2, NonGC, "Objective-C Garbage Collection mode")
235 ENUM_LANGOPT(ValueVisibilityMode, Visibility, 3, DefaultVisibility,
236 "value symbol visibility")
237 ENUM_LANGOPT(TypeVisibilityMode, Visibility, 3, DefaultVisibility,
238 "type symbol visibility")
239 ENUM_LANGOPT(StackProtector, StackProtectorMode, 2, SSPOff,
240 "stack protector mode")
241 ENUM_LANGOPT(SignedOverflowBehavior, SignedOverflowBehaviorTy, 2, SOB_Undefined,
242 "signed integer overflow handling")
244 BENIGN_LANGOPT(ArrowDepth, 32, 256,
245 "maximum number of operator->s to follow")
246 BENIGN_LANGOPT(InstantiationDepth, 32, 1024,
247 "maximum template instantiation depth")
248 BENIGN_LANGOPT(ConstexprCallDepth, 32, 512,
249 "maximum constexpr call depth")
250 BENIGN_LANGOPT(ConstexprStepLimit, 32, 1048576,
251 "maximum constexpr evaluation steps")
252 BENIGN_LANGOPT(BracketDepth, 32, 256,
253 "maximum bracket nesting depth")
254 BENIGN_LANGOPT(NumLargeByValueCopy, 32, 0,
255 "if non-zero, warn about parameter or return Warn if parameter/return value is larger in bytes than this setting. 0 is no check.")
256 VALUE_LANGOPT(MSCompatibilityVersion, 32, 0, "Microsoft Visual C/C++ Version")
257 VALUE_LANGOPT(VtorDispMode, 2, 1, "How many vtordisps to insert")
259 LANGOPT(ApplePragmaPack, 1, 0, "Apple gcc-compatible #pragma pack handling")
261 LANGOPT(RetainCommentsFromSystemHeaders, 1, 0, "retain documentation comments from system headers in the AST")
263 LANGOPT(SanitizeAddressFieldPadding, 2, 0, "controls how aggressive is ASan "
264 "field padding (0: none, 1:least "
265 "aggressive, 2: more aggressive)")
267 LANGOPT(XRayInstrument, 1, 0, "controls whether to do XRay instrumentation")
269 LANGOPT(AllowEditorPlaceholders, 1, 0, "allow editor placeholders in source")
272 #undef COMPATIBLE_LANGOPT
273 #undef BENIGN_LANGOPT
275 #undef COMPATIBLE_ENUM_LANGOPT
276 #undef BENIGN_ENUM_LANGOPT
278 #undef COMPATIBLE_VALUE_LANGOPT
279 #undef BENIGN_VALUE_LANGOPT