g1_globals.hpp revision 9679:9689c3d3e2f8
1/* 2 * Copyright (c) 2001, 2015, Oracle and/or its affiliates. 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 20 * or visit www.oracle.com if you need additional information or have any 21 * questions. 22 * 23 */ 24 25#ifndef SHARE_VM_GC_G1_G1_GLOBALS_HPP 26#define SHARE_VM_GC_G1_G1_GLOBALS_HPP 27 28#include "runtime/globals.hpp" 29#include <float.h> // for DBL_MAX 30// 31// Defines all globals flags used by the garbage-first compiler. 32// 33 34#define G1_FLAGS(develop, develop_pd, product, product_pd, diagnostic, experimental, notproduct, manageable, product_rw, range, constraint) \ 35 \ 36 product(bool, G1UseAdaptiveIHOP, true, \ 37 "Adaptively adjust the initiating heap occupancy from the " \ 38 "initial value of InitiatingHeapOccupancyPercent. The policy " \ 39 "attempts to start marking in time based on application " \ 40 "behavior.") \ 41 \ 42 experimental(size_t, G1AdaptiveIHOPNumInitialSamples, 3, \ 43 "How many completed time periods from initial mark to first " \ 44 "mixed gc are required to use the input values for prediction " \ 45 "of the optimal occupancy to start marking.") \ 46 range(1, max_intx) \ 47 \ 48 product(uintx, G1ConfidencePercent, 50, \ 49 "Confidence level for MMU/pause predictions") \ 50 range(0, 100) \ 51 \ 52 develop(intx, G1MarkingOverheadPercent, 0, \ 53 "Overhead of concurrent marking") \ 54 range(0, 100) \ 55 \ 56 develop(intx, G1MarkingVerboseLevel, 0, \ 57 "Level (0-4) of verboseness of the marking code") \ 58 range(0, 4) \ 59 \ 60 develop(bool, G1TraceMarkStackOverflow, false, \ 61 "If true, extra debugging code for CM restart for ovflw.") \ 62 \ 63 diagnostic(bool, G1SummarizeConcMark, false, \ 64 "Summarize concurrent mark info") \ 65 \ 66 diagnostic(bool, G1SummarizeRSetStats, false, \ 67 "Summarize remembered set processing info") \ 68 \ 69 diagnostic(intx, G1SummarizeRSetStatsPeriod, 0, \ 70 "The period (in number of GCs) at which we will generate " \ 71 "update buffer processing info " \ 72 "(0 means do not periodically generate this info); " \ 73 "it also requires -XX:+G1SummarizeRSetStats") \ 74 range(0, max_intx) \ 75 \ 76 diagnostic(bool, G1TraceConcRefinement, false, \ 77 "Trace G1 concurrent refinement") \ 78 \ 79 experimental(bool, G1TraceStringSymbolTableScrubbing, false, \ 80 "Trace information string and symbol table scrubbing.") \ 81 \ 82 product(double, G1ConcMarkStepDurationMillis, 10.0, \ 83 "Target duration of individual concurrent marking steps " \ 84 "in milliseconds.") \ 85 range(1.0, DBL_MAX) \ 86 \ 87 product(intx, G1RefProcDrainInterval, 10, \ 88 "The number of discovered reference objects to process before " \ 89 "draining concurrent marking work queues.") \ 90 range(1, max_intx) \ 91 \ 92 experimental(bool, G1UseConcMarkReferenceProcessing, true, \ 93 "If true, enable reference discovery during concurrent " \ 94 "marking and reference processing at the end of remark.") \ 95 \ 96 experimental(double, G1LastPLABAverageOccupancy, 50.0, \ 97 "The expected average occupancy of the last PLAB in " \ 98 "percent.") \ 99 range(0.001, 100.0) \ 100 \ 101 product(size_t, G1SATBBufferSize, 1*K, \ 102 "Number of entries in an SATB log buffer.") \ 103 range(1, max_uintx) \ 104 \ 105 develop(intx, G1SATBProcessCompletedThreshold, 20, \ 106 "Number of completed buffers that triggers log processing.") \ 107 range(0, max_jint) \ 108 \ 109 product(uintx, G1SATBBufferEnqueueingThresholdPercent, 60, \ 110 "Before enqueueing them, each mutator thread tries to do some " \ 111 "filtering on the SATB buffers it generates. If post-filtering " \ 112 "the percentage of retained entries is over this threshold " \ 113 "the buffer will be enqueued for processing. A value of 0 " \ 114 "specifies that mutator threads should not do such filtering.") \ 115 range(0, 100) \ 116 \ 117 experimental(intx, G1ExpandByPercentOfAvailable, 20, \ 118 "When expanding, % of uncommitted space to claim.") \ 119 range(0, 100) \ 120 \ 121 develop(bool, G1RSBarrierRegionFilter, true, \ 122 "If true, generate region filtering code in RS barrier") \ 123 \ 124 diagnostic(bool, G1PrintRegionLivenessInfo, false, \ 125 "Prints the liveness information for all regions in the heap " \ 126 "at the end of a marking cycle.") \ 127 \ 128 product(size_t, G1UpdateBufferSize, 256, \ 129 "Size of an update buffer") \ 130 range(1, NOT_LP64(32*M) LP64_ONLY(1*G)) \ 131 \ 132 product(intx, G1ConcRefinementYellowZone, 0, \ 133 "Number of enqueued update buffers that will " \ 134 "trigger concurrent processing. Will be selected ergonomically " \ 135 "by default.") \ 136 range(0, max_intx) \ 137 \ 138 product(intx, G1ConcRefinementRedZone, 0, \ 139 "Maximum number of enqueued update buffers before mutator " \ 140 "threads start processing new ones instead of enqueueing them. " \ 141 "Will be selected ergonomically by default. Zero will disable " \ 142 "concurrent processing.") \ 143 range(0, max_intx) \ 144 \ 145 product(intx, G1ConcRefinementGreenZone, 0, \ 146 "The number of update buffers that are left in the queue by the " \ 147 "concurrent processing threads. Will be selected ergonomically " \ 148 "by default.") \ 149 range(0, max_intx) \ 150 \ 151 product(intx, G1ConcRefinementServiceIntervalMillis, 300, \ 152 "The last concurrent refinement thread wakes up every " \ 153 "specified number of milliseconds to do miscellaneous work.") \ 154 range(0, max_jint) \ 155 \ 156 product(intx, G1ConcRefinementThresholdStep, 0, \ 157 "Each time the rset update queue increases by this amount " \ 158 "activate the next refinement thread if available. " \ 159 "Will be selected ergonomically by default.") \ 160 range(0, max_jint) \ 161 \ 162 product(intx, G1RSetUpdatingPauseTimePercent, 10, \ 163 "A target percentage of time that is allowed to be spend on " \ 164 "process RS update buffers during the collection pause.") \ 165 range(0, 100) \ 166 \ 167 product(bool, G1UseAdaptiveConcRefinement, true, \ 168 "Select green, yellow and red zones adaptively to meet the " \ 169 "the pause requirements.") \ 170 \ 171 product(size_t, G1ConcRSLogCacheSize, 10, \ 172 "Log base 2 of the length of conc RS hot-card cache.") \ 173 range(0, 27) \ 174 \ 175 product(uintx, G1ConcRSHotCardLimit, 4, \ 176 "The threshold that defines (>=) a hot card.") \ 177 range(0, max_jubyte) \ 178 \ 179 develop(intx, G1RSetRegionEntriesBase, 256, \ 180 "Max number of regions in a fine-grain table per MB.") \ 181 range(1, max_jint/wordSize) \ 182 \ 183 product(intx, G1RSetRegionEntries, 0, \ 184 "Max number of regions for which we keep bitmaps." \ 185 "Will be set ergonomically by default") \ 186 range(0, max_jint/wordSize) \ 187 constraint(G1RSetRegionEntriesConstraintFunc,AfterErgo) \ 188 \ 189 develop(intx, G1RSetSparseRegionEntriesBase, 4, \ 190 "Max number of entries per region in a sparse table " \ 191 "per MB.") \ 192 range(1, max_jint/wordSize) \ 193 \ 194 product(intx, G1RSetSparseRegionEntries, 0, \ 195 "Max number of entries per region in a sparse table." \ 196 "Will be set ergonomically by default.") \ 197 range(0, max_jint/wordSize) \ 198 constraint(G1RSetSparseRegionEntriesConstraintFunc,AfterErgo) \ 199 \ 200 develop(intx, G1MaxVerifyFailures, -1, \ 201 "The maximum number of verification failures to print. " \ 202 "-1 means print all.") \ 203 range(-1, max_jint) \ 204 \ 205 develop(bool, G1ScrubRemSets, true, \ 206 "When true, do RS scrubbing after cleanup.") \ 207 \ 208 develop(bool, G1RSScrubVerbose, false, \ 209 "When true, do RS scrubbing with verbose output.") \ 210 \ 211 develop(bool, G1YoungSurvRateVerbose, false, \ 212 "print out the survival rate of young regions according to age.") \ 213 \ 214 develop(intx, G1YoungSurvRateNumRegionsSummary, 0, \ 215 "the number of regions for which we'll print a surv rate " \ 216 "summary.") \ 217 range(0, max_intx) \ 218 constraint(G1YoungSurvRateNumRegionsSummaryConstraintFunc,AfterErgo)\ 219 \ 220 product(uintx, G1ReservePercent, 10, \ 221 "It determines the minimum reserve we should have in the heap " \ 222 "to minimize the probability of promotion failure.") \ 223 range(0, 50) \ 224 \ 225 diagnostic(bool, G1PrintHeapRegions, false, \ 226 "If set G1 will print information on which regions are being " \ 227 "allocated and which are reclaimed.") \ 228 \ 229 develop(bool, G1HRRSUseSparseTable, true, \ 230 "When true, use sparse table to save space.") \ 231 \ 232 develop(bool, G1HRRSFlushLogBuffersOnVerify, false, \ 233 "Forces flushing of log buffers before verification.") \ 234 \ 235 product(size_t, G1HeapRegionSize, 0, \ 236 "Size of the G1 regions.") \ 237 range(0, 32*M) \ 238 constraint(G1HeapRegionSizeConstraintFunc,AfterMemoryInit) \ 239 \ 240 product(uintx, G1ConcRefinementThreads, 0, \ 241 "If non-0 is the number of parallel rem set update threads, " \ 242 "otherwise the value is determined ergonomically.") \ 243 range(0, (max_jint-1)/wordSize) \ 244 \ 245 develop(bool, G1VerifyCTCleanup, false, \ 246 "Verify card table cleanup.") \ 247 \ 248 product(size_t, G1RSetScanBlockSize, 64, \ 249 "Size of a work unit of cards claimed by a worker thread" \ 250 "during RSet scanning.") \ 251 range(1, max_uintx) \ 252 \ 253 develop(uintx, G1SecondaryFreeListAppendLength, 5, \ 254 "The number of regions we will add to the secondary free list " \ 255 "at every append operation") \ 256 \ 257 develop(bool, G1ConcRegionFreeingVerbose, false, \ 258 "Enables verboseness during concurrent region freeing") \ 259 \ 260 develop(bool, G1StressConcRegionFreeing, false, \ 261 "It stresses the concurrent region freeing operation") \ 262 \ 263 develop(uintx, G1StressConcRegionFreeingDelayMillis, 0, \ 264 "Artificial delay during concurrent region freeing") \ 265 \ 266 develop(uintx, G1DummyRegionsPerGC, 0, \ 267 "The number of dummy regions G1 will allocate at the end of " \ 268 "each evacuation pause in order to artificially fill up the " \ 269 "heap and stress the marking implementation.") \ 270 \ 271 develop(bool, G1ExitOnExpansionFailure, false, \ 272 "Raise a fatal VM exit out of memory failure in the event " \ 273 " that heap expansion fails due to running out of swap.") \ 274 \ 275 develop(uintx, G1ConcMarkForceOverflow, 0, \ 276 "The number of times we'll force an overflow during " \ 277 "concurrent marking") \ 278 \ 279 experimental(uintx, G1MaxNewSizePercent, 60, \ 280 "Percentage (0-100) of the heap size to use as default " \ 281 " maximum young gen size.") \ 282 range(0, 100) \ 283 constraint(G1MaxNewSizePercentConstraintFunc,AfterErgo) \ 284 \ 285 experimental(uintx, G1NewSizePercent, 5, \ 286 "Percentage (0-100) of the heap size to use as default " \ 287 "minimum young gen size.") \ 288 range(0, 100) \ 289 constraint(G1NewSizePercentConstraintFunc,AfterErgo) \ 290 \ 291 experimental(uintx, G1MixedGCLiveThresholdPercent, 85, \ 292 "Threshold for regions to be considered for inclusion in the " \ 293 "collection set of mixed GCs. " \ 294 "Regions with live bytes exceeding this will not be collected.") \ 295 range(0, 100) \ 296 \ 297 product(uintx, G1HeapWastePercent, 5, \ 298 "Amount of space, expressed as a percentage of the heap size, " \ 299 "that G1 is willing not to collect to avoid expensive GCs.") \ 300 range(0, 100) \ 301 \ 302 product(uintx, G1MixedGCCountTarget, 8, \ 303 "The target number of mixed GCs after a marking cycle.") \ 304 range(0, max_uintx) \ 305 \ 306 experimental(bool, G1EagerReclaimHumongousObjects, true, \ 307 "Try to reclaim dead large objects at every young GC.") \ 308 \ 309 experimental(bool, G1EagerReclaimHumongousObjectsWithStaleRefs, true, \ 310 "Try to reclaim dead large objects that have a few stale " \ 311 "references at every young GC.") \ 312 \ 313 experimental(bool, G1TraceEagerReclaimHumongousObjects, false, \ 314 "Print some information about large object liveness " \ 315 "at every young GC.") \ 316 \ 317 experimental(uintx, G1OldCSetRegionThresholdPercent, 10, \ 318 "An upper bound for the number of old CSet regions expressed " \ 319 "as a percentage of the heap size.") \ 320 range(0, 100) \ 321 \ 322 experimental(ccstr, G1LogLevel, NULL, \ 323 "Log level for G1 logging: fine, finer, finest") \ 324 \ 325 notproduct(bool, G1EvacuationFailureALot, false, \ 326 "Force use of evacuation failure handling during certain " \ 327 "evacuation pauses") \ 328 \ 329 develop(uintx, G1EvacuationFailureALotCount, 1000, \ 330 "Number of successful evacuations between evacuation failures " \ 331 "occurring at object copying") \ 332 \ 333 develop(uintx, G1EvacuationFailureALotInterval, 5, \ 334 "Total collections between forced triggering of evacuation " \ 335 "failures") \ 336 \ 337 develop(bool, G1EvacuationFailureALotDuringConcMark, true, \ 338 "Force use of evacuation failure handling during evacuation " \ 339 "pauses when marking is in progress") \ 340 \ 341 develop(bool, G1EvacuationFailureALotDuringInitialMark, true, \ 342 "Force use of evacuation failure handling during initial mark " \ 343 "evacuation pauses") \ 344 \ 345 develop(bool, G1EvacuationFailureALotDuringYoungGC, true, \ 346 "Force use of evacuation failure handling during young " \ 347 "evacuation pauses") \ 348 \ 349 develop(bool, G1EvacuationFailureALotDuringMixedGC, true, \ 350 "Force use of evacuation failure handling during mixed " \ 351 "evacuation pauses") \ 352 \ 353 diagnostic(bool, G1VerifyRSetsDuringFullGC, false, \ 354 "If true, perform verification of each heap region's " \ 355 "remembered set when verifying the heap during a full GC.") \ 356 \ 357 diagnostic(bool, G1VerifyHeapRegionCodeRoots, false, \ 358 "Verify the code root lists attached to each heap region.") \ 359 \ 360 develop(bool, G1VerifyBitmaps, false, \ 361 "Verifies the consistency of the marking bitmaps") 362 363G1_FLAGS(DECLARE_DEVELOPER_FLAG, \ 364 DECLARE_PD_DEVELOPER_FLAG, \ 365 DECLARE_PRODUCT_FLAG, \ 366 DECLARE_PD_PRODUCT_FLAG, \ 367 DECLARE_DIAGNOSTIC_FLAG, \ 368 DECLARE_EXPERIMENTAL_FLAG, \ 369 DECLARE_NOTPRODUCT_FLAG, \ 370 DECLARE_MANAGEABLE_FLAG, \ 371 DECLARE_PRODUCT_RW_FLAG, \ 372 IGNORE_RANGE, \ 373 IGNORE_CONSTRAINT) 374 375#endif // SHARE_VM_GC_G1_G1_GLOBALS_HPP 376