1 ; Options for the language- and target-independent parts of the compiler.
3 ; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
4 ; Free Software Foundation, Inc.
6 ; This file is part of GCC.
8 ; GCC is free software; you can redistribute it and/or modify it under
9 ; the terms of the GNU General Public License as published by the Free
10 ; Software Foundation; either version 3, or (at your option) any later
13 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 ; FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 ; You should have received a copy of the GNU General Public License
19 ; along with GCC; see the file COPYING3. If not see
20 ; <http://www.gnu.org/licenses/>.
22 ; See the GCC internals manual (options.texi) for a description of this file's format.
24 ; Please try to keep this file in ASCII collating order.
28 Display this information
32 --help=<class> Display descriptions of a specific class of options. <class> is one or more of optimizers, target, warnings, undocumented, params
36 Alias for --help=target
38 ;; The following four entries are to work around the gcc driver
39 ;; program's insatiable desire to turn options starting with a
40 ;; double dash (--) into options starting with a dash f (-f).
55 --param <param>=<value> Set parameter <param> to value. See below for a complete list of parameters
61 Common Joined Separate UInteger
62 -G<number> Put global and static data smaller than <number> bytes into a special section (on some targets)
65 Common JoinedOrMissing Optimization
66 -O<number> Set optimization level to <number>
70 Optimize for space rather than speed
73 Common RejectNegative Var(extra_warnings) Warning
74 This switch is deprecated; use -Wextra instead
77 Common Var(warn_aggregate_return) Warning
78 Warn about returning structures, unions or arrays
81 Common Var(warn_array_bounds) Warning
82 Warn if an array is accessed out of bounds
85 Common Var(warn_attributes) Init(1) Warning
86 Warn about inappropriate attribute usage
89 Common Var(warn_cast_align) Warning
90 Warn about pointer casts which increase alignment
93 Common Var(warn_cpp) Init(1) Warning
94 Warn when a #warning directive is encountered
96 Wdeprecated-declarations
97 Common Var(warn_deprecated_decl) Init(1) Warning
98 Warn about uses of __attribute__((deprecated)) declarations
100 Wdisabled-optimization
101 Common Var(warn_disabled_optimization) Warning
102 Warn when an optimization pass is disabled
105 Common Var(warnings_are_errors)
106 Treat all warnings as errors
110 Treat specified warning as error
113 Common Var(extra_warnings) Warning
114 Print extra (possibly unwanted) warnings
117 Common Var(flag_fatal_errors)
118 Exit on the first error occurred
121 Common RejectNegative Joined UInteger
122 -Wframe-larger-than=<number> Warn if a function's stack frame requires more than <number> bytes
125 Common Var(warn_inline) Warning
126 Warn when an inlined function cannot be inlined
129 Common RejectNegative Joined UInteger Warning Undocumented
132 Common RejectNegative Joined UInteger Warning
133 -Wlarger-than=<number> Warn if an object is larger than <number> bytes
135 Wunsafe-loop-optimizations
136 Common Var(warn_unsafe_loop_optimizations) Warning
137 Warn if the loop cannot be optimized due to nontrivial assumptions.
140 Common Var(warn_missing_noreturn) Warning
141 Warn about functions which might be candidates for __attribute__((noreturn))
144 Common Var(warn_mudflap) Init(1) Warning
145 Warn about constructs not instrumented by -fmudflap
148 Common Var(warn_overflow) Init(1) Warning
149 Warn about overflow in arithmetic expressions
152 Common Var(warn_packed) Warning
153 Warn when the packed attribute has no effect on struct layout
156 Common Var(warn_padded) Warning
157 Warn when padding is required to align structure members
160 Common Var(warn_shadow) Warning
161 Warn when one local variable shadows another
164 Common Var(warn_stack_protect) Warning
165 Warn when not issuing stack smashing protection for some reason
169 Warn about code which might break strict aliasing rules
172 Common Joined UInteger Var(warn_strict_aliasing) Init(-1) Warning
173 Warn about code which might break strict aliasing rules
177 Warn about optimizations that assume that signed overflow is undefined
180 Common Joined UInteger Var(warn_strict_overflow) Init(-1) Warning
181 Warn about optimizations that assume that signed overflow is undefined
184 Common Var(warn_switch) Warning
185 Warn about enumerated switches, with no default, missing a case
188 Common Var(warn_switch_default) Warning
189 Warn about enumerated switches missing a \"default:\" statement
192 Common Var(warn_switch_enum) Warning
193 Warn about all enumerated switches missing a specific case
196 Common Var(warn_system_headers) Warning
197 Do not suppress warnings from system headers
200 Common Var(warn_type_limits) Init(-1) Warning
201 Warn if a comparison is always true or always false due to the limited range of the data type
204 Common Var(warn_uninitialized) Init(-1) Warning
205 Warn about uninitialized automatic variables
209 Does nothing. Preserved for backward compatibility.
212 Common Var(warn_unused) Init(0) Warning
213 Enable all -Wunused- warnings
215 Wunused-but-set-parameter
216 Common Var(warn_unused_but_set_parameter) Init(-1) Warning
217 Warn when a function parameter is only set, otherwise unused
219 Wunused-but-set-variable
220 Common Var(warn_unused_but_set_variable) Init(-1) Warning
221 Warn when a variable is only set, otherwise unused
224 Common Var(warn_unused_function) Init(-1) Warning
225 Warn when a function is unused
228 Common Var(warn_unused_label) Init(-1) Warning
229 Warn when a label is unused
232 Common Var(warn_unused_parameter) Init(-1) Warning
233 Warn when a function parameter is unused
236 Common Var(warn_unused_value) Init(-1) Warning
237 Warn when an expression value is unused
240 Common Var(warn_unused_variable) Init(-1) Warning
241 Warn when a variable is unused
244 Common RejectNegative Var(warn_coverage_mismatch) Warning
245 Warn instead of error in case profiles in -fprofile-use do not match
249 -aux-info <file> Emit declaration information into <file>
262 -d<letters> Enable dumps from specific passes of the compiler
266 -dumpbase <file> Set the file basename to be used for dumps
270 -dumpdir <dir> Set the directory name to be used for dumps
272 ; The version of the C++ ABI in use. The following values are allowed:
274 ; 0: The version of the ABI believed most conformant with the C++ ABI
275 ; specification. This ABI may change as bugs are discovered and fixed.
276 ; Therefore, 0 will not necessarily indicate the same ABI in different
279 ; 1: The version of the ABI first used in G++ 3.2.
281 ; 2: The version of the ABI first used in G++ 3.4 (and current default).
283 ; 3: The version of the ABI that fixes the missing underscore
284 ; in template non-type arguments of pointer type.
286 ; 4: The version of the ABI that introduces unambiguous mangling of
289 ; Additional positive integers will be assigned as new versions of
290 ; the ABI become the default version of the ABI.
292 Common Joined UInteger Var(flag_abi_version) Init(2)
295 Common Report Var(align_functions,0) Optimization UInteger
296 Align the start of functions
299 Common RejectNegative Joined UInteger
302 Common Report Var(align_jumps,0) Optimization UInteger
303 Align labels which are only reached by jumping
306 Common RejectNegative Joined UInteger
309 Common Report Var(align_labels,0) Optimization UInteger
313 Common RejectNegative Joined UInteger
316 Common Report Var(align_loops) Optimization UInteger
317 Align the start of loops
320 Common RejectNegative Joined UInteger
324 Does nothing. Preserved for backward compatibility.
328 Does nothing. Preserved for backward compatibility.
330 fargument-noalias-global
332 Does nothing. Preserved for backward compatibility.
334 fargument-noalias-anything
336 Does nothing. Preserved for backward compatibility.
338 fasynchronous-unwind-tables
339 Common Report Var(flag_asynchronous_unwind_tables) Optimization
340 Generate unwind tables that are exact at each instruction boundary
343 Common Report Var(flag_auto_inc_dec) Init(1)
344 Generate auto-inc/dec instructions
346 ; -fcheck-bounds causes gcc to generate array bounds checks.
347 ; For C, C++ and ObjC: defaults off.
348 ; For Java: defaults to on.
349 ; For Fortran: defaults to off.
351 Common Report Var(flag_bounds_check)
352 Generate code to check bounds before indexing arrays
355 Common Report Var(flag_branch_on_count_reg) Init(1) Optimization
356 Replace add, compare, branch with branch on count register
358 fbranch-probabilities
359 Common Report Var(flag_branch_probabilities) Optimization
360 Use profiling information for branch probabilities
362 fbranch-target-load-optimize
363 Common Report Var(flag_branch_target_load_optimize) Optimization
364 Perform branch target load optimization before prologue / epilogue threading
366 fbranch-target-load-optimize2
367 Common Report Var(flag_branch_target_load_optimize2) Optimization
368 Perform branch target load optimization after prologue / epilogue threading
371 Common Report Var(flag_btr_bb_exclusive) Optimization
372 Restrict target load migration not to re-use registers in any basic block
375 Common Joined RejectNegative
376 -fcall-saved-<register> Mark <register> as being preserved across functions
379 Common Joined RejectNegative
380 -fcall-used-<register> Mark <register> as being corrupted by function calls
382 ; Nonzero for -fcaller-saves: allocate values in regs that need to
383 ; be saved across function calls, if that produces overall better code.
384 ; Optional now, so people can test it.
386 Common Report Var(flag_caller_saves) Optimization
387 Save registers around function calls
390 Common Report Var(flag_check_data_deps)
391 Compare the results of several data dependence analyzers.
394 Common Report Var(flag_no_common,0) Optimization
395 Do not put uninitialized globals in the common section
398 Common JoinedOrMissing RejectNegative Var(flag_compare_debug_opt)
399 -fcompare-debug[=<opts>] Compile with and without e.g. -gtoggle, and compare the final-insns dump
401 fcompare-debug-second
402 Common RejectNegative Var(flag_compare_debug)
403 Run only the second compilation of -fcompare-debug
406 Common Var(flag_conserve_stack) Optimization
407 Do not perform optimizations increasing noticeably stack usage
410 Common Report Var(flag_cprop_registers) Optimization
411 Perform a register copy-propagation optimization pass
414 Common Report Var(flag_crossjumping) Optimization
415 Perform cross-jumping optimization
418 Common Report Var(flag_cse_follow_jumps) Optimization
419 When running CSE, follow jumps to their targets
423 Does nothing. Preserved for backward compatibility.
426 Common Report Var(flag_cx_limited_range) Optimization
427 Omit range reduction step when performing complex division
430 Common Report Var(flag_cx_fortran_rules) Optimization
431 Complex multiplication and division follow Fortran rules
434 Common Report Var(flag_data_sections) Optimization
435 Place data items into their own section
439 List all available debugging counters with their limits and counts.
442 Common RejectNegative Joined
443 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...] Set the debug counter limit.
446 Common Joined RejectNegative
447 Map one directory name to another in debug information
449 ; Nonzero for -fdefer-pop: don't pop args after each function call
450 ; instead save them up to pop many calls' args with one insns.
452 Common Report Var(flag_defer_pop) Optimization
453 Defer popping functions args from stack until later
456 Common Report Var(flag_delayed_branch) Optimization
457 Attempt to fill delay slots of branch instructions
459 fdelete-null-pointer-checks
460 Common Report Var(flag_delete_null_pointer_checks) Init(1) Optimization
461 Delete useless null pointer checks
463 fdiagnostics-show-location=
464 Common Joined RejectNegative
465 -fdiagnostics-show-location=[once|every-line] How often to emit source location at the beginning of line-wrapped diagnostics
467 fdiagnostics-show-option
469 Amend appropriate diagnostic messages with the command line option that controls them
472 Common Joined RejectNegative
473 -fdump-<type> Dump various compiler internals to a file
476 Common RejectNegative Joined Var(flag_dump_final_insns)
477 -fdump-final-insns=filename Dump to filename the insns at the end of translation
480 Common Report Var(flag_dump_noaddr)
481 Suppress output of addresses in debugging dumps
484 Common Report Var(flag_dump_unnumbered) VarExists
485 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
487 fdump-unnumbered-links
488 Common Report Var(flag_dump_unnumbered_links) VarExists
489 Suppress output of previous and next insn numbers in debugging dumps
492 Common Report Var(flag_dwarf2_cfi_asm) Init(HAVE_GAS_CFI_DIRECTIVE)
493 Enable CFI tables via GAS assembler directives.
496 Common Report Var(flag_early_inlining) Init(1) Optimization
497 Perform early inlining
499 feliminate-dwarf2-dups
500 Common Report Var(flag_eliminate_dwarf2_dups)
501 Perform DWARF2 duplicate elimination
504 Common Report Var(flag_ipa_sra) Init(0) Optimization
505 Perform interprocedural reduction of aggregates
507 feliminate-unused-debug-symbols
508 Common Report Var(flag_debug_only_used_symbols)
509 Perform unused type elimination in debug info
511 feliminate-unused-debug-types
512 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
513 Perform unused type elimination in debug info
515 femit-class-debug-always
516 Common Report Var(flag_emit_class_debug_always) Init(0)
517 Do not suppress C++ class debug information.
520 Common Report Var(flag_enable_icf_debug)
521 Generate debug information to support Identical Code Folding (ICF)
524 Common Report Var(flag_exceptions) Optimization
525 Enable exception handling
527 fexpensive-optimizations
528 Common Report Var(flag_expensive_optimizations) Optimization
529 Perform a number of minor, expensive optimizations
532 Common Joined RejectNegative
533 -fexcess-precision=[fast|standard] Specify handling of excess floating-point precision
539 Common Report Var(flag_finite_math_only) Optimization
540 Assume no NaNs or infinities are generated
543 Common Joined RejectNegative
544 -ffixed-<register> Mark <register> as being unavailable to the compiler
547 Common Report Var(flag_float_store) Optimization
548 Don't allocate floats and doubles in extended-precision registers
552 Does nothing. Preserved for backward compatibility.
555 Common Report Var(flag_forward_propagate) Optimization
556 Perform a forward propagation pass on RTL
558 ; Nonzero means don't put addresses of constant functions in registers.
559 ; Used for compiling the Unix kernel, where strange substitutions are
560 ; done on the assembly output.
562 Common Report Var(flag_no_function_cse,0)
563 Allow function addresses to be held in registers
566 Common Report Var(flag_function_sections)
567 Place each function into its own section
570 Common Report Var(flag_gcse) Optimization
571 Perform global common subexpression elimination
574 Common Report Var(flag_gcse_lm) Init(1) Optimization
575 Perform enhanced load motion during global common subexpression elimination
578 Common Report Var(flag_gcse_sm) Init(0) Optimization
579 Perform store motion after global common subexpression elimination
582 Common Report Var(flag_gcse_las) Init(0) Optimization
583 Perform redundant load after store elimination in global common subexpression
587 Common Report Var(flag_gcse_after_reload) Optimization
588 Perform global common subexpression elimination after register allocation
591 ; This option is not documented yet as its semantics will change.
593 Common Report Var(flag_graphite)
594 Enable in and out of Graphite representation
597 Common Report Var(flag_graphite_identity) Optimization
598 Enable Graphite Identity transformation
600 floop-parallelize-all
601 Common Report Var(flag_loop_parallelize_all) Optimization
602 Mark all loops as parallel
605 Common Report Var(flag_loop_strip_mine) Optimization
606 Enable Loop Strip Mining transformation
609 Common Report Var(flag_loop_interchange) Optimization
610 Enable Loop Interchange transformation
613 Common Report Var(flag_loop_block) Optimization
614 Enable Loop Blocking transformation
616 fguess-branch-probability
617 Common Report Var(flag_guess_branch_prob) Optimization
618 Enable guessing of branch probabilities
620 ; Nonzero means ignore `#ident' directives. 0 means handle them.
621 ; Generate position-independent code for executables if possible
622 ; On SVR4 targets, it also controls whether or not to emit a
623 ; string identifying the compiler.
625 Common Report Var(flag_no_ident,0)
626 Process #ident directives
629 Common Report Var(flag_if_conversion) Optimization
630 Perform conversion of conditional jumps to branchless equivalents
633 Common Report Var(flag_if_conversion2) Optimization
634 Perform conversion of conditional jumps to conditional execution
636 ; -finhibit-size-directive inhibits output of .size for ELF.
637 ; This is used only for compiling crtstuff.c,
638 ; and it may be extended to other effects
639 ; needed for crtstuff.c on other systems.
640 finhibit-size-directive
641 Common Report Var(flag_inhibit_size_directive)
642 Do not generate .size directives
645 Common Report Var(flag_indirect_inlining)
646 Perform indirect inlining
648 ; Nonzero means that functions declared `inline' will be treated
649 ; as `static'. Prevents generation of zillions of copies of unused
650 ; static inline functions; instead, `inlines' are written out
651 ; only when actually used. Used in conjunction with -g. Also
652 ; does the right thing with #pragma interface.
654 Common Report Var(flag_no_inline,0) Init(0)
655 Pay attention to the \"inline\" keyword
657 finline-small-functions
658 Common Report Var(flag_inline_small_functions) Optimization
659 Integrate simple functions into their callers when code size is known to not growth
662 Common Report Var(flag_inline_functions) Optimization
663 Integrate simple functions into their callers
665 finline-functions-called-once
666 Common Report Var(flag_inline_functions_called_once) Init(1) Optimization
667 Integrate functions called once into their callers
670 Common RejectNegative Joined UInteger
673 Common RejectNegative Joined UInteger
674 -finline-limit=<number> Limit the size of inlined functions to <number>
676 finstrument-functions
677 Common Report Var(flag_instrument_function_entry_exit)
678 Instrument function entry and exit with profiling calls
680 finstrument-functions-exclude-function-list=
681 Common RejectNegative Joined
682 -finstrument-functions-exclude-function-list=name,... Do not instrument listed functions
684 finstrument-functions-exclude-file-list=
685 Common RejectNegative Joined
686 -finstrument-functions-exclude-file-list=filename,... Do not instrument functions listed in files
689 Common Report Var(flag_ipa_cp) Optimization
690 Perform Interprocedural constant propagation
693 Common Report Var(flag_ipa_cp_clone) Optimization
694 Perform cloning to make Interprocedural constant propagation stronger
697 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
698 Discover pure and const functions
701 Common Report Var(flag_ipa_pta) Init(0) Optimization
702 Perform interprocedural points-to analysis
705 Common Report Var(flag_ipa_reference) Init(0) Optimization
706 Discover readonly and non addressable static variables
709 Common Report Var(flag_ipa_type_escape) Init(0) Optimization
710 Type based escape and alias analysis
713 Common Report Var(flag_ipa_matrix_reorg) Optimization
714 Perform matrix layout flattening and transposing based
715 on profiling information.
718 Common Report Var(flag_ipa_struct_reorg)
719 Perform structure layout optimizations based
720 on profiling information.
723 Common Joined RejectNegative
724 -fira-algorithm=[CB|priority] Set the used IRA algorithm
727 Common Joined RejectNegative
728 -fira-region=[one|all|mixed] Set regions for IRA
731 Common Report Var(flag_ira_coalesce) Init(0)
732 Do optimistic coalescing.
735 Common Report Var(flag_ira_loop_pressure)
736 Use IRA based register pressure calculation
737 in RTL loop optimizations.
739 fira-share-save-slots
740 Common Report Var(flag_ira_share_save_slots) Init(1)
741 Share slots for saving different hard registers.
743 fira-share-spill-slots
744 Common Report Var(flag_ira_share_spill_slots) Init(1)
745 Share stack slots for spilled pseudo-registers.
748 Common RejectNegative Joined UInteger
749 -fira-verbose=<number> Control IRA's level of diagnostic messages.
752 Common Report Var(flag_ivopts) Init(1) Optimization
753 Optimize induction variables on trees
756 Common Var(flag_jump_tables) Init(1) Optimization
757 Use jump tables for sufficiently large switch statements
759 fkeep-inline-functions
760 Common Report Var(flag_keep_inline_functions)
761 Generate code for functions even if they are fully inlined
764 Common Report Var(flag_keep_static_consts) Init(1)
765 Emit static const variables even if they are not used
768 Common Report Var(flag_leading_underscore) Init(-1)
769 Give external symbols a leading underscore
773 Does nothing. Preserved for backward compatibility.
777 Enable link-time optimization.
779 ; The initial value of -1 comes from Z_DEFAULT_COMPRESSION in zlib.h.
780 flto-compression-level=
781 Common Joined UInteger Var(flag_lto_compression_level) Init(-1)
782 -flto-compression-level=<number> Use zlib compression level <number> for IL
785 Common Report Var(flag_lto_report) Init(0) Optimization
786 Report various link-time optimization statistics
789 Common Report Var(flag_errno_math) Init(1) Optimization
790 Set errno after built-in math functions
793 Common Report Var(mem_report)
794 Report on permanent memory allocation
796 ; This will attempt to merge constant section constants, if 1 only
797 ; string constants and constants from constant pool, if 2 also constant
800 Common Report Var(flag_merge_constants,2) Init(1) Optimization
801 Attempt to merge identical constants and constant variables
804 Common Report Var(flag_merge_constants,1) VarExists Optimization
805 Attempt to merge identical constants across compilation units
808 Common Report Var(flag_merge_debug_strings) Init(1)
809 Attempt to merge identical debug strings across compilation units
812 Common RejectNegative Joined UInteger
813 -fmessage-length=<number> Limit diagnostics to <number> characters per line. 0 suppresses line-wrapping
816 Common Report Var(flag_modulo_sched) Optimization
817 Perform SMS based modulo scheduling before the first scheduling pass
819 fmodulo-sched-allow-regmoves
820 Common Report Var(flag_modulo_sched_allow_regmoves)
821 Perform SMS based modulo scheduling with register moves allowed
823 fmove-loop-invariants
824 Common Report Var(flag_move_loop_invariants) Init(1) Optimization
825 Move loop invariant computations out of loops
828 Common RejectNegative Report Var(flag_mudflap)
829 Add mudflap bounds-checking instrumentation for single-threaded program
832 Common RejectNegative Report VarExists Var(flag_mudflap,2)
833 Add mudflap bounds-checking instrumentation for multi-threaded program
836 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
837 Ignore read operations when inserting mudflap instrumentation
840 Common Var(flag_dce) Init(1) Optimization
841 Use the RTL dead code elimination pass
844 Common Var(flag_dse) Init(1) Optimization
845 Use the RTL dead store elimination pass
847 freschedule-modulo-scheduled-loops
848 Common Report Var(flag_resched_modulo_sched) Optimization
849 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
852 Common Report Var(flag_non_call_exceptions) Optimization
853 Support synchronous non-call exceptions
856 Common Report Var(flag_omit_frame_pointer) Optimization
857 When possible do not generate stack frames
859 foptimize-register-move
860 Common Report Var(flag_regmove) Optimization
861 Do the full register move optimization pass
863 foptimize-sibling-calls
864 Common Report Var(flag_optimize_sibling_calls) Optimization
865 Optimize sibling and tail recursive calls
868 Common Report Var(pre_ipa_mem_report)
869 Report on memory allocation before interprocedural optimization
872 Common Report Var(post_ipa_mem_report)
873 Report on memory allocation before interprocedural optimization
876 Common Report Var(flag_pack_struct) Optimization
877 Pack structure members together without holes
880 Common RejectNegative Joined UInteger Optimization
881 -fpack-struct=<number> Set initial maximum structure member alignment
884 Common Report Var(flag_pcc_struct_return,1) VarExists
885 Return small aggregates in memory, not registers
888 Common Report Var(flag_peel_loops) Optimization
892 Common Report Var(flag_no_peephole,0) Optimization
893 Enable machine specific peephole optimizations
896 Common Report Var(flag_peephole2) Optimization
897 Enable an RTL peephole pass before sched2
900 Common Report Var(flag_pic,2)
901 Generate position-independent code if possible (large mode)
904 Common Report Var(flag_pie,2)
905 Generate position-independent code for executables if possible (large mode)
908 Common Report Var(flag_pic,1) VarExists
909 Generate position-independent code if possible (small mode)
912 Common Report Var(flag_pie,1) VarExists
913 Generate position-independent code for executables if possible (small mode)
916 Common Joined RejectNegative
917 Specify a plugin to load
920 Common Joined RejectNegative
921 -fplugin-arg-<name>-<key>[=<value>] Specify argument <key>=<value> for plugin <name>
923 fpredictive-commoning
924 Common Report Var(flag_predictive_commoning) Optimization
925 Run predictive commoning optimization.
927 fprefetch-loop-arrays
928 Common Report Var(flag_prefetch_loop_arrays) Optimization
929 Generate prefetch instructions, if available, for arrays in loops
932 Common Report Var(profile_flag)
933 Enable basic program profiling code
936 Common Report Var(profile_arc_flag)
937 Insert arc-based program profiling code
940 Common Joined RejectNegative
941 Set the top-level directory for storing the profile data.
942 The default is 'pwd'.
945 Common Report Var(flag_profile_correction)
946 Enable correction of flow inconsistent profile data input
950 Enable common options for generating profile info for profile feedback directed optimizations
953 Common Joined RejectNegative
954 Enable common options for generating profile info for profile feedback directed optimizations, and set -fprofile-dir=
957 Common Var(flag_profile_use)
958 Enable common options for performing profile feedback directed optimizations
961 Common Joined RejectNegative
962 Enable common options for performing profile feedback directed optimizations, and set -fprofile-dir=
965 Common Report Var(flag_profile_values)
966 Insert code to profile values of expressions
972 Common Joined RejectNegative
973 -frandom-seed=<string> Make compile reproducible using <string>
975 ; This switch causes the command line that was used to create an
976 ; object file to be recorded into the object file. The exact format
977 ; of this recording is target and binary file format dependent.
978 ; It is related to the -fverbose-asm switch, but that switch only
979 ; records information in the assembler output file as comments, so
980 ; they never reach the object file.
982 Common Report Var(flag_record_gcc_switches)
983 Record gcc command line switches in the object file.
986 Common Report Var(flag_pcc_struct_return,0) VarExists Optimization
987 Return small aggregates in registers
990 Common Report Var(flag_regmove) Optimization
991 Enables a register move optimization
994 Common Report Var(flag_rename_registers) Init(2) Optimization
995 Perform a register renaming optimization pass
998 Common Report Var(flag_reorder_blocks) Optimization
999 Reorder basic blocks to improve code placement
1001 freorder-blocks-and-partition
1002 Common Report Var(flag_reorder_blocks_and_partition) Optimization
1003 Reorder basic blocks and partition into hot and cold sections
1006 Common Report Var(flag_reorder_functions) Optimization
1007 Reorder functions to improve code placement
1009 frerun-cse-after-loop
1010 Common Report Var(flag_rerun_cse_after_loop) Init(2) Optimization
1011 Add a common subexpression elimination pass after loop optimizations
1015 Does nothing. Preserved for backward compatibility.
1018 Common Report Var(flag_rounding_math) Optimization
1019 Disable optimizations that assume default FP rounding behavior
1022 Common Report Var(flag_schedule_interblock) Init(1) Optimization
1023 Enable scheduling across basic blocks
1026 Common Report Var(flag_sched_pressure) Init(0) Optimization
1027 Enable register pressure sensitive insn scheduling
1030 Common Report Var(flag_schedule_speculative) Init(1) Optimization
1031 Allow speculative motion of non-loads
1034 Common Report Var(flag_schedule_speculative_load) Optimization
1035 Allow speculative motion of some loads
1037 fsched-spec-load-dangerous
1038 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
1039 Allow speculative motion of more loads
1042 Common RejectNegative Joined
1043 -fsched-verbose=<number> Set the verbosity level of the scheduler
1045 fsched2-use-superblocks
1046 Common Report Var(flag_sched2_use_superblocks) Optimization
1047 If scheduling post reload, do superblock scheduling
1051 Does nothing. Preserved for backward compatibility.
1054 Common Report Var(flag_schedule_insns) Optimization
1055 Reschedule instructions before register allocation
1058 Common Report Var(flag_schedule_insns_after_reload) Optimization
1059 Reschedule instructions after register allocation
1061 ; This flag should be on when a target implements non-trivial
1062 ; scheduling hooks, maybe saving some information for its own sake.
1063 ; On IA64, for example, this is used for correct bundling.
1064 fselective-scheduling
1065 Common Report Var(flag_selective_scheduling) Optimization
1066 Schedule instructions using selective scheduling algorithm
1068 fselective-scheduling2
1069 Common Report Var(flag_selective_scheduling2) Optimization
1070 Run selective scheduling after reload
1072 fsel-sched-pipelining
1073 Common Report Var(flag_sel_sched_pipelining) Init(0) Optimization
1074 Perform software pipelining of inner loops during selective scheduling
1076 fsel-sched-pipelining-outer-loops
1077 Common Report Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization
1078 Perform software pipelining of outer loops during selective scheduling
1080 fsel-sched-reschedule-pipelined
1081 Common Report Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization
1082 Reschedule pipelined regions without pipelining
1084 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1085 ; of stalled insns into the ready list.
1086 fsched-stalled-insns
1087 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1088 Allow premature scheduling of queued insns
1090 fsched-stalled-insns=
1091 Common RejectNegative Joined UInteger
1092 -fsched-stalled-insns=<number> Set number of queued insns that can be prematurely scheduled
1094 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1095 ; be examined for a dependency on a stalled insn that is candidate for
1096 ; premature removal from the queue of stalled insns into the ready list (has
1097 ; an effect only if the flag 'sched_stalled_insns' is set).
1098 fsched-stalled-insns-dep
1099 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1100 Set dependence distance checking in premature scheduling of queued insns
1102 fsched-stalled-insns-dep=
1103 Common RejectNegative Joined UInteger
1104 -fsched-stalled-insns-dep=<number> Set dependence distance checking in premature scheduling of queued insns
1106 fsched-group-heuristic
1107 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1108 Enable the group heuristic in the scheduler
1110 fsched-critical-path-heuristic
1111 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1112 Enable the critical path heuristic in the scheduler
1114 fsched-spec-insn-heuristic
1115 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1116 Enable the speculative instruction heuristic in the scheduler
1118 fsched-rank-heuristic
1119 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1120 Enable the rank heuristic in the scheduler
1122 fsched-last-insn-heuristic
1123 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1124 Enable the last instruction heuristic in the scheduler
1126 fsched-dep-count-heuristic
1127 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1128 Enable the dependent count heuristic in the scheduler
1131 Common Report Var(flag_section_anchors) Optimization
1132 Access data in the same section from shared anchor points
1136 Does nothing. Preserved for backward compatibility.
1139 Common C ObjC C++ ObjC++ Report Var(flag_show_column) Init(1)
1140 Show column numbers in diagnostics, when available. Default on
1143 Common Report Var(flag_signaling_nans) Optimization
1144 Disable optimizations observable by IEEE signaling NaNs
1147 Common Report Var(flag_signed_zeros) Init(1) Optimization
1148 Disable floating point optimizations that ignore the IEEE signedness of zero
1150 fsingle-precision-constant
1151 Common Report Var(flag_single_precision_constant) Optimization
1152 Convert floating point constants to single precision constants
1154 fsplit-ivs-in-unroller
1155 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
1156 Split lifetimes of induction variables when loops are unrolled
1159 Common Report Var(flag_split_wide_types) Optimization
1160 Split wide types into independent registers
1162 fvariable-expansion-in-unroller
1163 Common Report Var(flag_variable_expansion_in_unroller) Optimization
1164 Apply variable expansion when loops are unrolled
1167 Common Report RejectNegative Joined
1168 -fstack-check=[no|generic|specific] Insert stack checking code into the program
1172 Insert stack checking code into the program. Same as -fstack-check=specific
1177 fstack-limit-register=
1178 Common RejectNegative Joined
1179 -fstack-limit-register=<register> Trap if the stack goes past <register>
1181 fstack-limit-symbol=
1182 Common RejectNegative Joined
1183 -fstack-limit-symbol=<name> Trap if the stack goes past symbol <name>
1186 Common Report Var(flag_stack_protect, 1)
1187 Use propolice as a stack protection method
1189 fstack-protector-all
1190 Common Report RejectNegative Var(flag_stack_protect, 2) VarExists
1191 Use a stack protection method for every function
1195 Does nothing. Preserved for backward compatibility.
1197 ; Nonzero if we should do (language-dependent) alias analysis.
1198 ; Typically, this analysis will assume that expressions of certain
1199 ; types do not alias expressions of certain other types. Only used
1200 ; if alias analysis (in general) is enabled.
1202 Common Report Var(flag_strict_aliasing) Optimization
1203 Assume strict aliasing rules apply
1206 Common Report Var(flag_strict_overflow)
1207 Treat signed overflow as undefined
1210 Common Report Var(flag_syntax_only)
1211 Check for syntax errors, then stop
1214 Common Report Var(flag_test_coverage)
1215 Create data files needed by \"gcov\"
1218 Common Report Var(flag_thread_jumps) Optimization
1219 Perform jump threading optimizations
1222 Common Report Var(time_report)
1223 Report the time taken by each compiler pass
1226 Common Joined RejectNegative
1227 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec] Set the default thread-local storage code generation model
1230 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
1231 Reorder top level functions, variables, and asms
1234 Common Report Var(flag_tracer)
1235 Perform superblock formation via tail duplication
1237 ; Zero means that floating-point math operations cannot generate a
1238 ; (user-visible) trap. This is the case, for example, in nonstop
1239 ; IEEE 754 arithmetic.
1241 Common Report Var(flag_trapping_math) Init(1) Optimization
1242 Assume floating-point operations can trap
1245 Common Report Var(flag_trapv) Optimization
1246 Trap for signed overflow in addition, subtraction and multiplication
1249 Common Report Var(flag_tree_ccp) Optimization
1250 Enable SSA-CCP optimization on trees
1254 Does nothing. Preserved for backward compatibility.
1257 Common Report Var(flag_tree_ch) Optimization
1258 Enable loop header copying on trees
1261 Common Report Var(flag_tree_copyrename) Optimization
1262 Replace SSA temporaries with better names in copies
1265 Common Report Var(flag_tree_copy_prop) Optimization
1266 Enable copy propagation on trees
1268 ftree-store-copy-prop
1270 Does nothing. Preserved for backward compatibility.
1273 Common Report Var(flag_tree_cselim) Init(2) Optimization
1274 Transform condition stores into unconditional ones
1276 ftree-switch-conversion
1277 Common Report Var(flag_tree_switch_conversion) Optimization
1278 Perform conversions of switch initializations.
1281 Common Report Var(flag_tree_dce) Optimization
1282 Enable SSA dead code elimination optimization on trees
1284 ftree-dominator-opts
1285 Common Report Var(flag_tree_dom) Optimization
1286 Enable dominator optimizations
1289 Common Report Var(flag_tree_dse) Optimization
1290 Enable dead store elimination
1293 Common Report Var(flag_tree_forwprop) Init(1) Optimization
1294 Enable forward propagation on trees
1297 Common Report Var(flag_tree_fre) Optimization
1298 Enable Full Redundancy Elimination (FRE) on trees
1300 ftree-loop-distribution
1301 Common Report Var(flag_tree_loop_distribution) Optimization
1302 Enable loop distribution on trees
1305 Common Report Var(flag_tree_loop_im) Init(1) Optimization
1306 Enable loop invariant motion on trees
1309 Common Report Var(flag_tree_loop_linear) Optimization
1310 Enable linear loop transforms on trees
1313 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
1314 Create canonical induction variables in loops
1317 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
1318 Enable loop optimizations on tree level
1320 ftree-parallelize-loops=
1321 Common Report Joined UInteger Var(flag_tree_parallelize_loops) Init(1)
1322 Enable automatic parallelization of loops
1325 Common Report Var(flag_tree_phiprop) Init(1) Optimization
1326 Enable hoisting loads from conditional pointers.
1329 Common Report Var(flag_tree_pre) Optimization
1330 Enable SSA-PRE optimization on trees
1333 Common Report Var(flag_tree_pta) Init(1) Optimization
1334 Perform function-local points-to analysis on trees.
1337 Common Report Var(flag_tree_reassoc) Init(1) Optimization
1338 Enable reassociation on tree level
1342 Does nothing. Preserved for backward compatibility.
1345 Common Report Var(flag_tree_sink) Optimization
1346 Enable SSA code sinking on trees
1349 Common Report Var(flag_tree_sra) Optimization
1350 Perform scalar replacement of aggregates
1353 Common Report Var(flag_tree_ter) Init(1) Optimization
1354 Replace temporary expressions in the SSA->normal pass
1357 Common Report Var(flag_tree_live_range_split) Optimization
1358 Perform live range splitting during the SSA->normal pass
1361 Common Report Var(flag_tree_vrp) Init(0) Optimization
1362 Perform Value Range Propagation on trees
1365 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
1366 Compile whole compilation unit at a time
1369 Common Report Var(flag_unroll_loops) Optimization
1370 Perform loop unrolling when iteration count is known
1373 Common Report Var(flag_unroll_all_loops) Optimization
1374 Perform loop unrolling for all loops
1376 ; Nonzero means that loop optimizer may assume that the induction variables
1377 ; that control loops do not overflow and that the loops with nontrivial
1378 ; exit condition are not infinite
1379 funsafe-loop-optimizations
1380 Common Report Var(flag_unsafe_loop_optimizations) Optimization
1381 Allow loop optimizations to assume that the loops behave in normal way
1384 Common Report Var(flag_associative_math)
1385 Allow optimization for floating-point arithmetic which may change the
1386 result of the operation due to rounding.
1389 Common Report Var(flag_reciprocal_math)
1390 Same as -fassociative-math for expressions which include division.
1392 ; Nonzero means that unsafe floating-point math optimizations are allowed
1393 ; for the sake of speed. IEEE compliance is not guaranteed, and operations
1394 ; are allowed to assume that their arguments and results are "normal"
1395 ; (e.g., nonnegative for SQRT).
1396 funsafe-math-optimizations
1397 Common Report Var(flag_unsafe_math_optimizations) Optimization
1398 Allow math optimizations that may violate IEEE or ISO standards
1401 Common Report Var(flag_unswitch_loops) Optimization
1402 Perform loop unswitching
1405 Common Report Var(flag_unwind_tables) Optimization
1406 Just generate unwind tables for exception handling
1412 Common Report Var(flag_var_tracking) VarExists Optimization
1413 Perform variable tracking
1415 fvar-tracking-assignments
1416 Common Report Var(flag_var_tracking_assignments) VarExists Optimization
1417 Perform variable tracking by annotating assignments
1419 fvar-tracking-assignments-toggle
1420 Common Report Var(flag_var_tracking_assignments_toggle) VarExists Optimization
1421 Toggle -fvar-tracking-assignments
1423 fvar-tracking-uninit
1424 Common Report Var(flag_var_tracking_uninit) Optimization
1425 Perform variable tracking and also tag variables that are uninitialized
1428 Common Report Var(flag_tree_vectorize) Optimization
1429 Enable loop vectorization on trees
1432 Common Report Var(flag_tree_slp_vectorize) Init(2) Optimization
1433 Enable basic block vectorization (SLP) on trees
1436 Common Report Var(flag_vect_cost_model) Optimization
1437 Enable use of cost model in vectorization
1439 ftree-vect-loop-version
1440 Common Report Var(flag_tree_vect_loop_version) Init(1) Optimization
1441 Enable loop versioning when doing loop vectorization on trees
1443 ftree-vectorizer-verbose=
1444 Common RejectNegative Joined
1445 -ftree-vectorizer-verbose=<number> Set the verbosity level of the vectorizer
1448 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
1449 Enable copy propagation of scalar-evolution information.
1451 ; -fverbose-asm causes extra commentary information to be produced in
1452 ; the generated assembly code (to make it more readable). This option
1453 ; is generally only of use to those who actually need to read the
1454 ; generated assembly code (perhaps while debugging the compiler itself).
1455 ; -fno-verbose-asm, the default, causes the extra information
1456 ; to not be added and is useful when comparing two assembler files.
1458 Common Report Var(flag_verbose_asm)
1459 Add extra commentary to assembler output
1462 Common Joined RejectNegative
1463 -fvisibility=[default|internal|hidden|protected] Set the default symbol visibility
1467 Common Report Var(flag_value_profile_transformations) Optimization
1468 Use expression value profiles in optimizations
1471 Common Report Var(flag_web) Init(2) Optimization
1472 Construct webs and split unrelated uses of single variable
1475 Common Var(flag_whopr)
1476 Enable partitioned link-time optimization.
1478 ftree-builtin-call-dce
1479 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
1480 Enable conditional dead code elimination for builtin calls
1483 Common Report Var(flag_whole_program) Init(0) Optimization
1484 Perform whole program optimizations
1487 Common Report Var(flag_wrapv) Optimization
1488 Assume signed arithmetic overflow wraps around
1490 fzero-initialized-in-bss
1491 Common Report Var(flag_zero_initialized_in_bss) Init(1)
1492 Put zero initialized data in the bss section
1495 Common JoinedOrMissing
1496 Generate debug information in default format
1499 Common JoinedOrMissing Negative(gdwarf-)
1500 Generate debug information in COFF format
1503 Common Joined UInteger Var(dwarf_version) Init(2) Negative(gstabs)
1504 Generate debug information in DWARF v2 (or later) format
1507 Common JoinedOrMissing
1508 Generate debug information in default extended format
1511 Common JoinedOrMissing Negative(gstabs+)
1512 Generate debug information in STABS format
1515 Common JoinedOrMissing Negative(gvms)
1516 Generate debug information in extended STABS format
1519 Common RejectNegative Var(dwarf_strict,0) Init(-1)
1520 Emit DWARF additions beyond selected version
1523 Common Report RejectNegative Var(dwarf_strict,1) VarExists
1524 Don't emit DWARF additions beyond selected version
1527 Common Report Var(flag_gtoggle)
1528 Toggle debug information generation
1531 Common JoinedOrMissing Negative(gxcoff)
1532 Generate debug information in VMS format
1535 Common JoinedOrMissing Negative(gxcoff+)
1536 Generate debug information in XCOFF format
1539 Common JoinedOrMissing Negative(gcoff)
1540 Generate debug information in extended XCOFF format
1543 Common Joined Var(plugindir_string) Init(0)
1544 -iplugindir=<dir> Set <dir> to be the default plugin directory
1547 Common Joined Separate
1548 -o <file> Place output into <file>
1551 Common Var(profile_flag)
1552 Enable function profiling
1555 Common Var(pedantic)
1556 Issue warnings needed for strict compliance to the standard
1560 Like -pedantic but issue them as errors
1563 Common Var(quiet_flag)
1564 Do not display functions compiled or elapsed time
1567 Common Var(version_flag)
1568 Display the compiler's version
1571 Common Var(inhibit_warnings)
1575 Common RejectNegative Negative(pie)
1576 Create a shared library
1579 Common RejectNegative Negative(shared)
1580 Create a position independent executable
1582 ; This comment is to ensure we retain the blank line above.