1//===--- LangOptions.def - Language 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 language options. Users of this file must
11// define the LANGOPT macro to make use of this information.
12//
13// Optionally, the user may also define:
14//
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).
18//
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).
22//
23// ENUM_LANGOPT: for options that have enumeration, rather than unsigned, type.
24//
25// VALUE_LANGOPT: for options that describe a value rather than a flag.
26//
27// BENIGN_ENUM_LANGOPT, COMPATIBLE_ENUM_LANGOPT,
28// BENIGN_VALUE_LANGOPT, COMPATIBLE_VALUE_LANGOPT: combinations of the above.
29//
30// FIXME: Clients should be able to more easily select whether they want
31// different levels of compatibility versus how to handle different kinds
32// of option.
33//
34// The Description field should be a noun phrase, for instance "frobbing all
35// widgets" or "C's implicit blintz feature".
36//===----------------------------------------------------------------------===//
37
38#ifndef LANGOPT
39# error Define the LANGOPT macro to handle language options
40#endif
41
42#ifndef COMPATIBLE_LANGOPT
43# define COMPATIBLE_LANGOPT(Name, Bits, Default, Description) \
44 LANGOPT(Name, Bits, Default, Description)
45#endif
46
47#ifndef BENIGN_LANGOPT
48# define BENIGN_LANGOPT(Name, Bits, Default, Description) \
49 COMPATIBLE_LANGOPT(Name, Bits, Default, Description)
50#endif
51
52#ifndef ENUM_LANGOPT
53# define ENUM_LANGOPT(Name, Type, Bits, Default, Description) \
54 LANGOPT(Name, Bits, Default, Description)
55#endif
56
57#ifndef COMPATIBLE_ENUM_LANGOPT
58# define COMPATIBLE_ENUM_LANGOPT(Name, Type, Bits, Default, Description) \
59 ENUM_LANGOPT(Name, Type, Bits, Default, Description)
60#endif
61
62#ifndef BENIGN_ENUM_LANGOPT
63# define BENIGN_ENUM_LANGOPT(Name, Type, Bits, Default, Description) \
64 COMPATIBLE_ENUM_LANGOPT(Name, Type, Bits, Default, Description)
65#endif
66
67#ifndef VALUE_LANGOPT
68# define VALUE_LANGOPT(Name, Bits, Default, Description) \
69 LANGOPT(Name, Bits, Default, Description)
70#endif
71
72#ifndef COMPATIBLE_VALUE_LANGOPT
73# define COMPATIBLE_VALUE_LANGOPT(Name, Bits, Default, Description) \
74 VALUE_LANGOPT(Name, Bits, Default, Description)
75#endif
76
77#ifndef BENIGN_VALUE_LANGOPT
78# define BENIGN_VALUE_LANGOPT(Name, Bits, Default, Description) \
79 COMPATIBLE_VALUE_LANGOPT(Name, Bits, Default, Description)
80#endif
81
82// FIXME: A lot of the BENIGN_ options should be COMPATIBLE_ instead.
83LANGOPT(C99 , 1, 0, "C99")
84LANGOPT(C11 , 1, 0, "C11")
85LANGOPT(C17 , 1, 0, "C17")
86LANGOPT(MSVCCompat , 1, 0, "Microsoft Visual C++ full compatibility mode")
87LANGOPT(MicrosoftExt , 1, 0, "Microsoft C++ extensions")
88LANGOPT(AsmBlocks , 1, 0, "Microsoft inline asm blocks")
89LANGOPT(Borland , 1, 0, "Borland extensions")
90LANGOPT(CPlusPlus , 1, 0, "C++")
91LANGOPT(CPlusPlus11 , 1, 0, "C++11")
92LANGOPT(CPlusPlus14 , 1, 0, "C++14")
93LANGOPT(CPlusPlus17 , 1, 0, "C++17")
94LANGOPT(CPlusPlus2a , 1, 0, "C++2a")
95LANGOPT(ObjC , 1, 0, "Objective-C")
96BENIGN_LANGOPT(ObjCDefaultSynthProperties , 1, 0,
97 "Objective-C auto-synthesized properties")
98BENIGN_LANGOPT(EncodeExtendedBlockSig , 1, 0,
99 "Encoding extended block type signature")
100BENIGN_LANGOPT(ObjCInferRelatedResultType , 1, 1,
101 "Objective-C related result type inference")
102LANGOPT(AppExt , 1, 0, "Objective-C App Extension")
103LANGOPT(Trigraphs , 1, 0,"trigraphs")
104LANGOPT(LineComment , 1, 0, "'//' comments")
105LANGOPT(Bool , 1, 0, "bool, true, and false keywords")
106LANGOPT(Half , 1, 0, "half keyword")
107LANGOPT(WChar , 1, CPlusPlus, "wchar_t keyword")
108LANGOPT(Char8 , 1, 0, "char8_t keyword")
109LANGOPT(DeclSpecKeyword , 1, 0, "__declspec keyword")
110BENIGN_LANGOPT(DollarIdents , 1, 1, "'$' in identifiers")
111BENIGN_LANGOPT(AsmPreprocessor, 1, 0, "preprocessor in asm mode")
112LANGOPT(GNUMode , 1, 1, "GNU extensions")
113LANGOPT(GNUKeywords , 1, 1, "GNU keywords")
114BENIGN_LANGOPT(ImplicitInt, 1, !C99 && !CPlusPlus, "C89 implicit 'int'")
115LANGOPT(Digraphs , 1, 0, "digraphs")
116BENIGN_LANGOPT(HexFloats , 1, C99, "C99 hexadecimal float constants")
117LANGOPT(CXXOperatorNames , 1, 0, "C++ operator name keywords")
118LANGOPT(AppleKext , 1, 0, "Apple kext support")
119BENIGN_LANGOPT(PascalStrings, 1, 0, "Pascal string support")
120LANGOPT(WritableStrings , 1, 0, "writable string support")
121LANGOPT(ConstStrings , 1, 0, "const-qualified string support")
122LANGOPT(LaxVectorConversions , 1, 1, "lax vector conversions")
123LANGOPT(AltiVec , 1, 0, "AltiVec-style vector initializers")
124LANGOPT(ZVector , 1, 0, "System z vector extensions")
125LANGOPT(Exceptions , 1, 0, "exception handling")
126LANGOPT(ObjCExceptions , 1, 0, "Objective-C exceptions")
127LANGOPT(CXXExceptions , 1, 0, "C++ exceptions")
128LANGOPT(DWARFExceptions , 1, 0, "dwarf exception handling")
129LANGOPT(SjLjExceptions , 1, 0, "setjmp-longjump exception handling")
130LANGOPT(SEHExceptions , 1, 0, "SEH .xdata exception handling")
131LANGOPT(ExternCNoUnwind , 1, 0, "Assume extern C functions don't unwind")
132LANGOPT(TraditionalCPP , 1, 0, "traditional CPP emulation")
133LANGOPT(RTTI , 1, 1, "run-time type information")
134LANGOPT(RTTIData , 1, 1, "emit run-time type information data")
135LANGOPT(MSBitfields , 1, 0, "Microsoft-compatible structure layout")
136LANGOPT(Freestanding, 1, 0, "freestanding implementation")
137LANGOPT(NoBuiltin , 1, 0, "disable builtin functions")
138LANGOPT(NoMathBuiltin , 1, 0, "disable math builtin functions")
139LANGOPT(GNUAsm , 1, 1, "GNU-style inline assembly")
140LANGOPT(CoroutinesTS , 1, 0, "C++ coroutines TS")
141LANGOPT(DllExportInlines , 1, 1, "dllexported classes dllexport inline methods")
142LANGOPT(RelaxedTemplateTemplateArgs, 1, 0, "C++17 relaxed matching of template template arguments")
143
144LANGOPT(DoubleSquareBracketAttributes, 1, 0, "'[[]]' attributes extension for all language standard modes")
145
146BENIGN_LANGOPT(ThreadsafeStatics , 1, 1, "thread-safe static initializers")
147LANGOPT(POSIXThreads , 1, 0, "POSIX thread support")
148LANGOPT(Blocks , 1, 0, "blocks extension to C")
149BENIGN_LANGOPT(EmitAllDecls , 1, 0, "emitting all declarations")
150LANGOPT(MathErrno , 1, 1, "errno in math functions")
151BENIGN_LANGOPT(HeinousExtensions , 1, 0, "extensions that we really don't like and may be ripped out at any time")
152LANGOPT(Modules , 1, 0, "modules extension to C")
153COMPATIBLE_LANGOPT(ModulesTS , 1, 0, "C++ Modules TS")
154BENIGN_ENUM_LANGOPT(CompilingModule, CompilingModuleKind, 2, CMK_None,
155 "compiling a module interface")
156BENIGN_LANGOPT(CompilingPCH, 1, 0, "building a pch")
157BENIGN_LANGOPT(BuildingPCHWithObjectFile, 1, 0, "building a pch which has a corresponding object file")
158COMPATIBLE_LANGOPT(ModulesDeclUse , 1, 0, "require declaration of module uses")
159BENIGN_LANGOPT(ModulesSearchAll , 1, 1, "searching even non-imported modules to find unresolved references")
160COMPATIBLE_LANGOPT(ModulesStrictDeclUse, 1, 0, "requiring declaration of module uses and all headers to be in modules")
161BENIGN_LANGOPT(ModulesErrorRecovery, 1, 1, "automatically importing modules as needed when performing error recovery")
162BENIGN_LANGOPT(ImplicitModules, 1, 1, "building modules that are not specified via -fmodule-file")
163COMPATIBLE_LANGOPT(ModulesLocalVisibility, 1, 0, "local submodule visibility")
164COMPATIBLE_LANGOPT(Optimize , 1, 0, "__OPTIMIZE__ predefined macro")
165COMPATIBLE_LANGOPT(OptimizeSize , 1, 0, "__OPTIMIZE_SIZE__ predefined macro")
166COMPATIBLE_LANGOPT(Static , 1, 0, "__STATIC__ predefined macro (as opposed to __DYNAMIC__)")
167VALUE_LANGOPT(PackStruct , 32, 0,
168 "default struct packing maximum alignment")
169VALUE_LANGOPT(MaxTypeAlign , 32, 0,
170 "default maximum alignment for types")
171VALUE_LANGOPT(AlignDouble , 1, 0, "Controls if doubles should be aligned to 8 bytes (x86 only)")
172COMPATIBLE_VALUE_LANGOPT(PICLevel , 2, 0, "__PIC__ level")
173COMPATIBLE_VALUE_LANGOPT(PIE , 1, 0, "is pie")
174COMPATIBLE_LANGOPT(GNUInline , 1, 0, "GNU inline semantics")
175COMPATIBLE_LANGOPT(NoInlineDefine , 1, 0, "__NO_INLINE__ predefined macro")
176COMPATIBLE_LANGOPT(Deprecated , 1, 0, "__DEPRECATED predefined macro")
177COMPATIBLE_LANGOPT(FastMath , 1, 0, "fast FP math optimizations, and __FAST_MATH__ predefined macro")
178COMPATIBLE_LANGOPT(FiniteMathOnly , 1, 0, "__FINITE_MATH_ONLY__ predefined macro")
179COMPATIBLE_LANGOPT(UnsafeFPMath , 1, 0, "Unsafe Floating Point Math")
180
181BENIGN_LANGOPT(ObjCGCBitmapPrint , 1, 0, "printing of GC's bitmap layout for __weak/__strong ivars")
182
183BENIGN_LANGOPT(AccessControl , 1, 1, "C++ access control")
184LANGOPT(CharIsSigned , 1, 1, "signed char")
185LANGOPT(WCharSize , 4, 0, "width of wchar_t")
186LANGOPT(WCharIsSigned , 1, 0, "signed or unsigned wchar_t")
187ENUM_LANGOPT(MSPointerToMemberRepresentationMethod, PragmaMSPointersToMembersKind, 2, PPTMK_BestCase, "member-pointer representation method")
188ENUM_LANGOPT(DefaultCallingConv, DefaultCallingConvention, 3, DCC_None, "default calling convention")
189
190LANGOPT(ShortEnums , 1, 0, "short enum types")
191
192LANGOPT(OpenCL , 1, 0, "OpenCL")
193LANGOPT(OpenCLVersion , 32, 0, "OpenCL C version")
194LANGOPT(OpenCLCPlusPlus , 1, 0, "OpenCL C++")
195LANGOPT(OpenCLCPlusPlusVersion , 32, 0, "OpenCL C++ version")
196LANGOPT(NativeHalfType , 1, 0, "Native half type support")
197LANGOPT(NativeHalfArgsAndReturns, 1, 0, "Native half args and returns")
198LANGOPT(HalfArgsAndReturns, 1, 0, "half args and returns")
199LANGOPT(CUDA , 1, 0, "CUDA")
200LANGOPT(HIP , 1, 0, "HIP")
201LANGOPT(OpenMP , 32, 0, "OpenMP support and version of OpenMP (31, 40 or 45)")
202LANGOPT(OpenMPSimd , 1, 0, "Use SIMD only OpenMP support.")
203LANGOPT(OpenMPUseTLS , 1, 0, "Use TLS for threadprivates or runtime calls")
204LANGOPT(OpenMPIsDevice , 1, 0, "Generate code only for OpenMP target device")
205LANGOPT(OpenMPCUDAMode , 1, 0, "Generate code for OpenMP pragmas in SIMT/SPMD mode")
206LANGOPT(OpenMPCUDAForceFullRuntime , 1, 0, "Force to use full runtime in all constructs when offloading to CUDA devices")
207LANGOPT(OpenMPHostCXXExceptions , 1, 0, "C++ exceptions handling in the host code.")
208LANGOPT(OpenMPCUDANumSMs , 32, 0, "Number of SMs for CUDA devices.")
209LANGOPT(OpenMPCUDABlocksPerSM , 32, 0, "Number of blocks per SM for CUDA devices.")
210LANGOPT(RenderScript , 1, 0, "RenderScript")
211
212LANGOPT(CUDAIsDevice , 1, 0, "compiling for CUDA device")
213LANGOPT(CUDAAllowVariadicFunctions, 1, 0, "allowing variadic functions in CUDA device code")
214LANGOPT(CUDAHostDeviceConstexpr, 1, 1, "treating unattributed constexpr functions as __host__ __device__")
215LANGOPT(CUDADeviceApproxTranscendentals, 1, 0, "using approximate transcendental functions")
216LANGOPT(GPURelocatableDeviceCode, 1, 0, "generate relocatable device code")
217
218LANGOPT(SizedDeallocation , 1, 0, "sized deallocation")
219LANGOPT(AlignedAllocation , 1, 0, "aligned allocation")
220LANGOPT(AlignedAllocationUnavailable, 1, 0, "aligned allocation functions are unavailable")
221LANGOPT(NewAlignOverride , 32, 0, "maximum alignment guaranteed by '::operator new(size_t)'")
222LANGOPT(ConceptsTS , 1, 0, "enable C++ Extensions for Concepts")
223BENIGN_LANGOPT(ModulesCodegen , 1, 0, "Modules code generation")
224BENIGN_LANGOPT(ModulesDebugInfo , 1, 0, "Modules debug info")
225BENIGN_LANGOPT(ElideConstructors , 1, 1, "C++ copy constructor elision")
226BENIGN_LANGOPT(DumpRecordLayouts , 1, 0, "dumping the layout of IRgen'd records")
227BENIGN_LANGOPT(DumpRecordLayoutsSimple , 1, 0, "dumping the layout of IRgen'd records in a simple form")
228BENIGN_LANGOPT(DumpVTableLayouts , 1, 0, "dumping the layouts of emitted vtables")
229LANGOPT(NoConstantCFStrings , 1, 0, "no constant CoreFoundation strings")
230BENIGN_LANGOPT(InlineVisibilityHidden , 1, 0, "hidden default visibility for inline C++ methods")
231BENIGN_LANGOPT(ParseUnknownAnytype, 1, 0, "__unknown_anytype")
232BENIGN_LANGOPT(DebuggerSupport , 1, 0, "debugger support")
233BENIGN_LANGOPT(DebuggerCastResultToId, 1, 0, "for 'po' in the debugger, cast the result to id if it is of unknown type")
234BENIGN_LANGOPT(DebuggerObjCLiteral , 1, 0, "debugger Objective-C literals and subscripting support")
235
236BENIGN_LANGOPT(SpellChecking , 1, 1, "spell-checking")
237LANGOPT(SinglePrecisionConstants , 1, 0, "treating double-precision floating point constants as single precision constants")
238LANGOPT(FastRelaxedMath , 1, 0, "OpenCL fast relaxed math")
239/// FP_CONTRACT mode (on/off/fast).
240ENUM_LANGOPT(DefaultFPContractMode, FPContractModeKind, 2, FPC_Off, "FP contraction type")
241LANGOPT(NoBitFieldTypeAlign , 1, 0, "bit-field type alignment")
242LANGOPT(HexagonQdsp6Compat , 1, 0, "hexagon-qdsp6 backward compatibility")
243LANGOPT(ObjCAutoRefCount , 1, 0, "Objective-C automated reference counting")
244LANGOPT(ObjCWeakRuntime , 1, 0, "__weak support in the ARC runtime")
245LANGOPT(ObjCWeak , 1, 0, "Objective-C __weak in ARC and MRC files")
246LANGOPT(ObjCSubscriptingLegacyRuntime , 1, 0, "Subscripting support in legacy ObjectiveC runtime")
247LANGOPT(CFProtectionBranch , 1, 0, "Control-Flow Branch Protection enabled")
248LANGOPT(FakeAddressSpaceMap , 1, 0, "OpenCL fake address space map")
249ENUM_LANGOPT(AddressSpaceMapMangling , AddrSpaceMapMangling, 2, ASMM_Target, "OpenCL address space map mangling mode")
250LANGOPT(IncludeDefaultHeader, 1, 0, "Include default header file for OpenCL")
251BENIGN_LANGOPT(DelayedTemplateParsing , 1, 0, "delayed template parsing")
252LANGOPT(BlocksRuntimeOptional , 1, 0, "optional blocks runtime")
253LANGOPT(
254 CompleteMemberPointers, 1, 0,
255 "Require member pointer base types to be complete at the point where the "
256 "type's inheritance model would be determined under the Microsoft ABI")
257
258ENUM_LANGOPT(GC, GCMode, 2, NonGC, "Objective-C Garbage Collection mode")
259ENUM_LANGOPT(ValueVisibilityMode, Visibility, 3, DefaultVisibility,
260 "value symbol visibility")
261ENUM_LANGOPT(TypeVisibilityMode, Visibility, 3, DefaultVisibility,
262 "type symbol visibility")
263ENUM_LANGOPT(StackProtector, StackProtectorMode, 2, SSPOff,
264 "stack protector mode")
265ENUM_LANGOPT(SignedOverflowBehavior, SignedOverflowBehaviorTy, 2, SOB_Undefined,
266 "signed integer overflow handling")
267
268BENIGN_LANGOPT(ArrowDepth, 32, 256,
269 "maximum number of operator->s to follow")
270BENIGN_LANGOPT(InstantiationDepth, 32, 1024,
271 "maximum template instantiation depth")
272BENIGN_LANGOPT(ConstexprCallDepth, 32, 512,
273 "maximum constexpr call depth")
274BENIGN_LANGOPT(ConstexprStepLimit, 32, 1048576,
275 "maximum constexpr evaluation steps")
276BENIGN_LANGOPT(BracketDepth, 32, 256,
277 "maximum bracket nesting depth")
278BENIGN_LANGOPT(NumLargeByValueCopy, 32, 0,
279 "if non-zero, warn about parameter or return Warn if parameter/return value is larger in bytes than this setting. 0 is no check.")
280VALUE_LANGOPT(MSCompatibilityVersion, 32, 0, "Microsoft Visual C/C++ Version")
281VALUE_LANGOPT(VtorDispMode, 2, 1, "How many vtordisps to insert")
282
283LANGOPT(ApplePragmaPack, 1, 0, "Apple gcc-compatible #pragma pack handling")
284
285LANGOPT(RetainCommentsFromSystemHeaders, 1, 0, "retain documentation comments from system headers in the AST")
286
287LANGOPT(SanitizeAddressFieldPadding, 2, 0, "controls how aggressive is ASan "
288 "field padding (0: none, 1:least "
289 "aggressive, 2: more aggressive)")
290
291LANGOPT(XRayInstrument, 1, 0, "controls whether to do XRay instrumentation")
292LANGOPT(XRayAlwaysEmitCustomEvents, 1, 0,
293 "controls whether to always emit intrinsic calls to "
294 "__xray_customevent(...) builtin.")
295LANGOPT(XRayAlwaysEmitTypedEvents, 1, 0,
296 "controls whether to always emit intrinsic calls to "
297 "__xray_typedevent(...) builtin.")
298
299LANGOPT(ForceEmitVTables, 1, 0, "whether to emit all vtables")
300
301BENIGN_LANGOPT(AllowEditorPlaceholders, 1, 0,
302 "allow editor placeholders in source")
303
304ENUM_LANGOPT(ClangABICompat, ClangABI, 4, ClangABI::Latest,
305 "version of Clang that we should attempt to be ABI-compatible "
306 "with")
307
308COMPATIBLE_VALUE_LANGOPT(FunctionAlignment, 5, 0, "Default alignment for functions")
309
310LANGOPT(FixedPoint, 1, 0, "fixed point types")
311LANGOPT(PaddingOnUnsignedFixedPoint, 1, 0,
312 "unsigned fixed point types having one extra padding bit")
313
314LANGOPT(RegisterStaticDestructors, 1, 1, "Register C++ static destructors")
315
316#undef LANGOPT
317#undef COMPATIBLE_LANGOPT
318#undef BENIGN_LANGOPT
319#undef ENUM_LANGOPT
320#undef COMPATIBLE_ENUM_LANGOPT
321#undef BENIGN_ENUM_LANGOPT
322#undef VALUE_LANGOPT
323#undef COMPATIBLE_VALUE_LANGOPT
324#undef BENIGN_VALUE_LANGOPT
325