blob: 9213d217ef7c2973dc3d44a970b9a28985ed0f51 [file] [log] [blame]
Daniel Dunbar8adfcff2009-11-19 07:19:04 +00001//===--- 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
James Molloybfd7a522012-05-01 14:57:16 +000014let Flags = [CC1Option] in {
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000015
Daniel Dunbar33a33d82009-11-24 00:54:16 +000016//===----------------------------------------------------------------------===//
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000017// Target Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +000018//===----------------------------------------------------------------------===//
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000019
Charles Davis98b7c5c2010-06-11 01:06:47 +000020def cxx_abi : Separate<"-cxx-abi">,
21 HelpText<"Target a particular C++ ABI type">;
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000022def target_abi : Separate<"-target-abi">,
23 HelpText<"Target a particular ABI type">;
Daniel Dunbar38b48af2009-12-18 06:30:12 +000024def target_cpu : Separate<"-target-cpu">,
25 HelpText<"Target a specific cpu type">;
Daniel Dunbar31db76c2009-11-20 01:46:44 +000026def target_feature : Separate<"-target-feature">,
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000027 HelpText<"Target specific attributes">;
Daniel Dunbar39065a52010-08-11 23:07:42 +000028def target_linker_version : Separate<"-target-linker-version">,
29 HelpText<"Target linker version">;
Daniel Dunbar31db76c2009-11-20 01:46:44 +000030def triple : Separate<"-triple">,
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000031 HelpText<"Specify target triple (e.g. i686-apple-darwin9)">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +000032def triple_EQ : Joined<"-triple=">, Alias<triple>;
Daniel Dunbar50a44872009-11-20 17:23:30 +000033
Daniel Dunbar33a33d82009-11-24 00:54:16 +000034//===----------------------------------------------------------------------===//
Daniel Dunbare2814d82009-11-22 22:08:20 +000035// Analyzer Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +000036//===----------------------------------------------------------------------===//
Daniel Dunbare2814d82009-11-22 22:08:20 +000037
Ted Kremenek9b823e82010-08-03 00:09:51 +000038def analysis_UnoptimizedCFG : Flag<"-unoptimized-cfg">,
Ted Kremenekc9c6b902010-08-20 05:53:47 +000039 HelpText<"Generate unoptimized CFGs for all analyses">;
Marcin Swiderski9121ba22010-09-30 07:41:24 +000040def analysis_CFGAddImplicitDtors : Flag<"-cfg-add-implicit-dtors">,
41 HelpText<"Add C++ implicit destructors to CFGs for all analyses">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000042
43def analyzer_store : Separate<"-analyzer-store">,
44 HelpText<"Source Code Analysis - Abstract Memory Store Models">;
45def analyzer_store_EQ : Joined<"-analyzer-store=">, Alias<analyzer_store>;
46
47def analyzer_constraints : Separate<"-analyzer-constraints">,
48 HelpText<"Source Code Analysis - Symbolic Constraint Engines">;
49def analyzer_constraints_EQ : Joined<"-analyzer-constraints=">,
50 Alias<analyzer_constraints>;
51
52def analyzer_output : Separate<"-analyzer-output">,
53 HelpText<"Source Code Analysis - Output Options">;
54def analyzer_output_EQ : Joined<"-analyzer-output=">,
55 Alias<analyzer_output>;
56
Anna Zaksd3095282011-09-30 02:03:00 +000057def analyzer_purge : Separate<"-analyzer-purge">,
58 HelpText<"Source Code Analysis - Dead Symbol Removal Frequency">;
59def analyzer_purge_EQ : Joined<"-analyzer-purge=">, Alias<analyzer_purge>;
60
Daniel Dunbare2814d82009-11-22 22:08:20 +000061def analyzer_opt_analyze_headers : Flag<"-analyzer-opt-analyze-headers">,
62 HelpText<"Force the static analyzer to analyze functions defined in header files">;
Ted Kremenekfc576512009-12-07 22:06:12 +000063def analyzer_opt_analyze_nested_blocks : Flag<"-analyzer-opt-analyze-nested-blocks">,
Michael J. Spencer20249a12010-10-21 03:16:25 +000064 HelpText<"Analyze the definitions of blocks in addition to functions">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000065def analyzer_display_progress : Flag<"-analyzer-display-progress">,
66 HelpText<"Emit verbose output about the analyzer's progress">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000067def analyze_function : Separate<"-analyze-function">,
68 HelpText<"Run analysis on specific function">;
69def analyze_function_EQ : Joined<"-analyze-function=">, Alias<analyze_function>;
70def analyzer_eagerly_assume : Flag<"-analyzer-eagerly-assume">,
71 HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">;
Ted Kremenekd767d812011-02-09 01:27:33 +000072def analyzer_no_eagerly_trim_egraph : Flag<"-analyzer-no-eagerly-trim-egraph">,
73 HelpText<"Don't eagerly remove uninteresting ExplodedNodes from the ExplodedGraph">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000074def trim_egraph : Flag<"-trim-egraph">,
75 HelpText<"Only show error-related paths in the analysis graph">;
76def analyzer_viz_egraph_graphviz : Flag<"-analyzer-viz-egraph-graphviz">,
77 HelpText<"Display exploded graph using GraphViz">;
78def analyzer_viz_egraph_ubigraph : Flag<"-analyzer-viz-egraph-ubigraph">,
79 HelpText<"Display exploded graph using Ubigraph">;
Anna Zaks66253352012-03-08 23:16:35 +000080
Anna Zaks8235f9c2012-03-02 19:05:03 +000081def analyzer_inline_max_stack_depth : Separate<"-analyzer-inline-max-stack-depth">,
82 HelpText<"Bound on stack depth while inlining (4 by default)">;
Anna Zaks66253352012-03-08 23:16:35 +000083def analyzer_inline_max_stack_depth_EQ : Joined<"-analyzer-inline-max-stack-depth=">,
84 Alias<analyzer_inline_max_stack_depth>;
85
Anna Zaks8235f9c2012-03-02 19:05:03 +000086def analyzer_inline_max_function_size : Separate<"-analyzer-inline-max-function-size">,
Anna Zaks8fbb4e62012-03-05 23:54:55 +000087 HelpText<"Bound on the number of basic blocks in an inlined function (200 by default)">;
Anna Zaks66253352012-03-08 23:16:35 +000088def analyzer_inline_max_function_size_EQ : Joined<"-analyzer-inline-max-function-size=">,
89 Alias<analyzer_inline_max_function_size>;
90
91def analyzer_ipa : Separate<"-analyzer-ipa">,
92 HelpText<"Specify the inter-procedural analysis mode">;
93def analyzer_ipa_EQ : Joined<"-analyzer-ipa=">, Alias<analyzer_ipa>;
94
95def analyzer_inlining_mode : Separate<"-analyzer-inlining-mode">,
96 HelpText<"Specify the function selection heuristic used during inlining">;
97def analyzer_inlining_mode_EQ : Joined<"-analyzer-inlining-mode=">, Alias<analyzer_inlining_mode>;
Anna Zaks5903a372012-03-27 20:02:53 +000098
Anna Zaksb47dbcb2012-03-28 19:59:16 +000099def analyzer_disable_retry_exhausted : Flag<"-analyzer-disable-retry-exhausted">,
100 HelpText<"Do not re-analyze paths leading to exhausted nodes with a different strategy (may decrease code coverage)">;
Anna Zaks66253352012-03-08 23:16:35 +0000101
Zhongxing Xuc09289d2010-04-13 06:44:31 +0000102def analyzer_max_nodes : Separate<"-analyzer-max-nodes">,
Tom Carecf9ce132010-09-29 23:48:13 +0000103 HelpText<"The maximum number of nodes the analyzer can generate (150000 default, 0 = no limit)">;
Zhongxing Xu6362b892010-05-18 00:28:37 +0000104def analyzer_max_loop : Separate<"-analyzer-max-loop">,
105 HelpText<"The maximum number of times the analyzer will go through a loop">;
Anna Zaks81fb1692012-02-27 21:33:16 +0000106def analyzer_stats : Flag<"-analyzer-stats">,
107 HelpText<"Print internal analyzer statistics.">;
Daniel Dunbare2814d82009-11-22 22:08:20 +0000108
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +0000109def analyzer_checker : Separate<"-analyzer-checker">,
110 HelpText<"Choose analyzer checkers to enable">;
111def analyzer_checker_EQ : Joined<"-analyzer-checker=">,
112 Alias<analyzer_checker>;
113
114def analyzer_disable_checker : Separate<"-analyzer-disable-checker">,
115 HelpText<"Choose analyzer checkers to disable">;
116def analyzer_disable_checker_EQ : Joined<"-analyzer-disable-checker=">,
117 Alias<analyzer_disable_checker>;
118
Argyrios Kyrtzidis116f3642011-02-25 00:09:51 +0000119def analyzer_checker_help : Flag<"-analyzer-checker-help">,
120 HelpText<"Display the list of analyzer checkers that are available">;
121
Ted Kremenek7b73e082012-08-29 05:55:00 +0000122def analyzer_config : Separate<"-analyzer-config">,
123 HelpText<"Choose analyzer checkers to enable">;
124def analyzer_config_EQ : Joined<"-analyzer-config=">,
125 Alias<analyzer_config>;
126
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000127//===----------------------------------------------------------------------===//
Fariborz Jahanianb5c6bab2012-01-25 00:20:29 +0000128// Migrator Options
129//===----------------------------------------------------------------------===//
130def migrator_no_nsalloc_error : Flag<"-no-ns-alloc-error">,
131 HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">;
132
Fariborz Jahanian26f0e4e2012-01-26 00:08:04 +0000133def migrator_no_finalize_removal : Flag<"-no-finalize-removal">,
134 HelpText<"Do not remove finalize method in gc mode">;
135
Fariborz Jahanianb5c6bab2012-01-25 00:20:29 +0000136//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000137// CodeGen Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000138//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000139
140def disable_llvm_optzns : Flag<"-disable-llvm-optzns">,
141 HelpText<"Don't run LLVM optimization passes">;
John McCall824e19e2010-02-12 23:47:27 +0000142def disable_llvm_verifier : Flag<"-disable-llvm-verifier">,
143 HelpText<"Don't run the LLVM IR verifier pass">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000144def disable_red_zone : Flag<"-disable-red-zone">,
145 HelpText<"Do not emit code that uses the red zone.">;
Nick Lewycky7c4fd912011-10-21 02:32:14 +0000146def fdebug_compilation_dir : Separate<"-fdebug-compilation-dir">,
147 HelpText<"The compilation directory to embed in the debug info.">;
Daniel Dunbarf2d8b9f2009-12-18 02:43:17 +0000148def dwarf_debug_flags : Separate<"-dwarf-debug-flags">,
149 HelpText<"The string to embed in the Dwarf debug flags record.">;
John McCall32096692011-03-18 02:56:14 +0000150def fforbid_guard_variables : Flag<"-fforbid-guard-variables">,
151 HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
Chad Rosier005af272012-05-16 21:19:55 +0000152def no_implicit_float : Flag<"-no-implicit-float">,
153 HelpText<"Don't generate implicit floating point instructions">;
Anders Carlsson824d7ea2010-02-11 08:02:13 +0000154def fdump_vtable_layouts : Flag<"-fdump-vtable-layouts">,
155 HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
Nick Lewyckye8ba8d72011-04-21 23:44:07 +0000156def femit_coverage_notes : Flag<"-femit-coverage-notes">,
157 HelpText<"Emit a gcov coverage notes file when compiling.">;
158def femit_coverage_data: Flag<"-femit-coverage-data">,
159 HelpText<"Instrument the program to emit gcov coverage data when run.">;
Nick Lewycky3dc05412011-05-05 00:08:20 +0000160def coverage_file : Separate<"-coverage-file">,
161 HelpText<"Emit coverage data to this filename. The extension will be replaced.">;
162def coverage_file_EQ : Joined<"-coverage-file=">, Alias<coverage_file>;
Daniel Dunbare26bdb92011-06-21 18:54:46 +0000163def fuse_register_sized_bitfield_access: Flag<"-fuse-register-sized-bitfield-access">,
164 HelpText<"Use register sized accesses to bit-fields, when possible.">;
Dan Gohman4d5625e2010-10-14 22:36:56 +0000165def relaxed_aliasing : Flag<"-relaxed-aliasing">,
Devang Patelbe570122010-10-15 18:23:36 +0000166 HelpText<"Turn off Type Based Alias Analysis">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000167def masm_verbose : Flag<"-masm-verbose">,
168 HelpText<"Generate verbose assembly output">;
169def mcode_model : Separate<"-mcode-model">,
170 HelpText<"The code model to use">;
171def mdebug_pass : Separate<"-mdebug-pass">,
172 HelpText<"Enable additional debug output">;
173def mdisable_fp_elim : Flag<"-mdisable-fp-elim">,
174 HelpText<"Disable frame pointer elimination optimization">;
Nick Lewycky1db772b2012-01-23 08:29:12 +0000175def mdisable_tail_calls : Flag<"-mdisable-tail-calls">,
176 HelpText<"Disable tail call optimization, keeping the call stack accurate">;
Daniel Dunbar001f6282011-12-09 23:41:18 +0000177def menable_no_infinities : Flag<"-menable-no-infs">,
178 HelpText<"Allow optimization to assume there are no infinities.">;
179def menable_no_nans : Flag<"-menable-no-nans">,
180 HelpText<"Allow optimization to assume there are no NaNs.">;
Chandler Carruthabf07a72012-01-02 14:19:45 +0000181def menable_unsafe_fp_math : Flag<"-menable-unsafe-fp-math">,
182 HelpText<"Allow unsafe floating-point math optimizations which may decrease "
183 "precision">;
Daniel Dunbar87667aa2009-12-08 19:49:51 +0000184def mfloat_abi : Separate<"-mfloat-abi">,
Daniel Dunbar3b315262009-11-30 08:42:00 +0000185 HelpText<"The float ABI to use">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000186def mlimit_float_precision : Separate<"-mlimit-float-precision">,
187 HelpText<"Limit float precision to the given value">;
Nick Lewyckyc3b90142011-06-21 00:14:18 +0000188def mno_exec_stack : Flag<"-mnoexecstack">,
189 HelpText<"Mark the file as not needing an executable stack">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000190def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">,
191 HelpText<"Do not put zero initialized data in the BSS">;
Daniel Dunbar3c66d302011-03-22 16:48:17 +0000192def backend_option : Separate<"-backend-option">,
193 HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
Daniel Dunbar17d3fea2011-02-09 17:54:19 +0000194def mregparm : Separate<"-mregparm">,
195 HelpText<"Limit the number of registers available for integer arguments">;
Daniel Dunbar96932322011-03-28 22:49:28 +0000196def msave_temp_labels : Flag<"-msave-temp-labels">,
197 HelpText<"(integrated-as) Save temporary labels">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000198def mrelocation_model : Separate<"-mrelocation-model">,
199 HelpText<"The relocation model to use">;
200def munwind_tables : Flag<"-munwind-tables">,
201 HelpText<"Generate unwinding tables for all functions">;
Rafael Espindola8af669f2012-06-19 01:26:10 +0000202def fuse_init_array : Flag<"-fuse-init-array">,
203 HelpText<"Use .init_array instead of .ctors">;
John McCalld46f9852010-02-19 01:32:20 +0000204def mconstructor_aliases : Flag<"-mconstructor-aliases">,
205 HelpText<"Emit complete constructors and destructors as aliases when possible">;
Peter Collingbourne22a7dfe2011-10-30 17:30:44 +0000206def mlink_bitcode_file : Separate<"-mlink-bitcode-file">,
207 HelpText<"Link the given bitcode file before performing optimizations.">;
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000208
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000209//===----------------------------------------------------------------------===//
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000210// Dependency Output Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000211//===----------------------------------------------------------------------===//
212
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000213def sys_header_deps : Flag<"-sys-header-deps">,
214 HelpText<"Include system headers in dependency output">;
Daniel Dunbarb34d69b2011-02-02 21:11:31 +0000215def header_include_file : Separate<"-header-include-file">,
216 HelpText<"Filename (or -) to write header include output to">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000217
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000218//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000219// Diagnostic Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000220//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000221
222def dump_build_information : Separate<"-dump-build-information">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000223 MetaVarName<"<filename>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000224 HelpText<"output a dump of some build information to a file">;
Daniel Dunbar08c66952011-04-07 18:11:14 +0000225def diagnostic_log_file : Separate<"-diagnostic-log-file">,
226 HelpText<"Filename (or -) to log diagnostics to">;
Ted Kremenek36f6e302011-11-11 00:07:43 +0000227def diagnostic_serialized_file : Separate<"-serialize-diagnostic-file">,
Ted Kremenek78002122011-10-29 00:12:39 +0000228 MetaVarName<"<filename>">,
229 HelpText<"File for serializing diagnostics in a binary format">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000230
Douglas Gregorc9471b02011-05-21 17:07:29 +0000231def fdiagnostics_format : Separate<"-fdiagnostics-format">,
232 HelpText<"Change diagnostic formatting to match IDE and command line tools">;
Chris Lattner6fbe8392010-05-04 21:55:25 +0000233def fdiagnostics_show_category : Separate<"-fdiagnostics-show-category">,
234 HelpText<"Print diagnostic category">;
Chris Lattner124fca52010-01-09 21:54:33 +0000235def ftabstop : Separate<"-ftabstop">, MetaVarName<"<N>">,
236 HelpText<"Set the tab stop distance.">;
Chris Lattnerc1002142010-04-07 20:37:06 +0000237def ferror_limit : Separate<"-ferror-limit">, MetaVarName<"<N>">,
238 HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
Douglas Gregor6c1cb992010-05-04 17:13:42 +0000239def fmacro_backtrace_limit : Separate<"-fmacro-backtrace-limit">, MetaVarName<"<N>">,
Chandler Carruthb29a6102011-07-15 00:04:38 +0000240 HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
Douglas Gregor575cf372010-04-20 07:18:24 +0000241def ftemplate_backtrace_limit : Separate<"-ftemplate-backtrace-limit">, MetaVarName<"<N>">,
242 HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
Richard Smith08d6e032011-12-16 19:06:07 +0000243def fconstexpr_backtrace_limit : Separate<"-fconstexpr-backtrace-limit">, MetaVarName<"<N>">,
244 HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000245def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000246 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000247def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">,
248 HelpText<"Silence ObjC rewriting warnings">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000249
250//===----------------------------------------------------------------------===//
251// Frontend Options
252//===----------------------------------------------------------------------===//
253
Daniel Dunbar8ff5b282009-12-11 23:00:49 +0000254// This isn't normally used, it is just here so we can parse a
255// CompilerInvocation out of a driver-derived argument vector.
256def cc1 : Flag<"-cc1">;
257
Douglas Gregor9bed8792010-02-09 19:21:46 +0000258def ast_merge : Separate<"-ast-merge">,
259 MetaVarName<"<ast file>">,
260 HelpText<"Merge the given AST file into the translation unit being compiled.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000261def code_completion_at : Separate<"-code-completion-at">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000262 MetaVarName<"<file>:<line>:<column>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000263 HelpText<"Dump code-completion information at a location">;
Daniel Dunbare14b5f52009-12-03 05:11:16 +0000264def remap_file : Separate<"-remap-file">,
265 MetaVarName<"<from>;<to>">,
266 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +0000267def code_completion_at_EQ : Joined<"-code-completion-at=">,
268 Alias<code_completion_at>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000269def code_completion_macros : Flag<"-code-completion-macros">,
270 HelpText<"Include macros in code-completion results">;
Douglas Gregord8e8a582010-05-25 21:41:55 +0000271def code_completion_patterns : Flag<"-code-completion-patterns">,
272 HelpText<"Include code patterns in code-completion results">;
Douglas Gregor8071e422010-08-15 06:18:01 +0000273def no_code_completion_globals : Flag<"-no-code-completion-globals">,
274 HelpText<"Do not include global declarations in code-completion results.">;
Dmitri Gribenkod99ef532012-07-02 17:35:10 +0000275def code_completion_brief_comments : Flag<"-code-completion-brief-comments">,
276 HelpText<"Include brief documentation comments in code-completion results.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000277def disable_free : Flag<"-disable-free">,
278 HelpText<"Disable freeing of memory on exit">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000279def load : Separate<"-load">, MetaVarName<"<dsopath>">,
Daniel Dunbarefba2272009-12-03 05:11:05 +0000280 HelpText<"Load the named plugin (dynamic shared object)">;
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000281def plugin : Separate<"-plugin">, MetaVarName<"<name>">,
Nico Weber5aa74af2011-01-25 20:34:14 +0000282 HelpText<"Use the named plugin action instead of the default action (use \"help\" to list available options)">;
Michael J. Spencer20249a12010-10-21 03:16:25 +0000283def plugin_arg : JoinedAndSeparate<"-plugin-arg-">,
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000284 MetaVarName<"<name> <arg>">,
285 HelpText<"Pass <arg> to plugin <name>">;
Nico Weber5aa74af2011-01-25 20:34:14 +0000286def add_plugin : Separate<"-add-plugin">, MetaVarName<"<name>">,
287 HelpText<"Use the named plugin action in addition to the default action">;
Daniel Dunbar8b9adfe2009-12-15 00:06:45 +0000288def resource_dir : Separate<"-resource-dir">,
289 HelpText<"The directory which holds the compiler resource files">;
Daniel Dunbar9b5e9ae2009-12-03 07:01:58 +0000290def version : Flag<"-version">,
291 HelpText<"Print the compiler version">;
Alexander Kornienkoe34a0522012-07-26 16:01:23 +0000292def ast_dump_filter : Separate<"-ast-dump-filter">,
293 MetaVarName<"<dump_filter>">,
294 HelpText<"Use with -ast-dump or -ast-print to dump/print only AST declaration"
Alexander Kornienko171af642012-07-31 09:37:40 +0000295 " nodes having a certain substring in a qualified name. Use"
296 " -ast-list to list all filterable declaration node names.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000297
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000298let Group = Action_Group in {
299
300def Eonly : Flag<"-Eonly">,
301 HelpText<"Just run preprocessor, no output (for timings)">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000302def dump_raw_tokens : Flag<"-dump-raw-tokens">,
303 HelpText<"Lex file in raw mode and dump raw tokens">;
304def analyze : Flag<"-analyze">,
305 HelpText<"Run static analysis engine">;
306def dump_tokens : Flag<"-dump-tokens">,
307 HelpText<"Run preprocessor, dump internal rep of tokens">;
Daniel Dunbar27585952010-03-19 19:44:04 +0000308def init_only : Flag<"-init-only">,
309 HelpText<"Only execute frontend initialization">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000310def fixit : Flag<"-fixit">,
311 HelpText<"Apply fix-it advice to the input source">;
Nick Lewyckyba5f6ec2010-04-24 01:30:46 +0000312def fixit_EQ : Joined<"-fixit=">,
313 HelpText<"Apply fix-it advice creating a file with the given suffix">;
Douglas Gregorf033f1d2010-07-20 20:18:03 +0000314def print_preamble : Flag<"-print-preamble">,
315 HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
316 " precompiled headers.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000317def emit_html : Flag<"-emit-html">,
318 HelpText<"Output input source as HTML">;
319def ast_print : Flag<"-ast-print">,
320 HelpText<"Build ASTs and then pretty-print them">;
Alexander Kornienko171af642012-07-31 09:37:40 +0000321def ast_list : Flag<"-ast-list">,
322 HelpText<"Build ASTs and print the list of declaration node qualified names">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000323def ast_dump : Flag<"-ast-dump">,
324 HelpText<"Build ASTs and then debug dump them">;
John McCallf3514242010-11-24 11:21:45 +0000325def ast_dump_xml : Flag<"-ast-dump-xml">,
326 HelpText<"Build ASTs and then debug dump them in a verbose XML format">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000327def ast_view : Flag<"-ast-view">,
328 HelpText<"Build ASTs and view them with GraphViz">;
329def print_decl_contexts : Flag<"-print-decl-contexts">,
330 HelpText<"Print DeclContexts and their Decls">;
Douglas Gregor467dc882011-08-25 22:30:56 +0000331def emit_module : Flag<"-emit-module">,
Douglas Gregor66490142011-11-29 22:42:06 +0000332 HelpText<"Generate pre-compiled module file from a module map">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000333def emit_pth : Flag<"-emit-pth">,
334 HelpText<"Generate pre-tokenized header file">;
335def emit_pch : Flag<"-emit-pch">,
336 HelpText<"Generate pre-compiled header file">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000337def emit_llvm_bc : Flag<"-emit-llvm-bc">,
338 HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
339def emit_llvm_only : Flag<"-emit-llvm-only">,
340 HelpText<"Build ASTs and convert to LLVM, discarding output">;
Daniel Dunbar32148ce2010-05-25 18:41:01 +0000341def emit_codegen_only : Flag<"-emit-codegen-only">,
342 HelpText<"Generate machine code, but discard output">;
Daniel Dunbarda1573f2010-02-03 01:18:43 +0000343def emit_obj : Flag<"-emit-obj">,
344 HelpText<"Emit native object files">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000345def rewrite_test : Flag<"-rewrite-test">,
346 HelpText<"Rewriter playground">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000347def rewrite_macros : Flag<"-rewrite-macros">,
348 HelpText<"Expand macros without full preprocessing">;
Ted Kremenek30660a82012-03-06 20:06:33 +0000349def migrate : Flag<"-migrate">,
350 HelpText<"Migrate source code">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000351}
352
Ted Kremenek30660a82012-03-06 20:06:33 +0000353def mt_migrate_directory : Separate<"-mt-migrate-directory">,
354 HelpText<"Directory for temporary files produced during ARC or ObjC migration">;
John McCallf85e1932011-06-15 23:02:42 +0000355def arcmt_check : Flag<"-arcmt-check">,
356 HelpText<"Check for ARC migration issues that need manual handling">;
357def arcmt_modify : Flag<"-arcmt-modify">,
358 HelpText<"Apply modifications to files to conform to ARC">;
Argyrios Kyrtzidis69325d52011-07-09 20:00:58 +0000359def arcmt_migrate : Flag<"-arcmt-migrate">,
360 HelpText<"Apply modifications and produces temporary files that conform to ARC">;
Argyrios Kyrtzidis389db162010-11-03 22:45:23 +0000361
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000362def relocatable_pch : Flag<"-relocatable-pch">,
363 HelpText<"Whether to build a relocatable precompiled header">;
364def print_stats : Flag<"-print-stats">,
365 HelpText<"Print performance metrics and statistics">;
Anders Carlsson46116ce2010-04-10 19:09:13 +0000366def fdump_record_layouts : Flag<"-fdump-record-layouts">,
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000367 HelpText<"Dump record layout information">;
Douglas Gregor453dbcb2012-01-26 07:55:45 +0000368def fdump_record_layouts_simple : Flag<"-fdump-record-layouts-simple">,
369 HelpText<"Dump record layout information in a simple form used for testing">;
Nick Lewycky1450f262010-08-13 17:31:00 +0000370def fix_what_you_can : Flag<"-fix-what-you-can">,
371 HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
Argyrios Kyrtzidis61d679a2012-01-26 02:40:48 +0000372def fix_only_warnings : Flag<"-fix-only-warnings">,
373 HelpText<"Apply fix-it advice only for warnings, not errors">;
374def fixit_recompile : Flag<"-fixit-recompile">,
375 HelpText<"Apply fix-it changes and recompile">;
376def fixit_to_temp : Flag<"-fixit-to-temporary">,
377 HelpText<"Apply fix-it changes to temporary files">;
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000378
Douglas Gregor453dbcb2012-01-26 07:55:45 +0000379def foverride_record_layout_EQ : Joined<"-foverride-record-layout=">,
380 HelpText<"Override record layouts with those in the given file">;
381
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000382//===----------------------------------------------------------------------===//
383// Language Options
384//===----------------------------------------------------------------------===//
385
John McCall13db5cf2011-09-09 20:41:01 +0000386def fblocks_runtime_optional : Flag<"-fblocks-runtime-optional">,
387 HelpText<"Weakly link in the blocks runtime">;
Daniel Dunbar73482882010-02-10 18:48:44 +0000388def fsjlj_exceptions : Flag<"-fsjlj-exceptions">,
389 HelpText<"Use SjLj style exceptions">;
John McCall279b5eb2010-08-12 23:36:15 +0000390def fhidden_weak_vtables : Flag<"-fhidden-weak-vtables">,
391 HelpText<"Generate weak vtables and RTTI with hidden visibility">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000392def main_file_name : Separate<"-main-file-name">,
393 HelpText<"Main file name to use for debug info">;
Daniel Dunbarefb0fa92010-03-20 04:15:41 +0000394def fno_signed_char : Flag<"-fno-signed-char">,
395 HelpText<"Char is unsigned">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000396def fconstant_string_class : Separate<"-fconstant-string-class">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000397 MetaVarName<"<class name>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000398 HelpText<"Specify the class to use for constant Objective-C string objects.">;
John McCallf85e1932011-06-15 23:02:42 +0000399def fobjc_arc_cxxlib_EQ : Joined<"-fobjc-arc-cxxlib=">,
400 HelpText<"Objective-C++ Automatic Reference Counting standard library kind">;
John McCall9f084a32011-07-06 00:26:06 +0000401def fobjc_runtime_has_weak : Flag<"-fobjc-runtime-has-weak">,
402 HelpText<"The target Objective-C runtime supports ARC weak operations">;
Daniel Dunbarf643b9b2010-04-24 17:56:46 +0000403def fobjc_dispatch_method_EQ : Joined<"-fobjc-dispatch-method=">,
404 HelpText<"Objective-C dispatch method to use">;
Ted Kremenekc32647d2010-12-23 21:35:43 +0000405def fobjc_default_synthesize_properties : Flag<"-fobjc-default-synthesize-properties">,
406 HelpText<"enable the default synthesis of Objective-C properties">;
Daniel Dunbar76743522009-11-29 02:39:08 +0000407def pic_level : Separate<"-pic-level">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000408 HelpText<"Value for __PIC__">;
Chandler Carruth5e219cf2012-04-08 16:40:35 +0000409def pie_level : Separate<"-pie-level">,
410 HelpText<"Value for __PIE__">;
Douglas Gregorfae3b2f2010-07-27 00:27:13 +0000411def fno_validate_pch : Flag<"-fno-validate-pch">,
412 HelpText<"Disable validation of precompiled headers">;
Argyrios Kyrtzidisb9728582010-10-14 20:14:18 +0000413def dump_deserialized_pch_decls : Flag<"-dump-deserialized-decls">,
414 HelpText<"Dump declarations that are deserialized from PCH, for testing">;
Argyrios Kyrtzidis3e785932010-10-14 20:14:25 +0000415def error_on_deserialized_pch_decl : Separate<"-error-on-deserialized-decl">,
416 HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
Argyrios Kyrtzidis9a8cbc72011-10-28 22:54:24 +0000417def error_on_deserialized_pch_decl_EQ : Joined<"-error-on-deserialized-decl=">,
418 Alias<error_on_deserialized_pch_decl>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000419def static_define : Flag<"-static-define">,
420 HelpText<"Should __STATIC__ be defined">;
421def stack_protector : Separate<"-stack-protector">,
422 HelpText<"Enable stack protectors">;
Chad Rosiera7afeb02012-08-21 16:16:06 +0000423def stack_protector_buffer_size : Separate<"-stack-protector-buffer-size">,
424 HelpText<"Lower bound for a buffer to be considered for stack protection">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000425def fvisibility : Separate<"-fvisibility">,
426 HelpText<"Default symbol visibility">;
427def ftemplate_depth : Separate<"-ftemplate-depth">,
428 HelpText<"Maximum depth of recursive template instantiation">;
Richard Smithc18c4232011-11-21 19:36:32 +0000429def fconstexpr_depth : Separate<"-fconstexpr-depth">,
430 HelpText<"Maximum depth of recursive constexpr function calls">;
Chandler Carruth50465d12011-04-23 06:30:43 +0000431def fconst_strings : Flag<"-fconst-strings">,
432 HelpText<"Use a const qualified type for string literals in C and ObjC">;
433def fno_const_strings : Flag<"-fno-const-strings">,
434 HelpText<"Don't use a const qualified type for string literals in C and ObjC">;
Daniel Dunbarfb937b82010-04-15 15:06:22 +0000435def fno_bitfield_type_align : Flag<"-fno-bitfield-type-align">,
436 HelpText<"Ignore bit-field types when aligning structures">;
Peter Collingbourne207f4d82011-03-18 22:38:29 +0000437def ffake_address_space_map : Flag<"-ffake-address-space-map">,
438 HelpText<"Use a fake address space map; OpenCL testing purposes only">;
John McCalla5fc4722011-04-09 22:50:59 +0000439def funknown_anytype : Flag<"-funknown-anytype">,
440 HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">;
John McCall48218c62011-07-13 17:56:40 +0000441def fdebugger_support : Flag<"-fdebugger-support">,
442 HelpText<"Enable special debugger support behavior">;
Sean Callanan50a9a122012-02-04 01:29:37 +0000443def fdebugger_cast_result_to_id : Flag<"-fdebugger-cast-result-to-id">,
444 HelpText<"Enable casting unknown expression results to id">;
Ted Kremenekebcb57a2012-03-06 20:05:56 +0000445def fdebugger_objc_literal : Flag<"-fdebugger-objc-literal">,
Jordan Roseb13291a2012-07-19 18:10:18 +0000446 HelpText<"Enable special debugger support for Objective-C subscripting and literals">;
Chandler Carruth1cfe3c32011-04-23 09:27:53 +0000447def fdeprecated_macro : Flag<"-fdeprecated-macro">,
Chandler Carruthf8c247d2011-04-23 19:48:40 +0000448 HelpText<"Defines the __DEPRECATED macro">;
Chandler Carruth1cfe3c32011-04-23 09:27:53 +0000449def fno_deprecated_macro : Flag<"-fno-deprecated-macro">,
Chandler Carruthf8c247d2011-04-23 19:48:40 +0000450 HelpText<"Undefines the __DEPRECATED macro">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000451
452//===----------------------------------------------------------------------===//
453// Header Search Options
454//===----------------------------------------------------------------------===//
455
Daniel Dunbara268fc02011-10-11 18:20:10 +0000456def nostdsysteminc : Flag<"-nostdsysteminc">,
457 HelpText<"Disable standard system #include directories">;
Douglas Gregorb86b8dc2011-11-15 19:35:01 +0000458def fmodule_name : Joined<"-fmodule-name=">,
459 MetaVarName<"<name>">,
460 HelpText<"Specify the name of the module to build">;
Douglas Gregor6e975c42011-09-13 23:15:45 +0000461def fdisable_module_hash : Flag<"-fdisable-module-hash">,
462 HelpText<"Disable the module hash">;
Benjamin Kramer47adebe2011-09-22 21:41:16 +0000463def c_isystem : JoinedOrSeparate<"-c-isystem">, MetaVarName<"<directory>">,
464 HelpText<"Add directory to the C SYSTEM include search path">;
Benjamin Kramer47adebe2011-09-22 21:41:16 +0000465def objc_isystem : JoinedOrSeparate<"-objc-isystem">,
466 MetaVarName<"<directory>">,
467 HelpText<"Add directory to the ObjC SYSTEM include search path">;
468def objcxx_isystem : JoinedOrSeparate<"-objcxx-isystem">,
469 MetaVarName<"<directory>">,
470 HelpText<"Add directory to the ObjC++ SYSTEM include search path">;
Chandler Carruthac2bc4d2011-11-05 08:30:29 +0000471def internal_isystem : JoinedOrSeparate<"-internal-isystem">,
472 MetaVarName<"<directory>">,
473 HelpText<"Add directory to the internal system include search path; these "
474 "are assumed to not be user-provided and are used to model system "
475 "and standard headers' paths.">;
476def internal_externc_isystem : JoinedOrSeparate<"-internal-externc-isystem">,
477 MetaVarName<"<directory>">,
478 HelpText<"Add directory to the internal system include search path with "
479 "implicit extern \"C\" semantics; these are assumed to not be "
480 "user-provided and are used to model system and standard headers' "
481 "paths.">;
Richard Smithf122a132012-06-13 20:27:03 +0000482def isystem_prefix : JoinedOrSeparate<"-isystem-prefix">,
483 MetaVarName<"<prefix>">,
484 HelpText<"Treat all #include paths starting with <prefix> as including a "
485 "system header.">;
486def ino_system_prefix : JoinedOrSeparate<"-ino-system-prefix">,
487 MetaVarName<"<prefix>">,
488 HelpText<"Treat all #include paths starting with <prefix> as not including a "
489 "system header.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000490
491//===----------------------------------------------------------------------===//
492// Preprocessor Options
493//===----------------------------------------------------------------------===//
494
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000495def include_pth : Separate<"-include-pth">, MetaVarName<"<file>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000496 HelpText<"Include file before parsing">;
Argyrios Kyrtzidisb0f4b9a2011-03-09 17:21:42 +0000497def chain_include : Separate<"-chain-include">, MetaVarName<"<file>">,
498 HelpText<"Include and chain a header file after turning it into PCH">;
Douglas Gregorf4f6c9d2010-07-26 21:36:20 +0000499def preamble_bytes_EQ : Joined<"-preamble-bytes=">,
Douglas Gregor3d398aa2010-07-26 16:29:14 +0000500 HelpText<"Assume that the precompiled header is a precompiled preamble "
501 "covering the first N bytes of the main file">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000502def token_cache : Separate<"-token-cache">, MetaVarName<"<path>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000503 HelpText<"Use specified token cache file">;
Douglas Gregor94dc8f62010-03-19 16:15:56 +0000504def detailed_preprocessing_record : Flag<"-detailed-preprocessing-record">,
505 HelpText<"include a detailed record of preprocessing actions">;
Peter Collingbourne61e07862010-12-04 01:50:45 +0000506
507//===----------------------------------------------------------------------===//
508// OpenCL Options
509//===----------------------------------------------------------------------===//
510
511def cl_opt_disable : Flag<"-cl-opt-disable">,
512 HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">;
Peter Collingbourne09821362010-12-04 01:50:56 +0000513def cl_single_precision_constant : Flag<"-cl-single-precision-constant">,
514 HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">;
Peter Collingbourne5d729a32010-12-04 01:51:05 +0000515def cl_finite_math_only : Flag<"-cl-finite-math-only">,
516 HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">;
Peter Collingbourne5f67e132010-12-04 01:51:14 +0000517def cl_unsafe_math_optimizations : Flag<"-cl-unsafe-math-optimizations">,
518 HelpText<"OpenCL only. Allow unsafe floating-point optimizations. Also implies -cl-no-signed-zeros and -cl-mad-enable">;
Peter Collingbournef0840822010-12-04 01:51:23 +0000519def cl_fast_relaxed_math : Flag<"-cl-fast-relaxed-math">,
520 HelpText<"OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines __FAST_RELAXED_MATH__">;
Peter Collingbourne4400cb82010-12-04 01:51:33 +0000521def cl_mad_enable : Flag<"-cl-mad-enable">,
522 HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">;
Peter Collingbourne91252d12010-12-04 01:51:40 +0000523def cl_std_EQ : Joined<"-cl-std=">,
524 HelpText<"OpenCL language standard to compile for">;
Peter Collingbourned51e43a2011-10-06 18:29:46 +0000525
526//===----------------------------------------------------------------------===//
527// CUDA Options
528//===----------------------------------------------------------------------===//
529
530def fcuda_is_device : Flag<"-fcuda-is-device">,
531 HelpText<"Generate code for CUDA device">;
James Molloybfd7a522012-05-01 14:57:16 +0000532
533} // let Flags = [CC1Option]