1 /*
2 * Copyright (c) 1997, 2026, 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_RUNTIME_GLOBALS_HPP
26 #define SHARE_RUNTIME_GLOBALS_HPP
27
28 #include "compiler/compiler_globals_pd.hpp"
29 #include "runtime/globals_shared.hpp"
30 #include "utilities/align.hpp"
31 #include "utilities/globalDefinitions.hpp"
32 #include "utilities/macros.hpp"
33 #include CPU_HEADER(globals)
34 #include OS_HEADER(globals)
35 #include OS_CPU_HEADER(globals)
36
37 // develop flags are settable / visible only during development and are constant in the PRODUCT version
38 // product flags are always settable / visible
39 // develop_pd/product_pd flags are the same as develop/product, except that their default values
40 // are specified in platform-dependent header files.
41
42 // Flags must be declared with the following number of parameters:
43 // non-pd flags:
44 // (type, name, default_value, doc), or
45 // (type, name, default_value, extra_attrs, doc)
46 // pd flags:
47 // (type, name, doc), or
48 // (type, name, extra_attrs, doc)
49
50 // A flag must be declared with one of the following types:
51 // bool, int, uint, intx, uintx, size_t, ccstr, ccstrlist, double, or uint64_t.
52 // The type "ccstr" and "ccstrlist" are an alias for "const char*" and is used
53 // only in this file, because the macrology requires single-token type names.
54
55 // The optional extra_attrs parameter may have one of the following values:
56 // DIAGNOSTIC, EXPERIMENTAL, or MANAGEABLE. Currently extra_attrs can be used
57 // only with product/product_pd flags.
58 //
59 // DIAGNOSTIC options are not meant for VM tuning or for product modes.
60 // They are to be used for VM quality assurance or field diagnosis
61 // of VM bugs. They are hidden so that users will not be encouraged to
62 // try them as if they were VM ordinary execution options. However, they
63 // are available in the product version of the VM. Under instruction
64 // from support engineers, VM customers can turn them on to collect
65 // diagnostic information about VM problems. To use a VM diagnostic
66 // option, you must first specify +UnlockDiagnosticVMOptions.
67 // (This master switch also affects the behavior of -Xprintflags.)
68 //
69 // EXPERIMENTAL flags are in support of features that may not be
70 // an officially supported part of a product, but may be available
71 // for experimenting with. They could, for example, be performance
72 // features that may not have undergone full or rigorous QA, but which may
73 // help performance in some cases and released for experimentation
74 // by the community of users and developers. This flag also allows one to
75 // be able to build a fully supported product that nonetheless also
76 // ships with some unsupported, lightly tested, experimental features.
77 // Refer to the documentation of any products using this code for details
78 // on support and fitness for production.
79 // Like the UnlockDiagnosticVMOptions flag above, there is a corresponding
80 // UnlockExperimentalVMOptions flag, which allows the control and
81 // modification of the experimental flags.
82 //
83 // Nota bene: neither diagnostic nor experimental options should be used casually,
84 // Refer to the documentation of any products using this code for details.
85 //
86 // MANAGEABLE flags are writeable external product flags.
87 // They are dynamically writeable through the JDK management interface
88 // (com.sun.management.HotSpotDiagnosticMXBean API) and also through JConsole.
89 // These flags are external exported interface (see CSR). The list of
90 // manageable flags can be queried programmatically through the management
91 // interface.
92 //
93 // A flag can be made as "manageable" only if
94 // - the flag is defined in a CSR request as an external exported interface.
95 // - the VM implementation supports dynamic setting of the flag.
96 // This implies that the VM must *always* query the flag variable
97 // and not reuse state related to the flag state at any given time.
98 // - you want the flag to be queried programmatically by the customers.
99 //
100
101 //
102 // range is a macro that will expand to min and max arguments for range
103 // checking code if provided - see jvmFlagLimit.hpp
104 //
105 // constraint is a macro that will expand to custom function call
106 // for constraint checking if provided - see jvmFlagLimit.hpp
107
108 // Default and minimum StringTable and SymbolTable size values
109 // Must be powers of 2
110 const size_t defaultStringTableSize = NOT_LP64(1024) LP64_ONLY(65536);
111 const size_t minimumStringTableSize = 128;
112 const size_t defaultSymbolTableSize = 32768; // 2^15
113 const size_t minimumSymbolTableSize = 1024;
114
115 #ifdef _LP64
116 #define LP64_RUNTIME_FLAGS(develop, \
117 develop_pd, \
118 product, \
119 product_pd, \
120 range, \
121 constraint) \
122 \
123 product(bool, UseCompressedOops, false, \
124 "Use 32-bit object references in 64-bit VM. " \
125 "lp64_product means flag is always constant in 32 bit VM") \
126 \
127 product(bool, AOTCompatibleOopCompression, false, DIAGNOSTIC, \
128 "Always use HeapBasedNarrowOop mode, so that AOT code will " \
129 "always work regardless of runtime heap range") \
130 \
131 product(bool, UseCompactObjectHeaders, true, \
132 "Use compact 64-bit object headers in 64-bit VM") \
133 \
134 product(int, ObjectAlignmentInBytes, 8, \
135 "Default object alignment in bytes, 8 is minimum") \
136 range(8, 256) \
137 constraint(ObjectAlignmentInBytesConstraintFunc, AtParse)
138
139 #else
140 // !_LP64
141
142 #define LP64_RUNTIME_FLAGS(develop, \
143 develop_pd, \
144 product, \
145 product_pd, \
146 range, \
147 constraint)
148 const bool UseCompressedOops = false;
149 const bool AOTCompatibleOopCompression = false;
150 const bool UseCompactObjectHeaders = false;
151 const int ObjectAlignmentInBytes = 8;
152
153 #endif // _LP64
154
155 // Default value for PrintAssemblyOptions, set via --with-print-assembly-options.
156 #ifndef DEFAULT_PRINT_ASSEMBLY_OPTIONS
157 #define DEFAULT_PRINT_ASSEMBLY_OPTIONS nullptr
158 #endif
159
160 #define RUNTIME_FLAGS(develop, \
161 develop_pd, \
162 product, \
163 product_pd, \
164 range, \
165 constraint) \
166 \
167 develop(bool, CheckCompressedOops, true, \
168 "Generate checks in encoding/decoding code in debug VM") \
169 \
170 product(uintx, HeapSearchSteps, 3 PPC64_ONLY(+17), \
171 "Heap allocation steps through preferred address regions to find" \
172 " where it can allocate the heap. Number of steps to take per " \
173 "region.") \
174 range(1, max_uintx) \
175 \
176 product(uint, HandshakeTimeout, 0, DIAGNOSTIC, \
177 "If nonzero set a timeout in milliseconds for handshakes") \
178 \
179 product(bool, AlwaysSafeConstructors, false, EXPERIMENTAL, \
180 "Force safe construction, as if all fields are final.") \
181 \
182 product(bool, UnlockDiagnosticVMOptions, trueInDebug, DIAGNOSTIC, \
183 "Enable normal processing of flags relating to field diagnostics")\
184 \
185 product(bool, UnlockExperimentalVMOptions, false, EXPERIMENTAL, \
186 "Enable normal processing of flags relating to experimental " \
187 "features") \
188 \
189 product(bool, JavaMonitorsInStackTrace, true, \
190 "Print information about Java monitor locks when the stacks are " \
191 "dumped") \
192 \
193 product_pd(bool, UseLargePages, \
194 "Use large page memory") \
195 \
196 product_pd(bool, UseLargePagesIndividualAllocation, \
197 "Allocate large pages individually for better affinity") \
198 \
199 develop(bool, LargePagesIndividualAllocationInjectError, false, \
200 "Fail large pages individual allocation") \
201 \
202 product(bool, UseNUMA, false, \
203 "Use NUMA if available") \
204 \
205 product(bool, UseNUMAInterleaving, false, \
206 "Interleave memory across NUMA nodes if available") \
207 \
208 product(size_t, NUMAInterleaveGranularity, 2*M, \
209 "Granularity to use for NUMA interleaving on Windows OS") \
210 constraint(NUMAInterleaveGranularityConstraintFunc, AtParse) \
211 \
212 product(bool, NUMAStats, false, \
213 "Print NUMA stats in detailed heap information") \
214 \
215 product(bool, UseAES, false, \
216 "Control whether AES instructions are used when available") \
217 \
218 product(bool, UseFMA, false, \
219 "Control whether FMA instructions are used when available") \
220 \
221 product(bool, UseSHA, false, \
222 "Control whether SHA instructions are used when available") \
223 \
224 product(bool, UseGHASHIntrinsics, false, DIAGNOSTIC, \
225 "Use intrinsics for GHASH versions of crypto") \
226 \
227 product(bool, UseBASE64Intrinsics, false, \
228 "Use intrinsics for java.util.Base64") \
229 \
230 product(bool, UsePoly1305Intrinsics, false, DIAGNOSTIC, \
231 "Use intrinsics for sun.security.util.math.intpoly") \
232 product(bool, UseIntPolyIntrinsics, false, DIAGNOSTIC, \
233 "Use intrinsics for sun.security.util.math.intpoly.MontgomeryIntegerPolynomialP256") \
234 \
235 product(size_t, LargePageSizeInBytes, 0, \
236 "Maximum large page size used (0 will use the default large " \
237 "page size for the environment as the maximum) " \
238 "(must be a power of 2)") \
239 range(0, max_uintx) \
240 constraint(LargePageSizeInBytesConstraintFunc, AtParse) \
241 \
242 product(size_t, LargePageHeapSizeThreshold, 128*M, \
243 "Use large pages if maximum heap is at least this big") \
244 range(0, max_uintx) \
245 \
246 product(bool, ForceTimeHighResolution, false, \
247 "Using high time resolution (for Win32 only)") \
248 \
249 develop(bool, TracePcPatching, false, \
250 "Trace usage of frame::patch_pc") \
251 \
252 develop(bool, TraceRelocator, false, \
253 "Trace the bytecode relocator") \
254 \
255 \
256 product(bool, SafepointALot, false, DIAGNOSTIC, \
257 "Generate a lot of safepoints. This works with " \
258 "GuaranteedSafepointInterval") \
259 \
260 product(bool, HandshakeALot, false, DIAGNOSTIC, \
261 "Generate a lot of handshakes. This works with " \
262 "GuaranteedSafepointInterval") \
263 \
264 product_pd(bool, BackgroundCompilation, \
265 "A thread requesting compilation is not blocked during " \
266 "compilation") \
267 \
268 product(bool, MethodFlushing, true, \
269 "Reclamation of compiled methods") \
270 \
271 develop(bool, VerifyStack, false, \
272 "Verify stack of each thread when it is entering a runtime call") \
273 \
274 product(bool, ForceUnreachable, false, DIAGNOSTIC, \
275 "Make all non code cache addresses to be unreachable by " \
276 "forcing use of 64bit literal fixups") \
277 \
278 develop(bool, TraceDerivedPointers, false, \
279 "Trace traversal of derived pointers on stack") \
280 \
281 develop(bool, TraceCodeBlobStacks, false, \
282 "Trace stack-walk of codeblobs") \
283 \
284 develop(bool, PrintRewrites, false, \
285 "Print methods that are being rewritten") \
286 \
287 product(bool, UseInlineCaches, true, \
288 "Use Inline Caches for virtual calls ") \
289 \
290 develop(bool, VerifyInlineCaches, true, \
291 "Verify Inline Caches") \
292 \
293 product(bool, InlineArrayCopy, true, DIAGNOSTIC, \
294 "Inline arraycopy native that is known to be part of " \
295 "base library DLL") \
296 \
297 product(bool, InlineObjectHash, true, DIAGNOSTIC, \
298 "Inline Object::hashCode() native that is known to be part " \
299 "of base library DLL") \
300 \
301 product(bool, InlineNatives, true, DIAGNOSTIC, \
302 "Inline natives that are known to be part of base library DLL") \
303 \
304 product(bool, InlineMathNatives, true, DIAGNOSTIC, \
305 "Inline SinD, CosD, etc.") \
306 \
307 product(bool, InlineClassNatives, true, DIAGNOSTIC, \
308 "Inline Class.isInstance, etc") \
309 \
310 product(bool, InlineThreadNatives, true, DIAGNOSTIC, \
311 "Inline Thread.currentThread, etc") \
312 \
313 product(bool, InlineUnsafeOps, true, DIAGNOSTIC, \
314 "Inline memory ops (native methods) from Unsafe") \
315 \
316 product(bool, UseAESIntrinsics, false, DIAGNOSTIC, \
317 "Use intrinsics for AES versions of crypto") \
318 \
319 product(bool, UseAESCTRIntrinsics, false, DIAGNOSTIC, \
320 "Use intrinsics for the paralleled version of AES/CTR crypto") \
321 \
322 product(bool, UseChaCha20Intrinsics, false, DIAGNOSTIC, \
323 "Use intrinsics for the vectorized version of ChaCha20") \
324 \
325 product(bool, UseKyberIntrinsics, false, DIAGNOSTIC, \
326 "Use intrinsics for the vectorized version of Kyber") \
327 \
328 product(bool, UseDilithiumIntrinsics, false, DIAGNOSTIC, \
329 "Use intrinsics for the vectorized version of Dilithium") \
330 \
331 product(bool, UseMD5Intrinsics, false, DIAGNOSTIC, \
332 "Use intrinsics for MD5 crypto hash function") \
333 \
334 product(bool, UseSHA1Intrinsics, false, DIAGNOSTIC, \
335 "Use intrinsics for SHA-1 crypto hash function. " \
336 "Requires that UseSHA is enabled.") \
337 \
338 product(bool, UseSHA256Intrinsics, false, DIAGNOSTIC, \
339 "Use intrinsics for SHA-224 and SHA-256 crypto hash functions. " \
340 "Requires that UseSHA is enabled.") \
341 \
342 product(bool, UseSHA512Intrinsics, false, DIAGNOSTIC, \
343 "Use intrinsics for SHA-384 and SHA-512 crypto hash functions. " \
344 "Requires that UseSHA is enabled.") \
345 \
346 product(bool, UseSHA3Intrinsics, false, DIAGNOSTIC, \
347 "Use intrinsics for SHA3 crypto hash function. " \
348 "Requires that UseSHA is enabled.") \
349 \
350 product(bool, UseCRC32Intrinsics, false, DIAGNOSTIC, \
351 "use intrinsics for java.util.zip.CRC32") \
352 \
353 product(bool, UseCRC32CIntrinsics, false, DIAGNOSTIC, \
354 "use intrinsics for java.util.zip.CRC32C") \
355 \
356 product(bool, UseAdler32Intrinsics, false, DIAGNOSTIC, \
357 "use intrinsics for java.util.zip.Adler32") \
358 \
359 product(bool, UseVectorizedMismatchIntrinsic, false, DIAGNOSTIC, \
360 "Enables intrinsification of ArraysSupport.vectorizedMismatch()") \
361 \
362 product(bool, UseVectorizedHashCodeIntrinsic, false, DIAGNOSTIC, \
363 "Enables intrinsification of ArraysSupport.vectorizedHashCode()") \
364 \
365 product(bool, UseCopySignIntrinsic, false, DIAGNOSTIC, \
366 "Enables intrinsification of Math.copySign") \
367 \
368 product(bool, UseSignumIntrinsic, false, DIAGNOSTIC, \
369 "Enables intrinsification of Math.signum") \
370 \
371 product_pd(bool, DelayCompilerStubsGeneration, DIAGNOSTIC, \
372 "Use Compiler thread for compiler's stubs generation") \
373 \
374 product(ccstrlist, DisableIntrinsic, "", DIAGNOSTIC, \
375 "do not expand intrinsics whose (internal) names appear here") \
376 constraint(DisableIntrinsicConstraintFunc,AfterErgo) \
377 \
378 product(ccstrlist, ControlIntrinsic, "", DIAGNOSTIC, \
379 "Control intrinsics using a list of +/- (internal) names, " \
380 "separated by commas") \
381 constraint(ControlIntrinsicConstraintFunc,AfterErgo) \
382 \
383 develop(bool, TraceCallFixup, false, \
384 "Trace all call fixups") \
385 \
386 develop(bool, DeoptimizeALot, false, \
387 "Deoptimize at every exit from the runtime system") \
388 \
389 develop(ccstrlist, DeoptimizeOnlyAt, "", \
390 "A comma separated list of bcis to deoptimize at") \
391 \
392 develop(bool, DeoptimizeRandom, false, \
393 "Deoptimize random frames on random exit from the runtime system")\
394 \
395 develop(bool, ZombieALot, false, \
396 "Create non-entrant nmethods at exit from the runtime system") \
397 \
398 develop(bool, WalkStackALot, false, \
399 "Trace stack (no print) at every exit from the runtime system") \
400 \
401 develop(bool, DeoptimizeObjectsALot, false, \
402 "For testing purposes concurrent threads revert optimizations " \
403 "based on escape analysis at intervals given with " \
404 "DeoptimizeObjectsALotInterval=n. The thread count is given " \
405 "with DeoptimizeObjectsALotThreadCountSingle and " \
406 "DeoptimizeObjectsALotThreadCountAll.") \
407 \
408 develop(uint64_t, DeoptimizeObjectsALotInterval, 5, \
409 "Interval for DeoptimizeObjectsALot.") \
410 range(0, max_jlong) \
411 \
412 develop(int, DeoptimizeObjectsALotThreadCountSingle, 1, \
413 "The number of threads that revert optimizations based on " \
414 "escape analysis for a single thread if DeoptimizeObjectsALot " \
415 "is enabled. The target thread is selected round robin." ) \
416 range(0, max_jint) \
417 \
418 develop(int, DeoptimizeObjectsALotThreadCountAll, 1, \
419 "The number of threads that revert optimizations based on " \
420 "escape analysis for all threads if DeoptimizeObjectsALot " \
421 "is enabled." ) \
422 range(0, max_jint) \
423 \
424 develop(bool, VerifyLastFrame, false, \
425 "Verify oops on last frame on entry to VM") \
426 \
427 product(bool, SafepointTimeout, false, \
428 "Time out and warn or fail after SafepointTimeoutDelay " \
429 "milliseconds if failed to reach safepoint") \
430 \
431 product(bool, AbortVMOnSafepointTimeout, false, DIAGNOSTIC, \
432 "Abort upon failure to reach safepoint (see SafepointTimeout)") \
433 \
434 product(uint64_t, AbortVMOnSafepointTimeoutDelay, 0, DIAGNOSTIC, \
435 "Delay in milliseconds for option AbortVMOnSafepointTimeout") \
436 range(0, max_jlong) \
437 \
438 product(bool, AbortVMOnVMOperationTimeout, false, DIAGNOSTIC, \
439 "Abort upon failure to complete VM operation promptly") \
440 \
441 product(intx, AbortVMOnVMOperationTimeoutDelay, 1000, DIAGNOSTIC, \
442 "Delay in milliseconds for option AbortVMOnVMOperationTimeout") \
443 range(0, max_intx) \
444 \
445 product(bool, MaxFDLimit, true, \
446 "Bump the number of file descriptors to maximum (Unix only)") \
447 \
448 product(bool, LogEvents, true, DIAGNOSTIC, \
449 "Enable the various ring buffer event logs") \
450 \
451 product(int, LogEventsBufferEntries, 20, DIAGNOSTIC, \
452 "Number of ring buffer event logs") \
453 range(1, NOT_LP64(1*K) LP64_ONLY(1*M)) \
454 \
455 product(bool, BytecodeVerificationRemote, true, DIAGNOSTIC, \
456 "Enable the Java bytecode verifier for remote classes") \
457 \
458 product(bool, BytecodeVerificationLocal, false, DIAGNOSTIC, \
459 "Enable the Java bytecode verifier for local classes") \
460 \
461 develop(bool, VerifyStackAtCalls, false, \
462 "Verify that the stack pointer is unchanged after calls") \
463 \
464 develop(bool, TraceJavaAssertions, false, \
465 "Trace java language assertions") \
466 \
467 develop(bool, VerifyCodeCache, false, \
468 "Verify code cache on memory allocation/deallocation") \
469 \
470 develop(bool, ZapResourceArea, trueInDebug, \
471 "Zap freed resource/arena space") \
472 \
473 develop(bool, ZapVMHandleArea, trueInDebug, \
474 "Zap freed VM handle space") \
475 \
476 develop(bool, ZapStackSegments, trueInDebug, \
477 "Zap allocated/freed stack segments") \
478 \
479 develop(bool, ZapUnusedHeapArea, trueInDebug, \
480 "Zap unused heap space") \
481 \
482 develop(bool, ZapFillerObjects, trueInDebug, \
483 "Zap filler objects") \
484 \
485 develop(bool, ZapCHeap, trueInDebug, \
486 "Zap allocated/freed C heap space") \
487 \
488 develop(bool, ZapTLAB, trueInDebug, \
489 "Zap allocated TLABs") \
490 develop(bool, TestingAsyncLoggingDeathTest, false, \
491 "Recursive logging death test") \
492 develop(bool, TestingAsyncLoggingDeathTestNoCrash, false, \
493 "Recursive logging death test (no crash)") \
494 \
495 product(bool, ExecutingUnitTests, false, \
496 "Whether the JVM is running unit tests or not") \
497 \
498 develop(uint, ErrorHandlerTest, 0, \
499 "If > 0, provokes an error after VM initialization; the value " \
500 "determines which error to provoke. See controlled_crash() " \
501 "in vmError.cpp.") \
502 range(0, 18) \
503 \
504 develop(uint, TestCrashInErrorHandler, 0, \
505 "If > 0, provokes an error inside VM error handler (a secondary " \
506 "crash). see controlled_crash() in vmError.cpp") \
507 range(0, 17) \
508 \
509 develop(bool, TestSafeFetchInErrorHandler, false , \
510 "If true, tests SafeFetch inside error handler.") \
511 \
512 develop(bool, TestUnresponsiveErrorHandler, false, \
513 "If true, simulates an unresponsive error handler.") \
514 \
515 develop(bool, Verbose, false, \
516 "Print additional debugging information from other modes") \
517 \
518 develop(bool, PrintMiscellaneous, false, \
519 "Print uncategorized debugging information (requires +Verbose)") \
520 \
521 develop(bool, WizardMode, false, \
522 "Print much more debugging information") \
523 \
524 product(bool, ShowMessageBoxOnError, false, \
525 "Keep process alive on VM fatal error") \
526 \
527 product(bool, CreateCoredumpOnCrash, true, \
528 "Create core/mini dump on VM fatal error") \
529 \
530 product(uint64_t, ErrorLogTimeout, 2 * 60, \
531 "Timeout, in seconds, to limit the time spent on writing an " \
532 "error log in case of a crash.") \
533 range(0, (uint64_t)max_jlong/1000) \
534 \
535 product(bool, ErrorLogSecondaryErrorDetails, false, DIAGNOSTIC, \
536 "If enabled, show details on secondary crashes in the error log") \
537 \
538 develop(intx, TraceDwarfLevel, 0, \
539 "Debug levels for the dwarf parser") \
540 range(0, 4) \
541 \
542 product(bool, SuppressFatalErrorMessage, false, \
543 "Report NO fatal error message (avoid deadlock)") \
544 \
545 product(ccstrlist, OnError, "", \
546 "Run user-defined commands on fatal error; see VMError.cpp " \
547 "for examples") \
548 \
549 product(ccstrlist, OnOutOfMemoryError, "", \
550 "Run user-defined commands on first java.lang.OutOfMemoryError " \
551 "thrown from JVM") \
552 \
553 product(bool, HeapDumpBeforeFullGC, false, MANAGEABLE, \
554 "Dump heap to file before any major stop-the-world GC " \
555 "(also see FullGCHeapDumpLimit, HeapDumpPath, HeapDumpGzipLevel)")\
556 \
557 product(bool, HeapDumpAfterFullGC, false, MANAGEABLE, \
558 "Dump heap to file after any major stop-the-world GC " \
559 "(also see FullGCHeapDumpLimit, HeapDumpPath, HeapDumpGzipLevel)")\
560 \
561 product(uint, FullGCHeapDumpLimit, 0, MANAGEABLE, \
562 "Limit the number of heap dumps triggered by " \
563 "HeapDumpBeforeFullGC or HeapDumpAfterFullGC " \
564 "(0 means no limit)") \
565 \
566 product(bool, HeapDumpOnOutOfMemoryError, false, MANAGEABLE, \
567 "Dump heap to file when java.lang.OutOfMemoryError is thrown " \
568 "from JVM " \
569 "(also see HeapDumpPath, HeapDumpGzipLevel)") \
570 \
571 product(ccstr, HeapDumpPath, nullptr, MANAGEABLE, \
572 "When HeapDumpOnOutOfMemoryError, HeapDumpBeforeFullGC " \
573 "or HeapDumpAfterFullGC is on, the path (filename or " \
574 "directory) of the dump file (defaults to java_pid<pid>.hprof " \
575 "in the working directory)") \
576 \
577 product(int, HeapDumpGzipLevel, 0, MANAGEABLE, \
578 "When HeapDumpOnOutOfMemoryError, HeapDumpBeforeFullGC " \
579 "or HeapDumpAfterFullGC is on, the gzip compression " \
580 "level of the dump file. 0 (the default) disables gzip " \
581 "compression. Otherwise the level must be between 1 and 9.") \
582 range(0, 9) \
583 \
584 product(ccstr, NativeMemoryTracking, DEBUG_ONLY("summary") NOT_DEBUG("off"), \
585 "Native memory tracking options") \
586 \
587 product(bool, PrintNMTStatistics, false, DIAGNOSTIC, \
588 "Print native memory tracking summary data if it is on") \
589 \
590 product(bool, LogCompilation, false, DIAGNOSTIC, \
591 "Log compilation activity in detail to LogFile") \
592 \
593 product(bool, PrintCompilation, false, \
594 "Print compilations") \
595 \
596 product(intx, RepeatCompilation, 0, DIAGNOSTIC, \
597 "Repeat compilation without installing code (number of times)") \
598 range(0, max_jint) \
599 \
600 product(bool, PrintExtendedThreadInfo, false, \
601 "Print more information in thread dump") \
602 \
603 product(intx, ScavengeRootsInCode, 2, DIAGNOSTIC, \
604 "0: do not allow scavengable oops in the code cache; " \
605 "1: allow scavenging from the code cache; " \
606 "2: emit as many constants as the compiler can see") \
607 range(0, 2) \
608 \
609 product(bool, AlwaysRestoreFPU, false, \
610 "Restore the FPU control word after every JNI call (expensive)") \
611 \
612 product(bool, PrintCompilation2, false, DIAGNOSTIC, \
613 "Print additional statistics per compilation") \
614 \
615 product(bool, PrintAdapterHandlers, false, DIAGNOSTIC, \
616 "Print code generated for i2c/c2i adapters") \
617 \
618 develop(bool, VerifyAdapterSharing, false, \
619 "Verify that the code for shared adapters is the equivalent") \
620 \
621 product(bool, PrintAssembly, false, DIAGNOSTIC, \
622 "Print assembly code (using external disassembler.so)") \
623 \
624 product(ccstr, PrintAssemblyOptions, DEFAULT_PRINT_ASSEMBLY_OPTIONS, \
625 DIAGNOSTIC, \
626 "Print options string passed to disassembler.so") \
627 \
628 develop(bool, PrintNMethodStatistics, false, \
629 "Print a summary statistic for the generated nmethods") \
630 \
631 product(bool, PrintNMethods, false, DIAGNOSTIC, \
632 "Print assembly code for nmethods when generated") \
633 \
634 product(bool, PrintNativeNMethods, false, DIAGNOSTIC, \
635 "Print assembly code for native nmethods when generated") \
636 \
637 develop(bool, PrintDebugInfo, false, \
638 "Print debug information for all nmethods when generated") \
639 \
640 develop(bool, PrintRelocations, false, \
641 "Print relocation information for all nmethods when generated") \
642 \
643 develop(bool, PrintDependencies, false, \
644 "Print dependency information for all nmethods when generated") \
645 \
646 develop(bool, PrintExceptionHandlers, false, \
647 "Print exception handler tables for all nmethods when generated") \
648 \
649 develop(bool, StressCompiledExceptionHandlers, false, \
650 "Exercise compiled exception handlers") \
651 \
652 product(bool, DeoptimizeOnAllocationException, false, DIAGNOSTIC, \
653 "Deoptimize on exception during allocation instead of using the " \
654 "compiled exception handlers") \
655 \
656 develop(bool, InterceptOSException, false, \
657 "Start debugger when an implicit OS (e.g. null pointer) " \
658 "exception happens") \
659 \
660 product(bool, PrintCodeCache, false, \
661 "Print the code cache memory usage when exiting") \
662 \
663 develop(bool, PrintCodeCache2, false, \
664 "Print detailed usage information on the code cache when exiting")\
665 \
666 product(bool, PrintCodeCacheOnCompilation, false, \
667 "Print the code cache memory usage each time a method is " \
668 "compiled") \
669 \
670 product(bool, PrintCodeHeapAnalytics, false, DIAGNOSTIC, \
671 "Print code heap usage statistics on exit and on full condition") \
672 \
673 product(bool, PrintStubCode, false, DIAGNOSTIC, \
674 "Print generated stub code") \
675 \
676 product(bool, StackTraceInThrowable, true, \
677 "Collect backtrace in throwable when exception happens") \
678 \
679 product(bool, OmitStackTraceInFastThrow, true, \
680 "Omit backtraces for some 'hot' exceptions in optimized code") \
681 \
682 product(bool, ShowCodeDetailsInExceptionMessages, true, MANAGEABLE, \
683 "Show exception messages from RuntimeExceptions that contain " \
684 "snippets of the failing code. Disable this to improve privacy.") \
685 \
686 product(bool, PrintWarnings, true, \
687 "Print JVM warnings to output stream") \
688 \
689 develop(bool, RegisterReferences, true, \
690 "Tell whether the VM should register soft/weak/final/phantom " \
691 "references") \
692 \
693 develop(bool, PrintCodeCacheExtension, false, \
694 "Print extension of code cache") \
695 \
696 product(bool, ClassUnloading, true, \
697 "Do unloading of classes") \
698 \
699 product(bool, ClassUnloadingWithConcurrentMark, true, \
700 "Do unloading of classes with a concurrent marking cycle") \
701 \
702 develop(bool, PrintSystemDictionaryAtExit, false, \
703 "Print the system dictionary at exit") \
704 \
705 develop(bool, PrintClassLoaderDataGraphAtExit, false, \
706 "Print the class loader data graph at exit") \
707 \
708 product(bool, PrintVMInfoAtExit, false, DIAGNOSTIC, \
709 "Executes the VM.info diagnostic command at exit") \
710 \
711 product(bool, AllowParallelDefineClass, false, \
712 "Allow parallel defineClass requests for class loaders " \
713 "registering as parallel capable") \
714 \
715 product(bool, DisablePrimordialThreadGuardPages, false, EXPERIMENTAL, \
716 "Disable the use of stack guard pages if the JVM is loaded " \
717 "on the primordial process thread") \
718 \
719 product(bool, DoJVMTIVirtualThreadTransitions, true, EXPERIMENTAL, \
720 "Do JVMTI virtual thread mount/unmount transitions " \
721 "(disabling this flag implies no JVMTI events are posted)") \
722 \
723 /* notice: the max range value here is max_jint, not max_intx */ \
724 /* because of overflow issue */ \
725 product(intx, AsyncDeflationInterval, 250, DIAGNOSTIC, \
726 "Async deflate idle monitors every so many milliseconds when " \
727 "MonitorUsedDeflationThreshold is exceeded (0 is off).") \
728 range(0, max_jint) \
729 \
730 /* notice: the max range value here is max_jint, not max_intx */ \
731 /* because of overflow issue */ \
732 product(intx, GuaranteedAsyncDeflationInterval, 60000, DIAGNOSTIC, \
733 "Async deflate idle monitors every so many milliseconds even " \
734 "when MonitorUsedDeflationThreshold is NOT exceeded (0 is off).") \
735 range(0, max_jint) \
736 \
737 product(size_t, AvgMonitorsPerThreadEstimate, 1024, DIAGNOSTIC, \
738 "Used to estimate a variable ceiling based on number of threads " \
739 "for use with MonitorUsedDeflationThreshold (0 is off).") \
740 range(0, max_uintx) \
741 \
742 /* notice: the max range value here is max_jint, not max_intx */ \
743 /* because of overflow issue */ \
744 product(intx, MonitorDeflationMax, 1000000, DIAGNOSTIC, \
745 "The maximum number of monitors to deflate, unlink and delete " \
746 "at one time (minimum is 1024).") \
747 range(1024, max_jint) \
748 \
749 product(intx, MonitorUnlinkBatch, 500, DIAGNOSTIC, \
750 "The maximum number of monitors to unlink in one batch. ") \
751 range(1, max_jint) \
752 \
753 product(int, MonitorUsedDeflationThreshold, 90, DIAGNOSTIC, \
754 "Percentage of used monitors before triggering deflation (0 is " \
755 "off). The check is performed on AsyncDeflationInterval or " \
756 "GuaranteedAsyncDeflationInterval, whichever is lower.") \
757 range(0, 100) \
758 \
759 product(uintx, NoAsyncDeflationProgressMax, 3, DIAGNOSTIC, \
760 "Max number of no progress async deflation attempts to tolerate " \
761 "before adjusting the in_use_list_ceiling up (0 is off).") \
762 range(0, max_uintx) \
763 \
764 product(intx, hashCode, 5, EXPERIMENTAL, \
765 "(Unstable) select hashCode generation algorithm") \
766 \
767 product(bool, ReduceSignalUsage, false, \
768 "Reduce the use of OS signals in Java and/or the VM") \
769 \
770 develop(bool, LoadLineNumberTables, true, \
771 "Tell whether the class file parser loads line number tables") \
772 \
773 develop(bool, LoadLocalVariableTables, true, \
774 "Tell whether the class file parser loads local variable tables") \
775 \
776 develop(bool, LoadLocalVariableTypeTables, true, \
777 "Tell whether the class file parser loads local variable type" \
778 "tables") \
779 \
780 product(bool, AllowUserSignalHandlers, false, \
781 "Application will install primary signal handlers for the JVM " \
782 "(Unix only)") \
783 \
784 product(bool, UseSignalChaining, true, \
785 "Use signal-chaining to invoke signal handlers installed " \
786 "by the application (Unix only)") \
787 \
788 product(bool, RestoreMXCSROnJNICalls, false, \
789 "Restore MXCSR when returning from JNI calls") \
790 \
791 product(bool, CheckJNICalls, false, \
792 "Verify all arguments to JNI calls") \
793 \
794 product(bool, UseFastJNIAccessors, true, \
795 "Use optimized versions of Get<Primitive>Field") \
796 \
797 product(intx, MaxJNILocalCapacity, 65536, \
798 "Maximum allowable local JNI handle capacity to " \
799 "EnsureLocalCapacity() and PushLocalFrame(), " \
800 "where <= 0 is unlimited, default: 65536") \
801 range(min_intx, max_intx) \
802 \
803 product(bool, EagerXrunInit, false, \
804 "Eagerly initialize -Xrun libraries; allows startup profiling, " \
805 "but not all -Xrun libraries may support the state of the VM " \
806 "at this time") \
807 \
808 develop(uintx, PreallocatedOutOfMemoryErrorCount, 4, \
809 "Number of OutOfMemoryErrors preallocated with backtrace") \
810 range(0, 1024) \
811 \
812 product(bool, PrintFieldLayout, false, DIAGNOSTIC, \
813 "Print field layout for each class") \
814 \
815 product(bool, PrintInlineLayout, false, DIAGNOSTIC, \
816 "Print field layout for each value class or class containing " \
817 "inlined value fields") \
818 \
819 product(bool, PrintFlatArrayLayout, false, DIAGNOSTIC, \
820 "Print array layout for each flattened value array") \
821 \
822 product(bool, UseArrayFlattening, true, DIAGNOSTIC, \
823 "Allow the JVM to flatten arrays of concrete value objects " \
824 "when it determines it is possible and beneficial to do so") \
825 \
826 product(bool, UseFieldFlattening, true, DIAGNOSTIC, \
827 "Allow the JVM to inline the fields of concrete value objects " \
828 "when it determines it is possible and beneficial to do so") \
829 \
830 product(bool, UseNullableAtomicValueFlattening, true, DIAGNOSTIC, \
831 "Allow the JVM to flatten some nullable atomic values") \
832 \
833 product(bool, UseNullFreeNonAtomicValueFlattening, true, EXPERIMENTAL, \
834 "Allow the JVM to flatten some null-free non-atomic values") \
835 \
836 product(bool, UseNullFreeAtomicValueFlattening, true, EXPERIMENTAL, \
837 "Allow the JVM to flatten some null-free atomic values") \
838 \
839 product(bool, UseNullableNonAtomicValueFlattening, true, DIAGNOSTIC, \
840 "Allow the JVM to flatten some strict final non-static fields") \
841 \
842 product(intx, FlatArrayElementMaxOops, 4, DIAGNOSTIC, \
843 "Max number of embedded object references in a value container " \
844 "before no flattening attempts are made, <0 indicates no limit") \
845 \
846 product(uint, FlatteningBudget, 1024, EXPERIMENTAL, \
847 "Maximum size (in bytes) dedicated to flat fields in an instance")\
848 range(0, 1024 * 1024) \
849 develop(ccstrlist, PrintInlineKlassFields, "", \
850 "Print fields collected by InlineKlass::collect_fields") \
851 \
852 /* Need to limit the extent of the padding to reasonable size. */\
853 /* 8K is well beyond the reasonable HW cache line size, even with */\
854 /* aggressive prefetching, while still leaving the room for segregating */\
855 /* among the distinct pages. */\
856 product(int, ContendedPaddingWidth, 128, \
857 "How many bytes to pad the fields/classes marked @Contended with")\
858 range(0, 8192) \
859 constraint(ContendedPaddingWidthConstraintFunc,AfterErgo) \
860 \
861 product(bool, EnableContended, true, \
862 "Enable @Contended annotation support") \
863 \
864 product(bool, RestrictContended, true, \
865 "Restrict @Contended to trusted classes") \
866 \
867 product(int, DiagnoseSyncOnValueBasedClasses, 0, DIAGNOSTIC, \
868 "Detect and take action upon identifying synchronization on " \
869 "value based classes. Modes: " \
870 "0: off; " \
871 "1: exit with fatal error; " \
872 "2: log message to stdout. Output file can be specified with " \
873 " -Xlog:valuebasedclasses. If JFR is running it will " \
874 " also generate JFR events.") \
875 range(0, 2) \
876 \
877 product(bool, ExitOnOutOfMemoryError, false, \
878 "JVM exits on the first occurrence of an out-of-memory error " \
879 "thrown from JVM") \
880 \
881 product(bool, CrashOnOutOfMemoryError, false, \
882 "JVM aborts, producing an error log and core/mini dump, on the " \
883 "first occurrence of an out-of-memory error thrown from JVM") \
884 \
885 product(intx, UserThreadWaitAttemptsAtExit, 30, \
886 "The number of times to wait for user threads to stop executing " \
887 "native code during JVM exit. Each wait lasts 10 milliseconds. " \
888 "The maximum number of waits is 1000, to wait at most 10 " \
889 "seconds.") \
890 range(0, 1000) \
891 \
892 /* tracing */ \
893 \
894 develop(bool, StressRewriter, false, \
895 "Stress linktime bytecode rewriting") \
896 \
897 product(ccstr, TraceJVMTI, nullptr, \
898 "Trace flags for JVMTI functions and events") \
899 \
900 product(bool, StressLdcRewrite, false, DIAGNOSTIC, \
901 "Force ldc -> ldc_w rewrite during RedefineClasses. " \
902 "This option can change an EMCP method into an obsolete method " \
903 "and can affect tests that expect specific methods to be EMCP. " \
904 "This option should be used with caution.") \
905 \
906 product(bool, AllowRedefinitionToAddDeleteMethods, false, \
907 "(Deprecated) Allow redefinition to add and delete private " \
908 "static or final methods for compatibility with old releases") \
909 \
910 develop(bool, TraceBytecodes, false, \
911 "Trace bytecode execution") \
912 \
913 develop(bool, TraceBytecodesTruncated, false, \
914 "Truncate non control-flow bytecode when tracing bytecode") \
915 \
916 develop(bool, VerifyDependencies, trueInDebug, \
917 "Exercise and verify the compilation dependency mechanism") \
918 \
919 develop(bool, TimeOopMap, false, \
920 "Time calls to GenerateOopMap::compute_map() in sum") \
921 \
922 develop(bool, GenerateOopMapALot, false, \
923 "Generate interpreter oopmaps at all safepoints") \
924 \
925 develop(bool, TraceFinalizerRegistration, false, \
926 "Trace registration of final references") \
927 \
928 product(bool, IgnoreEmptyClassPaths, false, \
929 "Ignore empty path elements in -classpath") \
930 \
931 product(bool, PrintHeapAtSIGBREAK, true, \
932 "Print heap layout in response to SIGBREAK") \
933 \
934 product(bool, PrintClassHistogram, false, MANAGEABLE, \
935 "Print a histogram of class instances") \
936 \
937 product(double, ObjectCountCutOffPercent, 0.5, EXPERIMENTAL, \
938 "The percentage of the used heap that the instances of a class " \
939 "must occupy for the class to generate a trace event") \
940 range(0.0, 100.0) \
941 \
942 /* JVMTI heap profiling */ \
943 \
944 product(bool, VerifyBeforeIteration, false, DIAGNOSTIC, \
945 "Verify memory system before JVMTI iteration") \
946 \
947 /* compiler */ \
948 \
949 /* notice: the max range value here is max_jint, not max_intx */ \
950 /* because of overflow issue */ \
951 product(intx, CICompilerCount, CI_COMPILER_COUNT, \
952 "Number of compiler threads to run") \
953 range(0, max_jint) \
954 constraint(CICompilerCountConstraintFunc, AfterErgo) \
955 \
956 product(bool, UseDynamicNumberOfCompilerThreads, true, \
957 "Dynamically choose the number of parallel compiler threads") \
958 \
959 product(bool, ReduceNumberOfCompilerThreads, true, DIAGNOSTIC, \
960 "Reduce the number of parallel compiler threads when they " \
961 "are not used") \
962 \
963 product(bool, TraceCompilerThreads, false, DIAGNOSTIC, \
964 "Trace creation and removal of compiler threads") \
965 \
966 product(ccstr, LogClassLoadingCauseFor, nullptr, \
967 "Apply -Xlog:class+load+cause* to classes whose fully " \
968 "qualified name contains this string (\"*\" matches " \
969 "any class).") \
970 \
971 develop(bool, InjectCompilerCreationFailure, false, \
972 "Inject thread creation failures for " \
973 "UseDynamicNumberOfCompilerThreads") \
974 \
975 product_pd(bool, ImplicitNullChecks, DIAGNOSTIC, \
976 "Generate code for implicit null checks") \
977 \
978 product_pd(bool, TrapBasedNullChecks, \
979 "Generate code for null checks that uses a cmp and trap " \
980 "instruction raising SIGTRAP. This is only used if an access to" \
981 "null (+offset) will not raise a SIGSEGV, i.e.," \
982 "ImplicitNullChecks don't work (PPC64).") \
983 \
984 product(bool, EnableThreadSMRStatistics, trueInDebug, DIAGNOSTIC, \
985 "Enable Thread SMR Statistics") \
986 \
987 product(bool, Inline, true, \
988 "Enable inlining") \
989 \
990 product(bool, ClipInlining, true, \
991 "Clip inlining if aggregate method exceeds DesiredMethodLimit") \
992 \
993 develop(bool, UseCHA, true, \
994 "Enable CHA") \
995 \
996 product(bool, UseTypeProfile, true, \
997 "Check interpreter profile for historically monomorphic calls") \
998 \
999 product(bool, PrintInlining, false, DIAGNOSTIC, \
1000 "Print inlining optimizations") \
1001 \
1002 product(bool, UsePopCountInstruction, false, \
1003 "Use population count instruction") \
1004 \
1005 develop(bool, TraceMethodReplacement, false, \
1006 "Print when methods are replaced do to recompilation") \
1007 \
1008 product(intx, MinPassesBeforeFlush, 10, DIAGNOSTIC, \
1009 "Minimum number of sweeper passes before an nmethod " \
1010 "can be flushed") \
1011 range(0, max_intx) \
1012 \
1013 develop(bool, StressCodeBuffers, false, \
1014 "Exercise code buffer expansion and other rare state changes") \
1015 \
1016 product(bool, DebugNonSafepoints, trueInDebug, DIAGNOSTIC, \
1017 "Generate extra debugging information for non-safepoints in " \
1018 "nmethods") \
1019 \
1020 product(bool, PrintVMOptions, false, \
1021 "Print flags that appeared on the command line") \
1022 \
1023 product(bool, IgnoreUnrecognizedVMOptions, false, \
1024 "Ignore unrecognized VM options") \
1025 \
1026 product(bool, PrintCommandLineFlags, false, \
1027 "Print flags specified on command line or set by ergonomics") \
1028 \
1029 product(bool, PrintFlagsInitial, false, \
1030 "Print all VM flags before argument processing and exit VM") \
1031 \
1032 product(bool, PrintFlagsFinal, false, \
1033 "Print all VM flags after argument and ergonomic processing") \
1034 \
1035 develop(bool, PrintFlagsWithComments, false, \
1036 "Print all VM flags with default values and descriptions and " \
1037 "exit") \
1038 \
1039 product(bool, PrintFlagsRanges, false, \
1040 "Print VM flags and their ranges") \
1041 \
1042 product(bool, SerializeVMOutput, true, DIAGNOSTIC, \
1043 "Use a mutex to serialize output to tty and LogFile") \
1044 \
1045 product(bool, DisplayVMOutput, true, DIAGNOSTIC, \
1046 "Display all VM output on the tty, independently of LogVMOutput") \
1047 \
1048 product(bool, LogVMOutput, false, DIAGNOSTIC, \
1049 "Save VM output to LogFile") \
1050 \
1051 product(ccstr, LogFile, nullptr, DIAGNOSTIC, \
1052 "If LogVMOutput or LogCompilation is on, save VM output to " \
1053 "this file [default: ./hotspot_pid%p.log] (%p replaced with pid)")\
1054 \
1055 product(ccstr, ErrorFile, nullptr, \
1056 "If an error occurs, save the error data to this file " \
1057 "[default: ./hs_err_pid%p.log] (%p replaced with pid)") \
1058 \
1059 product(bool, ExtensiveErrorReports, \
1060 PRODUCT_ONLY(false) NOT_PRODUCT(true), \
1061 "Error reports are more extensive.") \
1062 \
1063 product(bool, DisplayVMOutputToStderr, false, \
1064 "If DisplayVMOutput is true, display all VM output to stderr") \
1065 \
1066 product(bool, DisplayVMOutputToStdout, false, \
1067 "If DisplayVMOutput is true, display all VM output to stdout") \
1068 \
1069 product(bool, ErrorFileToStderr, false, \
1070 "If true, error data is printed to stderr instead of a file") \
1071 \
1072 product(bool, ErrorFileToStdout, false, \
1073 "If true, error data is printed to stdout instead of a file") \
1074 \
1075 product(bool, PrintStringTableStatistics, false, \
1076 "print statistics about the StringTable and SymbolTable") \
1077 \
1078 product(bool, VerifyStringTableAtExit, false, DIAGNOSTIC, \
1079 "verify StringTable contents at exit") \
1080 \
1081 develop(bool, PrintSymbolTableSizeHistogram, false, \
1082 "print histogram of the symbol table") \
1083 \
1084 product(ccstr, AbortVMOnException, nullptr, DIAGNOSTIC, \
1085 "Call fatal if this exception is thrown. Example: " \
1086 "java -XX:AbortVMOnException=java.lang.NullPointerException Foo") \
1087 \
1088 product(ccstr, AbortVMOnExceptionMessage, nullptr, DIAGNOSTIC, \
1089 "Call fatal if the exception pointed by AbortVMOnException " \
1090 "has this message") \
1091 \
1092 develop(bool, DebugVtables, false, \
1093 "add debugging code to vtable dispatch") \
1094 \
1095 product(bool, RangeCheckElimination, true, \
1096 "Eliminate range checks") \
1097 \
1098 develop_pd(bool, UncommonNullCast, \
1099 "track occurrences of null in casts; adjust compiler tactics") \
1100 \
1101 develop(bool, TypeProfileCasts, true, \
1102 "treat casts like calls for purposes of type profiling") \
1103 \
1104 develop(bool, TraceLivenessGen, false, \
1105 "Trace the generation of liveness analysis information") \
1106 \
1107 develop(bool, TraceLivenessQuery, false, \
1108 "Trace queries of liveness analysis information") \
1109 \
1110 develop(bool, CollectIndexSetStatistics, false, \
1111 "Collect information about IndexSets") \
1112 \
1113 /* This value is later shifted left by up to LogBytesPerLong bits */\
1114 /* (to convert from element count to size in bytes), so we must ensure */\
1115 /* it does not overflow during the shift. */\
1116 develop(int, FastAllocateSizeLimit, 128*K, \
1117 /* Note: This value is zero mod 1<<13 for a cheap sparc set. */ \
1118 "Inline allocations larger than this in doublewords must go slow")\
1119 range(0, (1 << (BitsPerInt - LogBytesPerLong - 1)) - 1) \
1120 \
1121 product_pd(bool, CompactStrings, \
1122 "Enable Strings to use single byte chars in backing store") \
1123 \
1124 product_pd(uint, TypeProfileLevel, \
1125 "=XYZ, with Z: Type profiling of arguments at call; " \
1126 "Y: Type profiling of return value at call; " \
1127 "X: Type profiling of parameters to methods; " \
1128 "X, Y and Z in 0=off ; 1=jsr292 only; 2=all methods") \
1129 constraint(TypeProfileLevelConstraintFunc, AfterErgo) \
1130 \
1131 product(int, TypeProfileArgsLimit, 2, \
1132 "max number of call arguments to consider for type profiling") \
1133 range(0, 16) \
1134 \
1135 product(int, TypeProfileParmsLimit, 2, \
1136 "max number of incoming parameters to consider for type profiling"\
1137 ", -1 for all") \
1138 range(-1, 64) \
1139 \
1140 /* statistics */ \
1141 develop(bool, CountCompiledCalls, false, \
1142 "Count method invocations") \
1143 \
1144 develop(bool, ICMissHistogram, false, \
1145 "Produce histogram of IC misses") \
1146 \
1147 /* interpreter */ \
1148 product_pd(bool, RewriteBytecodes, \
1149 "Allow rewriting of bytecodes (bytecodes are not immutable)") \
1150 \
1151 product_pd(bool, RewriteFrequentPairs, \
1152 "Rewrite frequently used bytecode pairs into a single bytecode") \
1153 \
1154 product(bool, PrintInterpreter, false, DIAGNOSTIC, \
1155 "Print the generated interpreter code") \
1156 \
1157 product(bool, UseInterpreter, true, \
1158 "Use interpreter for non-compiled methods") \
1159 \
1160 develop(bool, UseFastSignatureHandlers, true, \
1161 "Use fast signature handlers for native calls") \
1162 \
1163 product(bool, UseLoopCounter, true, \
1164 "Increment invocation counter on backward branch") \
1165 \
1166 product_pd(bool, UseOnStackReplacement, \
1167 "Use on stack replacement, calls runtime if invoc. counter " \
1168 "overflows in loop") \
1169 \
1170 develop(bool, TraceOnStackReplacement, false, \
1171 "Trace on stack replacement") \
1172 \
1173 product_pd(bool, PreferInterpreterNativeStubs, \
1174 "Use always interpreter stubs for native methods invoked via " \
1175 "interpreter") \
1176 \
1177 develop(bool, CountBytecodes, false, \
1178 "Count number of bytecodes executed") \
1179 \
1180 develop(bool, PrintBytecodeHistogram, false, \
1181 "Print histogram of the executed bytecodes") \
1182 \
1183 develop(bool, PrintBytecodePairHistogram, false, \
1184 "Print histogram of the executed bytecode pairs") \
1185 \
1186 product(bool, PrintSignatureHandlers, false, DIAGNOSTIC, \
1187 "Print code generated for native method signature handlers") \
1188 \
1189 develop(bool, VerifyOops, false, \
1190 "Do plausibility checks for oops") \
1191 \
1192 develop(bool, CheckUnhandledOops, false, \
1193 "Check for unhandled oops in VM code") \
1194 \
1195 develop(bool, VerifyJNIFields, trueInDebug, \
1196 "Verify jfieldIDs for instance fields") \
1197 \
1198 develop(bool, VerifyActivationFrameSize, false, \
1199 "Verify that activation frame didn't become smaller than its " \
1200 "minimal size") \
1201 \
1202 develop(bool, TraceFrequencyInlining, false, \
1203 "Trace frequency based inlining") \
1204 \
1205 develop_pd(bool, InlineIntrinsics, \
1206 "Use intrinsics in Interpreter that can be statically resolved") \
1207 \
1208 product_pd(bool, ProfileInterpreter, \
1209 "Profile at the bytecode level during interpretation") \
1210 \
1211 develop_pd(bool, ProfileTraps, \
1212 "Profile deoptimization traps at the bytecode level") \
1213 \
1214 product(intx, ProfileMaturityPercentage, 20, \
1215 "number of method invocations/branches (expressed as % of " \
1216 "CompileThreshold) before using the method's profile") \
1217 range(0, 100) \
1218 \
1219 product(bool, PrintMethodData, false, DIAGNOSTIC, \
1220 "Print the results of +ProfileInterpreter at end of run") \
1221 \
1222 develop(bool, VerifyDataPointer, trueInDebug, \
1223 "Verify the method data pointer during interpreter profiling") \
1224 \
1225 develop(bool, CrashGCForDumpingJavaThread, false, \
1226 "Manually make GC thread crash then dump java stack trace; " \
1227 "Test only") \
1228 \
1229 /* compilation */ \
1230 product(bool, UseCompiler, true, \
1231 "Use Just-In-Time compilation") \
1232 \
1233 product(bool, AlwaysCompileLoopMethods, false, \
1234 "(Deprecated) When using recompilation, never interpret methods " \
1235 "containing loops") \
1236 \
1237 product(int, AllocatePrefetchStyle, 1, \
1238 "0 = no prefetch, " \
1239 "1 = generate prefetch instructions for each allocation, " \
1240 "2 = use TLAB watermark to gate allocation prefetch, " \
1241 "3 = generate one prefetch instruction per cache line") \
1242 range(0, 3) \
1243 \
1244 product(int, AllocatePrefetchDistance, -1, \
1245 "Distance to prefetch ahead of allocation pointer. " \
1246 "-1: use system-specific value (automatically determined") \
1247 range(-1, 512) \
1248 \
1249 product(int, AllocatePrefetchLines, 3, \
1250 "Number of lines to prefetch ahead of array allocation pointer") \
1251 range(1, 64) \
1252 \
1253 product(int, AllocateInstancePrefetchLines, 1, \
1254 "Number of lines to prefetch ahead of instance allocation " \
1255 "pointer") \
1256 range(1, 64) \
1257 \
1258 product(int, AllocatePrefetchStepSize, 16, \
1259 "Step size in bytes of sequential prefetch instructions") \
1260 range(1, 512) \
1261 constraint(AllocatePrefetchStepSizeConstraintFunc,AfterMemoryInit)\
1262 \
1263 product(intx, AllocatePrefetchInstr, 0, \
1264 "Select instruction to prefetch ahead of allocation pointer") \
1265 constraint(AllocatePrefetchInstrConstraintFunc, AfterMemoryInit) \
1266 \
1267 /* deoptimization */ \
1268 product(bool, TraceDeoptimization, false, DIAGNOSTIC, \
1269 "Trace deoptimization") \
1270 \
1271 develop(bool, PrintDeoptimizationDetails, false, \
1272 "Print more information about deoptimization") \
1273 \
1274 develop(bool, DebugDeoptimization, false, \
1275 "Tracing various information while debugging deoptimization") \
1276 \
1277 product(double, SelfDestructTimer, 0.0, \
1278 "Will cause VM to terminate after a given time " \
1279 "(in fractional minutes) " \
1280 "(0.0 means off)") \
1281 range(0.0, (double)max_intx) \
1282 \
1283 product(int, MaxJavaStackTraceDepth, 1024, \
1284 "The maximum number of lines in the stack trace for Java " \
1285 "exceptions (0 means all)") \
1286 range(0, max_jint/2) \
1287 \
1288 /* notice: the max range value here is max_jint, not max_intx */ \
1289 /* because of overflow issue */ \
1290 product(intx, GuaranteedSafepointInterval, 0, DIAGNOSTIC, \
1291 "Guarantee a safepoint (at least) every so many milliseconds " \
1292 "(0 means none)") \
1293 range(0, max_jint) \
1294 \
1295 product(intx, ServiceThreadCleanupInterval, 1000, DIAGNOSTIC, \
1296 "Wake the ServiceThread to do periodic cleanup checks every so " \
1297 "many milliseconds (0 means none)") \
1298 range(0, max_jint) \
1299 \
1300 product(double, SafepointTimeoutDelay, 10000, \
1301 "Delay in milliseconds for option SafepointTimeout; " \
1302 "supports sub-millisecond resolution with fractional values.") \
1303 range(0, max_jlongDouble LP64_ONLY(/MICROUNITS)) \
1304 \
1305 product(bool, UseSystemMemoryBarrier, false, \
1306 "Try to enable system memory barrier if supported by OS") \
1307 \
1308 product(intx, NmethodSweepActivity, 4, \
1309 "Removes cold nmethods from code cache if > 0. Higher values " \
1310 "result in more aggressive sweeping") \
1311 range(0, 2000) \
1312 \
1313 develop(intx, MallocCatchPtr, -1, \
1314 "Hit breakpoint when mallocing/freeing this pointer") \
1315 \
1316 develop(int, StackPrintLimit, 100, \
1317 "number of stack frames to print in VM-level stack dump") \
1318 \
1319 product(int, ErrorLogPrintCodeLimit, 3, DIAGNOSTIC, \
1320 "max number of compiled code units to print in error log") \
1321 range(0, VMError::max_error_log_print_code) \
1322 \
1323 develop(int, MaxElementPrintSize, 256, \
1324 "maximum number of elements to print") \
1325 \
1326 develop(int, MaxStringPrintSize, 256, \
1327 "maximum number of characters to print for a java.lang.String " \
1328 "in the VM. If exceeded, an abridged version of the string is " \
1329 "printed with the middle of the string elided.") \
1330 range(2, O_BUFLEN) \
1331 \
1332 develop(intx, MaxSubklassPrintSize, 4, \
1333 "maximum number of subklasses to print when printing klass") \
1334 \
1335 develop(intx, MaxForceInlineLevel, 100, \
1336 "maximum number of nested calls that are forced for inlining " \
1337 "(using CompileCommand or marked w/ @ForceInline)") \
1338 range(0, max_jint) \
1339 \
1340 develop(intx, MethodHistogramCutoff, 100, \
1341 "The cutoff value for method invocation histogram (+CountCalls)") \
1342 \
1343 develop(intx, DeoptimizeALotInterval, 5, \
1344 "Number of exits until DeoptimizeALot kicks in") \
1345 \
1346 develop(intx, ZombieALotInterval, 5, \
1347 "Number of exits until ZombieALot kicks in") \
1348 \
1349 product(ccstr, MallocLimit, nullptr, DIAGNOSTIC, \
1350 "Limit malloc allocation size from VM. Reaching a limit will " \
1351 "trigger an action (see flag). This feature requires " \
1352 "NativeMemoryTracking=summary or NativeMemoryTracking=detail." \
1353 "Usage:" \
1354 "\"-XX:MallocLimit=<size>[:<flag>]\" sets a total limit." \
1355 "\"-XX:MallocLimit=<category>:<size>[:<flag>][,<category>:<size>[:<flag>] ...]\"" \
1356 "sets one or more category-specific limits." \
1357 "<flag> defines the action upon reaching the limit:" \
1358 "\"fatal\": end VM with a fatal error at the allocation site" \
1359 "\"oom\" : will mimic a native OOM" \
1360 "If <flag> is omitted, \"fatal\" is the default." \
1361 "Examples:\n" \
1362 "-XX:MallocLimit=2g" \
1363 "-XX:MallocLimit=2g:oom" \
1364 "-XX:MallocLimit=compiler:200m:oom,code:100m") \
1365 \
1366 product(intx, TypeProfileWidth, 2, \
1367 "Number of receiver types to record in call/cast profile") \
1368 range(0, 8) \
1369 \
1370 develop(intx, BciProfileWidth, 2, \
1371 "Number of return bci's to record in ret profile") \
1372 \
1373 product(intx, PerMethodRecompilationCutoff, 400, \
1374 "After recompiling N times, stay in the interpreter (-1=>'Inf')") \
1375 range(-1, max_intx) \
1376 \
1377 product(intx, PerBytecodeRecompilationCutoff, 200, \
1378 "Per-BCI limit on repeated recompilation (-1=>'Inf')") \
1379 range(-1, max_intx) \
1380 \
1381 product(intx, PerMethodTrapLimit, 100, \
1382 "Limit on traps (of one kind) in a method (includes inlines)") \
1383 range(0, max_jint) \
1384 \
1385 product(intx, PerMethodSpecTrapLimit, 5000, EXPERIMENTAL, \
1386 "Limit on speculative traps (of one kind) in a method " \
1387 "(includes inlines)") \
1388 range(0, max_jint) \
1389 \
1390 product(intx, PerBytecodeTrapLimit, 4, \
1391 "Limit on traps (of one kind) at a particular BCI") \
1392 range(0, max_jint) \
1393 \
1394 product(int, SpecTrapLimitExtraEntries, 3, EXPERIMENTAL, \
1395 "Extra method data trap entries for speculation") \
1396 range(0, 100) \
1397 \
1398 product(double, InlineFrequencyRatio, 0.25, DIAGNOSTIC, \
1399 "Ratio of call site execution to caller method invocation") \
1400 \
1401 product(double, MinInlineFrequencyRatio, 0.0085, DIAGNOSTIC, \
1402 "Minimum ratio of call site execution to caller method" \
1403 "invocation to be considered for inlining") \
1404 \
1405 develop(intx, InlineThrowCount, 50, \
1406 "Force inlining of interpreted methods that throw this often") \
1407 range(0, max_jint) \
1408 \
1409 develop(intx, InlineThrowMaxSize, 200, \
1410 "Force inlining of throwing methods smaller than this") \
1411 range(0, max_jint) \
1412 \
1413 product(size_t, MetaspaceSize, NOT_LP64(16 * M) LP64_ONLY(21 * M), \
1414 "Initial threshold (in bytes) at which a garbage collection " \
1415 "is done to reduce Metaspace usage") \
1416 constraint(MetaspaceSizeConstraintFunc,AfterErgo) \
1417 \
1418 product(size_t, MaxMetaspaceSize, max_uintx, \
1419 "Maximum size of Metaspaces (in bytes)") \
1420 constraint(MaxMetaspaceSizeConstraintFunc,AfterErgo) \
1421 \
1422 product(size_t, CompressedClassSpaceSize, 1*G, \
1423 "Maximum size of class area in Metaspace when compressed " \
1424 "class pointers are used") \
1425 range(1*M, LP64_ONLY(4*G) NOT_LP64(max_uintx)) \
1426 \
1427 develop(size_t, CompressedClassSpaceBaseAddress, 0, \
1428 "Force the class space to be allocated at this address or " \
1429 "fails VM initialization (requires -Xshare=off.") \
1430 \
1431 develop(bool, RandomizeClassSpaceLocation, true, \
1432 "Randomize location of class space.") \
1433 \
1434 product(bool, PrintMetaspaceStatisticsAtExit, false, DIAGNOSTIC, \
1435 "Print metaspace statistics upon VM exit.") \
1436 \
1437 product(bool, PrintCompilerMemoryStatisticsAtExit, false, DIAGNOSTIC, \
1438 "Print compiler memory statistics upon VM exit.") \
1439 \
1440 product(uintx, MinHeapFreeRatio, 40, MANAGEABLE, \
1441 "The minimum percentage of heap free after GC to avoid expansion."\
1442 " For most GCs this applies to the old generation. In G1 and" \
1443 " ParallelGC it applies to the whole heap.") \
1444 range(0, 100) \
1445 constraint(MinHeapFreeRatioConstraintFunc,AfterErgo) \
1446 \
1447 product(uintx, MaxHeapFreeRatio, 70, MANAGEABLE, \
1448 "The maximum percentage of heap free after GC to avoid shrinking."\
1449 " For most GCs this applies to the old generation. In G1 and" \
1450 " ParallelGC it applies to the whole heap.") \
1451 range(0, 100) \
1452 constraint(MaxHeapFreeRatioConstraintFunc,AfterErgo) \
1453 \
1454 product(intx, SoftRefLRUPolicyMSPerMB, 1000, \
1455 "Number of milliseconds per MB of free space in the heap") \
1456 range(0, max_intx) \
1457 constraint(SoftRefLRUPolicyMSPerMBConstraintFunc,AfterMemoryInit) \
1458 \
1459 product(size_t, MinHeapDeltaBytes, ScaleForWordSize(128*K), \
1460 "The minimum change in heap space due to GC (in bytes)") \
1461 range(0, max_uintx / 2 + 1) \
1462 \
1463 product(size_t, MinMetaspaceExpansion, ScaleForWordSize(256*K), \
1464 "The minimum expansion of Metaspace (in bytes)") \
1465 range(0, max_uintx) \
1466 \
1467 product(uint, MaxMetaspaceFreeRatio, 70, \
1468 "The maximum percentage of Metaspace free after GC to avoid " \
1469 "shrinking") \
1470 range(0, 100) \
1471 constraint(MaxMetaspaceFreeRatioConstraintFunc,AfterErgo) \
1472 \
1473 product(uint, MinMetaspaceFreeRatio, 40, \
1474 "The minimum percentage of Metaspace free after GC to avoid " \
1475 "expansion") \
1476 range(0, 99) \
1477 constraint(MinMetaspaceFreeRatioConstraintFunc,AfterErgo) \
1478 \
1479 product(size_t, MaxMetaspaceExpansion, ScaleForWordSize(4*M), \
1480 "The maximum expansion of Metaspace without full GC (in bytes)") \
1481 range(0, max_uintx) \
1482 \
1483 /* stack parameters */ \
1484 product_pd(intx, StackYellowPages, \
1485 "Number of yellow zone (recoverable overflows) pages of size " \
1486 "4KB. If pages are bigger yellow zone is aligned up.") \
1487 range(MIN_STACK_YELLOW_PAGES, (DEFAULT_STACK_YELLOW_PAGES+5)) \
1488 \
1489 product_pd(intx, StackRedPages, \
1490 "Number of red zone (unrecoverable overflows) pages of size " \
1491 "4KB. If pages are bigger red zone is aligned up.") \
1492 range(MIN_STACK_RED_PAGES, (DEFAULT_STACK_RED_PAGES+2)) \
1493 \
1494 product_pd(intx, StackReservedPages, \
1495 "Number of reserved zone (reserved to annotated methods) pages" \
1496 " of size 4KB. If pages are bigger reserved zone is aligned up.") \
1497 range(MIN_STACK_RESERVED_PAGES, (DEFAULT_STACK_RESERVED_PAGES+10))\
1498 \
1499 product(bool, RestrictReservedStack, true, \
1500 "Restrict @ReservedStackAccess to trusted classes") \
1501 \
1502 /* greater stack shadow pages can't generate instruction to bang stack */ \
1503 product_pd(intx, StackShadowPages, \
1504 "Number of shadow zone (for overflow checking) pages of size " \
1505 "4KB. If pages are bigger shadow zone is aligned up. " \
1506 "This should exceed the depth of the VM and native call stack.") \
1507 range(MIN_STACK_SHADOW_PAGES, (DEFAULT_STACK_SHADOW_PAGES+30)) \
1508 \
1509 product_pd(intx, ThreadStackSize, \
1510 "Thread Stack Size (in Kbytes)") \
1511 range(0, 1 * M) \
1512 \
1513 product_pd(intx, VMThreadStackSize, \
1514 "Non-Java Thread Stack Size (in Kbytes)") \
1515 range(0, max_intx/(1 * K)) \
1516 \
1517 product_pd(intx, CompilerThreadStackSize, \
1518 "Compiler Thread Stack Size (in Kbytes)") \
1519 range(0, max_intx/(1 * K)) \
1520 \
1521 develop_pd(size_t, JVMInvokeMethodSlack, \
1522 "Stack space (bytes) required for JVM_InvokeMethod to complete") \
1523 \
1524 /* code cache parameters */ \
1525 product_pd(size_t, CodeCacheSegmentSize, EXPERIMENTAL, \
1526 "Code cache segment size (in bytes) - smallest unit of " \
1527 "allocation") \
1528 range(1, 1024) \
1529 constraint(CodeCacheSegmentSizeConstraintFunc, AfterErgo) \
1530 \
1531 product_pd(uint, CodeEntryAlignment, EXPERIMENTAL, \
1532 "Code entry alignment for generated code" \
1533 " (in bytes, power of two)") \
1534 constraint(CodeEntryAlignmentConstraintFunc, AfterErgo) \
1535 \
1536 product_pd(intx, OptoLoopAlignment, \
1537 "Align inner loops to zero relative to this modulus") \
1538 range(1, 128) \
1539 constraint(OptoLoopAlignmentConstraintFunc, AfterErgo) \
1540 \
1541 product_pd(size_t, InitialCodeCacheSize, \
1542 "Initial code cache size (in bytes)") \
1543 constraint(VMPageSizeConstraintFunc, AtParse) \
1544 \
1545 develop_pd(size_t, CodeCacheMinimumUseSpace, \
1546 "Minimum code cache size (in bytes) required to start VM.") \
1547 range(0, SIZE_MAX) \
1548 \
1549 product(bool, SegmentedCodeCache, false, \
1550 "Use a segmented code cache") \
1551 \
1552 product_pd(size_t, ReservedCodeCacheSize, \
1553 "Reserved code cache size (in bytes) - maximum code cache size") \
1554 constraint(VMPageSizeConstraintFunc, AtParse) \
1555 \
1556 product_pd(size_t, NonProfiledCodeHeapSize, \
1557 "Size of code heap with non-profiled methods (in bytes)") \
1558 range(0, SIZE_MAX) \
1559 \
1560 product_pd(size_t, ProfiledCodeHeapSize, \
1561 "Size of code heap with profiled methods (in bytes)") \
1562 range(0, SIZE_MAX) \
1563 \
1564 product_pd(size_t, NonNMethodCodeHeapSize, \
1565 "Size of code heap with non-nmethods (in bytes)") \
1566 constraint(VMPageSizeConstraintFunc, AtParse) \
1567 \
1568 product(size_t, HotCodeHeapSize, 0, EXPERIMENTAL, \
1569 "Size of code heap with predicted hot methods (in bytes)") \
1570 range(0, SIZE_MAX) \
1571 \
1572 product_pd(size_t, CodeCacheExpansionSize, \
1573 "Code cache expansion size (in bytes)") \
1574 range(32*K, SIZE_MAX) \
1575 \
1576 product_pd(size_t, CodeCacheMinBlockLength, DIAGNOSTIC, \
1577 "Minimum number of segments in a code cache block") \
1578 range(1, 100) \
1579 \
1580 develop(bool, ExitOnFullCodeCache, false, \
1581 "Exit the VM if we fill the code cache") \
1582 \
1583 product(bool, UseCodeCacheFlushing, true, \
1584 "Remove cold/old nmethods from the code cache") \
1585 \
1586 product(double, SweeperThreshold, 15.0, \
1587 "Threshold when a code cache unloading GC is invoked." \
1588 "Value is percentage of ReservedCodeCacheSize.") \
1589 range(0.0, 100.0) \
1590 \
1591 product(uintx, StartAggressiveSweepingAt, 10, \
1592 "Start aggressive sweeping if less than X[%] of the total code cache is free.")\
1593 range(0, 100) \
1594 \
1595 product(bool, NMethodRelocation, false, EXPERIMENTAL, \
1596 "Enables use of experimental function nmethod::relocate()") \
1597 \
1598 /* interpreter debugging */ \
1599 develop(intx, BinarySwitchThreshold, 5, \
1600 "Minimal number of lookupswitch entries for rewriting to binary " \
1601 "switch") \
1602 \
1603 develop(uintx, StopInterpreterAt, 0, \
1604 "Stop interpreter execution at specified bytecode number") \
1605 \
1606 develop(uintx, TraceBytecodesAt, 0, \
1607 "Trace bytecodes starting with specified bytecode number") \
1608 \
1609 develop(uintx, TraceBytecodesStopAt, 0, \
1610 "Stop bytecode tracing at the specified bytecode number") \
1611 \
1612 /* Priorities */ \
1613 product_pd(bool, UseThreadPriorities, "Use native thread priorities") \
1614 \
1615 product(int, ThreadPriorityPolicy, 0, \
1616 "0 : Normal. "\
1617 " VM chooses priorities that are appropriate for normal "\
1618 " applications. "\
1619 " On Windows applications are allowed to use higher native "\
1620 " priorities. However, with ThreadPriorityPolicy=0, VM will "\
1621 " not use the highest possible native priority, "\
1622 " THREAD_PRIORITY_TIME_CRITICAL, as it may interfere with "\
1623 " system threads. On Linux thread priorities are ignored "\
1624 " because the OS does not support static priority in "\
1625 " SCHED_OTHER scheduling class which is the only choice for "\
1626 " non-root, non-realtime applications. "\
1627 "1 : Aggressive. "\
1628 " Java thread priorities map over to the entire range of "\
1629 " native thread priorities. Higher Java thread priorities map "\
1630 " to higher native thread priorities. This policy should be "\
1631 " used with care, as sometimes it can cause performance "\
1632 " degradation in the application and/or the entire system. On "\
1633 " Linux/BSD/macOS this policy requires root privilege or an "\
1634 " extended capability.") \
1635 range(0, 1) \
1636 \
1637 product(bool, ThreadPriorityVerbose, false, \
1638 "Print priority changes") \
1639 \
1640 product(int, CompilerThreadPriority, -1, \
1641 "The native priority at which compiler threads should run " \
1642 "(-1 means no change)") \
1643 range(min_jint, max_jint) \
1644 \
1645 product(int, VMThreadPriority, -1, \
1646 "The native priority at which the VM thread should run " \
1647 "(-1 means no change)") \
1648 range(min_jint, max_jint) \
1649 \
1650 product(int, JavaPriority1_To_OSPriority, -1, \
1651 "Map Java priorities to OS priorities") \
1652 range(min_jint, max_jint) \
1653 \
1654 product(int, JavaPriority2_To_OSPriority, -1, \
1655 "Map Java priorities to OS priorities") \
1656 range(min_jint, max_jint) \
1657 \
1658 product(int, JavaPriority3_To_OSPriority, -1, \
1659 "Map Java priorities to OS priorities") \
1660 range(min_jint, max_jint) \
1661 \
1662 product(int, JavaPriority4_To_OSPriority, -1, \
1663 "Map Java priorities to OS priorities") \
1664 range(min_jint, max_jint) \
1665 \
1666 product(int, JavaPriority5_To_OSPriority, -1, \
1667 "Map Java priorities to OS priorities") \
1668 range(min_jint, max_jint) \
1669 \
1670 product(int, JavaPriority6_To_OSPriority, -1, \
1671 "Map Java priorities to OS priorities") \
1672 range(min_jint, max_jint) \
1673 \
1674 product(int, JavaPriority7_To_OSPriority, -1, \
1675 "Map Java priorities to OS priorities") \
1676 range(min_jint, max_jint) \
1677 \
1678 product(int, JavaPriority8_To_OSPriority, -1, \
1679 "Map Java priorities to OS priorities") \
1680 range(min_jint, max_jint) \
1681 \
1682 product(int, JavaPriority9_To_OSPriority, -1, \
1683 "Map Java priorities to OS priorities") \
1684 range(min_jint, max_jint) \
1685 \
1686 product(int, JavaPriority10_To_OSPriority,-1, \
1687 "Map Java priorities to OS priorities") \
1688 range(min_jint, max_jint) \
1689 \
1690 product(bool, UseCriticalJavaThreadPriority, false, EXPERIMENTAL, \
1691 "Java thread priority 10 maps to critical scheduling priority") \
1692 \
1693 product(bool, UseCriticalCompilerThreadPriority, false, EXPERIMENTAL, \
1694 "Compiler thread(s) run at critical scheduling priority") \
1695 \
1696 develop(intx, NewCodeParameter, 0, \
1697 "Testing Only: Create a dedicated integer parameter before " \
1698 "putback") \
1699 \
1700 /* new oopmap storage allocation */ \
1701 develop(int, MinOopMapAllocation, 8, \
1702 "Minimum number of OopMap entries in an OopMapSet") \
1703 range(0, max_jint) \
1704 \
1705 /* recompilation */ \
1706 product_pd(intx, CompileThreshold, \
1707 "number of interpreted method invocations before (re-)compiling") \
1708 constraint(CompileThresholdConstraintFunc, AfterErgo) \
1709 \
1710 product_pd(bool, TieredCompilation, \
1711 "Enable tiered compilation") \
1712 \
1713 /* Properties for Java libraries */ \
1714 \
1715 product(uint64_t, MaxDirectMemorySize, 0, \
1716 "Maximum total size of NIO direct-buffer allocations. " \
1717 "Ignored if not explicitly set.") \
1718 range(0, max_jlong) \
1719 \
1720 /* Flags used for temporary code during development */ \
1721 \
1722 product(bool, UseNewCode, false, DIAGNOSTIC, \
1723 "Testing Only: Use the new version while testing") \
1724 \
1725 product(bool, UseNewCode2, false, DIAGNOSTIC, \
1726 "Testing Only: Use the new version while testing") \
1727 \
1728 product(bool, UseNewCode3, false, DIAGNOSTIC, \
1729 "Testing Only: Use the new version while testing") \
1730 \
1731 develop(bool, UseDebuggerErgo, false, \
1732 "Debugging Only: Adjust the VM to be more debugger-friendly. " \
1733 "Turns on the other UseDebuggerErgo* flags") \
1734 \
1735 develop(bool, UseDebuggerErgo1, false, \
1736 "Debugging Only: Enable workarounds for debugger induced " \
1737 "os::processor_id() >= os::processor_count() problems") \
1738 \
1739 develop(bool, UseDebuggerErgo2, false, \
1740 "Debugging Only: Limit the number of spawned JVM threads") \
1741 \
1742 develop(bool, EnableJVMTIStackDepthAsserts, true, \
1743 "Enable JVMTI asserts related to stack depth checks") \
1744 \
1745 /* flags for performance data collection */ \
1746 \
1747 product(bool, UsePerfData, true, \
1748 "Flag to disable jvmstat instrumentation for performance testing "\
1749 "and problem isolation purposes") \
1750 \
1751 product(bool, PerfDataSaveToFile, false, \
1752 "Save PerfData memory to hsperfdata_<pid> file on exit") \
1753 \
1754 product(ccstr, PerfDataSaveFile, nullptr, \
1755 "Save PerfData memory to the specified absolute pathname. " \
1756 "The string %p in the file name (if present) " \
1757 "will be replaced by pid") \
1758 \
1759 product(bool, PerfDisableSharedMem, false, \
1760 "Store performance data in standard memory") \
1761 \
1762 product(int, PerfDataMemorySize, 32*K, \
1763 "Size of performance data memory region. Will be rounded " \
1764 "up to a multiple of the native os page size.") \
1765 range(128, 32*64*K) \
1766 \
1767 product(int, PerfMaxStringConstLength, 1024, \
1768 "Maximum PerfStringConstant string length before truncation") \
1769 range(32, 32*K) \
1770 \
1771 product(bool, PerfAllowAtExitRegistration, false, \
1772 "Allow registration of atexit() methods") \
1773 \
1774 product(bool, PerfBypassFileSystemCheck, false, \
1775 "Bypass Win32 file system criteria checks (Windows Only)") \
1776 \
1777 product(int, UnguardOnExecutionViolation, 0, \
1778 "Unguard page and retry on no-execute fault (Win32 only) " \
1779 "0=off, 1=conservative, 2=aggressive") \
1780 range(0, 2) \
1781 \
1782 /* Serviceability Support */ \
1783 \
1784 product(bool, ManagementServer, false, \
1785 "Create JMX Management Server") \
1786 \
1787 product(bool, DisableAttachMechanism, false, \
1788 "Disable mechanism that allows tools to attach to this VM") \
1789 \
1790 product(bool, StartAttachListener, false, \
1791 "Always start Attach Listener at VM startup") \
1792 \
1793 product(bool, EnableDynamicAgentLoading, true, \
1794 "Allow tools to load agents with the attach mechanism") \
1795 \
1796 product(bool, PrintConcurrentLocks, false, MANAGEABLE, \
1797 "Print java.util.concurrent locks in thread dump") \
1798 \
1799 product(bool, PrintMethodHandleStubs, false, DIAGNOSTIC, \
1800 "Print generated stub code for method handles") \
1801 \
1802 product(bool, VerifyMethodHandles, trueInDebug, DIAGNOSTIC, \
1803 "perform extra checks when constructing method handles") \
1804 \
1805 product(bool, IgnoreAssertUnsetFields, false, DIAGNOSTIC, \
1806 "Ignore assert_unset_fields") \
1807 \
1808 product(bool, ShowHiddenFrames, false, DIAGNOSTIC, \
1809 "show method handle implementation frames (usually hidden)") \
1810 \
1811 product(bool, ShowCarrierFrames, false, DIAGNOSTIC, \
1812 "show virtual threads' carrier frames in exceptions") \
1813 \
1814 product(bool, TrustFinalNonStaticFields, false, EXPERIMENTAL, \
1815 "trust final non-static declarations for constant folding") \
1816 \
1817 product(bool, FoldStableValues, true, DIAGNOSTIC, \
1818 "Optimize loads from stable fields (marked w/ @Stable)") \
1819 \
1820 product(int, UseBootstrapCallInfo, 1, DIAGNOSTIC, \
1821 "0: when resolving InDy or ConDy, force all BSM arguments to be " \
1822 "resolved before the bootstrap method is called; 1: when a BSM " \
1823 "that may accept a BootstrapCallInfo is detected, use that API " \
1824 "to pass BSM arguments, which allows the BSM to delay their " \
1825 "resolution; 2+: stress test the BCI API by calling more BSMs " \
1826 "via that API, instead of with the eagerly-resolved array.") \
1827 \
1828 product(bool, PauseAtStartup, false, DIAGNOSTIC, \
1829 "Causes the VM to pause at startup time and wait for the pause " \
1830 "file to be removed (default: ./vm.paused.<pid>)") \
1831 \
1832 product(ccstr, PauseAtStartupFile, nullptr, DIAGNOSTIC, \
1833 "The file to create and for whose removal to await when pausing " \
1834 "at startup. (default: ./vm.paused.<pid>)") \
1835 \
1836 product(bool, PauseAtExit, false, DIAGNOSTIC, \
1837 "Pause and wait for keypress on exit if a debugger is attached") \
1838 \
1839 product(bool, DTraceMethodProbes, false, \
1840 "Enable dtrace tool probes for method-entry and method-exit") \
1841 \
1842 product(bool, DTraceAllocProbes, false, \
1843 "Enable dtrace tool probes for object allocation") \
1844 \
1845 product(bool, DTraceMonitorProbes, false, \
1846 "Enable dtrace tool probes for monitor events") \
1847 \
1848 product(bool, RelaxAccessControlCheck, false, \
1849 "Relax the access control checks in the verifier") \
1850 \
1851 product(uintx, StringTableSize, defaultStringTableSize, \
1852 "Number of buckets in the interned String table " \
1853 "(will be rounded to nearest higher power of 2)") \
1854 range(minimumStringTableSize, 16777216ul /* 2^24 */) \
1855 \
1856 product(uintx, SymbolTableSize, defaultSymbolTableSize, EXPERIMENTAL, \
1857 "Number of buckets in the JVM internal Symbol table") \
1858 range(minimumSymbolTableSize, 16777216ul /* 2^24 */) \
1859 \
1860 product(bool, UseStringDeduplication, false, \
1861 "Use string deduplication") \
1862 \
1863 product(uint, StringDeduplicationAgeThreshold, 3, \
1864 "A string must reach this age (or be promoted to an old region) " \
1865 "to be considered for deduplication") \
1866 range(1, markWord::max_age) \
1867 \
1868 product(size_t, StringDeduplicationInitialTableSize, 500, EXPERIMENTAL, \
1869 "Approximate initial number of buckets in the table") \
1870 range(1, 1 * G) \
1871 \
1872 product(double, StringDeduplicationGrowTableLoad, 14.0, EXPERIMENTAL, \
1873 "Entries per bucket above which the table should be expanded") \
1874 range(0.1, 1000.0) \
1875 \
1876 product(double, StringDeduplicationShrinkTableLoad, 1.0, EXPERIMENTAL, \
1877 "Entries per bucket below which the table should be shrunk") \
1878 range(0.01, 100.0) \
1879 \
1880 product(double, StringDeduplicationTargetTableLoad, 7.0, EXPERIMENTAL, \
1881 "Desired entries per bucket when resizing the table") \
1882 range(0.01, 1000.0) \
1883 \
1884 product(size_t, StringDeduplicationCleanupDeadMinimum, 100, EXPERIMENTAL, \
1885 "Minimum number of dead table entries for cleaning the table") \
1886 \
1887 product(int, StringDeduplicationCleanupDeadPercent, 5, EXPERIMENTAL, \
1888 "Minimum percentage of dead table entries for cleaning the table") \
1889 range(1, 100) \
1890 \
1891 product(bool, StringDeduplicationResizeALot, false, DIAGNOSTIC, \
1892 "Force more frequent table resizing") \
1893 \
1894 product(uint64_t, StringDeduplicationHashSeed, 0, DIAGNOSTIC, \
1895 "Seed for the table hashing function; 0 requests computed seed") \
1896 \
1897 product(bool, WhiteBoxAPI, false, DIAGNOSTIC, \
1898 "Enable internal testing APIs") \
1899 \
1900 product(bool, UseUnalignedAccesses, false, DIAGNOSTIC, \
1901 "Use unaligned memory accesses in Unsafe") \
1902 \
1903 product_pd(bool, PreserveFramePointer, \
1904 "Use the FP register for holding the frame pointer " \
1905 "and not as a general purpose register.") \
1906 \
1907 product(size_t, AsyncLogBufferSize, 2*M, \
1908 "Memory budget (in bytes) for the buffer of Asynchronous " \
1909 "Logging (-Xlog:async).") \
1910 range(DEBUG_ONLY(192) NOT_DEBUG(100*K), 50*M) \
1911 \
1912 product(bool, CheckIntrinsics, true, DIAGNOSTIC, \
1913 "When a class C is loaded, check that " \
1914 "(1) all intrinsics defined by the VM for class C are present "\
1915 "in the loaded class file and are marked with the " \
1916 "@IntrinsicCandidate annotation, that " \
1917 "(2) there is an intrinsic registered for all loaded methods " \
1918 "that are annotated with the @IntrinsicCandidate annotation, " \
1919 "and that " \
1920 "(3) no orphan methods exist for class C (i.e., methods for " \
1921 "which the VM declares an intrinsic but that are not declared "\
1922 "in the loaded class C. " \
1923 "Check (3) is available only in debug builds.") \
1924 \
1925 product_pd(intx, InitArrayShortSize, DIAGNOSTIC, \
1926 "Threshold small size (in bytes) for clearing arrays. " \
1927 "Anything this size or smaller may get converted to discrete " \
1928 "scalar stores.") \
1929 range(0, max_intx) \
1930 constraint(InitArrayShortSizeConstraintFunc, AfterErgo) \
1931 \
1932 product(ccstr, AllocateHeapAt, nullptr, \
1933 "Path to the directory where a temporary file will be created " \
1934 "to use as the backing store for Java Heap.") \
1935 \
1936 product_pd(bool, VMContinuations, EXPERIMENTAL, \
1937 "Enable VM continuations support") \
1938 \
1939 develop(bool, LoomDeoptAfterThaw, false, \
1940 "Deopt stack after thaw") \
1941 \
1942 develop(bool, LoomVerifyAfterThaw, false, \
1943 "Verify stack after thaw") \
1944 \
1945 develop(bool, VerifyContinuations, false, \
1946 "Verify continuation consistency") \
1947 \
1948 develop(bool, UseContinuationFastPath, true, \
1949 "Use fast-path frame walking in continuations") \
1950 \
1951 develop(bool, ForceSingleFrameThaw, false, \
1952 "Force thawing one frame at a time") \
1953 \
1954 develop(int, VerifyMetaspaceInterval, DEBUG_ONLY(500) NOT_DEBUG(0), \
1955 "Run periodic metaspace verifications (0 - none, " \
1956 "1 - always, >1 every nth interval)") \
1957 \
1958 product(bool, ShowRegistersOnAssert, true, DIAGNOSTIC, \
1959 "On internal errors, include registers in error report.") \
1960 \
1961 product(bool, UseSwitchProfiling, true, DIAGNOSTIC, \
1962 "leverage profiling for table/lookup switch") \
1963 \
1964 develop(bool, TraceMemoryWriteback, false, \
1965 "Trace memory writeback operations") \
1966 \
1967 JFR_ONLY(product(bool, FlightRecorder, false, \
1968 "(Deprecated) Enable Flight Recorder")) \
1969 \
1970 JFR_ONLY(product(ccstr, FlightRecorderOptions, nullptr, \
1971 "Flight Recorder options")) \
1972 \
1973 JFR_ONLY(product(ccstr, StartFlightRecording, nullptr, \
1974 "Start flight recording with options")) \
1975 \
1976 product(bool, UseFastUnorderedTimeStamps, false, EXPERIMENTAL, \
1977 "Use platform unstable time where supported for timestamps only") \
1978 \
1979 product_pd(bool, InlineTypePassFieldsAsArgs, DIAGNOSTIC, \
1980 "Pass each inline type field as an argument at calls") \
1981 \
1982 product_pd(bool, InlineTypeReturnedAsFields, DIAGNOSTIC, \
1983 "Return fields instead of an inline type reference") \
1984 \
1985 develop(bool, StressCallingConvention, false, \
1986 "Stress the scalarized calling convention.") \
1987 \
1988 develop(bool, PreloadClasses, true, \
1989 "Preloading all classes from the LoadableDescriptors attribute") \
1990 \
1991 product(ccstrlist, ForceNonTearable, "", DIAGNOSTIC, \
1992 "List of inline classes which are forced to be atomic " \
1993 "(whitespace and commas separate names, " \
1994 "and leading and trailing stars '*' are wildcards)") \
1995 \
1996 product(bool, DeoptimizeNMethodBarriersALot, false, DIAGNOSTIC, \
1997 "Make nmethod barriers deoptimise a lot.") \
1998 \
1999 develop(bool, VerifyCrossModifyFence, \
2000 false AARCH64_ONLY(DEBUG_ONLY(||true)), \
2001 "Mark all threads after a safepoint, and clear on a modify " \
2002 "fence. Add cleanliness checks.") \
2003 \
2004 product(bool, UseObjectMonitorTable, true, DIAGNOSTIC, \
2005 "Use a table to record inflated monitors rather than the first " \
2006 "word of the object.") \
2007 \
2008 product(int, FastLockingSpins, 8, DIAGNOSTIC, \
2009 "Specifies the number of times fast locking will attempt to " \
2010 "CAS the markWord before inflating. Between each CAS it will " \
2011 "spin for exponentially more time, resulting in a total number " \
2012 "of spins on the order of O(2^value)") \
2013 range(1, 30) \
2014 \
2015 product(uint, TrimNativeHeapInterval, 0, \
2016 "Interval, in ms, at which the JVM will trim the native heap if " \
2017 "the platform supports that. Lower values will reclaim memory " \
2018 "more eagerly at the cost of higher overhead. A value of 0 " \
2019 "(default) disables native heap trimming.") \
2020 range(0, UINT_MAX) \
2021 \
2022 develop(bool, SimulateFullAddressSpace, false, \
2023 "Simulates a very populated, fragmented address space; no " \
2024 "targeted reservations will succeed.") \
2025 \
2026 product(bool, ProfileExceptionHandlers, true, \
2027 "Profile exception handlers") \
2028 \
2029 product(bool, AlwaysRecordEvolDependencies, true, EXPERIMENTAL, \
2030 "Unconditionally record nmethod dependencies on class " \
2031 "rewriting/transformation independently of the JVMTI " \
2032 "can_{retransform/redefine}_classes capabilities.") \
2033 \
2034 product(bool, UseSecondarySupersCache, true, DIAGNOSTIC, \
2035 "Use secondary supers cache during subtype checks.") \
2036 \
2037 product(bool, UseSecondarySupersTable, false, DIAGNOSTIC, \
2038 "Use hash table to lookup secondary supers.") \
2039 \
2040 product(bool, VerifySecondarySupers, false, DIAGNOSTIC, \
2041 "Check that linear and hashed secondary lookups return the same result.") \
2042 \
2043 product(bool, StressSecondarySupers, false, DIAGNOSTIC, \
2044 "Use a terrible hash function in order to generate many collisions.") \
2045 \
2046 product(bool, UseThreadsLockThrottleLock, true, DIAGNOSTIC, \
2047 "Use an extra lock during Thread start and exit to alleviate" \
2048 "contention on Threads_lock.") \
2049 \
2050 develop(uint, BinarySearchThreshold, 16, \
2051 "Minimal number of elements in a sorted collection to prefer" \
2052 "binary search over simple linear search." ) \
2053 \
2054 product(bool, UseAcmpFastPath, true, DIAGNOSTIC, \
2055 "Use fast path for acmp.") \
2056
2057 // end of RUNTIME_FLAGS
2058
2059 DECLARE_FLAGS(LP64_RUNTIME_FLAGS)
2060 DECLARE_ARCH_FLAGS(ARCH_FLAGS)
2061 DECLARE_FLAGS(RUNTIME_FLAGS)
2062 DECLARE_FLAGS(RUNTIME_OS_FLAGS)
2063
2064 #endif // SHARE_RUNTIME_GLOBALS_HPP