1 //===--- CC1Options.td - Options for clang -cc1 ---------------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines the options accepted by clang -cc1 and clang -cc1as.
12 //===----------------------------------------------------------------------===//
14 let Flags = [CC1Option, NoDriverOption] in {
16 //===----------------------------------------------------------------------===//
18 //===----------------------------------------------------------------------===//
20 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
22 def target_cpu : Separate<["-"], "target-cpu">,
23 HelpText<"Target a specific cpu type">;
24 def target_feature : Separate<["-"], "target-feature">,
25 HelpText<"Target specific attributes">;
26 def triple : Separate<["-"], "triple">,
27 HelpText<"Specify target triple (e.g. i686-apple-darwin9)">;
28 def target_abi : Separate<["-"], "target-abi">,
29 HelpText<"Target a particular ABI type">;
33 def target_linker_version : Separate<["-"], "target-linker-version">,
34 HelpText<"Target linker version">;
35 def triple_EQ : Joined<["-"], "triple=">, Alias<triple>;
36 def mfpmath : Separate<["-"], "mfpmath">,
37 HelpText<"Which unit to use for fp math">;
39 //===----------------------------------------------------------------------===//
41 //===----------------------------------------------------------------------===//
43 def analysis_UnoptimizedCFG : Flag<["-"], "unoptimized-cfg">,
44 HelpText<"Generate unoptimized CFGs for all analyses">;
45 def analysis_CFGAddImplicitDtors : Flag<["-"], "cfg-add-implicit-dtors">,
46 HelpText<"Add C++ implicit destructors to CFGs for all analyses">;
48 def analyzer_store : Separate<["-"], "analyzer-store">,
49 HelpText<"Source Code Analysis - Abstract Memory Store Models">;
50 def analyzer_store_EQ : Joined<["-"], "analyzer-store=">, Alias<analyzer_store>;
52 def analyzer_constraints : Separate<["-"], "analyzer-constraints">,
53 HelpText<"Source Code Analysis - Symbolic Constraint Engines">;
54 def analyzer_constraints_EQ : Joined<["-"], "analyzer-constraints=">,
55 Alias<analyzer_constraints>;
57 def analyzer_output : Separate<["-"], "analyzer-output">,
58 HelpText<"Source Code Analysis - Output Options">;
59 def analyzer_output_EQ : Joined<["-"], "analyzer-output=">,
60 Alias<analyzer_output>;
62 def analyzer_purge : Separate<["-"], "analyzer-purge">,
63 HelpText<"Source Code Analysis - Dead Symbol Removal Frequency">;
64 def analyzer_purge_EQ : Joined<["-"], "analyzer-purge=">, Alias<analyzer_purge>;
66 def analyzer_opt_analyze_headers : Flag<["-"], "analyzer-opt-analyze-headers">,
67 HelpText<"Force the static analyzer to analyze functions defined in header files">;
68 def analyzer_opt_analyze_nested_blocks : Flag<["-"], "analyzer-opt-analyze-nested-blocks">,
69 HelpText<"Analyze the definitions of blocks in addition to functions">;
70 def analyzer_display_progress : Flag<["-"], "analyzer-display-progress">,
71 HelpText<"Emit verbose output about the analyzer's progress">;
72 def analyze_function : Separate<["-"], "analyze-function">,
73 HelpText<"Run analysis on specific function">;
74 def analyze_function_EQ : Joined<["-"], "analyze-function=">, Alias<analyze_function>;
75 def analyzer_eagerly_assume : Flag<["-"], "analyzer-eagerly-assume">,
76 HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">;
77 def trim_egraph : Flag<["-"], "trim-egraph">,
78 HelpText<"Only show error-related paths in the analysis graph">;
79 def analyzer_viz_egraph_graphviz : Flag<["-"], "analyzer-viz-egraph-graphviz">,
80 HelpText<"Display exploded graph using GraphViz">;
81 def analyzer_viz_egraph_ubigraph : Flag<["-"], "analyzer-viz-egraph-ubigraph">,
82 HelpText<"Display exploded graph using Ubigraph">;
84 def analyzer_inline_max_stack_depth : Separate<["-"], "analyzer-inline-max-stack-depth">,
85 HelpText<"Bound on stack depth while inlining (4 by default)">;
86 def analyzer_inline_max_stack_depth_EQ : Joined<["-"], "analyzer-inline-max-stack-depth=">,
87 Alias<analyzer_inline_max_stack_depth>;
89 def analyzer_inlining_mode : Separate<["-"], "analyzer-inlining-mode">,
90 HelpText<"Specify the function selection heuristic used during inlining">;
91 def analyzer_inlining_mode_EQ : Joined<["-"], "analyzer-inlining-mode=">, Alias<analyzer_inlining_mode>;
93 def analyzer_disable_retry_exhausted : Flag<["-"], "analyzer-disable-retry-exhausted">,
94 HelpText<"Do not re-analyze paths leading to exhausted nodes with a different strategy (may decrease code coverage)">;
96 def analyzer_max_loop : Separate<["-"], "analyzer-max-loop">,
97 HelpText<"The maximum number of times the analyzer will go through a loop">;
98 def analyzer_stats : Flag<["-"], "analyzer-stats">,
99 HelpText<"Print internal analyzer statistics.">;
101 def analyzer_checker : Separate<["-"], "analyzer-checker">,
102 HelpText<"Choose analyzer checkers to enable">;
103 def analyzer_checker_EQ : Joined<["-"], "analyzer-checker=">,
104 Alias<analyzer_checker>;
106 def analyzer_disable_checker : Separate<["-"], "analyzer-disable-checker">,
107 HelpText<"Choose analyzer checkers to disable">;
108 def analyzer_disable_checker_EQ : Joined<["-"], "analyzer-disable-checker=">,
109 Alias<analyzer_disable_checker>;
111 def analyzer_disable_all_checks : Flag<["-"], "analyzer-disable-all-checks">,
112 HelpText<"Disable all static analyzer checks">;
114 def analyzer_checker_help : Flag<["-"], "analyzer-checker-help">,
115 HelpText<"Display the list of analyzer checkers that are available">;
117 def analyzer_config : Separate<["-"], "analyzer-config">,
118 HelpText<"Choose analyzer options to enable">;
120 //===----------------------------------------------------------------------===//
122 //===----------------------------------------------------------------------===//
123 def migrator_no_nsalloc_error : Flag<["-"], "no-ns-alloc-error">,
124 HelpText<"Do not error on use of NSAllocateCollectable/NSReallocateCollectable">;
126 def migrator_no_finalize_removal : Flag<["-"], "no-finalize-removal">,
127 HelpText<"Do not remove finalize method in gc mode">;
129 //===----------------------------------------------------------------------===//
131 //===----------------------------------------------------------------------===//
133 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
135 def fdebug_compilation_dir : Separate<["-"], "fdebug-compilation-dir">,
136 HelpText<"The compilation directory to embed in the debug info.">;
137 def dwarf_debug_flags : Separate<["-"], "dwarf-debug-flags">,
138 HelpText<"The string to embed in the Dwarf debug flags record.">;
139 def mno_exec_stack : Flag<["-"], "mnoexecstack">,
140 HelpText<"Mark the file as not needing an executable stack">;
141 def massembler_fatal_warnings : Flag<["-"], "massembler-fatal-warnings">,
142 HelpText<"Make assembler warnings fatal">;
143 def compress_debug_sections : Flag<["-"], "compress-debug-sections">,
144 HelpText<"Compress DWARF debug sections using zlib">;
145 def msave_temp_labels : Flag<["-"], "msave-temp-labels">,
146 HelpText<"Save temporary labels in the symbol table. "
147 "Note this may change .s semantics and shouldn't generally be used "
148 "on compiler-generated code.">;
152 def disable_llvm_optzns : Flag<["-"], "disable-llvm-optzns">,
153 HelpText<"Don't run LLVM optimization passes">;
154 def disable_llvm_verifier : Flag<["-"], "disable-llvm-verifier">,
155 HelpText<"Don't run the LLVM IR verifier pass">;
156 def disable_red_zone : Flag<["-"], "disable-red-zone">,
157 HelpText<"Do not emit code that uses the red zone.">;
158 def dwarf_column_info : Flag<["-"], "dwarf-column-info">,
159 HelpText<"Turn on column location information.">;
160 def split_dwarf : Flag<["-"], "split-dwarf">,
161 HelpText<"Split out the dwarf .dwo sections">;
162 def gnu_pubnames : Flag<["-"], "gnu-pubnames">,
163 HelpText<"Emit newer GNU style pubnames">;
164 def arange_sections : Flag<["-"], "arange_sections">,
165 HelpText<"Emit DWARF .debug_arange sections">;
166 def fforbid_guard_variables : Flag<["-"], "fforbid-guard-variables">,
167 HelpText<"Emit an error if a C++ static local initializer would need a guard variable">;
168 def no_implicit_float : Flag<["-"], "no-implicit-float">,
169 HelpText<"Don't generate implicit floating point instructions">;
170 def fdump_vtable_layouts : Flag<["-"], "fdump-vtable-layouts">,
171 HelpText<"Dump the layouts of all vtables that will be emitted in a translation unit">;
172 def fmerge_functions : Flag<["-"], "fmerge-functions">,
173 HelpText<"Permit merging of identical functions when optimizing.">;
174 def femit_coverage_notes : Flag<["-"], "femit-coverage-notes">,
175 HelpText<"Emit a gcov coverage notes file when compiling.">;
176 def femit_coverage_data: Flag<["-"], "femit-coverage-data">,
177 HelpText<"Instrument the program to emit gcov coverage data when run.">;
178 def coverage_file : Separate<["-"], "coverage-file">,
179 HelpText<"Emit coverage data to this filename. The extension will be replaced.">;
180 def coverage_file_EQ : Joined<["-"], "coverage-file=">, Alias<coverage_file>;
181 def coverage_cfg_checksum : Flag<["-"], "coverage-cfg-checksum">,
182 HelpText<"Emit CFG checksum for functions in .gcno files.">;
183 def coverage_no_function_names_in_data : Flag<["-"], "coverage-no-function-names-in-data">,
184 HelpText<"Emit function names in .gcda files.">;
185 def coverage_exit_block_before_body : Flag<["-"], "coverage-exit-block-before-body">,
186 HelpText<"Emit the exit block before the body blocks in .gcno files.">;
187 def coverage_version_EQ : Joined<["-"], "coverage-version=">,
188 HelpText<"Four-byte version string for gcov files.">;
189 def test_coverage : Flag<["-"], "test-coverage">,
190 HelpText<"Do not generate coverage files or remove coverage changes from IR">;
191 def dump_coverage_mapping : Flag<["-"], "dump-coverage-mapping">,
192 HelpText<"Dump the coverage mapping records, for testing">;
193 def fuse_register_sized_bitfield_access: Flag<["-"], "fuse-register-sized-bitfield-access">,
194 HelpText<"Use register sized accesses to bit-fields, when possible.">;
195 def relaxed_aliasing : Flag<["-"], "relaxed-aliasing">,
196 HelpText<"Turn off Type Based Alias Analysis">;
197 def no_struct_path_tbaa : Flag<["-"], "no-struct-path-tbaa">,
198 HelpText<"Turn off struct-path aware Type Based Alias Analysis">;
199 def masm_verbose : Flag<["-"], "masm-verbose">,
200 HelpText<"Generate verbose assembly output">;
201 def mcode_model : Separate<["-"], "mcode-model">,
202 HelpText<"The code model to use">;
203 def mdebug_pass : Separate<["-"], "mdebug-pass">,
204 HelpText<"Enable additional debug output">;
205 def mdisable_fp_elim : Flag<["-"], "mdisable-fp-elim">,
206 HelpText<"Disable frame pointer elimination optimization">;
207 def mdisable_tail_calls : Flag<["-"], "mdisable-tail-calls">,
208 HelpText<"Disable tail call optimization, keeping the call stack accurate">;
209 def menable_no_infinities : Flag<["-"], "menable-no-infs">,
210 HelpText<"Allow optimization to assume there are no infinities.">;
211 def menable_no_nans : Flag<["-"], "menable-no-nans">,
212 HelpText<"Allow optimization to assume there are no NaNs.">;
213 def menable_unsafe_fp_math : Flag<["-"], "menable-unsafe-fp-math">,
214 HelpText<"Allow unsafe floating-point math optimizations which may decrease "
216 def mfloat_abi : Separate<["-"], "mfloat-abi">,
217 HelpText<"The float ABI to use">;
218 def mlimit_float_precision : Separate<["-"], "mlimit-float-precision">,
219 HelpText<"Limit float precision to the given value">;
220 def split_stacks : Flag<["-"], "split-stacks">,
221 HelpText<"Try to use a split stack if possible.">;
222 def mno_zero_initialized_in_bss : Flag<["-"], "mno-zero-initialized-in-bss">,
223 HelpText<"Do not put zero initialized data in the BSS">;
224 def backend_option : Separate<["-"], "backend-option">,
225 HelpText<"Additional arguments to forward to LLVM backend (during code gen)">;
226 def mregparm : Separate<["-"], "mregparm">,
227 HelpText<"Limit the number of registers available for integer arguments">;
228 def mrelocation_model : Separate<["-"], "mrelocation-model">,
229 HelpText<"The relocation model to use">;
230 def munwind_tables : Flag<["-"], "munwind-tables">,
231 HelpText<"Generate unwinding tables for all functions">;
232 def mconstructor_aliases : Flag<["-"], "mconstructor-aliases">,
233 HelpText<"Emit complete constructors and destructors as aliases when possible">;
234 def mlink_bitcode_file : Separate<["-"], "mlink-bitcode-file">,
235 HelpText<"Link the given bitcode file before performing optimizations.">;
236 def vectorize_loops : Flag<["-"], "vectorize-loops">,
237 HelpText<"Run the Loop vectorization passes">;
238 def vectorize_slp : Flag<["-"], "vectorize-slp">,
239 HelpText<"Run the SLP vectorization passes">;
240 def vectorize_slp_aggressive : Flag<["-"], "vectorize-slp-aggressive">,
241 HelpText<"Run the BB vectorization passes">;
242 def dependent_lib : Joined<["--"], "dependent-lib=">,
243 HelpText<"Add dependent library">;
244 def fsanitize_coverage_type : Joined<["-"], "fsanitize-coverage-type=">,
245 HelpText<"Sanitizer coverage type">;
246 def fsanitize_coverage_indirect_calls
247 : Flag<["-"], "fsanitize-coverage-indirect-calls">,
248 HelpText<"Enable sanitizer coverage for indirect calls">;
249 def fsanitize_coverage_trace_bb
250 : Flag<["-"], "fsanitize-coverage-trace-bb">,
251 HelpText<"Enable basic block tracing in sanitizer coverage">;
252 def fsanitize_coverage_trace_cmp
253 : Flag<["-"], "fsanitize-coverage-trace-cmp">,
254 HelpText<"Enable cmp instruction tracing in sanitizer coverage">;
255 def fsanitize_coverage_8bit_counters
256 : Flag<["-"], "fsanitize-coverage-8bit-counters">,
257 HelpText<"Enable frequency counters in sanitizer coverage">;
259 //===----------------------------------------------------------------------===//
260 // Dependency Output Options
261 //===----------------------------------------------------------------------===//
263 def sys_header_deps : Flag<["-"], "sys-header-deps">,
264 HelpText<"Include system headers in dependency output">;
265 def module_file_deps : Flag<["-"], "module-file-deps">,
266 HelpText<"Include module files in dependency output">;
267 def header_include_file : Separate<["-"], "header-include-file">,
268 HelpText<"Filename (or -) to write header include output to">;
269 def show_includes : Flag<["--"], "show-includes">,
270 HelpText<"Print cl.exe style /showIncludes to stdout">;
272 //===----------------------------------------------------------------------===//
273 // Diagnostic Options
274 //===----------------------------------------------------------------------===//
276 def diagnostic_log_file : Separate<["-"], "diagnostic-log-file">,
277 HelpText<"Filename (or -) to log diagnostics to">;
278 def diagnostic_serialized_file : Separate<["-"], "serialize-diagnostic-file">,
279 MetaVarName<"<filename>">,
280 HelpText<"File for serializing diagnostics in a binary format">;
282 def fdiagnostics_format : Separate<["-"], "fdiagnostics-format">,
283 HelpText<"Change diagnostic formatting to match IDE and command line tools">;
284 def fdiagnostics_show_category : Separate<["-"], "fdiagnostics-show-category">,
285 HelpText<"Print diagnostic category">;
286 def fno_diagnostics_use_presumed_location : Flag<["-"], "fno-diagnostics-use-presumed-location">,
287 HelpText<"Ignore #line directives when displaying diagnostic locations">;
288 def ftabstop : Separate<["-"], "ftabstop">, MetaVarName<"<N>">,
289 HelpText<"Set the tab stop distance.">;
290 def ferror_limit : Separate<["-"], "ferror-limit">, MetaVarName<"<N>">,
291 HelpText<"Set the maximum number of errors to emit before stopping (0 = no limit).">;
292 def fmacro_backtrace_limit : Separate<["-"], "fmacro-backtrace-limit">, MetaVarName<"<N>">,
293 HelpText<"Set the maximum number of entries to print in a macro expansion backtrace (0 = no limit).">;
294 def ftemplate_backtrace_limit : Separate<["-"], "ftemplate-backtrace-limit">, MetaVarName<"<N>">,
295 HelpText<"Set the maximum number of entries to print in a template instantiation backtrace (0 = no limit).">;
296 def fconstexpr_backtrace_limit : Separate<["-"], "fconstexpr-backtrace-limit">, MetaVarName<"<N>">,
297 HelpText<"Set the maximum number of entries to print in a constexpr evaluation backtrace (0 = no limit).">;
298 def fspell_checking_limit : Separate<["-"], "fspell-checking-limit">, MetaVarName<"<N>">,
299 HelpText<"Set the maximum number of times to perform spell checking on unrecognized identifiers (0 = no limit).">;
300 def fmessage_length : Separate<["-"], "fmessage-length">, MetaVarName<"<N>">,
301 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">;
302 def verify : Flag<["-"], "verify">,
303 HelpText<"Verify diagnostic output using comment directives">;
304 def verify_ignore_unexpected : Flag<["-"], "verify-ignore-unexpected">,
305 HelpText<"Ignore unexpected diagnostic messages">;
306 def verify_ignore_unexpected_EQ : CommaJoined<["-"], "verify-ignore-unexpected=">,
307 HelpText<"Ignore unexpected diagnostic messages">;
308 def Wno_rewrite_macros : Flag<["-"], "Wno-rewrite-macros">,
309 HelpText<"Silence ObjC rewriting warnings">;
311 //===----------------------------------------------------------------------===//
313 //===----------------------------------------------------------------------===//
315 // This isn't normally used, it is just here so we can parse a
316 // CompilerInvocation out of a driver-derived argument vector.
317 def cc1 : Flag<["-"], "cc1">;
318 def cc1as : Flag<["-"], "cc1as">;
320 def ast_merge : Separate<["-"], "ast-merge">,
321 MetaVarName<"<ast file>">,
322 HelpText<"Merge the given AST file into the translation unit being compiled.">;
323 def code_completion_at : Separate<["-"], "code-completion-at">,
324 MetaVarName<"<file>:<line>:<column>">,
325 HelpText<"Dump code-completion information at a location">;
326 def remap_file : Separate<["-"], "remap-file">,
327 MetaVarName<"<from>;<to>">,
328 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">;
329 def code_completion_at_EQ : Joined<["-"], "code-completion-at=">,
330 Alias<code_completion_at>;
331 def code_completion_macros : Flag<["-"], "code-completion-macros">,
332 HelpText<"Include macros in code-completion results">;
333 def code_completion_patterns : Flag<["-"], "code-completion-patterns">,
334 HelpText<"Include code patterns in code-completion results">;
335 def no_code_completion_globals : Flag<["-"], "no-code-completion-globals">,
336 HelpText<"Do not include global declarations in code-completion results.">;
337 def code_completion_brief_comments : Flag<["-"], "code-completion-brief-comments">,
338 HelpText<"Include brief documentation comments in code-completion results.">;
339 def disable_free : Flag<["-"], "disable-free">,
340 HelpText<"Disable freeing of memory on exit">;
341 def load : Separate<["-"], "load">, MetaVarName<"<dsopath>">,
342 HelpText<"Load the named plugin (dynamic shared object)">;
343 def plugin : Separate<["-"], "plugin">, MetaVarName<"<name>">,
344 HelpText<"Use the named plugin action instead of the default action (use \"help\" to list available options)">;
345 def plugin_arg : JoinedAndSeparate<["-"], "plugin-arg-">,
346 MetaVarName<"<name> <arg>">,
347 HelpText<"Pass <arg> to plugin <name>">;
348 def add_plugin : Separate<["-"], "add-plugin">, MetaVarName<"<name>">,
349 HelpText<"Use the named plugin action in addition to the default action">;
350 def ast_dump_filter : Separate<["-"], "ast-dump-filter">,
351 MetaVarName<"<dump_filter>">,
352 HelpText<"Use with -ast-dump or -ast-print to dump/print only AST declaration"
353 " nodes having a certain substring in a qualified name. Use"
354 " -ast-list to list all filterable declaration node names.">;
355 def fno_modules_global_index : Flag<["-"], "fno-modules-global-index">,
356 HelpText<"Do not automatically generate or update the global module index">;
357 def fno_modules_error_recovery : Flag<["-"], "fno-modules-error-recovery">,
358 HelpText<"Do not automatically import modules for error recovery">;
359 def fmodule_implementation_of : Separate<["-"], "fmodule-implementation-of">,
360 MetaVarName<"<name>">,
361 HelpText<"Specify the name of the module whose implementation file this is">;
362 def fmodule_map_file_home_is_cwd : Flag<["-"], "fmodule-map-file-home-is-cwd">,
363 HelpText<"Use the current working directory as the home directory of "
364 "module maps specified by -fmodule-map-file=<FILE>">;
365 def fmodule_feature : Separate<["-"], "fmodule-feature">,
366 MetaVarName<"<feature>">,
367 HelpText<"Enable <feature> in module map requires declarations">;
368 def fmodules_local_submodule_visibility :
369 Flag<["-"], "fmodules-local-submodule-visibility">,
370 HelpText<"Enforce name visibility rules across submodules of the same "
371 "top-level module.">;
372 def fno_modules_hide_internal_linkage :
373 Flag<["-"], "fno-modules-hide-internal-linkage">,
374 HelpText<"Make all declarations visible to redeclaration lookup, "
375 "even if they have internal linkage.">;
376 def fconcepts_ts : Flag<["-"], "fconcepts-ts">,
377 HelpText<"Enable C++ Extensions for Concepts.">;
379 let Group = Action_Group in {
381 def Eonly : Flag<["-"], "Eonly">,
382 HelpText<"Just run preprocessor, no output (for timings)">;
383 def dump_raw_tokens : Flag<["-"], "dump-raw-tokens">,
384 HelpText<"Lex file in raw mode and dump raw tokens">;
385 def analyze : Flag<["-"], "analyze">,
386 HelpText<"Run static analysis engine">;
387 def dump_tokens : Flag<["-"], "dump-tokens">,
388 HelpText<"Run preprocessor, dump internal rep of tokens">;
389 def init_only : Flag<["-"], "init-only">,
390 HelpText<"Only execute frontend initialization">;
391 def fixit : Flag<["-"], "fixit">,
392 HelpText<"Apply fix-it advice to the input source">;
393 def fixit_EQ : Joined<["-"], "fixit=">,
394 HelpText<"Apply fix-it advice creating a file with the given suffix">;
395 def print_preamble : Flag<["-"], "print-preamble">,
396 HelpText<"Print the \"preamble\" of a file, which is a candidate for implicit"
397 " precompiled headers.">;
398 def emit_html : Flag<["-"], "emit-html">,
399 HelpText<"Output input source as HTML">;
400 def ast_print : Flag<["-"], "ast-print">,
401 HelpText<"Build ASTs and then pretty-print them">;
402 def ast_list : Flag<["-"], "ast-list">,
403 HelpText<"Build ASTs and print the list of declaration node qualified names">;
404 def ast_dump : Flag<["-"], "ast-dump">,
405 HelpText<"Build ASTs and then debug dump them">;
406 def ast_dump_lookups : Flag<["-"], "ast-dump-lookups">,
407 HelpText<"Build ASTs and then debug dump their name lookup tables">;
408 def ast_view : Flag<["-"], "ast-view">,
409 HelpText<"Build ASTs and view them with GraphViz">;
410 def print_decl_contexts : Flag<["-"], "print-decl-contexts">,
411 HelpText<"Print DeclContexts and their Decls">;
412 def emit_module : Flag<["-"], "emit-module">,
413 HelpText<"Generate pre-compiled module file from a module map">;
414 def emit_pth : Flag<["-"], "emit-pth">,
415 HelpText<"Generate pre-tokenized header file">;
416 def emit_pch : Flag<["-"], "emit-pch">,
417 HelpText<"Generate pre-compiled header file">;
418 def emit_llvm_bc : Flag<["-"], "emit-llvm-bc">,
419 HelpText<"Build ASTs then convert to LLVM, emit .bc file">;
420 def emit_llvm_only : Flag<["-"], "emit-llvm-only">,
421 HelpText<"Build ASTs and convert to LLVM, discarding output">;
422 def emit_codegen_only : Flag<["-"], "emit-codegen-only">,
423 HelpText<"Generate machine code, but discard output">;
424 def emit_obj : Flag<["-"], "emit-obj">,
425 HelpText<"Emit native object files">;
426 def rewrite_test : Flag<["-"], "rewrite-test">,
427 HelpText<"Rewriter playground">;
428 def rewrite_macros : Flag<["-"], "rewrite-macros">,
429 HelpText<"Expand macros without full preprocessing">;
430 def migrate : Flag<["-"], "migrate">,
431 HelpText<"Migrate source code">;
434 def emit_llvm_uselists : Flag<["-"], "emit-llvm-uselists">,
435 HelpText<"Preserve order of LLVM use-lists when serializing">;
436 def no_emit_llvm_uselists : Flag<["-"], "no-emit-llvm-uselists">,
437 HelpText<"Don't preserve order of LLVM use-lists when serializing">;
439 def mt_migrate_directory : Separate<["-"], "mt-migrate-directory">,
440 HelpText<"Directory for temporary files produced during ARC or ObjC migration">;
441 def arcmt_check : Flag<["-"], "arcmt-check">,
442 HelpText<"Check for ARC migration issues that need manual handling">;
443 def arcmt_modify : Flag<["-"], "arcmt-modify">,
444 HelpText<"Apply modifications to files to conform to ARC">;
445 def arcmt_migrate : Flag<["-"], "arcmt-migrate">,
446 HelpText<"Apply modifications and produces temporary files that conform to ARC">;
448 def print_stats : Flag<["-"], "print-stats">,
449 HelpText<"Print performance metrics and statistics">;
450 def fdump_record_layouts : Flag<["-"], "fdump-record-layouts">,
451 HelpText<"Dump record layout information">;
452 def fdump_record_layouts_simple : Flag<["-"], "fdump-record-layouts-simple">,
453 HelpText<"Dump record layout information in a simple form used for testing">;
454 def fix_what_you_can : Flag<["-"], "fix-what-you-can">,
455 HelpText<"Apply fix-it advice even in the presence of unfixable errors">;
456 def fix_only_warnings : Flag<["-"], "fix-only-warnings">,
457 HelpText<"Apply fix-it advice only for warnings, not errors">;
458 def fixit_recompile : Flag<["-"], "fixit-recompile">,
459 HelpText<"Apply fix-it changes and recompile">;
460 def fixit_to_temp : Flag<["-"], "fixit-to-temporary">,
461 HelpText<"Apply fix-it changes to temporary files">;
463 def foverride_record_layout_EQ : Joined<["-"], "foverride-record-layout=">,
464 HelpText<"Override record layouts with those in the given file">;
466 //===----------------------------------------------------------------------===//
468 //===----------------------------------------------------------------------===//
470 let Flags = [CC1Option, CC1AsOption, NoDriverOption] in {
472 def version : Flag<["-"], "version">,
473 HelpText<"Print the compiler version">;
474 def main_file_name : Separate<["-"], "main-file-name">,
475 HelpText<"Main file name to use for debug info">;
479 def fblocks_runtime_optional : Flag<["-"], "fblocks-runtime-optional">,
480 HelpText<"Weakly link in the blocks runtime">;
481 def fsjlj_exceptions : Flag<["-"], "fsjlj-exceptions">,
482 HelpText<"Use SjLj style exceptions">;
483 def split_dwarf_file : Separate<["-"], "split-dwarf-file">,
484 HelpText<"File name to use for split dwarf debug info output">;
485 def fno_wchar : Flag<["-"], "fno-wchar">,
486 HelpText<"Disable C++ builtin type wchar_t">;
487 def fconstant_string_class : Separate<["-"], "fconstant-string-class">,
488 MetaVarName<"<class name>">,
489 HelpText<"Specify the class to use for constant Objective-C string objects.">;
490 def fobjc_arc_cxxlib_EQ : Joined<["-"], "fobjc-arc-cxxlib=">,
491 HelpText<"Objective-C++ Automatic Reference Counting standard library kind">;
492 def fobjc_runtime_has_weak : Flag<["-"], "fobjc-runtime-has-weak">,
493 HelpText<"The target Objective-C runtime supports ARC weak operations">;
494 def fobjc_dispatch_method_EQ : Joined<["-"], "fobjc-dispatch-method=">,
495 HelpText<"Objective-C dispatch method to use">;
496 def disable_objc_default_synthesize_properties : Flag<["-"], "disable-objc-default-synthesize-properties">,
497 HelpText<"disable the default synthesis of Objective-C properties">;
498 def fencode_extended_block_signature : Flag<["-"], "fencode-extended-block-signature">,
499 HelpText<"enable extended encoding of block type signature">;
500 def pic_level : Separate<["-"], "pic-level">,
501 HelpText<"Value for __PIC__">;
502 def pie_level : Separate<["-"], "pie-level">,
503 HelpText<"Value for __PIE__">;
504 def fno_validate_pch : Flag<["-"], "fno-validate-pch">,
505 HelpText<"Disable validation of precompiled headers">;
506 def dump_deserialized_pch_decls : Flag<["-"], "dump-deserialized-decls">,
507 HelpText<"Dump declarations that are deserialized from PCH, for testing">;
508 def error_on_deserialized_pch_decl : Separate<["-"], "error-on-deserialized-decl">,
509 HelpText<"Emit error if a specific declaration is deserialized from PCH, for testing">;
510 def error_on_deserialized_pch_decl_EQ : Joined<["-"], "error-on-deserialized-decl=">,
511 Alias<error_on_deserialized_pch_decl>;
512 def static_define : Flag<["-"], "static-define">,
513 HelpText<"Should __STATIC__ be defined">;
514 def stack_protector : Separate<["-"], "stack-protector">,
515 HelpText<"Enable stack protectors">;
516 def stack_protector_buffer_size : Separate<["-"], "stack-protector-buffer-size">,
517 HelpText<"Lower bound for a buffer to be considered for stack protection">;
518 def fvisibility : Separate<["-"], "fvisibility">,
519 HelpText<"Default type and symbol visibility">;
520 def ftype_visibility : Separate<["-"], "ftype-visibility">,
521 HelpText<"Default type visibility">;
522 def ftemplate_depth : Separate<["-"], "ftemplate-depth">,
523 HelpText<"Maximum depth of recursive template instantiation">;
524 def foperator_arrow_depth : Separate<["-"], "foperator-arrow-depth">,
525 HelpText<"Maximum number of 'operator->'s to call for a member access">;
526 def fconstexpr_depth : Separate<["-"], "fconstexpr-depth">,
527 HelpText<"Maximum depth of recursive constexpr function calls">;
528 def fconstexpr_steps : Separate<["-"], "fconstexpr-steps">,
529 HelpText<"Maximum number of steps in constexpr function evaluation">;
530 def fbracket_depth : Separate<["-"], "fbracket-depth">,
531 HelpText<"Maximum nesting level for parentheses, brackets, and braces">;
532 def fconst_strings : Flag<["-"], "fconst-strings">,
533 HelpText<"Use a const qualified type for string literals in C and ObjC">;
534 def fno_const_strings : Flag<["-"], "fno-const-strings">,
535 HelpText<"Don't use a const qualified type for string literals in C and ObjC">;
536 def fno_bitfield_type_align : Flag<["-"], "fno-bitfield-type-align">,
537 HelpText<"Ignore bit-field types when aligning structures">;
538 def ffake_address_space_map : Flag<["-"], "ffake-address-space-map">,
539 HelpText<"Use a fake address space map; OpenCL testing purposes only">;
540 def faddress_space_map_mangling_EQ : Joined<["-"], "faddress-space-map-mangling=">, MetaVarName<"<yes|no|target>">,
541 HelpText<"Set the mode for address space map based mangling; OpenCL testing purposes only">;
542 def funknown_anytype : Flag<["-"], "funknown-anytype">,
543 HelpText<"Enable parser support for the __unknown_anytype type; for testing purposes only">;
544 def fdebugger_support : Flag<["-"], "fdebugger-support">,
545 HelpText<"Enable special debugger support behavior">;
546 def fdebugger_cast_result_to_id : Flag<["-"], "fdebugger-cast-result-to-id">,
547 HelpText<"Enable casting unknown expression results to id">;
548 def fdebugger_objc_literal : Flag<["-"], "fdebugger-objc-literal">,
549 HelpText<"Enable special debugger support for Objective-C subscripting and literals">;
550 def fdeprecated_macro : Flag<["-"], "fdeprecated-macro">,
551 HelpText<"Defines the __DEPRECATED macro">;
552 def fno_deprecated_macro : Flag<["-"], "fno-deprecated-macro">,
553 HelpText<"Undefines the __DEPRECATED macro">;
554 def fobjc_subscripting_legacy_runtime : Flag<["-"], "fobjc-subscripting-legacy-runtime">,
555 HelpText<"Allow Objective-C array and dictionary subscripting in legacy runtime">;
556 def vtordisp_mode_EQ : Joined<["-"], "vtordisp-mode=">,
557 HelpText<"Control vtordisp placement on win32 targets">;
558 def fno_rtti_data : Flag<["-"], "fno-rtti-data">,
559 HelpText<"Control emission of RTTI data">;
560 def fnative_half_type: Flag<["-"], "fnative-half-type">,
561 HelpText<"Use the native half type for __fp16 instead of promoting to float">;
562 def fallow_half_arguments_and_returns : Flag<["-"], "fallow-half-arguments-and-returns">,
563 HelpText<"Allow function arguments and returns of type half">;
565 //===----------------------------------------------------------------------===//
566 // Header Search Options
567 //===----------------------------------------------------------------------===//
569 def nostdsysteminc : Flag<["-"], "nostdsysteminc">,
570 HelpText<"Disable standard system #include directories">;
571 def fdisable_module_hash : Flag<["-"], "fdisable-module-hash">,
572 HelpText<"Disable the module hash">;
573 def c_isystem : JoinedOrSeparate<["-"], "c-isystem">, MetaVarName<"<directory>">,
574 HelpText<"Add directory to the C SYSTEM include search path">;
575 def objc_isystem : JoinedOrSeparate<["-"], "objc-isystem">,
576 MetaVarName<"<directory>">,
577 HelpText<"Add directory to the ObjC SYSTEM include search path">;
578 def objcxx_isystem : JoinedOrSeparate<["-"], "objcxx-isystem">,
579 MetaVarName<"<directory>">,
580 HelpText<"Add directory to the ObjC++ SYSTEM include search path">;
581 def internal_isystem : JoinedOrSeparate<["-"], "internal-isystem">,
582 MetaVarName<"<directory>">,
583 HelpText<"Add directory to the internal system include search path; these "
584 "are assumed to not be user-provided and are used to model system "
585 "and standard headers' paths.">;
586 def internal_externc_isystem : JoinedOrSeparate<["-"], "internal-externc-isystem">,
587 MetaVarName<"<directory>">,
588 HelpText<"Add directory to the internal system include search path with "
589 "implicit extern \"C\" semantics; these are assumed to not be "
590 "user-provided and are used to model system and standard headers' "
593 //===----------------------------------------------------------------------===//
594 // Preprocessor Options
595 //===----------------------------------------------------------------------===//
597 def include_pth : Separate<["-"], "include-pth">, MetaVarName<"<file>">,
598 HelpText<"Include file before parsing">;
599 def chain_include : Separate<["-"], "chain-include">, MetaVarName<"<file>">,
600 HelpText<"Include and chain a header file after turning it into PCH">;
601 def preamble_bytes_EQ : Joined<["-"], "preamble-bytes=">,
602 HelpText<"Assume that the precompiled header is a precompiled preamble "
603 "covering the first N bytes of the main file">;
604 def token_cache : Separate<["-"], "token-cache">, MetaVarName<"<path>">,
605 HelpText<"Use specified token cache file">;
606 def detailed_preprocessing_record : Flag<["-"], "detailed-preprocessing-record">,
607 HelpText<"include a detailed record of preprocessing actions">;
609 //===----------------------------------------------------------------------===//
611 //===----------------------------------------------------------------------===//
613 def cl_opt_disable : Flag<["-"], "cl-opt-disable">,
614 HelpText<"OpenCL only. This option disables all optimizations. The default is optimizations are enabled.">;
615 def cl_strict_aliasing : Flag<["-"], "cl-strict-aliasing">,
616 HelpText<"OpenCL only. This option does nothing and is for compatibility with OpenCL 1.0">;
617 def cl_single_precision_constant : Flag<["-"], "cl-single-precision-constant">,
618 HelpText<"OpenCL only. Treat double precision floating-point constant as single precision constant.">;
619 def cl_finite_math_only : Flag<["-"], "cl-finite-math-only">,
620 HelpText<"OpenCL only. Allow floating-point optimizations that assume arguments and results are not NaNs or +-Inf.">;
621 def cl_kernel_arg_info : Flag<["-"], "cl-kernel-arg-info">,
622 HelpText<"OpenCL only. Generate kernel argument metadata.">;
623 def cl_unsafe_math_optimizations : Flag<["-"], "cl-unsafe-math-optimizations">,
624 HelpText<"OpenCL only. Allow unsafe floating-point optimizations. Also implies -cl-no-signed-zeros and -cl-mad-enable">;
625 def cl_fast_relaxed_math : Flag<["-"], "cl-fast-relaxed-math">,
626 HelpText<"OpenCL only. Sets -cl-finite-math-only and -cl-unsafe-math-optimizations, and defines __FAST_RELAXED_MATH__">;
627 def cl_mad_enable : Flag<["-"], "cl-mad-enable">,
628 HelpText<"OpenCL only. Enable less precise MAD instructions to be generated.">;
629 def cl_std_EQ : Joined<["-"], "cl-std=">,
630 HelpText<"OpenCL language standard to compile for">;
631 def cl_denorms_are_zero : Flag<["-"], "cl-denorms-are-zero">,
632 HelpText<"OpenCL only. Allow denormals to be flushed to zero">;
634 //===----------------------------------------------------------------------===//
636 //===----------------------------------------------------------------------===//
638 def fcuda_is_device : Flag<["-"], "fcuda-is-device">,
639 HelpText<"Generate code for CUDA device">;
640 def fcuda_allow_host_calls_from_host_device : Flag<["-"],
641 "fcuda-allow-host-calls-from-host-device">,
642 HelpText<"Allow host device functions to call host functions">;
643 def fcuda_disable_target_call_checks : Flag<["-"],
644 "fcuda-disable-target-call-checks">,
645 HelpText<"Disable all cross-target (host, device, etc.) call checks in CUDA">;
646 def fcuda_include_gpubinary : Separate<["-"], "fcuda-include-gpubinary">,
647 HelpText<"Incorporate CUDA device-side binary into host object file.">;
649 } // let Flags = [CC1Option]
652 //===----------------------------------------------------------------------===//
653 // cc1as-only Options
654 //===----------------------------------------------------------------------===//
656 let Flags = [CC1AsOption, NoDriverOption] in {
659 def n : Flag<["-"], "n">,
660 HelpText<"Don't automatically start assembly file with a text section">;
663 def filetype : Separate<["-"], "filetype">,
664 HelpText<"Specify the output file type ('asm', 'null', or 'obj')">;
666 // Transliterate Options
667 def output_asm_variant : Separate<["-"], "output-asm-variant">,
668 HelpText<"Select the asm variant index to use for output">;
669 def show_encoding : Flag<["-"], "show-encoding">,
670 HelpText<"Show instruction encoding information in transliterate mode">;
671 def show_inst : Flag<["-"], "show-inst">,
672 HelpText<"Show internal instruction representation in transliterate mode">;
675 def dwarf_debug_producer : Separate<["-"], "dwarf-debug-producer">,
676 HelpText<"The string to embed in the Dwarf debug AT_producer record.">;
678 } // let Flags = [CC1AsOption]