; Options for the language- and target-independent parts of the compiler.
-; Copyright (C) 2003, 2004 Free Software Foundation, Inc.
+; Copyright (C) 2003, 2004, 2005 Free Software Foundation, Inc.
;
; This file is part of GCC.
;
;
; You should have received a copy of the GNU General Public License
; along with GCC; see the file COPYING. If not, write to the Free
-; Software Foundation, 59 Temple Place - Suite 330, Boston, MA
-; 02111-1307, USA.
+; Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
+; 02110-1301, USA.
-; See c.opt for a description of this file's format.
+; See the GCC internals manual for a description of this file's format.
; Please try to keep this file in ASCII collating order.
-param
Common Separate
---param <param>=<value> Set paramter <param> to value. See below for a complete list of parameters
+--param <param>=<value> Set parameter <param> to value. See below for a complete list of parameters
-target-help
Common
Common Var(warn_aggregate_return)
Warn about returning structures, unions or arrays
+Walways-true
+Common Var(warn_always_true)
+Warn about comparisons that always evaluate to true
+
+Wattributes
+Common Var(warn_attributes) Init(1)
+Warn about inappropriate attribute usage
+
Wcast-align
Common Var(warn_cast_align)
Warn about pointer casts which increase alignment
Common RejectNegative Joined UInteger
-Wlarger-than-<number> Warn if an object is larger than <number> bytes
+Wunsafe-loop-optimizations
+Common Var(warn_unsafe_loop_optimizations)
+Warn if the loop cannot be optimized due to nontrivial assumptions.
+
Wmissing-noreturn
Common Var(warn_missing_noreturn)
Warn about functions which might be candidates for __attribute__((noreturn))
Common Var(warn_shadow)
Warn when one local variable shadows another
+Wstack-protector
+Common Var(warn_stack_protect)
+Warn when not issuing stack smashing protection for some reason
+
Wstrict-aliasing
Common
Warn about code which might break strict aliasing rules
Common Joined UInteger
Warn about code which might break strict aliasing rules
+Wstring-literal-comparison
+Common Var(warn_string_literal_comparison)
+Warn about comparisons to constant string literals
+
Wswitch
Common Var(warn_switch)
Warn about enumerated switches, with no default, missing a case
Common Var(warn_unused_variable)
Warn when a variable is unused
+Wvolatile-register-var
+Common Var(warn_register_var)
+Warn when a register variable is declared volatile
+
aux-info
Common Separate
-aux-info <file> Emit declaration information into <file>
Common Separate
-dumpbase <file> Set the file basename to be used for dumps
-fPIC
-Common Report Var(flag_pic,2)
-
-fPIE
-Common Report Var(flag_pie,2)
-
+; The version of the C++ ABI in use. The following values are allowed:
+;
+; 0: The version of the ABI believed most conformant with the C++ ABI
+; specification. This ABI may change as bugs are discovered and fixed.
+; Therefore, 0 will not necessarily indicate the same ABI in different
+; versions of G++.
+;
+; 1: The version of the ABI first used in G++ 3.2.
+;
+; Additional positive integers will be assigned as new versions of
+; the ABI become the default version of the ABI.
fabi-version=
Common Joined UInteger Var(flag_abi_version) Init(2)
falign-loops=
Common RejectNegative Joined UInteger
+; This flag is only tested if alias checking is enabled.
+; 0 if pointer arguments may alias each other. True in C.
+; 1 if pointer arguments may not alias each other but may alias
+; global variables.
+; 2 if pointer arguments may not alias each other and may not
+; alias global variables. True in Fortran.
fargument-alias
Common Report Var(flag_argument_noalias,0)
Specify that arguments may alias each other and globals
Common Report Var(flag_asynchronous_unwind_tables)
Generate unwind tables that are exact at each instruction boundary
+; -fcheck-bounds causes gcc to generate array bounds checks.
+; For C, C++ and ObjC: defaults off.
+; For Java: defaults to on.
+; For Fortran: defaults to off.
fbounds-check
Common Report Var(flag_bounds_check)
Generate code to check bounds before indexing arrays
Common Joined RejectNegative
-fcall-used-<register> Mark <register> as being corrupted by function calls
+; Nonzero for -fcaller-saves: allocate values in regs that need to
+; be saved across function calls, if that produces overall better code.
+; Optional now, so people can test it.
fcaller-saves
Common Report Var(flag_caller_saves)
Save registers around function calls
Common Report Var(flag_cse_skip_blocks)
When running CSE, follow conditional jumps
+fcx-limited-range
+Common Report Var(flag_cx_limited_range)
+Omit range reduction step when performing complex division
+
fdata-sections
Common Report Var(flag_data_sections)
Place data items into their own section
+; Nonzero for -fdefer-pop: don't pop args after each function call
+; instead save them up to pop many calls' args with one insns.
fdefer-pop
Common Report Var(flag_defer_pop)
Defer popping functions args from stack until later
Common Joined RejectNegative
-fdiagnostics-show-location=[once|every-line] How often to emit source location at the beginning of line-wrapped diagnostics
+fdiagnostics-show-option
+Common
+Amend appropriate diagnostic messages with the command line option that controls them
+
fdump-
Common Joined RejectNegative
-fdump-<type> Dump various compiler internals to a file
Common Report Var(flag_dump_unnumbered) VarExists
Suppress output of instruction numbers and line number notes in debugging dumps
+fearly-inlining
+Common Report Var(flag_early_inlining) Init(1)
+Perform early inlining
+
feliminate-dwarf2-dups
Common Report Var(flag_eliminate_dwarf2_dups)
Perform DWARF2 duplicate elimination
ffloat-store
Common Report Var(flag_float_store)
-Do not store floats in registers
+Don't allocate floats and doubles in extended-precision registers
+; Nonzero for -fforce-addr: load memory address into a register before
+; reference to memory. This makes better cse but slower compilation.
fforce-addr
Common Report Var(flag_force_addr)
Copy memory address constants into registers before use
+; Nonzero for -fforce-mem: load memory value into a register
+; before arithmetic on it. This makes better cse but slower compilation.
fforce-mem
Common Report Var(flag_force_mem)
Copy memory operands into registers before use
+; Nonzero means don't put addresses of constant functions in registers.
+; Used for compiling the Unix kernel, where strange substitutions are
+; done on the assembly output.
ffunction-cse
Common Report Var(flag_no_function_cse,0)
Allow function addresses to be held in registers
Perform enhanced load motion during global common subexpression elimination
fgcse-sm
-Common Report Var(flag_gcse_sm) Init(1)
+Common Report Var(flag_gcse_sm) Init(0)
Perform store motion after global common subexpression elimination
fgcse-las
-Common Report Var(flag_gcse_las) Init(1)
+Common Report Var(flag_gcse_las) Init(0)
Perform redundant load after store elimination in global common subexpression
elimination
fgcse-after-reload
Common Report Var(flag_gcse_after_reload)
Perform global common subexpression elimination after register allocation
-has finished.
+has finished
fguess-branch-probability
Common Report Var(flag_guess_branch_prob)
Enable guessing of branch probabilities
+; Nonzero means ignore `#ident' directives. 0 means handle them.
+; Generate position-independent code for executables if possible
+; On SVR4 targets, it also controls whether or not to emit a
+; string identifying the compiler.
fident
Common Report Var(flag_no_ident,0)
Process #ident directives
Common Report Var(flag_if_conversion2)
Perform conversion of conditional jumps to conditional execution
+; -finhibit-size-directive inhibits output of .size for ELF.
+; This is used only for compiling crtstuff.c,
+; and it may be extended to other effects
+; needed for crtstuff.c on other systems.
finhibit-size-directive
Common Report Var(flag_inhibit_size_directive)
Do not generate .size directives
+; Nonzero means that functions declared `inline' will be treated
+; as `static'. Prevents generation of zillions of copies of unused
+; static inline functions; instead, `inlines' are written out
+; only when actually used. Used in conjunction with -g. Also
+; does the right thing with #pragma interface.
finline
Common Report Var(flag_no_inline,0) Init(2)
Pay attention to the \"inline\" keyword
Common Report Var(flag_inline_functions)
Integrate simple functions into their callers
+finline-functions-called-once
+Common Report Var(flag_inline_functions_called_once) Init(1)
+Integrate functions called once into their callers
+
finline-limit-
Common RejectNegative Joined UInteger
Common Report Var(flag_instrument_function_entry_exit)
Instrument function entry and exit with profiling calls
+fipa-cp
+Common Report Var(flag_ipa_cp)
+Perform Interprocedural constant propagation
+
+fipa-pure-const
+Common Report Var(flag_ipa_pure_const) Init(0)
+Discover pure and const functions
+
+fipa-reference
+Common Report Var(flag_ipa_reference) Init(0)
+Discover readonly and non addressable static variables
+
+fipa-type-escape
+Common Report Var(flag_ipa_type_escape) Init(0)
+Type based escape and alias analysis
+
+fivopts
+Common Report Var(flag_ivopts) Init(1)
+Optimize induction variables on trees
+
+fjump-tables
+Common Var(flag_jump_tables) Init(1)
+Use jump tables for sufficiently large switch statements
+
fkeep-inline-functions
Common Report Var(flag_keep_inline_functions)
Generate code for functions even if they are fully inlined
Common Report Var(flag_loop_optimize)
Perform loop optimizations
+floop-optimize2
+Common Report Var(flag_loop_optimize2)
+Perform loop optimizations using the new loop optimizer
+
fmath-errno
Common Report Var(flag_errno_math) Init(1)
Set errno after built-in math functions
Common Report Var(mem_report)
Report on permanent memory allocation
+; This will attempt to merge constant section constants, if 1 only
+; string constants and constants from constant pool, if 2 also constant
+; variables.
fmerge-all-constants
Common Report Var(flag_merge_constants,2) Init(1)
Attempt to merge identical constants and constant variables
Common Report Var(flag_modulo_sched)
Perform SMS based modulo scheduling before the first scheduling pass
-fmove-all-movables
-Common Report Var(flag_move_all_movables)
-Force all loop invariant computations out of loops
+fmove-loop-invariants
+Common Report Var(flag_move_loop_invariants)
+Move loop invariant computations out of loops
fmudflap
Common RejectNegative Report Var(flag_mudflap)
-Add mudflap bounds-checking instrumentation for single-threaded program.
+Add mudflap bounds-checking instrumentation for single-threaded program
fmudflapth
Common RejectNegative Report Var(flag_mudflap_threads)
-Add mudflap bounds-checking instrumentation for multi-threaded program.
+Add mudflap bounds-checking instrumentation for multi-threaded program
fmudflapir
Common RejectNegative Report Var(flag_mudflap_ignore_reads)
-Ignore read operations when inserting mudflap instrumentation.
+Ignore read operations when inserting mudflap instrumentation
-fnew-ra
-Common Report Var(flag_new_regalloc)
-Use graph-coloring register allocation
+freschedule-modulo-scheduled-loops
+Common Report Var(flag_resched_modulo_sched)
+Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
fnon-call-exceptions
Common Report Var(flag_non_call_exceptions)
Support synchronous non-call exceptions
-fold-unroll-loops
-Common Report Var(flag_old_unroll_loops)
-Perform loop unrolling when iteration count is known
-
-fold-unroll-all-loops
-Common Report Var(flag_old_unroll_all_loops)
-Perform loop unrolling for all loops
-
fomit-frame-pointer
Common Report Var(flag_omit_frame_pointer)
When possible do not generate stack frames
Common Report Var(flag_pack_struct)
Pack structure members together without holes
+fpack-struct=
+Common RejectNegative Joined UInteger
+-fpack-struct=<number> Set initial maximum structure member alignment
+
fpcc-struct-return
Common Report Var(flag_pcc_struct_return,1) VarExists
Return small aggregates in memory, not registers
Common Report Var(flag_peephole2)
Enable an RTL peephole pass before sched2
+fPIC
+Common Report Var(flag_pic,2)
+Generate position-independent code if possible (large mode)
+
+fPIE
+Common Report Var(flag_pie,2)
+Generate position-independent code for executables if possible (large mode)
+
fpic
Common Report Var(flag_pic,1) VarExists
-Generate position-independent code if possible
+Generate position-independent code if possible (small mode)
fpie
Common Report Var(flag_pie,1) VarExists
-Generate position-independent code for executables if possible
+Generate position-independent code for executables if possible (small mode)
fprefetch-loop-arrays
Common Report Var(flag_prefetch_loop_arrays)
Common Joined RejectNegative
-frandom-seed=<string> Make compile reproducible using <string>
-freduce-all-givs
-Common Report Var(flag_reduce_all_givs)
-Strength reduce all loop general induction variables
-
freg-struct-return
Common Report Var(flag_pcc_struct_return,0) VarExists
Return small aggregates in registers
Enables a register move optimization
frename-registers
-Common Report Var(flag_rename_registers)
+Common Report Var(flag_rename_registers) Init(2)
Perform a register renaming optimization pass
freorder-blocks
Reorder functions to improve code placement
frerun-cse-after-loop
-Common Report Var(flag_rerun_cse_after_loop)
+Common Report Var(flag_rerun_cse_after_loop) Init(2)
Add a common subexpression elimination pass after loop optimizations
frerun-loop-opt
Common Report Var(flag_schedule_insns_after_reload)
Reschedule instructions after register allocation
+; sched_stalled_insns means that insns can be moved prematurely from the queue
+; of stalled insns into the ready list.
fsched-stalled-insns
Common Report Var(flag_sched_stalled_insns)
Allow premature scheduling of queued insns
fsched-stalled-insns=
Common RejectNegative Joined UInteger
--fsched-stalled-insns=<number> Set number of queued insns that can be prematurely scheduled
+-fsched-stalled-insns=<number> Set number of queued insns that can be prematurely scheduled
+; sched_stalled_insns_dep controls how many recently scheduled cycles will
+; be examined for a dependency on a stalled insn that is candidate for
+; premature removal from the queue of stalled insns into the ready list (has
+; an effect only if the flag 'sched_stalled_insns' is set).
fsched-stalled-insns-dep
Common Report Var(flag_sched_stalled_insns_dep,1) Init(1)
Set dependence distance checking in premature scheduling of queued insns
fsched-stalled-insns-dep=
Common RejectNegative Joined UInteger
--fsched-stalled-insns-dep=<number> Set dependence distance checking in premature scheduling of queued insns
+-fsched-stalled-insns-dep=<number> Set dependence distance checking in premature scheduling of queued insns
+
+frtl-abstract-sequences
+Common Report Var(flag_rtl_seqabstr)
+Perform sequence abstraction optimization on RTL
fshared-data
Common Report Var(flag_shared_data)
Mark data as shared rather than private
+fshow-column
+Common C ObjC C++ ObjC++ Report Var(flag_show_column) Init(1)
+Show column numbers in diagnostics, when available. Default on
+
fsignaling-nans
Common Report Var(flag_signaling_nans)
Disable optimizations observable by IEEE signaling NaNs
Common Report Var(flag_single_precision_constant)
Convert floating point constants to single precision constants
+fsplit-ivs-in-unroller
+Common Report Var(flag_split_ivs_in_unroller) Init(1)
+Split lifetimes of induction variables when loops are unrolled
+
+fvariable-expansion-in-unroller
+Common Report Var(flag_variable_expansion_in_unroller)
+Apply variable expansion when loops are unrolled
+
+; Emit code to probe the stack, to help detect stack overflow; also
+; may cause large objects to be allocated dynamically.
fstack-check
Common Report Var(flag_stack_check)
Insert stack checking code into the program
Common RejectNegative Joined
-fstack-limit-symbol=<name> Trap if the stack goes past symbol <name>
+fstack-protector
+Common Report Var(flag_stack_protect, 1)
+Use propolice as a stack protection method
+
+fstack-protector-all
+Common Report RejectNegative Var(flag_stack_protect, 2) VarExists
+Use a stack protection method for every function
+
fstrength-reduce
Common Report Var(flag_strength_reduce)
Perform strength reduction optimizations
+; Nonzero if we should do (language-dependent) alias analysis.
+; Typically, this analysis will assume that expressions of certain
+; types do not alias expressions of certain other types. Only used
+; if alias analysis (in general) is enabled.
fstrict-aliasing
Common Report Var(flag_strict_aliasing)
Assume strict aliasing rules apply
Common Report Var(flag_tracer)
Perform superblock formation via tail duplication
+; Zero means that floating-point math operations cannot generate a
+; (user-visible) trap. This is the case, for example, in nonstop
+; IEEE 754 arithmetic.
ftrapping-math
-Common Report Var(flag_trapping_math)
+Common Report Var(flag_trapping_math) Init(1)
Assume floating-point operations can trap
ftrapv
Common Report Var(flag_trapv)
Trap for signed overflow in addition, subtraction and multiplication
-ftree-based-profiling
-Common Report Var(flag_tree_based_profiling)
-Use tree-ssa based implementation of profiling
-
ftree-ccp
Common Report Var(flag_tree_ccp)
Enable SSA-CCP optimization on trees
+ftree-store-ccp
+Common Report Var(flag_tree_store_ccp)
+Enable SSA-CCP optimization for stores and loads
+
ftree-ch
Common Report Var(flag_tree_ch)
Enable loop header copying on trees
ftree-copyrename
Common Report Var(flag_tree_copyrename)
-Replace SSA temporaries with better names in copies.
+Replace SSA temporaries with better names in copies
+
+ftree-copy-prop
+Common Report Var(flag_tree_copy_prop)
+Enable copy propagation on trees
+
+ftree-store-copy-prop
+Common Report Var(flag_tree_store_copy_prop)
+Enable copy propagation for stores and loads
ftree-dce
Common Report Var(flag_tree_dce)
Common Report Var(flag_tree_dse)
Enable dead store elimination
-ftree-points-to=
-Common Joined RejectNegative
+ftree-fre
+Common Report Var(flag_tree_fre)
+Enable Full Redundancy Elimination (FRE) on trees
+
+ftree-loop-im
+Common Report Var(flag_tree_loop_im) Init(1)
+Enable loop invariant motion on trees
+
+ftree-loop-linear
+Common Report Var(flag_tree_loop_linear)
+Enable linear loop transforms on trees
+
+ftree-loop-ivcanon
+Common Report Var(flag_tree_loop_ivcanon) Init(1)
+Create canonical induction variables in loops
+
+ftree-loop-optimize
+Common Report Var(flag_tree_loop_optimize) Init(1)
+Enable loop optimizations on tree level
ftree-pre
Common Report Var(flag_tree_pre)
Enable SSA-PRE optimization on trees
+ftree-salias
+Common Report Var(flag_tree_salias)
+Perform structural alias analysis
+
+ftree-sink
+Common Report Var(flag_tree_sink)
+Enable SSA code sinking on trees
+
ftree-sra
Common Report Var(flag_tree_sra)
Perform scalar replacement of aggregates
ftree-lrs
Common Report Var(flag_tree_live_range_split)
-Perform live range splitting during the SSA->normal pass.
+Perform live range splitting during the SSA->normal pass
+
+ftree-vrp
+Common Report Var(flag_tree_vrp) Init(0)
+Perform Value Range Propagation on trees
funit-at-a-time
Common Report Var(flag_unit_at_a_time)
Common Report Var(flag_unroll_all_loops)
Perform loop unrolling for all loops
+; Nonzero means that loop optimizer may assume that the induction variables
+; that control loops do not overflow and that the loops with nontrivial
+; exit condition are not infinite
+funsafe-loop-optimizations
+Common Report Var(flag_unsafe_loop_optimizations)
+Allow loop optimizations to assume that the loops behave in normal way
+
+; Nonzero means that unsafe floating-point math optimizations are allowed
+; for the sake of speed. IEEE compliance is not guaranteed, and operations
+; are allowed to assume that their arguments and results are "normal"
+; (e.g., nonnegative for SQRT).
funsafe-math-optimizations
Common Report Var(flag_unsafe_math_optimizations)
Allow math optimizations that may violate IEEE or ISO standards
Common Report Var(flag_var_tracking) VarExists
Perform variable tracking
+ftree-vectorize
+Common Report Var(flag_tree_vectorize)
+Enable loop vectorization on trees
+
+ftree-vect-loop-version
+Common Report Var(flag_tree_vect_loop_version) Init(1)
+Enable loop versioning when doing loop vectorization on trees
+
+ftree-vectorizer-verbose=
+Common RejectNegative Joined
+-ftree-vectorizer-verbose=<number> Set the verbosity level of the vectorizer
+
+; -fverbose-asm causes extra commentary information to be produced in
+; the generated assembly code (to make it more readable). This option
+; is generally only of use to those who actually need to read the
+; generated assembly code (perhaps while debugging the compiler itself).
+; -fno-verbose-asm, the default, causes the extra information
+; to not be added and is useful when comparing two assembler files.
fverbose-asm
Common Report Var(flag_verbose_asm)
Add extra commentary to assembler output
+fvisibility=
+Common Joined RejectNegative
+-fvisibility=[default|internal|hidden|protected] Set the default symbol visibility
+
+
fvpt
Common Report Var(flag_value_profile_transformations)
Use expression value profiles in optimizations
fweb
-Common Report Var(flag_web) VarExists
+Common Report Var(flag_web) Init(2)
Construct webs and split unrelated uses of single variable
+fwhole-program
+Common Report Var(flag_whole_program) Init(0)
+Perform whole program optimizations
+
fwrapv
Common Report Var(flag_wrapv)
Assume signed arithmetic overflow wraps around
Common JoinedOrMissing
Generate debug information in extended XCOFF format
-m
-Common Joined
-
o
Common Joined Separate
-o <file> Place output into <file>