CC1Options.td revision 773303a505c23d73da624f1e6abcf41a393dad2b
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. 15include "OptParser.td" 16 17//===----------------------------------------------------------------------===// 18// Target Options 19//===----------------------------------------------------------------------===// 20 21def cxx_abi : Separate<"-cxx-abi">, 22 HelpText<"Target a particular C++ ABI type">; 23def target_abi : Separate<"-target-abi">, 24 HelpText<"Target a particular ABI type">; 25def target_cpu : Separate<"-target-cpu">, 26 HelpText<"Target a specific cpu type">; 27def target_feature : Separate<"-target-feature">, 28 HelpText<"Target specific attributes">; 29def target_linker_version : Separate<"-target-linker-version">, 30 HelpText<"Target linker version">; 31def triple : Separate<"-triple">, 32 HelpText<"Specify target triple (e.g. i686-apple-darwin9)">; 33def triple_EQ : Joined<"-triple=">, Alias<triple>; 34 35//===----------------------------------------------------------------------===// 36// Analyzer Options 37//===----------------------------------------------------------------------===// 38 39def analysis_UnoptimizedCFG : Flag<"-unoptimized-cfg">, 40 HelpText<"Generate unoptimized CFGs for all analyses">; 41def analysis_CFGAddImplicitDtors : Flag<"-cfg-add-implicit-dtors">, 42 HelpText<"Add C++ implicit destructors to CFGs for all analyses">; 43def analysis_CFGAddInitializers : Flag<"-cfg-add-initializers">, 44 HelpText<"Add C++ initializers to CFGs for all analyses">; 45 46def analyzer_store : Separate<"-analyzer-store">, 47 HelpText<"Source Code Analysis - Abstract Memory Store Models">; 48def analyzer_store_EQ : Joined<"-analyzer-store=">, Alias<analyzer_store>; 49 50def analyzer_constraints : Separate<"-analyzer-constraints">, 51 HelpText<"Source Code Analysis - Symbolic Constraint Engines">; 52def analyzer_constraints_EQ : Joined<"-analyzer-constraints=">, 53 Alias<analyzer_constraints>; 54 55def analyzer_output : Separate<"-analyzer-output">, 56 HelpText<"Source Code Analysis - Output Options">; 57def analyzer_output_EQ : Joined<"-analyzer-output=">, 58 Alias<analyzer_output>; 59 60def analyzer_purge : Separate<"-analyzer-purge">, 61 HelpText<"Source Code Analysis - Dead Symbol Removal Frequency">; 62def analyzer_purge_EQ : Joined<"-analyzer-purge=">, Alias<analyzer_purge>; 63 64def analyzer_opt_analyze_headers : Flag<"-analyzer-opt-analyze-headers">, 65 HelpText<"Force the static analyzer to analyze functions defined in header files">; 66def analyzer_opt_analyze_nested_blocks : Flag<"-analyzer-opt-analyze-nested-blocks">, 67 HelpText<"Analyze the definitions of blocks in addition to functions">; 68def analyzer_display_progress : Flag<"-analyzer-display-progress">, 69 HelpText<"Emit verbose output about the analyzer's progress">; 70def analyze_function : Separate<"-analyze-function">, 71 HelpText<"Run analysis on specific function">; 72def analyze_function_EQ : Joined<"-analyze-function=">, Alias<analyze_function>; 73def analyzer_eagerly_assume : Flag<"-analyzer-eagerly-assume">, 74 HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">; 75def analyzer_no_eagerly_trim_egraph : Flag<"-analyzer-no-eagerly-trim-egraph">, 76 HelpText<"Don't eagerly remove uninteresting ExplodedNodes from the ExplodedGraph">; 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">; 83def analyzer_inline_call : Flag<"-analyzer-inline-call">, 84 HelpText<"Experimental transfer function inlining callees when its definition is available.">; 85def analyzer_max_nodes : Separate<"-analyzer-max-nodes">, 86 HelpText<"The maximum number of nodes the analyzer can generate (150000 default, 0 = no limit)">; 87def analyzer_max_loop : Separate<"-analyzer-max-loop">, 88 HelpText<"The maximum number of times the analyzer will go through a loop">; 89 90def analyzer_checker : Separate<"-analyzer-checker">, 91 HelpText<"Choose analyzer checkers to enable">; 92def analyzer_checker_EQ : Joined<"-analyzer-checker=">, 93 Alias<analyzer_checker>; 94 95def analyzer_disable_checker : Separate<"-analyzer-disable-checker">, 96 HelpText<"Choose analyzer checkers to disable">; 97def analyzer_disable_checker_EQ : Joined<"-analyzer-disable-checker=">, 98 Alias<analyzer_disable_checker>; 99 100def analyzer_checker_help : Flag<"-analyzer-checker-help">, 101 HelpText<"Display the list of analyzer checkers that are available">; 102 103//===----------------------------------------------------------------------===// 104// Migrator Options 105//===----------------------------------------------------------------------===// 106def migrator_no_nsalloc_error : Flag<"-no-ns-alloc-error">, 107 HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">; 108 109def migrator_no_finalize_removal : Flag<"-no-finalize-removal">, 110 HelpText<"Do not remove finalize method in gc mode">; 111 112//===----------------------------------------------------------------------===// 113// CodeGen Options 114//===----------------------------------------------------------------------===// 115 116def disable_llvm_optzns : Flag<"-disable-llvm-optzns">, 117 HelpText<"Don't run LLVM optimization passes">; 118def disable_llvm_verifier : Flag<"-disable-llvm-verifier">, 119 HelpText<"Don't run the LLVM IR verifier pass">; 120def disable_red_zone : Flag<"-disable-red-zone">, 121 HelpText<"Do not emit code that uses the red zone.">; 122def fdebug_compilation_dir : Separate<"-fdebug-compilation-dir">, 123 HelpText<"The compilation directory to embed in the debug info.">; 124def dwarf_debug_flags : Separate<"-dwarf-debug-flags">, 125 HelpText<"The string to embed in the Dwarf debug flags record.">; 126def faddress_sanitizer: Flag<"-faddress-sanitizer">, 127 HelpText<"Enable AddressSanitizer instrumentation (memory error detection)">; 128def fforbid_guard_variables : Flag<"-fforbid-guard-variables">, 129 HelpText<"Emit an error if a C++ static local initializer would need a guard variable">; 130def g : Flag<"-g">, HelpText<"Generate source level debug information">; 131def fno_dwarf2_cfi_asm : Flag<"-fno-dwarf2-cfi-asm">, 132 HelpText<"Don't use the cfi directives">; 133def fno_dwarf_directory_asm : Flag<"-fno-dwarf-directory-asm">, 134 HelpText<"Don't separate directory and filename in .file directives">; 135def fcatch_undefined_behavior : Flag<"-fcatch-undefined-behavior">, 136 HelpText<"Generate runtime checks for undefined behavior.">; 137def flimit_debug_info : Flag<"-flimit-debug-info">, 138 HelpText<"Limit debug information produced to reduce size of debug binary">; 139def fno_common : Flag<"-fno-common">, 140 HelpText<"Compile common globals like normal definitions">; 141def no_implicit_float : Flag<"-no-implicit-float">, 142 HelpText<"Don't generate implicit floating point instructions (x86-only)">; 143def finstrument_functions : Flag<"-finstrument-functions">, 144 HelpText<"Generate calls to instrument function entry and exit">; 145def fno_limit_debug_info : Flag<"-fno-limit-debug-info">, 146 HelpText<"Do not limit debug information produced to reduce size of debug binary">; 147def fno_merge_all_constants : Flag<"-fno-merge-all-constants">, 148 HelpText<"Disallow merging of constants.">; 149def fno_threadsafe_statics : Flag<"-fno-threadsafe-statics">, 150 HelpText<"Do not emit code to make initialization of local statics thread safe">; 151def fdump_vtable_layouts : Flag<"-fdump-vtable-layouts">, 152 HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">; 153def ffunction_sections : Flag<"-ffunction-sections">, 154 HelpText<"Place each function in its own section (ELF Only)">; 155def fdata_sections : Flag<"-fdata-sections">, 156 HelpText<"Place each data in its own section (ELF Only)">; 157def funroll_loops : Flag<"-funroll-loops">, 158 HelpText<"Turn on loop unroller">; 159def femit_coverage_notes : Flag<"-femit-coverage-notes">, 160 HelpText<"Emit a gcov coverage notes file when compiling.">; 161def femit_coverage_data: Flag<"-femit-coverage-data">, 162 HelpText<"Instrument the program to emit gcov coverage data when run.">; 163def coverage_file : Separate<"-coverage-file">, 164 HelpText<"Emit coverage data to this filename. The extension will be replaced.">; 165def coverage_file_EQ : Joined<"-coverage-file=">, Alias<coverage_file>; 166def fuse_register_sized_bitfield_access: Flag<"-fuse-register-sized-bitfield-access">, 167 HelpText<"Use register sized accesses to bit-fields, when possible.">; 168def relaxed_aliasing : Flag<"-relaxed-aliasing">, 169 HelpText<"Turn off Type Based Alias Analysis">; 170def masm_verbose : Flag<"-masm-verbose">, 171 HelpText<"Generate verbose assembly output">; 172def mcode_model : Separate<"-mcode-model">, 173 HelpText<"The code model to use">; 174def mdebug_pass : Separate<"-mdebug-pass">, 175 HelpText<"Enable additional debug output">; 176def mdisable_fp_elim : Flag<"-mdisable-fp-elim">, 177 HelpText<"Disable frame pointer elimination optimization">; 178def mdisable_tail_calls : Flag<"-mdisable-tail-calls">, 179 HelpText<"Disable tail call optimization, keeping the call stack accurate">; 180def menable_no_infinities : Flag<"-menable-no-infs">, 181 HelpText<"Allow optimization to assume there are no infinities.">; 182def menable_no_nans : Flag<"-menable-no-nans">, 183 HelpText<"Allow optimization to assume there are no NaNs.">; 184def menable_unsafe_fp_math : Flag<"-menable-unsafe-fp-math">, 185 HelpText<"Allow unsafe floating-point math optimizations which may decrease " 186 "precision">; 187def mfloat_abi : Separate<"-mfloat-abi">, 188 HelpText<"The float ABI to use">; 189def mno_global_merge : Flag<"-mno-global-merge">, 190 HelpText<"Disable merging of globals">; 191def mlimit_float_precision : Separate<"-mlimit-float-precision">, 192 HelpText<"Limit float precision to the given value">; 193def mno_exec_stack : Flag<"-mnoexecstack">, 194 HelpText<"Mark the file as not needing an executable stack">; 195def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">, 196 HelpText<"Do not put zero initialized data in the BSS">; 197def momit_leaf_frame_pointer : Flag<"-momit-leaf-frame-pointer">, 198 HelpText<"Omit frame pointer setup for leaf functions.">; 199def msoft_float : Flag<"-msoft-float">, 200 HelpText<"Use software floating point">; 201def backend_option : Separate<"-backend-option">, 202 HelpText<"Additional arguments to forward to LLVM backend (during code gen)">; 203def mregparm : Separate<"-mregparm">, 204 HelpText<"Limit the number of registers available for integer arguments">; 205def mrelax_all : Flag<"-mrelax-all">, 206 HelpText<"(integrated-as) Relax all machine instructions">; 207def msave_temp_labels : Flag<"-msave-temp-labels">, 208 HelpText<"(integrated-as) Save temporary labels">; 209def mrtd: Flag<"-mrtd">, 210 HelpText<"Make StdCall calling convention the default">; 211def mrelocation_model : Separate<"-mrelocation-model">, 212 HelpText<"The relocation model to use">; 213def munwind_tables : Flag<"-munwind-tables">, 214 HelpText<"Generate unwinding tables for all functions">; 215def mconstructor_aliases : Flag<"-mconstructor-aliases">, 216 HelpText<"Emit complete constructors and destructors as aliases when possible">; 217def mms_bitfields : Flag<"-mms-bitfields">, 218 HelpText<"Set the default structure layout to be compatible with the Microsoft compiler standard.">; 219def mstackrealign : Flag<"-mstackrealign">, 220 HelpText<"Force realign the stack at entry to every function.">; 221def mstack_alignment : Joined<"-mstack-alignment=">, 222 HelpText<"Set the stack alignment">; 223def mlink_bitcode_file : Separate<"-mlink-bitcode-file">, 224 HelpText<"Link the given bitcode file before performing optimizations.">; 225def O : Joined<"-O">, HelpText<"Optimization level">; 226def Os : Flag<"-Os">, HelpText<"Optimize for size">; 227def Oz : Flag<"-Oz">, HelpText<"Optimize for size, regardless of performance">; 228def pg : Flag<"-pg">, HelpText<"Enable mcount instrumentation">; 229 230//===----------------------------------------------------------------------===// 231// Dependency Output Options 232//===----------------------------------------------------------------------===// 233 234def dependency_file : Separate<"-dependency-file">, 235 HelpText<"Filename (or -) to write dependency output to">; 236def dependency_dot : Separate<"-dependency-dot">, 237 HelpText<"Filename to write DOT-formatted header dependencies to">; 238def sys_header_deps : Flag<"-sys-header-deps">, 239 HelpText<"Include system headers in dependency output">; 240def header_include_file : Separate<"-header-include-file">, 241 HelpText<"Filename (or -) to write header include output to">; 242def H : Flag<"-H">, 243 HelpText<"Show header includes and nesting depth">; 244def MQ : Separate<"-MQ">, HelpText<"Specify target to quote for dependency">; 245def MT : Separate<"-MT">, HelpText<"Specify target for dependency">; 246def MP : Flag<"-MP">, 247 HelpText<"Create phony target for each dependency (other than main file)">; 248def MG : Flag<"-MG">, HelpText<"Add missing headers to dependency list">; 249 250//===----------------------------------------------------------------------===// 251// Diagnostic Options 252//===----------------------------------------------------------------------===// 253 254def dump_build_information : Separate<"-dump-build-information">, 255 MetaVarName<"<filename>">, 256 HelpText<"output a dump of some build information to a file">; 257def diagnostic_log_file : Separate<"-diagnostic-log-file">, 258 HelpText<"Filename (or -) to log diagnostics to">; 259def diagnostic_serialized_file : Separate<"-serialize-diagnostic-file">, 260 MetaVarName<"<filename>">, 261 HelpText<"File for serializing diagnostics in a binary format">; 262def fno_show_column : Flag<"-fno-show-column">, 263 HelpText<"Do not include column number on diagnostics">; 264def fshow_column : Flag<"-fshow-column">, 265 HelpText<"Include column number on diagnostics">; 266def fno_show_source_location : Flag<"-fno-show-source-location">, 267 HelpText<"Do not include source location information with diagnostics">; 268def fshow_overloads_EQ : Joined<"-fshow-overloads=">, 269 HelpText<"Which overload candidates to show when overload resolution fails: " 270 "best|all; defaults to all">; 271def fno_caret_diagnostics : Flag<"-fno-caret-diagnostics">, 272 HelpText<"Do not include source line and caret with diagnostics">; 273def fno_diagnostics_fixit_info : Flag<"-fno-diagnostics-fixit-info">, 274 HelpText<"Do not include fixit information in diagnostics">; 275def fno_diagnostics_show_note_include_stack : 276 Flag<"-fno-diagnostics-show-note-include-stack">, 277 HelpText<"Display include stacks for diagnostic notes">; 278def w : Flag<"-w">, HelpText<"Suppress all warnings">; 279def pedantic : Flag<"-pedantic">; 280def pedantic_errors : Flag<"-pedantic-errors">; 281 282// This gets all -W options, including -Werror, -W[no-]system-headers, etc. The 283// driver has stripped off -Wa,foo etc. The driver has also translated -W to 284// -Wextra, so we don't need to worry about it. 285def W : Joined<"-W">; 286 287def fdiagnostics_print_source_range_info : Flag<"-fdiagnostics-print-source-range-info">, 288 HelpText<"Print source range spans in numeric form">; 289def fdiagnostics_parseable_fixits : Flag<"-fdiagnostics-parseable-fixits">, 290 HelpText<"Print fix-its in machine parseable form">; 291def fdiagnostics_show_name : Flag<"-fdiagnostics-show-name">, 292 HelpText<"Print diagnostic name">; 293def fdiagnostics_show_option : Flag<"-fdiagnostics-show-option">, 294 HelpText<"Print option name with mappable diagnostics">; 295def fdiagnostics_format : Separate<"-fdiagnostics-format">, 296 HelpText<"Change diagnostic formatting to match IDE and command line tools">; 297def fdiagnostics_show_category : Separate<"-fdiagnostics-show-category">, 298 HelpText<"Print diagnostic category">; 299def fdiagnostics_show_note_include_stack : 300 Flag<"-fdiagnostics-show-note-include-stack">, 301 HelpText<"Display include stacks for diagnostic notes">; 302def ftabstop : Separate<"-ftabstop">, MetaVarName<"<N>">, 303 HelpText<"Set the tab stop distance.">; 304def ferror_limit : Separate<"-ferror-limit">, MetaVarName<"<N>">, 305 HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">; 306def fmacro_backtrace_limit : Separate<"-fmacro-backtrace-limit">, MetaVarName<"<N>">, 307 HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">; 308def ftemplate_backtrace_limit : Separate<"-ftemplate-backtrace-limit">, MetaVarName<"<N>">, 309 HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">; 310def fconstexpr_backtrace_limit : Separate<"-fconstexpr-backtrace-limit">, MetaVarName<"<N>">, 311 HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">; 312def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">, 313 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">; 314def fcolor_diagnostics : Flag<"-fcolor-diagnostics">, 315 HelpText<"Use colors in diagnostics">; 316def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">, 317 HelpText<"Silence ObjC rewriting warnings">; 318def verify : Flag<"-verify">, 319 HelpText<"Verify emitted diagnostics and warnings">; 320 321//===----------------------------------------------------------------------===// 322// Frontend Options 323//===----------------------------------------------------------------------===// 324 325// This isn't normally used, it is just here so we can parse a 326// CompilerInvocation out of a driver-derived argument vector. 327def cc1 : Flag<"-cc1">; 328 329def ast_merge : Separate<"-ast-merge">, 330 MetaVarName<"<ast file>">, 331 HelpText<"Merge the given AST file into the translation unit being compiled.">; 332def code_completion_at : Separate<"-code-completion-at">, 333 MetaVarName<"<file>:<line>:<column>">, 334 HelpText<"Dump code-completion information at a location">; 335def remap_file : Separate<"-remap-file">, 336 MetaVarName<"<from>;<to>">, 337 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">; 338def code_completion_at_EQ : Joined<"-code-completion-at=">, 339 Alias<code_completion_at>; 340def code_completion_macros : Flag<"-code-completion-macros">, 341 HelpText<"Include macros in code-completion results">; 342def code_completion_patterns : Flag<"-code-completion-patterns">, 343 HelpText<"Include code patterns in code-completion results">; 344def no_code_completion_globals : Flag<"-no-code-completion-globals">, 345 HelpText<"Do not include global declarations in code-completion results.">; 346def disable_free : Flag<"-disable-free">, 347 HelpText<"Disable freeing of memory on exit">; 348def help : Flag<"-help">, 349 HelpText<"Print this help text">; 350def _help : Flag<"--help">, Alias<help>; 351def x : Separate<"-x">, HelpText<"Input language type">; 352def o : Separate<"-o">, MetaVarName<"<path>">, HelpText<"Specify output file">; 353def load : Separate<"-load">, MetaVarName<"<dsopath>">, 354 HelpText<"Load the named plugin (dynamic shared object)">; 355def plugin : Separate<"-plugin">, MetaVarName<"<name>">, 356 HelpText<"Use the named plugin action instead of the default action (use \"help\" to list available options)">; 357def plugin_arg : JoinedAndSeparate<"-plugin-arg-">, 358 MetaVarName<"<name> <arg>">, 359 HelpText<"Pass <arg> to plugin <name>">; 360def add_plugin : Separate<"-add-plugin">, MetaVarName<"<name>">, 361 HelpText<"Use the named plugin action in addition to the default action">; 362def resource_dir : Separate<"-resource-dir">, 363 HelpText<"The directory which holds the compiler resource files">; 364def version : Flag<"-version">, 365 HelpText<"Print the compiler version">; 366def _version : Flag<"--version">, Alias<version>; 367 368def Action_Group : OptionGroup<"<action group>">; 369let Group = Action_Group in { 370 371def Eonly : Flag<"-Eonly">, 372 HelpText<"Just run preprocessor, no output (for timings)">; 373def E : Flag<"-E">, 374 HelpText<"Run preprocessor, emit preprocessed file">; 375def dump_raw_tokens : Flag<"-dump-raw-tokens">, 376 HelpText<"Lex file in raw mode and dump raw tokens">; 377def analyze : Flag<"-analyze">, 378 HelpText<"Run static analysis engine">; 379def dump_tokens : Flag<"-dump-tokens">, 380 HelpText<"Run preprocessor, dump internal rep of tokens">; 381def init_only : Flag<"-init-only">, 382 HelpText<"Only execute frontend initialization">; 383def fsyntax_only : Flag<"-fsyntax-only">, 384 HelpText<"Run parser and perform semantic analysis">; 385def fixit : Flag<"-fixit">, 386 HelpText<"Apply fix-it advice to the input source">; 387def fixit_EQ : Joined<"-fixit=">, 388 HelpText<"Apply fix-it advice creating a file with the given suffix">; 389def print_preamble : Flag<"-print-preamble">, 390 HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit" 391 " precompiled headers.">; 392def emit_html : Flag<"-emit-html">, 393 HelpText<"Output input source as HTML">; 394def ast_print : Flag<"-ast-print">, 395 HelpText<"Build ASTs and then pretty-print them">; 396def ast_dump : Flag<"-ast-dump">, 397 HelpText<"Build ASTs and then debug dump them">; 398def ast_dump_xml : Flag<"-ast-dump-xml">, 399 HelpText<"Build ASTs and then debug dump them in a verbose XML format">; 400def ast_view : Flag<"-ast-view">, 401 HelpText<"Build ASTs and view them with GraphViz">; 402def print_decl_contexts : Flag<"-print-decl-contexts">, 403 HelpText<"Print DeclContexts and their Decls">; 404def emit_module : Flag<"-emit-module">, 405 HelpText<"Generate pre-compiled module file from a module map">; 406def emit_pth : Flag<"-emit-pth">, 407 HelpText<"Generate pre-tokenized header file">; 408def emit_pch : Flag<"-emit-pch">, 409 HelpText<"Generate pre-compiled header file">; 410def S : Flag<"-S">, 411 HelpText<"Emit native assembly code">; 412def emit_llvm : Flag<"-emit-llvm">, 413 HelpText<"Build ASTs then convert to LLVM, emit .ll file">; 414def emit_llvm_bc : Flag<"-emit-llvm-bc">, 415 HelpText<"Build ASTs then convert to LLVM, emit .bc file">; 416def emit_llvm_only : Flag<"-emit-llvm-only">, 417 HelpText<"Build ASTs and convert to LLVM, discarding output">; 418def emit_codegen_only : Flag<"-emit-codegen-only">, 419 HelpText<"Generate machine code, but discard output">; 420def emit_obj : Flag<"-emit-obj">, 421 HelpText<"Emit native object files">; 422def rewrite_test : Flag<"-rewrite-test">, 423 HelpText<"Rewriter playground">; 424def rewrite_objc : Flag<"-rewrite-objc">, 425 HelpText<"Rewrite ObjC into C (code rewriter example)">; 426def rewrite_macros : Flag<"-rewrite-macros">, 427 HelpText<"Expand macros without full preprocessing">; 428} 429 430def arcmt_check : Flag<"-arcmt-check">, 431 HelpText<"Check for ARC migration issues that need manual handling">; 432def arcmt_modify : Flag<"-arcmt-modify">, 433 HelpText<"Apply modifications to files to conform to ARC">; 434def arcmt_migrate : Flag<"-arcmt-migrate">, 435 HelpText<"Apply modifications and produces temporary files that conform to ARC">; 436def arcmt_migrate_directory : Separate<"-arcmt-migrate-directory">, 437 HelpText<"Directory for temporary files produced during ARC migration">; 438def arcmt_migrate_report_output : Separate<"-arcmt-migrate-report-output">, 439 HelpText<"Output path for the plist report">; 440def arcmt_migrate_emit_arc_errors : Flag<"-arcmt-migrate-emit-errors">, 441 HelpText<"Emit ARC errors even if the migrator can fix them">; 442 443def working_directory : JoinedOrSeparate<"-working-directory">, 444 HelpText<"Resolve file paths relative to the specified directory">; 445def working_directory_EQ : Joined<"-working-directory=">, 446 Alias<working_directory>; 447 448def relocatable_pch : Flag<"-relocatable-pch">, 449 HelpText<"Whether to build a relocatable precompiled header">; 450def print_stats : Flag<"-print-stats">, 451 HelpText<"Print performance metrics and statistics">; 452def ftime_report : Flag<"-ftime-report">, 453 HelpText<"Print the amount of time each phase of compilation takes">; 454def fdump_record_layouts : Flag<"-fdump-record-layouts">, 455 HelpText<"Dump record layout information">; 456def fdump_record_layouts_simple : Flag<"-fdump-record-layouts-simple">, 457 HelpText<"Dump record layout information in a simple form used for testing">; 458def fix_what_you_can : Flag<"-fix-what-you-can">, 459 HelpText<"Apply fix-it advice even in the presence of unfixable errors">; 460def fix_only_warnings : Flag<"-fix-only-warnings">, 461 HelpText<"Apply fix-it advice only for warnings, not errors">; 462def fixit_recompile : Flag<"-fixit-recompile">, 463 HelpText<"Apply fix-it changes and recompile">; 464def fixit_to_temp : Flag<"-fixit-to-temporary">, 465 HelpText<"Apply fix-it changes to temporary files">; 466 467// Generic forwarding to LLVM options. This should only be used for debugging 468// and experimental features. 469def mllvm : Separate<"-mllvm">, 470 HelpText<"Additional arguments to forward to LLVM's option processing">; 471 472def foverride_record_layout_EQ : Joined<"-foverride-record-layout=">, 473 HelpText<"Override record layouts with those in the given file">; 474 475//===----------------------------------------------------------------------===// 476// Language Options 477//===----------------------------------------------------------------------===// 478 479def fno_builtin : Flag<"-fno-builtin">, 480 HelpText<"Disable implicit builtin knowledge of functions">; 481def faltivec : Flag<"-faltivec">, 482 HelpText<"Enable AltiVec vector initializer syntax">; 483def fno_access_control : Flag<"-fno-access-control">, 484 HelpText<"Disable C++ access control">; 485def fno_assume_sane_operator_new : Flag<"-fno-assume-sane-operator-new">, 486 HelpText<"Don't assume that C++'s global operator new can't alias any pointer">; 487def fgnu_keywords : Flag<"-fgnu-keywords">, 488 HelpText<"Allow GNU-extension keywords regardless of language standard">; 489def fgnu89_inline : Flag<"-fgnu89-inline">, 490 HelpText<"Use the gnu89 inline semantics">; 491def fno_gnu_keywords : Flag<"-fno-gnu-keywords">, 492 HelpText<"Disallow GNU-extension keywords regardless of language standard">; 493def fdollars_in_identifiers : Flag<"-fdollars-in-identifiers">, 494 HelpText<"Allow '$' in identifiers">; 495def fno_dollars_in_identifiers : Flag<"-fno-dollars-in-identifiers">, 496 HelpText<"Disallow '$' in identifiers">; 497def femit_all_decls : Flag<"-femit-all-decls">, 498 HelpText<"Emit all declarations, even if unused">; 499def fblocks : Flag<"-fblocks">, 500 HelpText<"Enable the 'blocks' language feature">; 501def fblocks_runtime_optional : Flag<"-fblocks-runtime-optional">, 502 HelpText<"Weakly link in the blocks runtime">; 503def fheinous_gnu_extensions : Flag<"-fheinous-gnu-extensions">; 504def fexceptions : Flag<"-fexceptions">, 505 HelpText<"Enable support for exception handling">; 506def fobjc_exceptions : Flag<"-fobjc-exceptions">, 507 HelpText<"Enable Objective-C exceptions">; 508def fcxx_exceptions : Flag<"-fcxx-exceptions">, 509 HelpText<"Enable C++ exceptions">; 510def fsjlj_exceptions : Flag<"-fsjlj-exceptions">, 511 HelpText<"Use SjLj style exceptions">; 512def ffast_math : Flag<"-ffast-math">, 513 HelpText<"Enable the *frontend*'s 'fast-math' mode. This has no effect on " 514 "optimizations, but provides a preprocessor macro __FAST_MATH__ the " 515 "same as GCC's -ffast-math flag.">; 516def ffreestanding : Flag<"-ffreestanding">, 517 HelpText<"Assert that the compilation takes place in a freestanding environment">; 518def fgnu_runtime : Flag<"-fgnu-runtime">, 519 HelpText<"Generate output compatible with the standard GNU Objective-C runtime">; 520def fhidden_weak_vtables : Flag<"-fhidden-weak-vtables">, 521 HelpText<"Generate weak vtables and RTTI with hidden visibility">; 522def std_EQ : Joined<"-std=">, 523 HelpText<"Language standard to compile for">; 524def stdlib_EQ : Joined<"-stdlib=">, 525 HelpText<"C++ standard library to use">; 526def fmath_errno : Flag<"-fmath-errno">, 527 HelpText<"Require math functions to indicate errors by setting errno">; 528def fms_extensions : Flag<"-fms-extensions">, 529 HelpText<"Accept some non-standard constructs supported by the Microsoft compiler">; 530def fms_compatibility : Flag<"-fms-compatibility">, 531 HelpText<"Enable Microsoft compatibility mode">; 532def fmsc_version : Joined<"-fmsc-version=">, 533 HelpText<"Version of the Microsoft C/C++ compiler to report in _MSC_VER (0 = don't define it (default))">; 534def fborland_extensions : Flag<"-fborland-extensions">, 535 HelpText<"Accept non-standard constructs supported by the Borland compiler">; 536def main_file_name : Separate<"-main-file-name">, 537 HelpText<"Main file name to use for debug info">; 538def fno_elide_constructors : Flag<"-fno-elide-constructors">, 539 HelpText<"Disable C++ copy constructor elision">; 540def fno_lax_vector_conversions : Flag<"-fno-lax-vector-conversions">, 541 HelpText<"Disallow implicit conversions between vectors with a different number of elements or different element types">; 542def fno_operator_names : Flag<"-fno-operator-names">, 543 HelpText<"Do not treat C++ operator name keywords as synonyms for operators">; 544def fno_signed_char : Flag<"-fno-signed-char">, 545 HelpText<"Char is unsigned">; 546def fno_spell_checking : Flag<"-fno-spell-checking">, 547 HelpText<"Disable spell-checking">; 548def fno_use_cxa_atexit : Flag<"-fno-use-cxa-atexit">, 549 HelpText<"Don't use __cxa_atexit for calling destructors">; 550def fconstant_string_class : Separate<"-fconstant-string-class">, 551 MetaVarName<"<class name>">, 552 HelpText<"Specify the class to use for constant Objective-C string objects.">; 553def fno_constant_cfstrings : Flag<"-fno-constant-cfstrings">, 554 HelpText<"Enable creation of CodeFoundation-type constant strings">; 555def fobjc_arc : Flag<"-fobjc-arc">, 556 HelpText<"Synthesize retain and release calls for Objective-C pointers">; 557def fobjc_arc_cxxlib_EQ : Joined<"-fobjc-arc-cxxlib=">, 558 HelpText<"Objective-C++ Automatic Reference Counting standard library kind">; 559def fobjc_arc_exceptions : Flag<"-fobjc-arc-exceptions">, 560 HelpText<"Use EH-safe code when synthesizing retains and releases in -fobjc-arc">; 561def fobjc_runtime_has_arc : Flag<"-fobjc-runtime-has-arc">, 562 HelpText<"The target Objective-C runtime provides ARC entrypoints">; 563def fobjc_runtime_has_weak : Flag<"-fobjc-runtime-has-weak">, 564 HelpText<"The target Objective-C runtime supports ARC weak operations">; 565def fobjc_runtime_has_terminate : Flag<"-fobjc-runtime-has-terminate">, 566 HelpText<"The target Objective-C runtime provides an objc_terminate entrypoint">; 567def fobjc_gc : Flag<"-fobjc-gc">, 568 HelpText<"Enable Objective-C garbage collection">; 569def fobjc_gc_only : Flag<"-fobjc-gc-only">, 570 HelpText<"Use GC exclusively for Objective-C related memory management">; 571def fapple_kext : Flag<"-fapple-kext">, 572 HelpText<"Use Apple's kernel extensions ABI">; 573def fobjc_dispatch_method_EQ : Joined<"-fobjc-dispatch-method=">, 574 HelpText<"Objective-C dispatch method to use">; 575def fobjc_default_synthesize_properties : Flag<"-fobjc-default-synthesize-properties">, 576 HelpText<"enable the default synthesis of Objective-C properties">; 577def print_ivar_layout : Flag<"-print-ivar-layout">, 578 HelpText<"Enable Objective-C Ivar layout bitmap print trace">; 579def fobjc_fragile_abi : Flag<"-fobjc-fragile-abi">, 580 HelpText<"Use Objective-C's fragile ABI">; 581def fno_objc_infer_related_result_type : Flag< 582 "-fno-objc-infer-related-result-type">, 583 HelpText< 584 "do not infer Objective-C related result type based on method family">; 585def ftrapv : Flag<"-ftrapv">, 586 HelpText<"Trap on integer overflow">; 587def ftrapv_handler : Separate<"-ftrapv-handler">, 588 MetaVarName<"<function name>">, 589 HelpText<"Specify the function to be called on overflow.">; 590def fwrapv : Flag<"-fwrapv">, 591 HelpText<"Treat signed integer overflow as two's complement">; 592def pic_level : Separate<"-pic-level">, 593 HelpText<"Value for __PIC__">; 594def pthread : Flag<"-pthread">, 595 HelpText<"Support POSIX threads in generated code">; 596def fpack_struct : Separate<"-fpack-struct">, 597 HelpText<"Specify the default maximum struct packing alignment">; 598def fpascal_strings : Flag<"-fpascal-strings">, 599 HelpText<"Recognize and construct Pascal-style string literals">; 600def fno_rtti : Flag<"-fno-rtti">, 601 HelpText<"Disable generation of rtti information">; 602def fno_validate_pch : Flag<"-fno-validate-pch">, 603 HelpText<"Disable validation of precompiled headers">; 604def dump_deserialized_pch_decls : Flag<"-dump-deserialized-decls">, 605 HelpText<"Dump declarations that are deserialized from PCH, for testing">; 606def error_on_deserialized_pch_decl : Separate<"-error-on-deserialized-decl">, 607 HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">; 608def error_on_deserialized_pch_decl_EQ : Joined<"-error-on-deserialized-decl=">, 609 Alias<error_on_deserialized_pch_decl>; 610def fshort_wchar : Flag<"-fshort-wchar">, 611 HelpText<"Force wchar_t to be a short unsigned int">; 612def fshort_enums : Flag<"-fshort-enums">, 613 HelpText<"Allocate to an enum type only as many bytes as it needs for the declared range of possible values">; 614def static_define : Flag<"-static-define">, 615 HelpText<"Should __STATIC__ be defined">; 616def stack_protector : Separate<"-stack-protector">, 617 HelpText<"Enable stack protectors">; 618def fvisibility : Separate<"-fvisibility">, 619 HelpText<"Default symbol visibility">; 620def fvisibility_inlines_hidden : Flag<"-fvisibility-inlines-hidden">, 621 HelpText<"Give inline C++ member functions default visibility by default">; 622def ftemplate_depth : Separate<"-ftemplate-depth">, 623 HelpText<"Maximum depth of recursive template instantiation">; 624def fconstexpr_depth : Separate<"-fconstexpr-depth">, 625 HelpText<"Maximum depth of recursive constexpr function calls">; 626def Wlarge_by_value_copy : Separate<"-Wlarge-by-value-copy">, 627 HelpText<"Warn if a function definition returns or accepts an object larger " 628 "in bytes that a given value">; 629def Wlarge_by_value_copy_EQ : Joined<"-Wlarge-by-value-copy=">, 630 Alias<Wlarge_by_value_copy>; 631def trigraphs : Flag<"-trigraphs">, 632 HelpText<"Process trigraph sequences">; 633def fwritable_strings : Flag<"-fwritable-strings">, 634 HelpText<"Store string literals as writable data">; 635def fconst_strings : Flag<"-fconst-strings">, 636 HelpText<"Use a const qualified type for string literals in C and ObjC">; 637def fno_const_strings : Flag<"-fno-const-strings">, 638 HelpText<"Don't use a const qualified type for string literals in C and ObjC">; 639def fno_bitfield_type_align : Flag<"-fno-bitfield-type-align">, 640 HelpText<"Ignore bit-field types when aligning structures">; 641def traditional_cpp : Flag<"-traditional-cpp">, 642 HelpText<"Enable some traditional CPP emulation">; 643def ffake_address_space_map : Flag<"-ffake-address-space-map">, 644 HelpText<"Use a fake address space map; OpenCL testing purposes only">; 645def fdelayed_template_parsing : Flag<"-fdelayed-template-parsing">, 646 HelpText<"Parse templated function definitions at the end of the " 647 "translation unit ">; 648def funknown_anytype : Flag<"-funknown-anytype">, 649 HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">; 650def fdebugger_support : Flag<"-fdebugger-support">, 651 HelpText<"Enable special debugger support behavior">; 652def fdeprecated_macro : Flag<"-fdeprecated-macro">, 653 HelpText<"Defines the __DEPRECATED macro">; 654def fno_deprecated_macro : Flag<"-fno-deprecated-macro">, 655 HelpText<"Undefines the __DEPRECATED macro">; 656def fapple_pragma_pack : Flag<"-fapple-pragma-pack">, 657 HelpText<"Enable Apple gcc-compatible #pragma pack handling">; 658 659//===----------------------------------------------------------------------===// 660// Header Search Options 661//===----------------------------------------------------------------------===// 662 663def nostdsysteminc : Flag<"-nostdsysteminc">, 664 HelpText<"Disable standard system #include directories">; 665def nostdincxx : Flag<"-nostdinc++">, 666 HelpText<"Disable standard #include directories for the C++ standard library">; 667def nobuiltininc : Flag<"-nobuiltininc">, 668 HelpText<"Disable builtin #include directories">; 669def fmodule_cache_path : Separate<"-fmodule-cache-path">, 670 MetaVarName<"<directory>">, 671 HelpText<"Specify the module cache path">; 672def fmodule_name : Joined<"-fmodule-name=">, 673 MetaVarName<"<name>">, 674 HelpText<"Specify the name of the module to build">; 675def fdisable_module_hash : Flag<"-fdisable-module-hash">, 676 HelpText<"Disable the module hash">; 677def fmodules : Flag<"-fmodules">, 678 HelpText<"Enable the 'modules' language feature">; 679 680def F : JoinedOrSeparate<"-F">, MetaVarName<"<directory>">, 681 HelpText<"Add directory to framework include search path">; 682def I : JoinedOrSeparate<"-I">, MetaVarName<"<directory>">, 683 HelpText<"Add directory to include search path">; 684def idirafter : JoinedOrSeparate<"-idirafter">, MetaVarName<"<directory>">, 685 HelpText<"Add directory to AFTER include search path">; 686def index_header_map : Flag<"-index-header-map">, 687 HelpText<"Make the next included directory (-I or -F) an indexer header map">; 688def iquote : JoinedOrSeparate<"-iquote">, MetaVarName<"<directory>">, 689 HelpText<"Add directory to QUOTE include search path">; 690def c_isystem : JoinedOrSeparate<"-c-isystem">, MetaVarName<"<directory>">, 691 HelpText<"Add directory to the C SYSTEM include search path">; 692def cxx_isystem : JoinedOrSeparate<"-cxx-isystem">, MetaVarName<"<directory>">, 693 HelpText<"Add directory to the C++ SYSTEM include search path">; 694def objc_isystem : JoinedOrSeparate<"-objc-isystem">, 695 MetaVarName<"<directory>">, 696 HelpText<"Add directory to the ObjC SYSTEM include search path">; 697def objcxx_isystem : JoinedOrSeparate<"-objcxx-isystem">, 698 MetaVarName<"<directory>">, 699 HelpText<"Add directory to the ObjC++ SYSTEM include search path">; 700def iframework : JoinedOrSeparate<"-iframework">, MetaVarName<"<directory>">, 701 HelpText<"Add directory to SYSTEM framework search path">; 702def isystem : JoinedOrSeparate<"-isystem">, MetaVarName<"<directory>">, 703 HelpText<"Add directory to SYSTEM include search path">; 704def iwithsysroot : JoinedOrSeparate<"-iwithsysroot">,MetaVarName<"<directory>">, 705 HelpText<"Add directory to SYSTEM include search path, " 706 "absolute paths are relative to -isysroot">; 707def internal_isystem : JoinedOrSeparate<"-internal-isystem">, 708 MetaVarName<"<directory>">, 709 HelpText<"Add directory to the internal system include search path; these " 710 "are assumed to not be user-provided and are used to model system " 711 "and standard headers' paths.">; 712def internal_externc_isystem : JoinedOrSeparate<"-internal-externc-isystem">, 713 MetaVarName<"<directory>">, 714 HelpText<"Add directory to the internal system include search path with " 715 "implicit extern \"C\" semantics; these are assumed to not be " 716 "user-provided and are used to model system and standard headers' " 717 "paths.">; 718def iprefix : JoinedOrSeparate<"-iprefix">, MetaVarName<"<prefix>">, 719 HelpText<"Set the -iwithprefix/-iwithprefixbefore prefix">; 720def iwithprefix : JoinedOrSeparate<"-iwithprefix">, MetaVarName<"<dir>">, 721 HelpText<"Set directory to SYSTEM include search path with prefix">; 722def iwithprefixbefore : JoinedOrSeparate<"-iwithprefixbefore">, 723 MetaVarName<"<dir>">, 724 HelpText<"Set directory to include search path with prefix">; 725def isysroot : JoinedOrSeparate<"-isysroot">, MetaVarName<"<dir>">, 726 HelpText<"Set the system root directory (usually /)">; 727def v : Flag<"-v">, HelpText<"Enable verbose output">; 728 729//===----------------------------------------------------------------------===// 730// Preprocessor Options 731//===----------------------------------------------------------------------===// 732 733def D : JoinedOrSeparate<"-D">, MetaVarName<"<macro>">, 734 HelpText<"Predefine the specified macro">; 735def include_ : JoinedOrSeparate<"-include">, MetaVarName<"<file>">, EnumName<"include">, 736 HelpText<"Include file before parsing">; 737def imacros : JoinedOrSeparate<"-imacros">, MetaVarName<"<file>">, 738 HelpText<"Include macros from file before parsing">; 739def include_pch : Separate<"-include-pch">, MetaVarName<"<file>">, 740 HelpText<"Include precompiled header file">; 741def include_pth : Separate<"-include-pth">, MetaVarName<"<file>">, 742 HelpText<"Include file before parsing">; 743def chain_include : Separate<"-chain-include">, MetaVarName<"<file>">, 744 HelpText<"Include and chain a header file after turning it into PCH">; 745def preamble_bytes_EQ : Joined<"-preamble-bytes=">, 746 HelpText<"Assume that the precompiled header is a precompiled preamble " 747 "covering the first N bytes of the main file">; 748def token_cache : Separate<"-token-cache">, MetaVarName<"<path>">, 749 HelpText<"Use specified token cache file">; 750def U : JoinedOrSeparate<"-U">, MetaVarName<"<macro>">, 751 HelpText<"Undefine the specified macro">; 752def undef : Flag<"-undef">, MetaVarName<"<macro>">, 753 HelpText<"undef all system defines">; 754def detailed_preprocessing_record : Flag<"-detailed-preprocessing-record">, 755 HelpText<"include a detailed record of preprocessing actions">; 756def mqdsp6_compat : Flag<"-mqdsp6-compat">, 757 HelpText<"Enable hexagon-qdsp6 backward compatibility">; 758 759//===----------------------------------------------------------------------===// 760// Preprocessed Output Options 761//===----------------------------------------------------------------------===// 762 763def P : Flag<"-P">, 764 HelpText<"Disable linemarker output in -E mode">; 765def C : Flag<"-C">, 766 HelpText<"Enable comment output in -E mode">; 767def CC : Flag<"-CC">, 768 HelpText<"Enable comment output in -E mode, even from macro expansions">; 769def dM : Flag<"-dM">, 770 HelpText<"Print macro definitions in -E mode instead of normal output">; 771def dD : Flag<"-dD">, 772 HelpText<"Print macro definitions in -E mode in addition to normal output">; 773 774//===----------------------------------------------------------------------===// 775// OpenCL Options 776//===----------------------------------------------------------------------===// 777 778def cl_opt_disable : Flag<"-cl-opt-disable">, 779 HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">; 780def cl_single_precision_constant : Flag<"-cl-single-precision-constant">, 781 HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">; 782def cl_finite_math_only : Flag<"-cl-finite-math-only">, 783 HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">; 784def cl_unsafe_math_optimizations : Flag<"-cl-unsafe-math-optimizations">, 785 HelpText<"OpenCL only. Allow unsafe floating-point optimizations. Also implies -cl-no-signed-zeros and -cl-mad-enable">; 786def cl_fast_relaxed_math : Flag<"-cl-fast-relaxed-math">, 787 HelpText<"OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines __FAST_RELAXED_MATH__">; 788def cl_mad_enable : Flag<"-cl-mad-enable">, 789 HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">; 790def cl_std_EQ : Joined<"-cl-std=">, 791 HelpText<"OpenCL language standard to compile for">; 792 793//===----------------------------------------------------------------------===// 794// CUDA Options 795//===----------------------------------------------------------------------===// 796 797def fcuda_is_device : Flag<"-fcuda-is-device">, 798 HelpText<"Generate code for CUDA device">; 799