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