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