annotate src/share/vm/gc_implementation/g1/g1_globals.hpp @ 1261:0414c1049f15

6923991: G1: improve scalability of RSet scanning Summary: Implemented block-based work stealing. Moved copying during the rset scanning phase to the main copying phase. Made the size of rset table depend on the region size. Reviewed-by: apetrusenko, tonyp
author iveresov
date Thu, 11 Feb 2010 15:52:19 -0800
parents 34fb2662f6c2
children b81f3572f355
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 \
tonyp@884 37 develop(intx, G1MarkingOverheadPercent, 0, \
ysr@342 38 "Overhead of concurrent marking") \
ysr@342 39 \
tonyp@942 40 product(uintx, G1YoungGenSize, 0, \
ysr@342 41 "Size of the G1 young generation, 0 is the adaptive policy") \
ysr@342 42 \
johnc@751 43 develop(bool, G1Gen, true, \
ysr@342 44 "If true, it will enable the generational G1") \
ysr@342 45 \
tonyp@884 46 develop(intx, G1GCPercent, 10, \
ysr@342 47 "The desired percent time spent on GC") \
ysr@342 48 \
johnc@751 49 develop(intx, G1PolicyVerbose, 0, \
ysr@342 50 "The verbosity level on G1 policy decisions") \
ysr@342 51 \
ysr@342 52 develop(bool, G1UseHRIntoRS, true, \
ysr@342 53 "Determines whether the 'advanced' HR Into rem set is used.") \
ysr@342 54 \
ysr@342 55 develop(intx, G1MarkingVerboseLevel, 0, \
ysr@342 56 "Level (0-4) of verboseness of the marking code") \
ysr@342 57 \
tonyp@1044 58 develop(bool, G1PrintReachableAtInitialMark, false, \
tonyp@1044 59 "Reachable object dump at the initial mark pause") \
tonyp@1044 60 \
tonyp@1044 61 develop(bool, G1VerifyDuringGCPrintReachable, false, \
tonyp@1044 62 "If conc mark verification fails, dump reachable objects") \
tonyp@1044 63 \
tonyp@1044 64 develop(ccstr, G1PrintReachableBaseFile, NULL, \
tonyp@1044 65 "The base file name for the reachable object dumps") \
ysr@342 66 \
ysr@342 67 develop(bool, G1TraceMarkStackOverflow, false, \
ysr@342 68 "If true, extra debugging code for CM restart for ovflw.") \
ysr@342 69 \
ysr@342 70 develop(intx, G1PausesBtwnConcMark, -1, \
ysr@342 71 "If positive, fixed number of pauses between conc markings") \
ysr@342 72 \
johnc@751 73 diagnostic(bool, G1SummarizeConcurrentMark, false, \
ysr@342 74 "Summarize concurrent mark info") \
ysr@342 75 \
johnc@751 76 diagnostic(bool, G1SummarizeRSetStats, false, \
ysr@342 77 "Summarize remembered set processing info") \
ysr@342 78 \
tonyp@884 79 diagnostic(intx, G1SummarizeRSetStatsPeriod, 0, \
tonyp@884 80 "The period (in number of GCs) at which we will generate " \
tonyp@884 81 "update buffer processing info " \
tonyp@884 82 "(0 means do not periodically generate this info); " \
tonyp@884 83 "it also requires -XX:+G1SummarizeRSetStats") \
tonyp@884 84 \
johnc@751 85 diagnostic(bool, G1SummarizeZFStats, false, \
ysr@342 86 "Summarize zero-filling info") \
ysr@342 87 \
iveresov@1111 88 diagnostic(bool, G1TraceConcurrentRefinement, false, \
ysr@342 89 "Trace G1 concurrent refinement") \
ysr@342 90 \
johnc@751 91 product(intx, G1MarkStackSize, 2 * 1024 * 1024, \
ysr@342 92 "Size of the mark stack for concurrent marking.") \
ysr@342 93 \
johnc@751 94 product(intx, G1MarkRegionStackSize, 1024 * 1024, \
ysr@342 95 "Size of the region stack for concurrent marking.") \
ysr@342 96 \
ysr@342 97 develop(bool, G1ConcZeroFill, true, \
ysr@342 98 "If true, run concurrent zero-filling thread") \
ysr@342 99 \
ysr@342 100 develop(intx, G1ConcZFMaxRegions, 1, \
ysr@342 101 "Stop zero-filling when # of zf'd regions reaches") \
ysr@342 102 \
ysr@342 103 product(intx, G1SteadyStateUsed, 90, \
ysr@342 104 "If non-0, try to maintain 'used' at this pct (of max)") \
ysr@342 105 \
ysr@342 106 product(intx, G1SteadyStateUsedDelta, 30, \
ysr@342 107 "If G1SteadyStateUsed is non-0, then do pause this number of " \
ysr@342 108 "of percentage points earlier if no marking is in progress.") \
ysr@342 109 \
ysr@342 110 develop(bool, G1SATBBarrierPrintNullPreVals, false, \
ysr@342 111 "If true, count frac of ptr writes with null pre-vals.") \
ysr@342 112 \
ysr@342 113 product(intx, G1SATBLogBufferSize, 1*K, \
ysr@342 114 "Number of entries in an SATB log buffer.") \
ysr@342 115 \
ysr@342 116 product(intx, G1SATBProcessCompletedThreshold, 20, \
ysr@342 117 "Number of completed buffers that triggers log processing.") \
ysr@342 118 \
ysr@342 119 develop(intx, G1ExtraRegionSurvRate, 33, \
ysr@342 120 "If the young survival rate is S, and there's room left in " \
ysr@342 121 "to-space, we will allow regions whose survival rate is up to " \
ysr@342 122 "S + (1 - S)*X, where X is this parameter (as a fraction.)") \
ysr@342 123 \
ysr@342 124 develop(intx, G1InitYoungSurvRatio, 50, \
ysr@342 125 "Expected Survival Rate for newly allocated bytes") \
ysr@342 126 \
ysr@342 127 develop(bool, G1SATBPrintStubs, false, \
ysr@342 128 "If true, print generated stubs for the SATB barrier") \
ysr@342 129 \
johnc@751 130 product(intx, G1ExpandByPercentOfAvailable, 20, \
ysr@342 131 "When expanding, % of uncommitted space to claim.") \
ysr@342 132 \
ysr@342 133 develop(bool, G1RSBarrierRegionFilter, true, \
ysr@342 134 "If true, generate region filtering code in RS barrier") \
ysr@342 135 \
ysr@342 136 develop(bool, G1RSBarrierNullFilter, true, \
ysr@342 137 "If true, generate null-pointer filtering code in RS barrier") \
ysr@342 138 \
ysr@342 139 develop(bool, G1PrintCTFilterStats, false, \
ysr@342 140 "If true, print stats on RS filtering effectiveness") \
ysr@342 141 \
iveresov@616 142 develop(bool, G1DeferredRSUpdate, true, \
iveresov@616 143 "If true, use deferred RS updates") \
iveresov@616 144 \
ysr@342 145 develop(bool, G1RSLogCheckCardTable, false, \
ysr@342 146 "If true, verify that no dirty cards remain after RS log " \
ysr@342 147 "processing.") \
ysr@342 148 \
ysr@342 149 develop(bool, G1RSCountHisto, false, \
ysr@342 150 "If true, print a histogram of RS occupancies after each pause") \
ysr@342 151 \
ysr@342 152 develop(intx, G1PrintRegionLivenessInfo, 0, \
ysr@342 153 "When > 0, print the occupancies of the <n> best and worst" \
ysr@342 154 "regions.") \
ysr@342 155 \
ysr@342 156 develop(bool, G1PrintParCleanupStats, false, \
ysr@342 157 "When true, print extra stats about parallel cleanup.") \
ysr@342 158 \
ysr@342 159 develop(bool, G1DisablePreBarrier, false, \
ysr@342 160 "Disable generation of pre-barrier (i.e., marking barrier) ") \
ysr@342 161 \
ysr@342 162 develop(bool, G1DisablePostBarrier, false, \
ysr@342 163 "Disable generation of post-barrier (i.e., RS barrier) ") \
ysr@342 164 \
tonyp@883 165 product(intx, G1UpdateBufferSize, 256, \
tonyp@883 166 "Size of an update buffer") \
tonyp@883 167 \
iveresov@1111 168 product(intx, G1ConcRefineYellowZone, 0, \
tonyp@883 169 "Number of enqueued update buffers that will " \
iveresov@1111 170 "trigger concurrent processing. Will be selected ergonomically " \
iveresov@1111 171 "by default.") \
tonyp@883 172 \
iveresov@1111 173 product(intx, G1ConcRefineRedZone, 0, \
tonyp@883 174 "Maximum number of enqueued update buffers before mutator " \
iveresov@1111 175 "threads start processing new ones instead of enqueueing them. " \
iveresov@1111 176 "Will be selected ergonomically by default. Zero will disable " \
iveresov@1111 177 "concurrent processing.") \
iveresov@1111 178 \
iveresov@1111 179 product(intx, G1ConcRefineGreenZone, 0, \
iveresov@1111 180 "The number of update buffers that are left in the queue by the " \
iveresov@1111 181 "concurrent processing threads. Will be selected ergonomically " \
iveresov@1111 182 "by default.") \
iveresov@1111 183 \
iveresov@1111 184 product(intx, G1ConcRefineServiceInterval, 300, \
iveresov@1111 185 "The last concurrent refinement thread wakes up every " \
iveresov@1111 186 "specified number of milliseconds to do miscellaneous work.") \
iveresov@1111 187 \
iveresov@1111 188 product(intx, G1ConcRefineThresholdStep, 0, \
iveresov@1111 189 "Each time the rset update queue increases by this amount " \
iveresov@1111 190 "activate the next refinement thread if available. " \
iveresov@1111 191 "Will be selected ergonomically by default.") \
iveresov@1111 192 \
iveresov@1111 193 product(intx, G1RSUpdatePauseFractionPercent, 10, \
iveresov@1111 194 "A target percentage of time that is allowed to be spend on " \
iveresov@1111 195 "process RS update buffers during the collection pause.") \
iveresov@1111 196 \
iveresov@1111 197 product(bool, G1AdaptiveConcRefine, true, \
iveresov@1111 198 "Select green, yellow and red zones adaptively to meet the " \
iveresov@1111 199 "the pause requirements.") \
ysr@342 200 \
ysr@342 201 develop(intx, G1ConcRSLogCacheSize, 10, \
ysr@342 202 "Log base 2 of the length of conc RS hot-card cache.") \
ysr@342 203 \
johnc@751 204 develop(intx, G1ConcRSHotCardLimit, 4, \
ysr@342 205 "The threshold that defines (>=) a hot card.") \
ysr@342 206 \
ysr@342 207 develop(bool, G1PrintOopAppls, false, \
ysr@342 208 "When true, print applications of closures to external locs.") \
ysr@342 209 \
iveresov@1261 210 develop(intx, G1RSetRegionEntriesBase, 256, \
iveresov@1261 211 "Max number of regions in a fine-grain table per MB.") \
iveresov@1261 212 \
iveresov@1261 213 product(intx, G1RSetRegionEntries, 0, \
iveresov@1261 214 "Max number of regions for which we keep bitmaps." \
iveresov@1261 215 "Will be set ergonomically by default") \
iveresov@1261 216 \
iveresov@1261 217 develop(intx, G1RSetSparseRegionEntriesBase, 4, \
iveresov@1261 218 "Max number of entries per region in a sparse table " \
iveresov@1261 219 "per MB.") \
iveresov@1261 220 \
iveresov@1261 221 product(intx, G1RSetSparseRegionEntries, 0, \
iveresov@1261 222 "Max number of entries per region in a sparse table." \
iveresov@1261 223 "Will be set ergonomically by default.") \
ysr@342 224 \
ysr@342 225 develop(bool, G1RecordHRRSOops, false, \
ysr@342 226 "When true, record recent calls to rem set operations.") \
ysr@342 227 \
ysr@342 228 develop(bool, G1RecordHRRSEvents, false, \
ysr@342 229 "When true, record recent calls to rem set operations.") \
ysr@342 230 \
ysr@342 231 develop(intx, G1MaxVerifyFailures, -1, \
ysr@342 232 "The maximum number of verification failrues to print. " \
ysr@342 233 "-1 means print all.") \
ysr@342 234 \
ysr@342 235 develop(bool, G1ScrubRemSets, true, \
ysr@342 236 "When true, do RS scrubbing after cleanup.") \
ysr@342 237 \
ysr@342 238 develop(bool, G1RSScrubVerbose, false, \
ysr@342 239 "When true, do RS scrubbing with verbose output.") \
ysr@342 240 \
ysr@342 241 develop(bool, G1YoungSurvRateVerbose, false, \
ysr@342 242 "print out the survival rate of young regions according to age.") \
ysr@342 243 \
ysr@342 244 develop(intx, G1YoungSurvRateNumRegionsSummary, 0, \
ysr@342 245 "the number of regions for which we'll print a surv rate " \
ysr@342 246 "summary.") \
ysr@342 247 \
ysr@342 248 product(bool, G1UseScanOnlyPrefix, false, \
ysr@342 249 "It determines whether the system will calculate an optimum " \
ysr@342 250 "scan-only set.") \
ysr@342 251 \
johnc@751 252 product(intx, G1MinReservePercent, 10, \
ysr@342 253 "It determines the minimum reserve we should have in the heap " \
ysr@342 254 "to minimize the probability of promotion failure.") \
ysr@342 255 \
johnc@751 256 diagnostic(bool, G1PrintRegions, false, \
ysr@342 257 "If set G1 will print information on which regions are being " \
ysr@342 258 "allocated and which are reclaimed.") \
ysr@342 259 \
ysr@342 260 develop(bool, G1HRRSUseSparseTable, true, \
ysr@342 261 "When true, use sparse table to save space.") \
ysr@342 262 \
ysr@342 263 develop(bool, G1HRRSFlushLogBuffersOnVerify, false, \
ysr@342 264 "Forces flushing of log buffers before verification.") \
ysr@342 265 \
johnc@751 266 product(bool, G1UseSurvivorSpaces, true, \
apetrusenko@545 267 "When true, use survivor space.") \
apetrusenko@545 268 \
ysr@1087 269 develop(bool, G1FailOnFPError, false, \
ysr@1087 270 "When set, G1 will fail when it encounters an FP 'error', " \
ysr@1087 271 "so as to allow debugging") \
ysr@1087 272 \
johnc@751 273 develop(bool, G1FixedTenuringThreshold, false, \
apetrusenko@545 274 "When set, G1 will not adjust the tenuring threshold") \
apetrusenko@545 275 \
johnc@751 276 develop(bool, G1FixedEdenSize, false, \
apetrusenko@545 277 "When set, G1 will not allocate unused survivor space regions") \
apetrusenko@545 278 \
johnc@751 279 develop(uintx, G1FixedSurvivorSpaceSize, 0, \
apetrusenko@545 280 "If non-0 is the size of the G1 survivor space, " \
tonyp@638 281 "otherwise SurvivorRatio is used to determine the size") \
tonyp@638 282 \
ysr@1088 283 product(bool, G1ForgetfulMMUTracker, false, \
ysr@1088 284 "If the MMU tracker's memory is full, forget the oldest entry") \
ysr@1088 285 \
tonyp@942 286 product(uintx, G1HeapRegionSize, 0, \
tonyp@942 287 "Size of the G1 regions.") \
tonyp@942 288 \
johnc@751 289 experimental(bool, G1ParallelRSetUpdatingEnabled, false, \
tonyp@638 290 "Enables the parallelization of remembered set updating " \
tonyp@638 291 "during evacuation pauses") \
tonyp@638 292 \
johnc@751 293 experimental(bool, G1ParallelRSetScanningEnabled, false, \
tonyp@638 294 "Enables the parallelization of remembered set scanning " \
iveresov@794 295 "during evacuation pauses") \
iveresov@794 296 \
iveresov@794 297 product(uintx, G1ParallelRSetThreads, 0, \
iveresov@794 298 "If non-0 is the number of parallel rem set update threads, " \
johnc@890 299 "otherwise the value is determined ergonomically.") \
johnc@890 300 \
johnc@890 301 develop(intx, G1CardCountCacheExpandThreshold, 16, \
johnc@890 302 "Expand the card count cache if the number of collisions for " \
apetrusenko@940 303 "a particular entry exceeds this value.") \
apetrusenko@940 304 \
apetrusenko@940 305 develop(bool, G1VerifyCTCleanup, false, \
ysr@1194 306 "Verify card table cleanup.") \
ysr@1194 307 \
iveresov@1261 308 product(uintx, G1RSetScanBlockSize, 64, \
iveresov@1261 309 "Size of a work unit of cards claimed by a worker thread" \
iveresov@1261 310 "during RSet scanning.") \
iveresov@1261 311 \
ysr@1194 312 develop(bool, ReduceInitialCardMarksForG1, false, \
ysr@1194 313 "When ReduceInitialCardMarks is true, this flag setting " \
ysr@1194 314 " controls whether G1 allows the RICM optimization")
ysr@342 315
ysr@350 316 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)