blob: 7e61b6c6ebbd35db08d65578f4c7d3b92eca6f07 [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
14// Include the common option parsing interfaces.
15include "OptParser.td"
16
Daniel Dunbar33a33d82009-11-24 00:54:16 +000017//===----------------------------------------------------------------------===//
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000018// Target Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +000019//===----------------------------------------------------------------------===//
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000020
Charles Davis98b7c5c2010-06-11 01:06:47 +000021def cxx_abi : Separate<"-cxx-abi">,
22 HelpText<"Target a particular C++ ABI type">;
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000023def target_abi : Separate<"-target-abi">,
24 HelpText<"Target a particular ABI type">;
Daniel Dunbar38b48af2009-12-18 06:30:12 +000025def target_cpu : Separate<"-target-cpu">,
26 HelpText<"Target a specific cpu type">;
Daniel Dunbar31db76c2009-11-20 01:46:44 +000027def target_feature : Separate<"-target-feature">,
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000028 HelpText<"Target specific attributes">;
Daniel Dunbar39065a52010-08-11 23:07:42 +000029def target_linker_version : Separate<"-target-linker-version">,
30 HelpText<"Target linker version">;
Daniel Dunbar31db76c2009-11-20 01:46:44 +000031def triple : Separate<"-triple">,
Daniel Dunbar8adfcff2009-11-19 07:19:04 +000032 HelpText<"Specify target triple (e.g. i686-apple-darwin9)">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +000033def triple_EQ : Joined<"-triple=">, Alias<triple>;
Daniel Dunbar50a44872009-11-20 17:23:30 +000034
Daniel Dunbar33a33d82009-11-24 00:54:16 +000035//===----------------------------------------------------------------------===//
Daniel Dunbare2814d82009-11-22 22:08:20 +000036// Analyzer Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +000037//===----------------------------------------------------------------------===//
Daniel Dunbare2814d82009-11-22 22:08:20 +000038
Ted Kremenek9b823e82010-08-03 00:09:51 +000039def analysis_UnoptimizedCFG : Flag<"-unoptimized-cfg">,
Ted Kremenekc9c6b902010-08-20 05:53:47 +000040 HelpText<"Generate unoptimized CFGs for all analyses">;
Marcin Swiderski9121ba22010-09-30 07:41:24 +000041def analysis_CFGAddImplicitDtors : Flag<"-cfg-add-implicit-dtors">,
42 HelpText<"Add C++ implicit destructors to CFGs for all analyses">;
43def analysis_CFGAddInitializers : Flag<"-cfg-add-initializers">,
44 HelpText<"Add C++ initializers to CFGs for all analyses">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000045
46def analyzer_store : Separate<"-analyzer-store">,
47 HelpText<"Source Code Analysis - Abstract Memory Store Models">;
48def analyzer_store_EQ : Joined<"-analyzer-store=">, Alias<analyzer_store>;
49
50def analyzer_constraints : Separate<"-analyzer-constraints">,
51 HelpText<"Source Code Analysis - Symbolic Constraint Engines">;
52def analyzer_constraints_EQ : Joined<"-analyzer-constraints=">,
53 Alias<analyzer_constraints>;
54
55def analyzer_output : Separate<"-analyzer-output">,
56 HelpText<"Source Code Analysis - Output Options">;
57def analyzer_output_EQ : Joined<"-analyzer-output=">,
58 Alias<analyzer_output>;
59
Anna Zaksd3095282011-09-30 02:03:00 +000060def analyzer_purge : Separate<"-analyzer-purge">,
61 HelpText<"Source Code Analysis - Dead Symbol Removal Frequency">;
62def analyzer_purge_EQ : Joined<"-analyzer-purge=">, Alias<analyzer_purge>;
63
Daniel Dunbare2814d82009-11-22 22:08:20 +000064def analyzer_opt_analyze_headers : Flag<"-analyzer-opt-analyze-headers">,
65 HelpText<"Force the static analyzer to analyze functions defined in header files">;
Ted Kremenekfc576512009-12-07 22:06:12 +000066def analyzer_opt_analyze_nested_blocks : Flag<"-analyzer-opt-analyze-nested-blocks">,
Michael J. Spencer20249a12010-10-21 03:16:25 +000067 HelpText<"Analyze the definitions of blocks in addition to functions">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000068def analyzer_display_progress : Flag<"-analyzer-display-progress">,
69 HelpText<"Emit verbose output about the analyzer's progress">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000070def analyze_function : Separate<"-analyze-function">,
71 HelpText<"Run analysis on specific function">;
72def analyze_function_EQ : Joined<"-analyze-function=">, Alias<analyze_function>;
73def analyzer_eagerly_assume : Flag<"-analyzer-eagerly-assume">,
74 HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">;
Ted Kremenekd767d812011-02-09 01:27:33 +000075def analyzer_no_eagerly_trim_egraph : Flag<"-analyzer-no-eagerly-trim-egraph">,
76 HelpText<"Don't eagerly remove uninteresting ExplodedNodes from the ExplodedGraph">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000077def trim_egraph : Flag<"-trim-egraph">,
78 HelpText<"Only show error-related paths in the analysis graph">;
79def analyzer_viz_egraph_graphviz : Flag<"-analyzer-viz-egraph-graphviz">,
80 HelpText<"Display exploded graph using GraphViz">;
81def analyzer_viz_egraph_ubigraph : Flag<"-analyzer-viz-egraph-ubigraph">,
82 HelpText<"Display exploded graph using Ubigraph">;
Zhongxing Xu7b99d122010-05-06 02:59:29 +000083def analyzer_inline_call : Flag<"-analyzer-inline-call">,
84 HelpText<"Experimental transfer function inlining callees when its definition is available.">;
Zhongxing Xuc09289d2010-04-13 06:44:31 +000085def analyzer_max_nodes : Separate<"-analyzer-max-nodes">,
Tom Carecf9ce132010-09-29 23:48:13 +000086 HelpText<"The maximum number of nodes the analyzer can generate (150000 default, 0 = no limit)">;
Zhongxing Xu6362b892010-05-18 00:28:37 +000087def analyzer_max_loop : Separate<"-analyzer-max-loop">,
88 HelpText<"The maximum number of times the analyzer will go through a loop">;
Daniel Dunbare2814d82009-11-22 22:08:20 +000089
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +000090def analyzer_checker : Separate<"-analyzer-checker">,
91 HelpText<"Choose analyzer checkers to enable">;
92def analyzer_checker_EQ : Joined<"-analyzer-checker=">,
93 Alias<analyzer_checker>;
94
95def analyzer_disable_checker : Separate<"-analyzer-disable-checker">,
96 HelpText<"Choose analyzer checkers to disable">;
97def analyzer_disable_checker_EQ : Joined<"-analyzer-disable-checker=">,
98 Alias<analyzer_disable_checker>;
99
Argyrios Kyrtzidis116f3642011-02-25 00:09:51 +0000100def analyzer_checker_help : Flag<"-analyzer-checker-help">,
101 HelpText<"Display the list of analyzer checkers that are available">;
102
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000103//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000104// CodeGen Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000105//===----------------------------------------------------------------------===//
Daniel Dunbar50a44872009-11-20 17:23:30 +0000106
107def disable_llvm_optzns : Flag<"-disable-llvm-optzns">,
108 HelpText<"Don't run LLVM optimization passes">;
John McCall824e19e2010-02-12 23:47:27 +0000109def disable_llvm_verifier : Flag<"-disable-llvm-verifier">,
110 HelpText<"Don't run the LLVM IR verifier pass">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000111def disable_red_zone : Flag<"-disable-red-zone">,
112 HelpText<"Do not emit code that uses the red zone.">;
Nick Lewycky7c4fd912011-10-21 02:32:14 +0000113def fdebug_compilation_dir : Separate<"-fdebug-compilation-dir">,
114 HelpText<"The compilation directory to embed in the debug info.">;
Daniel Dunbarf2d8b9f2009-12-18 02:43:17 +0000115def dwarf_debug_flags : Separate<"-dwarf-debug-flags">,
116 HelpText<"The string to embed in the Dwarf debug flags record.">;
John McCall32096692011-03-18 02:56:14 +0000117def fforbid_guard_variables : Flag<"-fforbid-guard-variables">,
118 HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000119def g : Flag<"-g">, HelpText<"Generate source level debug information">;
Chad Rosieraf6fbe42011-08-25 20:17:19 +0000120def fno_dwarf2_cfi_asm : Flag<"-fno-dwarf2-cfi-asm">,
121 HelpText<"Don't use the cfi directives">;
Nick Lewyckyea523d72011-10-17 23:05:52 +0000122def fno_dwarf_directory_asm : Flag<"-fno-dwarf-directory-asm">,
123 HelpText<"Don't separate directory and filename in .file directives">;
Mike Stump9c276ae2009-12-12 01:27:46 +0000124def fcatch_undefined_behavior : Flag<"-fcatch-undefined-behavior">,
Chad Rosieraf6fbe42011-08-25 20:17:19 +0000125 HelpText<"Generate runtime checks for undefined behavior.">;
Devang Patelc69e1cf2010-09-30 19:05:55 +0000126def flimit_debug_info : Flag<"-flimit-debug-info">,
127 HelpText<"Limit debug information produced to reduce size of debug binary">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000128def fno_common : Flag<"-fno-common">,
129 HelpText<"Compile common globals like normal definitions">;
130def no_implicit_float : Flag<"-no-implicit-float">,
131 HelpText<"Don't generate implicit floating point instructions (x86-only)">;
Chris Lattner7255a2d2010-06-22 00:03:40 +0000132def finstrument_functions : Flag<"-finstrument-functions">,
133 HelpText<"Generate calls to instrument function entry and exit">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000134def fno_merge_all_constants : Flag<"-fno-merge-all-constants">,
135 HelpText<"Disallow merging of constants.">;
Anders Carlssona508b7d2010-02-06 23:23:06 +0000136def fno_threadsafe_statics : Flag<"-fno-threadsafe-statics">,
137 HelpText<"Do not emit code to make initialization of local statics thread safe">;
Anders Carlsson824d7ea2010-02-11 08:02:13 +0000138def fdump_vtable_layouts : Flag<"-fdump-vtable-layouts">,
139 HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
Chris Lattnerbbea7162010-04-13 00:38:24 +0000140def ffunction_sections : Flag<"-ffunction-sections">,
141 HelpText<"Place each function in its own section (ELF Only)">;
142def fdata_sections : Flag<"-fdata-sections">,
143 HelpText<"Place each data in its own section (ELF Only)">;
Eric Christopherf84d4092010-08-07 23:08:14 +0000144def funroll_loops : Flag<"-funroll-loops">,
145 HelpText<"Turn on loop unroller">;
Nick Lewyckye8ba8d72011-04-21 23:44:07 +0000146def femit_coverage_notes : Flag<"-femit-coverage-notes">,
147 HelpText<"Emit a gcov coverage notes file when compiling.">;
148def femit_coverage_data: Flag<"-femit-coverage-data">,
149 HelpText<"Instrument the program to emit gcov coverage data when run.">;
Nick Lewycky3dc05412011-05-05 00:08:20 +0000150def coverage_file : Separate<"-coverage-file">,
151 HelpText<"Emit coverage data to this filename. The extension will be replaced.">;
152def coverage_file_EQ : Joined<"-coverage-file=">, Alias<coverage_file>;
Daniel Dunbare26bdb92011-06-21 18:54:46 +0000153def fuse_register_sized_bitfield_access: Flag<"-fuse-register-sized-bitfield-access">,
154 HelpText<"Use register sized accesses to bit-fields, when possible.">;
Dan Gohman4d5625e2010-10-14 22:36:56 +0000155def relaxed_aliasing : Flag<"-relaxed-aliasing">,
Devang Patelbe570122010-10-15 18:23:36 +0000156 HelpText<"Turn off Type Based Alias Analysis">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000157def masm_verbose : Flag<"-masm-verbose">,
158 HelpText<"Generate verbose assembly output">;
159def mcode_model : Separate<"-mcode-model">,
160 HelpText<"The code model to use">;
161def mdebug_pass : Separate<"-mdebug-pass">,
162 HelpText<"Enable additional debug output">;
163def mdisable_fp_elim : Flag<"-mdisable-fp-elim">,
164 HelpText<"Disable frame pointer elimination optimization">;
Daniel Dunbar87667aa2009-12-08 19:49:51 +0000165def mfloat_abi : Separate<"-mfloat-abi">,
Daniel Dunbar3b315262009-11-30 08:42:00 +0000166 HelpText<"The float ABI to use">;
Chad Rosier1b906052011-08-26 00:26:29 +0000167def mno_global_merge : Flag<"-mno-global-merge">,
168 HelpText<"Disable merging of globals">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000169def mlimit_float_precision : Separate<"-mlimit-float-precision">,
170 HelpText<"Limit float precision to the given value">;
Nick Lewyckyc3b90142011-06-21 00:14:18 +0000171def mno_exec_stack : Flag<"-mnoexecstack">,
172 HelpText<"Mark the file as not needing an executable stack">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000173def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">,
174 HelpText<"Do not put zero initialized data in the BSS">;
Daniel Dunbar1ad66482010-07-01 01:31:45 +0000175def momit_leaf_frame_pointer : Flag<"-momit-leaf-frame-pointer">,
176 HelpText<"Omit frame pointer setup for leaf functions.">;
Daniel Dunbar87667aa2009-12-08 19:49:51 +0000177def msoft_float : Flag<"-msoft-float">,
Daniel Dunbar3b315262009-11-30 08:42:00 +0000178 HelpText<"Use software floating point">;
Daniel Dunbar3c66d302011-03-22 16:48:17 +0000179def backend_option : Separate<"-backend-option">,
180 HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
Daniel Dunbar17d3fea2011-02-09 17:54:19 +0000181def mregparm : Separate<"-mregparm">,
182 HelpText<"Limit the number of registers available for integer arguments">;
Daniel Dunbar4ecc9b72010-05-27 05:39:39 +0000183def mrelax_all : Flag<"-mrelax-all">,
Daniel Dunbar96932322011-03-28 22:49:28 +0000184 HelpText<"(integrated-as) Relax all machine instructions">;
185def msave_temp_labels : Flag<"-msave-temp-labels">,
186 HelpText<"(integrated-as) Save temporary labels">;
Roman Divackycfe9af22011-03-01 17:40:53 +0000187def mrtd: Flag<"-mrtd">,
188 HelpText<"Make StdCall calling convention the default">;
Daniel Dunbarf219e7c2009-11-29 07:18:39 +0000189def mrelocation_model : Separate<"-mrelocation-model">,
190 HelpText<"The relocation model to use">;
191def munwind_tables : Flag<"-munwind-tables">,
192 HelpText<"Generate unwinding tables for all functions">;
John McCalld46f9852010-02-19 01:32:20 +0000193def mconstructor_aliases : Flag<"-mconstructor-aliases">,
194 HelpText<"Emit complete constructors and destructors as aliases when possible">;
Douglas Gregor6f755502011-02-01 15:15:22 +0000195def mms_bitfields : Flag<"-mms-bitfields">,
196 HelpText<"Set the default structure layout to be compatible with the Microsoft compiler standard.">;
Eric Christopher1a584022011-05-02 21:18:22 +0000197def mstackrealign : Flag<"-mstackrealign">,
198 HelpText<"Force realign the stack at entry to every function.">;
Daniel Dunbar50a44872009-11-20 17:23:30 +0000199def O : Joined<"-O">, HelpText<"Optimization level">;
200def Os : Flag<"-Os">, HelpText<"Optimize for size">;
Bob Wilsona0fa2032011-04-29 22:49:50 +0000201def Oz : Flag<"-Oz">, HelpText<"Optimize for size, regardless of performance">;
Roman Divackybe4c8702011-02-10 16:52:03 +0000202def pg : Flag<"-pg">, HelpText<"Enable mcount instrumentation">;
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000203
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000204//===----------------------------------------------------------------------===//
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000205// Dependency Output Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000206//===----------------------------------------------------------------------===//
207
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000208def dependency_file : Separate<"-dependency-file">,
209 HelpText<"Filename (or -) to write dependency output to">;
210def 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">;
214def H : Flag<"-H">,
215 HelpText<"Show header includes and nesting depth">;
Chris Lattner3edbeb72010-03-29 17:55:58 +0000216def MQ : Separate<"-MQ">, HelpText<"Specify target to quote for dependency">;
Daniel Dunbar1bed0c32009-11-20 23:28:07 +0000217def MT : Separate<"-MT">, HelpText<"Specify target for dependency">;
218def MP : Flag<"-MP">,
219 HelpText<"Create phony target for each dependency (other than main file)">;
Peter Collingbournebb527862011-07-12 19:35:15 +0000220def MG : Flag<"-MG">, HelpText<"Add missing headers to dependency list">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000221
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000222//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000223// Diagnostic Options
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000224//===----------------------------------------------------------------------===//
Daniel Dunbar21affc02009-11-23 23:41:17 +0000225
226def dump_build_information : Separate<"-dump-build-information">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000227 MetaVarName<"<filename>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000228 HelpText<"output a dump of some build information to a file">;
Daniel Dunbar08c66952011-04-07 18:11:14 +0000229def diagnostic_log_file : Separate<"-diagnostic-log-file">,
230 HelpText<"Filename (or -) to log diagnostics to">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000231def fno_show_column : Flag<"-fno-show-column">,
232 HelpText<"Do not include column number on diagnostics">;
Douglas Gregorc9471b02011-05-21 17:07:29 +0000233def fshow_column : Flag<"-fshow-column">,
234 HelpText<"Include column number on diagnostics">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000235def fno_show_source_location : Flag<"-fno-show-source-location">,
236 HelpText<"Do not include source location information with diagnostics">;
Jeffrey Yasskin5edbdcc2010-06-11 05:57:47 +0000237def fshow_overloads_EQ : Joined<"-fshow-overloads=">,
238 HelpText<"Which overload candidates to show when overload resolution fails: "
239 "best|all; defaults to all">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000240def fno_caret_diagnostics : Flag<"-fno-caret-diagnostics">,
241 HelpText<"Do not include source line and caret with diagnostics">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000242def fno_diagnostics_fixit_info : Flag<"-fno-diagnostics-fixit-info">,
243 HelpText<"Do not include fixit information in diagnostics">;
Chandler Carruthabaca7a2011-03-27 01:50:55 +0000244def fno_diagnostics_show_note_include_stack :
245 Flag<"-fno-diagnostics-show-note-include-stack">,
246 HelpText<"Display include stacks for diagnostic notes">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000247def w : Flag<"-w">, HelpText<"Suppress all warnings">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000248def pedantic : Flag<"-pedantic">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000249def pedantic_errors : Flag<"-pedantic-errors">;
250
251// This gets all -W options, including -Werror, -W[no-]system-headers, etc. The
252// driver has stripped off -Wa,foo etc. The driver has also translated -W to
253// -Wextra, so we don't need to worry about it.
254def W : Joined<"-W">;
255
256def fdiagnostics_print_source_range_info : Flag<"-fdiagnostics-print-source-range-info">,
257 HelpText<"Print source range spans in numeric form">;
Douglas Gregor4786c152010-08-19 20:24:43 +0000258def fdiagnostics_parseable_fixits : Flag<"-fdiagnostics-parseable-fixits">,
259 HelpText<"Print fix-its in machine parseable form">;
Douglas Gregor7d2b8c12011-04-15 22:04:17 +0000260def fdiagnostics_show_name : Flag<"-fdiagnostics-show-name">,
261 HelpText<"Print diagnostic name">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000262def fdiagnostics_show_option : Flag<"-fdiagnostics-show-option">,
Douglas Gregor7d2b8c12011-04-15 22:04:17 +0000263 HelpText<"Print option name with mappable diagnostics">;
Douglas Gregorc9471b02011-05-21 17:07:29 +0000264def fdiagnostics_format : Separate<"-fdiagnostics-format">,
265 HelpText<"Change diagnostic formatting to match IDE and command line tools">;
Chris Lattner6fbe8392010-05-04 21:55:25 +0000266def fdiagnostics_show_category : Separate<"-fdiagnostics-show-category">,
267 HelpText<"Print diagnostic category">;
Chandler Carruthabaca7a2011-03-27 01:50:55 +0000268def fdiagnostics_show_note_include_stack :
269 Flag<"-fdiagnostics-show-note-include-stack">,
270 HelpText<"Display include stacks for diagnostic notes">;
Chris Lattner124fca52010-01-09 21:54:33 +0000271def ftabstop : Separate<"-ftabstop">, MetaVarName<"<N>">,
272 HelpText<"Set the tab stop distance.">;
Chris Lattnerc1002142010-04-07 20:37:06 +0000273def ferror_limit : Separate<"-ferror-limit">, MetaVarName<"<N>">,
274 HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
Douglas Gregor6c1cb992010-05-04 17:13:42 +0000275def fmacro_backtrace_limit : Separate<"-fmacro-backtrace-limit">, MetaVarName<"<N>">,
Chandler Carruthb29a6102011-07-15 00:04:38 +0000276 HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
Douglas Gregor575cf372010-04-20 07:18:24 +0000277def ftemplate_backtrace_limit : Separate<"-ftemplate-backtrace-limit">, MetaVarName<"<N>">,
278 HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000279def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">,
Daniel Dunbar21affc02009-11-23 23:41:17 +0000280 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000281def fcolor_diagnostics : Flag<"-fcolor-diagnostics">,
282 HelpText<"Use colors in diagnostics">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000283def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">,
284 HelpText<"Silence ObjC rewriting warnings">;
Daniel Dunbar21affc02009-11-23 23:41:17 +0000285def verify : Flag<"-verify">,
286 HelpText<"Verify emitted diagnostics and warnings">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000287
288//===----------------------------------------------------------------------===//
289// Frontend Options
290//===----------------------------------------------------------------------===//
291
Daniel Dunbar8ff5b282009-12-11 23:00:49 +0000292// This isn't normally used, it is just here so we can parse a
293// CompilerInvocation out of a driver-derived argument vector.
294def cc1 : Flag<"-cc1">;
295
Douglas Gregor9bed8792010-02-09 19:21:46 +0000296def ast_merge : Separate<"-ast-merge">,
297 MetaVarName<"<ast file>">,
298 HelpText<"Merge the given AST file into the translation unit being compiled.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000299def code_completion_at : Separate<"-code-completion-at">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000300 MetaVarName<"<file>:<line>:<column>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000301 HelpText<"Dump code-completion information at a location">;
Daniel Dunbare14b5f52009-12-03 05:11:16 +0000302def remap_file : Separate<"-remap-file">,
303 MetaVarName<"<from>;<to>">,
304 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +0000305def code_completion_at_EQ : Joined<"-code-completion-at=">,
306 Alias<code_completion_at>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000307def code_completion_macros : Flag<"-code-completion-macros">,
308 HelpText<"Include macros in code-completion results">;
Douglas Gregord8e8a582010-05-25 21:41:55 +0000309def code_completion_patterns : Flag<"-code-completion-patterns">,
310 HelpText<"Include code patterns in code-completion results">;
Douglas Gregor8071e422010-08-15 06:18:01 +0000311def no_code_completion_globals : Flag<"-no-code-completion-globals">,
312 HelpText<"Do not include global declarations in code-completion results.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000313def disable_free : Flag<"-disable-free">,
314 HelpText<"Disable freeing of memory on exit">;
Daniel Dunbar9b5e9ae2009-12-03 07:01:58 +0000315def help : Flag<"-help">,
316 HelpText<"Print this help text">;
317def _help : Flag<"--help">, Alias<help>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000318def x : Separate<"-x">, HelpText<"Input language type">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000319def o : Separate<"-o">, MetaVarName<"<path>">, HelpText<"Specify output file">;
320def load : Separate<"-load">, MetaVarName<"<dsopath>">,
Daniel Dunbarefba2272009-12-03 05:11:05 +0000321 HelpText<"Load the named plugin (dynamic shared object)">;
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000322def plugin : Separate<"-plugin">, MetaVarName<"<name>">,
Nico Weber5aa74af2011-01-25 20:34:14 +0000323 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 +0000324def plugin_arg : JoinedAndSeparate<"-plugin-arg-">,
Daniel Dunbar3177aae2010-06-16 16:59:23 +0000325 MetaVarName<"<name> <arg>">,
326 HelpText<"Pass <arg> to plugin <name>">;
Nico Weber5aa74af2011-01-25 20:34:14 +0000327def add_plugin : Separate<"-add-plugin">, MetaVarName<"<name>">,
328 HelpText<"Use the named plugin action in addition to the default action">;
Daniel Dunbar8b9adfe2009-12-15 00:06:45 +0000329def resource_dir : Separate<"-resource-dir">,
330 HelpText<"The directory which holds the compiler resource files">;
Daniel Dunbar9b5e9ae2009-12-03 07:01:58 +0000331def version : Flag<"-version">,
332 HelpText<"Print the compiler version">;
333def _version : Flag<"--version">, Alias<version>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000334
335def Action_Group : OptionGroup<"<action group>">;
336let Group = Action_Group in {
337
338def Eonly : Flag<"-Eonly">,
339 HelpText<"Just run preprocessor, no output (for timings)">;
340def E : Flag<"-E">,
341 HelpText<"Run preprocessor, emit preprocessed file">;
342def dump_raw_tokens : Flag<"-dump-raw-tokens">,
343 HelpText<"Lex file in raw mode and dump raw tokens">;
344def analyze : Flag<"-analyze">,
345 HelpText<"Run static analysis engine">;
346def dump_tokens : Flag<"-dump-tokens">,
347 HelpText<"Run preprocessor, dump internal rep of tokens">;
Daniel Dunbar27585952010-03-19 19:44:04 +0000348def init_only : Flag<"-init-only">,
349 HelpText<"Only execute frontend initialization">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000350def fsyntax_only : Flag<"-fsyntax-only">,
351 HelpText<"Run parser and perform semantic analysis">;
352def fixit : Flag<"-fixit">,
353 HelpText<"Apply fix-it advice to the input source">;
Nick Lewyckyba5f6ec2010-04-24 01:30:46 +0000354def fixit_EQ : Joined<"-fixit=">,
355 HelpText<"Apply fix-it advice creating a file with the given suffix">;
Douglas Gregorf033f1d2010-07-20 20:18:03 +0000356def print_preamble : Flag<"-print-preamble">,
357 HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
358 " precompiled headers.">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000359def emit_html : Flag<"-emit-html">,
360 HelpText<"Output input source as HTML">;
361def ast_print : Flag<"-ast-print">,
362 HelpText<"Build ASTs and then pretty-print them">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000363def ast_dump : Flag<"-ast-dump">,
364 HelpText<"Build ASTs and then debug dump them">;
John McCallf3514242010-11-24 11:21:45 +0000365def ast_dump_xml : Flag<"-ast-dump-xml">,
366 HelpText<"Build ASTs and then debug dump them in a verbose XML format">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000367def ast_view : Flag<"-ast-view">,
368 HelpText<"Build ASTs and view them with GraphViz">;
369def print_decl_contexts : Flag<"-print-decl-contexts">,
370 HelpText<"Print DeclContexts and their Decls">;
Douglas Gregor467dc882011-08-25 22:30:56 +0000371def emit_module : Flag<"-emit-module">,
372 HelpText<"Generate pre-compiled module file">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000373def emit_pth : Flag<"-emit-pth">,
374 HelpText<"Generate pre-tokenized header file">;
375def emit_pch : Flag<"-emit-pch">,
376 HelpText<"Generate pre-compiled header file">;
377def S : Flag<"-S">,
378 HelpText<"Emit native assembly code">;
379def emit_llvm : Flag<"-emit-llvm">,
380 HelpText<"Build ASTs then convert to LLVM, emit .ll file">;
381def emit_llvm_bc : Flag<"-emit-llvm-bc">,
382 HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
383def emit_llvm_only : Flag<"-emit-llvm-only">,
384 HelpText<"Build ASTs and convert to LLVM, discarding output">;
Daniel Dunbar32148ce2010-05-25 18:41:01 +0000385def emit_codegen_only : Flag<"-emit-codegen-only">,
386 HelpText<"Generate machine code, but discard output">;
Daniel Dunbarda1573f2010-02-03 01:18:43 +0000387def emit_obj : Flag<"-emit-obj">,
388 HelpText<"Emit native object files">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000389def rewrite_test : Flag<"-rewrite-test">,
390 HelpText<"Rewriter playground">;
391def rewrite_objc : Flag<"-rewrite-objc">,
392 HelpText<"Rewrite ObjC into C (code rewriter example)">;
393def rewrite_macros : Flag<"-rewrite-macros">,
394 HelpText<"Expand macros without full preprocessing">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000395}
396
John McCallf85e1932011-06-15 23:02:42 +0000397def arcmt_check : Flag<"-arcmt-check">,
398 HelpText<"Check for ARC migration issues that need manual handling">;
399def arcmt_modify : Flag<"-arcmt-modify">,
400 HelpText<"Apply modifications to files to conform to ARC">;
Argyrios Kyrtzidis69325d52011-07-09 20:00:58 +0000401def arcmt_migrate : Flag<"-arcmt-migrate">,
402 HelpText<"Apply modifications and produces temporary files that conform to ARC">;
403def arcmt_migrate_directory : Separate<"-arcmt-migrate-directory">,
404 HelpText<"Directory for temporary files produced during ARC migration">;
Argyrios Kyrtzidis7ee20492011-07-19 17:20:03 +0000405def arcmt_migrate_report_output : Separate<"-arcmt-migrate-report-output">,
406 HelpText<"Output path for the plist report">;
407def arcmt_migrate_emit_arc_errors : Flag<"-arcmt-migrate-emit-errors">,
408 HelpText<"Emit ARC errors even if the migrator can fix them">;
John McCallf85e1932011-06-15 23:02:42 +0000409
Argyrios Kyrtzidis389db162010-11-03 22:45:23 +0000410def working_directory : JoinedOrSeparate<"-working-directory">,
411 HelpText<"Resolve file paths relative to the specified directory">;
412def working_directory_EQ : Joined<"-working-directory=">,
413 Alias<working_directory>;
414
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000415def relocatable_pch : Flag<"-relocatable-pch">,
416 HelpText<"Whether to build a relocatable precompiled header">;
417def print_stats : Flag<"-print-stats">,
418 HelpText<"Print performance metrics and statistics">;
419def ftime_report : Flag<"-ftime-report">,
420 HelpText<"Print the amount of time each phase of compilation takes">;
Anders Carlsson46116ce2010-04-10 19:09:13 +0000421def fdump_record_layouts : Flag<"-fdump-record-layouts">,
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000422 HelpText<"Dump record layout information">;
Nick Lewycky1450f262010-08-13 17:31:00 +0000423def fix_what_you_can : Flag<"-fix-what-you-can">,
424 HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
Daniel Dunbarb69eca52010-04-08 02:59:56 +0000425
Daniel Dunbar3f87fb02010-04-15 06:09:03 +0000426// Generic forwarding to LLVM options. This should only be used for debugging
427// and experimental features.
428def mllvm : Separate<"-mllvm">,
429 HelpText<"Additional arguments to forward to LLVM's option processing">;
430
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000431//===----------------------------------------------------------------------===//
432// Language Options
433//===----------------------------------------------------------------------===//
434
435def fno_builtin : Flag<"-fno-builtin">,
436 HelpText<"Disable implicit builtin knowledge of functions">;
437def faltivec : Flag<"-faltivec">,
438 HelpText<"Enable AltiVec vector initializer syntax">;
Benjamin Kramerc53e3652010-04-09 19:40:47 +0000439def fno_access_control : Flag<"-fno-access-control">,
John McCall380509a2010-04-09 19:09:08 +0000440 HelpText<"Disable C++ access control">;
Nuno Lopesfc284482009-12-16 16:59:22 +0000441def fno_assume_sane_operator_new : Flag<"-fno-assume-sane-operator-new">,
Nuno Lopes99860172009-12-17 22:37:33 +0000442 HelpText<"Don't assume that C++'s global operator new can't alias any pointer">;
Chandler Carrutheb5d7b72010-04-17 20:17:31 +0000443def fgnu_keywords : Flag<"-fgnu-keywords">,
444 HelpText<"Allow GNU-extension keywords regardless of language standard">;
Rafael Espindolafb3f4aa2011-06-02 16:13:27 +0000445def fgnu89_inline : Flag<"-fgnu89-inline">,
446 HelpText<"Use the gnu89 inline semantics">;
Chandler Carrutheb5d7b72010-04-17 20:17:31 +0000447def fno_gnu_keywords : Flag<"-fno-gnu-keywords">,
448 HelpText<"Disallow GNU-extension keywords regardless of language standard">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000449def fdollars_in_identifiers : Flag<"-fdollars-in-identifiers">,
450 HelpText<"Allow '$' in identifiers">;
Daniel Dunbar8663b182009-12-16 20:10:18 +0000451def fno_dollars_in_identifiers : Flag<"-fno-dollars-in-identifiers">,
452 HelpText<"Disallow '$' in identifiers">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000453def femit_all_decls : Flag<"-femit-all-decls">,
454 HelpText<"Emit all declarations, even if unused">;
455def fblocks : Flag<"-fblocks">,
John McCall13db5cf2011-09-09 20:41:01 +0000456 HelpText<"Enable the 'blocks' language feature">;
457def fblocks_runtime_optional : Flag<"-fblocks-runtime-optional">,
458 HelpText<"Weakly link in the blocks runtime">;
Michael J. Spencer20249a12010-10-21 03:16:25 +0000459def fheinous_gnu_extensions : Flag<"-fheinous-gnu-extensions">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000460def fexceptions : Flag<"-fexceptions">,
461 HelpText<"Enable support for exception handling">;
Anders Carlsson0761e442011-02-23 03:16:42 +0000462def fobjc_exceptions : Flag<"-fobjc-exceptions">,
463 HelpText<"Enable Objective-C exceptions">;
464def fcxx_exceptions : Flag<"-fcxx-exceptions">,
465 HelpText<"Enable C++ exceptions">;
Daniel Dunbar73482882010-02-10 18:48:44 +0000466def fsjlj_exceptions : Flag<"-fsjlj-exceptions">,
467 HelpText<"Use SjLj style exceptions">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000468def ffreestanding : Flag<"-ffreestanding">,
469 HelpText<"Assert that the compilation takes place in a freestanding environment">;
470def fgnu_runtime : Flag<"-fgnu-runtime">,
471 HelpText<"Generate output compatible with the standard GNU Objective-C runtime">;
John McCall279b5eb2010-08-12 23:36:15 +0000472def fhidden_weak_vtables : Flag<"-fhidden-weak-vtables">,
473 HelpText<"Generate weak vtables and RTTI with hidden visibility">;
Daniel Dunbarce6bf1e2009-11-29 09:32:20 +0000474def std_EQ : Joined<"-std=">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000475 HelpText<"Language standard to compile for">;
Bob Wilson13c4f212011-06-21 21:12:29 +0000476def stdlib_EQ : Joined<"-stdlib=">,
477 HelpText<"C++ standard library to use">;
Dan Gohmanc31176d2010-01-08 02:20:44 +0000478def fmath_errno : Flag<"-fmath-errno">,
479 HelpText<"Require math functions to indicate errors by setting errno">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000480def fms_extensions : Flag<"-fms-extensions">,
Francois Pichetae556082011-09-17 04:32:15 +0000481 HelpText<"Accept some non-standard constructs supported by the Microsoft compiler">;
482def fms_compatibility : Flag<"-fms-compatibility">,
483 HelpText<"Enable Microsoft compatibility mode">;
Michael J. Spencerdae4ac42010-10-21 05:21:48 +0000484def fmsc_version : Joined<"-fmsc-version=">,
485 HelpText<"Version of the Microsoft C/C++ compiler to report in _MSC_VER (0 = don't define it (default))">;
Dawn Perchik400b6072010-09-02 23:59:25 +0000486def fborland_extensions : Flag<"-fborland-extensions">,
487 HelpText<"Accept non-standard constructs supported by the Borland compiler">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000488def main_file_name : Separate<"-main-file-name">,
489 HelpText<"Main file name to use for debug info">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000490def fno_elide_constructors : Flag<"-fno-elide-constructors">,
491 HelpText<"Disable C++ copy constructor elision">;
492def fno_lax_vector_conversions : Flag<"-fno-lax-vector-conversions">,
493 HelpText<"Disallow implicit conversions between vectors with a different number of elements or different element types">;
494def fno_operator_names : Flag<"-fno-operator-names">,
495 HelpText<"Do not treat C++ operator name keywords as synonyms for operators">;
Daniel Dunbarefb0fa92010-03-20 04:15:41 +0000496def fno_signed_char : Flag<"-fno-signed-char">,
497 HelpText<"Char is unsigned">;
Douglas Gregora0068fc2010-07-09 17:35:33 +0000498def fno_spell_checking : Flag<"-fno-spell-checking">,
Michael J. Spencer20249a12010-10-21 03:16:25 +0000499 HelpText<"Disable spell-checking">;
Daniel Dunbarefb0fa92010-03-20 04:15:41 +0000500def fno_use_cxa_atexit : Flag<"-fno-use-cxa-atexit">,
501 HelpText<"Don't use __cxa_atexit for calling destructors">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000502def fconstant_string_class : Separate<"-fconstant-string-class">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000503 MetaVarName<"<class name>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000504 HelpText<"Specify the class to use for constant Objective-C string objects.">;
Fariborz Jahanian33e982b2010-04-22 20:26:39 +0000505def fno_constant_cfstrings : Flag<"-fno-constant-cfstrings">,
506 HelpText<"Enable creation of CodeFoundation-type constant strings">;
John McCallf85e1932011-06-15 23:02:42 +0000507def fobjc_arc : Flag<"-fobjc-arc">,
508 HelpText<"Synthesize retain and release calls for Objective-C pointers">;
509def fobjc_arc_cxxlib_EQ : Joined<"-fobjc-arc-cxxlib=">,
510 HelpText<"Objective-C++ Automatic Reference Counting standard library kind">;
John McCallf85e1932011-06-15 23:02:42 +0000511def fobjc_arc_exceptions : Flag<"-fobjc-arc-exceptions">,
512 HelpText<"Use EH-safe code when synthesizing retains and releases in -fobjc-arc">;
John McCall9f084a32011-07-06 00:26:06 +0000513def fobjc_runtime_has_arc : Flag<"-fobjc-runtime-has-arc">,
514 HelpText<"The target Objective-C runtime provides ARC entrypoints">;
515def fobjc_runtime_has_weak : Flag<"-fobjc-runtime-has-weak">,
516 HelpText<"The target Objective-C runtime supports ARC weak operations">;
John McCall256a76e2011-07-06 01:22:26 +0000517def fobjc_runtime_has_terminate : Flag<"-fobjc-runtime-has-terminate">,
518 HelpText<"The target Objective-C runtime provides an objc_terminate entrypoint">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000519def fobjc_gc : Flag<"-fobjc-gc">,
520 HelpText<"Enable Objective-C garbage collection">;
521def fobjc_gc_only : Flag<"-fobjc-gc-only">,
522 HelpText<"Use GC exclusively for Objective-C related memory management">;
Fariborz Jahanianb466d012011-01-07 01:05:02 +0000523def fapple_kext : Flag<"-fapple-kext">,
Fariborz Jahanianf84109e2011-01-07 18:59:25 +0000524 HelpText<"Use Apple's kernel extensions ABI">;
Daniel Dunbarf643b9b2010-04-24 17:56:46 +0000525def fobjc_dispatch_method_EQ : Joined<"-fobjc-dispatch-method=">,
526 HelpText<"Objective-C dispatch method to use">;
Ted Kremenekc32647d2010-12-23 21:35:43 +0000527def fobjc_default_synthesize_properties : Flag<"-fobjc-default-synthesize-properties">,
528 HelpText<"enable the default synthesis of Objective-C properties">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000529def print_ivar_layout : Flag<"-print-ivar-layout">,
530 HelpText<"Enable Objective-C Ivar layout bitmap print trace">;
John McCalld1e40d52011-10-02 01:16:38 +0000531def fobjc_fragile_abi : Flag<"-fobjc-fragile-abi">,
532 HelpText<"Use Objective-C's fragile ABI">;
Douglas Gregor74da19f2011-06-14 23:20:43 +0000533def fno_objc_infer_related_result_type : Flag<
534 "-fno-objc-infer-related-result-type">,
535 HelpText<
536 "do not infer Objective-C related result type based on method family">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000537def ftrapv : Flag<"-ftrapv">,
538 HelpText<"Trap on integer overflow">;
David Chisnall7f18e672010-09-17 18:29:54 +0000539def ftrapv_handler : Separate<"-ftrapv-handler">,
540 MetaVarName<"<function name>">,
541 HelpText<"Specify the function to be called on overflow.">;
Chris Lattnera4d71452010-06-26 21:25:03 +0000542def fwrapv : Flag<"-fwrapv">,
543 HelpText<"Treat signed integer overflow as two's complement">;
Daniel Dunbar76743522009-11-29 02:39:08 +0000544def pic_level : Separate<"-pic-level">,
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000545 HelpText<"Value for __PIC__">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000546def pthread : Flag<"-pthread">,
547 HelpText<"Support POSIX threads in generated code">;
Daniel Dunbar88934e82011-10-05 21:04:55 +0000548def fpack_struct : Separate<"-fpack-struct">,
549 HelpText<"Specify the default maximum struct packing alignment">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000550def fpascal_strings : Flag<"-fpascal-strings">,
551 HelpText<"Recognize and construct Pascal-style string literals">;
552def fno_rtti : Flag<"-fno-rtti">,
553 HelpText<"Disable generation of rtti information">;
Douglas Gregorfae3b2f2010-07-27 00:27:13 +0000554def fno_validate_pch : Flag<"-fno-validate-pch">,
555 HelpText<"Disable validation of precompiled headers">;
Argyrios Kyrtzidisb9728582010-10-14 20:14:18 +0000556def dump_deserialized_pch_decls : Flag<"-dump-deserialized-decls">,
557 HelpText<"Dump declarations that are deserialized from PCH, for testing">;
Argyrios Kyrtzidis3e785932010-10-14 20:14:25 +0000558def error_on_deserialized_pch_decl : Separate<"-error-on-deserialized-decl">,
559 HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
Argyrios Kyrtzidis9a8cbc72011-10-28 22:54:24 +0000560def error_on_deserialized_pch_decl_EQ : Joined<"-error-on-deserialized-decl=">,
561 Alias<error_on_deserialized_pch_decl>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000562def fshort_wchar : Flag<"-fshort-wchar">,
563 HelpText<"Force wchar_t to be a short unsigned int">;
Argyrios Kyrtzidis9a2b9d72010-10-08 00:25:19 +0000564def fshort_enums : Flag<"-fshort-enums">,
565 HelpText<"Allocate to an enum type only as many bytes as it needs for the declared range of possible values">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000566def static_define : Flag<"-static-define">,
567 HelpText<"Should __STATIC__ be defined">;
568def stack_protector : Separate<"-stack-protector">,
569 HelpText<"Enable stack protectors">;
570def fvisibility : Separate<"-fvisibility">,
571 HelpText<"Default symbol visibility">;
Douglas Gregor7cf84d62010-06-15 17:05:35 +0000572def fvisibility_inlines_hidden : Flag<"-fvisibility-inlines-hidden">,
573 HelpText<"Give inline C++ member functions default visibility by default">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000574def ftemplate_depth : Separate<"-ftemplate-depth">,
575 HelpText<"Maximum depth of recursive template instantiation">;
Argyrios Kyrtzidis1380a142010-11-18 00:20:36 +0000576def Wlarge_by_value_copy : Separate<"-Wlarge-by-value-copy">,
Argyrios Kyrtzidis3532fdd2010-11-17 23:11:54 +0000577 HelpText<"Warn if a function definition returns or accepts an object larger "
578 "in bytes that a given value">;
Argyrios Kyrtzidis1380a142010-11-18 00:20:36 +0000579def Wlarge_by_value_copy_EQ : Joined<"-Wlarge-by-value-copy=">,
580 Alias<Wlarge_by_value_copy>;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000581def trigraphs : Flag<"-trigraphs">,
582 HelpText<"Process trigraph sequences">;
583def fwritable_strings : Flag<"-fwritable-strings">,
584 HelpText<"Store string literals as writable data">;
Chandler Carruth50465d12011-04-23 06:30:43 +0000585def fconst_strings : Flag<"-fconst-strings">,
586 HelpText<"Use a const qualified type for string literals in C and ObjC">;
587def fno_const_strings : Flag<"-fno-const-strings">,
588 HelpText<"Don't use a const qualified type for string literals in C and ObjC">;
Daniel Dunbarfb937b82010-04-15 15:06:22 +0000589def fno_bitfield_type_align : Flag<"-fno-bitfield-type-align">,
590 HelpText<"Ignore bit-field types when aligning structures">;
Daniel Dunbar2ed42282011-03-18 21:23:38 +0000591def traditional_cpp : Flag<"-traditional-cpp">,
592 HelpText<"Enable some traditional CPP emulation">;
Peter Collingbourne207f4d82011-03-18 22:38:29 +0000593def ffake_address_space_map : Flag<"-ffake-address-space-map">,
594 HelpText<"Use a fake address space map; OpenCL testing purposes only">;
Francois Pichet8387e2a2011-04-22 22:18:13 +0000595def fdelayed_template_parsing : Flag<"-fdelayed-template-parsing">,
596 HelpText<"Parse templated function definitions at the end of the "
597 "translation unit ">;
John McCalla5fc4722011-04-09 22:50:59 +0000598def funknown_anytype : Flag<"-funknown-anytype">,
599 HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">;
John McCall48218c62011-07-13 17:56:40 +0000600def fdebugger_support : Flag<"-fdebugger-support">,
601 HelpText<"Enable special debugger support behavior">;
Chandler Carruth1cfe3c32011-04-23 09:27:53 +0000602def fdeprecated_macro : Flag<"-fdeprecated-macro">,
Chandler Carruthf8c247d2011-04-23 19:48:40 +0000603 HelpText<"Defines the __DEPRECATED macro">;
Chandler Carruth1cfe3c32011-04-23 09:27:53 +0000604def fno_deprecated_macro : Flag<"-fno-deprecated-macro">,
Chandler Carruthf8c247d2011-04-23 19:48:40 +0000605 HelpText<"Undefines the __DEPRECATED macro">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000606
607//===----------------------------------------------------------------------===//
608// Header Search Options
609//===----------------------------------------------------------------------===//
610
Daniel Dunbara268fc02011-10-11 18:20:10 +0000611def nostdsysteminc : Flag<"-nostdsysteminc">,
612 HelpText<"Disable standard system #include directories">;
Douglas Gregor4c2bcad2010-03-24 20:13:48 +0000613def nostdincxx : Flag<"-nostdinc++">,
614 HelpText<"Disable standard #include directories for the C++ standard library">;
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000615def nobuiltininc : Flag<"-nobuiltininc">,
616 HelpText<"Disable builtin #include directories">;
Douglas Gregor8ee51ef2011-09-14 20:28:46 +0000617def fmodule_cache_path : Separate<"-fmodule-cache-path">,
Douglas Gregor9a6da692011-09-12 20:41:59 +0000618 MetaVarName<"<directory>">,
619 HelpText<"Specify the module cache path">;
Douglas Gregor6e975c42011-09-13 23:15:45 +0000620def fdisable_module_hash : Flag<"-fdisable-module-hash">,
621 HelpText<"Disable the module hash">;
Douglas Gregorfba18aa2011-09-15 22:00:41 +0000622def fauto_module_import : Flag<"-fauto-module-import">,
623 HelpText<"Automatically translate #include/#import into module imports "
624 "when possible">;
625
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000626def F : JoinedOrSeparate<"-F">, MetaVarName<"<directory>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000627 HelpText<"Add directory to framework include search path">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000628def I : JoinedOrSeparate<"-I">, MetaVarName<"<directory>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000629 HelpText<"Add directory to include search path">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000630def idirafter : JoinedOrSeparate<"-idirafter">, MetaVarName<"<directory>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000631 HelpText<"Add directory to AFTER include search path">;
Douglas Gregor65e02fa2011-07-28 04:45:53 +0000632def index_header_map : Flag<"-index-header-map">,
633 HelpText<"Make the next included directory (-I or -F) an indexer header map">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000634def iquote : JoinedOrSeparate<"-iquote">, MetaVarName<"<directory>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000635 HelpText<"Add directory to QUOTE include search path">;
Benjamin Kramer47adebe2011-09-22 21:41:16 +0000636def c_isystem : JoinedOrSeparate<"-c-isystem">, MetaVarName<"<directory>">,
637 HelpText<"Add directory to the C SYSTEM include search path">;
Joerg Sonnenberger2df66472011-02-22 00:40:56 +0000638def cxx_isystem : JoinedOrSeparate<"-cxx-isystem">, MetaVarName<"<directory>">,
639 HelpText<"Add directory to the C++ SYSTEM include search path">;
Benjamin Kramer47adebe2011-09-22 21:41:16 +0000640def objc_isystem : JoinedOrSeparate<"-objc-isystem">,
641 MetaVarName<"<directory>">,
642 HelpText<"Add directory to the ObjC SYSTEM include search path">;
643def objcxx_isystem : JoinedOrSeparate<"-objcxx-isystem">,
644 MetaVarName<"<directory>">,
645 HelpText<"Add directory to the ObjC++ SYSTEM include search path">;
Daniel Dunbar024f4be2011-10-18 20:40:38 +0000646def iframework : JoinedOrSeparate<"-iframework">, MetaVarName<"<directory>">,
647 HelpText<"Add directory to SYSTEM framework search path">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000648def isystem : JoinedOrSeparate<"-isystem">, MetaVarName<"<directory>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000649 HelpText<"Add directory to SYSTEM include search path">;
Chris Lattner9db9ad32010-08-24 21:09:16 +0000650def iwithsysroot : JoinedOrSeparate<"-iwithsysroot">,MetaVarName<"<directory>">,
651 HelpText<"Add directory to SYSTEM include search path, "
652 "absolute paths are relative to -isysroot">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000653def iprefix : JoinedOrSeparate<"-iprefix">, MetaVarName<"<prefix>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000654 HelpText<"Set the -iwithprefix/-iwithprefixbefore prefix">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000655def iwithprefix : JoinedOrSeparate<"-iwithprefix">, MetaVarName<"<dir>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000656 HelpText<"Set directory to SYSTEM include search path with prefix">;
Mike Stumpe4cb2a42009-12-09 18:09:35 +0000657def iwithprefixbefore : JoinedOrSeparate<"-iwithprefixbefore">,
658 MetaVarName<"<dir>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000659 HelpText<"Set directory to include search path with prefix">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000660def isysroot : JoinedOrSeparate<"-isysroot">, MetaVarName<"<dir>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000661 HelpText<"Set the system root directory (usually /)">;
662def v : Flag<"-v">, HelpText<"Enable verbose output">;
663
664//===----------------------------------------------------------------------===//
665// Preprocessor Options
666//===----------------------------------------------------------------------===//
667
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000668def D : JoinedOrSeparate<"-D">, MetaVarName<"<macro>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000669 HelpText<"Predefine the specified macro">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000670def include_ : JoinedOrSeparate<"-include">, MetaVarName<"<file>">, EnumName<"include">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000671 HelpText<"Include file before parsing">;
Daniel Dunbarb94ffa42009-12-09 10:01:26 +0000672def imacros : JoinedOrSeparate<"-imacros">, MetaVarName<"<file>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000673 HelpText<"Include macros from file before parsing">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000674def include_pch : Separate<"-include-pch">, MetaVarName<"<file>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000675 HelpText<"Include precompiled header file">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000676def include_pth : Separate<"-include-pth">, MetaVarName<"<file>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000677 HelpText<"Include file before parsing">;
Argyrios Kyrtzidisb0f4b9a2011-03-09 17:21:42 +0000678def chain_include : Separate<"-chain-include">, MetaVarName<"<file>">,
679 HelpText<"Include and chain a header file after turning it into PCH">;
Douglas Gregorf4f6c9d2010-07-26 21:36:20 +0000680def preamble_bytes_EQ : Joined<"-preamble-bytes=">,
Douglas Gregor3d398aa2010-07-26 16:29:14 +0000681 HelpText<"Assume that the precompiled header is a precompiled preamble "
682 "covering the first N bytes of the main file">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000683def token_cache : Separate<"-token-cache">, MetaVarName<"<path>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000684 HelpText<"Use specified token cache file">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000685def U : JoinedOrSeparate<"-U">, MetaVarName<"<macro>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000686 HelpText<"Undefine the specified macro">;
Daniel Dunbarb737fb12009-12-03 07:01:46 +0000687def undef : Flag<"-undef">, MetaVarName<"<macro>">,
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000688 HelpText<"undef all system defines">;
Douglas Gregor94dc8f62010-03-19 16:15:56 +0000689def detailed_preprocessing_record : Flag<"-detailed-preprocessing-record">,
690 HelpText<"include a detailed record of preprocessing actions">;
Michael J. Spencer20249a12010-10-21 03:16:25 +0000691
Daniel Dunbar33a33d82009-11-24 00:54:16 +0000692//===----------------------------------------------------------------------===//
693// Preprocessed Output Options
694//===----------------------------------------------------------------------===//
695
696def P : Flag<"-P">,
697 HelpText<"Disable linemarker output in -E mode">;
698def C : Flag<"-C">,
699 HelpText<"Enable comment output in -E mode">;
700def CC : Flag<"-CC">,
701 HelpText<"Enable comment output in -E mode, even from macro expansions">;
702def dM : Flag<"-dM">,
703 HelpText<"Print macro definitions in -E mode instead of normal output">;
704def dD : Flag<"-dD">,
705 HelpText<"Print macro definitions in -E mode in addition to normal output">;
Peter Collingbourne61e07862010-12-04 01:50:45 +0000706
707//===----------------------------------------------------------------------===//
708// OpenCL Options
709//===----------------------------------------------------------------------===//
710
711def cl_opt_disable : Flag<"-cl-opt-disable">,
712 HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">;
Peter Collingbourne09821362010-12-04 01:50:56 +0000713def cl_single_precision_constant : Flag<"-cl-single-precision-constant">,
714 HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">;
Peter Collingbourne5d729a32010-12-04 01:51:05 +0000715def cl_finite_math_only : Flag<"-cl-finite-math-only">,
716 HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">;
Peter Collingbourne5f67e132010-12-04 01:51:14 +0000717def cl_unsafe_math_optimizations : Flag<"-cl-unsafe-math-optimizations">,
718 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 +0000719def cl_fast_relaxed_math : Flag<"-cl-fast-relaxed-math">,
720 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 +0000721def cl_mad_enable : Flag<"-cl-mad-enable">,
722 HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">;
Peter Collingbourne91252d12010-12-04 01:51:40 +0000723def cl_std_EQ : Joined<"-cl-std=">,
724 HelpText<"OpenCL language standard to compile for">;
Peter Collingbourned51e43a2011-10-06 18:29:46 +0000725
726//===----------------------------------------------------------------------===//
727// CUDA Options
728//===----------------------------------------------------------------------===//
729
730def fcuda_is_device : Flag<"-fcuda-is-device">,
731 HelpText<"Generate code for CUDA device">;