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