annotate src/share/vm/gc_implementation/g1/g1_globals.hpp @ 638:2a5da27ccae9

6816154: G1: introduce flags to enable/disable RSet updating and scanning Summary: Introduces two flags, -XX:-/+G1EnableParallelRSetUpdating and -XX:-/+G1EnableParallelRSetScanning, to turn on/off the "band aid" fix that serializes RSet updating / scanning during GCs. Reviewed-by: iveresov
author tonyp
date Mon, 16 Mar 2009 10:52:44 -0400
parents 4f360ec815ba
children ba50942c8138
rev   line source
ysr@342 1 /*
ysr@342 2 * Copyright 2001-2007 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 \
tonyp@526 31 product(intx, ParallelGCG1AllocBufferSize, 8*K, \
ysr@342 32 "Size of parallel G1 allocation buffers in to-space.") \
ysr@342 33 \
ysr@342 34 product(intx, G1TimeSliceMS, 500, \
ysr@342 35 "Time slice for MMU specification") \
ysr@342 36 \
ysr@342 37 product(intx, G1MaxPauseTimeMS, 200, \
ysr@342 38 "Max GC time per MMU time slice") \
ysr@342 39 \
ysr@342 40 product(intx, G1ConfidencePerc, 50, \
ysr@342 41 "Confidence level for MMU/pause predictions") \
ysr@342 42 \
ysr@342 43 product(intx, G1MarkingOverheadPerc, 0, \
ysr@342 44 "Overhead of concurrent marking") \
ysr@342 45 \
ysr@342 46 product(bool, G1AccountConcurrentOverhead, false, \
ysr@342 47 "Whether soft real-time compliance in G1 will take into account" \
ysr@342 48 "concurrent overhead") \
ysr@342 49 \
ysr@342 50 product(intx, G1YoungGenSize, 0, \
ysr@342 51 "Size of the G1 young generation, 0 is the adaptive policy") \
ysr@342 52 \
ysr@342 53 product(bool, G1Gen, true, \
ysr@342 54 "If true, it will enable the generational G1") \
ysr@342 55 \
ysr@342 56 develop(intx, G1GCPct, 10, \
ysr@342 57 "The desired percent time spent on GC") \
ysr@342 58 \
ysr@342 59 product(intx, G1PolicyVerbose, 0, \
ysr@342 60 "The verbosity level on G1 policy decisions") \
ysr@342 61 \
ysr@342 62 develop(bool, G1UseHRIntoRS, true, \
ysr@342 63 "Determines whether the 'advanced' HR Into rem set is used.") \
ysr@342 64 \
ysr@342 65 product(bool, G1VerifyRemSet, false, \
ysr@342 66 "If true, verify the rem set functioning at each GC") \
ysr@342 67 \
ysr@342 68 product(bool, G1VerifyConcMark, false, \
ysr@342 69 "If true, verify the conc marking code at full GC time") \
ysr@342 70 \
ysr@342 71 develop(intx, G1MarkingVerboseLevel, 0, \
ysr@342 72 "Level (0-4) of verboseness of the marking code") \
ysr@342 73 \
ysr@342 74 develop(bool, G1VerifyConcMarkPrintReachable, true, \
ysr@342 75 "If conc mark verification fails, print reachable objects") \
ysr@342 76 \
ysr@342 77 develop(bool, G1TraceMarkStackOverflow, false, \
ysr@342 78 "If true, extra debugging code for CM restart for ovflw.") \
ysr@342 79 \
ysr@342 80 product(bool, G1VerifyMarkingInEvac, false, \
ysr@342 81 "If true, verify marking info during evacuation") \
ysr@342 82 \
ysr@342 83 develop(intx, G1PausesBtwnConcMark, -1, \
ysr@342 84 "If positive, fixed number of pauses between conc markings") \
ysr@342 85 \
ysr@342 86 product(intx, G1EfficiencyPctCausesMark, 80, \
ysr@342 87 "The cum gc efficiency since mark fall-off that causes " \
ysr@342 88 "new marking") \
ysr@342 89 \
ysr@342 90 product(bool, TraceConcurrentMark, false, \
ysr@342 91 "Trace concurrent mark") \
ysr@342 92 \
ysr@342 93 product(bool, SummarizeG1ConcMark, false, \
ysr@342 94 "Summarize concurrent mark info") \
ysr@342 95 \
ysr@342 96 product(bool, SummarizeG1RSStats, false, \
ysr@342 97 "Summarize remembered set processing info") \
ysr@342 98 \
ysr@342 99 product(bool, SummarizeG1ZFStats, false, \
ysr@342 100 "Summarize zero-filling info") \
ysr@342 101 \
ysr@342 102 product(bool, TraceG1Refine, false, \
ysr@342 103 "Trace G1 concurrent refinement") \
ysr@342 104 \
ysr@342 105 develop(bool, G1ConcMark, true, \
ysr@342 106 "If true, run concurrent marking for G1") \
ysr@342 107 \
ysr@342 108 product(intx, G1CMStackSize, 2 * 1024 * 1024, \
ysr@342 109 "Size of the mark stack for concurrent marking.") \
ysr@342 110 \
ysr@342 111 product(intx, G1CMRegionStackSize, 1024 * 1024, \
ysr@342 112 "Size of the region stack for concurrent marking.") \
ysr@342 113 \
ysr@342 114 develop(bool, G1ConcRefine, true, \
ysr@342 115 "If true, run concurrent rem set refinement for G1") \
ysr@342 116 \
ysr@342 117 develop(intx, G1ConcRefineTargTraversals, 4, \
ysr@342 118 "Number of concurrent refinement we try to achieve") \
ysr@342 119 \
ysr@342 120 develop(intx, G1ConcRefineInitialDelta, 4, \
ysr@342 121 "Number of heap regions of alloc ahead of starting collection " \
ysr@342 122 "pause to start concurrent refinement (initially)") \
ysr@342 123 \
ysr@342 124 product(bool, G1SmoothConcRefine, true, \
ysr@342 125 "Attempts to smooth out the overhead of concurrent refinement") \
ysr@342 126 \
ysr@342 127 develop(bool, G1ConcZeroFill, true, \
ysr@342 128 "If true, run concurrent zero-filling thread") \
ysr@342 129 \
ysr@342 130 develop(intx, G1ConcZFMaxRegions, 1, \
ysr@342 131 "Stop zero-filling when # of zf'd regions reaches") \
ysr@342 132 \
ysr@342 133 product(intx, G1SteadyStateUsed, 90, \
ysr@342 134 "If non-0, try to maintain 'used' at this pct (of max)") \
ysr@342 135 \
ysr@342 136 product(intx, G1SteadyStateUsedDelta, 30, \
ysr@342 137 "If G1SteadyStateUsed is non-0, then do pause this number of " \
ysr@342 138 "of percentage points earlier if no marking is in progress.") \
ysr@342 139 \
ysr@342 140 develop(bool, G1SATBBarrierPrintNullPreVals, false, \
ysr@342 141 "If true, count frac of ptr writes with null pre-vals.") \
ysr@342 142 \
ysr@342 143 product(intx, G1SATBLogBufferSize, 1*K, \
ysr@342 144 "Number of entries in an SATB log buffer.") \
ysr@342 145 \
ysr@342 146 product(intx, G1SATBProcessCompletedThreshold, 20, \
ysr@342 147 "Number of completed buffers that triggers log processing.") \
ysr@342 148 \
ysr@342 149 develop(intx, G1ExtraRegionSurvRate, 33, \
ysr@342 150 "If the young survival rate is S, and there's room left in " \
ysr@342 151 "to-space, we will allow regions whose survival rate is up to " \
ysr@342 152 "S + (1 - S)*X, where X is this parameter (as a fraction.)") \
ysr@342 153 \
ysr@342 154 develop(intx, G1InitYoungSurvRatio, 50, \
ysr@342 155 "Expected Survival Rate for newly allocated bytes") \
ysr@342 156 \
ysr@342 157 develop(bool, G1SATBPrintStubs, false, \
ysr@342 158 "If true, print generated stubs for the SATB barrier") \
ysr@342 159 \
ysr@342 160 product(intx, G1ExpandByPctOfAvail, 20, \
ysr@342 161 "When expanding, % of uncommitted space to claim.") \
ysr@342 162 \
ysr@342 163 develop(bool, G1RSBarrierRegionFilter, true, \
ysr@342 164 "If true, generate region filtering code in RS barrier") \
ysr@342 165 \
ysr@342 166 develop(bool, G1RSBarrierNullFilter, true, \
ysr@342 167 "If true, generate null-pointer filtering code in RS barrier") \
ysr@342 168 \
ysr@342 169 develop(bool, G1PrintCTFilterStats, false, \
ysr@342 170 "If true, print stats on RS filtering effectiveness") \
ysr@342 171 \
ysr@342 172 develop(bool, G1RSBarrierUseQueue, true, \
ysr@342 173 "If true, use queueing RS barrier") \
ysr@342 174 \
iveresov@616 175 develop(bool, G1DeferredRSUpdate, true, \
iveresov@616 176 "If true, use deferred RS updates") \
iveresov@616 177 \
ysr@342 178 develop(bool, G1RSLogCheckCardTable, false, \
ysr@342 179 "If true, verify that no dirty cards remain after RS log " \
ysr@342 180 "processing.") \
ysr@342 181 \
ysr@342 182 product(intx, G1MinPausesBetweenMarks, 2, \
ysr@342 183 "Number of inefficient pauses necessary to trigger marking.") \
ysr@342 184 \
ysr@342 185 product(intx, G1InefficientPausePct, 80, \
ysr@342 186 "Threshold of an 'inefficient' pauses (as % of cum efficiency.") \
ysr@342 187 \
ysr@342 188 product(intx, G1RSPopLimit, 32768, \
ysr@342 189 "Limit that defines popularity. Should go away! XXX") \
ysr@342 190 \
ysr@342 191 develop(bool, G1RSCountHisto, false, \
ysr@342 192 "If true, print a histogram of RS occupancies after each pause") \
ysr@342 193 \
ysr@342 194 product(intx, G1ObjPopLimit, 256, \
ysr@342 195 "Limit that defines popularity for an object.") \
ysr@342 196 \
ysr@342 197 product(bool, G1TraceFileOverwrite, false, \
ysr@342 198 "Allow the trace file to be overwritten") \
ysr@342 199 \
ysr@342 200 develop(intx, G1PrintRegionLivenessInfo, 0, \
ysr@342 201 "When > 0, print the occupancies of the <n> best and worst" \
ysr@342 202 "regions.") \
ysr@342 203 \
ysr@342 204 develop(bool, G1TracePopularity, false, \
ysr@342 205 "When true, provide detailed tracing of popularity.") \
ysr@342 206 \
ysr@342 207 product(bool, G1SummarizePopularity, false, \
ysr@342 208 "When true, provide end-of-run-summarization of popularity.") \
ysr@342 209 \
ysr@342 210 product(intx, G1NumPopularRegions, 1, \
ysr@342 211 "Number of regions reserved to hold popular objects. " \
ysr@342 212 "Should go away later.") \
ysr@342 213 \
ysr@342 214 develop(bool, G1PrintParCleanupStats, false, \
ysr@342 215 "When true, print extra stats about parallel cleanup.") \
ysr@342 216 \
ysr@342 217 product(bool, G1DoAgeCohortChecks, false, \
ysr@342 218 "When true, check well-formedness of age cohort structures.") \
ysr@342 219 \
ysr@342 220 develop(bool, G1DisablePreBarrier, false, \
ysr@342 221 "Disable generation of pre-barrier (i.e., marking barrier) ") \
ysr@342 222 \
ysr@342 223 develop(bool, G1DisablePostBarrier, false, \
ysr@342 224 "Disable generation of post-barrier (i.e., RS barrier) ") \
ysr@342 225 \
ysr@342 226 product(intx, G1DirtyCardQueueMax, 30, \
ysr@342 227 "Maximum number of completed RS buffers before mutator threads " \
ysr@342 228 "start processing them.") \
ysr@342 229 \
ysr@342 230 develop(intx, G1ConcRSLogCacheSize, 10, \
ysr@342 231 "Log base 2 of the length of conc RS hot-card cache.") \
ysr@342 232 \
ysr@342 233 product(bool, G1ConcRSCountTraversals, false, \
ysr@342 234 "If true, gather data about the number of times CR traverses " \
ysr@342 235 "cards ") \
ysr@342 236 \
ysr@342 237 product(intx, G1ConcRSHotCardLimit, 4, \
ysr@342 238 "The threshold that defines (>=) a hot card.") \
ysr@342 239 \
ysr@342 240 develop(bool, G1PrintOopAppls, false, \
ysr@342 241 "When true, print applications of closures to external locs.") \
ysr@342 242 \
ysr@342 243 product(intx, G1LogRSRegionEntries, 7, \
ysr@342 244 "Log_2 of max number of regions for which we keep bitmaps.") \
ysr@342 245 \
ysr@342 246 develop(bool, G1RecordHRRSOops, false, \
ysr@342 247 "When true, record recent calls to rem set operations.") \
ysr@342 248 \
ysr@342 249 develop(bool, G1RecordHRRSEvents, false, \
ysr@342 250 "When true, record recent calls to rem set operations.") \
ysr@342 251 \
ysr@342 252 develop(intx, G1MaxVerifyFailures, -1, \
ysr@342 253 "The maximum number of verification failrues to print. " \
ysr@342 254 "-1 means print all.") \
ysr@342 255 \
ysr@342 256 develop(bool, G1ScrubRemSets, true, \
ysr@342 257 "When true, do RS scrubbing after cleanup.") \
ysr@342 258 \
ysr@342 259 develop(bool, G1RSScrubVerbose, false, \
ysr@342 260 "When true, do RS scrubbing with verbose output.") \
ysr@342 261 \
ysr@342 262 develop(bool, G1YoungSurvRateVerbose, false, \
ysr@342 263 "print out the survival rate of young regions according to age.") \
ysr@342 264 \
ysr@342 265 develop(intx, G1YoungSurvRateNumRegionsSummary, 0, \
ysr@342 266 "the number of regions for which we'll print a surv rate " \
ysr@342 267 "summary.") \
ysr@342 268 \
ysr@342 269 product(bool, G1UseScanOnlyPrefix, false, \
ysr@342 270 "It determines whether the system will calculate an optimum " \
ysr@342 271 "scan-only set.") \
ysr@342 272 \
ysr@342 273 product(intx, G1MinReservePerc, 10, \
ysr@342 274 "It determines the minimum reserve we should have in the heap " \
ysr@342 275 "to minimize the probability of promotion failure.") \
ysr@342 276 \
ysr@342 277 product(bool, G1TraceRegions, false, \
ysr@342 278 "If set G1 will print information on which regions are being " \
ysr@342 279 "allocated and which are reclaimed.") \
ysr@342 280 \
ysr@342 281 develop(bool, G1HRRSUseSparseTable, true, \
ysr@342 282 "When true, use sparse table to save space.") \
ysr@342 283 \
ysr@342 284 develop(bool, G1HRRSFlushLogBuffersOnVerify, false, \
ysr@342 285 "Forces flushing of log buffers before verification.") \
ysr@342 286 \
apetrusenko@545 287 product(bool, G1UseSurvivorSpace, true, \
apetrusenko@545 288 "When true, use survivor space.") \
apetrusenko@545 289 \
apetrusenko@545 290 product(bool, G1FixedTenuringThreshold, false, \
apetrusenko@545 291 "When set, G1 will not adjust the tenuring threshold") \
apetrusenko@545 292 \
apetrusenko@545 293 product(bool, G1FixedEdenSize, false, \
apetrusenko@545 294 "When set, G1 will not allocate unused survivor space regions") \
apetrusenko@545 295 \
apetrusenko@545 296 product(uintx, G1FixedSurvivorSpaceSize, 0, \
apetrusenko@545 297 "If non-0 is the size of the G1 survivor space, " \
tonyp@638 298 "otherwise SurvivorRatio is used to determine the size") \
tonyp@638 299 \
tonyp@638 300 experimental(bool, G1EnableParallelRSetUpdating, false, \
tonyp@638 301 "Enables the parallelization of remembered set updating " \
tonyp@638 302 "during evacuation pauses") \
tonyp@638 303 \
tonyp@638 304 experimental(bool, G1EnableParallelRSetScanning, false, \
tonyp@638 305 "Enables the parallelization of remembered set scanning " \
tonyp@638 306 "during evacuation pauses")
ysr@342 307
ysr@350 308 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)