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 
 363 G1_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