annotate src/share/vm/gc_implementation/g1/g1_globals.hpp @ 883:27f6a9b9c311

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