blob: 48d143d2e1d6c6e36e2ada6bbeed26aacfd4e593 [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">;
42def analysis_CFGAddInitializers : Flag<"-cfg-add-initializers">,
43 HelpText<"Add C++ initializers to CFGs for all analyses">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000044
45def analyzer_store : Separate<"-analyzer-store">,
46 HelpText<"Source Code Analysis - Abstract Memory Store Models">;
47def analyzer_store_EQ : Joined<"-analyzer-store=">, Alias<analyzer_store>;
48
49def analyzer_constraints : Separate<"-analyzer-constraints">,
50 HelpText<"Source Code Analysis - Symbolic Constraint Engines">;
51def analyzer_constraints_EQ : Joined<"-analyzer-constraints=">,
52 Alias<analyzer_constraints>;
53
54def analyzer_output : Separate<"-analyzer-output">,
55 HelpText<"Source Code Analysis - Output Options">;
56def analyzer_output_EQ : Joined<"-analyzer-output=">,
57 Alias<analyzer_output>;
58
Anna Zaksd3095282011-09-30 02:03:00 +000059def analyzer_purge : Separate<"-analyzer-purge">,
60 HelpText<"Source Code Analysis - Dead Symbol Removal Frequency">;
61def analyzer_purge_EQ : Joined<"-analyzer-purge=">, Alias<analyzer_purge>;
62
Daniel Dunbare2814d82009-11-22 22:08:20 +000063def analyzer_opt_analyze_headers : Flag<"-analyzer-opt-analyze-headers">,
64 HelpText<"Force the static analyzer to analyze functions defined in header files">;
Ted Kremenekfc576512009-12-07 22:06:12 +000065def analyzer_opt_analyze_nested_blocks : Flag<"-analyzer-opt-analyze-nested-blocks">,
Michael J. Spencer20249a12010-10-21 03:16:25 +000066 HelpText<"Analyze the definitions of blocks in addition to functions">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000067def analyzer_display_progress : Flag<"-analyzer-display-progress">,
68 HelpText<"Emit verbose output about the analyzer's progress">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000069def analyze_function : Separate<"-analyze-function">,
70 HelpText<"Run analysis on specific function">;
71def analyze_function_EQ : Joined<"-analyze-function=">, Alias<analyze_function>;
72def analyzer_eagerly_assume : Flag<"-analyzer-eagerly-assume">,
73 HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">;
Ted Kremenekd767d812011-02-09 01:27:33 +000074def analyzer_no_eagerly_trim_egraph : Flag<"-analyzer-no-eagerly-trim-egraph">,
75 HelpText<"Don't eagerly remove uninteresting ExplodedNodes from the ExplodedGraph">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000076def trim_egraph : Flag<"-trim-egraph">,
77 HelpText<"Only show error-related paths in the analysis graph">;
78def analyzer_viz_egraph_graphviz : Flag<"-analyzer-viz-egraph-graphviz">,
79 HelpText<"Display exploded graph using GraphViz">;
80def analyzer_viz_egraph_ubigraph : Flag<"-analyzer-viz-egraph-ubigraph">,
81 HelpText<"Display exploded graph using Ubigraph">;
Anna Zaks66253352012-03-08 23:16:35 +000082
Anna Zaks8235f9c2012-03-02 19:05:03 +000083def analyzer_inline_max_stack_depth : Separate<"-analyzer-inline-max-stack-depth">,
84 HelpText<"Bound on stack depth while inlining (4 by default)">;
Anna Zaks66253352012-03-08 23:16:35 +000085def analyzer_inline_max_stack_depth_EQ : Joined<"-analyzer-inline-max-stack-depth=">,
86 Alias<analyzer_inline_max_stack_depth>;
87
Anna Zaks8235f9c2012-03-02 19:05:03 +000088def analyzer_inline_max_function_size : Separate<"-analyzer-inline-max-function-size">,
Anna Zaks8fbb4e62012-03-05 23:54:55 +000089 HelpText<"Bound on the number of basic blocks in an inlined function (200 by default)">;
Anna Zaks66253352012-03-08 23:16:35 +000090def analyzer_inline_max_function_size_EQ : Joined<"-analyzer-inline-max-function-size=">,
91 Alias<analyzer_inline_max_function_size>;
92
93def analyzer_ipa : Separate<"-analyzer-ipa">,
94 HelpText<"Specify the inter-procedural analysis mode">;
95def analyzer_ipa_EQ : Joined<"-analyzer-ipa=">, Alias<analyzer_ipa>;
96
97def analyzer_inlining_mode : Separate<"-analyzer-inlining-mode">,
98 HelpText<"Specify the function selection heuristic used during inlining">;
99def analyzer_inlining_mode_EQ : Joined<"-analyzer-inlining-mode=">, Alias<analyzer_inlining_mode>;
Anna Zaks5903a372012-03-27 20:02:53 +0000100
Anna Zaksb47dbcb2012-03-28 19:59:16 +0000101def analyzer_disable_retry_exhausted : Flag<"-analyzer-disable-retry-exhausted">,
102 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 +0000103
Zhongxing Xuc09289d2010-04-13 06:44:31 +0000104def analyzer_max_nodes : Separate<"-analyzer-max-nodes">,
Tom Carecf9ce132010-09-29 23:48:13 +0000105 HelpText<"The maximum number of nodes the analyzer can generate (150000 default, 0 = no limit)">;
Zhongxing Xu6362b892010-05-18 00:28:37 +0000106def analyzer_max_loop : Separate<"-analyzer-max-loop">,
107 HelpText<"The maximum number of times the analyzer will go through a loop">;
Anna Zaks81fb1692012-02-27 21:33:16 +0000108def analyzer_stats : Flag<"-analyzer-stats">,
109 HelpText<"Print internal analyzer statistics.">;
Daniel Dunbare2814d82009-11-22 22:08:20 +0000110
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +0000111def analyzer_checker : Separate<"-analyzer-checker">,
112 HelpText<"Choose analyzer checkers to enable">;
113def analyzer_checker_EQ : Joined<"-analyzer-checker=">,
114 Alias<analyzer_checker>;
115
116def analyzer_disable_checker : Separate<"-analyzer-disable-checker">,
117 HelpText<"Choose analyzer checkers to disable">;
118def analyzer_disable_checker_EQ : Joined<"-analyzer-disable-checker=">,
119 Alias<analyzer_disable_checker>;
120
Argyrios Kyrtzidis116f3642011-02-25 00:09:51 +0000121def analyzer_checker_help : Flag<"-analyzer-checker-help">,
122 HelpText<"Display the list of analyzer checkers that are available">;
123
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000124//===----------------------------------------------------------------------===//
Fariborz Jahanianb5c6bab2012-01-25 00:20:29 +0000125// Migrator Options
126//===----------------------------------------------------------------------===//
127def migrator_no_nsalloc_error : Flag<"-no-ns-alloc-error">,
128 HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">;
129
Fariborz Jahanian26f0e4e2012-01-26 00:08:04 +0000130def migrator_no_finalize_removal : Flag<"-no-finalize-removal">,
131 HelpText<"Do not remove finalize method in gc mode">;
132
Fariborz Jahanianb5c6bab2012-01-25 00:20:29 +0000133//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000134// CodeGen Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000135//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000136
137def disable_llvm_optzns : Flag<"-disable-llvm-optzns">,
138 HelpText<"Don't run LLVM optimization passes">;
John McCall824e19e2010-02-12 23:47:27 +0000139def disable_llvm_verifier : Flag<"-disable-llvm-verifier">,
140 HelpText<"Don't run the LLVM IR verifier pass">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000141def disable_red_zone : Flag<"-disable-red-zone">,
142 HelpText<"Do not emit code that uses the red zone.">;
Nick Lewycky7c4fd912011-10-21 02:32:14 +0000143def fdebug_compilation_dir : Separate<"-fdebug-compilation-dir">,
144 HelpText<"The compilation directory to embed in the debug info.">;
Daniel Dunbarf2d8b9f2009-12-18 02:43:17 +0000145def dwarf_debug_flags : Separate<"-dwarf-debug-flags">,
146 HelpText<"The string to embed in the Dwarf debug flags record.">;
John McCall32096692011-03-18 02:56:14 +0000147def fforbid_guard_variables : Flag<"-fforbid-guard-variables">,
148 HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
Chad Rosier005af272012-05-16 21:19:55 +0000149def no_implicit_float : Flag<"-no-implicit-float">,
150 HelpText<"Don't generate implicit floating point instructions">;
Anders Carlsson824d7ea2010-02-11 08:02:13 +0000151def fdump_vtable_layouts : Flag<"-fdump-vtable-layouts">,
152 HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
Nick Lewyckye8ba8d72011-04-21 23:44:07 +0000153def femit_coverage_notes : Flag<"-femit-coverage-notes">,
154 HelpText<"Emit a gcov coverage notes file when compiling.">;
155def femit_coverage_data: Flag<"-femit-coverage-data">,
156 HelpText<"Instrument the program to emit gcov coverage data when run.">;
Nick Lewycky3dc05412011-05-05 00:08:20 +0000157def coverage_file : Separate<"-coverage-file">,
158 HelpText<"Emit coverage data to this filename. The extension will be replaced.">;
159def coverage_file_EQ : Joined<"-coverage-file=">, Alias<coverage_file>;
Daniel Dunbare26bdb92011-06-21 18:54:46 +0000160def fuse_register_sized_bitfield_access: Flag<"-fuse-register-sized-bitfield-access">,
161 HelpText<"Use register sized accesses to bit-fields, when possible.">;
Dan Gohman4d5625e2010-10-14 22:36:56 +0000162def relaxed_aliasing : Flag<"-relaxed-aliasing">,
Devang Patelbe570122010-10-15 18:23:36 +0000163 HelpText<"Turn off Type Based Alias Analysis">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000164def masm_verbose : Flag<"-masm-verbose">,
165 HelpText<"Generate verbose assembly output">;
166def mcode_model : Separate<"-mcode-model">,
167 HelpText<"The code model to use">;
168def mdebug_pass : Separate<"-mdebug-pass">,
169 HelpText<"Enable additional debug output">;
170def mdisable_fp_elim : Flag<"-mdisable-fp-elim">,
171 HelpText<"Disable frame pointer elimination optimization">;
Nick Lewycky1db772b2012-01-23 08:29:12 +0000172def mdisable_tail_calls : Flag<"-mdisable-tail-calls">,
173 HelpText<"Disable tail call optimization, keeping the call stack accurate">;
Daniel Dunbar001f6282011-12-09 23:41:18 +0000174def menable_no_infinities : Flag<"-menable-no-infs">,
175 HelpText<"Allow optimization to assume there are no infinities.">;
176def menable_no_nans : Flag<"-menable-no-nans">,
177 HelpText<"Allow optimization to assume there are no NaNs.">;
Chandler Carruthabf07a72012-01-02 14:19:45 +0000178def menable_unsafe_fp_math : Flag<"-menable-unsafe-fp-math">,
179 HelpText<"Allow unsafe floating-point math optimizations which may decrease "
180 "precision">;
Daniel Dunbar87667aa2009-12-08 19:49:51 +0000181def mfloat_abi : Separate<"-mfloat-abi">,
Daniel Dunbar3b315262009-11-30 08:42:00 +0000182 HelpText<"The float ABI to use">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000183def mlimit_float_precision : Separate<"-mlimit-float-precision">,
184 HelpText<"Limit float precision to the given value">;
Nick Lewyckyc3b90142011-06-21 00:14:18 +0000185def mno_exec_stack : Flag<"-mnoexecstack">,
186 HelpText<"Mark the file as not needing an executable stack">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000187def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">,
188 HelpText<"Do not put zero initialized data in the BSS">;
Daniel Dunbar3c66d302011-03-22 16:48:17 +0000189def backend_option : Separate<"-backend-option">,
190 HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
Daniel Dunbar17d3fea2011-02-09 17:54:19 +0000191def mregparm : Separate<"-mregparm">,
192 HelpText<"Limit the number of registers available for integer arguments">;
Daniel Dunbar96932322011-03-28 22:49:28 +0000193def msave_temp_labels : Flag<"-msave-temp-labels">,
194 HelpText<"(integrated-as) Save temporary labels">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000195def mrelocation_model : Separate<"-mrelocation-model">,
196 HelpText<"The relocation model to use">;
197def munwind_tables : Flag<"-munwind-tables">,
198 HelpText<"Generate unwinding tables for all functions">;
Rafael Espindola8af669f2012-06-19 01:26:10 +0000199def fuse_init_array : Flag<"-fuse-init-array">,
200 HelpText<"Use .init_array instead of .ctors">;
John McCalld46f9852010-02-19 01:32:20 +0000201def mconstructor_aliases : Flag<"-mconstructor-aliases">,
202 HelpText<"Emit complete constructors and destructors as aliases when possible">;
Peter Collingbourne22a7dfe2011-10-30 17:30:44 +0000203def mlink_bitcode_file : Separate<"-mlink-bitcode-file">,
204 HelpText<"Link the given bitcode file before performing optimizations.">;
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000205
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000206//===----------------------------------------------------------------------===//
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000207// Dependency Output Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000208//===----------------------------------------------------------------------===//
209
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000210def sys_header_deps : Flag<"-sys-header-deps">,
211 HelpText<"Include system headers in dependency output">;
Daniel Dunbarb34d69b2011-02-02 21:11:31 +0000212def header_include_file : Separate<"-header-include-file">,
213 HelpText<"Filename (or -) to write header include output to">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000214
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000215//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000216// Diagnostic Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000217//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000218
219def dump_build_information : Separate<"-dump-build-information">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000220 MetaVarName<"<filename>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000221 HelpText<"output a dump of some build information to a file">;
Daniel Dunbar08c66952011-04-07 18:11:14 +0000222def diagnostic_log_file : Separate<"-diagnostic-log-file">,
223 HelpText<"Filename (or -) to log diagnostics to">;
Ted Kremenek36f6e302011-11-11 00:07:43 +0000224def diagnostic_serialized_file : Separate<"-serialize-diagnostic-file">,
Ted Kremenek78002122011-10-29 00:12:39 +0000225 MetaVarName<"<filename>">,
226 HelpText<"File for serializing diagnostics in a binary format">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000227
Douglas Gregorc9471b02011-05-21 17:07:29 +0000228def fdiagnostics_format : Separate<"-fdiagnostics-format">,
229 HelpText<"Change diagnostic formatting to match IDE and command line tools">;
Chris Lattner6fbe8392010-05-04 21:55:25 +0000230def fdiagnostics_show_category : Separate<"-fdiagnostics-show-category">,
231 HelpText<"Print diagnostic category">;
Chris Lattner124fca52010-01-09 21:54:33 +0000232def ftabstop : Separate<"-ftabstop">, MetaVarName<"<N>">,
233 HelpText<"Set the tab stop distance.">;
Chris Lattnerc1002142010-04-07 20:37:06 +0000234def ferror_limit : Separate<"-ferror-limit">, MetaVarName<"<N>">,
235 HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
Douglas Gregor6c1cb992010-05-04 17:13:42 +0000236def fmacro_backtrace_limit : Separate<"-fmacro-backtrace-limit">, MetaVarName<"<N>">,
Chandler Carruthb29a6102011-07-15 00:04:38 +0000237 HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
Douglas Gregor575cf372010-04-20 07:18:24 +0000238def ftemplate_backtrace_limit : Separate<"-ftemplate-backtrace-limit">, MetaVarName<"<N>">,
239 HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
Richard Smith08d6e032011-12-16 19:06:07 +0000240def fconstexpr_backtrace_limit : Separate<"-fconstexpr-backtrace-limit">, MetaVarName<"<N>">,
241 HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000242def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000243 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000244def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">,
245 HelpText<"Silence ObjC rewriting warnings">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000246
247//===----------------------------------------------------------------------===//
248// Frontend Options
249//===----------------------------------------------------------------------===//
250
Daniel Dunbar8ff5b282009-12-11 23:00:49 +0000251// This isn't normally used, it is just here so we can parse a
252// CompilerInvocation out of a driver-derived argument vector.
253def cc1 : Flag<"-cc1">;
254
Douglas Gregor9bed8792010-02-09 19:21:46 +0000255def ast_merge : Separate<"-ast-merge">,
256 MetaVarName<"<ast file>">,
257 HelpText<"Merge the given AST file into the translation unit being compiled.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000258def code_completion_at : Separate<"-code-completion-at">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000259 MetaVarName<"<file>:<line>:<column>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000260 HelpText<"Dump code-completion information at a location">;
Daniel Dunbare14b5f52009-12-03 05:11:16 +0000261def remap_file : Separate<"-remap-file">,
262 MetaVarName<"<from>;<to>">,
263 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +0000264def code_completion_at_EQ : Joined<"-code-completion-at=">,
265 Alias<code_completion_at>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000266def code_completion_macros : Flag<"-code-completion-macros">,
267 HelpText<"Include macros in code-completion results">;
Douglas Gregord8e8a582010-05-25 21:41:55 +0000268def code_completion_patterns : Flag<"-code-completion-patterns">,
269 HelpText<"Include code patterns in code-completion results">;
Douglas Gregor8071e422010-08-15 06:18:01 +0000270def no_code_completion_globals : Flag<"-no-code-completion-globals">,
271 HelpText<"Do not include global declarations in code-completion results.">;
Dmitri Gribenkod99ef532012-07-02 17:35:10 +0000272def code_completion_brief_comments : Flag<"-code-completion-brief-comments">,
273 HelpText<"Include brief documentation comments in code-completion results.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000274def disable_free : Flag<"-disable-free">,
275 HelpText<"Disable freeing of memory on exit">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000276def load : Separate<"-load">, MetaVarName<"<dsopath>">,
Daniel Dunbarefba2272009-12-03 05:11:05 +0000277 HelpText<"Load the named plugin (dynamic shared object)">;
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000278def plugin : Separate<"-plugin">, MetaVarName<"<name>">,
Nico Weber5aa74af2011-01-25 20:34:14 +0000279 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 +0000280def plugin_arg : JoinedAndSeparate<"-plugin-arg-">,
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000281 MetaVarName<"<name> <arg>">,
282 HelpText<"Pass <arg> to plugin <name>">;
Nico Weber5aa74af2011-01-25 20:34:14 +0000283def add_plugin : Separate<"-add-plugin">, MetaVarName<"<name>">,
284 HelpText<"Use the named plugin action in addition to the default action">;
Daniel Dunbar8b9adfe2009-12-15 00:06:45 +0000285def resource_dir : Separate<"-resource-dir">,
286 HelpText<"The directory which holds the compiler resource files">;
Daniel Dunbar9b5e9ae2009-12-03 07:01:58 +0000287def version : Flag<"-version">,
288 HelpText<"Print the compiler version">;
Alexander Kornienkoe34a0522012-07-26 16:01:23 +0000289def ast_dump_filter : Separate<"-ast-dump-filter">,
290 MetaVarName<"<dump_filter>">,
291 HelpText<"Use with -ast-dump or -ast-print to dump/print only AST declaration"
292 " nodes having a certain substring in a qualified name.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000293
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000294let Group = Action_Group in {
295
296def Eonly : Flag<"-Eonly">,
297 HelpText<"Just run preprocessor, no output (for timings)">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000298def dump_raw_tokens : Flag<"-dump-raw-tokens">,
299 HelpText<"Lex file in raw mode and dump raw tokens">;
300def analyze : Flag<"-analyze">,
301 HelpText<"Run static analysis engine">;
302def dump_tokens : Flag<"-dump-tokens">,
303 HelpText<"Run preprocessor, dump internal rep of tokens">;
Daniel Dunbar27585952010-03-19 19:44:04 +0000304def init_only : Flag<"-init-only">,
305 HelpText<"Only execute frontend initialization">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000306def fixit : Flag<"-fixit">,
307 HelpText<"Apply fix-it advice to the input source">;
Nick Lewyckyba5f6ec2010-04-24 01:30:46 +0000308def fixit_EQ : Joined<"-fixit=">,
309 HelpText<"Apply fix-it advice creating a file with the given suffix">;
Douglas Gregorf033f1d2010-07-20 20:18:03 +0000310def print_preamble : Flag<"-print-preamble">,
311 HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
312 " precompiled headers.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000313def emit_html : Flag<"-emit-html">,
314 HelpText<"Output input source as HTML">;
315def ast_print : Flag<"-ast-print">,
316 HelpText<"Build ASTs and then pretty-print them">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000317def ast_dump : Flag<"-ast-dump">,
318 HelpText<"Build ASTs and then debug dump them">;
John McCallf3514242010-11-24 11:21:45 +0000319def ast_dump_xml : Flag<"-ast-dump-xml">,
320 HelpText<"Build ASTs and then debug dump them in a verbose XML format">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000321def ast_view : Flag<"-ast-view">,
322 HelpText<"Build ASTs and view them with GraphViz">;
323def print_decl_contexts : Flag<"-print-decl-contexts">,
324 HelpText<"Print DeclContexts and their Decls">;
Douglas Gregor467dc882011-08-25 22:30:56 +0000325def emit_module : Flag<"-emit-module">,
Douglas Gregor66490142011-11-29 22:42:06 +0000326 HelpText<"Generate pre-compiled module file from a module map">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000327def emit_pth : Flag<"-emit-pth">,
328 HelpText<"Generate pre-tokenized header file">;
329def emit_pch : Flag<"-emit-pch">,
330 HelpText<"Generate pre-compiled header file">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000331def emit_llvm_bc : Flag<"-emit-llvm-bc">,
332 HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
333def emit_llvm_only : Flag<"-emit-llvm-only">,
334 HelpText<"Build ASTs and convert to LLVM, discarding output">;
Daniel Dunbar32148ce2010-05-25 18:41:01 +0000335def emit_codegen_only : Flag<"-emit-codegen-only">,
336 HelpText<"Generate machine code, but discard output">;
Daniel Dunbarda1573f2010-02-03 01:18:43 +0000337def emit_obj : Flag<"-emit-obj">,
338 HelpText<"Emit native object files">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000339def rewrite_test : Flag<"-rewrite-test">,
340 HelpText<"Rewriter playground">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000341def rewrite_macros : Flag<"-rewrite-macros">,
342 HelpText<"Expand macros without full preprocessing">;
Ted Kremenek30660a82012-03-06 20:06:33 +0000343def migrate : Flag<"-migrate">,
344 HelpText<"Migrate source code">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000345}
346
Ted Kremenek30660a82012-03-06 20:06:33 +0000347def mt_migrate_directory : Separate<"-mt-migrate-directory">,
348 HelpText<"Directory for temporary files produced during ARC or ObjC migration">;
John McCallf85e1932011-06-15 23:02:42 +0000349def arcmt_check : Flag<"-arcmt-check">,
350 HelpText<"Check for ARC migration issues that need manual handling">;
351def arcmt_modify : Flag<"-arcmt-modify">,
352 HelpText<"Apply modifications to files to conform to ARC">;
Argyrios Kyrtzidis69325d52011-07-09 20:00:58 +0000353def arcmt_migrate : Flag<"-arcmt-migrate">,
354 HelpText<"Apply modifications and produces temporary files that conform to ARC">;
Argyrios Kyrtzidis389db162010-11-03 22:45:23 +0000355
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000356def relocatable_pch : Flag<"-relocatable-pch">,
357 HelpText<"Whether to build a relocatable precompiled header">;
358def print_stats : Flag<"-print-stats">,
359 HelpText<"Print performance metrics and statistics">;
Anders Carlsson46116ce2010-04-10 19:09:13 +0000360def fdump_record_layouts : Flag<"-fdump-record-layouts">,
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000361 HelpText<"Dump record layout information">;
Douglas Gregor453dbcb2012-01-26 07:55:45 +0000362def fdump_record_layouts_simple : Flag<"-fdump-record-layouts-simple">,
363 HelpText<"Dump record layout information in a simple form used for testing">;
Nick Lewycky1450f262010-08-13 17:31:00 +0000364def fix_what_you_can : Flag<"-fix-what-you-can">,
365 HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
Argyrios Kyrtzidis61d679a2012-01-26 02:40:48 +0000366def fix_only_warnings : Flag<"-fix-only-warnings">,
367 HelpText<"Apply fix-it advice only for warnings, not errors">;
368def fixit_recompile : Flag<"-fixit-recompile">,
369 HelpText<"Apply fix-it changes and recompile">;
370def fixit_to_temp : Flag<"-fixit-to-temporary">,
371 HelpText<"Apply fix-it changes to temporary files">;
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000372
Douglas Gregor453dbcb2012-01-26 07:55:45 +0000373def foverride_record_layout_EQ : Joined<"-foverride-record-layout=">,
374 HelpText<"Override record layouts with those in the given file">;
375
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000376//===----------------------------------------------------------------------===//
377// Language Options
378//===----------------------------------------------------------------------===//
379
John McCall13db5cf2011-09-09 20:41:01 +0000380def fblocks_runtime_optional : Flag<"-fblocks-runtime-optional">,
381 HelpText<"Weakly link in the blocks runtime">;
Daniel Dunbar73482882010-02-10 18:48:44 +0000382def fsjlj_exceptions : Flag<"-fsjlj-exceptions">,
383 HelpText<"Use SjLj style exceptions">;
John McCall279b5eb2010-08-12 23:36:15 +0000384def fhidden_weak_vtables : Flag<"-fhidden-weak-vtables">,
385 HelpText<"Generate weak vtables and RTTI with hidden visibility">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000386def main_file_name : Separate<"-main-file-name">,
387 HelpText<"Main file name to use for debug info">;
Daniel Dunbarefb0fa92010-03-20 04:15:41 +0000388def fno_signed_char : Flag<"-fno-signed-char">,
389 HelpText<"Char is unsigned">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000390def fconstant_string_class : Separate<"-fconstant-string-class">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000391 MetaVarName<"<class name>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000392 HelpText<"Specify the class to use for constant Objective-C string objects.">;
John McCallf85e1932011-06-15 23:02:42 +0000393def fobjc_arc_cxxlib_EQ : Joined<"-fobjc-arc-cxxlib=">,
394 HelpText<"Objective-C++ Automatic Reference Counting standard library kind">;
John McCall9f084a32011-07-06 00:26:06 +0000395def fobjc_runtime_has_weak : Flag<"-fobjc-runtime-has-weak">,
396 HelpText<"The target Objective-C runtime supports ARC weak operations">;
Daniel Dunbarf643b9b2010-04-24 17:56:46 +0000397def fobjc_dispatch_method_EQ : Joined<"-fobjc-dispatch-method=">,
398 HelpText<"Objective-C dispatch method to use">;
Ted Kremenekc32647d2010-12-23 21:35:43 +0000399def fobjc_default_synthesize_properties : Flag<"-fobjc-default-synthesize-properties">,
400 HelpText<"enable the default synthesis of Objective-C properties">;
Daniel Dunbar76743522009-11-29 02:39:08 +0000401def pic_level : Separate<"-pic-level">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000402 HelpText<"Value for __PIC__">;
Chandler Carruth5e219cf2012-04-08 16:40:35 +0000403def pie_level : Separate<"-pie-level">,
404 HelpText<"Value for __PIE__">;
Douglas Gregorfae3b2f2010-07-27 00:27:13 +0000405def fno_validate_pch : Flag<"-fno-validate-pch">,
406 HelpText<"Disable validation of precompiled headers">;
Argyrios Kyrtzidisb9728582010-10-14 20:14:18 +0000407def dump_deserialized_pch_decls : Flag<"-dump-deserialized-decls">,
408 HelpText<"Dump declarations that are deserialized from PCH, for testing">;
Argyrios Kyrtzidis3e785932010-10-14 20:14:25 +0000409def error_on_deserialized_pch_decl : Separate<"-error-on-deserialized-decl">,
410 HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
Argyrios Kyrtzidis9a8cbc72011-10-28 22:54:24 +0000411def error_on_deserialized_pch_decl_EQ : Joined<"-error-on-deserialized-decl=">,
412 Alias<error_on_deserialized_pch_decl>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000413def static_define : Flag<"-static-define">,
414 HelpText<"Should __STATIC__ be defined">;
415def stack_protector : Separate<"-stack-protector">,
416 HelpText<"Enable stack protectors">;
417def fvisibility : Separate<"-fvisibility">,
418 HelpText<"Default symbol visibility">;
419def ftemplate_depth : Separate<"-ftemplate-depth">,
420 HelpText<"Maximum depth of recursive template instantiation">;
Richard Smithc18c4232011-11-21 19:36:32 +0000421def fconstexpr_depth : Separate<"-fconstexpr-depth">,
422 HelpText<"Maximum depth of recursive constexpr function calls">;
Chandler Carruth50465d12011-04-23 06:30:43 +0000423def fconst_strings : Flag<"-fconst-strings">,
424 HelpText<"Use a const qualified type for string literals in C and ObjC">;
425def fno_const_strings : Flag<"-fno-const-strings">,
426 HelpText<"Don't use a const qualified type for string literals in C and ObjC">;
Daniel Dunbarfb937b82010-04-15 15:06:22 +0000427def fno_bitfield_type_align : Flag<"-fno-bitfield-type-align">,
428 HelpText<"Ignore bit-field types when aligning structures">;
Peter Collingbourne207f4d82011-03-18 22:38:29 +0000429def ffake_address_space_map : Flag<"-ffake-address-space-map">,
430 HelpText<"Use a fake address space map; OpenCL testing purposes only">;
John McCalla5fc4722011-04-09 22:50:59 +0000431def funknown_anytype : Flag<"-funknown-anytype">,
432 HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">;
John McCall48218c62011-07-13 17:56:40 +0000433def fdebugger_support : Flag<"-fdebugger-support">,
434 HelpText<"Enable special debugger support behavior">;
Sean Callanan50a9a122012-02-04 01:29:37 +0000435def fdebugger_cast_result_to_id : Flag<"-fdebugger-cast-result-to-id">,
436 HelpText<"Enable casting unknown expression results to id">;
Ted Kremenekebcb57a2012-03-06 20:05:56 +0000437def fdebugger_objc_literal : Flag<"-fdebugger-objc-literal">,
Jordan Roseb13291a2012-07-19 18:10:18 +0000438 HelpText<"Enable special debugger support for Objective-C subscripting and literals">;
Chandler Carruth1cfe3c32011-04-23 09:27:53 +0000439def fdeprecated_macro : Flag<"-fdeprecated-macro">,
Chandler Carruthf8c247d2011-04-23 19:48:40 +0000440 HelpText<"Defines the __DEPRECATED macro">;
Chandler Carruth1cfe3c32011-04-23 09:27:53 +0000441def fno_deprecated_macro : Flag<"-fno-deprecated-macro">,
Chandler Carruthf8c247d2011-04-23 19:48:40 +0000442 HelpText<"Undefines the __DEPRECATED macro">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000443
444//===----------------------------------------------------------------------===//
445// Header Search Options
446//===----------------------------------------------------------------------===//
447
Daniel Dunbara268fc02011-10-11 18:20:10 +0000448def nostdsysteminc : Flag<"-nostdsysteminc">,
449 HelpText<"Disable standard system #include directories">;
Douglas Gregorb86b8dc2011-11-15 19:35:01 +0000450def fmodule_name : Joined<"-fmodule-name=">,
451 MetaVarName<"<name>">,
452 HelpText<"Specify the name of the module to build">;
Douglas Gregor6e975c42011-09-13 23:15:45 +0000453def fdisable_module_hash : Flag<"-fdisable-module-hash">,
454 HelpText<"Disable the module hash">;
Benjamin Kramer47adebe2011-09-22 21:41:16 +0000455def c_isystem : JoinedOrSeparate<"-c-isystem">, MetaVarName<"<directory>">,
456 HelpText<"Add directory to the C SYSTEM include search path">;
Benjamin Kramer47adebe2011-09-22 21:41:16 +0000457def objc_isystem : JoinedOrSeparate<"-objc-isystem">,
458 MetaVarName<"<directory>">,
459 HelpText<"Add directory to the ObjC SYSTEM include search path">;
460def objcxx_isystem : JoinedOrSeparate<"-objcxx-isystem">,
461 MetaVarName<"<directory>">,
462 HelpText<"Add directory to the ObjC++ SYSTEM include search path">;
Chandler Carruthac2bc4d2011-11-05 08:30:29 +0000463def internal_isystem : JoinedOrSeparate<"-internal-isystem">,
464 MetaVarName<"<directory>">,
465 HelpText<"Add directory to the internal system include search path; these "
466 "are assumed to not be user-provided and are used to model system "
467 "and standard headers' paths.">;
468def internal_externc_isystem : JoinedOrSeparate<"-internal-externc-isystem">,
469 MetaVarName<"<directory>">,
470 HelpText<"Add directory to the internal system include search path with "
471 "implicit extern \"C\" semantics; these are assumed to not be "
472 "user-provided and are used to model system and standard headers' "
473 "paths.">;
Richard Smithf122a132012-06-13 20:27:03 +0000474def isystem_prefix : JoinedOrSeparate<"-isystem-prefix">,
475 MetaVarName<"<prefix>">,
476 HelpText<"Treat all #include paths starting with <prefix> as including a "
477 "system header.">;
478def ino_system_prefix : JoinedOrSeparate<"-ino-system-prefix">,
479 MetaVarName<"<prefix>">,
480 HelpText<"Treat all #include paths starting with <prefix> as not including a "
481 "system header.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000482
483//===----------------------------------------------------------------------===//
484// Preprocessor Options
485//===----------------------------------------------------------------------===//
486
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000487def include_pth : Separate<"-include-pth">, MetaVarName<"<file>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000488 HelpText<"Include file before parsing">;
Argyrios Kyrtzidisb0f4b9a2011-03-09 17:21:42 +0000489def chain_include : Separate<"-chain-include">, MetaVarName<"<file>">,
490 HelpText<"Include and chain a header file after turning it into PCH">;
Douglas Gregorf4f6c9d2010-07-26 21:36:20 +0000491def preamble_bytes_EQ : Joined<"-preamble-bytes=">,
Douglas Gregor3d398aa2010-07-26 16:29:14 +0000492 HelpText<"Assume that the precompiled header is a precompiled preamble "
493 "covering the first N bytes of the main file">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000494def token_cache : Separate<"-token-cache">, MetaVarName<"<path>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000495 HelpText<"Use specified token cache file">;
Douglas Gregor94dc8f62010-03-19 16:15:56 +0000496def detailed_preprocessing_record : Flag<"-detailed-preprocessing-record">,
497 HelpText<"include a detailed record of preprocessing actions">;
Peter Collingbourne61e07862010-12-04 01:50:45 +0000498
499//===----------------------------------------------------------------------===//
500// OpenCL Options
501//===----------------------------------------------------------------------===//
502
503def cl_opt_disable : Flag<"-cl-opt-disable">,
504 HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">;
Peter Collingbourne09821362010-12-04 01:50:56 +0000505def cl_single_precision_constant : Flag<"-cl-single-precision-constant">,
506 HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">;
Peter Collingbourne5d729a32010-12-04 01:51:05 +0000507def cl_finite_math_only : Flag<"-cl-finite-math-only">,
508 HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">;
Peter Collingbourne5f67e132010-12-04 01:51:14 +0000509def cl_unsafe_math_optimizations : Flag<"-cl-unsafe-math-optimizations">,
510 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 +0000511def cl_fast_relaxed_math : Flag<"-cl-fast-relaxed-math">,
512 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 +0000513def cl_mad_enable : Flag<"-cl-mad-enable">,
514 HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">;
Peter Collingbourne91252d12010-12-04 01:51:40 +0000515def cl_std_EQ : Joined<"-cl-std=">,
516 HelpText<"OpenCL language standard to compile for">;
Peter Collingbourned51e43a2011-10-06 18:29:46 +0000517
518//===----------------------------------------------------------------------===//
519// CUDA Options
520//===----------------------------------------------------------------------===//
521
522def fcuda_is_device : Flag<"-fcuda-is-device">,
523 HelpText<"Generate code for CUDA device">;
James Molloybfd7a522012-05-01 14:57:16 +0000524
525} // let Flags = [CC1Option]