Thu, 30 Apr 2009 15:07:53 -0700
6490395: G1: Tidy up command line flags.
Summary: Change G1 flag names to be more consistent and disable some in 'product' mode.
Reviewed-by: tonyp, iveresov
1 /*
2 * Copyright 2001-2009 Sun Microsystems, Inc. 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
20 * CA 95054 USA or visit www.sun.com if you need additional information or
21 * have any questions.
22 *
23 */
25 //
26 // Defines all globals flags used by the garbage-first compiler.
27 //
29 #define G1_FLAGS(develop, develop_pd, product, product_pd, diagnostic, experimental, notproduct, manageable, product_rw) \
30 \
31 product(intx, G1ParallelGCAllocBufferSize, 8*K, \
32 "Size of parallel G1 allocation buffers in to-space.") \
33 \
34 product(intx, G1ConfidencePercent, 50, \
35 "Confidence level for MMU/pause predictions") \
36 \
37 develop(intx, G1MarkingOverheadPercent, 0, \
38 "Overhead of concurrent marking") \
39 \
40 develop(bool, G1AccountConcurrentOverhead, false, \
41 "Whether soft real-time compliance in G1 will take into account" \
42 "concurrent overhead") \
43 \
44 product(intx, G1YoungGenSize, 0, \
45 "Size of the G1 young generation, 0 is the adaptive policy") \
46 \
47 develop(bool, G1Gen, true, \
48 "If true, it will enable the generational G1") \
49 \
50 develop(intx, G1GCPercent, 10, \
51 "The desired percent time spent on GC") \
52 \
53 develop(intx, G1PolicyVerbose, 0, \
54 "The verbosity level on G1 policy decisions") \
55 \
56 develop(bool, G1UseHRIntoRS, true, \
57 "Determines whether the 'advanced' HR Into rem set is used.") \
58 \
59 develop(intx, G1MarkingVerboseLevel, 0, \
60 "Level (0-4) of verboseness of the marking code") \
61 \
62 develop(bool, G1VerifyConcMarkPrintReachable, false, \
63 "If conc mark verification fails, print reachable objects") \
64 \
65 develop(bool, G1TraceMarkStackOverflow, false, \
66 "If true, extra debugging code for CM restart for ovflw.") \
67 \
68 develop(intx, G1PausesBtwnConcMark, -1, \
69 "If positive, fixed number of pauses between conc markings") \
70 \
71 diagnostic(bool, G1SummarizeConcurrentMark, false, \
72 "Summarize concurrent mark info") \
73 \
74 diagnostic(bool, G1SummarizeRSetStats, false, \
75 "Summarize remembered set processing info") \
76 \
77 diagnostic(bool, G1SummarizeZFStats, false, \
78 "Summarize zero-filling info") \
79 \
80 develop(bool, G1TraceConcurrentRefinement, false, \
81 "Trace G1 concurrent refinement") \
82 \
83 develop(bool, G1ConcMark, true, \
84 "If true, run concurrent marking for G1") \
85 \
86 product(intx, G1MarkStackSize, 2 * 1024 * 1024, \
87 "Size of the mark stack for concurrent marking.") \
88 \
89 product(intx, G1MarkRegionStackSize, 1024 * 1024, \
90 "Size of the region stack for concurrent marking.") \
91 \
92 develop(bool, G1ConcRefine, true, \
93 "If true, run concurrent rem set refinement for G1") \
94 \
95 develop(intx, G1ConcRefineTargTraversals, 4, \
96 "Number of concurrent refinement we try to achieve") \
97 \
98 develop(intx, G1ConcRefineInitialDelta, 4, \
99 "Number of heap regions of alloc ahead of starting collection " \
100 "pause to start concurrent refinement (initially)") \
101 \
102 develop(bool, G1SmoothConcRefine, true, \
103 "Attempts to smooth out the overhead of concurrent refinement") \
104 \
105 develop(bool, G1ConcZeroFill, true, \
106 "If true, run concurrent zero-filling thread") \
107 \
108 develop(intx, G1ConcZFMaxRegions, 1, \
109 "Stop zero-filling when # of zf'd regions reaches") \
110 \
111 product(intx, G1SteadyStateUsed, 90, \
112 "If non-0, try to maintain 'used' at this pct (of max)") \
113 \
114 product(intx, G1SteadyStateUsedDelta, 30, \
115 "If G1SteadyStateUsed is non-0, then do pause this number of " \
116 "of percentage points earlier if no marking is in progress.") \
117 \
118 develop(bool, G1SATBBarrierPrintNullPreVals, false, \
119 "If true, count frac of ptr writes with null pre-vals.") \
120 \
121 product(intx, G1SATBLogBufferSize, 1*K, \
122 "Number of entries in an SATB log buffer.") \
123 \
124 product(intx, G1SATBProcessCompletedThreshold, 20, \
125 "Number of completed buffers that triggers log processing.") \
126 \
127 develop(intx, G1ExtraRegionSurvRate, 33, \
128 "If the young survival rate is S, and there's room left in " \
129 "to-space, we will allow regions whose survival rate is up to " \
130 "S + (1 - S)*X, where X is this parameter (as a fraction.)") \
131 \
132 develop(intx, G1InitYoungSurvRatio, 50, \
133 "Expected Survival Rate for newly allocated bytes") \
134 \
135 develop(bool, G1SATBPrintStubs, false, \
136 "If true, print generated stubs for the SATB barrier") \
137 \
138 product(intx, G1ExpandByPercentOfAvailable, 20, \
139 "When expanding, % of uncommitted space to claim.") \
140 \
141 develop(bool, G1RSBarrierRegionFilter, true, \
142 "If true, generate region filtering code in RS barrier") \
143 \
144 develop(bool, G1RSBarrierNullFilter, true, \
145 "If true, generate null-pointer filtering code in RS barrier") \
146 \
147 develop(bool, G1PrintCTFilterStats, false, \
148 "If true, print stats on RS filtering effectiveness") \
149 \
150 develop(bool, G1RSBarrierUseQueue, true, \
151 "If true, use queueing RS barrier") \
152 \
153 develop(bool, G1DeferredRSUpdate, true, \
154 "If true, use deferred RS updates") \
155 \
156 develop(bool, G1RSLogCheckCardTable, false, \
157 "If true, verify that no dirty cards remain after RS log " \
158 "processing.") \
159 \
160 develop(bool, G1RSCountHisto, false, \
161 "If true, print a histogram of RS occupancies after each pause") \
162 \
163 develop(intx, G1PrintRegionLivenessInfo, 0, \
164 "When > 0, print the occupancies of the <n> best and worst" \
165 "regions.") \
166 \
167 develop(bool, G1PrintParCleanupStats, false, \
168 "When true, print extra stats about parallel cleanup.") \
169 \
170 develop(bool, G1DisablePreBarrier, false, \
171 "Disable generation of pre-barrier (i.e., marking barrier) ") \
172 \
173 develop(bool, G1DisablePostBarrier, false, \
174 "Disable generation of post-barrier (i.e., RS barrier) ") \
175 \
176 product(intx, G1DirtyCardQueueMax, 30, \
177 "Maximum number of completed RS buffers before mutator threads " \
178 "start processing them.") \
179 \
180 develop(intx, G1ConcRSLogCacheSize, 10, \
181 "Log base 2 of the length of conc RS hot-card cache.") \
182 \
183 develop(bool, G1ConcRSCountTraversals, false, \
184 "If true, gather data about the number of times CR traverses " \
185 "cards ") \
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, G1LogRSRegionEntries, 7, \
194 "Log_2 of max number of regions for which we keep bitmaps.") \
195 \
196 develop(bool, G1RecordHRRSOops, false, \
197 "When true, record recent calls to rem set operations.") \
198 \
199 develop(bool, G1RecordHRRSEvents, false, \
200 "When true, record recent calls to rem set operations.") \
201 \
202 develop(intx, G1MaxVerifyFailures, -1, \
203 "The maximum number of verification failrues to print. " \
204 "-1 means print all.") \
205 \
206 develop(bool, G1ScrubRemSets, true, \
207 "When true, do RS scrubbing after cleanup.") \
208 \
209 develop(bool, G1RSScrubVerbose, false, \
210 "When true, do RS scrubbing with verbose output.") \
211 \
212 develop(bool, G1YoungSurvRateVerbose, false, \
213 "print out the survival rate of young regions according to age.") \
214 \
215 develop(intx, G1YoungSurvRateNumRegionsSummary, 0, \
216 "the number of regions for which we'll print a surv rate " \
217 "summary.") \
218 \
219 product(bool, G1UseScanOnlyPrefix, false, \
220 "It determines whether the system will calculate an optimum " \
221 "scan-only set.") \
222 \
223 product(intx, G1MinReservePercent, 10, \
224 "It determines the minimum reserve we should have in the heap " \
225 "to minimize the probability of promotion failure.") \
226 \
227 diagnostic(bool, G1PrintRegions, false, \
228 "If set G1 will print information on which regions are being " \
229 "allocated and which are reclaimed.") \
230 \
231 develop(bool, G1HRRSUseSparseTable, true, \
232 "When true, use sparse table to save space.") \
233 \
234 develop(bool, G1HRRSFlushLogBuffersOnVerify, false, \
235 "Forces flushing of log buffers before verification.") \
236 \
237 product(bool, G1UseSurvivorSpaces, true, \
238 "When true, use survivor space.") \
239 \
240 develop(bool, G1FixedTenuringThreshold, false, \
241 "When set, G1 will not adjust the tenuring threshold") \
242 \
243 develop(bool, G1FixedEdenSize, false, \
244 "When set, G1 will not allocate unused survivor space regions") \
245 \
246 develop(uintx, G1FixedSurvivorSpaceSize, 0, \
247 "If non-0 is the size of the G1 survivor space, " \
248 "otherwise SurvivorRatio is used to determine the size") \
249 \
250 experimental(bool, G1ParallelRSetUpdatingEnabled, false, \
251 "Enables the parallelization of remembered set updating " \
252 "during evacuation pauses") \
253 \
254 experimental(bool, G1ParallelRSetScanningEnabled, false, \
255 "Enables the parallelization of remembered set scanning " \
256 "during evacuation pauses")
258 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)