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