include/clang/Driver/CLCompatOptions.td

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