]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - contrib/llvm/tools/clang/include/clang/Driver/CC1Options.td
MFV r339640,339641,339644:
[FreeBSD/FreeBSD.git] / contrib / llvm / tools / clang / 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 (for C++ include parameters in name)">;
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   ValuesCode<[{
104     const char *Values =
105     #define GET_CHECKERS
106     #define CHECKER(FULLNAME, CLASS, DESCFILE, HT, G, H)  FULLNAME ","
107     #include "clang/StaticAnalyzer/Checkers/Checkers.inc"
108     #undef GET_CHECKERS
109     #define GET_PACKAGES
110     #define PACKAGE(FULLNAME, G, D)  FULLNAME ","
111     #include "clang/StaticAnalyzer/Checkers/Checkers.inc"
112     #undef GET_PACKAGES
113     ;
114   }]>;
115 def analyzer_checker_EQ : Joined<["-"], "analyzer-checker=">,
116   Alias<analyzer_checker>;
117
118 def analyzer_disable_checker : Separate<["-"], "analyzer-disable-checker">,
119   HelpText<"Choose analyzer checkers to disable">;
120 def analyzer_disable_checker_EQ : Joined<["-"], "analyzer-disable-checker=">,
121   Alias<analyzer_disable_checker>;
122
123 def analyzer_disable_all_checks : Flag<["-"], "analyzer-disable-all-checks">,
124   HelpText<"Disable all static analyzer checks">;
125
126 def analyzer_checker_help : Flag<["-"], "analyzer-checker-help">,
127   HelpText<"Display the list of analyzer checkers that are available">;
128
129 def analyzer_list_enabled_checkers : Flag<["-"], "analyzer-list-enabled-checkers">,
130   HelpText<"Display the list of enabled analyzer checkers">;
131
132 def analyzer_config : Separate<["-"], "analyzer-config">,
133   HelpText<"Choose analyzer options to enable">;
134
135 //===----------------------------------------------------------------------===//
136 // Migrator Options
137 //===----------------------------------------------------------------------===//
138 def migrator_no_nsalloc_error : Flag<["-"], "no-ns-alloc-error">,
139   HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">;
140
141 def migrator_no_finalize_removal : Flag<["-"], "no-finalize-removal">,
142   HelpText<"Do not remove finalize method in gc mode">;
143
144 //===----------------------------------------------------------------------===//
145 // CodeGen Options
146 //===----------------------------------------------------------------------===//
147
148 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
149 def debug_info_kind_EQ : Joined<["-"], "debug-info-kind=">;
150 def debug_info_macro : Flag<["-"], "debug-info-macro">,
151   HelpText<"Emit macro debug information">;
152 def dwarf_version_EQ : Joined<["-"], "dwarf-version=">;
153 def debugger_tuning_EQ : Joined<["-"], "debugger-tuning=">;
154 def fdebug_compilation_dir : Separate<["-"], "fdebug-compilation-dir">,
155   HelpText<"The compilation directory to embed in the debug info.">;
156 def dwarf_debug_flags : Separate<["-"], "dwarf-debug-flags">,
157   HelpText<"The string to embed in the Dwarf debug flags record.">;
158 def compress_debug_sections : Flag<["-", "--"], "compress-debug-sections">,
159     HelpText<"DWARF debug sections compression">;
160 def compress_debug_sections_EQ : Joined<["-"], "compress-debug-sections=">,
161     HelpText<"DWARF debug sections compression type">;
162 def mno_exec_stack : Flag<["-"], "mnoexecstack">,
163   HelpText<"Mark the file as not needing an executable stack">;
164 def massembler_fatal_warnings : Flag<["-"], "massembler-fatal-warnings">,
165   HelpText<"Make assembler warnings fatal">;
166 def mrelax_relocations : Flag<["--"], "mrelax-relocations">,
167     HelpText<"Use relaxable elf relocations">;
168 def msave_temp_labels : Flag<["-"], "msave-temp-labels">,
169   HelpText<"Save temporary labels in the symbol table. "
170            "Note this may change .s semantics and shouldn't generally be used "
171            "on compiler-generated code.">;
172 def mrelocation_model : Separate<["-"], "mrelocation-model">,
173   HelpText<"The relocation model to use">, Values<"static,pic,ropi,rwpi,ropi-rwpi,dynamic-no-pic">;
174 def fno_math_builtin : Flag<["-"], "fno-math-builtin">,
175   HelpText<"Disable implicit builtin knowledge of math functions">;
176 }
177
178 def disable_llvm_verifier : Flag<["-"], "disable-llvm-verifier">,
179   HelpText<"Don't run the LLVM IR verifier pass">;
180 def disable_llvm_passes : Flag<["-"], "disable-llvm-passes">,
181   HelpText<"Use together with -emit-llvm to get pristine LLVM IR from the "
182            "frontend by not running any LLVM passes at all">;
183 def disable_llvm_optzns : Flag<["-"], "disable-llvm-optzns">,
184   Alias<disable_llvm_passes>;
185 def disable_lifetimemarkers : Flag<["-"], "disable-lifetime-markers">,
186   HelpText<"Disable lifetime-markers emission even when optimizations are "
187            "enabled">;
188 def disable_O0_optnone : Flag<["-"], "disable-O0-optnone">,
189   HelpText<"Disable adding the optnone attribute to functions at O0">;
190 def disable_red_zone : Flag<["-"], "disable-red-zone">,
191   HelpText<"Do not emit code that uses the red zone.">;
192 def dwarf_column_info : Flag<["-"], "dwarf-column-info">,
193   HelpText<"Turn on column location information.">;
194 def split_dwarf : Flag<["-"], "split-dwarf">,
195   HelpText<"Split out the dwarf .dwo sections">;
196 def gnu_pubnames : Flag<["-"], "gnu-pubnames">,
197   HelpText<"Emit newer GNU style pubnames">;
198 def arange_sections : Flag<["-"], "arange_sections">,
199   HelpText<"Emit DWARF .debug_arange sections">;
200 def dwarf_ext_refs : Flag<["-"], "dwarf-ext-refs">,
201   HelpText<"Generate debug info with external references to clang modules"
202            " or precompiled headers">;
203 def dwarf_explicit_import : Flag<["-"], "dwarf-explicit-import">,
204   HelpText<"Generate explicit import from anonymous namespace to containing"
205            " scope">;
206 def debug_forward_template_params : Flag<["-"], "debug-forward-template-params">,
207   HelpText<"Emit complete descriptions of template parameters in forward"
208            " declarations">;
209 def fforbid_guard_variables : Flag<["-"], "fforbid-guard-variables">,
210   HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
211 def no_implicit_float : Flag<["-"], "no-implicit-float">,
212   HelpText<"Don't generate implicit floating point instructions">;
213 def fdump_vtable_layouts : Flag<["-"], "fdump-vtable-layouts">,
214   HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
215 def fmerge_functions : Flag<["-"], "fmerge-functions">,
216   HelpText<"Permit merging of identical functions when optimizing.">;
217 def femit_coverage_notes : Flag<["-"], "femit-coverage-notes">,
218   HelpText<"Emit a gcov coverage notes file when compiling.">;
219 def femit_coverage_data: Flag<["-"], "femit-coverage-data">,
220   HelpText<"Instrument the program to emit gcov coverage data when run.">;
221 def coverage_data_file : Separate<["-"], "coverage-data-file">,
222   HelpText<"Emit coverage data to this filename.">;
223 def coverage_data_file_EQ : Joined<["-"], "coverage-data-file=">,
224   Alias<coverage_data_file>;
225 def coverage_notes_file : Separate<["-"], "coverage-notes-file">,
226   HelpText<"Emit coverage notes to this filename.">;
227 def coverage_notes_file_EQ : Joined<["-"], "coverage-notes-file=">,
228   Alias<coverage_notes_file>;
229 def coverage_cfg_checksum : Flag<["-"], "coverage-cfg-checksum">,
230   HelpText<"Emit CFG checksum for functions in .gcno files.">;
231 def coverage_no_function_names_in_data : Flag<["-"], "coverage-no-function-names-in-data">,
232   HelpText<"Emit function names in .gcda files.">;
233 def coverage_exit_block_before_body : Flag<["-"], "coverage-exit-block-before-body">,
234   HelpText<"Emit the exit block before the body blocks in .gcno files.">;
235 def coverage_version_EQ : Joined<["-"], "coverage-version=">,
236   HelpText<"Four-byte version string for gcov files.">;
237 def test_coverage : Flag<["-"], "test-coverage">,
238   HelpText<"Do not generate coverage files or remove coverage changes from IR">;
239 def dump_coverage_mapping : Flag<["-"], "dump-coverage-mapping">,
240   HelpText<"Dump the coverage mapping records, for testing">;
241 def fuse_register_sized_bitfield_access: Flag<["-"], "fuse-register-sized-bitfield-access">,
242   HelpText<"Use register sized accesses to bit-fields, when possible.">;
243 def relaxed_aliasing : Flag<["-"], "relaxed-aliasing">,
244   HelpText<"Turn off Type Based Alias Analysis">;
245 def no_struct_path_tbaa : Flag<["-"], "no-struct-path-tbaa">,
246   HelpText<"Turn off struct-path aware Type Based Alias Analysis">;
247 def new_struct_path_tbaa : Flag<["-"], "new-struct-path-tbaa">,
248   HelpText<"Enable enhanced struct-path aware Type Based Alias Analysis">;
249 def masm_verbose : Flag<["-"], "masm-verbose">,
250   HelpText<"Generate verbose assembly output">;
251 def mcode_model : Separate<["-"], "mcode-model">,
252   HelpText<"The code model to use">, Values<"small,kernel,medium,large">;
253 def mdebug_pass : Separate<["-"], "mdebug-pass">,
254   HelpText<"Enable additional debug output">;
255 def mdisable_fp_elim : Flag<["-"], "mdisable-fp-elim">,
256   HelpText<"Disable frame pointer elimination optimization">;
257 def mdisable_tail_calls : Flag<["-"], "mdisable-tail-calls">,
258   HelpText<"Disable tail call optimization, keeping the call stack accurate">;
259 def menable_no_infinities : Flag<["-"], "menable-no-infs">,
260   HelpText<"Allow optimization to assume there are no infinities.">;
261 def menable_no_nans : Flag<["-"], "menable-no-nans">,
262   HelpText<"Allow optimization to assume there are no NaNs.">;
263 def menable_unsafe_fp_math : Flag<["-"], "menable-unsafe-fp-math">,
264   HelpText<"Allow unsafe floating-point math optimizations which may decrease "
265            "precision">;
266 def mreassociate : Flag<["-"], "mreassociate">,
267   HelpText<"Allow reassociation transformations for floating-point instructions">;
268 def mfloat_abi : Separate<["-"], "mfloat-abi">,
269   HelpText<"The float ABI to use">;
270 def mtp : Separate<["-"], "mtp">,
271   HelpText<"Mode for reading thread pointer">;
272 def mlimit_float_precision : Separate<["-"], "mlimit-float-precision">,
273   HelpText<"Limit float precision to the given value">;
274 def split_stacks : Flag<["-"], "split-stacks">,
275   HelpText<"Try to use a split stack if possible.">;
276 def mno_zero_initialized_in_bss : Flag<["-"], "mno-zero-initialized-in-bss">,
277   HelpText<"Do not put zero initialized data in the BSS">;
278 def backend_option : Separate<["-"], "backend-option">,
279   HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
280 def mregparm : Separate<["-"], "mregparm">,
281   HelpText<"Limit the number of registers available for integer arguments">;
282 def munwind_tables : Flag<["-"], "munwind-tables">,
283   HelpText<"Generate unwinding tables for all functions">;
284 def mconstructor_aliases : Flag<["-"], "mconstructor-aliases">,
285   HelpText<"Emit complete constructors and destructors as aliases when possible">;
286 def mlink_bitcode_file : Separate<["-"], "mlink-bitcode-file">,
287   HelpText<"Link the given bitcode file before performing optimizations.">;
288 def mlink_cuda_bitcode : Separate<["-"], "mlink-cuda-bitcode">,
289   HelpText<"Link and internalize needed symbols from the given bitcode file "
290            "before performing optimizations.">;
291 def vectorize_loops : Flag<["-"], "vectorize-loops">,
292   HelpText<"Run the Loop vectorization passes">;
293 def vectorize_slp : Flag<["-"], "vectorize-slp">,
294   HelpText<"Run the SLP vectorization passes">;
295 def dependent_lib : Joined<["--"], "dependent-lib=">,
296   HelpText<"Add dependent library">;
297 def linker_option : Joined<["--"], "linker-option=">,
298   HelpText<"Add linker option">;
299 def fsanitize_coverage_type : Joined<["-"], "fsanitize-coverage-type=">,
300                               HelpText<"Sanitizer coverage type">;
301 def fsanitize_coverage_indirect_calls
302     : Flag<["-"], "fsanitize-coverage-indirect-calls">,
303       HelpText<"Enable sanitizer coverage for indirect calls">;
304 def fsanitize_coverage_trace_bb
305     : Flag<["-"], "fsanitize-coverage-trace-bb">,
306       HelpText<"Enable basic block tracing in sanitizer coverage">;
307 def fsanitize_coverage_trace_cmp
308     : Flag<["-"], "fsanitize-coverage-trace-cmp">,
309       HelpText<"Enable cmp instruction tracing in sanitizer coverage">;
310 def fsanitize_coverage_trace_div
311     : Flag<["-"], "fsanitize-coverage-trace-div">,
312       HelpText<"Enable div instruction tracing in sanitizer coverage">;
313 def fsanitize_coverage_trace_gep
314     : Flag<["-"], "fsanitize-coverage-trace-gep">,
315       HelpText<"Enable gep instruction tracing in sanitizer coverage">;
316 def fsanitize_coverage_8bit_counters
317     : Flag<["-"], "fsanitize-coverage-8bit-counters">,
318       HelpText<"Enable frequency counters in sanitizer coverage">;
319 def fsanitize_coverage_inline_8bit_counters
320     : Flag<["-"], "fsanitize-coverage-inline-8bit-counters">,
321       HelpText<"Enable inline 8-bit counters in sanitizer coverage">;
322 def fsanitize_coverage_pc_table
323     : Flag<["-"], "fsanitize-coverage-pc-table">,
324       HelpText<"Create a table of coverage-instrumented PCs">;
325 def fsanitize_coverage_trace_pc
326     : Flag<["-"], "fsanitize-coverage-trace-pc">,
327       HelpText<"Enable PC tracing in sanitizer coverage">;
328 def fsanitize_coverage_trace_pc_guard
329     : Flag<["-"], "fsanitize-coverage-trace-pc-guard">,
330       HelpText<"Enable PC tracing with guard in sanitizer coverage">;
331 def fsanitize_coverage_no_prune
332     : Flag<["-"], "fsanitize-coverage-no-prune">,
333       HelpText<"Disable coverage pruning (i.e. instrument all blocks/edges)">;
334 def fsanitize_coverage_stack_depth
335     : Flag<["-"], "fsanitize-coverage-stack-depth">,
336       HelpText<"Enable max stack depth tracing">;
337 def fprofile_instrument_EQ : Joined<["-"], "fprofile-instrument=">,
338     HelpText<"Enable PGO instrumentation. The accepted value is clang, llvm, "
339              "or none">, Values<"none,clang,llvm">;
340 def fprofile_instrument_path_EQ : Joined<["-"], "fprofile-instrument-path=">,
341     HelpText<"Generate instrumented code to collect execution counts into "
342              "<file> (overridden by LLVM_PROFILE_FILE env var)">;
343 def fprofile_instrument_use_path_EQ :
344     Joined<["-"], "fprofile-instrument-use-path=">,
345     HelpText<"Specify the profile path in PGO use compilation">;
346 def flto_visibility_public_std:
347     Flag<["-"], "flto-visibility-public-std">,
348     HelpText<"Use public LTO visibility for classes in std and stdext namespaces">;
349 def flto_unit: Flag<["-"], "flto-unit">,
350     HelpText<"Emit IR to support LTO unit features (CFI, whole program vtable opt)">;
351 def fno_lto_unit: Flag<["-"], "fno-lto-unit">;
352 def fthin_link_bitcode_EQ : Joined<["-"], "fthin-link-bitcode=">,
353     HelpText<"Write minimized bitcode to <file> for the ThinLTO thin link only">;
354 def fdebug_pass_manager : Flag<["-"], "fdebug-pass-manager">,
355     HelpText<"Prints debug information for the new pass manager">;
356 def fno_debug_pass_manager : Flag<["-"], "fno-debug-pass-manager">,
357     HelpText<"Disables debug printing for the new pass manager">;
358
359 //===----------------------------------------------------------------------===//
360 // Dependency Output Options
361 //===----------------------------------------------------------------------===//
362
363 def sys_header_deps : Flag<["-"], "sys-header-deps">,
364   HelpText<"Include system headers in dependency output">;
365 def module_file_deps : Flag<["-"], "module-file-deps">,
366   HelpText<"Include module files in dependency output">;
367 def header_include_file : Separate<["-"], "header-include-file">,
368   HelpText<"Filename (or -) to write header include output to">;
369 def show_includes : Flag<["--"], "show-includes">,
370   HelpText<"Print cl.exe style /showIncludes to stdout">;
371
372 //===----------------------------------------------------------------------===//
373 // Diagnostic Options
374 //===----------------------------------------------------------------------===//
375
376 def diagnostic_log_file : Separate<["-"], "diagnostic-log-file">,
377   HelpText<"Filename (or -) to log diagnostics to">;
378 def diagnostic_serialized_file : Separate<["-"], "serialize-diagnostic-file">,
379   MetaVarName<"<filename>">,
380   HelpText<"File for serializing diagnostics in a binary format">;
381
382 def fdiagnostics_format : Separate<["-"], "fdiagnostics-format">,
383   HelpText<"Change diagnostic formatting to match IDE and command line tools">, Values<"clang,msvc,msvc-fallback,vi">;
384 def fdiagnostics_show_category : Separate<["-"], "fdiagnostics-show-category">,
385   HelpText<"Print diagnostic category">, Values<"none,id,name">;
386 def fno_diagnostics_use_presumed_location : Flag<["-"], "fno-diagnostics-use-presumed-location">,
387   HelpText<"Ignore #line directives when displaying diagnostic locations">;
388 def ftabstop : Separate<["-"], "ftabstop">, MetaVarName<"<N>">,
389   HelpText<"Set the tab stop distance.">;
390 def ferror_limit : Separate<["-"], "ferror-limit">, MetaVarName<"<N>">,
391   HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
392 def fmacro_backtrace_limit : Separate<["-"], "fmacro-backtrace-limit">, MetaVarName<"<N>">,
393   HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
394 def ftemplate_backtrace_limit : Separate<["-"], "ftemplate-backtrace-limit">, MetaVarName<"<N>">,
395   HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
396 def fconstexpr_backtrace_limit : Separate<["-"], "fconstexpr-backtrace-limit">, MetaVarName<"<N>">,
397   HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">;
398 def fspell_checking_limit : Separate<["-"], "fspell-checking-limit">, MetaVarName<"<N>">,
399   HelpText<"Set the maximum number of times to perform spell checking on unrecognized identifiers (0 = no limit).">;
400 def fcaret_diagnostics_max_lines :
401   Separate<["-"], "fcaret-diagnostics-max-lines">, MetaVarName<"<N>">,
402   HelpText<"Set the maximum number of source lines to show in a caret diagnostic">;
403 def fmessage_length : Separate<["-"], "fmessage-length">, MetaVarName<"<N>">,
404   HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
405 def verify_EQ : CommaJoined<["-"], "verify=">,
406   MetaVarName<"<prefixes>">,
407   HelpText<"Verify diagnostic output using comment directives that start with"
408            " prefixes in the comma-separated sequence <prefixes>">;
409 def verify : Flag<["-"], "verify">,
410   HelpText<"Equivalent to -verify=expected">;
411 def verify_ignore_unexpected : Flag<["-"], "verify-ignore-unexpected">,
412   HelpText<"Ignore unexpected diagnostic messages">;
413 def verify_ignore_unexpected_EQ : CommaJoined<["-"], "verify-ignore-unexpected=">,
414   HelpText<"Ignore unexpected diagnostic messages">;
415 def Wno_rewrite_macros : Flag<["-"], "Wno-rewrite-macros">,
416   HelpText<"Silence ObjC rewriting warnings">;
417
418 //===----------------------------------------------------------------------===//
419 // Frontend Options
420 //===----------------------------------------------------------------------===//
421
422 // This isn't normally used, it is just here so we can parse a
423 // CompilerInvocation out of a driver-derived argument vector.
424 def cc1 : Flag<["-"], "cc1">;
425 def cc1as : Flag<["-"], "cc1as">;
426
427 def ast_merge : Separate<["-"], "ast-merge">,
428   MetaVarName<"<ast file>">,
429   HelpText<"Merge the given AST file into the translation unit being compiled.">;
430 def aux_triple : Separate<["-"], "aux-triple">,
431   HelpText<"Auxiliary target triple.">;
432 def code_completion_at : Separate<["-"], "code-completion-at">,
433   MetaVarName<"<file>:<line>:<column>">,
434   HelpText<"Dump code-completion information at a location">;
435 def remap_file : Separate<["-"], "remap-file">,
436   MetaVarName<"<from>;<to>">,
437   HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
438 def code_completion_at_EQ : Joined<["-"], "code-completion-at=">,
439   Alias<code_completion_at>;
440 def code_completion_macros : Flag<["-"], "code-completion-macros">,
441   HelpText<"Include macros in code-completion results">;
442 def code_completion_patterns : Flag<["-"], "code-completion-patterns">,
443   HelpText<"Include code patterns in code-completion results">;
444 def no_code_completion_globals : Flag<["-"], "no-code-completion-globals">,
445   HelpText<"Do not include global declarations in code-completion results.">;
446 def no_code_completion_ns_level_decls : Flag<["-"], "no-code-completion-ns-level-decls">,
447   HelpText<"Do not include declarations inside namespaces (incl. global namespace) in the code-completion results.">;
448 def code_completion_brief_comments : Flag<["-"], "code-completion-brief-comments">,
449   HelpText<"Include brief documentation comments in code-completion results.">;
450 def disable_free : Flag<["-"], "disable-free">,
451   HelpText<"Disable freeing of memory on exit">;
452 def discard_value_names : Flag<["-"], "discard-value-names">,
453   HelpText<"Discard value names in LLVM IR">;
454 def load : Separate<["-"], "load">, MetaVarName<"<dsopath>">,
455   HelpText<"Load the named plugin (dynamic shared object)">;
456 def plugin : Separate<["-"], "plugin">, MetaVarName<"<name>">,
457   HelpText<"Use the named plugin action instead of the default action (use \"help\" to list available options)">;
458 def plugin_arg : JoinedAndSeparate<["-"], "plugin-arg-">,
459     MetaVarName<"<name> <arg>">,
460     HelpText<"Pass <arg> to plugin <name>">;
461 def add_plugin : Separate<["-"], "add-plugin">, MetaVarName<"<name>">,
462   HelpText<"Use the named plugin action in addition to the default action">;
463 def ast_dump_filter : Separate<["-"], "ast-dump-filter">,
464   MetaVarName<"<dump_filter>">,
465   HelpText<"Use with -ast-dump or -ast-print to dump/print only AST declaration"
466            " nodes having a certain substring in a qualified name. Use"
467            " -ast-list to list all filterable declaration node names.">;
468 def fno_modules_global_index : Flag<["-"], "fno-modules-global-index">,
469   HelpText<"Do not automatically generate or update the global module index">;
470 def fno_modules_error_recovery : Flag<["-"], "fno-modules-error-recovery">,
471   HelpText<"Do not automatically import modules for error recovery">;
472 def fmodule_map_file_home_is_cwd : Flag<["-"], "fmodule-map-file-home-is-cwd">,
473   HelpText<"Use the current working directory as the home directory of "
474            "module maps specified by -fmodule-map-file=<FILE>">;
475 def fmodule_feature : Separate<["-"], "fmodule-feature">,
476   MetaVarName<"<feature>">,
477   HelpText<"Enable <feature> in module map requires declarations">;
478 def fmodules_embed_file_EQ : Joined<["-"], "fmodules-embed-file=">,
479   MetaVarName<"<file>">,
480   HelpText<"Embed the contents of the specified file into the module file "
481            "being compiled.">;
482 def fmodules_embed_all_files : Joined<["-"], "fmodules-embed-all-files">,
483   HelpText<"Embed the contents of all files read by this compilation into "
484            "the produced module file.">;
485 def fmodules_local_submodule_visibility :
486   Flag<["-"], "fmodules-local-submodule-visibility">,
487   HelpText<"Enforce name visibility rules across submodules of the same "
488            "top-level module.">;
489 def fmodules_codegen :
490   Flag<["-"], "fmodules-codegen">,
491   HelpText<"Generate code for uses of this module that assumes an explicit "
492            "object file will be built for the module">;
493 def fmodules_debuginfo :
494   Flag<["-"], "fmodules-debuginfo">,
495   HelpText<"Generate debug info for types in an object file built from this "
496            "module and do not generate them elsewhere">;
497 def fmodule_format_EQ : Joined<["-"], "fmodule-format=">,
498   HelpText<"Select the container format for clang modules and PCH. "
499            "Supported options are 'raw' and 'obj'.">;
500 def ftest_module_file_extension_EQ :
501   Joined<["-"], "ftest-module-file-extension=">,
502   HelpText<"introduce a module file extension for testing purposes. "
503            "The argument is parsed as blockname:major:minor:hashed:user info">;
504 def fconcepts_ts : Flag<["-"], "fconcepts-ts">,
505   HelpText<"Enable C++ Extensions for Concepts.">;
506
507 let Group = Action_Group in {
508
509 def Eonly : Flag<["-"], "Eonly">,
510   HelpText<"Just run preprocessor, no output (for timings)">;
511 def dump_raw_tokens : Flag<["-"], "dump-raw-tokens">,
512   HelpText<"Lex file in raw mode and dump raw tokens">;
513 def analyze : Flag<["-"], "analyze">,
514   HelpText<"Run static analysis engine">;
515 def dump_tokens : Flag<["-"], "dump-tokens">,
516   HelpText<"Run preprocessor, dump internal rep of tokens">;
517 def init_only : Flag<["-"], "init-only">,
518   HelpText<"Only execute frontend initialization">;
519 def fixit : Flag<["-"], "fixit">,
520   HelpText<"Apply fix-it advice to the input source">;
521 def fixit_EQ : Joined<["-"], "fixit=">,
522   HelpText<"Apply fix-it advice creating a file with the given suffix">;
523 def print_preamble : Flag<["-"], "print-preamble">,
524   HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
525            " precompiled headers.">;
526 def emit_html : Flag<["-"], "emit-html">,
527   HelpText<"Output input source as HTML">;
528 def ast_print : Flag<["-"], "ast-print">,
529   HelpText<"Build ASTs and then pretty-print them">;
530 def ast_list : Flag<["-"], "ast-list">,
531   HelpText<"Build ASTs and print the list of declaration node qualified names">;
532 def ast_dump : Flag<["-"], "ast-dump">,
533   HelpText<"Build ASTs and then debug dump them">;
534 def ast_dump_all : Flag<["-"], "ast-dump-all">,
535   HelpText<"Build ASTs and then debug dump them, forcing deserialization">;
536 def ast_dump_lookups : Flag<["-"], "ast-dump-lookups">,
537   HelpText<"Build ASTs and then debug dump their name lookup tables">;
538 def ast_view : Flag<["-"], "ast-view">,
539   HelpText<"Build ASTs and view them with GraphViz">;
540 def print_decl_contexts : Flag<["-"], "print-decl-contexts">,
541   HelpText<"Print DeclContexts and their Decls">;
542 def emit_module : Flag<["-"], "emit-module">,
543   HelpText<"Generate pre-compiled module file from a module map">;
544 def emit_module_interface : Flag<["-"], "emit-module-interface">,
545   HelpText<"Generate pre-compiled module file from a C++ module interface">;
546 def emit_pth : Flag<["-"], "emit-pth">,
547   HelpText<"Generate pre-tokenized header file">;
548 def emit_pch : Flag<["-"], "emit-pch">,
549   HelpText<"Generate pre-compiled header file">;
550 def emit_llvm_bc : Flag<["-"], "emit-llvm-bc">,
551   HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
552 def emit_llvm_only : Flag<["-"], "emit-llvm-only">,
553   HelpText<"Build ASTs and convert to LLVM, discarding output">;
554 def emit_codegen_only : Flag<["-"], "emit-codegen-only">,
555   HelpText<"Generate machine code, but discard output">;
556 def emit_obj : Flag<["-"], "emit-obj">,
557   HelpText<"Emit native object files">;
558 def rewrite_test : Flag<["-"], "rewrite-test">,
559   HelpText<"Rewriter playground">;
560 def rewrite_macros : Flag<["-"], "rewrite-macros">,
561   HelpText<"Expand macros without full preprocessing">;
562 def migrate : Flag<["-"], "migrate">,
563   HelpText<"Migrate source code">;
564 }
565
566 def emit_llvm_uselists : Flag<["-"], "emit-llvm-uselists">,
567   HelpText<"Preserve order of LLVM use-lists when serializing">;
568 def no_emit_llvm_uselists : Flag<["-"], "no-emit-llvm-uselists">,
569   HelpText<"Don't preserve order of LLVM use-lists when serializing">;
570
571 def mt_migrate_directory : Separate<["-"], "mt-migrate-directory">,
572   HelpText<"Directory for temporary files produced during ARC or ObjC migration">;
573 def arcmt_check : Flag<["-"], "arcmt-check">,
574   HelpText<"Check for ARC migration issues that need manual handling">;
575 def arcmt_modify : Flag<["-"], "arcmt-modify">,
576   HelpText<"Apply modifications to files to conform to ARC">;
577 def arcmt_migrate : Flag<["-"], "arcmt-migrate">,
578   HelpText<"Apply modifications and produces temporary files that conform to ARC">;
579
580 def opt_record_file : Separate<["-"], "opt-record-file">,
581   HelpText<"File name to use for YAML optimization record output">;
582
583 def print_stats : Flag<["-"], "print-stats">,
584   HelpText<"Print performance metrics and statistics">;
585 def stats_file : Joined<["-"], "stats-file=">,
586   HelpText<"Filename to write statistics to">;
587 def fdump_record_layouts : Flag<["-"], "fdump-record-layouts">,
588   HelpText<"Dump record layout information">;
589 def fdump_record_layouts_simple : Flag<["-"], "fdump-record-layouts-simple">,
590   HelpText<"Dump record layout information in a simple form used for testing">;
591 def fix_what_you_can : Flag<["-"], "fix-what-you-can">,
592   HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
593 def fix_only_warnings : Flag<["-"], "fix-only-warnings">,
594   HelpText<"Apply fix-it advice only for warnings, not errors">;
595 def fixit_recompile : Flag<["-"], "fixit-recompile">,
596   HelpText<"Apply fix-it changes and recompile">;
597 def fixit_to_temp : Flag<["-"], "fixit-to-temporary">,
598   HelpText<"Apply fix-it changes to temporary files">;
599
600 def foverride_record_layout_EQ : Joined<["-"], "foverride-record-layout=">,
601   HelpText<"Override record layouts with those in the given file">;
602 def find_pch_source_EQ : Joined<["-"], "find-pch-source=">,
603   HelpText<"When building a pch, try to find the input file in include "
604            "directories, as if it had been included by the argument passed "
605            "to this flag.">;
606 def fno_pch_timestamp : Flag<["-"], "fno-pch-timestamp">,
607   HelpText<"Disable inclusion of timestamp in precompiled headers">;
608   
609 def aligned_alloc_unavailable : Flag<["-"], "faligned-alloc-unavailable">,
610   HelpText<"Aligned allocation/deallocation functions are unavailable">;
611
612 //===----------------------------------------------------------------------===//
613 // Language Options
614 //===----------------------------------------------------------------------===//
615
616 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
617
618 def version : Flag<["-"], "version">,
619   HelpText<"Print the compiler version">;
620 def main_file_name : Separate<["-"], "main-file-name">,
621   HelpText<"Main file name to use for debug info">;
622
623 }
624
625 def fblocks_runtime_optional : Flag<["-"], "fblocks-runtime-optional">,
626   HelpText<"Weakly link in the blocks runtime">;
627 def fexternc_nounwind : Flag<["-"], "fexternc-nounwind">,
628   HelpText<"Assume all functions with C linkage do not unwind">;
629 def enable_split_dwarf : Flag<["-"], "enable-split-dwarf">,
630   HelpText<"Use split dwarf/Fission">;
631 def split_dwarf_file : Separate<["-"], "split-dwarf-file">,
632   HelpText<"File name to use for split dwarf debug info output">;
633 def fno_wchar : Flag<["-"], "fno-wchar">,
634   HelpText<"Disable C++ builtin type wchar_t">;
635 def fconstant_string_class : Separate<["-"], "fconstant-string-class">,
636   MetaVarName<"<class name>">,
637   HelpText<"Specify the class to use for constant Objective-C string objects.">;
638 def fobjc_arc_cxxlib_EQ : Joined<["-"], "fobjc-arc-cxxlib=">,
639   HelpText<"Objective-C++ Automatic Reference Counting standard library kind">, Values<"libc++,libstdc++,none">;
640 def fobjc_runtime_has_weak : Flag<["-"], "fobjc-runtime-has-weak">,
641   HelpText<"The target Objective-C runtime supports ARC weak operations">;
642 def fobjc_dispatch_method_EQ : Joined<["-"], "fobjc-dispatch-method=">,
643   HelpText<"Objective-C dispatch method to use">, Values<"legacy,non-legacy,mixed">;
644 def disable_objc_default_synthesize_properties : Flag<["-"], "disable-objc-default-synthesize-properties">,
645   HelpText<"disable the default synthesis of Objective-C properties">;
646 def fencode_extended_block_signature : Flag<["-"], "fencode-extended-block-signature">,
647   HelpText<"enable extended encoding of block type signature">;
648 def pic_level : Separate<["-"], "pic-level">,
649   HelpText<"Value for __PIC__">;
650 def pic_is_pie : Flag<["-"], "pic-is-pie">,
651   HelpText<"File is for a position independent executable">;
652 def fno_validate_pch : Flag<["-"], "fno-validate-pch">,
653   HelpText<"Disable validation of precompiled headers">;
654 def fallow_pch_with_errors : Flag<["-"], "fallow-pch-with-compiler-errors">,
655   HelpText<"Accept a PCH file that was created with compiler errors">;
656 def dump_deserialized_pch_decls : Flag<["-"], "dump-deserialized-decls">,
657   HelpText<"Dump declarations that are deserialized from PCH, for testing">;
658 def error_on_deserialized_pch_decl : Separate<["-"], "error-on-deserialized-decl">,
659   HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
660 def error_on_deserialized_pch_decl_EQ : Joined<["-"], "error-on-deserialized-decl=">,
661   Alias<error_on_deserialized_pch_decl>;
662 def static_define : Flag<["-"], "static-define">,
663   HelpText<"Should __STATIC__ be defined">;
664 def stack_protector : Separate<["-"], "stack-protector">,
665   HelpText<"Enable stack protectors">;
666 def stack_protector_buffer_size : Separate<["-"], "stack-protector-buffer-size">,
667   HelpText<"Lower bound for a buffer to be considered for stack protection">;
668 def fvisibility : Separate<["-"], "fvisibility">,
669   HelpText<"Default type and symbol visibility">;
670 def ftype_visibility : Separate<["-"], "ftype-visibility">,
671   HelpText<"Default type visibility">;
672 def ftemplate_depth : Separate<["-"], "ftemplate-depth">,
673   HelpText<"Maximum depth of recursive template instantiation">;
674 def foperator_arrow_depth : Separate<["-"], "foperator-arrow-depth">,
675   HelpText<"Maximum number of 'operator->'s to call for a member access">;
676 def fconstexpr_depth : Separate<["-"], "fconstexpr-depth">,
677   HelpText<"Maximum depth of recursive constexpr function calls">;
678 def fconstexpr_steps : Separate<["-"], "fconstexpr-steps">,
679   HelpText<"Maximum number of steps in constexpr function evaluation">;
680 def fbracket_depth : Separate<["-"], "fbracket-depth">,
681   HelpText<"Maximum nesting level for parentheses, brackets, and braces">;
682 def fconst_strings : Flag<["-"], "fconst-strings">,
683   HelpText<"Use a const qualified type for string literals in C and ObjC">;
684 def fno_const_strings : Flag<["-"], "fno-const-strings">,
685   HelpText<"Don't use a const qualified type for string literals in C and ObjC">;
686 def fno_bitfield_type_align : Flag<["-"], "fno-bitfield-type-align">,
687   HelpText<"Ignore bit-field types when aligning structures">;
688 def ffake_address_space_map : Flag<["-"], "ffake-address-space-map">,
689   HelpText<"Use a fake address space map; OpenCL testing purposes only">;
690 def faddress_space_map_mangling_EQ : Joined<["-"], "faddress-space-map-mangling=">, MetaVarName<"<yes|no|target>">,
691   HelpText<"Set the mode for address space map based mangling; OpenCL testing purposes only">;
692 def funknown_anytype : Flag<["-"], "funknown-anytype">,
693   HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">;
694 def fdebugger_support : Flag<["-"], "fdebugger-support">,
695   HelpText<"Enable special debugger support behavior">;
696 def fdebugger_cast_result_to_id : Flag<["-"], "fdebugger-cast-result-to-id">,
697   HelpText<"Enable casting unknown expression results to id">;
698 def fdebugger_objc_literal : Flag<["-"], "fdebugger-objc-literal">,
699   HelpText<"Enable special debugger support for Objective-C subscripting and literals">;
700 def fdeprecated_macro : Flag<["-"], "fdeprecated-macro">,
701   HelpText<"Defines the __DEPRECATED macro">;
702 def fno_deprecated_macro : Flag<["-"], "fno-deprecated-macro">,
703   HelpText<"Undefines the __DEPRECATED macro">;
704 def fobjc_subscripting_legacy_runtime : Flag<["-"], "fobjc-subscripting-legacy-runtime">,
705   HelpText<"Allow Objective-C array and dictionary subscripting in legacy runtime">;
706 def vtordisp_mode_EQ : Joined<["-"], "vtordisp-mode=">,
707   HelpText<"Control vtordisp placement on win32 targets">;
708 def fno_rtti_data : Flag<["-"], "fno-rtti-data">,
709   HelpText<"Control emission of RTTI data">;
710 def fnative_half_type: Flag<["-"], "fnative-half-type">,
711   HelpText<"Use the native half type for __fp16 instead of promoting to float">;
712 def fnative_half_arguments_and_returns : Flag<["-"], "fnative-half-arguments-and-returns">,
713   HelpText<"Use the native __fp16 type for arguments and returns (and skip ABI-specific lowering)">;
714 def fallow_half_arguments_and_returns : Flag<["-"], "fallow-half-arguments-and-returns">,
715   HelpText<"Allow function arguments and returns of type half">;
716 def fdefault_calling_conv_EQ : Joined<["-"], "fdefault-calling-conv=">,
717   HelpText<"Set default calling convention">, Values<"cdecl,fastcall,stdcall,vectorcall,regcall">;
718 def finclude_default_header : Flag<["-"], "finclude-default-header">,
719   HelpText<"Include the default header file for OpenCL">;
720 def fpreserve_vec3_type : Flag<["-"], "fpreserve-vec3-type">,
721   HelpText<"Preserve 3-component vector type">;
722 def fwchar_type_EQ : Joined<["-"], "fwchar-type=">,
723   HelpText<"Select underlying type for wchar_t">, Values<"char,short,int">;
724 def fsigned_wchar : Flag<["-"], "fsigned-wchar">,
725   HelpText<"Use a signed type for wchar_t">;
726 def fno_signed_wchar : Flag<["-"], "fno-signed-wchar">,
727   HelpText<"Use an unsigned type for wchar_t">;
728
729 // FIXME: Remove these entirely once functionality/tests have been excised.
730 def fobjc_gc_only : Flag<["-"], "fobjc-gc-only">, Group<f_Group>,
731   HelpText<"Use GC exclusively for Objective-C related memory management">;
732 def fobjc_gc : Flag<["-"], "fobjc-gc">, Group<f_Group>,
733   HelpText<"Enable Objective-C garbage collection">;
734
735 //===----------------------------------------------------------------------===//
736 // Header Search Options
737 //===----------------------------------------------------------------------===//
738
739 def nostdsysteminc : Flag<["-"], "nostdsysteminc">,
740   HelpText<"Disable standard system #include directories">;
741 def fdisable_module_hash : Flag<["-"], "fdisable-module-hash">,
742   HelpText<"Disable the module hash">;
743 def fmodules_hash_content : Flag<["-"], "fmodules-hash-content">,
744   HelpText<"Enable hashing the content of a module file">;
745 def c_isystem : JoinedOrSeparate<["-"], "c-isystem">, MetaVarName<"<directory>">,
746   HelpText<"Add directory to the C SYSTEM include search path">;
747 def objc_isystem : JoinedOrSeparate<["-"], "objc-isystem">,
748   MetaVarName<"<directory>">,
749   HelpText<"Add directory to the ObjC SYSTEM include search path">;
750 def objcxx_isystem : JoinedOrSeparate<["-"], "objcxx-isystem">,
751   MetaVarName<"<directory>">,
752   HelpText<"Add directory to the ObjC++ SYSTEM include search path">;
753 def internal_isystem : JoinedOrSeparate<["-"], "internal-isystem">,
754   MetaVarName<"<directory>">,
755   HelpText<"Add directory to the internal system include search path; these "
756            "are assumed to not be user-provided and are used to model system "
757            "and standard headers' paths.">;
758 def internal_externc_isystem : JoinedOrSeparate<["-"], "internal-externc-isystem">,
759   MetaVarName<"<directory>">,
760   HelpText<"Add directory to the internal system include search path with "
761            "implicit extern \"C\" semantics; these are assumed to not be "
762            "user-provided and are used to model system and standard headers' "
763            "paths.">;
764
765 //===----------------------------------------------------------------------===//
766 // Preprocessor Options
767 //===----------------------------------------------------------------------===//
768
769 def include_pth : Separate<["-"], "include-pth">, MetaVarName<"<file>">,
770   HelpText<"Include file before parsing">;
771 def chain_include : Separate<["-"], "chain-include">, MetaVarName<"<file>">,
772   HelpText<"Include and chain a header file after turning it into PCH">;
773 def preamble_bytes_EQ : Joined<["-"], "preamble-bytes=">,
774   HelpText<"Assume that the precompiled header is a precompiled preamble "
775            "covering the first N bytes of the main file">;
776 def token_cache : Separate<["-"], "token-cache">, MetaVarName<"<path>">,
777   HelpText<"Use specified token cache file">;
778 def detailed_preprocessing_record : Flag<["-"], "detailed-preprocessing-record">,
779   HelpText<"include a detailed record of preprocessing actions">;
780
781 //===----------------------------------------------------------------------===//
782 // OpenCL Options
783 //===----------------------------------------------------------------------===//
784
785 def cl_ext_EQ : CommaJoined<["-"], "cl-ext=">,
786   HelpText<"OpenCL only. Enable or disable OpenCL extensions. The argument is a comma-separated sequence of one or more extension names, each prefixed by '+' or '-'.">;
787
788 //===----------------------------------------------------------------------===//
789 // CUDA Options
790 //===----------------------------------------------------------------------===//
791
792 def fcuda_is_device : Flag<["-"], "fcuda-is-device">,
793   HelpText<"Generate code for CUDA device">;
794 def fcuda_include_gpubinary : Separate<["-"], "fcuda-include-gpubinary">,
795   HelpText<"Incorporate CUDA device-side binary into host object file.">;
796 def fcuda_allow_variadic_functions : Flag<["-"], "fcuda-allow-variadic-functions">,
797   HelpText<"Allow variadic functions in CUDA device code.">;
798 def fno_cuda_host_device_constexpr : Flag<["-"], "fno-cuda-host-device-constexpr">,
799   HelpText<"Don't treat unattributed constexpr functions as __host__ __device__.">;
800
801 //===----------------------------------------------------------------------===//
802 // OpenMP Options
803 //===----------------------------------------------------------------------===//
804
805 def fopenmp_is_device : Flag<["-"], "fopenmp-is-device">,
806   HelpText<"Generate code only for an OpenMP target device.">;
807 def fopenmp_host_ir_file_path : Separate<["-"], "fopenmp-host-ir-file-path">,
808   HelpText<"Path to the IR file produced by the frontend for the host.">;
809   
810 } // let Flags = [CC1Option]
811
812
813 //===----------------------------------------------------------------------===//
814 // cc1as-only Options
815 //===----------------------------------------------------------------------===//
816
817 let Flags = [CC1AsOption, NoDriverOption] in {
818
819 // Language Options
820 def n : Flag<["-"], "n">,
821   HelpText<"Don't automatically start assembly file with a text section">;
822
823 // Frontend Options
824 def filetype : Separate<["-"], "filetype">,
825     HelpText<"Specify the output file type ('asm', 'null', or 'obj')">;
826
827 // Transliterate Options
828 def output_asm_variant : Separate<["-"], "output-asm-variant">,
829     HelpText<"Select the asm variant index to use for output">;
830 def show_encoding : Flag<["-"], "show-encoding">,
831     HelpText<"Show instruction encoding information in transliterate mode">;
832 def show_inst : Flag<["-"], "show-inst">,
833     HelpText<"Show internal instruction representation in transliterate mode">;
834
835 // Assemble Options
836 def dwarf_debug_producer : Separate<["-"], "dwarf-debug-producer">,
837   HelpText<"The string to embed in the Dwarf debug AT_producer record.">;
838
839 def defsym : Separate<["-"], "defsym">,
840   HelpText<"Define a value for a symbol">;
841 } // let Flags = [CC1AsOption]