granicus.if.org Git - clang/blob - 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 and clang -cc1as.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 let Flags = [CC1Option, NoDriverOption] in {
  15
  16 //===----------------------------------------------------------------------===//
  17 // Target Options
  18 //===----------------------------------------------------------------------===//
  19
  20 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
  21
  22 def target_cpu : Separate<["-"], "target-cpu">,
  23   HelpText<"Target a specific cpu type">;
  24 def target_feature : Separate<["-"], "target-feature">,
  25   HelpText<"Target specific attributes">;
  26 def triple : Separate<["-"], "triple">,
  27   HelpText<"Specify target triple (e.g. i686-apple-darwin9)">;
  28 def target_abi : Separate<["-"], "target-abi">,
  29   HelpText<"Target a particular ABI type">;
  30
  31 }
  32
  33 def target_linker_version : Separate<["-"], "target-linker-version">,
  34   HelpText<"Target linker version">;
  35 def triple_EQ : Joined<["-"], "triple=">, Alias<triple>;
  36 def mfpmath : Separate<["-"], "mfpmath">,
  37   HelpText<"Which unit to use for fp math">;
  38
  39 //===----------------------------------------------------------------------===//
  40 // Analyzer Options
  41 //===----------------------------------------------------------------------===//
  42
  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
  48 def analyzer_store : Separate<["-"], "analyzer-store">,
  49   HelpText<"Source Code Analysis - Abstract Memory Store Models">;
  50 def analyzer_store_EQ : Joined<["-"], "analyzer-store=">, Alias<analyzer_store>;
  51
  52 def analyzer_constraints : Separate<["-"], "analyzer-constraints">,
  53   HelpText<"Source Code Analysis - Symbolic Constraint Engines">;
  54 def analyzer_constraints_EQ : Joined<["-"], "analyzer-constraints=">,
  55   Alias<analyzer_constraints>;
  56
  57 def analyzer_output : Separate<["-"], "analyzer-output">,
  58   HelpText<"Source Code Analysis - Output Options">;
  59 def analyzer_output_EQ : Joined<["-"], "analyzer-output=">,
  60   Alias<analyzer_output>;
  61
  62 def analyzer_purge : Separate<["-"], "analyzer-purge">,
  63   HelpText<"Source Code Analysis - Dead Symbol Removal Frequency">;
  64 def analyzer_purge_EQ : Joined<["-"], "analyzer-purge=">, Alias<analyzer_purge>;
  65
  66 def analyzer_opt_analyze_headers : Flag<["-"], "analyzer-opt-analyze-headers">,
  67   HelpText<"Force the static analyzer to analyze functions defined in header files">;
  68 def analyzer_opt_analyze_nested_blocks : Flag<["-"], "analyzer-opt-analyze-nested-blocks">,
  69   HelpText<"Analyze the definitions of blocks in addition to functions">;
  70 def analyzer_display_progress : Flag<["-"], "analyzer-display-progress">,
  71   HelpText<"Emit verbose output about the analyzer's progress">;
  72 def analyze_function : Separate<["-"], "analyze-function">,
  73   HelpText<"Run analysis on specific function">;
  74 def analyze_function_EQ : Joined<["-"], "analyze-function=">, Alias<analyze_function>;
  75 def analyzer_eagerly_assume : Flag<["-"], "analyzer-eagerly-assume">,
  76   HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">;
  77 def trim_egraph : Flag<["-"], "trim-egraph">,
  78   HelpText<"Only show error-related paths in the analysis graph">;
  79 def analyzer_viz_egraph_graphviz : Flag<["-"], "analyzer-viz-egraph-graphviz">,
  80   HelpText<"Display exploded graph using GraphViz">;
  81 def analyzer_viz_egraph_ubigraph : Flag<["-"], "analyzer-viz-egraph-ubigraph">,
  82   HelpText<"Display exploded graph using Ubigraph">;
  83
  84 def analyzer_inline_max_stack_depth : Separate<["-"], "analyzer-inline-max-stack-depth">,
  85   HelpText<"Bound on stack depth while inlining (4 by default)">;
  86 def analyzer_inline_max_stack_depth_EQ : Joined<["-"], "analyzer-inline-max-stack-depth=">,
  87   Alias<analyzer_inline_max_stack_depth>;
  88
  89 def analyzer_inlining_mode : Separate<["-"], "analyzer-inlining-mode">,
  90   HelpText<"Specify the function selection heuristic used during inlining">;
  91 def analyzer_inlining_mode_EQ : Joined<["-"], "analyzer-inlining-mode=">, Alias<analyzer_inlining_mode>;
  92
  93 def analyzer_disable_retry_exhausted : Flag<["-"], "analyzer-disable-retry-exhausted">,
  94   HelpText<"Do not re-analyze paths leading to exhausted nodes with a different strategy (may decrease code coverage)">;
  95
  96 def analyzer_max_loop : Separate<["-"], "analyzer-max-loop">,
  97   HelpText<"The maximum number of times the analyzer will go through a loop">;
  98 def analyzer_stats : Flag<["-"], "analyzer-stats">,
  99   HelpText<"Print internal analyzer statistics.">;
 100
 101 def analyzer_checker : Separate<["-"], "analyzer-checker">,
 102   HelpText<"Choose analyzer checkers to enable">;
 103 def analyzer_checker_EQ : Joined<["-"], "analyzer-checker=">,
 104   Alias<analyzer_checker>;
 105
 106 def analyzer_disable_checker : Separate<["-"], "analyzer-disable-checker">,
 107   HelpText<"Choose analyzer checkers to disable">;
 108 def analyzer_disable_checker_EQ : Joined<["-"], "analyzer-disable-checker=">,
 109   Alias<analyzer_disable_checker>;
 110
 111 def analyzer_disable_all_checks : Flag<["-"], "analyzer-disable-all-checks">,
 112   HelpText<"Disable all static analyzer checks">;
 113
 114 def analyzer_checker_help : Flag<["-"], "analyzer-checker-help">,
 115   HelpText<"Display the list of analyzer checkers that are available">;
 116
 117 def analyzer_config : Separate<["-"], "analyzer-config">,
 118   HelpText<"Choose analyzer options to enable">;
 119
 120 //===----------------------------------------------------------------------===//
 121 // Migrator Options
 122 //===----------------------------------------------------------------------===//
 123 def migrator_no_nsalloc_error : Flag<["-"], "no-ns-alloc-error">,
 124   HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">;
 125
 126 def migrator_no_finalize_removal : Flag<["-"], "no-finalize-removal">,
 127   HelpText<"Do not remove finalize method in gc mode">;
 128
 129 //===----------------------------------------------------------------------===//
 130 // CodeGen Options
 131 //===----------------------------------------------------------------------===//
 132
 133 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
 134
 135 def debug_info_kind_EQ : Joined<["-"], "debug-info-kind=">;
 136 def dwarf_version_EQ : Joined<["-"], "dwarf-version=">;
 137 def debugger_tuning_EQ : Joined<["-"], "debugger-tuning=">;
 138 def fdebug_compilation_dir : Separate<["-"], "fdebug-compilation-dir">,
 139   HelpText<"The compilation directory to embed in the debug info.">;
 140 def dwarf_debug_flags : Separate<["-"], "dwarf-debug-flags">,
 141   HelpText<"The string to embed in the Dwarf debug flags record.">;
 142 def mno_exec_stack : Flag<["-"], "mnoexecstack">,
 143   HelpText<"Mark the file as not needing an executable stack">;
 144 def massembler_fatal_warnings : Flag<["-"], "massembler-fatal-warnings">,
 145   HelpText<"Make assembler warnings fatal">;
 146 def compress_debug_sections : Flag<["-"], "compress-debug-sections">,
 147     HelpText<"Compress DWARF debug sections using zlib">;
 148 def msave_temp_labels : Flag<["-"], "msave-temp-labels">,
 149   HelpText<"Save temporary labels in the symbol table. "
 150            "Note this may change .s semantics and shouldn't generally be used "
 151            "on compiler-generated code.">;
 152 def mrelocation_model : Separate<["-"], "mrelocation-model">,
 153   HelpText<"The relocation model to use">;
 154 def fno_math_builtin : Flag<["-"], "fno-math-builtin">,
 155   HelpText<"Disable implicit builtin knowledge of math functions">;
 156 }
 157
 158 def disable_llvm_optzns : Flag<["-"], "disable-llvm-optzns">,
 159   HelpText<"Don't run LLVM optimization passes">;
 160 def disable_llvm_verifier : Flag<["-"], "disable-llvm-verifier">,
 161   HelpText<"Don't run the LLVM IR verifier pass">;
 162 def disable_llvm_passes : Flag<["-"], "disable-llvm-passes">,
 163   HelpText<"Use together with -emit-llvm to get pristine LLVM IR from the "
 164            "frontend by not running any LLVM passes at all">;
 165 def disable_red_zone : Flag<["-"], "disable-red-zone">,
 166   HelpText<"Do not emit code that uses the red zone.">;
 167 def dwarf_column_info : Flag<["-"], "dwarf-column-info">,
 168   HelpText<"Turn on column location information.">;
 169 def split_dwarf : Flag<["-"], "split-dwarf">,
 170   HelpText<"Split out the dwarf .dwo sections">;
 171 def gnu_pubnames : Flag<["-"], "gnu-pubnames">,
 172   HelpText<"Emit newer GNU style pubnames">;
 173 def arange_sections : Flag<["-"], "arange_sections">,
 174   HelpText<"Emit DWARF .debug_arange sections">;
 175 def dwarf_ext_refs : Flag<["-"], "dwarf-ext-refs">,
 176   HelpText<"Generate debug info with external references to clang modules"
 177            " or precompiled headers">;
 178 def fforbid_guard_variables : Flag<["-"], "fforbid-guard-variables">,
 179   HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
 180 def no_implicit_float : Flag<["-"], "no-implicit-float">,
 181   HelpText<"Don't generate implicit floating point instructions">;
 182 def fdump_vtable_layouts : Flag<["-"], "fdump-vtable-layouts">,
 183   HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
 184 def fmerge_functions : Flag<["-"], "fmerge-functions">,
 185   HelpText<"Permit merging of identical functions when optimizing.">;
 186 def femit_coverage_notes : Flag<["-"], "femit-coverage-notes">,
 187   HelpText<"Emit a gcov coverage notes file when compiling.">;
 188 def femit_coverage_data: Flag<["-"], "femit-coverage-data">,
 189   HelpText<"Instrument the program to emit gcov coverage data when run.">;
 190 def coverage_file : Separate<["-"], "coverage-file">,
 191   HelpText<"Emit coverage data to this filename. The extension will be replaced.">;
 192 def coverage_file_EQ : Joined<["-"], "coverage-file=">, Alias<coverage_file>;
 193 def coverage_cfg_checksum : Flag<["-"], "coverage-cfg-checksum">,
 194   HelpText<"Emit CFG checksum for functions in .gcno files.">;
 195 def coverage_no_function_names_in_data : Flag<["-"], "coverage-no-function-names-in-data">,
 196   HelpText<"Emit function names in .gcda files.">;
 197 def coverage_exit_block_before_body : Flag<["-"], "coverage-exit-block-before-body">,
 198   HelpText<"Emit the exit block before the body blocks in .gcno files.">;
 199 def coverage_version_EQ : Joined<["-"], "coverage-version=">,
 200   HelpText<"Four-byte version string for gcov files.">;
 201 def test_coverage : Flag<["-"], "test-coverage">,
 202   HelpText<"Do not generate coverage files or remove coverage changes from IR">;
 203 def dump_coverage_mapping : Flag<["-"], "dump-coverage-mapping">,
 204   HelpText<"Dump the coverage mapping records, for testing">;
 205 def fuse_register_sized_bitfield_access: Flag<["-"], "fuse-register-sized-bitfield-access">,
 206   HelpText<"Use register sized accesses to bit-fields, when possible.">;
 207 def relaxed_aliasing : Flag<["-"], "relaxed-aliasing">,
 208   HelpText<"Turn off Type Based Alias Analysis">;
 209 def no_struct_path_tbaa : Flag<["-"], "no-struct-path-tbaa">,
 210   HelpText<"Turn off struct-path aware Type Based Alias Analysis">;
 211 def masm_verbose : Flag<["-"], "masm-verbose">,
 212   HelpText<"Generate verbose assembly output">;
 213 def mcode_model : Separate<["-"], "mcode-model">,
 214   HelpText<"The code model to use">;
 215 def mdebug_pass : Separate<["-"], "mdebug-pass">,
 216   HelpText<"Enable additional debug output">;
 217 def mdisable_fp_elim : Flag<["-"], "mdisable-fp-elim">,
 218   HelpText<"Disable frame pointer elimination optimization">;
 219 def mdisable_tail_calls : Flag<["-"], "mdisable-tail-calls">,
 220   HelpText<"Disable tail call optimization, keeping the call stack accurate">;
 221 def menable_no_infinities : Flag<["-"], "menable-no-infs">,
 222   HelpText<"Allow optimization to assume there are no infinities.">;
 223 def menable_no_nans : Flag<["-"], "menable-no-nans">,
 224   HelpText<"Allow optimization to assume there are no NaNs.">;
 225 def menable_unsafe_fp_math : Flag<["-"], "menable-unsafe-fp-math">,
 226   HelpText<"Allow unsafe floating-point math optimizations which may decrease "
 227            "precision">;
 228 def mfloat_abi : Separate<["-"], "mfloat-abi">,
 229   HelpText<"The float ABI to use">;
 230 def mlimit_float_precision : Separate<["-"], "mlimit-float-precision">,
 231   HelpText<"Limit float precision to the given value">;
 232 def split_stacks : Flag<["-"], "split-stacks">,
 233   HelpText<"Try to use a split stack if possible.">;
 234 def mno_zero_initialized_in_bss : Flag<["-"], "mno-zero-initialized-in-bss">,
 235   HelpText<"Do not put zero initialized data in the BSS">;
 236 def backend_option : Separate<["-"], "backend-option">,
 237   HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
 238 def mregparm : Separate<["-"], "mregparm">,
 239   HelpText<"Limit the number of registers available for integer arguments">;
 240 def munwind_tables : Flag<["-"], "munwind-tables">,
 241   HelpText<"Generate unwinding tables for all functions">;
 242 def mconstructor_aliases : Flag<["-"], "mconstructor-aliases">,
 243   HelpText<"Emit complete constructors and destructors as aliases when possible">;
 244 def mlink_bitcode_file : Separate<["-"], "mlink-bitcode-file">,
 245   HelpText<"Link the given bitcode file before performing optimizations.">;
 246 def mlink_cuda_bitcode : Separate<["-"], "mlink-cuda-bitcode">,
 247   HelpText<"Link and internalize needed symbols from the given bitcode file "
 248            "before performing optimizations.">;
 249 def vectorize_loops : Flag<["-"], "vectorize-loops">,
 250   HelpText<"Run the Loop vectorization passes">;
 251 def vectorize_slp : Flag<["-"], "vectorize-slp">,
 252   HelpText<"Run the SLP vectorization passes">;
 253 def vectorize_slp_aggressive : Flag<["-"], "vectorize-slp-aggressive">,
 254   HelpText<"Run the BB vectorization passes">;
 255 def dependent_lib : Joined<["--"], "dependent-lib=">,
 256   HelpText<"Add dependent library">;
 257 def linker_option : Joined<["--"], "linker-option=">,
 258   HelpText<"Add linker option">;
 259 def fsanitize_coverage_type : Joined<["-"], "fsanitize-coverage-type=">,
 260                               HelpText<"Sanitizer coverage type">;
 261 def fsanitize_coverage_indirect_calls
 262     : Flag<["-"], "fsanitize-coverage-indirect-calls">,
 263       HelpText<"Enable sanitizer coverage for indirect calls">;
 264 def fsanitize_coverage_trace_bb
 265     : Flag<["-"], "fsanitize-coverage-trace-bb">,
 266       HelpText<"Enable basic block tracing in sanitizer coverage">;
 267 def fsanitize_coverage_trace_cmp
 268     : Flag<["-"], "fsanitize-coverage-trace-cmp">,
 269       HelpText<"Enable cmp instruction tracing in sanitizer coverage">;
 270 def fsanitize_coverage_8bit_counters
 271     : Flag<["-"], "fsanitize-coverage-8bit-counters">,
 272       HelpText<"Enable frequency counters in sanitizer coverage">;
 273 def fsanitize_coverage_trace_pc
 274     : Flag<["-"], "fsanitize-coverage-trace-pc">,
 275       HelpText<"Enable PC tracing in sanitizer coverage">;
 276 def fprofile_instrument_EQ : Joined<["-"], "fprofile-instrument=">,
 277     HelpText<"Enable PGO instrumentation. The accepted values is clang or "
 278              "none">;
 279 def fprofile_instrument_path_EQ : Joined<["-"], "fprofile-instrument-path=">,
 280     HelpText<"Generate instrumented code to collect execution counts into "
 281              "<file> (overridden by LLVM_PROFILE_FILE env var)">;
 282
 283 //===----------------------------------------------------------------------===//
 284 // Dependency Output Options
 285 //===----------------------------------------------------------------------===//
 286
 287 def sys_header_deps : Flag<["-"], "sys-header-deps">,
 288   HelpText<"Include system headers in dependency output">;
 289 def module_file_deps : Flag<["-"], "module-file-deps">,
 290   HelpText<"Include module files in dependency output">;
 291 def header_include_file : Separate<["-"], "header-include-file">,
 292   HelpText<"Filename (or -) to write header include output to">;
 293 def show_includes : Flag<["--"], "show-includes">,
 294   HelpText<"Print cl.exe style /showIncludes to stdout">;
 295
 296 //===----------------------------------------------------------------------===//
 297 // Diagnostic Options
 298 //===----------------------------------------------------------------------===//
 299
 300 def diagnostic_log_file : Separate<["-"], "diagnostic-log-file">,
 301   HelpText<"Filename (or -) to log diagnostics to">;
 302 def diagnostic_serialized_file : Separate<["-"], "serialize-diagnostic-file">,
 303   MetaVarName<"<filename>">,
 304   HelpText<"File for serializing diagnostics in a binary format">;
 305
 306 def fdiagnostics_format : Separate<["-"], "fdiagnostics-format">,
 307   HelpText<"Change diagnostic formatting to match IDE and command line tools">;
 308 def fdiagnostics_show_category : Separate<["-"], "fdiagnostics-show-category">,
 309   HelpText<"Print diagnostic category">;
 310 def fno_diagnostics_use_presumed_location : Flag<["-"], "fno-diagnostics-use-presumed-location">,
 311   HelpText<"Ignore #line directives when displaying diagnostic locations">;
 312 def ftabstop : Separate<["-"], "ftabstop">, MetaVarName<"<N>">,
 313   HelpText<"Set the tab stop distance.">;
 314 def ferror_limit : Separate<["-"], "ferror-limit">, MetaVarName<"<N>">,
 315   HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
 316 def fmacro_backtrace_limit : Separate<["-"], "fmacro-backtrace-limit">, MetaVarName<"<N>">,
 317   HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
 318 def ftemplate_backtrace_limit : Separate<["-"], "ftemplate-backtrace-limit">, MetaVarName<"<N>">,
 319   HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
 320 def fconstexpr_backtrace_limit : Separate<["-"], "fconstexpr-backtrace-limit">, MetaVarName<"<N>">,
 321   HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">;
 322 def fspell_checking_limit : Separate<["-"], "fspell-checking-limit">, MetaVarName<"<N>">,
 323   HelpText<"Set the maximum number of times to perform spell checking on unrecognized identifiers (0 = no limit).">;
 324 def fmessage_length : Separate<["-"], "fmessage-length">, MetaVarName<"<N>">,
 325   HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
 326 def verify : Flag<["-"], "verify">,
 327   HelpText<"Verify diagnostic output using comment directives">;
 328 def verify_ignore_unexpected : Flag<["-"], "verify-ignore-unexpected">,
 329   HelpText<"Ignore unexpected diagnostic messages">;
 330 def verify_ignore_unexpected_EQ : CommaJoined<["-"], "verify-ignore-unexpected=">,
 331   HelpText<"Ignore unexpected diagnostic messages">;
 332 def Wno_rewrite_macros : Flag<["-"], "Wno-rewrite-macros">,
 333   HelpText<"Silence ObjC rewriting warnings">;
 334
 335 //===----------------------------------------------------------------------===//
 336 // Frontend Options
 337 //===----------------------------------------------------------------------===//
 338
 339 // This isn't normally used, it is just here so we can parse a
 340 // CompilerInvocation out of a driver-derived argument vector.
 341 def cc1 : Flag<["-"], "cc1">;
 342 def cc1as : Flag<["-"], "cc1as">;
 343
 344 def ast_merge : Separate<["-"], "ast-merge">,
 345   MetaVarName<"<ast file>">,
 346   HelpText<"Merge the given AST file into the translation unit being compiled.">;
 347 def aux_triple : Separate<["-"], "aux-triple">,
 348   HelpText<"Auxiliary target triple.">;
 349 def code_completion_at : Separate<["-"], "code-completion-at">,
 350   MetaVarName<"<file>:<line>:<column>">,
 351   HelpText<"Dump code-completion information at a location">;
 352 def remap_file : Separate<["-"], "remap-file">,
 353   MetaVarName<"<from>;<to>">,
 354   HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
 355 def code_completion_at_EQ : Joined<["-"], "code-completion-at=">,
 356   Alias<code_completion_at>;
 357 def code_completion_macros : Flag<["-"], "code-completion-macros">,
 358   HelpText<"Include macros in code-completion results">;
 359 def code_completion_patterns : Flag<["-"], "code-completion-patterns">,
 360   HelpText<"Include code patterns in code-completion results">;
 361 def no_code_completion_globals : Flag<["-"], "no-code-completion-globals">,
 362   HelpText<"Do not include global declarations in code-completion results.">;
 363 def code_completion_brief_comments : Flag<["-"], "code-completion-brief-comments">,
 364   HelpText<"Include brief documentation comments in code-completion results.">;
 365 def disable_free : Flag<["-"], "disable-free">,
 366   HelpText<"Disable freeing of memory on exit">;
 367 def load : Separate<["-"], "load">, MetaVarName<"<dsopath>">,
 368   HelpText<"Load the named plugin (dynamic shared object)">;
 369 def plugin : Separate<["-"], "plugin">, MetaVarName<"<name>">,
 370   HelpText<"Use the named plugin action instead of the default action (use \"help\" to list available options)">;
 371 def plugin_arg : JoinedAndSeparate<["-"], "plugin-arg-">,
 372     MetaVarName<"<name> <arg>">,
 373     HelpText<"Pass <arg> to plugin <name>">;
 374 def add_plugin : Separate<["-"], "add-plugin">, MetaVarName<"<name>">,
 375   HelpText<"Use the named plugin action in addition to the default action">;
 376 def ast_dump_filter : Separate<["-"], "ast-dump-filter">,
 377   MetaVarName<"<dump_filter>">,
 378   HelpText<"Use with -ast-dump or -ast-print to dump/print only AST declaration"
 379            " nodes having a certain substring in a qualified name. Use"
 380            " -ast-list to list all filterable declaration node names.">;
 381 def fno_modules_global_index : Flag<["-"], "fno-modules-global-index">,
 382   HelpText<"Do not automatically generate or update the global module index">;
 383 def fno_modules_error_recovery : Flag<["-"], "fno-modules-error-recovery">,
 384   HelpText<"Do not automatically import modules for error recovery">;
 385 def fmodule_map_file_home_is_cwd : Flag<["-"], "fmodule-map-file-home-is-cwd">,
 386   HelpText<"Use the current working directory as the home directory of "
 387            "module maps specified by -fmodule-map-file=<FILE>">;
 388 def fmodule_feature : Separate<["-"], "fmodule-feature">,
 389   MetaVarName<"<feature>">,
 390   HelpText<"Enable <feature> in module map requires declarations">;
 391 def fmodules_embed_file_EQ : Joined<["-"], "fmodules-embed-file=">,
 392   MetaVarName<"<file>">,
 393   HelpText<"Embed the contents of the specified file into the module file "
 394            "being compiled.">;
 395 def fmodules_embed_all_files : Joined<["-"], "fmodules-embed-all-files">,
 396   HelpText<"Embed the contents of all files read by this compilation into "
 397            "the produced module file.">;
 398 def fmodules_local_submodule_visibility :
 399   Flag<["-"], "fmodules-local-submodule-visibility">,
 400   HelpText<"Enforce name visibility rules across submodules of the same "
 401            "top-level module.">;
 402 def fmodule_format_EQ : Joined<["-"], "fmodule-format=">,
 403   HelpText<"Select the container format for clang modules and PCH. "
 404            "Supported options are 'raw' and 'obj'.">;
 405 def ftest_module_file_extension_EQ :
 406   Joined<["-"], "ftest-module-file-extension=">,
 407   HelpText<"introduce a module file extension for testing purposes. "
 408            "The argument is parsed as blockname:major:minor:hashed:user info">;
 409 def fconcepts_ts : Flag<["-"], "fconcepts-ts">,
 410   HelpText<"Enable C++ Extensions for Concepts.">;
 411
 412 let Group = Action_Group in {
 413
 414 def Eonly : Flag<["-"], "Eonly">,
 415   HelpText<"Just run preprocessor, no output (for timings)">;
 416 def dump_raw_tokens : Flag<["-"], "dump-raw-tokens">,
 417   HelpText<"Lex file in raw mode and dump raw tokens">;
 418 def analyze : Flag<["-"], "analyze">,
 419   HelpText<"Run static analysis engine">;
 420 def dump_tokens : Flag<["-"], "dump-tokens">,
 421   HelpText<"Run preprocessor, dump internal rep of tokens">;
 422 def init_only : Flag<["-"], "init-only">,
 423   HelpText<"Only execute frontend initialization">;
 424 def fixit : Flag<["-"], "fixit">,
 425   HelpText<"Apply fix-it advice to the input source">;
 426 def fixit_EQ : Joined<["-"], "fixit=">,
 427   HelpText<"Apply fix-it advice creating a file with the given suffix">;
 428 def print_preamble : Flag<["-"], "print-preamble">,
 429   HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
 430            " precompiled headers.">;
 431 def emit_html : Flag<["-"], "emit-html">,
 432   HelpText<"Output input source as HTML">;
 433 def ast_print : Flag<["-"], "ast-print">,
 434   HelpText<"Build ASTs and then pretty-print them">;
 435 def ast_list : Flag<["-"], "ast-list">,
 436   HelpText<"Build ASTs and print the list of declaration node qualified names">;
 437 def ast_dump : Flag<["-"], "ast-dump">,
 438   HelpText<"Build ASTs and then debug dump them">;
 439 def ast_dump_lookups : Flag<["-"], "ast-dump-lookups">,
 440   HelpText<"Build ASTs and then debug dump their name lookup tables">;
 441 def ast_view : Flag<["-"], "ast-view">,
 442   HelpText<"Build ASTs and view them with GraphViz">;
 443 def print_decl_contexts : Flag<["-"], "print-decl-contexts">,
 444   HelpText<"Print DeclContexts and their Decls">;
 445 def emit_module : Flag<["-"], "emit-module">,
 446   HelpText<"Generate pre-compiled module file from a module map">;
 447 def emit_pth : Flag<["-"], "emit-pth">,
 448   HelpText<"Generate pre-tokenized header file">;
 449 def emit_pch : Flag<["-"], "emit-pch">,
 450   HelpText<"Generate pre-compiled header file">;
 451 def emit_llvm_bc : Flag<["-"], "emit-llvm-bc">,
 452   HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
 453 def emit_llvm_only : Flag<["-"], "emit-llvm-only">,
 454   HelpText<"Build ASTs and convert to LLVM, discarding output">;
 455 def emit_codegen_only : Flag<["-"], "emit-codegen-only">,
 456   HelpText<"Generate machine code, but discard output">;
 457 def emit_obj : Flag<["-"], "emit-obj">,
 458   HelpText<"Emit native object files">;
 459 def rewrite_test : Flag<["-"], "rewrite-test">,
 460   HelpText<"Rewriter playground">;
 461 def rewrite_macros : Flag<["-"], "rewrite-macros">,
 462   HelpText<"Expand macros without full preprocessing">;
 463 def migrate : Flag<["-"], "migrate">,
 464   HelpText<"Migrate source code">;
 465 }
 466
 467 def emit_llvm_uselists : Flag<["-"], "emit-llvm-uselists">,
 468   HelpText<"Preserve order of LLVM use-lists when serializing">;
 469 def no_emit_llvm_uselists : Flag<["-"], "no-emit-llvm-uselists">,
 470   HelpText<"Don't preserve order of LLVM use-lists when serializing">;
 471
 472 def mt_migrate_directory : Separate<["-"], "mt-migrate-directory">,
 473   HelpText<"Directory for temporary files produced during ARC or ObjC migration">;
 474 def arcmt_check : Flag<["-"], "arcmt-check">,
 475   HelpText<"Check for ARC migration issues that need manual handling">;
 476 def arcmt_modify : Flag<["-"], "arcmt-modify">,
 477   HelpText<"Apply modifications to files to conform to ARC">;
 478 def arcmt_migrate : Flag<["-"], "arcmt-migrate">,
 479   HelpText<"Apply modifications and produces temporary files that conform to ARC">;
 480
 481 def print_stats : Flag<["-"], "print-stats">,
 482   HelpText<"Print performance metrics and statistics">;
 483 def fdump_record_layouts : Flag<["-"], "fdump-record-layouts">,
 484   HelpText<"Dump record layout information">;
 485 def fdump_record_layouts_simple : Flag<["-"], "fdump-record-layouts-simple">,
 486   HelpText<"Dump record layout information in a simple form used for testing">;
 487 def fix_what_you_can : Flag<["-"], "fix-what-you-can">,
 488   HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
 489 def fix_only_warnings : Flag<["-"], "fix-only-warnings">,
 490   HelpText<"Apply fix-it advice only for warnings, not errors">;
 491 def fixit_recompile : Flag<["-"], "fixit-recompile">,
 492   HelpText<"Apply fix-it changes and recompile">;
 493 def fixit_to_temp : Flag<["-"], "fixit-to-temporary">,
 494   HelpText<"Apply fix-it changes to temporary files">;
 495
 496 def foverride_record_layout_EQ : Joined<["-"], "foverride-record-layout=">,
 497   HelpText<"Override record layouts with those in the given file">;
 498
 499 //===----------------------------------------------------------------------===//
 500 // Language Options
 501 //===----------------------------------------------------------------------===//
 502
 503 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
 504
 505 def version : Flag<["-"], "version">,
 506   HelpText<"Print the compiler version">;
 507 def main_file_name : Separate<["-"], "main-file-name">,
 508   HelpText<"Main file name to use for debug info">;
 509
 510 }
 511
 512 def fblocks_runtime_optional : Flag<["-"], "fblocks-runtime-optional">,
 513   HelpText<"Weakly link in the blocks runtime">;
 514 def fexternc_nounwind : Flag<["-"], "fexternc-nounwind">,
 515   HelpText<"Assume all functions with C linkage do not unwind">;
 516 def fsjlj_exceptions : Flag<["-"], "fsjlj-exceptions">,
 517   HelpText<"Use SjLj style exceptions">;
 518 def split_dwarf_file : Separate<["-"], "split-dwarf-file">,
 519   HelpText<"File name to use for split dwarf debug info output">;
 520 def fno_wchar : Flag<["-"], "fno-wchar">,
 521   HelpText<"Disable C++ builtin type wchar_t">;
 522 def fconstant_string_class : Separate<["-"], "fconstant-string-class">,
 523   MetaVarName<"<class name>">,
 524   HelpText<"Specify the class to use for constant Objective-C string objects.">;
 525 def fobjc_arc_cxxlib_EQ : Joined<["-"], "fobjc-arc-cxxlib=">,
 526   HelpText<"Objective-C++ Automatic Reference Counting standard library kind">;
 527 def fobjc_runtime_has_weak : Flag<["-"], "fobjc-runtime-has-weak">,
 528   HelpText<"The target Objective-C runtime supports ARC weak operations">;
 529 def fobjc_dispatch_method_EQ : Joined<["-"], "fobjc-dispatch-method=">,
 530   HelpText<"Objective-C dispatch method to use">;
 531 def disable_objc_default_synthesize_properties : Flag<["-"], "disable-objc-default-synthesize-properties">,
 532   HelpText<"disable the default synthesis of Objective-C properties">;
 533 def fencode_extended_block_signature : Flag<["-"], "fencode-extended-block-signature">,
 534   HelpText<"enable extended encoding of block type signature">;
 535 def pic_level : Separate<["-"], "pic-level">,
 536   HelpText<"Value for __PIC__">;
 537 def pie_level : Separate<["-"], "pie-level">,
 538   HelpText<"Value for __PIE__">;
 539 def fno_validate_pch : Flag<["-"], "fno-validate-pch">,
 540   HelpText<"Disable validation of precompiled headers">;
 541 def dump_deserialized_pch_decls : Flag<["-"], "dump-deserialized-decls">,
 542   HelpText<"Dump declarations that are deserialized from PCH, for testing">;
 543 def error_on_deserialized_pch_decl : Separate<["-"], "error-on-deserialized-decl">,
 544   HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
 545 def error_on_deserialized_pch_decl_EQ : Joined<["-"], "error-on-deserialized-decl=">,
 546   Alias<error_on_deserialized_pch_decl>;
 547 def static_define : Flag<["-"], "static-define">,
 548   HelpText<"Should __STATIC__ be defined">;
 549 def stack_protector : Separate<["-"], "stack-protector">,
 550   HelpText<"Enable stack protectors">;
 551 def stack_protector_buffer_size : Separate<["-"], "stack-protector-buffer-size">,
 552   HelpText<"Lower bound for a buffer to be considered for stack protection">;
 553 def fvisibility : Separate<["-"], "fvisibility">,
 554   HelpText<"Default type and symbol visibility">;
 555 def ftype_visibility : Separate<["-"], "ftype-visibility">,
 556   HelpText<"Default type visibility">;
 557 def ftemplate_depth : Separate<["-"], "ftemplate-depth">,
 558   HelpText<"Maximum depth of recursive template instantiation">;
 559 def foperator_arrow_depth : Separate<["-"], "foperator-arrow-depth">,
 560   HelpText<"Maximum number of 'operator->'s to call for a member access">;
 561 def fconstexpr_depth : Separate<["-"], "fconstexpr-depth">,
 562   HelpText<"Maximum depth of recursive constexpr function calls">;
 563 def fconstexpr_steps : Separate<["-"], "fconstexpr-steps">,
 564   HelpText<"Maximum number of steps in constexpr function evaluation">;
 565 def fbracket_depth : Separate<["-"], "fbracket-depth">,
 566   HelpText<"Maximum nesting level for parentheses, brackets, and braces">;
 567 def fconst_strings : Flag<["-"], "fconst-strings">,
 568   HelpText<"Use a const qualified type for string literals in C and ObjC">;
 569 def fno_const_strings : Flag<["-"], "fno-const-strings">,
 570   HelpText<"Don't use a const qualified type for string literals in C and ObjC">;
 571 def fno_bitfield_type_align : Flag<["-"], "fno-bitfield-type-align">,
 572   HelpText<"Ignore bit-field types when aligning structures">;
 573 def ffake_address_space_map : Flag<["-"], "ffake-address-space-map">,
 574   HelpText<"Use a fake address space map; OpenCL testing purposes only">;
 575 def faddress_space_map_mangling_EQ : Joined<["-"], "faddress-space-map-mangling=">, MetaVarName<"<yes|no|target>">,
 576   HelpText<"Set the mode for address space map based mangling; OpenCL testing purposes only">;
 577 def funknown_anytype : Flag<["-"], "funknown-anytype">,
 578   HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">;
 579 def fdebugger_support : Flag<["-"], "fdebugger-support">,
 580   HelpText<"Enable special debugger support behavior">;
 581 def fdebugger_cast_result_to_id : Flag<["-"], "fdebugger-cast-result-to-id">,
 582   HelpText<"Enable casting unknown expression results to id">;
 583 def fdebugger_objc_literal : Flag<["-"], "fdebugger-objc-literal">,
 584   HelpText<"Enable special debugger support for Objective-C subscripting and literals">;
 585 def fdeprecated_macro : Flag<["-"], "fdeprecated-macro">,
 586   HelpText<"Defines the __DEPRECATED macro">;
 587 def fno_deprecated_macro : Flag<["-"], "fno-deprecated-macro">,
 588   HelpText<"Undefines the __DEPRECATED macro">;
 589 def fobjc_subscripting_legacy_runtime : Flag<["-"], "fobjc-subscripting-legacy-runtime">,
 590   HelpText<"Allow Objective-C array and dictionary subscripting in legacy runtime">;
 591 def vtordisp_mode_EQ : Joined<["-"], "vtordisp-mode=">,
 592   HelpText<"Control vtordisp placement on win32 targets">;
 593 def fno_rtti_data : Flag<["-"], "fno-rtti-data">,
 594   HelpText<"Control emission of RTTI data">;
 595 def fnative_half_type: Flag<["-"], "fnative-half-type">,
 596   HelpText<"Use the native half type for __fp16 instead of promoting to float">;
 597 def fallow_half_arguments_and_returns : Flag<["-"], "fallow-half-arguments-and-returns">,
 598   HelpText<"Allow function arguments and returns of type half">;
 599
 600 // C++ TSes.
 601 def fcoroutines : Flag<["-"], "fcoroutines">,
 602   HelpText<"Enable support for the C++ Coroutines TS">;
 603
 604 //===----------------------------------------------------------------------===//
 605 // Header Search Options
 606 //===----------------------------------------------------------------------===//
 607
 608 def nostdsysteminc : Flag<["-"], "nostdsysteminc">,
 609   HelpText<"Disable standard system #include directories">;
 610 def fdisable_module_hash : Flag<["-"], "fdisable-module-hash">,
 611   HelpText<"Disable the module hash">;
 612 def c_isystem : JoinedOrSeparate<["-"], "c-isystem">, MetaVarName<"<directory>">,
 613   HelpText<"Add directory to the C SYSTEM include search path">;
 614 def objc_isystem : JoinedOrSeparate<["-"], "objc-isystem">,
 615   MetaVarName<"<directory>">,
 616   HelpText<"Add directory to the ObjC SYSTEM include search path">;
 617 def objcxx_isystem : JoinedOrSeparate<["-"], "objcxx-isystem">,
 618   MetaVarName<"<directory>">,
 619   HelpText<"Add directory to the ObjC++ SYSTEM include search path">;
 620 def internal_isystem : JoinedOrSeparate<["-"], "internal-isystem">,
 621   MetaVarName<"<directory>">,
 622   HelpText<"Add directory to the internal system include search path; these "
 623            "are assumed to not be user-provided and are used to model system "
 624            "and standard headers' paths.">;
 625 def internal_externc_isystem : JoinedOrSeparate<["-"], "internal-externc-isystem">,
 626   MetaVarName<"<directory>">,
 627   HelpText<"Add directory to the internal system include search path with "
 628            "implicit extern \"C\" semantics; these are assumed to not be "
 629            "user-provided and are used to model system and standard headers' "
 630            "paths.">;
 631
 632 //===----------------------------------------------------------------------===//
 633 // Preprocessor Options
 634 //===----------------------------------------------------------------------===//
 635
 636 def include_pth : Separate<["-"], "include-pth">, MetaVarName<"<file>">,
 637   HelpText<"Include file before parsing">;
 638 def chain_include : Separate<["-"], "chain-include">, MetaVarName<"<file>">,
 639   HelpText<"Include and chain a header file after turning it into PCH">;
 640 def preamble_bytes_EQ : Joined<["-"], "preamble-bytes=">,
 641   HelpText<"Assume that the precompiled header is a precompiled preamble "
 642            "covering the first N bytes of the main file">;
 643 def token_cache : Separate<["-"], "token-cache">, MetaVarName<"<path>">,
 644   HelpText<"Use specified token cache file">;
 645 def detailed_preprocessing_record : Flag<["-"], "detailed-preprocessing-record">,
 646   HelpText<"include a detailed record of preprocessing actions">;
 647
 648 //===----------------------------------------------------------------------===//
 649 // OpenCL Options
 650 //===----------------------------------------------------------------------===//
 651
 652 def cl_opt_disable : Flag<["-"], "cl-opt-disable">,
 653   HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">;
 654 def cl_strict_aliasing : Flag<["-"], "cl-strict-aliasing">,
 655   HelpText<"OpenCL only. This option does nothing and is for compatibility with OpenCL 1.0">;
 656 def cl_single_precision_constant : Flag<["-"], "cl-single-precision-constant">,
 657   HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">;
 658 def cl_finite_math_only : Flag<["-"], "cl-finite-math-only">,
 659   HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">;
 660 def cl_kernel_arg_info : Flag<["-"], "cl-kernel-arg-info">,
 661   HelpText<"OpenCL only. Generate kernel argument metadata.">;
 662 def cl_unsafe_math_optimizations : Flag<["-"], "cl-unsafe-math-optimizations">,
 663   HelpText<"OpenCL only. Allow unsafe floating-point optimizations.  Also implies -cl-no-signed-zeros and -cl-mad-enable">;
 664 def cl_fast_relaxed_math : Flag<["-"], "cl-fast-relaxed-math">,
 665   HelpText<"OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines __FAST_RELAXED_MATH__">;
 666 def cl_mad_enable : Flag<["-"], "cl-mad-enable">,
 667   HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">;
 668 def cl_std_EQ : Joined<["-"], "cl-std=">,
 669   HelpText<"OpenCL language standard to compile for">;
 670 def cl_denorms_are_zero : Flag<["-"], "cl-denorms-are-zero">,
 671   HelpText<"OpenCL only. Allow denormals to be flushed to zero">;
 672
 673 //===----------------------------------------------------------------------===//
 674 // CUDA Options
 675 //===----------------------------------------------------------------------===//
 676
 677 def fcuda_is_device : Flag<["-"], "fcuda-is-device">,
 678   HelpText<"Generate code for CUDA device">;
 679 def fcuda_allow_host_calls_from_host_device : Flag<["-"],
 680     "fcuda-allow-host-calls-from-host-device">,
 681   HelpText<"Allow host device functions to call host functions">;
 682 def fcuda_disable_target_call_checks : Flag<["-"],
 683     "fcuda-disable-target-call-checks">,
 684   HelpText<"Disable all cross-target (host, device, etc.) call checks in CUDA">;
 685 def fcuda_include_gpubinary : Separate<["-"], "fcuda-include-gpubinary">,
 686   HelpText<"Incorporate CUDA device-side binary into host object file.">;
 687 def fcuda_target_overloads : Flag<["-"], "fcuda-target-overloads">,
 688   HelpText<"Enable function overloads based on CUDA target attributes.">;
 689 def fcuda_allow_variadic_functions : Flag<["-"], "fcuda-allow-variadic-functions">,
 690   HelpText<"Allow variadic functions in CUDA device code.">;
 691
 692 //===----------------------------------------------------------------------===//
 693 // OpenMP Options
 694 //===----------------------------------------------------------------------===//
 695
 696 def fopenmp_is_device : Flag<["-"], "fopenmp-is-device">,
 697   HelpText<"Generate code only for an OpenMP target device.">;
 698 def omp_host_ir_file_path : Separate<["-"], "omp-host-ir-file-path">,
 699   HelpText<"Path to the IR file produced by the frontend for the host.">;
 700
 701 } // let Flags = [CC1Option]
 702
 703
 704 //===----------------------------------------------------------------------===//
 705 // cc1as-only Options
 706 //===----------------------------------------------------------------------===//
 707
 708 let Flags = [CC1AsOption, NoDriverOption] in {
 709
 710 // Language Options
 711 def n : Flag<["-"], "n">,
 712   HelpText<"Don't automatically start assembly file with a text section">;
 713
 714 // Frontend Options
 715 def filetype : Separate<["-"], "filetype">,
 716     HelpText<"Specify the output file type ('asm', 'null', or 'obj')">;
 717
 718 // Transliterate Options
 719 def output_asm_variant : Separate<["-"], "output-asm-variant">,
 720     HelpText<"Select the asm variant index to use for output">;
 721 def show_encoding : Flag<["-"], "show-encoding">,
 722     HelpText<"Show instruction encoding information in transliterate mode">;
 723 def show_inst : Flag<["-"], "show-inst">,
 724     HelpText<"Show internal instruction representation in transliterate mode">;
 725
 726 // Assemble Options
 727 def dwarf_debug_producer : Separate<["-"], "dwarf-debug-producer">,
 728   HelpText<"The string to embed in the Dwarf debug AT_producer record.">;
 729
 730 } // let Flags = [CC1AsOption]