blob: 8089a0a7327fd936f199bb613a777356cd9ab39a [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">,
Ted Kremenek318cc3c2012-08-30 05:49:16 +0000123 HelpText<"Choose analyzer options to enable">;
Ted Kremenek7b73e082012-08-29 05:55:00 +0000124
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000125//===----------------------------------------------------------------------===//
Fariborz Jahanianb5c6bab2012-01-25 00:20:29 +0000126// Migrator Options
127//===----------------------------------------------------------------------===//
128def migrator_no_nsalloc_error : Flag<"-no-ns-alloc-error">,
129 HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">;
130
Fariborz Jahanian26f0e4e2012-01-26 00:08:04 +0000131def migrator_no_finalize_removal : Flag<"-no-finalize-removal">,
132 HelpText<"Do not remove finalize method in gc mode">;
133
Fariborz Jahanianb5c6bab2012-01-25 00:20:29 +0000134//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000135// CodeGen Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000136//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000137
138def disable_llvm_optzns : Flag<"-disable-llvm-optzns">,
139 HelpText<"Don't run LLVM optimization passes">;
John McCall824e19e2010-02-12 23:47:27 +0000140def disable_llvm_verifier : Flag<"-disable-llvm-verifier">,
141 HelpText<"Don't run the LLVM IR verifier pass">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000142def disable_red_zone : Flag<"-disable-red-zone">,
143 HelpText<"Do not emit code that uses the red zone.">;
Nick Lewycky7c4fd912011-10-21 02:32:14 +0000144def fdebug_compilation_dir : Separate<"-fdebug-compilation-dir">,
145 HelpText<"The compilation directory to embed in the debug info.">;
Daniel Dunbarf2d8b9f2009-12-18 02:43:17 +0000146def dwarf_debug_flags : Separate<"-dwarf-debug-flags">,
147 HelpText<"The string to embed in the Dwarf debug flags record.">;
John McCall32096692011-03-18 02:56:14 +0000148def fforbid_guard_variables : Flag<"-fforbid-guard-variables">,
149 HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
Chad Rosier005af272012-05-16 21:19:55 +0000150def no_implicit_float : Flag<"-no-implicit-float">,
151 HelpText<"Don't generate implicit floating point instructions">;
Anders Carlsson824d7ea2010-02-11 08:02:13 +0000152def fdump_vtable_layouts : Flag<"-fdump-vtable-layouts">,
153 HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
Nick Lewyckye8ba8d72011-04-21 23:44:07 +0000154def femit_coverage_notes : Flag<"-femit-coverage-notes">,
155 HelpText<"Emit a gcov coverage notes file when compiling.">;
156def femit_coverage_data: Flag<"-femit-coverage-data">,
157 HelpText<"Instrument the program to emit gcov coverage data when run.">;
Nick Lewycky3dc05412011-05-05 00:08:20 +0000158def coverage_file : Separate<"-coverage-file">,
159 HelpText<"Emit coverage data to this filename. The extension will be replaced.">;
160def coverage_file_EQ : Joined<"-coverage-file=">, Alias<coverage_file>;
Daniel Dunbare26bdb92011-06-21 18:54:46 +0000161def fuse_register_sized_bitfield_access: Flag<"-fuse-register-sized-bitfield-access">,
162 HelpText<"Use register sized accesses to bit-fields, when possible.">;
Dan Gohman4d5625e2010-10-14 22:36:56 +0000163def relaxed_aliasing : Flag<"-relaxed-aliasing">,
Devang Patelbe570122010-10-15 18:23:36 +0000164 HelpText<"Turn off Type Based Alias Analysis">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000165def masm_verbose : Flag<"-masm-verbose">,
166 HelpText<"Generate verbose assembly output">;
167def mcode_model : Separate<"-mcode-model">,
168 HelpText<"The code model to use">;
169def mdebug_pass : Separate<"-mdebug-pass">,
170 HelpText<"Enable additional debug output">;
171def mdisable_fp_elim : Flag<"-mdisable-fp-elim">,
172 HelpText<"Disable frame pointer elimination optimization">;
Nick Lewycky1db772b2012-01-23 08:29:12 +0000173def mdisable_tail_calls : Flag<"-mdisable-tail-calls">,
174 HelpText<"Disable tail call optimization, keeping the call stack accurate">;
Daniel Dunbar001f6282011-12-09 23:41:18 +0000175def menable_no_infinities : Flag<"-menable-no-infs">,
176 HelpText<"Allow optimization to assume there are no infinities.">;
177def menable_no_nans : Flag<"-menable-no-nans">,
178 HelpText<"Allow optimization to assume there are no NaNs.">;
Chandler Carruthabf07a72012-01-02 14:19:45 +0000179def menable_unsafe_fp_math : Flag<"-menable-unsafe-fp-math">,
180 HelpText<"Allow unsafe floating-point math optimizations which may decrease "
181 "precision">;
Daniel Dunbar87667aa2009-12-08 19:49:51 +0000182def mfloat_abi : Separate<"-mfloat-abi">,
Daniel Dunbar3b315262009-11-30 08:42:00 +0000183 HelpText<"The float ABI to use">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000184def mlimit_float_precision : Separate<"-mlimit-float-precision">,
185 HelpText<"Limit float precision to the given value">;
Nick Lewyckyc3b90142011-06-21 00:14:18 +0000186def mno_exec_stack : Flag<"-mnoexecstack">,
187 HelpText<"Mark the file as not needing an executable stack">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000188def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">,
189 HelpText<"Do not put zero initialized data in the BSS">;
Daniel Dunbar3c66d302011-03-22 16:48:17 +0000190def backend_option : Separate<"-backend-option">,
191 HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
Daniel Dunbar17d3fea2011-02-09 17:54:19 +0000192def mregparm : Separate<"-mregparm">,
193 HelpText<"Limit the number of registers available for integer arguments">;
Daniel Dunbar96932322011-03-28 22:49:28 +0000194def msave_temp_labels : Flag<"-msave-temp-labels">,
195 HelpText<"(integrated-as) Save temporary labels">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000196def mrelocation_model : Separate<"-mrelocation-model">,
197 HelpText<"The relocation model to use">;
198def munwind_tables : Flag<"-munwind-tables">,
199 HelpText<"Generate unwinding tables for all functions">;
Rafael Espindola8af669f2012-06-19 01:26:10 +0000200def fuse_init_array : Flag<"-fuse-init-array">,
201 HelpText<"Use .init_array instead of .ctors">;
John McCalld46f9852010-02-19 01:32:20 +0000202def mconstructor_aliases : Flag<"-mconstructor-aliases">,
203 HelpText<"Emit complete constructors and destructors as aliases when possible">;
Peter Collingbourne22a7dfe2011-10-30 17:30:44 +0000204def mlink_bitcode_file : Separate<"-mlink-bitcode-file">,
205 HelpText<"Link the given bitcode file before performing optimizations.">;
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000206
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000207//===----------------------------------------------------------------------===//
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000208// Dependency Output Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000209//===----------------------------------------------------------------------===//
210
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000211def sys_header_deps : Flag<"-sys-header-deps">,
212 HelpText<"Include system headers in dependency output">;
Daniel Dunbarb34d69b2011-02-02 21:11:31 +0000213def header_include_file : Separate<"-header-include-file">,
214 HelpText<"Filename (or -) to write header include output to">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000215
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000216//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000217// Diagnostic Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000218//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000219
220def dump_build_information : Separate<"-dump-build-information">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000221 MetaVarName<"<filename>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000222 HelpText<"output a dump of some build information to a file">;
Daniel Dunbar08c66952011-04-07 18:11:14 +0000223def diagnostic_log_file : Separate<"-diagnostic-log-file">,
224 HelpText<"Filename (or -) to log diagnostics to">;
Ted Kremenek36f6e302011-11-11 00:07:43 +0000225def diagnostic_serialized_file : Separate<"-serialize-diagnostic-file">,
Ted Kremenek78002122011-10-29 00:12:39 +0000226 MetaVarName<"<filename>">,
227 HelpText<"File for serializing diagnostics in a binary format">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000228
Douglas Gregorc9471b02011-05-21 17:07:29 +0000229def fdiagnostics_format : Separate<"-fdiagnostics-format">,
230 HelpText<"Change diagnostic formatting to match IDE and command line tools">;
Chris Lattner6fbe8392010-05-04 21:55:25 +0000231def fdiagnostics_show_category : Separate<"-fdiagnostics-show-category">,
232 HelpText<"Print diagnostic category">;
Chris Lattner124fca52010-01-09 21:54:33 +0000233def ftabstop : Separate<"-ftabstop">, MetaVarName<"<N>">,
234 HelpText<"Set the tab stop distance.">;
Chris Lattnerc1002142010-04-07 20:37:06 +0000235def ferror_limit : Separate<"-ferror-limit">, MetaVarName<"<N>">,
236 HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
Douglas Gregor6c1cb992010-05-04 17:13:42 +0000237def fmacro_backtrace_limit : Separate<"-fmacro-backtrace-limit">, MetaVarName<"<N>">,
Chandler Carruthb29a6102011-07-15 00:04:38 +0000238 HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
Douglas Gregor575cf372010-04-20 07:18:24 +0000239def ftemplate_backtrace_limit : Separate<"-ftemplate-backtrace-limit">, MetaVarName<"<N>">,
240 HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
Richard Smith08d6e032011-12-16 19:06:07 +0000241def fconstexpr_backtrace_limit : Separate<"-fconstexpr-backtrace-limit">, MetaVarName<"<N>">,
242 HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000243def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000244 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000245def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">,
246 HelpText<"Silence ObjC rewriting warnings">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000247
248//===----------------------------------------------------------------------===//
249// Frontend Options
250//===----------------------------------------------------------------------===//
251
Daniel Dunbar8ff5b282009-12-11 23:00:49 +0000252// This isn't normally used, it is just here so we can parse a
253// CompilerInvocation out of a driver-derived argument vector.
254def cc1 : Flag<"-cc1">;
255
Douglas Gregor9bed8792010-02-09 19:21:46 +0000256def ast_merge : Separate<"-ast-merge">,
257 MetaVarName<"<ast file>">,
258 HelpText<"Merge the given AST file into the translation unit being compiled.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000259def code_completion_at : Separate<"-code-completion-at">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000260 MetaVarName<"<file>:<line>:<column>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000261 HelpText<"Dump code-completion information at a location">;
Daniel Dunbare14b5f52009-12-03 05:11:16 +0000262def remap_file : Separate<"-remap-file">,
263 MetaVarName<"<from>;<to>">,
264 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +0000265def code_completion_at_EQ : Joined<"-code-completion-at=">,
266 Alias<code_completion_at>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000267def code_completion_macros : Flag<"-code-completion-macros">,
268 HelpText<"Include macros in code-completion results">;
Douglas Gregord8e8a582010-05-25 21:41:55 +0000269def code_completion_patterns : Flag<"-code-completion-patterns">,
270 HelpText<"Include code patterns in code-completion results">;
Douglas Gregor8071e422010-08-15 06:18:01 +0000271def no_code_completion_globals : Flag<"-no-code-completion-globals">,
272 HelpText<"Do not include global declarations in code-completion results.">;
Dmitri Gribenkod99ef532012-07-02 17:35:10 +0000273def code_completion_brief_comments : Flag<"-code-completion-brief-comments">,
274 HelpText<"Include brief documentation comments in code-completion results.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000275def disable_free : Flag<"-disable-free">,
276 HelpText<"Disable freeing of memory on exit">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000277def load : Separate<"-load">, MetaVarName<"<dsopath>">,
Daniel Dunbarefba2272009-12-03 05:11:05 +0000278 HelpText<"Load the named plugin (dynamic shared object)">;
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000279def plugin : Separate<"-plugin">, MetaVarName<"<name>">,
Nico Weber5aa74af2011-01-25 20:34:14 +0000280 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 +0000281def plugin_arg : JoinedAndSeparate<"-plugin-arg-">,
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000282 MetaVarName<"<name> <arg>">,
283 HelpText<"Pass <arg> to plugin <name>">;
Nico Weber5aa74af2011-01-25 20:34:14 +0000284def add_plugin : Separate<"-add-plugin">, MetaVarName<"<name>">,
285 HelpText<"Use the named plugin action in addition to the default action">;
Daniel Dunbar8b9adfe2009-12-15 00:06:45 +0000286def resource_dir : Separate<"-resource-dir">,
287 HelpText<"The directory which holds the compiler resource files">;
Daniel Dunbar9b5e9ae2009-12-03 07:01:58 +0000288def version : Flag<"-version">,
289 HelpText<"Print the compiler version">;
Alexander Kornienkoe34a0522012-07-26 16:01:23 +0000290def ast_dump_filter : Separate<"-ast-dump-filter">,
291 MetaVarName<"<dump_filter>">,
292 HelpText<"Use with -ast-dump or -ast-print to dump/print only AST declaration"
Alexander Kornienko171af642012-07-31 09:37:40 +0000293 " nodes having a certain substring in a qualified name. Use"
294 " -ast-list to list all filterable declaration node names.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000295
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000296let Group = Action_Group in {
297
298def Eonly : Flag<"-Eonly">,
299 HelpText<"Just run preprocessor, no output (for timings)">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000300def dump_raw_tokens : Flag<"-dump-raw-tokens">,
301 HelpText<"Lex file in raw mode and dump raw tokens">;
302def analyze : Flag<"-analyze">,
303 HelpText<"Run static analysis engine">;
304def dump_tokens : Flag<"-dump-tokens">,
305 HelpText<"Run preprocessor, dump internal rep of tokens">;
Daniel Dunbar27585952010-03-19 19:44:04 +0000306def init_only : Flag<"-init-only">,
307 HelpText<"Only execute frontend initialization">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000308def fixit : Flag<"-fixit">,
309 HelpText<"Apply fix-it advice to the input source">;
Nick Lewyckyba5f6ec2010-04-24 01:30:46 +0000310def fixit_EQ : Joined<"-fixit=">,
311 HelpText<"Apply fix-it advice creating a file with the given suffix">;
Douglas Gregorf033f1d2010-07-20 20:18:03 +0000312def print_preamble : Flag<"-print-preamble">,
313 HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
314 " precompiled headers.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000315def emit_html : Flag<"-emit-html">,
316 HelpText<"Output input source as HTML">;
317def ast_print : Flag<"-ast-print">,
318 HelpText<"Build ASTs and then pretty-print them">;
Alexander Kornienko171af642012-07-31 09:37:40 +0000319def ast_list : Flag<"-ast-list">,
320 HelpText<"Build ASTs and print the list of declaration node qualified names">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000321def ast_dump : Flag<"-ast-dump">,
322 HelpText<"Build ASTs and then debug dump them">;
John McCallf3514242010-11-24 11:21:45 +0000323def ast_dump_xml : Flag<"-ast-dump-xml">,
324 HelpText<"Build ASTs and then debug dump them in a verbose XML format">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000325def ast_view : Flag<"-ast-view">,
326 HelpText<"Build ASTs and view them with GraphViz">;
327def print_decl_contexts : Flag<"-print-decl-contexts">,
328 HelpText<"Print DeclContexts and their Decls">;
Douglas Gregor467dc882011-08-25 22:30:56 +0000329def emit_module : Flag<"-emit-module">,
Douglas Gregor66490142011-11-29 22:42:06 +0000330 HelpText<"Generate pre-compiled module file from a module map">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000331def emit_pth : Flag<"-emit-pth">,
332 HelpText<"Generate pre-tokenized header file">;
333def emit_pch : Flag<"-emit-pch">,
334 HelpText<"Generate pre-compiled header file">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000335def emit_llvm_bc : Flag<"-emit-llvm-bc">,
336 HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
337def emit_llvm_only : Flag<"-emit-llvm-only">,
338 HelpText<"Build ASTs and convert to LLVM, discarding output">;
Daniel Dunbar32148ce2010-05-25 18:41:01 +0000339def emit_codegen_only : Flag<"-emit-codegen-only">,
340 HelpText<"Generate machine code, but discard output">;
Daniel Dunbarda1573f2010-02-03 01:18:43 +0000341def emit_obj : Flag<"-emit-obj">,
342 HelpText<"Emit native object files">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000343def rewrite_test : Flag<"-rewrite-test">,
344 HelpText<"Rewriter playground">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000345def rewrite_macros : Flag<"-rewrite-macros">,
346 HelpText<"Expand macros without full preprocessing">;
Ted Kremenek30660a82012-03-06 20:06:33 +0000347def migrate : Flag<"-migrate">,
348 HelpText<"Migrate source code">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000349}
350
Ted Kremenek30660a82012-03-06 20:06:33 +0000351def mt_migrate_directory : Separate<"-mt-migrate-directory">,
352 HelpText<"Directory for temporary files produced during ARC or ObjC migration">;
John McCallf85e1932011-06-15 23:02:42 +0000353def arcmt_check : Flag<"-arcmt-check">,
354 HelpText<"Check for ARC migration issues that need manual handling">;
355def arcmt_modify : Flag<"-arcmt-modify">,
356 HelpText<"Apply modifications to files to conform to ARC">;
Argyrios Kyrtzidis69325d52011-07-09 20:00:58 +0000357def arcmt_migrate : Flag<"-arcmt-migrate">,
358 HelpText<"Apply modifications and produces temporary files that conform to ARC">;
Argyrios Kyrtzidis389db162010-11-03 22:45:23 +0000359
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000360def relocatable_pch : Flag<"-relocatable-pch">,
361 HelpText<"Whether to build a relocatable precompiled header">;
362def print_stats : Flag<"-print-stats">,
363 HelpText<"Print performance metrics and statistics">;
Anders Carlsson46116ce2010-04-10 19:09:13 +0000364def fdump_record_layouts : Flag<"-fdump-record-layouts">,
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000365 HelpText<"Dump record layout information">;
Douglas Gregor453dbcb2012-01-26 07:55:45 +0000366def fdump_record_layouts_simple : Flag<"-fdump-record-layouts-simple">,
367 HelpText<"Dump record layout information in a simple form used for testing">;
Nick Lewycky1450f262010-08-13 17:31:00 +0000368def fix_what_you_can : Flag<"-fix-what-you-can">,
369 HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
Argyrios Kyrtzidis61d679a2012-01-26 02:40:48 +0000370def fix_only_warnings : Flag<"-fix-only-warnings">,
371 HelpText<"Apply fix-it advice only for warnings, not errors">;
372def fixit_recompile : Flag<"-fixit-recompile">,
373 HelpText<"Apply fix-it changes and recompile">;
374def fixit_to_temp : Flag<"-fixit-to-temporary">,
375 HelpText<"Apply fix-it changes to temporary files">;
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000376
Douglas Gregor453dbcb2012-01-26 07:55:45 +0000377def foverride_record_layout_EQ : Joined<"-foverride-record-layout=">,
378 HelpText<"Override record layouts with those in the given file">;
379
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000380//===----------------------------------------------------------------------===//
381// Language Options
382//===----------------------------------------------------------------------===//
383
John McCall13db5cf2011-09-09 20:41:01 +0000384def fblocks_runtime_optional : Flag<"-fblocks-runtime-optional">,
385 HelpText<"Weakly link in the blocks runtime">;
Daniel Dunbar73482882010-02-10 18:48:44 +0000386def fsjlj_exceptions : Flag<"-fsjlj-exceptions">,
387 HelpText<"Use SjLj style exceptions">;
John McCall279b5eb2010-08-12 23:36:15 +0000388def fhidden_weak_vtables : Flag<"-fhidden-weak-vtables">,
389 HelpText<"Generate weak vtables and RTTI with hidden visibility">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000390def main_file_name : Separate<"-main-file-name">,
391 HelpText<"Main file name to use for debug info">;
Daniel Dunbarefb0fa92010-03-20 04:15:41 +0000392def fno_signed_char : Flag<"-fno-signed-char">,
393 HelpText<"Char is unsigned">;
Abramo Bagnara5b86ffd2012-09-05 17:30:57 +0000394def fno_wchar : Flag<"-fno-wchar">,
395 HelpText<"Disable C++ builtin type wchar_t">;
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]