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