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