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