AOTInliningDepthToSizeRate | Double | 2.5 | |
AOTInliningSizeMaximum | Integer | 300 | |
AOTInliningSizeMinimum | Integer | 50 | |
AOTVerifyOops | Boolean | false | Generate verify oop checks in AOT code
|
ASMInstructionProfiling | String | null | Enables instruction profiling on assembler level. Valid values are a
comma separated list of supported instructions. Compare with subclasses
of Assembler.InstructionCounter.
|
AbortOnBenchmarkCounterOverflow | Boolean | false | Abort VM with SIGILL if benchmark counters controlled by the
(Generic|Timed|Benchmark)DynamicCounters
option overflow. This feature is only supported on AMD64.
WARNING: No descriptive error message will be printed! In case of an overflow,
manual inspection of the emitted code is required.
|
ActiveProcessorCount | Integer | -1 | Overwrites the available number of processors provided by the OS. Any
value <= 0 means using the processor count from the OS.
|
AggregatedMetricsFile | String | null | File to which aggregated metrics are dumped at shutdown. A CSV format
is used if the file ends with .csv otherwise a more human readable
format is used. If not specified, metrics are dumped to the console.
|
AliasArrayTypeFlows | Boolean | true | Model all array type flows using a unique elements type flow
abstraction.
|
AllocationProfilingThreshold | Integer | 1048576 | The minimum size in bytes required for printing an allocation profiling
entry
|
AllocationSiteSensitiveHeap | Boolean | false | A context sensitive heap means that each heap allocated object is
modeled by using at least the allocation site.
|
AlwaysInlineIntrinsics | Boolean | false | Unconditionally inline intrinsics
|
AlwaysInlineVTableStubs | Boolean | false | |
AnalysisContextSensitivity | String | "insens" | Controls the static analysis context sensitivity. Available values:
insens (context insensitive analysis), allocsens (context insensitive
analysis, context insensitive heap, allocation site sensitive heap),
_1obj (1 object sensitive analysis with a context insensitive heap),
_2obj1h (2 object sensitive with a 1 context sensitive heap)
|
AnalysisSizeCutoff | Integer | 8 | The maximum size of type and method profiles returned by the static
analysis. -1 indicates no limitation.
|
AnalysisStatisticsFile | String | null | Analysis results statistics file.
|
AuditHandles | Boolean | false | Record stack trace along with scoped foreign object reference wrappers to debug issue with a wrapper being used after its scope has closed.
|
BenchmarkCounterPrintingCutoff | Boolean | true | Use a cutoff to print only most significant counters.
|
BenchmarkCountersDumpDynamic | Boolean | true | Dump dynamic counters
|
BenchmarkCountersDumpStatic | Boolean | false | Dump static counters
|
BenchmarkCountersFile | String | null | File to which benchmark counters are dumped. A CSV format is used if
the file ends with .csv otherwise a more human readable format is used.
The fields in the CSV format are: category, group, name, value
|
BenchmarkDynamicCounters | String | null | Turn on the benchmark counters. The format of this option is:
(err|out),start pattern,end pattern
Start counting when the start pattern matches on the given stream and stop when the end pattern occurs.
You can use "~" to match 1 or more digits.
Examples:
err, starting =====, PASSED in
out,Iteration ~ (~s) begins:,Iteration ~ (~s) ends:
The first pattern matches DaCapo output and the second matches SPECjvm2008 output.
As a more detailed example, here are the options to use for getting statistics
about allocations within the DaCapo pmd benchmark:
-XX:JVMCICounterSize= -XX:-JVMCICountersExcludeCompiler \
-Dgraal.BenchmarkDynamicCounters="err, starting ====, PASSED in " \
-Dgraal.ProfileAllocations=true
The JVMCICounterSize value depends on the granularity of the profiling -
10000 should be sufficient. Omit JVMCICountersExcludeCompiler to exclude
counting allocations on the compiler threads.
The counters can be further configured by the ProfileAllocationsContext option.
We highly recommend the use of -Dgraal.AbortOnBenchmarkCounterOverflow=true to
detect counter overflows eagerly.
|
BootstrapInitializeOnly | Boolean | false | Do not compile anything on bootstrap but just initialize the compiler.
|
BootstrapTimeout | Double | 15.0 | Maximum time in minutes to spend bootstrapping (0 to disable this
limit).
|
BootstrapWatchDogCriticalRateRatio | Double | 0.25 | Ratio of the maximum compilation rate below which the bootstrap
compilation rate must not fall (0 or less disables monitoring).
|
CanOmitFrame | Boolean | true | |
CanonicalGraphStringsCheckConstants | Boolean | false | Exclude virtual nodes when dumping canonical text for graphs.
|
CanonicalGraphStringsExcludeVirtuals | Boolean | true | Exclude virtual nodes when dumping canonical text for graphs.
|
CanonicalGraphStringsRemoveIdentities | Boolean | true | Attempts to remove object identity hashes when dumping canonical text
for graphs.
|
ClearMetricsAfterBootstrap | Boolean | false | Clear the debug metrics after bootstrap.
|
CollectYoungGenerationSeparately | Boolean | false | Determines if a full GC collects the young generation separately or
together with the old generation.
|
CompilationBailoutAsFailure | Boolean | false | Treat compilation bailouts like compilation failures.
|
CompilationCountLimit | Integer | 0 | The number of compilations allowed for any method before the VM exits
(a value of 0 means there is no limit).
|
CompilationExcludePhases | String | null | Exclude certain phases from compilation, either unconditionally or with
a method filter
|
CompilationExpirationPeriod | Integer | 300 | Time limit in seconds before a compilation expires (0 to disable the
limit). A non-zero value for this option is doubled if assertions are
enabled and quadrupled if DetailedAsserts is true.
|
CompilationFailureAction | String | Silent | Specifies the action to take when compilation fails.
The accepted values are:
Silent - Print nothing to the console.
Print - Print a stack trace to the console.
Diagnose* - Retry the compilation with extra diagnostics.
ExitVM - Same as Diagnose except that the VM process exits after retrying.
* If "Diagnose" is set compilation will be retried with extra diagnostics enabled including dumping (see file:doc-files/DumpHelp.txt).
In such a scenario DiagnoseDumpLevel can be used to specify the dump level (DebugContext dump levels) accordingly.
|
CompilationIsolateAddressSpaceSize | Long | 0 | Size of the reserved address space of each compilation isolate (0:
default for new isolates).
|
CompilationWatchDogStackTraceInterval | Double | 60.0 | Interval in seconds between a watch dog reporting stack traces for long
running compilations.
|
CompilationWatchDogStartDelay | Double | 0.0 | Delay in seconds before watch dog monitoring a compilation (0 disables
monitoring).
|
CompileGraalWithC1Only | Boolean | true | In tiered mode compile Graal and JVMCI using optimized first tier code.
|
CompileInIsolates | Boolean | true | Activate runtime compilation in separate isolates (enable support
during image build with option SupportCompileInIsolates).
|
CompilerConfiguration | String | null | Names the compiler configuration to use. If omitted, the compiler
configuration with the highest auto-selection priority is used. To see
the set of available configurations, supply the value 'help' to this
option.
|
Compiler | String | null | Selects the system compiler. This must match the getCompilerName() value returned by a jdk.vm.ci.runtime.JVMCICompilerFactory provider. An empty string or the value "null" selects a compiler that will raise an exception upon receiving a compilation request.
|
ConditionalEliminationMaxIterations | Integer | 4 | |
ConditionalElimination | Boolean | true | |
Count | String | null | Pattern for specifying scopes in which counters are enabled. See the
Dump option for the pattern syntax. An empty value enables all counters
unconditionally.
|
Counters | String | null | Comma separated names of counters that are enabled irrespective of the
value for Count option. An empty value enables all counters
unconditionally.
|
CrashAtIsFatal | Boolean | false | Converts an exception triggered by the CrashAt option into a fatal
error if a non-null pointer was passed in the _fatal option to
JNI_CreateJavaVM. This option exists for the purpose of testing fatal
error handling in libgraal.
|
CrashAt | String | null | Pattern for method(s) that will trigger an exception when compiled.
This option exists to test handling compilation crashes gracefully. See
the MethodFilter option for the pattern syntax. A ':Bailout' suffix
will raise a bailout exception and a ':PermanentBailout' suffix will
raise a permanent bailout exception.
|
DebugStubsAndSnippets | Boolean | false | Enable debug output for stub code generation and snippet preparation.
|
DeoptALot | Boolean | false | |
DeoptAfterOSR | Boolean | true | Deoptimize OSR compiled code when the OSR entry loop is finished if
there is no mature profile available for the rest of the method.
|
DeoptsToDisableOptimisticOptimization | Integer | 40 | |
DetailedAsserts | Boolean | false | Enable expensive assertions if normal assertions (i.e. -ea or -esa) are
enabled.
|
DiagnoseDumpLevel | Integer | 3 | Specify the DumpLevel if CompilationFailureAction#Diagnose is used.See
CompilationFailureAction for details.
file:doc-files/CompilationFailureActionHelp.txt
|
DisableExplicitGC | Boolean | false | Ignore calls to System.gc()
|
DisableIntercept | Boolean | false | Disable intercepting exceptions in debug scopes.
|
DivertParameterReturningMethod | Boolean | true | Analysis: Detect methods that return one of their parameters and
hardwire the parameter straight to the return.
|
DumpAfterEveryBCI | Boolean | false | Dump the current graph after every bci to IGV.
|
DumpOnError | Boolean | false | Send compiler IR to dump handlers on error.
|
DumpOnPhaseChange | String | null | Dump a before and after graph if the named phase changes the
graph.%nThe argument is substring matched against the simple name of
the phase class
|
DumpPath | String | "graal_dumps" | The directory where various Graal dump files are written.
|
Dump | String | null | Filter pattern for specifying scopes in which dumping is enabled.
A filter is a list of comma-separated terms of the form:
[:]
If contains a "*" or "?" character, it is interpreted as a glob pattern.
Otherwise, it is interpreted as a substring. If is empty, it
matches every scope. If : is omitted, it defaults to 1. The term
~ is a shorthand for :0 to disable a debug facility for a pattern.
The default log level is 0 (disabled). Terms with an empty pattern set
the default log level to the specified value. The last
matching term with a non-empty pattern selects the level specified. If
no term matches, the log level is the default level. A filter with no
terms matches every scope with a log level of 1.
Examples of debug filters:
---------
(empty string)
Matches any scope with level 1.
---------
:1
Matches any scope with level 1.
---------
*
Matches any scope with level 1.
---------
CodeGen,CodeInstall
Matches scopes containing "CodeGen" or "CodeInstall", both with level 1.
---------
CodeGen:2,CodeInstall:1
Matches scopes containing "CodeGen" with level 2, or "CodeInstall" with level 1.
---------
Outer:2,Inner:0}
Matches scopes containing "Outer" with log level 2, or "Inner" with log level 0. If the scope
name contains both patterns then the log level will be 0. This is useful for silencing subscopes.
---------
:1,Dead:2
Matches scopes containing "Dead" with level 2, and all other scopes with level 1.
---------
Dead:0,:1
Matches all scopes with level 1, except those containing "Dead". Note that the location of
the :1 doesn't matter since it's specifying the default log level so it's the same as
specifying :1,Dead:0.
---------
Code*
Matches scopes starting with "Code" with level 1.
---------
Code,~Dead
Matches scopes containing "Code" but not "Dead", with level 1.
|
DumpingErrorsAreFatal | Boolean | false | Treat any exceptions during dumping as fatal.
|
DuplicateIrreducibleLoops | Boolean | true | When enabled, some limited amount of duplication will be performed in
order compile code containing irreducible loops.
|
DynamicCountersPrintGroupSeparator | Boolean | true | Use grouping separators for number printing
|
EagerSnippets | Boolean | true | Eagerly construct extra snippet info.
|
EmitStringSubstitutions | Boolean | true | Emit substitutions for String methods
|
EscapeAnalysisIterations | Integer | 2 | |
EscapeAnalysisLoopCutoff | Integer | 20 | |
EscapeAnalyzeOnly | String | null | |
ExactFullUnrollMaxNodes | Integer | 800 | |
ExactPartialUnrollMaxNodes | Integer | 200 | |
ExhaustiveHeapScan | Boolean | false | Scan all objects reachable from roots for analysis. By default false.
|
ExitVMOnException | Boolean | false | Alias for CompilationFailureAction=ExitVM.
|
ExtendedAsserts | Boolean | false | Enable extended asserts which slow down analysis.
|
FailedLoopExplosionIsFatal | Boolean | false | Do not bail out but throw an exception on failed loop explosion.
|
FallbackExecutorRuntimeJavaArg | Strings | * | Internal option used to specify runtime java arguments for
FallbackExecutor.
|
FlightRecorderLogging | String | "all=warning" | Usage: -XX:FlightRecorderLogging=[tag1[+tag2...][*][=level][,...]]
When this option is not set, logging is enabled at a level of WARNING.
When this option is set to the empty string, logging is enabled at a level of INFO.
When this option is set to "disable", logging is disabled entirely.
Otherwise, this option expects a comma separated list of tag combinations, each with an optional wildcard (*) and level.
A tag combination without a level is given a default level of INFO.
Messages with tags that match a given tag combination are set to log at that tag combination's level.
If a tag combination does not have a wildcard, then only messages with exactly the same tags are matched.
Otherwise, messages whose tags are a subset of the tag combination are matched.
Specifying "all" instead of a tag combination matches all tag combinations.
If more than one tag combination matches a message's tags, the rightmost one will apply.
Messages with tags that do not have any matching tag combinations are set to log at a default level of WARNING.
This option is case insensitive.
Available log levels:
[trace, debug, info, warning, error, off]
Available log tags:
[jfr, system, event, setting, bytecode, parser, metadata, dcmd]
|
FlightRecorder | Boolean | false | Enable Java Flight Recorder.
|
ForceDumpGraphsBeforeCompilation | Boolean | false | Force-dump graphs before compilation
|
FullUnrollConstantCompareBoost | Integer | 15 | |
FullUnrollMaxApplication | Integer | 60 | |
FullUnrollMaxIterations | Integer | 600 | |
FullUnrollMaxNodes | Integer | 400 | |
FullUnroll | Boolean | true | |
GCDebugStartCycle | Integer | -1 | Start tracing compiled GC barriers after N garbage collections
(disabled if N <= 0).
|
GenLoopSafepoints | Boolean | true | |
GeneratePIC | Boolean | false | Generate position independent code
|
GenericDynamicCounters | Boolean | false | Turn on the benchmark counters, and displays the results on VM shutdown
|
GraalArithmeticStubs | Boolean | true | Use Graal arithmetic stubs instead of HotSpot stubs where possible
|
GraalCompileOnly | String | null | A filter applied to a method the VM has selected for compilation by
Graal. A method not matching the filter is redirected to a lower tier
compiler. The filter format is the same as for the MethodFilter option.
|
GraphCompressionThreshold | Integer | 70 | Graal graph compression is performed when percent of live nodes falls
below this value
|
GuardPriorities | Boolean | true | |
HotSpotDeoptExplicitExceptions | Boolean | false | Testing only option that forces deopts for exception throws
|
HotSpotPostOnExceptions | Boolean | false | Testing only option that forces deopts for exception throws
|
HotSpotPrintInlining | Boolean | false | Print inlining optimizations
|
HybridStaticContext | Boolean | false | Enable hybrid context for static methods, i.e. uses invocation site as
context for static methods.
|
ImageObjectTreeExpandRoots | String | "" | Override the default suppression of specified roots. See: Reports.md.
|
ImageObjectTreeExpandTypes | String | "" | Override the default suppression of specified types. See: Reports.md.
|
ImageObjectTreeSuppressRoots | String | "" | Suppress the expansion of specified roots. See: Reports.md.
|
ImageObjectTreeSuppressTypes | String | "" | Suppress the expansion of specified types. See: Reports.md.
|
ImmutableCode | Boolean | false | Try to avoid emitting code where patching is required
|
InitTimer | Boolean | false | Specifies if initialization timing is enabled.
|
InlineBeforeAnalysis | Boolean | false | Experimental: Inline methods before static analysis
|
InlineDuringParsingMaxDepth | Integer | 10 | Maximum depth when inlining during bytecode parsing.
|
InlineDuringParsing | Boolean | true | Inlines trivial methods during bytecode parsing.
|
InlineEverything | Boolean | false | |
InlineIntrinsicsDuringParsing | Boolean | true | Inlines intrinsic methods during bytecode parsing.
|
InlineMegamorphicCalls | Boolean | true | Inline calls with megamorphic type profile (i.e., not all types could
be recorded).
|
InlineMonomorphicCalls | Boolean | true | Inline calls with monomorphic type profile.
|
InlinePartialIntrinsicExitDuringParsing | Boolean | true | Inlines partial intrinsic exits during bytecode parsing when possible.
A partial intrinsic exit is a call within an intrinsic to the method
being intrinsified and denotes semantics of the original method that
the intrinsic does not support.
|
InlinePolymorphicCalls | Boolean | true | Inline calls with polymorphic type profile.
|
InlineVTableStubs | Boolean | true | |
Inline | Boolean | true | Enable inlining
|
InliningDepthError | Integer | 1000 | Maximum inlining depth during partial evaluation before reporting an
infinite recursion
|
InspectServerContentPath | String | "inspect" | Path to the contents of the Inspect web server.
|
InstallSegfaultHandler | Boolean | null | Install segfault handler that prints register contents and full Java
stacktrace. Default: enabled for an executable, disabled for a shared
library.
|
InterceptBailout | Boolean | false | Intercept also bailout exceptions
|
Intrinsify | Boolean | true | Use compiler intrinsifications.
|
LIRDynMoveProfileMethod | Boolean | false | Enable dynamic move profiling per method.
|
LIROptConstantLoadOptimization | Boolean | true | Enable constant load optimization.
|
LIROptControlFlowOptimizer | Boolean | true | |
LIROptEdgeMoveOptimizer | Boolean | true | |
LIROptLSRAEliminateSpillMoves | Boolean | true | Enable spill move elimination.
|
LIROptLSRAOptimizeSpillPosition | Boolean | true | Enable spill position optimization
|
LIROptLSStackSlotAllocator | Boolean | true | Use linear scan stack slot allocation.
|
LIROptNullCheckOptimizer | Boolean | true | |
LIROptRedundantMoveElimination | Boolean | true | |
LIROptStackMoveOptimizer | Boolean | true | |
LIROptimization | Boolean | true | Enable LIR level optimiztations.
|
LIRProfileMethods | Boolean | false | Enables profiling of methods.
|
LIRProfileMoves | Boolean | false | Enables profiling of move types on LIR level. Move types are for
example stores (register to stack), constant loads (constant to
register) or copies (register to register).
|
LSRAOptSplitOnly | Boolean | false | LSRA optimization: Only split but do not reassign
|
LSRAOptimization | Boolean | false | Enable LSRA optimization
|
LibGraalManagementDelay | Integer | 1000 | Milliseconds to delay initialization of the libgraal JMX interface.
Specify a negative value to disable the interface altogether.
|
LimitInlinedInvokes | Double | 5.0 | |
LimitObjectArrayLength | Boolean | false | Enable a limit for the number of objects recorded for each type of a
type state before disabling heap sensitivity for that type. The
analysis must be heap sensitive.
|
ListMetrics | Boolean | false | Lists on the console at VM shutdown the metric names available to the
Timers, Counters and MemUseTrackers options. Note that this only lists
the metrics that were initialized during the VM execution and so will
not include metrics for compiler code that is not executed.
|
LoadExceptionObjectInVM | Boolean | false | Use a VM runtime call to load and clear the exception object from the
thread at the start of a compiled exception handler.
|
LogFile | String | null | File to which logging is sent. A %p in the name will be replaced with a
string identifying the process, usually the process id and %t will be
replaced by System.currentTimeMillis(). If the current runtime is in an
isolate, then %i will be replaced by '' otherwise %i is
removed. An %I is the same as %i except that the replacement is
'@'. Using %o as filename sends logging to
System.out whereas %e sends logging to System.err.
|
LogVerbose | Boolean | false | Enable more verbose log output when available
|
Log | String | null | Pattern for specifying scopes in which logging is enabled. See the Dump
option for the pattern syntax.
|
LoopHeaderAlignment | Integer | 16 | Alignment in bytes for loop header blocks.
|
LoopMaxUnswitch | Integer | 3 | |
LoopPeeling | Boolean | true | |
LoopPredicationMainPath | Boolean | true | Restricts LoopPredication to only focus on array bounds checks that
dominate the back edge of a loop.
|
LoopPredication | Boolean | true | Hoists array bounds checks out of simple loops. This is ignored if
SpeculativeGuardMovement is enabled.
|
LoopUnswitchFrequencyBoost | Double | 10.0 | |
LoopUnswitchMaxIncrease | Integer | 500 | |
LoopUnswitchTrivial | Integer | 10 | |
LoopUnswitch | Boolean | true | |
MatchExpressions | Boolean | true | Allow backend to match complex expressions.
|
MaxCallingContextDepth | Integer | 0 | The maximum length of the methods context chains.
|
MaxCallingContextWidth | Integer | 0 | The maximum number of contexts to record for a method. It only affects
the analysis when the max and min calling context depth are different.
|
MaxCompilationProblemsPerAction | Integer | 2 | The maximum number of compilation failures to handle with the action
specified by CompilationFailureAction before changing to a less verbose
action. This does not apply to the ExitVM action.
|
MaxConstantObjectsPerType | Integer | 100 | The maximum number of constant objects recorded for each type before
merging the constants into one unique constant object per type. The
analysis must be heap sensitive. It has a minimum value of 1.
|
MaxDirectMemorySize | Long | 0 | Maximum total size of NIO direct-buffer allocations
|
MaxDuplicationFactor | Double | 2.0 | How much duplication can happen because of irreducible loops before
bailing out.
|
MaxHeapContextDepth | Integer | 0 | The maximum length of the context used to model a heap object in
addition to the allocation site; used only when ContextSensitiveHeap is
enabled.
|
MaxHeapContextWidth | Integer | 0 | The maximum number of contexts to record for a heap object. It only
affects the analysis when the max and min calling context depth are
different.
|
MaxHeapSize | Long | 0 | The maximum heap size at run-time, in bytes.
|
MaxJavaStackTraceDepth | Integer | 1024 | The maximum number of lines in the stack trace for Java exceptions (0
means all)
|
MaxNewSize | Long | 0 | The maximum size of the young generation at run-time, in bytes
|
MaxObjectSetSize | Integer | 100 | The maximum number of objects recorded for each type of a type state
before disabling heap sensitivity for that type. The analysis must be
heap sensitive. It has a minimum value of 1.
|
MaxTemplatesPerSnippet | Integer | 50 | |
MaximumDesiredSize | Integer | 20000 | Maximum desired size of the compiler graph in nodes.
|
MaximumEscapeAnalysisArrayLength | Integer | 128 | The maximum length of an array that will be escape analyzed.
|
MaximumHeapSizePercent | Integer | 80 | The maximum heap size as percent of physical memory
|
MaximumInliningSize | Integer | 300 | Inlining is explored up to this number of nodes in the graph for each
call site.
|
MaximumLoopExplosionCount | Integer | 10000 | Max number of loop explosions per method.
|
MaximumRecursiveInlining | Integer | 5 | Maximum level of recursive inlining.
|
MaximumYoungGenerationSizePercent | Integer | 10 | The maximum size of the young generation as a percentage of the maximum
heap size
|
MegamorphicInliningMinMethodProbability | Double | 0.33 | Minimum probability for methods to be inlined for megamorphic type
profiles.
|
MemUseTrackers | String | null | Comma separated names of memory usage trackers that are enabled
irrespective of the value for TrackMemUse option. An empty value
enables all memory usage trackers unconditionally.
|
MethodFilterRootOnly | Boolean | false | Only check MethodFilter against the root method in the context if true,
otherwise check all methods
|
MethodFilter | String | null | Pattern for matching methods. The syntax for a pattern is:
SourcePatterns = SourcePattern ["," SourcePatterns] .
SourcePattern = [ "~" ] [ Class "." ] method [ "(" [ Parameter { ";" Parameter } ] ")" ] .
Parameter = Class | "int" | "long" | "float" | "double" | "short" | "char" | "boolean" .
Class = { package "." } class .
Glob pattern matching (*, ?) is allowed in all parts of the source pattern.
The "~" prefix negates the pattern.
Positive patterns are joined by an "or" operator: "A,B" matches anything
matched by "A" or "B". Negative patterns are joined by "and not": "~A,~B"
matches anything not matched by "A" and not matched by "B". "A,~B,~C,D"
matches anything matched by "A" or "D" and not matched by "B" and not
matched by "C".
A set of patterns containing negative patterns but no positive ones contains
an implicit positive "*" pattern: "~A,~B" is equivalent to "*,~A,~B".
Examples of method filters:
---------
*
Matches all methods in all classes.
---------
canonical(CanonicalizerTool;LogicNode;LogicNode)
Matches all methods named "canonical", with the first parameter of type
"CanonicalizerTool", and the second and third parameters of type
"LogicNode".
The packages of the parameter types are irrelevant.
---------
arraycopy(Object;;;;)
Matches all methods named "arraycopy", with the first parameter
of type "Object", and four more parameters of any type. The
packages of the parameter types are irrelevant.
---------
org.graalvm.compiler.nodes.PhiNode.*
Matches all methods in the class "org.graalvm.compiler.nodes.PhiNode".
---------
org.graalvm.compiler.nodes.*.canonical
Matches all methods named "canonical" in classes in the package
"org.graalvm.compiler.nodes".
---------
arraycopy,toString
Matches all methods named "arraycopy" or "toString", meaning that ',' acts
as an "or" operator.
---------
java.util.*.*.,~java.util.*Array*.*
java.util.*.*.,~*Array*.*
These patterns are equivalent and match all methods in the package
"java.util" except for classes that have "Array" in their name.
---------
~java.util.*.*
Matches all methods in all classes in all packages except for anything in
the "java.util" package.
|
MethodInlineBailoutLimit | Integer | 5000 | Per-compilation method inlining exploration limit before giving up (use
0 to disable)
|
MetricsFile | String | null | File to which metrics are dumped per compilation.
A CSV format is used if the file ends with .csv otherwise a more
human readable format is used. The fields in the CSV format are:
compilable - method being compiled
compilable_identity - identity hash code of compilable
compilation_nr - where this compilation lies in the ordered
sequence of all compilations identified by
compilable_identity
compilation_id - runtime issued identifier for the compilation
metric_name - name of metric
metric_value - value of metric
|
MinCallingContextDepth | Integer | 0 | The minimum length of the methods context chains.
|
MinHeapContextDepth | Integer | 0 | The minimum length of the context used to model a heap object in
addition to the allocation site; used only when ContextSensitiveHeap is
enabled.
|
MinHeapSize | Long | 0 | The minimum heap size at run-time, in bytes.
|
MinimalBulkZeroingSize | Integer | 2048 | If applicable, use bulk zeroing instructions when the zeroing size in
bytes exceeds this threshold.
|
MinimumPeelFrequency | Float | 0.35 | |
MoveGuardsUpwards | Boolean | true | Move guard nodes to earlier places in the dominator tree if all
successors of basic block share a common guard condition.
|
NDCV | Integer | 0 | Run level for NoDeadCodeVerifyHandler (0 = off, 1 = info, 2 = verbose,
3 = fatal)
|
NodeCounters | Boolean | false | Counts the number of instances of each node class.
|
NonFatalIdenticalCompilationSnapshots | Integer | 20 | Number of contiguous identical compiler thread stack traces allowed
before the VM exits on the basis of a stuck compilation.
|
ObjdumpExecutables | String | null | Comma separated list of candidate GNU objdump executables. If not
specified, disassembling via GNU objdump is disabled. Otherwise, the
first existing executable in the list is used.
|
OmitHotExceptionStacktrace | Boolean | false | |
OptAssumptions | Boolean | true | |
OptConvertDeoptsToGuards | Boolean | true | |
OptDeoptimizationGrouping | Boolean | true | |
OptDevirtualizeInvokesOptimistically | Boolean | true | |
OptEarlyReadElimination | Boolean | true | |
OptEliminateGuards | Boolean | true | |
OptFloatingReads | Boolean | true | |
OptImplicitNullChecks | Boolean | true | |
OptReadElimination | Boolean | true | |
OptScheduleOutOfLoops | Boolean | true | |
PartialEscapeAnalysis | Boolean | true | |
PartialUnroll | Boolean | true | |
PeelALot | Boolean | false | |
PercentTimeInIncrementalCollection | Integer | 50 | Percentage of total collection time that should be spent on young
generation collections.
|
PreferContainerQuotaForCPUCount | Boolean | true | Calculate the container CPU availability based on the value of quotas
(if set), when true. Otherwise, use the CPU shares value, provided it
is less than quota.
|
PrintAnalysisCallTree | Boolean | false | Print analysis call tree, a breadth-first tree reduction of the call
graph.
|
PrintAnalysisStatistics | Boolean | false | Print analysis results statistics.
|
PrintBackendCFG | Boolean | false | Enable dumping LIR, register allocation and code generation info to the
C1Visualizer.
|
PrintBlockMapping | Boolean | false | Enable dumping CFG built during initial BciBlockMapping
|
PrintCFG | Boolean | false | Enable dumping to the C1Visualizer. Enabling this option implies
PrintBackendCFG.
|
PrintCanonicalGraphStringFlavor | Integer | 0 | Choose format used when dumping canonical text for graphs: 0 gives a
scheduled graph (better for spotting changes involving the schedule)
while 1 gives a CFG containing expressions rooted at fixed nodes
(better for spotting small structure differences)
|
PrintCanonicalGraphStrings | Boolean | false | Enable dumping canonical text from for graphs.
|
PrintCompilation | Boolean | false | Print an informational line to the console for each completed
compilation.
|
PrintConfig | Boolean | false | Prints VM configuration available via JVMCI.
|
PrintDetailedAllocationProfiling | Boolean | true | Print detailed information for each allocation site
|
PrintFlagsWithExtraHelp | String | null | Print extra help, if available, based on comma-separated option names.
Pass * to show all options that contain extra help.
|
PrintFlags | String | null | Show available options based on comma-separated option-types (allowed
categories: User, Expert, Debug).
|
PrintGCSummary | Boolean | false | Print summary GC information after application main method returns.
|
PrintGCTimeStamps | Boolean | false | Print a time stamp at each collection, if +PrintGC or +VerboseGC.
|
PrintGCTimes | Boolean | false | Print the time for each of the phases of each collection, if
+VerboseGC.
|
PrintGC | Boolean | false | Print summary GC information after each collection
|
PrintGraphFile | Boolean | true | Setting to true sets PrintGraph=file, setting to false sets
PrintGraph=network
|
PrintGraphHost | String | "127.0.0.1" | Host part of the address to which graphs are dumped.
|
PrintGraphPort | Integer | 4445 | Port part of the address to which graphs are dumped in binary format.
|
PrintGraphWithSchedule | Boolean | false | Schedule graphs as they are dumped.
|
PrintGraph | String | File | Where IdealGraphVisualizer graph dumps triggered by Dump or DumpOnError
should be written.
The accepted values are:
File - Dump IGV graphs to the local file system (see DumpPath).
Network - Dump IGV graphs to the network destination specified by PrintGraphHost and PrintGraphPort.
If a network connection cannot be opened, dumping falls back to file dumping.
Disable - Do not dump IGV graphs.
|
PrintHeapShape | Boolean | false | Print the shape of the heap before and after each collection, if
+VerboseGC.
|
PrintIRWithLIR | Boolean | false | Print HIR along side LIR as the latter is generated
|
PrintImageObjectTree | Boolean | false | Print image object hierarchy.
|
PrintLIRWithAssembly | Boolean | false | Include the LIR as comments with the final assembly.
|
PrintPointsToStatistics | Boolean | false | Report analysis statistics.
|
PrintProfilingInformation | Boolean | false | Print profiling information when parsing a method's bytecode
|
PrintSynchronizedAnalysis | Boolean | false | Print types used for Java synchronization.
|
ProbabilisticProfiling | Boolean | true | Control probabilistic profiling on AMD64
|
ProfileAllocationsContext | String | AllocatingMethod | Control the naming and granularity of the counters when using
ProfileAllocations.
The accepted values are:
AllocatingMethod - a counter per method
InstanceOrArray - one counter for all instance allocations and
one counter for all array allocations
AllocatedType - one counter per allocated type
AllocatedTypesInMethod - one counter per allocated type, per method
|
ProfileAllocations | Boolean | false | Enable profiling of allocation sites.
|
ProfileAnalysisOperations | Boolean | false | Track the progress of the static analysis.
|
ProfileBackedges | Boolean | true | Emit profiling of backedges
|
ProfileCompiledMethods | Boolean | false | |
ProfileConstantObjects | Boolean | false | Track the creation of constant objects.
|
ProfileInvokes | Boolean | true | Emit profiling of invokes
|
ProfileMonitors | Boolean | false | Enable profiling of monitor operations.
|
ProfileSimpleMethods | Boolean | true | Profile simple methods
|
RawConditionalElimination | Boolean | true | |
ReadEliminationMaxLoopVisits | Integer | 5 | |
ReassociateExpressions | Boolean | true | Re-associate loop invariants and constants.
|
ReduceDCE | Boolean | true | Disable optional dead code eliminations
|
RegisterPressure | String | null | Comma separated list of registers that register allocation is limited
to.
|
RelaxTypeFlowStateConstraints | Boolean | true | Allow a type flow state to contain types not compatible with its
declared type.
|
RemoveNeverExecutedCode | Boolean | true | |
RemoveSaturatedTypeFlows | Boolean | true | Enable the type flow saturation analysis performance optimization.
|
ReplaceInputsWithConstantsBasedOnStamps | Boolean | true | |
SafepointPromptnessFailureNanos | Long | 0 | Exit the VM if I can not come to a safepoint in this many nanoseconds.
0 implies forever.
|
SafepointPromptnessWarningNanos | Long | 0 | Print a warning if I can not come to a safepoint in this many
nanoseconds. 0 implies forever.
|
ScanObjectsParallel | Boolean | true | Object scanning in parallel
|
ShowConfiguration | String | none | Writes to the VM log information about the compiler configuration
selected.
|
ShowDumpFiles | Boolean | false | Print the name of each dump file path as it's created.
|
ShowSubstitutionSourceInfo | Boolean | false | Controls whether the source position information of snippets and method
substitutions are exposed to HotSpot. Can be useful when profiling to
get more precise position information.
|
SimpleFastInflatedLocking | Boolean | true | Handle simple cases for inflated monitors in the fast-path.
|
SimpleMethodCalls | Integer | 1 | Maximum number of calls in a simple method
|
SimpleMethodGraphSize | Integer | 256 | Maximum number of nodes in a graph for a simple method
|
SimpleMethodIndirectCalls | Integer | 0 | Maximum number of indirect calls in a simple moethod
|
SmallCompiledLowLevelGraphSize | Integer | 330 | If the previous low-level graph size of the method exceeds the
threshold, it is not inlined.
|
SnippetCounters | Boolean | false | Enable counters for various paths in snippets.
|
SpectrePHTBarriers | String | None | Select a strategy to mitigate speculative bounds check bypass (aka
Spectre-PHT or Spectre V1).
This is an experimental option - execution of untrusted code is not supported by GraalVM CE.
The accepted values are:
None - No mitigations are used in JIT compiled code.
AllTargets - Speculative execution on all conditional branch targets is
stopped using speculative execution barrier instructions.
GuardTargets - Branch targets relevant to Java memory safety are instrumented
with barrier instructions. This option has less performance impact
than AllTargets.
NonDeoptGuardTargets - Same as GuardTargets, except that branches which deoptimize are not
protected since they can not be executed repeatedly and are thus less
likely to be successfully exploited in an attack.
Note that all modes except "None" will also instrument branch target blocks containing UNSAFE memory accesses
with barrier instructions.
|
SpectrePHTIndexMasking | Boolean | false | Mask indices to scope access to allocation size after bounds check.
|
SpeculativeGuardMovement | Boolean | true | Move loop invariant guards (e.g., array bounds checks) out of loops.
|
StackSize | Long | 0 | The size of each thread stack at run-time, in bytes.
|
StartFlightRecording | String | "" | Start flight recording with options.
|
StressExplicitExceptionCode | Boolean | false | Stress the code emitting explicit exception throwing code.
|
StressInvokeWithExceptionNode | Boolean | false | Stress the code emitting invokes with explicit exception edges.
|
StressTestEarlyReads | Boolean | false | Stress the code by emitting reads at earliest instead of latest point.
|
StringIndexOfLimit | Integer | 4096 | String.indexOf invocations will be evaluated at compile time if the
receiver is a constant and its length is lower than this value.
|
SupportJsrBytecodes | Boolean | true | |
SupportOSRWithLocks | Boolean | true | Support OSR compilations with locks. If DeoptAfterOSR is true we can
per definition not have unbalanced enter/exits mappings. If
DeoptAfterOSR is false insert artificial monitor enters after the
OSRStart to have balanced enter/exits in the graph.
|
TearDownFailureNanos | Long | 0 | The number of nanoseconds before tearing down an isolate gives a
failure message. 0 implies no message.
|
TearDownWarningNanos | Long | 0 | The number of nanoseconds before and between which tearing down an
isolate gives a warning message. 0 implies no warning.
|
TierABackedgeNotifyFreqLog | Integer | 16 | Backedge notification frequency
|
TierABackedgeProfileProbabilityLog | Integer | 12 | Backedge profile probability
|
TierAInvokeInlineeNotifyFreqLog | Integer | -1 | Inlinee invocation notification frequency (-1 means count, but do not
notify)
|
TierAInvokeNotifyFreqLog | Integer | 13 | Invocation notification frequency
|
TierAInvokeProfileProbabilityLog | Integer | 8 | Invocation profile probability
|
TieredAOT | Boolean | false | Do profiling and callbacks to tiered runtime
|
Time | String | null | Pattern for specifying scopes in which timing is enabled. See the Dump
option for the pattern syntax. An empty value enables all timers
unconditionally.
|
TimedDynamicCounters | Integer | -1 | Turn on the benchmark counters, and displays the results every n
milliseconds
|
Timers | String | null | Comma separated names of timers that are enabled irrespective of the
value for Time option. An empty value enables all timers
unconditionally.
|
TraceBytecodeParserLevel | Integer | 0 | The trace level for the bytecode parser. A value of 1 enables
instruction tracing and any greater value emits a frame state trace
just prior to each instruction trace.Instruction tracing output from
multiple compiler threads will be interleaved so use of this option
make most sense for single threaded compilation. The MethodFilter
option can be used to refine tracing to selected methods.
|
TraceCodeCache | Boolean | false | Print logging information for runtime code cache modifications
|
TraceDeoptimizationDetails | Boolean | false | Print verbose logging information for every deoptimization
|
TraceDeoptimization | Boolean | false | Print logging information for every deoptimization
|
TraceEscapeAnalysis | Boolean | false | |
TraceExceptionHandlerStub | Boolean | false | Trace execution of stub used to handle an exception thrown by a callee.
|
TraceHeapChunks | Boolean | false | Trace heap chunks during collections, if +VerboseGC and
+PrintHeapShape.
|
TraceInlineDuringParsing | Boolean | false | Traces inlining performed during bytecode parsing.
|
TraceInliningForStubsAndSnippets | Boolean | false | Enable inlining decision tracing in stubs and snippets.
|
TraceInlining | Boolean | false | Enable tracing of inlining decisions.
Output format:
compilation of 'Signature of the compilation root method':
at 'Signature of the root method' ['Bytecode index']: <'Phase'> 'Child method signature': 'Decision made about this callsite'
at 'Signature of the child method' ['Bytecode index']:
|--<'Phase 1'> 'Grandchild method signature': 'First decision made about this callsite'
\--<'Phase 2'> 'Grandchild method signature': 'Second decision made about this callsite'
at 'Signature of the child method' ['Bytecode index']: <'Phase'> 'Another grandchild method signature': 'The only decision made about this callsite.'
|
TraceLIRGeneratorLevel | Integer | 0 | The trace level for the LIR generator
|
TraceMethodDataFilter | String | null | Enables tracing of profiling info when read by JVMCI.
Empty value: trace all methods
Non-empty value: trace methods whose fully qualified name contains the value.
|
TraceMonitorsMethodFilter | String | null | Trace monitor operations in methods whose fully qualified name contains
this substring.
|
TraceMonitorsTypeFilter | String | null | Trace monitor operations on objects whose type contains this substring.
|
TraceParserPlugins | Boolean | false | Traces use of plugins during bytecode parsing.
|
TraceUnwindStub | Boolean | false | Trace execution of the stub that routes an exception to a handler in
the calling frame.
|
TrackAccessChain | Boolean | false | Track the callers for methods and accessing methods for fields.
|
TrackInputFlows | Boolean | false | Track the input for type flows.
|
TrackMemUse | String | null | Pattern for specifying scopes in which memory use tracking is enabled.
See the Dump option for the pattern syntax. An empty value enables all
memory use trackers unconditionally.
|
TrackNodeInsertion | Boolean | false | Track source stack trace where a node was inserted into the graph.
|
TrackNodeSourcePosition | Boolean | false | Track the NodeSourcePosition.
|
TrivialInliningSize | Integer | 10 | Graphs with less than this number of nodes are trivial and therefore
always inlined.
|
TruffleCompilerConfiguration | String | null | Select a compiler configuration for Truffle compilation (default: use
Graal system compiler configuration).
|
TrustFinalDefaultFields | Boolean | true | Determines whether to treat final fields with default values as
constant.
|
TypeCheckMaxHints | Integer | 2 | The maximum number of profiled types that will be used when compiling a
profiled type check. Note that TypeCheckMinProfileHitProbability also
influences whether profiling info is used in compiled type checks.
|
TypeCheckMinProfileHitProbability | Double | 0.5 | If the probability that a type check will hit one the profiled types
(up to TypeCheckMaxHints) is below this value, the type check will be
compiled without profiling info
|
TypeFlowSaturationCutoff | Integer | 20 | The maximum number of types recorded in a type flow. -1 indicates no
limitation.
|
UnresolvedIsError | Boolean | true | Report unresolved elements as errors.
|
UnrollMaxIterations | Integer | 16 | |
UseBranchesWithin32ByteBoundary | Boolean | false | Force branch instructions to align with 32-bytes boundary, to mitigate
the jcc erratum. See
https://www.intel.com/content/dam/support/us/en/documents/processors/mitigations-jump-conditional-code-erratum.pdf
for more details. If not set explicitly, the default value will be
determined according to the CPU model.
|
UseCompilationStatistics | Boolean | false | Enables CompilationStatistics.
|
UseEncodedGraphs | Boolean | false | Encode and decode snippets and substitutions before parsing to test
libgraal code path. This option is ignored in the context of libgraal.
|
UseExceptionProbability | Boolean | true | |
UseGraalStubs | Boolean | true | Use Graal-generated stubs for complicated LIR operations instead of
embedding all the emitted code.
|
UseLoopLimitChecks | Boolean | true | |
UseProfilingInformation | Boolean | true |
|
UseSnippetGraphCache | Boolean | true | Use a cache for snippet graphs.
|
UseSnippetTemplateCache | Boolean | true | Use a LRU cache for snippet templates.
|
UseTrappingNullChecks | Boolean | true | Use traps for null checks instead of explicit null-checks
|
UseTypeCheckHints | Boolean | true | |
VerboseGC | Boolean | false | Print more information about the heap before and after each collection
|
VerifyBalancedMonitors | Boolean | false | Emit extra code to dynamically check monitor operations are balanced.
|
VerifyGraalGraphEdges | Boolean | false | Perform expensive verification of graph inputs, usages, successors and
predecessors
|
VerifyGraalGraphs | Boolean | true | Verify graphs often during compilation when assertions are turned on
|
VerifyGraalPhasesSize | Boolean | false | Verify before - after relation of the relative, computed, code size of
a graph
|
VerifyHeapAtReturn | Boolean | false | Perform platform dependent validation of the Java heap at returns
|
VerifyKillCFGUnusedNodes | Boolean | false | Verify that there are no new unused nodes when performing killCFG
|
VerifyPhases | Boolean | false | |
Verify | String | null | Pattern for specifying scopes in which logging is enabled. See the Dump
option for the pattern syntax.
|
WriteableCodeCache | Boolean | false | Allocate code cache with write access, allowing inlining of objects
|
ZapStackOnMethodEntry | Boolean | false | |