Home | History | Annotate | Download | only in Driver
      1 //===--- CLCompatOptions.td - Options for clang-cl ------------------------===//
      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 options accepted by clang-cl.
     11 //
     12 //===----------------------------------------------------------------------===//
     13 
     14 def cl_Group : OptionGroup<"<clang-cl options>">,
     15   HelpText<"CL.EXE COMPATIBILITY OPTIONS">;
     16 
     17 def cl_compile_Group : OptionGroup<"<clang-cl compile-only options>">,
     18   Group<cl_Group>;
     19 
     20 def cl_ignored_Group : OptionGroup<"<clang-cl ignored options>">,
     21   Group<cl_Group>;
     22 
     23 class CLFlag<string name> : Option<["/", "-"], name, KIND_FLAG>,
     24   Group<cl_Group>, Flags<[CLOption, DriverOption]>;
     25 
     26 class CLCompileFlag<string name> : Option<["/", "-"], name, KIND_FLAG>,
     27   Group<cl_compile_Group>, Flags<[CLOption, DriverOption]>;
     28 
     29 class CLIgnoredFlag<string name> : Option<["/", "-"], name, KIND_FLAG>,
     30   Group<cl_ignored_Group>, Flags<[CLOption, DriverOption, HelpHidden]>;
     31 
     32 class CLJoined<string name> : Option<["/", "-"], name, KIND_JOINED>,
     33   Group<cl_Group>, Flags<[CLOption, DriverOption]>;
     34 
     35 class CLCompileJoined<string name> : Option<["/", "-"], name, KIND_JOINED>,
     36   Group<cl_compile_Group>, Flags<[CLOption, DriverOption]>;
     37 
     38 class CLIgnoredJoined<string name> : Option<["/", "-"], name, KIND_JOINED>,
     39   Group<cl_ignored_Group>, Flags<[CLOption, DriverOption, HelpHidden]>;
     40 
     41 class CLJoinedOrSeparate<string name> : Option<["/", "-"], name,
     42   KIND_JOINED_OR_SEPARATE>, Group<cl_Group>, Flags<[CLOption, DriverOption]>;
     43 
     44 class CLCompileJoinedOrSeparate<string name> : Option<["/", "-"], name,
     45   KIND_JOINED_OR_SEPARATE>, Group<cl_compile_Group>,
     46   Flags<[CLOption, DriverOption]>;
     47 
     48 class CLRemainingArgs<string name> : Option<["/", "-"], name,
     49   KIND_REMAINING_ARGS>, Group<cl_Group>, Flags<[CLOption, DriverOption]>;
     50 
     51 // Aliases:
     52 // (We don't put any of these in cl_compile_Group as the options they alias are
     53 // already in the right group.)
     54 
     55 def _SLASH_Brepro : CLFlag<"Brepro">,
     56   HelpText<"Emit an object file which can be reproduced over time">,
     57   Alias<mincremental_linker_compatible>;
     58 def _SLASH_Brepro_ : CLFlag<"Brepro-">,
     59   HelpText<"Emit an object file which cannot be reproduced over time">,
     60   Alias<mno_incremental_linker_compatible>;
     61 def _SLASH_C : CLFlag<"C">,
     62   HelpText<"Don't discard comments when preprocessing">, Alias<C>;
     63 def _SLASH_c : CLFlag<"c">, HelpText<"Compile only">, Alias<c>;
     64 def _SLASH_D : CLJoinedOrSeparate<"D">, HelpText<"Define macro">,
     65   MetaVarName<"<macro[=value]>">, Alias<D>;
     66 def _SLASH_E : CLFlag<"E">, HelpText<"Preprocess to stdout">, Alias<E>;
     67 def _SLASH_fp_except : CLFlag<"fp:except">, HelpText<"">, Alias<ftrapping_math>;
     68 def _SLASH_fp_except_ : CLFlag<"fp:except-">,
     69   HelpText<"">, Alias<fno_trapping_math>;
     70 def _SLASH_fp_fast : CLFlag<"fp:fast">, HelpText<"">, Alias<ffast_math>;
     71 def _SLASH_fp_precise : CLFlag<"fp:precise">,
     72   HelpText<"">, Alias<fno_fast_math>;
     73 def _SLASH_fp_strict : CLFlag<"fp:strict">, HelpText<"">, Alias<fno_fast_math>;
     74 def _SLASH_GA : CLFlag<"GA">, Alias<ftlsmodel_EQ>, AliasArgs<["local-exec"]>,
     75   HelpText<"Assume thread-local variables are defined in the executable">;
     76 def _SLASH_GR : CLFlag<"GR">, HelpText<"Enable emission of RTTI data">;
     77 def _SLASH_GR_ : CLFlag<"GR-">, HelpText<"Disable emission of RTTI data">;
     78 def _SLASH_GF_ : CLFlag<"GF-">, HelpText<"Disable string pooling">,
     79   Alias<fwritable_strings>;
     80 def _SLASH_Gs : CLJoined<"Gs">, HelpText<"Set stack probe size">,
     81   Alias<mstack_probe_size>;
     82 def _SLASH_Gy : CLFlag<"Gy">, HelpText<"Put each function in its own section">,
     83   Alias<ffunction_sections>;
     84 def _SLASH_Gy_ : CLFlag<"Gy-">,
     85   HelpText<"Don't put each function in its own section">,
     86   Alias<fno_function_sections>;
     87 def _SLASH_Gw : CLFlag<"Gw">, HelpText<"Put each data item in its own section">,
     88   Alias<fdata_sections>;
     89 def _SLASH_Gw_ : CLFlag<"Gw-">,
     90   HelpText<"Don't put each data item in its own section">,
     91   Alias<fno_data_sections>;
     92 def _SLASH_help : CLFlag<"help">, Alias<help>,
     93   HelpText<"Display available options">;
     94 def _SLASH_HELP : CLFlag<"HELP">, Alias<help>;
     95 def _SLASH_I : CLJoinedOrSeparate<"I">,
     96   HelpText<"Add directory to include search path">, MetaVarName<"<dir>">,
     97   Alias<I>;
     98 def _SLASH_J : CLFlag<"J">, HelpText<"Make char type unsigned">,
     99   Alias<funsigned_char>;
    100 def _SLASH_O0 : CLFlag<"O0">, Alias<O0>;
    101 def _SLASH_O : CLJoined<"O">, HelpText<"Optimization level">;
    102 def _SLASH_Ob0 : CLFlag<"Ob0">, HelpText<"Disable inlining">,
    103   Alias<fno_inline>;
    104 def _SLASH_Od : CLFlag<"Od">, HelpText<"Disable optimization">, Alias<O0>;
    105 def _SLASH_Oi : CLFlag<"Oi">, HelpText<"Enable use of builtin functions">,
    106   Alias<fbuiltin>;
    107 def _SLASH_Oi_ : CLFlag<"Oi-">, HelpText<"Disable use of builtin functions">,
    108   Alias<fno_builtin>;
    109 def _SLASH_Os : CLFlag<"Os">, HelpText<"Optimize for size">, Alias<O>,
    110   AliasArgs<["s"]>;
    111 def _SLASH_Ot : CLFlag<"Ot">, HelpText<"Optimize for speed">, Alias<O>,
    112   AliasArgs<["2"]>;
    113 def _SLASH_QUESTION : CLFlag<"?">, Alias<help>,
    114   HelpText<"Display available options">;
    115 def _SLASH_Qvec : CLFlag<"Qvec">,
    116   HelpText<"Enable the loop vectorization passes">, Alias<fvectorize>;
    117 def _SLASH_Qvec_ : CLFlag<"Qvec-">,
    118   HelpText<"Disable the loop vectorization passes">, Alias<fno_vectorize>;
    119 def _SLASH_showIncludes : CLFlag<"showIncludes">,
    120   HelpText<"Print info about included files to stderr">,
    121   Alias<show_includes>;
    122 def _SLASH_U : CLJoinedOrSeparate<"U">, HelpText<"Undefine macro">,
    123   MetaVarName<"<macro>">, Alias<U>;
    124 def _SLASH_W0 : CLFlag<"W0">, HelpText<"Disable all warnings">, Alias<w>;
    125 def _SLASH_W1 : CLFlag<"W1">, HelpText<"Enable -Wall">, Alias<Wall>;
    126 def _SLASH_W2 : CLFlag<"W2">, HelpText<"Enable -Wall">, Alias<Wall>;
    127 def _SLASH_W3 : CLFlag<"W3">, HelpText<"Enable -Wall">, Alias<Wall>;
    128 def _SLASH_W4 : CLFlag<"W4">, HelpText<"Enable -Wall and -Wextra">, Alias<WCL4>;
    129 def _SLASH_Wall : CLFlag<"Wall">, HelpText<"Enable -Wall and -Wextra">, Alias<WCL4>;
    130 def _SLASH_WX : CLFlag<"WX">, HelpText<"Treat warnings as errors">,
    131   Alias<W_Joined>, AliasArgs<["error"]>;
    132 def _SLASH_WX_ : CLFlag<"WX-">, HelpText<"Do not treat warnings as errors">,
    133   Alias<W_Joined>, AliasArgs<["no-error"]>;
    134 def _SLASH_w_flag : CLFlag<"w">, HelpText<"Disable all warnings">, Alias<w>;
    135 def _SLASH_wd4005 : CLFlag<"wd4005">, Alias<W_Joined>,
    136   AliasArgs<["no-macro-redefined"]>;
    137 def _SLASH_wd4100 : CLFlag<"wd4100">, Alias<W_Joined>,
    138   AliasArgs<["no-unused-parameter"]>;
    139 def _SLASH_wd4910 : CLFlag<"wd4910">, Alias<W_Joined>,
    140   AliasArgs<["no-dllexport-explicit-instantiation-decl"]>;
    141 def _SLASH_wd4996 : CLFlag<"wd4996">, Alias<W_Joined>,
    142   AliasArgs<["no-deprecated-declarations"]>;
    143 def _SLASH_vd : CLJoined<"vd">, HelpText<"Control vtordisp placement">,
    144   Alias<vtordisp_mode_EQ>;
    145 def _SLASH_Zc_sizedDealloc : CLFlag<"Zc:sizedDealloc">,
    146   HelpText<"Enable C++14 sized global deallocation functions">,
    147   Alias<fsized_deallocation>;
    148 def _SLASH_Zc_sizedDealloc_ : CLFlag<"Zc:sizedDealloc-">,
    149   HelpText<"Disable C++14 sized global deallocation functions">,
    150   Alias<fno_sized_deallocation>;
    151 def _SLASH_Zc_strictStrings : CLFlag<"Zc:strictStrings">,
    152   HelpText<"Treat string literals as const">, Alias<W_Joined>,
    153   AliasArgs<["error=c++11-compat-deprecated-writable-strings"]>;
    154 def _SLASH_Zc_threadSafeInit : CLFlag<"Zc:threadSafeInit">,
    155   HelpText<"Enable thread-safe initialization of static variables">,
    156   Alias<fthreadsafe_statics>;
    157 def _SLASH_Zc_threadSafeInit_ : CLFlag<"Zc:threadSafeInit-">,
    158   HelpText<"Disable thread-safe initialization of static variables">,
    159   Alias<fno_threadsafe_statics>;
    160 def _SLASH_Zc_trigraphs : CLFlag<"Zc:trigraphs">,
    161   HelpText<"Enable trigraphs">, Alias<ftrigraphs>;
    162 def _SLASH_Zc_trigraphs_off : CLFlag<"Zc:trigraphs-">,
    163   HelpText<"Disable trigraphs (default)">, Alias<fno_trigraphs>;
    164 def _SLASH_Z7 : CLFlag<"Z7">,
    165   HelpText<"Enable CodeView debug information in object files">;
    166 def _SLASH_Zi : CLFlag<"Zi">, Alias<_SLASH_Z7>,
    167   HelpText<"Alias for /Z7. Does not produce PDBs.">;
    168 def _SLASH_Zp : CLJoined<"Zp">,
    169   HelpText<"Specify the default maximum struct packing alignment">,
    170   Alias<fpack_struct_EQ>;
    171 def _SLASH_Zp_flag : CLFlag<"Zp">,
    172   HelpText<"Set the default maximum struct packing alignment to 1">,
    173   Alias<fpack_struct_EQ>, AliasArgs<["1"]>;
    174 def _SLASH_Zs : CLFlag<"Zs">, HelpText<"Syntax-check only">,
    175   Alias<fsyntax_only>;
    176 
    177 
    178 // Non-aliases:
    179 
    180 def _SLASH_arch : CLCompileJoined<"arch:">,
    181   HelpText<"Set architecture for code generation">;
    182 
    183 def _SLASH_M_Group : OptionGroup<"</M group>">, Group<cl_compile_Group>;
    184 def _SLASH_volatile_Group : OptionGroup<"</volatile group>">,
    185   Group<cl_compile_Group>;
    186 
    187 def _SLASH_EH : CLJoined<"EH">, HelpText<"Exception handling model">;
    188 def _SLASH_EP : CLFlag<"EP">,
    189   HelpText<"Disable linemarker output and preprocess to stdout">;
    190 def _SLASH_FA : CLFlag<"FA">,
    191   HelpText<"Output assembly code file during compilation">;
    192 def _SLASH_Fa : CLJoined<"Fa">,
    193   HelpText<"Output assembly code to this file during compilation (with /FA)">,
    194   MetaVarName<"<file or directory>">;
    195 def _SLASH_fallback : CLCompileFlag<"fallback">,
    196   HelpText<"Fall back to cl.exe if clang-cl fails to compile">;
    197 def _SLASH_FI : CLJoinedOrSeparate<"FI">,
    198   HelpText<"Include file before parsing">, Alias<include_>;
    199 def _SLASH_Fe : CLJoined<"Fe">,
    200   HelpText<"Set output executable file or directory (ends in / or \\)">,
    201   MetaVarName<"<file or directory>">;
    202 def _SLASH_Fi : CLCompileJoined<"Fi">,
    203   HelpText<"Set preprocess output file name (with /P)">,
    204   MetaVarName<"<file>">;
    205 def _SLASH_Fo : CLCompileJoined<"Fo">,
    206   HelpText<"Set output object file, or directory (ends in / or \\) (with /c)">,
    207   MetaVarName<"<file or directory>">;
    208 def _SLASH_LD : CLFlag<"LD">, HelpText<"Create DLL">;
    209 def _SLASH_LDd : CLFlag<"LDd">, HelpText<"Create debug DLL">;
    210 def _SLASH_link : CLRemainingArgs<"link">,
    211   HelpText<"Forward options to the linker">, MetaVarName<"<options>">;
    212 def _SLASH_MD : Option<["/", "-"], "MD", KIND_FLAG>, Group<_SLASH_M_Group>,
    213   Flags<[CLOption, DriverOption]>, HelpText<"Use DLL run-time">;
    214 def _SLASH_MDd : Option<["/", "-"], "MDd", KIND_FLAG>, Group<_SLASH_M_Group>,
    215   Flags<[CLOption, DriverOption]>, HelpText<"Use DLL debug run-time">;
    216 def _SLASH_MT : Option<["/", "-"], "MT", KIND_FLAG>, Group<_SLASH_M_Group>,
    217   Flags<[CLOption, DriverOption]>, HelpText<"Use static run-time">;
    218 def _SLASH_MTd : Option<["/", "-"], "MTd", KIND_FLAG>, Group<_SLASH_M_Group>,
    219   Flags<[CLOption, DriverOption]>, HelpText<"Use static debug run-time">;
    220 def _SLASH_o : CLJoinedOrSeparate<"o">,
    221   HelpText<"Set output file or directory (ends in / or \\)">,
    222   MetaVarName<"<file or directory>">;
    223 def _SLASH_P : CLFlag<"P">, HelpText<"Preprocess to file">;
    224 def _SLASH_Tc : CLCompileJoinedOrSeparate<"Tc">,
    225   HelpText<"Specify a C source file">, MetaVarName<"<filename>">;
    226 def _SLASH_TC : CLCompileFlag<"TC">, HelpText<"Treat all source files as C">;
    227 def _SLASH_Tp : CLCompileJoinedOrSeparate<"Tp">,
    228   HelpText<"Specify a C++ source file">, MetaVarName<"<filename>">;
    229 def _SLASH_TP : CLCompileFlag<"TP">, HelpText<"Treat all source files as C++">;
    230 def _SLASH_volatile_iso : Option<["/", "-"], "volatile:iso", KIND_FLAG>,
    231   Group<_SLASH_volatile_Group>, Flags<[CLOption, DriverOption]>,
    232   HelpText<"Volatile loads and stores have standard semantics">;
    233 def _SLASH_vmb : CLFlag<"vmb">,
    234   HelpText<"Use a best-case representation method for member pointers">;
    235 def _SLASH_vmg : CLFlag<"vmg">,
    236   HelpText<"Use a most-general representation for member pointers">;
    237 def _SLASH_vms : CLFlag<"vms">,
    238   HelpText<"Set the default most-general representation to single inheritance">;
    239 def _SLASH_vmm : CLFlag<"vmm">,
    240   HelpText<"Set the default most-general representation to "
    241            "multiple inheritance">;
    242 def _SLASH_vmv : CLFlag<"vmv">,
    243   HelpText<"Set the default most-general representation to "
    244            "virtual inheritance">;
    245 def _SLASH_volatile_ms  : Option<["/", "-"], "volatile:ms", KIND_FLAG>,
    246   Group<_SLASH_volatile_Group>, Flags<[CLOption, DriverOption]>,
    247   HelpText<"Volatile loads and stores have acquire and release semantics">;
    248 def _SLASH_Zl : CLFlag<"Zl">,
    249   HelpText<"Don't mention any default libraries in the object file">;
    250 
    251 // Ignored:
    252 
    253 def _SLASH_analyze_ : CLIgnoredFlag<"analyze-">;
    254 def _SLASH_bigobj : CLIgnoredFlag<"bigobj">;
    255 def _SLASH_cgthreads : CLIgnoredJoined<"cgthreads">;
    256 def _SLASH_d2Zi_PLUS : CLIgnoredFlag<"d2Zi+">;
    257 def _SLASH_errorReport : CLIgnoredJoined<"errorReport">;
    258 def _SLASH_Fd : CLIgnoredJoined<"Fd">;
    259 def _SLASH_FS : CLIgnoredFlag<"FS">, HelpText<"Force synchronous PDB writes">;
    260 def _SLASH_Gd : CLIgnoredFlag<"Gd">;
    261 def _SLASH_GF : CLIgnoredFlag<"GF">;
    262 def _SLASH_GS_ : CLIgnoredFlag<"GS-">;
    263 def _SLASH_kernel_ : CLIgnoredFlag<"kernel-">;
    264 def _SLASH_nologo : CLIgnoredFlag<"nologo">;
    265 def _SLASH_Ob1 : CLIgnoredFlag<"Ob1">;
    266 def _SLASH_Ob2 : CLIgnoredFlag<"Ob2">;
    267 def _SLASH_Og : CLIgnoredFlag<"Og">;
    268 def _SLASH_openmp_ : CLIgnoredFlag<"openmp-">;
    269 def _SLASH_RTC : CLIgnoredJoined<"RTC">;
    270 def _SLASH_sdl : CLIgnoredFlag<"sdl">;
    271 def _SLASH_sdl_ : CLIgnoredFlag<"sdl-">;
    272 def _SLASH_w : CLIgnoredJoined<"w">;
    273 def _SLASH_Zc_auto : CLIgnoredFlag<"Zc:auto">;
    274 def _SLASH_Zc_forScope : CLIgnoredFlag<"Zc:forScope">;
    275 def _SLASH_Zc_inline : CLIgnoredFlag<"Zc:inline">;
    276 def _SLASH_Zc_rvalueCast : CLIgnoredFlag<"Zc:rvalueCast">;
    277 def _SLASH_Zc_wchar_t : CLIgnoredFlag<"Zc:wchar_t">;
    278 def _SLASH_Zm : CLIgnoredJoined<"Zm">;
    279 def _SLASH_Zo : CLIgnoredFlag<"Zo">;
    280 def _SLASH_Zo_ : CLIgnoredFlag<"Zo-">;
    281 
    282 
    283 // Unsupported:
    284 
    285 def _SLASH_AI : CLJoined<"AI">;
    286 def _SLASH_clr : CLJoined<"clr">;
    287 def _SLASH_doc : CLJoined<"doc">;
    288 def _SLASH_FA_joined : CLJoined<"FA">;
    289 def _SLASH_favor : CLJoined<"favor">;
    290 def _SLASH_FC : CLFlag<"FC">;
    291 def _SLASH_F : CLFlag<"F">;
    292 def _SLASH_Fm : CLJoined<"Fm">;
    293 def _SLASH_Fp : CLJoined<"Fp">;
    294 def _SLASH_Fr : CLJoined<"Fr">;
    295 def _SLASH_FR : CLJoined<"FR">;
    296 def _SLASH_FU : CLJoinedOrSeparate<"FU">;
    297 def _SLASH_Fx : CLFlag<"Fx">;
    298 def _SLASH_G1 : CLFlag<"G1">;
    299 def _SLASH_G2 : CLFlag<"G2">;
    300 def _SLASH_Ge : CLFlag<"Ge">;
    301 def _SLASH_Gh : CLFlag<"Gh">;
    302 def _SLASH_GH : CLFlag<"GH">;
    303 def _SLASH_GL : CLFlag<"GL">;
    304 def _SLASH_GL_ : CLFlag<"GL-">;
    305 def _SLASH_Gm : CLFlag<"Gm">;
    306 def _SLASH_Gm_ : CLFlag<"Gm-">;
    307 def _SLASH_Gr : CLFlag<"Gr">;
    308 def _SLASH_GS : CLFlag<"GS">;
    309 def _SLASH_GT : CLFlag<"GT">;
    310 def _SLASH_Guard : CLJoined<"guard:">;
    311 def _SLASH_GX : CLFlag<"GX">;
    312 def _SLASH_Gv : CLFlag<"Gv">;
    313 def _SLASH_Gz : CLFlag<"Gz">;
    314 def _SLASH_GZ : CLFlag<"GZ">;
    315 def _SLASH_H : CLFlag<"H">;
    316 def _SLASH_homeparams : CLFlag<"homeparams">;
    317 def _SLASH_hotpatch : CLFlag<"hotpatch">;
    318 def _SLASH_kernel : CLFlag<"kernel">;
    319 def _SLASH_LN : CLFlag<"LN">;
    320 def _SLASH_MP : CLJoined<"MP">;
    321 def _SLASH_openmp : CLFlag<"openmp">;
    322 def _SLASH_Qfast_transcendentals : CLFlag<"Qfast_transcendentals">;
    323 def _SLASH_QIfist : CLFlag<"QIfist">;
    324 def _SLASH_Qimprecise_fwaits : CLFlag<"Qimprecise_fwaits">;
    325 def _SLASH_Qpar : CLFlag<"Qpar">;
    326 def _SLASH_Qvec_report : CLJoined<"Qvec-report">;
    327 def _SLASH_u : CLFlag<"u">;
    328 def _SLASH_V : CLFlag<"V">;
    329 def _SLASH_WL : CLFlag<"WL">;
    330 def _SLASH_Wp64 : CLFlag<"Wp64">;
    331 def _SLASH_X : CLFlag<"X">;
    332 def _SLASH_Yc : CLJoined<"Yc">;
    333 def _SLASH_Y_ : CLFlag<"Y-">;
    334 def _SLASH_Yd : CLFlag<"Yd">;
    335 def _SLASH_Yl : CLJoined<"Yl">;
    336 def _SLASH_Yu : CLJoined<"Yu">;
    337 def _SLASH_Za : CLFlag<"Za">;
    338 def _SLASH_Zc : CLJoined<"Zc:">;
    339 def _SLASH_Ze : CLFlag<"Ze">;
    340 def _SLASH_Zg : CLFlag<"Zg">;
    341 def _SLASH_ZI : CLFlag<"ZI">;
    342 def _SLASH_ZW : CLJoined<"ZW">;
    343