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