Fri, 23 Mar 2012 10:53:19 -0400
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