Home | History | Annotate | Download | only in Basic
      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.
     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 BENIGN_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(Coroutines        , 1, 0, "C++ coroutines")
    137 
    138 BENIGN_LANGOPT(ThreadsafeStatics , 1, 1, "thread-safe static initializers")
    139 LANGOPT(POSIXThreads      , 1, 0, "POSIX thread support")
    140 LANGOPT(Blocks            , 1, 0, "blocks extension to C")
    141 BENIGN_LANGOPT(EmitAllDecls      , 1, 0, "emitting all declarations")
    142 LANGOPT(MathErrno         , 1, 1, "errno in math functions")
    143 BENIGN_LANGOPT(HeinousExtensions , 1, 0, "extensions that we really don't like and may be ripped out at any time")
    144 LANGOPT(Modules           , 1, 0, "modules extension to C")
    145 BENIGN_LANGOPT(CompilingModule, 1, 0, "compiling a module interface")
    146 COMPATIBLE_LANGOPT(ModulesDeclUse    , 1, 0, "require declaration of module uses")
    147 BENIGN_LANGOPT(ModulesSearchAll  , 1, 1, "searching even non-imported modules to find unresolved references")
    148 COMPATIBLE_LANGOPT(ModulesStrictDeclUse, 1, 0, "requiring declaration of module uses and all headers to be in modules")
    149 BENIGN_LANGOPT(ModulesErrorRecovery, 1, 1, "automatically importing modules as needed when performing error recovery")
    150 BENIGN_LANGOPT(ImplicitModules, 1, 1, "building modules that are not specified via -fmodule-file")
    151 COMPATIBLE_LANGOPT(ModulesLocalVisibility, 1, 0, "local submodule visibility")
    152 COMPATIBLE_LANGOPT(Optimize          , 1, 0, "__OPTIMIZE__ predefined macro")
    153 COMPATIBLE_LANGOPT(OptimizeSize      , 1, 0, "__OPTIMIZE_SIZE__ predefined macro")
    154 COMPATIBLE_LANGOPT(Static            , 1, 0, "__STATIC__ predefined macro (as opposed to __DYNAMIC__)")
    155 VALUE_LANGOPT(PackStruct  , 32, 0,
    156               "default struct packing maximum alignment")
    157 VALUE_LANGOPT(MaxTypeAlign  , 32, 0,
    158               "default maximum alignment for types")
    159 VALUE_LANGOPT(AlignDouble            , 1, 0, "Controls if doubles should be aligned to 8 bytes (x86 only)")
    160 COMPATIBLE_VALUE_LANGOPT(PICLevel    , 2, 0, "__PIC__ level")
    161 COMPATIBLE_VALUE_LANGOPT(PIE         , 1, 0, "is pie")
    162 COMPATIBLE_LANGOPT(GNUInline         , 1, 0, "GNU inline semantics")
    163 COMPATIBLE_LANGOPT(NoInlineDefine    , 1, 0, "__NO_INLINE__ predefined macro")
    164 COMPATIBLE_LANGOPT(Deprecated        , 1, 0, "__DEPRECATED predefined macro")
    165 COMPATIBLE_LANGOPT(FastMath          , 1, 0, "fast FP math optimizations, and __FAST_MATH__ predefined macro")
    166 COMPATIBLE_LANGOPT(FiniteMathOnly    , 1, 0, "__FINITE_MATH_ONLY__ predefined macro")
    167 COMPATIBLE_LANGOPT(UnsafeFPMath      , 1, 0, "Unsafe Floating Point Math")
    168 
    169 BENIGN_LANGOPT(ObjCGCBitmapPrint , 1, 0, "printing of GC's bitmap layout for __weak/__strong ivars")
    170 
    171 BENIGN_LANGOPT(AccessControl     , 1, 1, "C++ access control")
    172 LANGOPT(CharIsSigned      , 1, 1, "signed char")
    173 LANGOPT(ShortWChar        , 1, 0, "unsigned short wchar_t")
    174 ENUM_LANGOPT(MSPointerToMemberRepresentationMethod, PragmaMSPointersToMembersKind, 2, PPTMK_BestCase, "member-pointer representation method")
    175 ENUM_LANGOPT(DefaultCallingConv, DefaultCallingConvention, 3, DCC_None, "default calling convention")
    176 
    177 LANGOPT(ShortEnums        , 1, 0, "short enum types")
    178 
    179 LANGOPT(OpenCL            , 1, 0, "OpenCL")
    180 LANGOPT(OpenCLVersion     , 32, 0, "OpenCL version")
    181 LANGOPT(NativeHalfType    , 1, 0, "Native half type support")
    182 LANGOPT(NativeHalfArgsAndReturns, 1, 0, "Native half args and returns")
    183 LANGOPT(HalfArgsAndReturns, 1, 0, "half args and returns")
    184 LANGOPT(CUDA              , 1, 0, "CUDA")
    185 LANGOPT(OpenMP            , 32, 0, "OpenMP support and version of OpenMP (31, 40 or 45)")
    186 LANGOPT(OpenMPUseTLS      , 1, 0, "Use TLS for threadprivates or runtime calls")
    187 LANGOPT(OpenMPIsDevice    , 1, 0, "Generate code only for OpenMP target device")
    188 LANGOPT(RenderScript      , 1, 0, "RenderScript")
    189 
    190 LANGOPT(CUDAIsDevice      , 1, 0, "compiling for CUDA device")
    191 LANGOPT(CUDAAllowVariadicFunctions, 1, 0, "allowing variadic functions in CUDA device code")
    192 LANGOPT(CUDAHostDeviceConstexpr, 1, 1, "treating unattributed constexpr functions as __host__ __device__")
    193 LANGOPT(CUDADeviceFlushDenormalsToZero, 1, 0, "flushing denormals to zero")
    194 LANGOPT(CUDADeviceApproxTranscendentals, 1, 0, "using approximate transcendental functions")
    195 
    196 LANGOPT(SizedDeallocation , 1, 0, "enable sized deallocation functions")
    197 LANGOPT(ConceptsTS , 1, 0, "enable C++ Extensions for Concepts")
    198 BENIGN_LANGOPT(ElideConstructors , 1, 1, "C++ copy constructor elision")
    199 BENIGN_LANGOPT(DumpRecordLayouts , 1, 0, "dumping the layout of IRgen'd records")
    200 BENIGN_LANGOPT(DumpRecordLayoutsSimple , 1, 0, "dumping the layout of IRgen'd records in a simple form")
    201 BENIGN_LANGOPT(DumpVTableLayouts , 1, 0, "dumping the layouts of emitted vtables")
    202 LANGOPT(NoConstantCFStrings , 1, 0, "no constant CoreFoundation strings")
    203 BENIGN_LANGOPT(InlineVisibilityHidden , 1, 0, "hidden default visibility for inline C++ methods")
    204 BENIGN_LANGOPT(ParseUnknownAnytype, 1, 0, "__unknown_anytype")
    205 BENIGN_LANGOPT(DebuggerSupport , 1, 0, "debugger support")
    206 BENIGN_LANGOPT(DebuggerCastResultToId, 1, 0, "for 'po' in the debugger, cast the result to id if it is of unknown type")
    207 BENIGN_LANGOPT(DebuggerObjCLiteral , 1, 0, "debugger Objective-C literals and subscripting support")
    208 
    209 BENIGN_LANGOPT(SpellChecking , 1, 1, "spell-checking")
    210 LANGOPT(SinglePrecisionConstants , 1, 0, "treating double-precision floating point constants as single precision constants")
    211 LANGOPT(FastRelaxedMath , 1, 0, "OpenCL fast relaxed math")
    212 LANGOPT(DefaultFPContract , 1, 0, "FP_CONTRACT")
    213 LANGOPT(NoBitFieldTypeAlign , 1, 0, "bit-field type alignment")
    214 LANGOPT(HexagonQdsp6Compat , 1, 0, "hexagon-qdsp6 backward compatibility")
    215 LANGOPT(ObjCAutoRefCount , 1, 0, "Objective-C automated reference counting")
    216 LANGOPT(ObjCWeakRuntime     , 1, 0, "__weak support in the ARC runtime")
    217 LANGOPT(ObjCWeak            , 1, 0, "Objective-C __weak in ARC and MRC files")
    218 LANGOPT(ObjCSubscriptingLegacyRuntime         , 1, 0, "Subscripting support in legacy ObjectiveC runtime")
    219 LANGOPT(FakeAddressSpaceMap , 1, 0, "OpenCL fake address space map")
    220 ENUM_LANGOPT(AddressSpaceMapMangling , AddrSpaceMapMangling, 2, ASMM_Target, "OpenCL address space map mangling mode")
    221 LANGOPT(IncludeDefaultHeader, 1, 0, "Include default header file for OpenCL")
    222 BENIGN_LANGOPT(DelayedTemplateParsing , 1, 0, "delayed template parsing")
    223 LANGOPT(BlocksRuntimeOptional , 1, 0, "optional blocks runtime")
    224 
    225 ENUM_LANGOPT(GC, GCMode, 2, NonGC, "Objective-C Garbage Collection mode")
    226 ENUM_LANGOPT(ValueVisibilityMode, Visibility, 3, DefaultVisibility,
    227              "value symbol visibility")
    228 ENUM_LANGOPT(TypeVisibilityMode, Visibility, 3, DefaultVisibility,
    229              "type symbol visibility")
    230 ENUM_LANGOPT(StackProtector, StackProtectorMode, 2, SSPOff,
    231              "stack protector mode")
    232 ENUM_LANGOPT(SignedOverflowBehavior, SignedOverflowBehaviorTy, 2, SOB_Undefined,
    233              "signed integer overflow handling")
    234 
    235 BENIGN_LANGOPT(ArrowDepth, 32, 256,
    236                "maximum number of operator->s to follow")
    237 BENIGN_LANGOPT(InstantiationDepth, 32, 256,
    238                "maximum template instantiation depth")
    239 BENIGN_LANGOPT(ConstexprCallDepth, 32, 512,
    240                "maximum constexpr call depth")
    241 BENIGN_LANGOPT(ConstexprStepLimit, 32, 1048576,
    242                "maximum constexpr evaluation steps")
    243 BENIGN_LANGOPT(BracketDepth, 32, 256,
    244                "maximum bracket nesting depth")
    245 BENIGN_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.")
    247 VALUE_LANGOPT(MSCompatibilityVersion, 32, 0, "Microsoft Visual C/C++ Version")
    248 VALUE_LANGOPT(VtorDispMode, 2, 1, "How many vtordisps to insert")
    249 
    250 LANGOPT(ApplePragmaPack, 1, 0, "Apple gcc-compatible #pragma pack handling")
    251 
    252 LANGOPT(RetainCommentsFromSystemHeaders, 1, 0, "retain documentation comments from system headers in the AST")
    253 
    254 LANGOPT(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