OSDN Git Service

2004-07-04 Matthias Klose <doko@debian.org>
[pf3gnuchains/gcc-fork.git] / gcc / params.def
index ace8916..72095af 100644 (file)
@@ -1,5 +1,5 @@
 /* params.def - Run-time parameters.
-   Copyright (C) 2001 Free Software Foundation, Inc.
+   Copyright (C) 2001, 2002, 2004 Free Software Foundation, Inc.
    Written by Mark Mitchell <mark@codesourcery.com>.
 
 This file is part of GCC.
@@ -35,15 +35,64 @@ Software Foundation, 59 Temple Place - Suite 330, Boston, MA
 
    Be sure to add an entry to invoke.texi summarizing the parameter.  */
 
-/* The maximum number of instructions accepted for inlining a
-   function.  Increasing values mean more agressive inlining.
-   This affects currently only functions explicitly marked as
-   inline (or methods defined within the class definition for C++).
-   The original default value of 10000 was arbitrary and caused
-   significant compile-time performance regressions.  */
-DEFPARAM (PARAM_MAX_INLINE_INSNS,
-         "max-inline-insns",
-         "The maximum number of instructions in a function that is eligible for inlining",
+/* The single function inlining limit. This is the maximum size
+   of a function counted in internal gcc instructions (not in
+   real machine instructions) that is eligible for inlining
+   by the tree inliner.
+   The default value is 500.
+   Only functions marked inline (or methods defined in the class
+   definition for C++) are affected by this, unless you set the
+   -finline-functions (included in -O3) compiler option.
+   There are more restrictions to inlining: If inlined functions
+   call other functions, the already inlined instructions are
+   counted and once the recursive inline limit (see 
+   "max-inline-insns" parameter) is exceeded, the acceptable size
+   gets decreased.  */
+DEFPARAM (PARAM_MAX_INLINE_INSNS_SINGLE,
+         "max-inline-insns-single",
+         "The maximum number of instructions in a single function eligible for inlining",
+         500)
+
+/* The single function inlining limit for functions that are
+   inlined by virtue of -finline-functions (-O3).
+   This limit should be chosen to be below or equal to the limit
+   that is applied to functions marked inlined (or defined in the
+   class declaration in C++) given by the "max-inline-insns-single"
+   parameter.
+   The default value is 150.  */
+DEFPARAM (PARAM_MAX_INLINE_INSNS_AUTO,
+         "max-inline-insns-auto",
+         "The maximum number of instructions when automatically inlining",
+         120)
+
+DEFPARAM (PARAM_MAX_INLINE_INSNS_RECURSIVE,
+         "max-inline-insns-recursive",
+         "The maximum number of instructions inline function can grow to via recursive inlining",
+         500)
+
+DEFPARAM (PARAM_MAX_INLINE_INSNS_RECURSIVE_AUTO,
+         "max-inline-insns-recursive-auto",
+         "The maximum number of instructions non-inline function can grow to via recursive inlining",
+         500)
+
+DEFPARAM (PARAM_MAX_INLINE_RECURSIVE_DEPTH,
+         "max-inline-recursive-depth",
+         "The maximum depth of recursive inlining for inline functions",
+         8)
+
+DEFPARAM (PARAM_MAX_INLINE_RECURSIVE_DEPTH_AUTO,
+         "max-inline-recursive-depth-auto",
+         "The maximum depth of recursive inlining for non-inline functions",
+         8)
+
+/* For languages that (still) use the RTL inliner, we can specify
+   limits for the RTL inliner separately.
+   The parameter here defines the maximum number of RTL instructions
+   a function may have to be eligible for inlining in the RTL inliner.
+   The default value is 600.  */
+DEFPARAM (PARAM_MAX_INLINE_INSNS_RTL,
+         "max-inline-insns-rtl",
+         "The maximum number of instructions for the RTL inliner",
          600)
 
 /* The maximum number of instructions to consider when looking for an
@@ -69,26 +118,246 @@ DEFPARAM(PARAM_MAX_DELAY_SLOT_LIVE_SEARCH,
         333)
 
 /* This parameter limits the number of branch elements that the 
-   scheduler will track anti-dependancies through without resetting
+   scheduler will track anti-dependencies through without resetting
    the tracking mechanism.  Large functions with few calls or barriers 
-   can generate lists containing many 1000's of dependancies.  Generally 
+   can generate lists containing many 1000's of dependencies.  Generally 
    the compiler either uses all available memory, or runs for far too long.  */
 DEFPARAM(PARAM_MAX_PENDING_LIST_LENGTH,
         "max-pending-list-length",
         "The maximum length of scheduling's pending operations list",
         32)
 
+DEFPARAM(PARAM_LARGE_FUNCTION_INSNS,
+        "large-function-insns",
+        "The size of function body to be considered large",
+        3000)
+DEFPARAM(PARAM_LARGE_FUNCTION_GROWTH,
+        "large-function-growth",
+        "Maximal growth due to inlining of large function (in percent)",
+        100)
+DEFPARAM(PARAM_INLINE_UNIT_GROWTH,
+        "inline-unit-growth",
+        "how much can given compilation unit grow because of the inlining (in percent)",
+        50)
+
 /* The GCSE optimization will be disabled if it would require
    significantly more memory than this value.  */
 DEFPARAM(PARAM_MAX_GCSE_MEMORY,
         "max-gcse-memory",
         "The maximum amount of memory to be allocated by GCSE",
         50 * 1024 * 1024)
-/* The number of repetitions of copy/const prop and PRE to run. */
+/* The number of repetitions of copy/const prop and PRE to run.  */
 DEFPARAM(PARAM_MAX_GCSE_PASSES,
        "max-gcse-passes",
        "The maximum number of passes to make when doing GCSE",
        1)
+/* This is the threshold ratio when to perform partial redundancy
+   elimination after reload. We perform partial redundancy elimination
+   when the following holds:
+   (Redundant load execution count)
+   ------------------------------- >= GCSE_AFTER_RELOAD_PARTIAL_FRACTION
+   (Added loads execution count)                                         */
+DEFPARAM(PARAM_GCSE_AFTER_RELOAD_PARTIAL_FRACTION,
+       "gcse-after-reload-partial-fraction",
+       "The threshold ratio for performing partial redundancy elimination \
+         after reload.",
+        3)
+/* This is the threshold ratio of the critical edges execution count compared to
+   the redundant loads execution count that permits performing the load
+   redundancy elimination in gcse after reload.  */
+DEFPARAM(PARAM_GCSE_AFTER_RELOAD_CRITICAL_FRACTION,
+       "gcse-after-reload-critical-fraction",
+       "The threshold ratio of critical edges execution count that permit \
+         performing redundancy elimination after reload.",
+        10)
+/* This parameter limits the number of insns in a loop that will be unrolled,
+   and by how much the loop is unrolled.
+   
+   This limit should be at most half of the peeling limits:  loop unroller
+   decides to not unroll loops that iterate fewer than 2*number of allowed
+   unrollings and thus we would have loops that are neither peeled or unrolled
+   otherwise.  */
+DEFPARAM(PARAM_MAX_UNROLLED_INSNS,
+        "max-unrolled-insns",
+        "The maximum number of instructions to consider to unroll in a loop",
+        200)
+/* This parameter limits how many times the loop is unrolled depending
+   on number of insns really executed in each iteration.  */
+DEFPARAM(PARAM_MAX_AVERAGE_UNROLLED_INSNS,
+        "max-average-unrolled-insns",
+        "The maximum number of instructions to consider to unroll in a loop on average",
+        80)
+/* The maximum number of unrollings of a single loop.  */
+DEFPARAM(PARAM_MAX_UNROLL_TIMES,
+       "max-unroll-times",
+       "The maximum number of unrollings of a single loop",
+       8)
+/* The maximum number of insns of a peeled loop.  */
+DEFPARAM(PARAM_MAX_PEELED_INSNS,
+       "max-peeled-insns",
+       "The maximum number of insns of a peeled loop",
+       400)
+/* The maximum number of peelings of a single loop.  */
+DEFPARAM(PARAM_MAX_PEEL_TIMES,
+       "max-peel-times",
+       "The maximum number of peelings of a single loop",
+       16)
+/* The maximum number of insns of a peeled loop.  */
+DEFPARAM(PARAM_MAX_COMPLETELY_PEELED_INSNS,
+       "max-completely-peeled-insns",
+       "The maximum number of insns of a completely peeled loop",
+       400)
+/* The maximum number of peelings of a single loop that is peeled completely.  */
+DEFPARAM(PARAM_MAX_COMPLETELY_PEEL_TIMES,
+       "max-completely-peel-times",
+       "The maximum number of peelings of a single loop that is peeled completely",
+       16)
+/* The maximum number of insns of a peeled loop that rolls only once.  */
+DEFPARAM(PARAM_MAX_ONCE_PEELED_INSNS,
+       "max-once-peeled-insns",
+       "The maximum number of insns of a peeled loop that rolls only once",
+       400)
+
+/* The maximum number of insns of an unswitched loop.  */
+DEFPARAM(PARAM_MAX_UNSWITCH_INSNS,
+       "max-unswitch-insns",
+       "The maximum number of insns of an unswitched loop",
+       50)
+/* The maximum level of recursion in unswitch_single_loop.  */
+DEFPARAM(PARAM_MAX_UNSWITCH_LEVEL,
+       "max-unswitch-level",
+       "The maximum number of unswitchings in a single loop",
+       3)
+
+DEFPARAM(PARAM_MAX_SMS_LOOP_NUMBER,
+        "max-sms-loop-number",
+        "Maximum number of loops to perform swing modulo scheduling on \
+         (mainly for debugging)",
+        -1)
+
+/* This parameter is used to tune SMS MAX II calculations.  */
+DEFPARAM(PARAM_SMS_MAX_II_FACTOR,
+        "sms-max-ii-factor",
+        "A factor for tuning the upper bound that swing modulo scheduler uses \
+         for scheduling a loop",
+        100)
+DEFPARAM(PARAM_SMS_DFA_HISTORY,
+        "sms-dfa-history",
+        "The number of cycles the swing modulo scheduler considers when \
+         checking conflicts using DFA",
+        0)
+DEFPARAM(PARAM_SMS_LOOP_AVERAGE_COUNT_THRESHOLD,
+        "sms-loop-average-count-threshold",
+        "A threshold on the average loop count considered by the swing modulo \
+         scheduler",
+        0)
+
+DEFPARAM(HOT_BB_COUNT_FRACTION,
+        "hot-bb-count-fraction",
+        "Select fraction of the maximal count of repetitions of basic block in \
+program given basic block needs to have to be considered hot",
+        10000)
+DEFPARAM(HOT_BB_FREQUENCY_FRACTION,
+        "hot-bb-frequency-fraction",
+        "Select fraction of the maximal frequency of executions of basic \
+block in function given basic block needs to have to be considered hot",
+        1000)
+DEFPARAM(TRACER_DYNAMIC_COVERAGE_FEEDBACK,
+        "tracer-dynamic-coverage-feedback",
+        "The percentage of function, weighted by execution frequency, that \
+must be covered by trace formation. Used when profile feedback is available",
+        95)
+DEFPARAM(TRACER_DYNAMIC_COVERAGE,
+        "tracer-dynamic-coverage",
+        "The percentage of function, weighted by execution frequency, that \
+must be covered by trace formation. Used when profile feedback is not available",
+        75)
+DEFPARAM(TRACER_MAX_CODE_GROWTH,
+        "tracer-max-code-growth",
+        "Maximal code growth caused by tail duplication (in percent)",
+        100)
+DEFPARAM(TRACER_MIN_BRANCH_RATIO,
+        "tracer-min-branch-ratio",
+        "Stop reverse growth if the reverse probability of best edge is less \
+than this threshold (in percent)",
+        10)
+DEFPARAM(TRACER_MIN_BRANCH_PROBABILITY_FEEDBACK,
+        "tracer-min-branch-probability-feedback",
+        "Stop forward growth if the probability of best edge is less than \
+this threshold (in percent). Used when profile feedback is available",
+        80)
+DEFPARAM(TRACER_MIN_BRANCH_PROBABILITY,
+        "tracer-min-branch-probability",
+        "Stop forward growth if the probability of best edge is less than \
+this threshold (in percent). Used when profile feedback is not available",
+        50)
+
+/* The maximum number of incoming edges to consider for crossjumping.  */
+DEFPARAM(PARAM_MAX_CROSSJUMP_EDGES,
+        "max-crossjump-edges",
+        "The maximum number of incoming edges to consider for crossjumping",
+        100)
+
+/* The maximum length of path considered in cse.  */
+DEFPARAM(PARAM_MAX_CSE_PATH_LENGTH,
+        "max-cse-path-length",
+        "The maximum length of path considered in cse",
+        10)
+
+/* The product of the next two is used to decide whether or not to
+   use .GLOBAL_VAR.  See tree-dfa.c.  */
+DEFPARAM(PARAM_GLOBAL_VAR_THRESHOLD,
+       "global-var-threshold",
+       "Given N calls and V call-clobbered vars in a function.  Use .GLOBAL_VAR if NxV is larger than this limit",
+       500000)
+
+DEFPARAM(PARAM_MAX_CSELIB_MEMORY_LOCATIONS,
+        "max-cselib-memory-locations",
+        "The maximum memory locations recorded by cselib",
+        500)
+
+#ifdef ENABLE_GC_ALWAYS_COLLECT
+# define GGC_MIN_EXPAND_DEFAULT 0
+# define GGC_MIN_HEAPSIZE_DEFAULT 0
+#else
+# define GGC_MIN_EXPAND_DEFAULT 30
+# define GGC_MIN_HEAPSIZE_DEFAULT 4096
+#endif
+
+DEFPARAM(GGC_MIN_EXPAND,
+        "ggc-min-expand",
+        "Minimum heap expansion to trigger garbage collection, as \
+a percentage of the total size of the heap",
+        GGC_MIN_EXPAND_DEFAULT)
+
+DEFPARAM(GGC_MIN_HEAPSIZE,
+        "ggc-min-heapsize",
+        "Minimum heap size before we start collecting garbage, in kilobytes",
+        GGC_MIN_HEAPSIZE_DEFAULT)
+
+#undef GGC_MIN_EXPAND_DEFAULT
+#undef GGC_MIN_HEAPSIZE_DEFAULT
+
+DEFPARAM(PARAM_MAX_RELOAD_SEARCH_INSNS,
+        "max-reload-search-insns",
+        "The maximum number of instructions to search backward when looking for equivalent reload",
+        100)
+
+DEFPARAM(PARAM_MAX_ALIASED_VOPS,
+         "max-aliased-vops",
+        "The maximum number of virtual operands allowed to represent aliases before triggering alias grouping.",
+        500)
+
+DEFPARAM(PARAM_MAX_SCHED_REGION_BLOCKS,
+        "max-sched-region-blocks",
+        "The maximum number of blocks in a region to be considered for interblock scheduling",
+        10)
+
+DEFPARAM(PARAM_MAX_SCHED_REGION_INSNS,
+        "max-sched-region-insns",
+        "The maximum number of insns in a region to be considered for interblock scheduling",
+        100)
+
 /*
 Local variables:
 mode:c