9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_VM_GC_G1_G1_GLOBALS_HPP
26 #define SHARE_VM_GC_G1_G1_GLOBALS_HPP
27
28 #include "runtime/globals.hpp"
29 //
30 // Defines all globals flags used by the garbage-first compiler.
31 //
32
33 #define G1_FLAGS(develop, develop_pd, product, product_pd, diagnostic, experimental, notproduct, manageable, product_rw, range, constraint) \
34 \
35 product(uintx, G1ConfidencePercent, 50, \
36 "Confidence level for MMU/pause predictions") \
37 range(0, 100) \
38 \
39 develop(intx, G1MarkingOverheadPercent, 0, \
40 "Overhead of concurrent marking") \
41 range(0, 100) \
42 \
43 develop(intx, G1MarkingVerboseLevel, 0, \
44 "Level (0-4) of verboseness of the marking code") \
45 range(0, 4) \
46 \
47 develop(bool, G1TraceMarkStackOverflow, false, \
48 "If true, extra debugging code for CM restart for ovflw.") \
49 \
50 develop(bool, G1TraceHeapRegionRememberedSet, false, \
51 "Enables heap region remembered set debug logs") \
52 \
53 diagnostic(bool, G1SummarizeConcMark, false, \
54 "Summarize concurrent mark info") \
55 \
56 diagnostic(bool, G1SummarizeRSetStats, false, \
57 "Summarize remembered set processing info") \
58 \
59 diagnostic(intx, G1SummarizeRSetStatsPeriod, 0, \
60 "The period (in number of GCs) at which we will generate " \
61 "update buffer processing info " \
62 "(0 means do not periodically generate this info); " \
63 "it also requires -XX:+G1SummarizeRSetStats") \
64 \
65 diagnostic(bool, G1TraceConcRefinement, false, \
66 "Trace G1 concurrent refinement") \
67 \
68 experimental(bool, G1TraceStringSymbolTableScrubbing, false, \
69 "Trace information string and symbol table scrubbing.") \
70 \
71 product(double, G1ConcMarkStepDurationMillis, 10.0, \
72 "Target duration of individual concurrent marking steps " \
73 "in milliseconds.") \
74 range(1.0, (double)max_uintx) \
75 \
76 product(intx, G1RefProcDrainInterval, 10, \
77 "The number of discovered reference objects to process before " \
78 "draining concurrent marking work queues.") \
79 range(1, max_intx) \
80 \
81 experimental(bool, G1UseConcMarkReferenceProcessing, true, \
82 "If true, enable reference discovery during concurrent " \
83 "marking and reference processing at the end of remark.") \
84 \
85 product(size_t, G1SATBBufferSize, 1*K, \
86 "Number of entries in an SATB log buffer.") \
87 \
88 develop(intx, G1SATBProcessCompletedThreshold, 20, \
89 "Number of completed buffers that triggers log processing.") \
90 \
91 product(uintx, G1SATBBufferEnqueueingThresholdPercent, 60, \
92 "Before enqueueing them, each mutator thread tries to do some " \
93 "filtering on the SATB buffers it generates. If post-filtering " \
94 "the percentage of retained entries is over this threshold " \
95 "the buffer will be enqueued for processing. A value of 0 " \
96 "specifies that mutator threads should not do such filtering.") \
97 range(0, 100) \
98 \
99 experimental(intx, G1ExpandByPercentOfAvailable, 20, \
100 "When expanding, % of uncommitted space to claim.") \
101 range(0, 100) \
102 \
103 develop(bool, G1RSBarrierRegionFilter, true, \
104 "If true, generate region filtering code in RS barrier") \
105 \
106 diagnostic(bool, G1PrintRegionLivenessInfo, false, \
107 "Prints the liveness information for all regions in the heap " \
108 "at the end of a marking cycle.") \
109 \
110 product(size_t, G1UpdateBufferSize, 256, \
111 "Size of an update buffer") \
112 \
113 product(intx, G1ConcRefinementYellowZone, 0, \
114 "Number of enqueued update buffers that will " \
115 "trigger concurrent processing. Will be selected ergonomically " \
116 "by default.") \
117 \
118 product(intx, G1ConcRefinementRedZone, 0, \
119 "Maximum number of enqueued update buffers before mutator " \
120 "threads start processing new ones instead of enqueueing them. " \
121 "Will be selected ergonomically by default. Zero will disable " \
122 "concurrent processing.") \
123 \
124 product(intx, G1ConcRefinementGreenZone, 0, \
125 "The number of update buffers that are left in the queue by the " \
126 "concurrent processing threads. Will be selected ergonomically " \
127 "by default.") \
128 \
129 product(intx, G1ConcRefinementServiceIntervalMillis, 300, \
130 "The last concurrent refinement thread wakes up every " \
131 "specified number of milliseconds to do miscellaneous work.") \
132 \
133 product(intx, G1ConcRefinementThresholdStep, 0, \
134 "Each time the rset update queue increases by this amount " \
135 "activate the next refinement thread if available. " \
136 "Will be selected ergonomically by default.") \
137 \
138 product(intx, G1RSetUpdatingPauseTimePercent, 10, \
139 "A target percentage of time that is allowed to be spend on " \
140 "process RS update buffers during the collection pause.") \
141 \
142 product(bool, G1UseAdaptiveConcRefinement, true, \
143 "Select green, yellow and red zones adaptively to meet the " \
144 "the pause requirements.") \
145 \
146 product(size_t, G1ConcRSLogCacheSize, 10, \
147 "Log base 2 of the length of conc RS hot-card cache.") \
148 range(0, 27) \
149 \
150 product(uintx, G1ConcRSHotCardLimit, 4, \
151 "The threshold that defines (>=) a hot card.") \
152 range(0, max_jubyte) \
153 \
154 develop(intx, G1RSetRegionEntriesBase, 256, \
155 "Max number of regions in a fine-grain table per MB.") \
156 \
157 product(intx, G1RSetRegionEntries, 0, \
158 "Max number of regions for which we keep bitmaps." \
159 "Will be set ergonomically by default") \
160 \
161 develop(intx, G1RSetSparseRegionEntriesBase, 4, \
162 "Max number of entries per region in a sparse table " \
163 "per MB.") \
164 \
165 product(intx, G1RSetSparseRegionEntries, 0, \
166 "Max number of entries per region in a sparse table." \
167 "Will be set ergonomically by default.") \
168 \
169 develop(bool, G1RecordHRRSOops, false, \
170 "When true, record recent calls to rem set operations.") \
171 \
172 develop(bool, G1RecordHRRSEvents, false, \
173 "When true, record recent calls to rem set operations.") \
174 \
175 develop(intx, G1MaxVerifyFailures, -1, \
176 "The maximum number of verification failures to print. " \
177 "-1 means print all.") \
178 \
179 develop(bool, G1ScrubRemSets, true, \
180 "When true, do RS scrubbing after cleanup.") \
181 \
182 develop(bool, G1RSScrubVerbose, false, \
183 "When true, do RS scrubbing with verbose output.") \
184 \
185 develop(bool, G1YoungSurvRateVerbose, false, \
186 "print out the survival rate of young regions according to age.") \
187 \
188 develop(intx, G1YoungSurvRateNumRegionsSummary, 0, \
189 "the number of regions for which we'll print a surv rate " \
190 "summary.") \
191 \
192 product(uintx, G1ReservePercent, 10, \
193 "It determines the minimum reserve we should have in the heap " \
194 "to minimize the probability of promotion failure.") \
195 range(0, 100) \
196 \
197 diagnostic(bool, G1PrintHeapRegions, false, \
198 "If set G1 will print information on which regions are being " \
199 "allocated and which are reclaimed.") \
200 \
201 develop(bool, G1HRRSUseSparseTable, true, \
202 "When true, use sparse table to save space.") \
203 \
204 develop(bool, G1HRRSFlushLogBuffersOnVerify, false, \
205 "Forces flushing of log buffers before verification.") \
206 \
207 develop(bool, G1FailOnFPError, false, \
208 "When set, G1 will fail when it encounters an FP 'error', " \
209 "so as to allow debugging") \
210 \
211 product(size_t, G1HeapRegionSize, 0, \
212 "Size of the G1 regions.") \
213 \
214 product(uintx, G1ConcRefinementThreads, 0, \
215 "If non-0 is the number of parallel rem set update threads, " \
216 "otherwise the value is determined ergonomically.") \
217 \
218 develop(bool, G1VerifyCTCleanup, false, \
219 "Verify card table cleanup.") \
220 \
221 product(size_t, G1RSetScanBlockSize, 64, \
222 "Size of a work unit of cards claimed by a worker thread" \
223 "during RSet scanning.") \
224 \
225 develop(uintx, G1SecondaryFreeListAppendLength, 5, \
226 "The number of regions we will add to the secondary free list " \
227 "at every append operation") \
228 \
229 develop(bool, G1ConcRegionFreeingVerbose, false, \
230 "Enables verboseness during concurrent region freeing") \
231 \
232 develop(bool, G1StressConcRegionFreeing, false, \
233 "It stresses the concurrent region freeing operation") \
234 \
235 develop(uintx, G1StressConcRegionFreeingDelayMillis, 0, \
236 "Artificial delay during concurrent region freeing") \
237 \
238 develop(uintx, G1DummyRegionsPerGC, 0, \
239 "The number of dummy regions G1 will allocate at the end of " \
240 "each evacuation pause in order to artificially fill up the " \
241 "heap and stress the marking implementation.") \
242 \
243 develop(bool, G1ExitOnExpansionFailure, false, \
244 "Raise a fatal VM exit out of memory failure in the event " \
245 " that heap expansion fails due to running out of swap.") \
246 \
247 develop(uintx, G1ConcMarkForceOverflow, 0, \
248 "The number of times we'll force an overflow during " \
249 "concurrent marking") \
250 \
251 experimental(uintx, G1MaxNewSizePercent, 60, \
252 "Percentage (0-100) of the heap size to use as default " \
253 " maximum young gen size.") \
254 range(0, 100) \
255 constraint(G1MaxNewSizePercentConstraintFunc,AfterErgo) \
256 \
257 experimental(uintx, G1NewSizePercent, 5, \
258 "Percentage (0-100) of the heap size to use as default " \
259 "minimum young gen size.") \
260 constraint(G1NewSizePercentConstraintFunc,AfterErgo) \
261 \
262 experimental(uintx, G1MixedGCLiveThresholdPercent, 85, \
263 "Threshold for regions to be considered for inclusion in the " \
264 "collection set of mixed GCs. " \
265 "Regions with live bytes exceeding this will not be collected.") \
266 range(0, 100) \
267 \
268 product(uintx, G1HeapWastePercent, 5, \
269 "Amount of space, expressed as a percentage of the heap size, " \
270 "that G1 is willing not to collect to avoid expensive GCs.") \
271 range(0, 100) \
272 \
273 product(uintx, G1MixedGCCountTarget, 8, \
274 "The target number of mixed GCs after a marking cycle.") \
275 \
276 experimental(bool, G1EagerReclaimHumongousObjects, true, \
277 "Try to reclaim dead large objects at every young GC.") \
278 \
279 experimental(bool, G1EagerReclaimHumongousObjectsWithStaleRefs, true, \
|
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(uintx, G1ConfidencePercent, 50, \
37 "Confidence level for MMU/pause predictions") \
38 range(0, 100) \
39 \
40 develop(intx, G1MarkingOverheadPercent, 0, \
41 "Overhead of concurrent marking") \
42 range(0, 100) \
43 \
44 develop(intx, G1MarkingVerboseLevel, 0, \
45 "Level (0-4) of verboseness of the marking code") \
46 range(0, 4) \
47 \
48 develop(bool, G1TraceMarkStackOverflow, false, \
49 "If true, extra debugging code for CM restart for ovflw.") \
50 \
51 develop(bool, G1TraceHeapRegionRememberedSet, false, \
52 "Enables heap region remembered set debug logs") \
53 \
54 diagnostic(bool, G1SummarizeConcMark, false, \
55 "Summarize concurrent mark info") \
56 \
57 diagnostic(bool, G1SummarizeRSetStats, false, \
58 "Summarize remembered set processing info") \
59 \
60 diagnostic(intx, G1SummarizeRSetStatsPeriod, 0, \
61 "The period (in number of GCs) at which we will generate " \
62 "update buffer processing info " \
63 "(0 means do not periodically generate this info); " \
64 "it also requires -XX:+G1SummarizeRSetStats") \
65 range(0, max_intx) \
66 \
67 diagnostic(bool, G1TraceConcRefinement, false, \
68 "Trace G1 concurrent refinement") \
69 \
70 experimental(bool, G1TraceStringSymbolTableScrubbing, false, \
71 "Trace information string and symbol table scrubbing.") \
72 \
73 product(double, G1ConcMarkStepDurationMillis, 10.0, \
74 "Target duration of individual concurrent marking steps " \
75 "in milliseconds.") \
76 range(1.0, DBL_MAX) \
77 \
78 product(intx, G1RefProcDrainInterval, 10, \
79 "The number of discovered reference objects to process before " \
80 "draining concurrent marking work queues.") \
81 range(1, max_intx) \
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(size_t, G1SATBBufferSize, 1*K, \
88 "Number of entries in an SATB log buffer.") \
89 range(1, max_uintx) \
90 \
91 develop(intx, G1SATBProcessCompletedThreshold, 20, \
92 "Number of completed buffers that triggers log processing.") \
93 range(0, max_jint) \
94 \
95 product(uintx, G1SATBBufferEnqueueingThresholdPercent, 60, \
96 "Before enqueueing them, each mutator thread tries to do some " \
97 "filtering on the SATB buffers it generates. If post-filtering " \
98 "the percentage of retained entries is over this threshold " \
99 "the buffer will be enqueued for processing. A value of 0 " \
100 "specifies that mutator threads should not do such filtering.") \
101 range(0, 100) \
102 \
103 experimental(intx, G1ExpandByPercentOfAvailable, 20, \
104 "When expanding, % of uncommitted space to claim.") \
105 range(0, 100) \
106 \
107 develop(bool, G1RSBarrierRegionFilter, true, \
108 "If true, generate region filtering code in RS barrier") \
109 \
110 diagnostic(bool, G1PrintRegionLivenessInfo, false, \
111 "Prints the liveness information for all regions in the heap " \
112 "at the end of a marking cycle.") \
113 \
114 product(size_t, G1UpdateBufferSize, 256, \
115 "Size of an update buffer") \
116 range(1, 1*G) \
117 \
118 product(intx, G1ConcRefinementYellowZone, 0, \
119 "Number of enqueued update buffers that will " \
120 "trigger concurrent processing. Will be selected ergonomically " \
121 "by default.") \
122 range(0, max_intx) \
123 \
124 product(intx, G1ConcRefinementRedZone, 0, \
125 "Maximum number of enqueued update buffers before mutator " \
126 "threads start processing new ones instead of enqueueing them. " \
127 "Will be selected ergonomically by default. Zero will disable " \
128 "concurrent processing.") \
129 range(0, max_intx) \
130 \
131 product(intx, G1ConcRefinementGreenZone, 0, \
132 "The number of update buffers that are left in the queue by the " \
133 "concurrent processing threads. Will be selected ergonomically " \
134 "by default.") \
135 range(0, max_intx) \
136 \
137 product(intx, G1ConcRefinementServiceIntervalMillis, 300, \
138 "The last concurrent refinement thread wakes up every " \
139 "specified number of milliseconds to do miscellaneous work.") \
140 range(0, max_intx) \
141 \
142 product(intx, G1ConcRefinementThresholdStep, 0, \
143 "Each time the rset update queue increases by this amount " \
144 "activate the next refinement thread if available. " \
145 "Will be selected ergonomically by default.") \
146 \
147 product(intx, G1RSetUpdatingPauseTimePercent, 10, \
148 "A target percentage of time that is allowed to be spend on " \
149 "process RS update buffers during the collection pause.") \
150 range(0, 100) \
151 \
152 product(bool, G1UseAdaptiveConcRefinement, true, \
153 "Select green, yellow and red zones adaptively to meet the " \
154 "the pause requirements.") \
155 \
156 product(size_t, G1ConcRSLogCacheSize, 10, \
157 "Log base 2 of the length of conc RS hot-card cache.") \
158 range(0, 27) \
159 \
160 product(uintx, G1ConcRSHotCardLimit, 4, \
161 "The threshold that defines (>=) a hot card.") \
162 range(0, max_jubyte) \
163 \
164 develop(intx, G1RSetRegionEntriesBase, 256, \
165 "Max number of regions in a fine-grain table per MB.") \
166 range(1, max_jint) \
167 \
168 product(intx, G1RSetRegionEntries, 0, \
169 "Max number of regions for which we keep bitmaps." \
170 "Will be set ergonomically by default") \
171 range(0, max_jint) \
172 constraint(G1RSetRegionEntriesConstraintFunc,AfterErgo) \
173 \
174 develop(intx, G1RSetSparseRegionEntriesBase, 4, \
175 "Max number of entries per region in a sparse table " \
176 "per MB.") \
177 range(1, max_jint) \
178 \
179 product(intx, G1RSetSparseRegionEntries, 0, \
180 "Max number of entries per region in a sparse table." \
181 "Will be set ergonomically by default.") \
182 range(0, max_jint) \
183 constraint(G1RSetSparseRegionEntriesConstraintFunc,AfterErgo) \
184 \
185 develop(bool, G1RecordHRRSOops, false, \
186 "When true, record recent calls to rem set operations.") \
187 \
188 develop(bool, G1RecordHRRSEvents, false, \
189 "When true, record recent calls to rem set operations.") \
190 \
191 develop(intx, G1MaxVerifyFailures, -1, \
192 "The maximum number of verification failures to print. " \
193 "-1 means print all.") \
194 range(-1, max_jint) \
195 \
196 develop(bool, G1ScrubRemSets, true, \
197 "When true, do RS scrubbing after cleanup.") \
198 \
199 develop(bool, G1RSScrubVerbose, false, \
200 "When true, do RS scrubbing with verbose output.") \
201 \
202 develop(bool, G1YoungSurvRateVerbose, false, \
203 "print out the survival rate of young regions according to age.") \
204 \
205 develop(intx, G1YoungSurvRateNumRegionsSummary, 0, \
206 "the number of regions for which we'll print a surv rate " \
207 "summary.") \
208 range(0, max_intx) \
209 constraint(G1YoungSurvRateNumRegionsSummaryConstraintFunc,AfterErgo)\
210 \
211 product(uintx, G1ReservePercent, 10, \
212 "It determines the minimum reserve we should have in the heap " \
213 "to minimize the probability of promotion failure.") \
214 range(0, 50) \
215 \
216 diagnostic(bool, G1PrintHeapRegions, false, \
217 "If set G1 will print information on which regions are being " \
218 "allocated and which are reclaimed.") \
219 \
220 develop(bool, G1HRRSUseSparseTable, true, \
221 "When true, use sparse table to save space.") \
222 \
223 develop(bool, G1HRRSFlushLogBuffersOnVerify, false, \
224 "Forces flushing of log buffers before verification.") \
225 \
226 develop(bool, G1FailOnFPError, false, \
227 "When set, G1 will fail when it encounters an FP 'error', " \
228 "so as to allow debugging") \
229 \
230 product(size_t, G1HeapRegionSize, 0, \
231 "Size of the G1 regions.") \
232 range(0, 32*M) \
233 constraint(G1HeapRegionSizeConstraintFunc,AfterMemoryInit) \
234 \
235 product(uintx, G1ConcRefinementThreads, 0, \
236 "If non-0 is the number of parallel rem set update threads, " \
237 "otherwise the value is determined ergonomically.") \
238 range(0, max_jint-1) \
239 \
240 develop(bool, G1VerifyCTCleanup, false, \
241 "Verify card table cleanup.") \
242 \
243 product(size_t, G1RSetScanBlockSize, 64, \
244 "Size of a work unit of cards claimed by a worker thread" \
245 "during RSet scanning.") \
246 range(1, max_uintx) \
247 \
248 develop(uintx, G1SecondaryFreeListAppendLength, 5, \
249 "The number of regions we will add to the secondary free list " \
250 "at every append operation") \
251 \
252 develop(bool, G1ConcRegionFreeingVerbose, false, \
253 "Enables verboseness during concurrent region freeing") \
254 \
255 develop(bool, G1StressConcRegionFreeing, false, \
256 "It stresses the concurrent region freeing operation") \
257 \
258 develop(uintx, G1StressConcRegionFreeingDelayMillis, 0, \
259 "Artificial delay during concurrent region freeing") \
260 \
261 develop(uintx, G1DummyRegionsPerGC, 0, \
262 "The number of dummy regions G1 will allocate at the end of " \
263 "each evacuation pause in order to artificially fill up the " \
264 "heap and stress the marking implementation.") \
265 range(0, 1000) \
266 \
267 develop(bool, G1ExitOnExpansionFailure, false, \
268 "Raise a fatal VM exit out of memory failure in the event " \
269 " that heap expansion fails due to running out of swap.") \
270 \
271 develop(uintx, G1ConcMarkForceOverflow, 0, \
272 "The number of times we'll force an overflow during " \
273 "concurrent marking") \
274 \
275 experimental(uintx, G1MaxNewSizePercent, 60, \
276 "Percentage (0-100) of the heap size to use as default " \
277 " maximum young gen size.") \
278 range(0, 100) \
279 constraint(G1MaxNewSizePercentConstraintFunc,AfterErgo) \
280 \
281 experimental(uintx, G1NewSizePercent, 5, \
282 "Percentage (0-100) of the heap size to use as default " \
283 "minimum young gen size.") \
284 range(0, 100) \
285 constraint(G1NewSizePercentConstraintFunc,AfterErgo) \
286 \
287 experimental(uintx, G1MixedGCLiveThresholdPercent, 85, \
288 "Threshold for regions to be considered for inclusion in the " \
289 "collection set of mixed GCs. " \
290 "Regions with live bytes exceeding this will not be collected.") \
291 range(0, 100) \
292 \
293 product(uintx, G1HeapWastePercent, 5, \
294 "Amount of space, expressed as a percentage of the heap size, " \
295 "that G1 is willing not to collect to avoid expensive GCs.") \
296 range(0, 100) \
297 \
298 product(uintx, G1MixedGCCountTarget, 8, \
299 "The target number of mixed GCs after a marking cycle.") \
300 \
301 experimental(bool, G1EagerReclaimHumongousObjects, true, \
302 "Try to reclaim dead large objects at every young GC.") \
303 \
304 experimental(bool, G1EagerReclaimHumongousObjectsWithStaleRefs, true, \
|