src/share/vm/gc_implementation/g1/g1_globals.hpp

Fri, 23 Mar 2012 10:53:19 -0400

author
tonyp
date
Fri, 23 Mar 2012 10:53:19 -0400
changeset 3667
21595f05bc93
parent 3539
a9647476d1a4
child 3691
2a0172480595
permissions
-rw-r--r--

7146246: G1: expose some of the -XX flags that drive which old regions to collect during mixed GCs
Summary: Make two G1 cmd line flags available in product builds: G1HeapWastePercent (previously called: G1OldReclaimableThresholdPercent) and G1MixedGCCountTarget (previous called: G1MaxMixedGCNum). Also changed the default of the former from 1% to 5% and the default for G1OldCSetRegionLiveThresholdPercent to 90%.
Reviewed-by: azeemj, jwilhelm, johnc

     1 /*
     2  * Copyright (c) 2001, 2012, 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  */
    25 #ifndef SHARE_VM_GC_IMPLEMENTATION_G1_G1_GLOBALS_HPP
    26 #define SHARE_VM_GC_IMPLEMENTATION_G1_G1_GLOBALS_HPP
    28 #include "runtime/globals.hpp"
    30 //
    31 // Defines all globals flags used by the garbage-first compiler.
    32 //
    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(intx, G1MarkingVerboseLevel, 0,                                   \
    43           "Level (0-4) of verboseness of the marking code")                 \
    44                                                                             \
    45   develop(bool, G1PrintReachableAtInitialMark, false,                       \
    46           "Reachable object dump at the initial mark pause")                \
    47                                                                             \
    48   develop(bool, G1VerifyDuringGCPrintReachable, false,                      \
    49           "If conc mark verification fails, dump reachable objects")        \
    50                                                                             \
    51   develop(ccstr, G1PrintReachableBaseFile, NULL,                            \
    52           "The base file name for the reachable object dumps")              \
    53                                                                             \
    54   develop(bool, G1TraceMarkStackOverflow, false,                            \
    55           "If true, extra debugging code for CM restart for ovflw.")        \
    56                                                                             \
    57   diagnostic(bool, G1SummarizeConcMark, false,                              \
    58           "Summarize concurrent mark info")                                 \
    59                                                                             \
    60   diagnostic(bool, G1SummarizeRSetStats, false,                             \
    61           "Summarize remembered set processing info")                       \
    62                                                                             \
    63   diagnostic(intx, G1SummarizeRSetStatsPeriod, 0,                           \
    64           "The period (in number of GCs) at which we will generate "        \
    65           "update buffer processing info "                                  \
    66           "(0 means do not periodically generate this info); "              \
    67           "it also requires -XX:+G1SummarizeRSetStats")                     \
    68                                                                             \
    69   diagnostic(bool, G1TraceConcRefinement, false,                            \
    70           "Trace G1 concurrent refinement")                                 \
    71                                                                             \
    72   product(intx, G1MarkRegionStackSize, 1024 * 1024,                         \
    73           "Size of the region stack for concurrent marking.")               \
    74                                                                             \
    75   product(double, G1ConcMarkStepDurationMillis, 10.0,                       \
    76           "Target duration of individual concurrent marking steps "         \
    77           "in milliseconds.")                                               \
    78                                                                             \
    79   product(intx, G1RefProcDrainInterval, 10,                                 \
    80           "The number of discovered reference objects to process before "   \
    81           "draining concurrent marking work queues.")                       \
    82                                                                             \
    83   experimental(bool, G1UseConcMarkReferenceProcessing, true,                \
    84           "If true, enable reference discovery during concurrent "          \
    85           "marking and reference processing at the end of remark.")         \
    86                                                                             \
    87   product(intx, G1SATBBufferSize, 1*K,                                      \
    88           "Number of entries in an SATB log buffer.")                       \
    89                                                                             \
    90   develop(intx, G1SATBProcessCompletedThreshold, 20,                        \
    91           "Number of completed buffers that triggers log processing.")      \
    92                                                                             \
    93   product(uintx, G1SATBBufferEnqueueingThresholdPercent, 60,                \
    94           "Before enqueueing them, each mutator thread tries to do some "   \
    95           "filtering on the SATB buffers it generates. If post-filtering "  \
    96           "the percentage of retained entries is over this threshold "      \
    97           "the buffer will be enqueued for processing. A value of 0 "       \
    98           "specifies that mutator threads should not do such filtering.")   \
    99                                                                             \
   100   develop(intx, G1ExtraRegionSurvRate, 33,                                  \
   101           "If the young survival rate is S, and there's room left in "      \
   102           "to-space, we will allow regions whose survival rate is up to "   \
   103           "S + (1 - S)*X, where X is this parameter (as a fraction.)")      \
   104                                                                             \
   105   develop(intx, G1InitYoungSurvRatio, 50,                                   \
   106           "Expected Survival Rate for newly allocated bytes")               \
   107                                                                             \
   108   develop(bool, G1SATBPrintStubs, false,                                    \
   109           "If true, print generated stubs for the SATB barrier")            \
   110                                                                             \
   111   experimental(intx, G1ExpandByPercentOfAvailable, 20,                      \
   112           "When expanding, % of uncommitted space to claim.")               \
   113                                                                             \
   114   develop(bool, G1RSBarrierRegionFilter, true,                              \
   115           "If true, generate region filtering code in RS barrier")          \
   116                                                                             \
   117   develop(bool, G1RSBarrierNullFilter, true,                                \
   118           "If true, generate null-pointer filtering code in RS barrier")    \
   119                                                                             \
   120   develop(bool, G1DeferredRSUpdate, true,                                   \
   121           "If true, use deferred RS updates")                               \
   122                                                                             \
   123   develop(bool, G1RSLogCheckCardTable, false,                               \
   124           "If true, verify that no dirty cards remain after RS log "        \
   125           "processing.")                                                    \
   126                                                                             \
   127   develop(bool, G1RSCountHisto, false,                                      \
   128           "If true, print a histogram of RS occupancies after each pause")  \
   129                                                                             \
   130   diagnostic(bool, G1PrintRegionLivenessInfo, false,                        \
   131             "Prints the liveness information for all regions in the heap "  \
   132             "at the end of a marking cycle.")                               \
   133                                                                             \
   134   develop(bool, G1PrintParCleanupStats, false,                              \
   135           "When true, print extra stats about parallel cleanup.")           \
   136                                                                             \
   137   product(intx, G1UpdateBufferSize, 256,                                    \
   138           "Size of an update buffer")                                       \
   139                                                                             \
   140   product(intx, G1ConcRefinementYellowZone, 0,                              \
   141           "Number of enqueued update buffers that will "                    \
   142           "trigger concurrent processing. Will be selected ergonomically "  \
   143           "by default.")                                                    \
   144                                                                             \
   145   product(intx, G1ConcRefinementRedZone, 0,                                 \
   146           "Maximum number of enqueued update buffers before mutator "       \
   147           "threads start processing new ones instead of enqueueing them. "  \
   148           "Will be selected ergonomically by default. Zero will disable "   \
   149           "concurrent processing.")                                         \
   150                                                                             \
   151   product(intx, G1ConcRefinementGreenZone, 0,                               \
   152           "The number of update buffers that are left in the queue by the " \
   153           "concurrent processing threads. Will be selected ergonomically "  \
   154           "by default.")                                                    \
   155                                                                             \
   156   product(intx, G1ConcRefinementServiceIntervalMillis, 300,                 \
   157           "The last concurrent refinement thread wakes up every "           \
   158           "specified number of milliseconds to do miscellaneous work.")     \
   159                                                                             \
   160   product(intx, G1ConcRefinementThresholdStep, 0,                           \
   161           "Each time the rset update queue increases by this amount "       \
   162           "activate the next refinement thread if available. "              \
   163           "Will be selected ergonomically by default.")                     \
   164                                                                             \
   165   product(intx, G1RSetUpdatingPauseTimePercent, 10,                         \
   166           "A target percentage of time that is allowed to be spend on "     \
   167           "process RS update buffers during the collection pause.")         \
   168                                                                             \
   169   product(bool, G1UseAdaptiveConcRefinement, true,                          \
   170           "Select green, yellow and red zones adaptively to meet the "      \
   171           "the pause requirements.")                                        \
   172                                                                             \
   173   develop(intx, G1ConcRSLogCacheSize, 10,                                   \
   174           "Log base 2 of the length of conc RS hot-card cache.")            \
   175                                                                             \
   176   develop(intx, G1ConcRSHotCardLimit, 4,                                    \
   177           "The threshold that defines (>=) a hot card.")                    \
   178                                                                             \
   179   develop(intx, G1MaxHotCardCountSizePercent, 25,                           \
   180           "The maximum size of the hot card count cache as a "              \
   181           "percentage of the number of cards for the maximum heap.")        \
   182                                                                             \
   183   develop(bool, G1PrintOopAppls, false,                                     \
   184           "When true, print applications of closures to external locs.")    \
   185                                                                             \
   186   develop(intx, G1RSetRegionEntriesBase, 256,                               \
   187           "Max number of regions in a fine-grain table per MB.")            \
   188                                                                             \
   189   product(intx, G1RSetRegionEntries, 0,                                     \
   190           "Max number of regions for which we keep bitmaps."                \
   191           "Will be set ergonomically by default")                           \
   192                                                                             \
   193   develop(intx, G1RSetSparseRegionEntriesBase, 4,                           \
   194           "Max number of entries per region in a sparse table "             \
   195           "per MB.")                                                        \
   196                                                                             \
   197   product(intx, G1RSetSparseRegionEntries, 0,                               \
   198           "Max number of entries per region in a sparse table."             \
   199           "Will be set ergonomically by default.")                          \
   200                                                                             \
   201   develop(bool, G1RecordHRRSOops, false,                                    \
   202           "When true, record recent calls to rem set operations.")          \
   203                                                                             \
   204   develop(bool, G1RecordHRRSEvents, false,                                  \
   205           "When true, record recent calls to rem set operations.")          \
   206                                                                             \
   207   develop(intx, G1MaxVerifyFailures, -1,                                    \
   208           "The maximum number of verification failrues to print.  "         \
   209           "-1 means print all.")                                            \
   210                                                                             \
   211   develop(bool, G1ScrubRemSets, true,                                       \
   212           "When true, do RS scrubbing after cleanup.")                      \
   213                                                                             \
   214   develop(bool, G1RSScrubVerbose, false,                                    \
   215           "When true, do RS scrubbing with verbose output.")                \
   216                                                                             \
   217   develop(bool, G1YoungSurvRateVerbose, false,                              \
   218           "print out the survival rate of young regions according to age.") \
   219                                                                             \
   220   develop(intx, G1YoungSurvRateNumRegionsSummary, 0,                        \
   221           "the number of regions for which we'll print a surv rate "        \
   222           "summary.")                                                       \
   223                                                                             \
   224   product(uintx, G1ReservePercent, 10,                                      \
   225           "It determines the minimum reserve we should have in the heap "   \
   226           "to minimize the probability of promotion failure.")              \
   227                                                                             \
   228   diagnostic(bool, G1PrintHeapRegions, false,                               \
   229           "If set G1 will print information on which regions are being "    \
   230           "allocated and which are reclaimed.")                             \
   231                                                                             \
   232   develop(bool, G1HRRSUseSparseTable, true,                                 \
   233           "When true, use sparse table to save space.")                     \
   234                                                                             \
   235   develop(bool, G1HRRSFlushLogBuffersOnVerify, false,                       \
   236           "Forces flushing of log buffers before verification.")            \
   237                                                                             \
   238   develop(bool, G1FailOnFPError, false,                                     \
   239           "When set, G1 will fail when it encounters an FP 'error', "       \
   240           "so as to allow debugging")                                       \
   241                                                                             \
   242   product(uintx, G1HeapRegionSize, 0,                                       \
   243           "Size of the G1 regions.")                                        \
   244                                                                             \
   245   experimental(bool, G1UseParallelRSetUpdating, true,                       \
   246           "Enables the parallelization of remembered set updating "         \
   247           "during evacuation pauses")                                       \
   248                                                                             \
   249   experimental(bool, G1UseParallelRSetScanning, true,                       \
   250           "Enables the parallelization of remembered set scanning "         \
   251           "during evacuation pauses")                                       \
   252                                                                             \
   253   product(uintx, G1ConcRefinementThreads, 0,                                \
   254           "If non-0 is the number of parallel rem set update threads, "     \
   255           "otherwise the value is determined ergonomically.")               \
   256                                                                             \
   257   develop(intx, G1CardCountCacheExpandThreshold, 16,                        \
   258           "Expand the card count cache if the number of collisions for "    \
   259           "a particular entry exceeds this value.")                         \
   260                                                                             \
   261   develop(bool, G1VerifyCTCleanup, false,                                   \
   262           "Verify card table cleanup.")                                     \
   263                                                                             \
   264   product(uintx, G1RSetScanBlockSize, 64,                                   \
   265           "Size of a work unit of cards claimed by a worker thread"         \
   266           "during RSet scanning.")                                          \
   267                                                                             \
   268   develop(uintx, G1SecondaryFreeListAppendLength, 5,                        \
   269           "The number of regions we will add to the secondary free list "   \
   270           "at every append operation")                                      \
   271                                                                             \
   272   develop(bool, G1ConcRegionFreeingVerbose, false,                          \
   273           "Enables verboseness during concurrent region freeing")           \
   274                                                                             \
   275   develop(bool, G1StressConcRegionFreeing, false,                           \
   276           "It stresses the concurrent region freeing operation")            \
   277                                                                             \
   278   develop(uintx, G1StressConcRegionFreeingDelayMillis, 0,                   \
   279           "Artificial delay during concurrent region freeing")              \
   280                                                                             \
   281   develop(uintx, G1DummyRegionsPerGC, 0,                                    \
   282           "The number of dummy regions G1 will allocate at the end of "     \
   283           "each evacuation pause in order to artificially fill up the "     \
   284           "heap and stress the marking implementation.")                    \
   285                                                                             \
   286   develop(bool, G1ExitOnExpansionFailure, false,                            \
   287           "Raise a fatal VM exit out of memory failure in the event "       \
   288           " that heap expansion fails due to running out of swap.")         \
   289                                                                             \
   290   develop(uintx, G1ConcMarkForceOverflow, 0,                                \
   291           "The number of times we'll force an overflow during "             \
   292           "concurrent marking")                                             \
   293                                                                             \
   294   develop(uintx, G1DefaultMinNewGenPercent, 20,                             \
   295           "Percentage (0-100) of the heap size to use as minimum "          \
   296           "young gen size.")                                                \
   297                                                                             \
   298   develop(uintx, G1DefaultMaxNewGenPercent, 80,                             \
   299           "Percentage (0-100) of the heap size to use as maximum "          \
   300           "young gen size.")                                                \
   301                                                                             \
   302   develop(uintx, G1OldCSetRegionLiveThresholdPercent, 90,                   \
   303           "Threshold for regions to be added to the collection set. "       \
   304           "Regions with more live bytes that this will not be collected.")  \
   305                                                                             \
   306   product(uintx, G1HeapWastePercent, 5,                                     \
   307           "Amount of space, expressed as a percentage of the heap size, "   \
   308           "that G1 is willing not to collect to avoid expensive GCs.")      \
   309                                                                             \
   310   product(uintx, G1MixedGCCountTarget, 4,                                   \
   311           "The target number of mixed GCs after a marking cycle.")          \
   312                                                                             \
   313   develop(uintx, G1OldCSetRegionThresholdPercent, 10,                       \
   314           "An upper bound for the number of old CSet regions expressed "    \
   315           "as a percentage of the heap size.")
   317 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)
   319 #endif // SHARE_VM_GC_IMPLEMENTATION_G1_G1_GLOBALS_HPP

mercurial