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