include/clang/Driver/CC1Options.td

   1 //===--- CC1Options.td - Options for clang -cc1 ---------------------------===//
   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 -cc1.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 // Include the common option parsing interfaces.
  15 include "OptParser.td"
  16
  17 //===----------------------------------------------------------------------===//
  18 // Target Options
  19 //===----------------------------------------------------------------------===//
  20
  21 def cxx_abi : Separate<"-cxx-abi">,
  22   HelpText<"Target a particular C++ ABI type">;
  23 def target_abi : Separate<"-target-abi">,
  24   HelpText<"Target a particular ABI type">;
  25 def target_cpu : Separate<"-target-cpu">,
  26   HelpText<"Target a specific cpu type">;
  27 def target_feature : Separate<"-target-feature">,
  28   HelpText<"Target specific attributes">;
  29 def target_linker_version : Separate<"-target-linker-version">,
  30   HelpText<"Target linker version">;
  31 def triple : Separate<"-triple">,
  32   HelpText<"Specify target triple (e.g. i686-apple-darwin9)">;
  33 def triple_EQ : Joined<"-triple=">, Alias<triple>;
  34
  35 //===----------------------------------------------------------------------===//
  36 // Analyzer Options
  37 //===----------------------------------------------------------------------===//
  38
  39 def analysis_CFGDump : Flag<"-cfg-dump">,
  40   HelpText<"Display Control-Flow Graphs">;
  41 def analysis_CFGView : Flag<"-cfg-view">,
  42   HelpText<"View Control-Flow Graphs using GraphViz">;
  43 def analysis_UnoptimizedCFG : Flag<"-unoptimized-cfg">,
  44   HelpText<"Generate unoptimized CFGs for all analyses">;
  45 def analysis_CFGAddImplicitDtors : Flag<"-cfg-add-implicit-dtors">,
  46   HelpText<"Add C++ implicit destructors to CFGs for all analyses">;
  47 def analysis_CFGAddInitializers : Flag<"-cfg-add-initializers">,
  48   HelpText<"Add C++ initializers to CFGs for all analyses">;
  49 def analysis_DisplayLiveVariables : Flag<"-dump-live-variables">,
  50   HelpText<"Print results of live variable analysis">;
  51 def analysis_WarnUninitVals : Flag<"-warn-uninit-values">,
  52   HelpText<"Warn about uses of uninitialized variables">;
  53 def analysis_ObjCMemChecker : Flag<"-analyzer-check-objc-mem">,
  54   HelpText<"Run the [Core] Foundation reference count checker">;
  55 def analysis_AnalyzerStats : Flag<"-analyzer-stats">,
  56   HelpText<"Emit warnings with analyzer statistics">;
  57 def analysis_WarnBufferOverflows : Flag<"-analyzer-check-buffer-overflows">,
  58   HelpText<"Warn about buffer overflows">;
  59
  60 def analyzer_store : Separate<"-analyzer-store">,
  61   HelpText<"Source Code Analysis - Abstract Memory Store Models">;
  62 def analyzer_store_EQ : Joined<"-analyzer-store=">, Alias<analyzer_store>;
  63
  64 def analyzer_constraints : Separate<"-analyzer-constraints">,
  65   HelpText<"Source Code Analysis - Symbolic Constraint Engines">;
  66 def analyzer_constraints_EQ : Joined<"-analyzer-constraints=">,
  67   Alias<analyzer_constraints>;
  68
  69 def analyzer_output : Separate<"-analyzer-output">,
  70   HelpText<"Source Code Analysis - Output Options">;
  71 def analyzer_output_EQ : Joined<"-analyzer-output=">,
  72   Alias<analyzer_output>;
  73
  74 def analyzer_opt_analyze_headers : Flag<"-analyzer-opt-analyze-headers">,
  75   HelpText<"Force the static analyzer to analyze functions defined in header files">;
  76 def analyzer_opt_analyze_nested_blocks : Flag<"-analyzer-opt-analyze-nested-blocks">,
  77   HelpText<"Analyze the definitions of blocks in addition to functions">;
  78 def analyzer_display_progress : Flag<"-analyzer-display-progress">,
  79   HelpText<"Emit verbose output about the analyzer's progress">;
  80 def analyzer_experimental_checks : Flag<"-analyzer-experimental-checks">,
  81   HelpText<"Use experimental path-sensitive checks">;
  82 def analyzer_experimental_internal_checks :
  83   Flag<"-analyzer-experimental-internal-checks">,
  84   HelpText<"Use new default path-sensitive checks currently in testing">;
  85 def analyze_function : Separate<"-analyze-function">,
  86   HelpText<"Run analysis on specific function">;
  87 def analyze_function_EQ : Joined<"-analyze-function=">, Alias<analyze_function>;
  88 def analyzer_eagerly_assume : Flag<"-analyzer-eagerly-assume">,
  89   HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">;
  90 def analyzer_no_purge_dead : Flag<"-analyzer-no-purge-dead">,
  91   HelpText<"Don't remove dead symbols, bindings, and constraints before processing a statement">;
  92 def analyzer_no_eagerly_trim_egraph : Flag<"-analyzer-no-eagerly-trim-egraph">,
  93   HelpText<"Don't eagerly remove uninteresting ExplodedNodes from the ExplodedGraph">;
  94 def trim_egraph : Flag<"-trim-egraph">,
  95   HelpText<"Only show error-related paths in the analysis graph">;
  96 def analyzer_viz_egraph_graphviz : Flag<"-analyzer-viz-egraph-graphviz">,
  97   HelpText<"Display exploded graph using GraphViz">;
  98 def analyzer_viz_egraph_ubigraph : Flag<"-analyzer-viz-egraph-ubigraph">,
  99   HelpText<"Display exploded graph using Ubigraph">;
 100 def analyzer_inline_call : Flag<"-analyzer-inline-call">,
 101   HelpText<"Experimental transfer function inlining callees when its definition is available.">;
 102 def analyzer_max_nodes : Separate<"-analyzer-max-nodes">,
 103   HelpText<"The maximum number of nodes the analyzer can generate (150000 default, 0 = no limit)">;
 104 def analyzer_max_loop : Separate<"-analyzer-max-loop">,
 105   HelpText<"The maximum number of times the analyzer will go through a loop">;
 106
 107 def analyzer_checker : Separate<"-analyzer-checker">,
 108   HelpText<"Choose analyzer checkers to enable">;
 109 def analyzer_checker_EQ : Joined<"-analyzer-checker=">,
 110   Alias<analyzer_checker>;
 111
 112 def analyzer_disable_checker : Separate<"-analyzer-disable-checker">,
 113   HelpText<"Choose analyzer checkers to disable">;
 114 def analyzer_disable_checker_EQ : Joined<"-analyzer-disable-checker=">,
 115   Alias<analyzer_disable_checker>;
 116
 117 //===----------------------------------------------------------------------===//
 118 // CodeGen Options
 119 //===----------------------------------------------------------------------===//
 120
 121 def disable_llvm_optzns : Flag<"-disable-llvm-optzns">,
 122   HelpText<"Don't run LLVM optimization passes">;
 123 def disable_llvm_verifier : Flag<"-disable-llvm-verifier">,
 124   HelpText<"Don't run the LLVM IR verifier pass">;
 125 def disable_red_zone : Flag<"-disable-red-zone">,
 126   HelpText<"Do not emit code that uses the red zone.">;
 127 def dwarf_debug_flags : Separate<"-dwarf-debug-flags">,
 128   HelpText<"The string to embed in the Dwarf debug flags record.">;
 129 def g : Flag<"-g">, HelpText<"Generate source level debug information">;
 130 def fcatch_undefined_behavior : Flag<"-fcatch-undefined-behavior">,
 131     HelpText<"Generate runtime checks for undefined behavior.">;
 132 def flimit_debug_info : Flag<"-flimit-debug-info">,
 133   HelpText<"Limit debug information produced to reduce size of debug binary">;
 134 def fno_common : Flag<"-fno-common">,
 135   HelpText<"Compile common globals like normal definitions">;
 136 def no_implicit_float : Flag<"-no-implicit-float">,
 137   HelpText<"Don't generate implicit floating point instructions (x86-only)">;
 138 def finstrument_functions : Flag<"-finstrument-functions">,
 139   HelpText<"Generate calls to instrument function entry and exit">;
 140 def fno_merge_all_constants : Flag<"-fno-merge-all-constants">,
 141   HelpText<"Disallow merging of constants.">;
 142 def fno_threadsafe_statics : Flag<"-fno-threadsafe-statics">,
 143   HelpText<"Do not emit code to make initialization of local statics thread safe">;
 144 def fdump_vtable_layouts : Flag<"-fdump-vtable-layouts">,
 145   HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
 146 def ffunction_sections : Flag<"-ffunction-sections">,
 147   HelpText<"Place each function in its own section (ELF Only)">;
 148 def fdata_sections : Flag<"-fdata-sections">,
 149   HelpText<"Place each data in its own section (ELF Only)">;
 150 def funroll_loops : Flag<"-funroll-loops">,
 151   HelpText<"Turn on loop unroller">;
 152 def relaxed_aliasing : Flag<"-relaxed-aliasing">,
 153   HelpText<"Turn off Type Based Alias Analysis">;
 154 def masm_verbose : Flag<"-masm-verbose">,
 155   HelpText<"Generate verbose assembly output">;
 156 def mcode_model : Separate<"-mcode-model">,
 157   HelpText<"The code model to use">;
 158 def mdebug_pass : Separate<"-mdebug-pass">,
 159   HelpText<"Enable additional debug output">;
 160 def mdisable_fp_elim : Flag<"-mdisable-fp-elim">,
 161   HelpText<"Disable frame pointer elimination optimization">;
 162 def mfloat_abi : Separate<"-mfloat-abi">,
 163   HelpText<"The float ABI to use">;
 164 def mlimit_float_precision : Separate<"-mlimit-float-precision">,
 165   HelpText<"Limit float precision to the given value">;
 166 def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">,
 167   HelpText<"Do not put zero initialized data in the BSS">;
 168 def momit_leaf_frame_pointer : Flag<"-momit-leaf-frame-pointer">,
 169   HelpText<"Omit frame pointer setup for leaf functions.">;
 170 def msoft_float : Flag<"-msoft-float">,
 171   HelpText<"Use software floating point">;
 172 def mregparm : Separate<"-mregparm">,
 173   HelpText<"Limit the number of registers available for integer arguments">;
 174 def mrelax_all : Flag<"-mrelax-all">,
 175   HelpText<"Relax all machine instructions">;
 176 def mrelocation_model : Separate<"-mrelocation-model">,
 177   HelpText<"The relocation model to use">;
 178 def munwind_tables : Flag<"-munwind-tables">,
 179   HelpText<"Generate unwinding tables for all functions">;
 180 def mconstructor_aliases : Flag<"-mconstructor-aliases">,
 181   HelpText<"Emit complete constructors and destructors as aliases when possible">;
 182 def mms_bitfields : Flag<"-mms-bitfields">,
 183   HelpText<"Set the default structure layout to be compatible with the Microsoft compiler standard.">;
 184 def O : Joined<"-O">, HelpText<"Optimization level">;
 185 def Os : Flag<"-Os">, HelpText<"Optimize for size">;
 186 def pg : Flag<"-pg">, HelpText<"Enable mcount instrumentation">;
 187
 188 //===----------------------------------------------------------------------===//
 189 // Dependency Output Options
 190 //===----------------------------------------------------------------------===//
 191
 192 def dependency_file : Separate<"-dependency-file">,
 193   HelpText<"Filename (or -) to write dependency output to">;
 194 def sys_header_deps : Flag<"-sys-header-deps">,
 195   HelpText<"Include system headers in dependency output">;
 196 def header_include_file : Separate<"-header-include-file">,
 197   HelpText<"Filename (or -) to write header include output to">;
 198 def H : Flag<"-H">,
 199   HelpText<"Show header includes and nesting depth">;
 200 def MQ : Separate<"-MQ">, HelpText<"Specify target to quote for dependency">;
 201 def MT : Separate<"-MT">, HelpText<"Specify target for dependency">;
 202 def MP : Flag<"-MP">,
 203   HelpText<"Create phony target for each dependency (other than main file)">;
 204
 205 //===----------------------------------------------------------------------===//
 206 // Diagnostic Options
 207 //===----------------------------------------------------------------------===//
 208
 209 def dump_build_information : Separate<"-dump-build-information">,
 210   MetaVarName<"<filename>">,
 211   HelpText<"output a dump of some build information to a file">;
 212 def fno_show_column : Flag<"-fno-show-column">,
 213   HelpText<"Do not include column number on diagnostics">;
 214 def fno_show_source_location : Flag<"-fno-show-source-location">,
 215   HelpText<"Do not include source location information with diagnostics">;
 216 def fshow_overloads_EQ : Joined<"-fshow-overloads=">,
 217   HelpText<"Which overload candidates to show when overload resolution fails: "
 218            "best|all; defaults to all">;
 219 def fno_caret_diagnostics : Flag<"-fno-caret-diagnostics">,
 220   HelpText<"Do not include source line and caret with diagnostics">;
 221 def fno_diagnostics_fixit_info : Flag<"-fno-diagnostics-fixit-info">,
 222   HelpText<"Do not include fixit information in diagnostics">;
 223 def w : Flag<"-w">, HelpText<"Suppress all warnings">;
 224 def pedantic : Flag<"-pedantic">;
 225 def pedantic_errors : Flag<"-pedantic-errors">;
 226
 227 // This gets all -W options, including -Werror, -W[no-]system-headers, etc.  The
 228 // driver has stripped off -Wa,foo etc.  The driver has also translated -W to
 229 // -Wextra, so we don't need to worry about it.
 230 def W : Joined<"-W">;
 231
 232 def fdiagnostics_print_source_range_info : Flag<"-fdiagnostics-print-source-range-info">,
 233   HelpText<"Print source range spans in numeric form">;
 234 def fdiagnostics_parseable_fixits : Flag<"-fdiagnostics-parseable-fixits">,
 235   HelpText<"Print fix-its in machine parseable form">;
 236 def fdiagnostics_show_option : Flag<"-fdiagnostics-show-option">,
 237   HelpText<"Print diagnostic name with mappable diagnostics">;
 238 def fdiagnostics_show_category : Separate<"-fdiagnostics-show-category">,
 239   HelpText<"Print diagnostic category">;
 240
 241 def ftabstop : Separate<"-ftabstop">, MetaVarName<"<N>">,
 242   HelpText<"Set the tab stop distance.">;
 243 def ferror_limit : Separate<"-ferror-limit">, MetaVarName<"<N>">,
 244   HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
 245 def fmacro_backtrace_limit : Separate<"-fmacro-backtrace-limit">, MetaVarName<"<N>">,
 246   HelpText<"Set the maximum number of entries to print in a macro instantiation backtrace (0 = no limit).">;
 247 def ftemplate_backtrace_limit : Separate<"-ftemplate-backtrace-limit">, MetaVarName<"<N>">,
 248   HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
 249 def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">,
 250   HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
 251 def fcolor_diagnostics : Flag<"-fcolor-diagnostics">,
 252   HelpText<"Use colors in diagnostics">;
 253 def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">,
 254   HelpText<"Silence ObjC rewriting warnings">;
 255 def Wwrite_strings : Flag<"-Wwrite-strings">,
 256   HelpText<"Remove const qualifier from string literals">;
 257 def verify : Flag<"-verify">,
 258   HelpText<"Verify emitted diagnostics and warnings">;
 259
 260 //===----------------------------------------------------------------------===//
 261 // Frontend Options
 262 //===----------------------------------------------------------------------===//
 263
 264 // This isn't normally used, it is just here so we can parse a
 265 // CompilerInvocation out of a driver-derived argument vector.
 266 def cc1 : Flag<"-cc1">;
 267
 268 def ast_merge : Separate<"-ast-merge">,
 269   MetaVarName<"<ast file>">,
 270   HelpText<"Merge the given AST file into the translation unit being compiled.">;
 271 def code_completion_at : Separate<"-code-completion-at">,
 272   MetaVarName<"<file>:<line>:<column>">,
 273   HelpText<"Dump code-completion information at a location">;
 274 def remap_file : Separate<"-remap-file">,
 275   MetaVarName<"<from>;<to>">,
 276   HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
 277 def code_completion_at_EQ : Joined<"-code-completion-at=">,
 278   Alias<code_completion_at>;
 279 def code_completion_macros : Flag<"-code-completion-macros">,
 280   HelpText<"Include macros in code-completion results">;
 281 def code_completion_patterns : Flag<"-code-completion-patterns">,
 282   HelpText<"Include code patterns in code-completion results">;
 283 def no_code_completion_globals : Flag<"-no-code-completion-globals">,
 284   HelpText<"Do not include global declarations in code-completion results.">;
 285 def disable_free : Flag<"-disable-free">,
 286   HelpText<"Disable freeing of memory on exit">;
 287 def help : Flag<"-help">,
 288   HelpText<"Print this help text">;
 289 def _help : Flag<"--help">, Alias<help>;
 290 def x : Separate<"-x">, HelpText<"Input language type">;
 291 def o : Separate<"-o">, MetaVarName<"<path>">, HelpText<"Specify output file">;
 292 def load : Separate<"-load">, MetaVarName<"<dsopath>">,
 293   HelpText<"Load the named plugin (dynamic shared object)">;
 294 def plugin : Separate<"-plugin">, MetaVarName<"<name>">,
 295   HelpText<"Use the named plugin action instead of the default action (use \"help\" to list available options)">;
 296 def plugin_arg : JoinedAndSeparate<"-plugin-arg-">,
 297     MetaVarName<"<name> <arg>">,
 298     HelpText<"Pass <arg> to plugin <name>">;
 299 def add_plugin : Separate<"-add-plugin">, MetaVarName<"<name>">,
 300   HelpText<"Use the named plugin action in addition to the default action">;
 301 def resource_dir : Separate<"-resource-dir">,
 302   HelpText<"The directory which holds the compiler resource files">;
 303 def version : Flag<"-version">,
 304   HelpText<"Print the compiler version">;
 305 def _version : Flag<"--version">, Alias<version>;
 306
 307 def Action_Group : OptionGroup<"<action group>">;
 308 let Group = Action_Group in {
 309
 310 def Eonly : Flag<"-Eonly">,
 311   HelpText<"Just run preprocessor, no output (for timings)">;
 312 def E : Flag<"-E">,
 313   HelpText<"Run preprocessor, emit preprocessed file">;
 314 def dump_raw_tokens : Flag<"-dump-raw-tokens">,
 315   HelpText<"Lex file in raw mode and dump raw tokens">;
 316 def analyze : Flag<"-analyze">,
 317   HelpText<"Run static analysis engine">;
 318 def dump_tokens : Flag<"-dump-tokens">,
 319   HelpText<"Run preprocessor, dump internal rep of tokens">;
 320 def init_only : Flag<"-init-only">,
 321   HelpText<"Only execute frontend initialization">;
 322 def fsyntax_only : Flag<"-fsyntax-only">,
 323   HelpText<"Run parser and perform semantic analysis">;
 324 def fixit : Flag<"-fixit">,
 325   HelpText<"Apply fix-it advice to the input source">;
 326 def fixit_EQ : Joined<"-fixit=">,
 327   HelpText<"Apply fix-it advice creating a file with the given suffix">;
 328 def print_preamble : Flag<"-print-preamble">,
 329   HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
 330            " precompiled headers.">;
 331 def emit_html : Flag<"-emit-html">,
 332   HelpText<"Output input source as HTML">;
 333 def ast_print : Flag<"-ast-print">,
 334   HelpText<"Build ASTs and then pretty-print them">;
 335 def ast_print_xml : Flag<"-ast-print-xml">,
 336   HelpText<"Build ASTs and then print them in XML format">;
 337 def ast_dump : Flag<"-ast-dump">,
 338   HelpText<"Build ASTs and then debug dump them">;
 339 def ast_dump_xml : Flag<"-ast-dump-xml">,
 340   HelpText<"Build ASTs and then debug dump them in a verbose XML format">;
 341 def ast_view : Flag<"-ast-view">,
 342   HelpText<"Build ASTs and view them with GraphViz">;
 343 def boostcon : Flag<"-boostcon">,
 344   HelpText<"BoostCon workshop mode">;
 345 def print_decl_contexts : Flag<"-print-decl-contexts">,
 346   HelpText<"Print DeclContexts and their Decls">;
 347 def emit_pth : Flag<"-emit-pth">,
 348   HelpText<"Generate pre-tokenized header file">;
 349 def emit_pch : Flag<"-emit-pch">,
 350   HelpText<"Generate pre-compiled header file">;
 351 def S : Flag<"-S">,
 352   HelpText<"Emit native assembly code">;
 353 def emit_llvm : Flag<"-emit-llvm">,
 354   HelpText<"Build ASTs then convert to LLVM, emit .ll file">;
 355 def emit_llvm_bc : Flag<"-emit-llvm-bc">,
 356   HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
 357 def emit_llvm_only : Flag<"-emit-llvm-only">,
 358   HelpText<"Build ASTs and convert to LLVM, discarding output">;
 359 def emit_codegen_only : Flag<"-emit-codegen-only">,
 360   HelpText<"Generate machine code, but discard output">;
 361 def emit_obj : Flag<"-emit-obj">,
 362   HelpText<"Emit native object files">;
 363 def rewrite_test : Flag<"-rewrite-test">,
 364   HelpText<"Rewriter playground">;
 365 def rewrite_objc : Flag<"-rewrite-objc">,
 366   HelpText<"Rewrite ObjC into C (code rewriter example)">;
 367 def rewrite_macros : Flag<"-rewrite-macros">,
 368   HelpText<"Expand macros without full preprocessing">;
 369
 370 def create_module : Flag<"-create-module">,
 371   HelpText<"Create a module definition file">;
 372 }
 373
 374 def import_module : Separate<"-import-module">,
 375   HelpText<"Import a module definition file">;
 376
 377 def working_directory : JoinedOrSeparate<"-working-directory">,
 378   HelpText<"Resolve file paths relative to the specified directory">;
 379 def working_directory_EQ : Joined<"-working-directory=">,
 380   Alias<working_directory>;
 381
 382 def relocatable_pch : Flag<"-relocatable-pch">,
 383   HelpText<"Whether to build a relocatable precompiled header">;
 384 def chained_pch : Flag<"-chained-pch">,
 385   HelpText<"Whether to chain the new precompiled header to the old one.">;
 386 def print_stats : Flag<"-print-stats">,
 387   HelpText<"Print performance metrics and statistics">;
 388 def ftime_report : Flag<"-ftime-report">,
 389   HelpText<"Print the amount of time each phase of compilation takes">;
 390 def fdump_record_layouts : Flag<"-fdump-record-layouts">,
 391   HelpText<"Dump record layout information">;
 392 def fix_what_you_can : Flag<"-fix-what-you-can">,
 393   HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
 394
 395 // Generic forwarding to LLVM options. This should only be used for debugging
 396 // and experimental features.
 397 def mllvm : Separate<"-mllvm">,
 398   HelpText<"Additional arguments to forward to LLVM's option processing">;
 399
 400 //===----------------------------------------------------------------------===//
 401 // Language Options
 402 //===----------------------------------------------------------------------===//
 403
 404 def fno_builtin : Flag<"-fno-builtin">,
 405   HelpText<"Disable implicit builtin knowledge of functions">;
 406 def faltivec : Flag<"-faltivec">,
 407   HelpText<"Enable AltiVec vector initializer syntax">;
 408 def fno_access_control : Flag<"-fno-access-control">,
 409   HelpText<"Disable C++ access control">;
 410 def fno_assume_sane_operator_new : Flag<"-fno-assume-sane-operator-new">,
 411   HelpText<"Don't assume that C++'s global operator new can't alias any pointer">;
 412 def fgnu_keywords : Flag<"-fgnu-keywords">,
 413   HelpText<"Allow GNU-extension keywords regardless of language standard">;
 414 def fno_gnu_keywords : Flag<"-fno-gnu-keywords">,
 415   HelpText<"Disallow GNU-extension keywords regardless of language standard">;
 416 def fdollars_in_identifiers : Flag<"-fdollars-in-identifiers">,
 417   HelpText<"Allow '$' in identifiers">;
 418 def fno_dollars_in_identifiers : Flag<"-fno-dollars-in-identifiers">,
 419   HelpText<"Disallow '$' in identifiers">;
 420 def femit_all_decls : Flag<"-femit-all-decls">,
 421   HelpText<"Emit all declarations, even if unused">;
 422 def fblocks : Flag<"-fblocks">,
 423   HelpText<"enable the 'blocks' language feature">;
 424 def fheinous_gnu_extensions : Flag<"-fheinous-gnu-extensions">;
 425 def fexceptions : Flag<"-fexceptions">,
 426   HelpText<"Enable support for exception handling">;
 427 def fsjlj_exceptions : Flag<"-fsjlj-exceptions">,
 428   HelpText<"Use SjLj style exceptions">;
 429 def ffreestanding : Flag<"-ffreestanding">,
 430   HelpText<"Assert that the compilation takes place in a freestanding environment">;
 431 def fgnu_runtime : Flag<"-fgnu-runtime">,
 432   HelpText<"Generate output compatible with the standard GNU Objective-C runtime">;
 433 def fhidden_weak_vtables : Flag<"-fhidden-weak-vtables">,
 434   HelpText<"Generate weak vtables and RTTI with hidden visibility">;
 435 def std_EQ : Joined<"-std=">,
 436   HelpText<"Language standard to compile for">;
 437 def fmath_errno : Flag<"-fmath-errno">,
 438   HelpText<"Require math functions to indicate errors by setting errno">;
 439 def fms_extensions : Flag<"-fms-extensions">,
 440   HelpText<"Accept some non-standard constructs used in Microsoft header files ">;
 441 def fmsc_version : Joined<"-fmsc-version=">,
 442   HelpText<"Version of the Microsoft C/C++ compiler to report in _MSC_VER (0 = don't define it (default))">;
 443 def fborland_extensions : Flag<"-fborland-extensions">,
 444   HelpText<"Accept non-standard constructs supported by the Borland compiler">;
 445 def main_file_name : Separate<"-main-file-name">,
 446   HelpText<"Main file name to use for debug info">;
 447 def fno_elide_constructors : Flag<"-fno-elide-constructors">,
 448   HelpText<"Disable C++ copy constructor elision">;
 449 def fno_lax_vector_conversions : Flag<"-fno-lax-vector-conversions">,
 450   HelpText<"Disallow implicit conversions between vectors with a different number of elements or different element types">;
 451 def fno_operator_names : Flag<"-fno-operator-names">,
 452   HelpText<"Do not treat C++ operator name keywords as synonyms for operators">;
 453 def fno_signed_char : Flag<"-fno-signed-char">,
 454   HelpText<"Char is unsigned">;
 455 def fno_spell_checking : Flag<"-fno-spell-checking">,
 456   HelpText<"Disable spell-checking">;
 457 def fno_use_cxa_atexit : Flag<"-fno-use-cxa-atexit">,
 458   HelpText<"Don't use __cxa_atexit for calling destructors">;
 459 def fconstant_string_class : Separate<"-fconstant-string-class">,
 460   MetaVarName<"<class name>">,
 461   HelpText<"Specify the class to use for constant Objective-C string objects.">;
 462 def fno_constant_cfstrings : Flag<"-fno-constant-cfstrings">,
 463   HelpText<"Enable creation of CodeFoundation-type constant strings">;
 464 def fobjc_gc : Flag<"-fobjc-gc">,
 465   HelpText<"Enable Objective-C garbage collection">;
 466 def fobjc_gc_only : Flag<"-fobjc-gc-only">,
 467   HelpText<"Use GC exclusively for Objective-C related memory management">;
 468 def fapple_kext : Flag<"-fapple-kext">,
 469   HelpText<"Use Apple's kernel extensions ABI">;
 470 def fobjc_dispatch_method_EQ : Joined<"-fobjc-dispatch-method=">,
 471   HelpText<"Objective-C dispatch method to use">;
 472 def fobjc_default_synthesize_properties : Flag<"-fobjc-default-synthesize-properties">,
 473   HelpText<"enable the default synthesis of Objective-C properties">;
 474 def print_ivar_layout : Flag<"-print-ivar-layout">,
 475   HelpText<"Enable Objective-C Ivar layout bitmap print trace">;
 476 def fobjc_nonfragile_abi : Flag<"-fobjc-nonfragile-abi">,
 477   HelpText<"enable objective-c's nonfragile abi">;
 478 def ftrapv : Flag<"-ftrapv">,
 479   HelpText<"Trap on integer overflow">;
 480 def ftrapv_handler : Separate<"-ftrapv-handler">,
 481   MetaVarName<"<function name>">,
 482   HelpText<"Specify the function to be called on overflow.">;
 483 def fwrapv : Flag<"-fwrapv">,
 484   HelpText<"Treat signed integer overflow as two's complement">;
 485 def pic_level : Separate<"-pic-level">,
 486   HelpText<"Value for __PIC__">;
 487 def pthread : Flag<"-pthread">,
 488   HelpText<"Support POSIX threads in generated code">;
 489 def fpascal_strings : Flag<"-fpascal-strings">,
 490   HelpText<"Recognize and construct Pascal-style string literals">;
 491 def fno_rtti : Flag<"-fno-rtti">,
 492   HelpText<"Disable generation of rtti information">;
 493 def fno_validate_pch : Flag<"-fno-validate-pch">,
 494   HelpText<"Disable validation of precompiled headers">;
 495 def dump_deserialized_pch_decls : Flag<"-dump-deserialized-decls">,
 496   HelpText<"Dump declarations that are deserialized from PCH, for testing">;
 497 def error_on_deserialized_pch_decl : Separate<"-error-on-deserialized-decl">,
 498   HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
 499 def fshort_wchar : Flag<"-fshort-wchar">,
 500   HelpText<"Force wchar_t to be a short unsigned int">;
 501 def fshort_enums : Flag<"-fshort-enums">,
 502   HelpText<"Allocate to an enum type only as many bytes as it needs for the declared range of possible values">;
 503 def static_define : Flag<"-static-define">,
 504   HelpText<"Should __STATIC__ be defined">;
 505 def stack_protector : Separate<"-stack-protector">,
 506   HelpText<"Enable stack protectors">;
 507 def fvisibility : Separate<"-fvisibility">,
 508   HelpText<"Default symbol visibility">;
 509 def fvisibility_inlines_hidden : Flag<"-fvisibility-inlines-hidden">,
 510   HelpText<"Give inline C++ member functions default visibility by default">;
 511 def ftemplate_depth : Separate<"-ftemplate-depth">,
 512   HelpText<"Maximum depth of recursive template instantiation">;
 513 def Wlarge_by_value_copy : Separate<"-Wlarge-by-value-copy">,
 514   HelpText<"Warn if a function definition returns or accepts an object larger "
 515            "in bytes that a given value">;
 516 def Wlarge_by_value_copy_EQ : Joined<"-Wlarge-by-value-copy=">,
 517   Alias<Wlarge_by_value_copy>;
 518 def trigraphs : Flag<"-trigraphs">,
 519   HelpText<"Process trigraph sequences">;
 520 def fwritable_strings : Flag<"-fwritable-strings">,
 521   HelpText<"Store string literals as writable data">;
 522 def fno_bitfield_type_align : Flag<"-fno-bitfield-type-align">,
 523   HelpText<"Ignore bit-field types when aligning structures">;
 524
 525 //===----------------------------------------------------------------------===//
 526 // Header Search Options
 527 //===----------------------------------------------------------------------===//
 528
 529 def nostdinc : Flag<"-nostdinc">,
 530   HelpText<"Disable standard #include directories">;
 531 def nostdincxx : Flag<"-nostdinc++">,
 532   HelpText<"Disable standard #include directories for the C++ standard library">;
 533 def nobuiltininc : Flag<"-nobuiltininc">,
 534   HelpText<"Disable builtin #include directories">;
 535 def F : JoinedOrSeparate<"-F">, MetaVarName<"<directory>">,
 536   HelpText<"Add directory to framework include search path">;
 537 def I : JoinedOrSeparate<"-I">, MetaVarName<"<directory>">,
 538   HelpText<"Add directory to include search path">;
 539 def idirafter : JoinedOrSeparate<"-idirafter">, MetaVarName<"<directory>">,
 540   HelpText<"Add directory to AFTER include search path">;
 541 def iquote : JoinedOrSeparate<"-iquote">, MetaVarName<"<directory>">,
 542   HelpText<"Add directory to QUOTE include search path">;
 543 def isystem : JoinedOrSeparate<"-isystem">, MetaVarName<"<directory>">,
 544   HelpText<"Add directory to SYSTEM include search path">;
 545 def iwithsysroot : JoinedOrSeparate<"-iwithsysroot">,MetaVarName<"<directory>">,
 546   HelpText<"Add directory to SYSTEM include search path, "
 547            "absolute paths are relative to -isysroot">;
 548 def iprefix : JoinedOrSeparate<"-iprefix">, MetaVarName<"<prefix>">,
 549   HelpText<"Set the -iwithprefix/-iwithprefixbefore prefix">;
 550 def iwithprefix : JoinedOrSeparate<"-iwithprefix">, MetaVarName<"<dir>">,
 551   HelpText<"Set directory to SYSTEM include search path with prefix">;
 552 def iwithprefixbefore : JoinedOrSeparate<"-iwithprefixbefore">,
 553   MetaVarName<"<dir>">,
 554   HelpText<"Set directory to include search path with prefix">;
 555 def isysroot : JoinedOrSeparate<"-isysroot">, MetaVarName<"<dir>">,
 556   HelpText<"Set the system root directory (usually /)">;
 557 def cxx_system_include : Separate<"-cxx-system-include">,
 558   HelpText<"Add a system #include directory for the C++ standard library">;
 559 def v : Flag<"-v">, HelpText<"Enable verbose output">;
 560
 561 //===----------------------------------------------------------------------===//
 562 // Preprocessor Options
 563 //===----------------------------------------------------------------------===//
 564
 565 def D : JoinedOrSeparate<"-D">, MetaVarName<"<macro>">,
 566   HelpText<"Predefine the specified macro">;
 567 def include_ : JoinedOrSeparate<"-include">, MetaVarName<"<file>">, EnumName<"include">,
 568   HelpText<"Include file before parsing">;
 569 def imacros : JoinedOrSeparate<"-imacros">, MetaVarName<"<file>">,
 570   HelpText<"Include macros from file before parsing">;
 571 def include_pch : Separate<"-include-pch">, MetaVarName<"<file>">,
 572   HelpText<"Include precompiled header file">;
 573 def include_pth : Separate<"-include-pth">, MetaVarName<"<file>">,
 574   HelpText<"Include file before parsing">;
 575 def preamble_bytes_EQ : Joined<"-preamble-bytes=">,
 576   HelpText<"Assume that the precompiled header is a precompiled preamble "
 577            "covering the first N bytes of the main file">;
 578 def token_cache : Separate<"-token-cache">, MetaVarName<"<path>">,
 579   HelpText<"Use specified token cache file">;
 580 def U : JoinedOrSeparate<"-U">, MetaVarName<"<macro>">,
 581   HelpText<"Undefine the specified macro">;
 582 def undef : Flag<"-undef">, MetaVarName<"<macro>">,
 583   HelpText<"undef all system defines">;
 584 def detailed_preprocessing_record : Flag<"-detailed-preprocessing-record">,
 585   HelpText<"include a detailed record of preprocessing actions">;
 586
 587 //===----------------------------------------------------------------------===//
 588 // Preprocessed Output Options
 589 //===----------------------------------------------------------------------===//
 590
 591 def P : Flag<"-P">,
 592   HelpText<"Disable linemarker output in -E mode">;
 593 def C : Flag<"-C">,
 594   HelpText<"Enable comment output in -E mode">;
 595 def CC : Flag<"-CC">,
 596   HelpText<"Enable comment output in -E mode, even from macro expansions">;
 597 def dM : Flag<"-dM">,
 598   HelpText<"Print macro definitions in -E mode instead of normal output">;
 599 def dD : Flag<"-dD">,
 600   HelpText<"Print macro definitions in -E mode in addition to normal output">;
 601
 602 //===----------------------------------------------------------------------===//
 603 // OpenCL Options
 604 //===----------------------------------------------------------------------===//
 605
 606 def cl_opt_disable : Flag<"-cl-opt-disable">,
 607   HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">;
 608 def cl_single_precision_constant : Flag<"-cl-single-precision-constant">,
 609   HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">;
 610 def cl_finite_math_only : Flag<"-cl-finite-math-only">,
 611   HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">;
 612 def cl_unsafe_math_optimizations : Flag<"-cl-unsafe-math-optimizations">,
 613   HelpText<"OpenCL only. Allow unsafe floating-point optimizations.  Also implies -cl-no-signed-zeros and -cl-mad-enable">;
 614 def cl_fast_relaxed_math : Flag<"-cl-fast-relaxed-math">,
 615   HelpText<"OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines __FAST_RELAXED_MATH__">;
 616 def cl_mad_enable : Flag<"-cl-mad-enable">,
 617   HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">;
 618 def cl_std_EQ : Joined<"-cl-std=">,
 619   HelpText<"OpenCL language standard to compile for">;