src/share/vm/gc_implementation/g1/g1_globals.hpp

Wed, 29 Jul 2009 11:01:26 -0400

author
tonyp
date
Wed, 29 Jul 2009 11:01:26 -0400
changeset 1318
27f6a9b9c311
parent 1280
df6caf649ff7
child 1319
83b687ce3090
permissions
-rw-r--r--

6864886: G1: rename -XX parameters related to update buffers
Summary: renaming a couple of update buffer-related parameters to make them more understandable and consistent.
Reviewed-by: iveresov, ysr

     1 /*
     2  * Copyright 2001-2009 Sun Microsystems, Inc.  All Rights Reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.
     8  *
     9  * This code is distributed in the hope that it will be useful, but WITHOUT
    10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    12  * version 2 for more details (a copy is included in the LICENSE file that
    13  * accompanied this code).
    14  *
    15  * You should have received a copy of the GNU General Public License version
    16  * 2 along with this work; if not, write to the Free Software Foundation,
    17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    18  *
    19  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    20  * CA 95054 USA or visit www.sun.com if you need additional information or
    21  * have any questions.
    22  *
    23  */
    25 //
    26 // Defines all globals flags used by the garbage-first compiler.
    27 //
    29 #define G1_FLAGS(develop, develop_pd, product, product_pd, diagnostic, experimental, notproduct, manageable, product_rw) \
    30                                                                             \
    31   product(intx, G1ParallelGCAllocBufferSize, 8*K,                           \
    32           "Size of parallel G1 allocation buffers in to-space.")            \
    33                                                                             \
    34   product(intx, G1ConfidencePercent, 50,                                    \
    35           "Confidence level for MMU/pause predictions")                     \
    36                                                                             \
    37   develop(intx, G1MarkingOverheadPercent, 0,                                   \
    38           "Overhead of concurrent marking")                                 \
    39                                                                             \
    40   develop(bool, G1AccountConcurrentOverhead, false,                         \
    41           "Whether soft real-time compliance in G1 will take into account"  \
    42           "concurrent overhead")                                            \
    43                                                                             \
    44   product(intx, G1YoungGenSize, 0,                                          \
    45           "Size of the G1 young generation, 0 is the adaptive policy")      \
    46                                                                             \
    47   develop(bool, G1Gen, true,                                                \
    48           "If true, it will enable the generational G1")                    \
    49                                                                             \
    50   develop(intx, G1GCPercent, 10,                                                \
    51           "The desired percent time spent on GC")                           \
    52                                                                             \
    53   develop(intx, G1PolicyVerbose, 0,                                         \
    54           "The verbosity level on G1 policy decisions")                     \
    55                                                                             \
    56   develop(bool, G1UseHRIntoRS, true,                                        \
    57           "Determines whether the 'advanced' HR Into rem set is used.")     \
    58                                                                             \
    59   develop(intx, G1MarkingVerboseLevel, 0,                                   \
    60           "Level (0-4) of verboseness of the marking code")                 \
    61                                                                             \
    62   develop(bool, G1VerifyConcMarkPrintReachable, false,                      \
    63           "If conc mark verification fails, print reachable objects")       \
    64                                                                             \
    65   develop(bool, G1TraceMarkStackOverflow, false,                            \
    66           "If true, extra debugging code for CM restart for ovflw.")        \
    67                                                                             \
    68   develop(intx, G1PausesBtwnConcMark, -1,                                   \
    69           "If positive, fixed number of pauses between conc markings")      \
    70                                                                             \
    71   diagnostic(bool, G1SummarizeConcurrentMark, false,                        \
    72           "Summarize concurrent mark info")                                 \
    73                                                                             \
    74   diagnostic(bool, G1SummarizeRSetStats, false,                             \
    75           "Summarize remembered set processing info")                       \
    76                                                                             \
    77   diagnostic(bool, G1SummarizeZFStats, false,                               \
    78           "Summarize zero-filling info")                                    \
    79                                                                             \
    80   develop(bool, G1TraceConcurrentRefinement, false,                         \
    81           "Trace G1 concurrent refinement")                                 \
    82                                                                             \
    83   product(intx, G1MarkStackSize, 2 * 1024 * 1024,                           \
    84           "Size of the mark stack for concurrent marking.")                 \
    85                                                                             \
    86   product(intx, G1MarkRegionStackSize, 1024 * 1024,                         \
    87           "Size of the region stack for concurrent marking.")               \
    88                                                                             \
    89   develop(bool, G1ConcRefine, true,                                         \
    90           "If true, run concurrent rem set refinement for G1")              \
    91                                                                             \
    92   develop(intx, G1ConcRefineTargTraversals, 4,                              \
    93           "Number of concurrent refinement we try to achieve")              \
    94                                                                             \
    95   develop(intx, G1ConcRefineInitialDelta, 4,                                \
    96           "Number of heap regions of alloc ahead of starting collection "   \
    97           "pause to start concurrent refinement (initially)")               \
    98                                                                             \
    99   develop(bool, G1SmoothConcRefine, true,                                   \
   100           "Attempts to smooth out the overhead of concurrent refinement")   \
   101                                                                             \
   102   develop(bool, G1ConcZeroFill, true,                                       \
   103           "If true, run concurrent zero-filling thread")                    \
   104                                                                             \
   105   develop(intx, G1ConcZFMaxRegions, 1,                                      \
   106           "Stop zero-filling when # of zf'd regions reaches")               \
   107                                                                             \
   108   product(intx, G1SteadyStateUsed, 90,                                      \
   109           "If non-0, try to maintain 'used' at this pct (of max)")          \
   110                                                                             \
   111   product(intx, G1SteadyStateUsedDelta, 30,                                 \
   112           "If G1SteadyStateUsed is non-0, then do pause this number of "    \
   113           "of percentage points earlier if no marking is in progress.")     \
   114                                                                             \
   115   develop(bool, G1SATBBarrierPrintNullPreVals, false,                       \
   116           "If true, count frac of ptr writes with null pre-vals.")          \
   117                                                                             \
   118   product(intx, G1SATBLogBufferSize, 1*K,                                   \
   119           "Number of entries in an SATB log buffer.")                       \
   120                                                                             \
   121   product(intx, G1SATBProcessCompletedThreshold, 20,                        \
   122           "Number of completed buffers that triggers log processing.")      \
   123                                                                             \
   124   develop(intx, G1ExtraRegionSurvRate, 33,                                  \
   125           "If the young survival rate is S, and there's room left in "      \
   126           "to-space, we will allow regions whose survival rate is up to "   \
   127           "S + (1 - S)*X, where X is this parameter (as a fraction.)")      \
   128                                                                             \
   129   develop(intx, G1InitYoungSurvRatio, 50,                                   \
   130           "Expected Survival Rate for newly allocated bytes")               \
   131                                                                             \
   132   develop(bool, G1SATBPrintStubs, false,                                    \
   133           "If true, print generated stubs for the SATB barrier")            \
   134                                                                             \
   135   product(intx, G1ExpandByPercentOfAvailable, 20,                           \
   136           "When expanding, % of uncommitted space to claim.")               \
   137                                                                             \
   138   develop(bool, G1RSBarrierRegionFilter, true,                              \
   139           "If true, generate region filtering code in RS barrier")          \
   140                                                                             \
   141   develop(bool, G1RSBarrierNullFilter, true,                                \
   142           "If true, generate null-pointer filtering code in RS barrier")    \
   143                                                                             \
   144   develop(bool, G1PrintCTFilterStats, false,                                \
   145           "If true, print stats on RS filtering effectiveness")             \
   146                                                                             \
   147   develop(bool, G1DeferredRSUpdate, true,                                   \
   148           "If true, use deferred RS updates")                               \
   149                                                                             \
   150   develop(bool, G1RSLogCheckCardTable, false,                               \
   151           "If true, verify that no dirty cards remain after RS log "        \
   152           "processing.")                                                    \
   153                                                                             \
   154   develop(bool, G1RSCountHisto, false,                                      \
   155           "If true, print a histogram of RS occupancies after each pause")  \
   156                                                                             \
   157   develop(intx, G1PrintRegionLivenessInfo, 0,                               \
   158           "When > 0, print the occupancies of the <n> best and worst"       \
   159           "regions.")                                                       \
   160                                                                             \
   161   develop(bool, G1PrintParCleanupStats, false,                              \
   162           "When true, print extra stats about parallel cleanup.")           \
   163                                                                             \
   164   develop(bool, G1DisablePreBarrier, false,                                 \
   165           "Disable generation of pre-barrier (i.e., marking barrier)   ")   \
   166                                                                             \
   167   develop(bool, G1DisablePostBarrier, false,                                \
   168           "Disable generation of post-barrier (i.e., RS barrier)   ")       \
   169                                                                             \
   170   product(intx, G1UpdateBufferSize, 256,                                    \
   171           "Size of an update buffer")                                       \
   172                                                                             \
   173   product(intx, G1UpdateBufferQueueProcessingThreshold, 5,                  \
   174           "Number of enqueued update buffers that will "                    \
   175           "trigger concurrent processing")                                  \
   176                                                                             \
   177   product(intx, G1UpdateBufferQueueMaxLength, 30,                           \
   178           "Maximum number of enqueued update buffers before mutator "       \
   179           "threads start processing new ones instead of enqueueing them")   \
   180                                                                             \
   181   develop(intx, G1ConcRSLogCacheSize, 10,                                   \
   182           "Log base 2 of the length of conc RS hot-card cache.")            \
   183                                                                             \
   184   develop(bool, G1ConcRSCountTraversals, false,                             \
   185           "If true, gather data about the number of times CR traverses "    \
   186           "cards ")                                                         \
   187                                                                             \
   188   develop(intx, G1ConcRSHotCardLimit, 4,                                    \
   189           "The threshold that defines (>=) a hot card.")                    \
   190                                                                             \
   191   develop(bool, G1PrintOopAppls, false,                                     \
   192           "When true, print applications of closures to external locs.")    \
   193                                                                             \
   194   develop(intx, G1LogRSRegionEntries, 7,                                    \
   195           "Log_2 of max number of regions for which we keep bitmaps.")      \
   196                                                                             \
   197   develop(bool, G1RecordHRRSOops, false,                                    \
   198           "When true, record recent calls to rem set operations.")          \
   199                                                                             \
   200   develop(bool, G1RecordHRRSEvents, false,                                  \
   201           "When true, record recent calls to rem set operations.")          \
   202                                                                             \
   203   develop(intx, G1MaxVerifyFailures, -1,                                    \
   204           "The maximum number of verification failrues to print.  "         \
   205           "-1 means print all.")                                            \
   206                                                                             \
   207   develop(bool, G1ScrubRemSets, true,                                       \
   208           "When true, do RS scrubbing after cleanup.")                      \
   209                                                                             \
   210   develop(bool, G1RSScrubVerbose, false,                                    \
   211           "When true, do RS scrubbing with verbose output.")                \
   212                                                                             \
   213   develop(bool, G1YoungSurvRateVerbose, false,                              \
   214           "print out the survival rate of young regions according to age.") \
   215                                                                             \
   216   develop(intx, G1YoungSurvRateNumRegionsSummary, 0,                        \
   217           "the number of regions for which we'll print a surv rate "        \
   218           "summary.")                                                       \
   219                                                                             \
   220   product(bool, G1UseScanOnlyPrefix, false,                                 \
   221           "It determines whether the system will calculate an optimum "     \
   222           "scan-only set.")                                                 \
   223                                                                             \
   224   product(intx, G1MinReservePercent, 10,                                    \
   225           "It determines the minimum reserve we should have in the heap "   \
   226           "to minimize the probability of promotion failure.")              \
   227                                                                             \
   228   diagnostic(bool, G1PrintRegions, false,                                   \
   229           "If set G1 will print information on which regions are being "    \
   230           "allocated and which are reclaimed.")                             \
   231                                                                             \
   232   develop(bool, G1HRRSUseSparseTable, true,                                 \
   233           "When true, use sparse table to save space.")                     \
   234                                                                             \
   235   develop(bool, G1HRRSFlushLogBuffersOnVerify, false,                       \
   236           "Forces flushing of log buffers before verification.")            \
   237                                                                             \
   238   product(bool, G1UseSurvivorSpaces, true,                                  \
   239           "When true, use survivor space.")                                 \
   240                                                                             \
   241   develop(bool, G1FixedTenuringThreshold, false,                            \
   242           "When set, G1 will not adjust the tenuring threshold")            \
   243                                                                             \
   244   develop(bool, G1FixedEdenSize, false,                                     \
   245           "When set, G1 will not allocate unused survivor space regions")   \
   246                                                                             \
   247   develop(uintx, G1FixedSurvivorSpaceSize, 0,                               \
   248           "If non-0 is the size of the G1 survivor space, "                 \
   249           "otherwise SurvivorRatio is used to determine the size")          \
   250                                                                             \
   251   experimental(bool, G1ParallelRSetUpdatingEnabled, false,                  \
   252           "Enables the parallelization of remembered set updating "         \
   253           "during evacuation pauses")                                       \
   254                                                                             \
   255   experimental(bool, G1ParallelRSetScanningEnabled, false,                  \
   256           "Enables the parallelization of remembered set scanning "         \
   257           "during evacuation pauses")                                       \
   258                                                                             \
   259   product(uintx, G1ParallelRSetThreads, 0,                                  \
   260           "If non-0 is the number of parallel rem set update threads, "     \
   261           "otherwise the value is determined ergonomically.")
   263 G1_FLAGS(DECLARE_DEVELOPER_FLAG, DECLARE_PD_DEVELOPER_FLAG, DECLARE_PRODUCT_FLAG, DECLARE_PD_PRODUCT_FLAG, DECLARE_DIAGNOSTIC_FLAG, DECLARE_EXPERIMENTAL_FLAG, DECLARE_NOTPRODUCT_FLAG, DECLARE_MANAGEABLE_FLAG, DECLARE_PRODUCT_RW_FLAG)

mercurial