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