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