CC1Options.td revision fc2844846e91398205fddc71196fe9dda04e105f
1//===--- 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 17//===----------------------------------------------------------------------===// 18// Target Options 19//===----------------------------------------------------------------------===// 20 21def target_abi : Separate<"-target-abi">, 22 HelpText<"Target a particular ABI type">; 23def mcpu : Separate<"-mcpu">, 24 HelpText<"Target a specific cpu type ('-mcpu help' for details)">; 25def target_feature : Separate<"-target-feature">, 26 HelpText<"Target specific attributes">; 27def triple : Separate<"-triple">, 28 HelpText<"Specify target triple (e.g. i686-apple-darwin9)">; 29def triple_EQ : Joined<"-triple=">, Alias<triple>; 30 31//===----------------------------------------------------------------------===// 32// Analyzer Options 33//===----------------------------------------------------------------------===// 34 35def analysis_CFGDump : Flag<"-cfg-dump">, 36 HelpText<"Display Control-Flow Graphs">; 37def analysis_CFGView : Flag<"-cfg-view">, 38 HelpText<"View Control-Flow Graphs using GraphViz">; 39def analysis_DisplayLiveVariables : Flag<"-dump-live-variables">, 40 HelpText<"Print results of live variable analysis">; 41def analysis_SecuritySyntacticChecks : Flag<"-warn-security-syntactic">, 42 HelpText<"Perform quick security checks that require no data flow">; 43def analysis_WarnDeadStores : Flag<"-warn-dead-stores">, 44 HelpText<"Warn about stores to dead variables">; 45def analysis_WarnUninitVals : Flag<"-warn-uninit-values">, 46 HelpText<"Warn about uses of uninitialized variables">; 47def analysis_WarnObjCMethSigs : Flag<"-warn-objc-methodsigs">, 48 HelpText<"Warn about Objective-C method signatures with type incompatibilities">; 49def analysis_WarnObjCDealloc : Flag<"-warn-objc-missing-dealloc">, 50 HelpText<"Warn about Objective-C classes that lack a correct implementation of -dealloc">; 51def analysis_WarnObjCUnusedIvars : Flag<"-warn-objc-unused-ivars">, 52 HelpText<"Warn about private ivars that are never used">; 53def analysis_CheckerCFRef : Flag<"-checker-cfref">, 54 HelpText<"Run the [Core] Foundation reference count checker">; 55def analysis_WarnSizeofPointer : Flag<"-warn-sizeof-pointer">, 56 HelpText<"Warn about unintended use of sizeof() on pointer expressions">; 57def analysis_InlineCall : Flag<"-inline-call">, 58 HelpText<"Experimental transfer function inlining callees when its definition is available.">; 59 60def analyzer_store : Separate<"-analyzer-store">, 61 HelpText<"Source Code Analysis - Abstract Memory Store Models">; 62def analyzer_store_EQ : Joined<"-analyzer-store=">, Alias<analyzer_store>; 63 64def analyzer_constraints : Separate<"-analyzer-constraints">, 65 HelpText<"Source Code Analysis - Symbolic Constraint Engines">; 66def analyzer_constraints_EQ : Joined<"-analyzer-constraints=">, 67 Alias<analyzer_constraints>; 68 69def analyzer_output : Separate<"-analyzer-output">, 70 HelpText<"Source Code Analysis - Output Options">; 71def analyzer_output_EQ : Joined<"-analyzer-output=">, 72 Alias<analyzer_output>; 73 74def analyzer_opt_analyze_headers : Flag<"-analyzer-opt-analyze-headers">, 75 HelpText<"Force the static analyzer to analyze functions defined in header files">; 76def analyzer_opt_analyze_nested_blocks : Flag<"-analyzer-opt-analyze-nested-blocks">, 77 HelpText<"Analyze the definitions of blocks in addition to functions">; 78def analyzer_display_progress : Flag<"-analyzer-display-progress">, 79 HelpText<"Emit verbose output about the analyzer's progress">; 80def analyzer_experimental_checks : Flag<"-analyzer-experimental-checks">, 81 HelpText<"Use experimental path-sensitive checks">; 82def analyzer_experimental_internal_checks : 83 Flag<"-analyzer-experimental-internal-checks">, 84 HelpText<"Use new default path-sensitive checks currently in testing">; 85def analyze_function : Separate<"-analyze-function">, 86 HelpText<"Run analysis on specific function">; 87def analyze_function_EQ : Joined<"-analyze-function=">, Alias<analyze_function>; 88def analyzer_eagerly_assume : Flag<"-analyzer-eagerly-assume">, 89 HelpText<"Eagerly assume the truth/falseness of some symbolic constraints">; 90def analyzer_no_purge_dead : Flag<"-analyzer-no-purge-dead">, 91 HelpText<"Don't remove dead symbols, bindings, and constraints before processing a statement">; 92def trim_egraph : Flag<"-trim-egraph">, 93 HelpText<"Only show error-related paths in the analysis graph">; 94def analyzer_viz_egraph_graphviz : Flag<"-analyzer-viz-egraph-graphviz">, 95 HelpText<"Display exploded graph using GraphViz">; 96def analyzer_viz_egraph_ubigraph : Flag<"-analyzer-viz-egraph-ubigraph">, 97 HelpText<"Display exploded graph using Ubigraph">; 98 99//===----------------------------------------------------------------------===// 100// CodeGen Options 101//===----------------------------------------------------------------------===// 102 103def disable_llvm_optzns : Flag<"-disable-llvm-optzns">, 104 HelpText<"Don't run LLVM optimization passes">; 105def disable_red_zone : Flag<"-disable-red-zone">, 106 HelpText<"Do not emit code that uses the red zone.">; 107def g : Flag<"-g">, HelpText<"Generate source level debug information">; 108def fcatch_undefined_behavior : Flag<"-fcatch-undefined-behavior">, 109 HelpText<"Generate runtime checks for undefined behavior.">; 110def fno_common : Flag<"-fno-common">, 111 HelpText<"Compile common globals like normal definitions">; 112def no_implicit_float : Flag<"-no-implicit-float">, 113 HelpText<"Don't generate implicit floating point instructions (x86-only)">; 114def fno_merge_all_constants : Flag<"-fno-merge-all-constants">, 115 HelpText<"Disallow merging of constants.">; 116def masm_verbose : Flag<"-masm-verbose">, 117 HelpText<"Generate verbose assembly output">; 118def mcode_model : Separate<"-mcode-model">, 119 HelpText<"The code model to use">; 120def mdebug_pass : Separate<"-mdebug-pass">, 121 HelpText<"Enable additional debug output">; 122def mdisable_fp_elim : Flag<"-mdisable-fp-elim">, 123 HelpText<"Disable frame pointer elimination optimization">; 124def mfloat_abi : Separate<"-mfloat-abi">, 125 HelpText<"The float ABI to use">; 126def mlimit_float_precision : Separate<"-mlimit-float-precision">, 127 HelpText<"Limit float precision to the given value">; 128def mno_zero_initialized_in_bss : Flag<"-mno-zero-initialized-in-bss">, 129 HelpText<"Do not put zero initialized data in the BSS">; 130def msoft_float : Flag<"-msoft-float">, 131 HelpText<"Use software floating point">; 132def mrelocation_model : Separate<"-mrelocation-model">, 133 HelpText<"The relocation model to use">; 134def munwind_tables : Flag<"-munwind-tables">, 135 HelpText<"Generate unwinding tables for all functions">; 136def O : Joined<"-O">, HelpText<"Optimization level">; 137def Os : Flag<"-Os">, HelpText<"Optimize for size">; 138 139//===----------------------------------------------------------------------===// 140// Dependency Output Options 141//===----------------------------------------------------------------------===// 142 143def dependency_file : Separate<"-dependency-file">, 144 HelpText<"Filename (or -) to write dependency output to">; 145def sys_header_deps : Flag<"-sys-header-deps">, 146 HelpText<"Include system headers in dependency output">; 147def MT : Separate<"-MT">, HelpText<"Specify target for dependency">; 148def MP : Flag<"-MP">, 149 HelpText<"Create phony target for each dependency (other than main file)">; 150 151//===----------------------------------------------------------------------===// 152// Diagnostic Options 153//===----------------------------------------------------------------------===// 154 155def dump_build_information : Separate<"-dump-build-information">, 156 MetaVarName<"<filename>">, 157 HelpText<"output a dump of some build information to a file">; 158def fno_show_column : Flag<"-fno-show-column">, 159 HelpText<"Do not include column number on diagnostics">; 160def fno_show_source_location : Flag<"-fno-show-source-location">, 161 HelpText<"Do not include source location information with diagnostics">; 162def fno_caret_diagnostics : Flag<"-fno-caret-diagnostics">, 163 HelpText<"Do not include source line and caret with diagnostics">; 164def fno_diagnostics_fixit_info : Flag<"-fno-diagnostics-fixit-info">, 165 HelpText<"Do not include fixit information in diagnostics">; 166def w : Flag<"-w">, HelpText<"Suppress all warnings">; 167def pedantic : Flag<"-pedantic">; 168def pedantic_errors : Flag<"-pedantic-errors">; 169 170// This gets all -W options, including -Werror, -W[no-]system-headers, etc. The 171// driver has stripped off -Wa,foo etc. The driver has also translated -W to 172// -Wextra, so we don't need to worry about it. 173def W : Joined<"-W">; 174 175def fdiagnostics_print_source_range_info : Flag<"-fdiagnostics-print-source-range-info">, 176 HelpText<"Print source range spans in numeric form">; 177def fdiagnostics_show_option : Flag<"-fdiagnostics-show-option">, 178 HelpText<"Print diagnostic name with mappable diagnostics">; 179def fmessage_length : Separate<"-fmessage-length">, MetaVarName<"<N>">, 180 HelpText<"Format message diagnostics so that they fit within N columns or fewer, when possible.">; 181def fcolor_diagnostics : Flag<"-fcolor-diagnostics">, 182 HelpText<"Use colors in diagnostics">; 183def Wno_rewrite_macros : Flag<"-Wno-rewrite-macros">, 184 HelpText<"Silence ObjC rewriting warnings">; 185def verify : Flag<"-verify">, 186 HelpText<"Verify emitted diagnostics and warnings">; 187 188//===----------------------------------------------------------------------===// 189// Frontend Options 190//===----------------------------------------------------------------------===// 191 192// This isn't normally used, it is just here so we can parse a 193// CompilerInvocation out of a driver-derived argument vector. 194def cc1 : Flag<"-cc1">; 195 196def code_completion_at : Separate<"-code-completion-at">, 197 MetaVarName<"<file>:<line>:<column>">, 198 HelpText<"Dump code-completion information at a location">; 199def remap_file : Separate<"-remap-file">, 200 MetaVarName<"<from>;<to>">, 201 HelpText<"Replace the contents of the <from> file with the contents of the <to> file">; 202def code_completion_at_EQ : Joined<"-code-completion-at=">, 203 Alias<code_completion_at>; 204def no_code_completion_debug_printer : Flag<"-no-code-completion-debug-printer">, 205 HelpText<"Don't use the \"debug\" code-completion print">; 206def code_completion_macros : Flag<"-code-completion-macros">, 207 HelpText<"Include macros in code-completion results">; 208def disable_free : Flag<"-disable-free">, 209 HelpText<"Disable freeing of memory on exit">; 210def empty_input_only : Flag<"-empty-input-only">, 211 HelpText<"Force running on an empty input file">; 212def help : Flag<"-help">, 213 HelpText<"Print this help text">; 214def _help : Flag<"--help">, Alias<help>; 215def x : Separate<"-x">, HelpText<"Input language type">; 216def cxx_inheritance_view : Separate<"-cxx-inheritance-view">, 217 MetaVarName<"<class name>">, 218 HelpText<"View C++ inheritance for a specified class">; 219def fixit_at : Separate<"-fixit-at">, MetaVarName<"<source location>">, 220 HelpText<"Perform Fix-It modifications at the given source location">; 221def o : Separate<"-o">, MetaVarName<"<path>">, HelpText<"Specify output file">; 222def load : Separate<"-load">, MetaVarName<"<dsopath>">, 223 HelpText<"Load the named plugin (dynamic shared object)">; 224def plugin : Separate<"-plugin">, 225 HelpText<"Use the named plugin action (use \"help\" to list available options)">; 226def resource_dir : Separate<"-resource-dir">, 227 HelpText<"The directory which holds the compiler resource files">; 228def version : Flag<"-version">, 229 HelpText<"Print the compiler version">; 230def _version : Flag<"--version">, Alias<version>; 231 232def Action_Group : OptionGroup<"<action group>">; 233let Group = Action_Group in { 234 235def Eonly : Flag<"-Eonly">, 236 HelpText<"Just run preprocessor, no output (for timings)">; 237def E : Flag<"-E">, 238 HelpText<"Run preprocessor, emit preprocessed file">; 239def dump_raw_tokens : Flag<"-dump-raw-tokens">, 240 HelpText<"Lex file in raw mode and dump raw tokens">; 241def analyze : Flag<"-analyze">, 242 HelpText<"Run static analysis engine">; 243def dump_tokens : Flag<"-dump-tokens">, 244 HelpText<"Run preprocessor, dump internal rep of tokens">; 245def parse_noop : Flag<"-parse-noop">, 246 HelpText<"Run parser with noop callbacks (for timings)">; 247def fsyntax_only : Flag<"-fsyntax-only">, 248 HelpText<"Run parser and perform semantic analysis">; 249def fixit : Flag<"-fixit">, 250 HelpText<"Apply fix-it advice to the input source">; 251def parse_print_callbacks : Flag<"-parse-print-callbacks">, 252 HelpText<"Run parser and print each callback invoked">; 253def emit_html : Flag<"-emit-html">, 254 HelpText<"Output input source as HTML">; 255def ast_print : Flag<"-ast-print">, 256 HelpText<"Build ASTs and then pretty-print them">; 257def ast_print_xml : Flag<"-ast-print-xml">, 258 HelpText<"Build ASTs and then print them in XML format">; 259def ast_dump : Flag<"-ast-dump">, 260 HelpText<"Build ASTs and then debug dump them">; 261def ast_view : Flag<"-ast-view">, 262 HelpText<"Build ASTs and view them with GraphViz">; 263def print_decl_contexts : Flag<"-print-decl-contexts">, 264 HelpText<"Print DeclContexts and their Decls">; 265def dump_record_layouts : Flag<"-dump-record-layouts">, 266 HelpText<"Dump record layout information">; 267def emit_pth : Flag<"-emit-pth">, 268 HelpText<"Generate pre-tokenized header file">; 269def emit_pch : Flag<"-emit-pch">, 270 HelpText<"Generate pre-compiled header file">; 271def S : Flag<"-S">, 272 HelpText<"Emit native assembly code">; 273def emit_llvm : Flag<"-emit-llvm">, 274 HelpText<"Build ASTs then convert to LLVM, emit .ll file">; 275def emit_llvm_bc : Flag<"-emit-llvm-bc">, 276 HelpText<"Build ASTs then convert to LLVM, emit .bc file">; 277def emit_llvm_only : Flag<"-emit-llvm-only">, 278 HelpText<"Build ASTs and convert to LLVM, discarding output">; 279def rewrite_test : Flag<"-rewrite-test">, 280 HelpText<"Rewriter playground">; 281def rewrite_objc : Flag<"-rewrite-objc">, 282 HelpText<"Rewrite ObjC into C (code rewriter example)">; 283def rewrite_macros : Flag<"-rewrite-macros">, 284 HelpText<"Expand macros without full preprocessing">; 285def rewrite_blocks : Flag<"-rewrite-blocks">, 286 HelpText<"Rewrite Blocks to C">; 287 288} 289 290def relocatable_pch : Flag<"-relocatable-pch">, 291 HelpText<"Whether to build a relocatable precompiled header">; 292def print_stats : Flag<"-print-stats">, 293 HelpText<"Print performance metrics and statistics">; 294def ftime_report : Flag<"-ftime-report">, 295 HelpText<"Print the amount of time each phase of compilation takes">; 296 297//===----------------------------------------------------------------------===// 298// Language Options 299//===----------------------------------------------------------------------===// 300 301def fno_builtin : Flag<"-fno-builtin">, 302 HelpText<"Disable implicit builtin knowledge of functions">; 303def faltivec : Flag<"-faltivec">, 304 HelpText<"Enable AltiVec vector initializer syntax">; 305def faccess_control : Flag<"-faccess-control">, 306 HelpText<"Enable C++ access control">; 307def fno_assume_sane_operator_new : Flag<"-fno-assume-sane-operator-new">, 308 HelpText<"Don't assume that C++'s new operator is sane">; 309def fdollars_in_identifiers : Flag<"-fdollars-in-identifiers">, 310 HelpText<"Allow '$' in identifiers">; 311def femit_all_decls : Flag<"-femit-all-decls">, 312 HelpText<"Emit all declarations, even if unused">; 313def fblocks : Flag<"-fblocks">, 314 HelpText<"enable the 'blocks' language feature">; 315def fheinous_gnu_extensions : Flag<"-fheinous-gnu-extensions">; 316def fexceptions : Flag<"-fexceptions">, 317 HelpText<"Enable support for exception handling">; 318def ffreestanding : Flag<"-ffreestanding">, 319 HelpText<"Assert that the compilation takes place in a freestanding environment">; 320def fgnu_runtime : Flag<"-fgnu-runtime">, 321 HelpText<"Generate output compatible with the standard GNU Objective-C runtime">; 322def std_EQ : Joined<"-std=">, 323 HelpText<"Language standard to compile for">; 324def fms_extensions : Flag<"-fms-extensions">, 325 HelpText<"Accept some non-standard constructs used in Microsoft header files ">; 326def main_file_name : Separate<"-main-file-name">, 327 HelpText<"Main file name to use for debug info">; 328def fno_elide_constructors : Flag<"-fno-elide-constructors">, 329 HelpText<"Disable C++ copy constructor elision">; 330def fno_lax_vector_conversions : Flag<"-fno-lax-vector-conversions">, 331 HelpText<"Disallow implicit conversions between vectors with a different number of elements or different element types">; 332def fno_math_errno : Flag<"-fno-math-errno">, 333 HelpText<"Don't require math functions to respect errno">; 334def fno_signed_char : Flag<"-fno-signed-char">, 335 HelpText<"Char is unsigned">; 336def fno_operator_names : Flag<"-fno-operator-names">, 337 HelpText<"Do not treat C++ operator name keywords as synonyms for operators">; 338def fconstant_string_class : Separate<"-fconstant-string-class">, 339 MetaVarName<"<class name>">, 340 HelpText<"Specify the class to use for constant Objective-C string objects.">; 341def fobjc_gc : Flag<"-fobjc-gc">, 342 HelpText<"Enable Objective-C garbage collection">; 343def fobjc_gc_only : Flag<"-fobjc-gc-only">, 344 HelpText<"Use GC exclusively for Objective-C related memory management">; 345def print_ivar_layout : Flag<"-print-ivar-layout">, 346 HelpText<"Enable Objective-C Ivar layout bitmap print trace">; 347def fobjc_nonfragile_abi : Flag<"-fobjc-nonfragile-abi">, 348 HelpText<"enable objective-c's nonfragile abi">; 349def ftrapv : Flag<"-ftrapv">, 350 HelpText<"Trap on integer overflow">; 351def pic_level : Separate<"-pic-level">, 352 HelpText<"Value for __PIC__">; 353def pthread : Flag<"-pthread">, 354 HelpText<"Support POSIX threads in generated code">; 355def fpascal_strings : Flag<"-fpascal-strings">, 356 HelpText<"Recognize and construct Pascal-style string literals">; 357def fno_rtti : Flag<"-fno-rtti">, 358 HelpText<"Disable generation of rtti information">; 359def fshort_wchar : Flag<"-fshort-wchar">, 360 HelpText<"Force wchar_t to be a short unsigned int">; 361def static_define : Flag<"-static-define">, 362 HelpText<"Should __STATIC__ be defined">; 363def stack_protector : Separate<"-stack-protector">, 364 HelpText<"Enable stack protectors">; 365def fvisibility : Separate<"-fvisibility">, 366 HelpText<"Default symbol visibility">; 367def ftemplate_depth : Separate<"-ftemplate-depth">, 368 HelpText<"Maximum depth of recursive template instantiation">; 369def trigraphs : Flag<"-trigraphs">, 370 HelpText<"Process trigraph sequences">; 371def fwritable_strings : Flag<"-fwritable-strings">, 372 HelpText<"Store string literals as writable data">; 373 374//===----------------------------------------------------------------------===// 375// Header Search Options 376//===----------------------------------------------------------------------===// 377 378def nostdinc : Flag<"-nostdinc">, 379 HelpText<"Disable standard #include directories">; 380def nobuiltininc : Flag<"-nobuiltininc">, 381 HelpText<"Disable builtin #include directories">; 382def F : JoinedOrSeparate<"-F">, MetaVarName<"<directory>">, 383 HelpText<"Add directory to framework include search path">; 384def I : JoinedOrSeparate<"-I">, MetaVarName<"<directory>">, 385 HelpText<"Add directory to include search path">; 386def idirafter : JoinedOrSeparate<"-idirafter">, MetaVarName<"<directory>">, 387 HelpText<"Add directory to AFTER include search path">; 388def iquote : JoinedOrSeparate<"-iquote">, MetaVarName<"<directory>">, 389 HelpText<"Add directory to QUOTE include search path">; 390def isystem : JoinedOrSeparate<"-isystem">, MetaVarName<"<directory>">, 391 HelpText<"Add directory to SYSTEM include search path">; 392def iprefix : JoinedOrSeparate<"-iprefix">, MetaVarName<"<prefix>">, 393 HelpText<"Set the -iwithprefix/-iwithprefixbefore prefix">; 394def iwithprefix : JoinedOrSeparate<"-iwithprefix">, MetaVarName<"<dir>">, 395 HelpText<"Set directory to SYSTEM include search path with prefix">; 396def iwithprefixbefore : JoinedOrSeparate<"-iwithprefixbefore">, 397 MetaVarName<"<dir>">, 398 HelpText<"Set directory to include search path with prefix">; 399def isysroot : JoinedOrSeparate<"-isysroot">, MetaVarName<"<dir>">, 400 HelpText<"Set the system root directory (usually /)">; 401def v : Flag<"-v">, HelpText<"Enable verbose output">; 402 403//===----------------------------------------------------------------------===// 404// Preprocessor Options 405//===----------------------------------------------------------------------===// 406 407def D : JoinedOrSeparate<"-D">, MetaVarName<"<macro>">, 408 HelpText<"Predefine the specified macro">; 409def include_ : JoinedOrSeparate<"-include">, MetaVarName<"<file>">, EnumName<"include">, 410 HelpText<"Include file before parsing">; 411def imacros : JoinedOrSeparate<"-imacros">, MetaVarName<"<file>">, 412 HelpText<"Include macros from file before parsing">; 413def include_pch : Separate<"-include-pch">, MetaVarName<"<file>">, 414 HelpText<"Include precompiled header file">; 415def include_pth : Separate<"-include-pth">, MetaVarName<"<file>">, 416 HelpText<"Include file before parsing">; 417def token_cache : Separate<"-token-cache">, MetaVarName<"<path>">, 418 HelpText<"Use specified token cache file">; 419def U : JoinedOrSeparate<"-U">, MetaVarName<"<macro>">, 420 HelpText<"Undefine the specified macro">; 421def undef : Flag<"-undef">, MetaVarName<"<macro>">, 422 HelpText<"undef all system defines">; 423 424//===----------------------------------------------------------------------===// 425// Preprocessed Output Options 426//===----------------------------------------------------------------------===// 427 428def P : Flag<"-P">, 429 HelpText<"Disable linemarker output in -E mode">; 430def C : Flag<"-C">, 431 HelpText<"Enable comment output in -E mode">; 432def CC : Flag<"-CC">, 433 HelpText<"Enable comment output in -E mode, even from macro expansions">; 434def dM : Flag<"-dM">, 435 HelpText<"Print macro definitions in -E mode instead of normal output">; 436def dD : Flag<"-dD">, 437 HelpText<"Print macro definitions in -E mode in addition to normal output">; 438