VM Options Explorer - GraalVM native-image CE JDK17

Deprecated.

Perform trivial method inlining in the AOT compiled native image.

Prefix that is added to the names of API functions. 

Enables instruction profiling on assembler level. Valid values are a comma separated list of supported instructions. 
Compare with subclasses of Assembler.InstructionCounter.

Abort VM with SIGILL if benchmark counters controlled by the (Generic|Timed|Benchmark)DynamicCounters.

Overwrites the available number of processors provided by the OS. Any value <= 0 means using the processor count from 
the OS.

Make all hosted charsets available at run time.

Make all supported providers returned by FileSystemProvider.installedProviders() available at run time.

Value /=(,)* updates  to export  to , 
regardless of module declaration.  can be ALL-UNNAMED to export to all unnamed modules.

Value /=(,)* updates  to open  to , 
regardless of module declaration.

Value =(,)* updates  to read , regardless of module 
declaration.  can be ALL-UNNAMED to read all unnamed modules.

Comma-separated list of additional security provider fully qualified class names to mark as used.Note that this option 
is only necessary if you use custom engine classes not available in JCA that are not JCA compliant.

Comma-separated list of additional security service types (fully qualified class names) for automatic registration. Note 
that these must be JCA compliant.

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.

Model all array type flows using a unique elements type flow abstraction.

The size of an aligned chunk. Serial and epsilon GC only. 

Number of cache lines to load after the object address using prefetch instructions. 

Sets the size (in bytes) of the prefetch distance for object allocation. Memory about to be written with the value of 
new objects is prefetched up to this distance starting from the address of the last allocated object. Each Java thread
has its own allocation point.

Sets the prefetch instruction to prefetch ahead of the allocation pointer. Possible values are from 0 to 3. The actual 
instructions behind the values depend on the platform.

Number of cache lines to load after the array allocation using prefetch instructions. 

Sets the step size (in bytes) for sequential prefetch instructions. 

Generated code style for prefetch instructions: for 0 or less no prefetch instructions are generated and for 1 or more 
prefetch instructions are introduced after each allocation.

Bytes that can be allocated before (re-)querying the physical memory size. Serial and epsilon GC only.

The minimum size in bytes required for printing an allocation profiling entry. 

Enable runtime profiling of allocation.

A context sensitive heap means that each heap allocated object is modeled by using at least the allocation site.

Allow using deprecated @AutomaticFeature annotation. If set to false, an error is shown instead of a warning.

Allow MethodTypeFlow to see @Fold methods.

Deprecated.

Enable support for reading Java modules (jimage format) and the jrt:// file system. Requires java.home to be set at 
runtime.

Enables features that allow the VM to be inspected during run time.

Determines if VM internal threads (e.g., a dedicated VM operation or reference handling thread) are allowed in this 
image.

Unconditionally inline intrinsics.

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).

The maximum size of type and method profiles returned by the static analysis. -1 indicates no limitation. 

Analysis results statistics file.

Array region equality checks will be evaluated at compile time if the receiver is a constant and its length is smaller 
than this value.

Assert class initialization is specified for all classes.

Determines if the reference handling is executed automatically or manually.

Use a cutoff to print only most significant counters.

Dump dynamic counters.

Dump static counters.

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.

Turn on the benchmark counters. The format of this option is:.

Do not compile anything on bootstrap but just initialize the compiler.

Maximum time in minutes to spend bootstrapping (0 to disable this limit). 

Ratio of the maximum compilation rate below which the bootstrap compilation rate must not fall (0 or less disables 
monitoring).

Show code and heap breakdowns as part of the build output.

Colorize build output.

Print GC warnings as part of build output.

Print build output statistics as JSON to the specified file. The output is according to the JSON schema located at: 
docs/reference-manual/native-image/assets/build-output-schema-v0.9.0.json.

Show links in build output.

Prefix build output with ':'.

Report progress in build output.

Silence build output.

Directory where information generated by the CAnnotation Processor are cached. 

Provide custom C compiler option used for query code compilation. 

Provide custom path to C compiler used for query code compilation and linking.

Search path for C libraries passed to the linker (list of comma-separated directories). 

Comma separated list of CPU features that will be enabled while building the target executable, irrespective of whether 
they are supported by the hosted environment. Note that enabling features not present within the target environment may
result in application crashes. The specific options available are target platform dependent. See --list-cpu-features
for feature list.

C standard to use in header files. Possible values are: [C89, C99, C11]. 

Exclude virtual nodes when dumping canonical text for graphs.

Exclude virtual nodes when dumping canonical text for graphs.

Attempts to remove object identity hashes when dumping canonical text for graphs.

Test whether a thread's recurring callback is pending on each transition from native code to Java.

Check if native-toolchain is known to work with native-image.

A comma-separated list of classes appended with their initialization strategy (':build_time', ':rerun', or ':run_time'). 

Class containing the default entry point method. Optional if --shared is used. 

Clear the debug metrics after bootstrap.

Alignment of AOT and JIT compiled code in bytes. 

Count accesses to the image and runtime code info table.

Statistics about code and deoptimization information.

The granularity of the index for looking up code metadata. Should be a power of 2. Larger values make the index smaller, 
but access slower.

Collect information during image build about devirtualized invokes and bytecode exceptions.

Determines if a full GC collects the young generation separately or together with the old generation. Serial GC only. 

Treat compilation bailouts like compilation failures.

The number of compilations allowed for any method before the VM exits (a value of 0 means there is no limit). 

Exclude certain phases from compilation, either unconditionally or with a method filter. Multiple exclusions can be 
specified separated by ':'. Phase names are matched as substrings, e.g.:
CompilationExcludePhases=PartialEscape:Loop=A.*,B.foo excludes PartialEscapePhase from all compilations and any phase
containing 'Loop' in its name from compilations of all methods in class A and of method B.foo.

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.

Specifies the action to take when compilation fails. [Extra help available] 

Size of the reserved address space of each compilation isolate (0: default for new isolates). 

Delay in seconds before watch dog monitors a compilation (0 disables monitoring). 

Number of seconds after which a compilation appearing to make no progress causes the VM to exit (0 disables VM exiting). 

In tiered mode compile Graal and JVMCI using optimized first tier code.

Activate runtime compilation in separate isolates (enable support during image build with option 
SupportCompileInIsolates).

Backend used by the compiler. 

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.

Directories directly containing configuration files for dynamic features at runtime. 

Resource path above configuration resources for dynamic features at runtime. 

Enable runtime instantiation of reflection objects for non-invoked methods.

Use the option to avoid the initial value of the enterSamplingCodeMethodId constant folding. The value of this option 
must never be set to true in order to keep the correct information in the variable.

Instrument write barriers with counters. Serial GC only.

Pattern for specifying scopes in which counters are enabled. See the Dump option for the pattern syntax. An empty value 
enables all counters unconditionally.

Comma separated names of counters that are enabled irrespective of the value for Count option. An empty value enables 
all counters unconditionally.

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.

In the dashboard dump, include all available information about the native image (this takes precedence over more 
specific flags).

Set dashboard to use BGV format for dump.

In the dashboard dump, include the breakdown of the code size across different packages.

Enable dashboard dumps to the specified file.

In the dashboard dump, include the breakdown of the object sizes in the heap across different classes.

Set dashboard to use JSON format for dump.

In the dashboard dump, include the information about the points-to analysis.

Set dashboard to use pretty print in JSON format.

Exit the image builder VM after printing call stacks.

The interval in minutes between watchdog checks (0 disables the watchdog). 

Directory under which to create source file cache for Application or GraalVM classes. 

Search path for source files for Application or GraalVM classes (list of comma-separated directories or jar files). 

Enable debug output for stub code generation and snippet preparation.

Default charset of the image, by the default it is the same as the default charset of the image builder. 

Default locale of the image, by the default it is the same as the default locale of the image builder. 

Default frequency for loops with unknown local frequency. 

Default unswitching factor for control split node with unkown profile data. 

Use linker option to remove all local symbols from image.

Deoptimize OSR compiled code when the OSR entry loop is finished if there is no mature profile available for the rest of 
the method.

Compiles all methods as deoptimization targets for testing.

Enable expensive assertions if normal assertions (i.e. -ea or -esa) are enabled.

When set to true, the image generator verifies that the image heap does not contain a home directory as a substring.

Specify the dump level if CompilationFailureAction#Diagnose is used.See CompilationFailureAction for details. 
file:doc-files/CompilationFailureActionHelp.txt.

Specifies how many details are printed for certain diagnostic thunks, e.g.: 'DumpThreads:1,DumpRegisters:2'. A value of 
1 will result in the maximum amount of information, higher values will print less information. By default, the most
detailed output is enabled for all diagnostic thunks. Wildcards (*) are supported in the name of the diagnostic thunk.

Sets the dir where diagnostic information is dumped.

Enables the diagnostic mode.

Ignore calls to System.gc().

Disable intercepting exceptions in debug scopes.

Disable intrinsics matching the given method filter (see MethodFilter option for details). For example, 
'DisableIntrinsics=String.equals' disables intrinsics for any method named 'equals' in a class whose simple name is
'String'. You can append ':verbose' at the end of the filter value to print out disabled intrinsics as they are
encountered during compilation (e.g., 'String.equals:verbose').

For internal purposes only. Disables type id result verification even when running with assertions enabled.

List of comma separated URL protocols that must never be included. 

Analysis: Detect methods that return one of their parameters and hardwire the parameter straight to the return.

Dump the current graph after every bci to IGV.

Debug flag to dump loop frequency differences computed based on loop end or exit nodes.If the frequencies diverge a lot, 
this may indicate missing profiles on control flowinside the loop body.

Create a heap dump and exit.

Dump the heap at a specific time during image building.The option accepts a list of comma separated phases, any of: 
during-analysis, after-analysis, before-compilation.

Send compiler IR to dump handlers on error.

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.

The directory where various Graal dump files are written. 

Dumps all runtime compiled methods on SIGUSR2.

Show native-toolchain information and image-build settings.

Dumps all thread stacktraces on SIGQUIT/SIGBREAK.

Filter pattern for specifying scopes in which dumping is enabled.

Treat any exceptions during dumping as fatal.

Use grouping separators for number printing.

One or several (comma-separated) paths to JSON files that specify lists of interfaces that define Java proxy classes. 
[Extra help available]

Resources describing program elements to be made available for reflection (see ProxyConfigurationFiles).

Enable trace logging for dynamic proxy.

Eagerly construct extra snippet info.

Enable early code emission order computation instead of late code emission order computation.

Perform early global value numbering.

Perform early loop invariant code motion.

Emit substitutions for String methods.

Add all security service classes to the generated image.

Enable the feature that provides support for logging.

Enable monitoring features that allow the VM to be inspected at run time. Comma-separated list can contain 'heapdump', 
'jfr', 'jvmstat', or 'all' (defaults to 'all' if no argument is provided). For example:
`--enable-monitoring=heapdump,jvmstat`.

Enable automatic registration of security services.

Enables the signal API (sun.misc.Signal or jdk.internal.misc.Signal). Defaults to false for shared library and true for 
executables.

Enables signal handling. 

List of comma separated URL protocols to enable. 

Enable wildcard expansion in command line arguments on Windows.

Enforce checking of maximum number of methods allowed for runtime compilation. Useful for checking in the gate that the 
number of methods does not go up without a good reason.

Prefix that is added to the names of entry point methods. 

Regexp to match names of resources to be excluded from the image. 

Scan all objects reachable from roots for analysis. By default false.

Exit after analysis.

Exit image generation after C Annotation Processor Cache creation.

Output query code for target platform without executing it.

Exit after writing relocatable file.

Exit on the first occurrence of an out-of-memory error that is thrown because the Java heap is out of memory.

Enable termination caused by missing metadata.

Alias for CompilationFailureAction=ExitVM.

Soft upper limit for used eden size. The hinted GC will be performed if the used eden size exceeds this value. 

Enable extended asserts which slow down analysis.

Do not bail out but throw an exception on failed loop explosion.

Internal option used to specify Classpath for FallbackExecutor.

Internal option used to specify java arguments for FallbackExecutor. 

Internal option used to specify MainClass for FallbackExecutor.

Internal option used to specify runtime java arguments for FallbackExecutor. 

Internal option used to specify system properties for FallbackExecutor. 

Define when fallback-image generation should be used. 

A comma-separated list of fully qualified Feature implementation classes. 

Usage: -XX:FlightRecorderLogging=[tag1[+tag2...][*][=level][,...]]. [Extra help available] 

Enable Java Flight Recorder.

Try to float non-constant division operations to expose global value numbering of divisions.

Fold SecurityManager getter.

Place N-byte constants in the data section such that they are misaligned with respect to N*2. For example, place 4 byte 
constants at offset 4, 12 or 20, etc. This layout is used to detect instructions that load constants with alignment
smaller than the fetch size. For instance, an XORPS instruction that does a 16-byte fetch of a 4-byte float not aligned
to 16 bytes will cause a segfault.

Force-dump graphs before compilation.

Force an explicit compiler node for Reference.reachabilityFence, instead of relying on FrameState liveness.

Use only a writable native image heap (requires ld.gold linker).

Maximum factor by which full unrolling can increase code size for large graphs. The FullUnrollSmallGraphThreshold option
determines which graphs are small.

Maximum factor by which full unrolling can increase code size for small graphs. The FullUnrollSmallGraphThreshold option
determines which graphs are small.

The threshold in terms of NodeSize for a graph to be considered small for the purpose of full unrolling. Applied in 
conjunction with the FullUnrollCodeSizeBudgetFactorForSmallGraphs and FullUnrollCodeSizeBudgetFactorForLargeGraphs
options.

Start tracing compiled GC barriers after N garbage collections (disabled if N <= 0). 

Gather statistics about each safepoint.

Insert debug info into the generated native image or library. 

Turn on the benchmark counters, and displays the results on VM shutdown.

Use Graal arithmetic stubs instead of HotSpot stubs where possible.

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.

Graal graph compression is performed when percent of live nodes falls below this value. 

Develop demographics of the object references visited. Serial GC only.

Number of bytes at the beginning of each heap chunk that are not used for payload data, i.e., can be freely used as 
metadata by the heap chunk provider. Serial and epsilon GC only.

Control heap verifier verbosity level: 0 - quiet, 1 - info, 2 - warning, 3 - all. 

Testing only option that forces deopts for exception throws.

Testing only option that forces deopts for exception throws.

Print inlining optimizations.

Enable hybrid context for static methods, i.e. uses invocation site as context for static methods.

File for printing image build statistics.

Enables card marking for image heap objects, which arranges them in chunks. Automatically enabled when supported. Serial 
GC only.

Override the default suppression of specified roots. See: Reports.md. 

Override the default suppression of specified types. See: Reports.md. 

Suppress the expansion of specified roots. See: Reports.md. 

Suppress the expansion of specified types. See: Reports.md. 

Common prefix used by method symbols in image. 

Make all hosted locales available at run time.

When true, all time zones will be pre-initialized in the image.

Determines if debugging-specific helper methods are embedded into the image. Those methods can be called directly from 
the debugger to obtain or print additional information.

Comma separated list of locales to be included into the image. The default locale is included in the list automatically 
if not present.

Include a list of methods included in the image for runtime inspection.

Track NodeSourcePositions during runtime-compilation.

Comma separated list of bundles to be included into the image. 

Regexp to match names of resources to be included in the image. 

The time zones, in addition to the default zone of the host, that will be pre-initialized in the image. 

The garbage collection policy, either Adaptive (default) or BySpaceAndTime. Serial GC only. 

The number of seconds by which to slow down each compilation. The compilations slowed down can be restricted with 
MethodFilter. This option exists to test the compilation watchdog.

Maximum number of invokes for method inlined before static analysis. 

Maximum number of invokes for method inlined before static analysis. 

Maximum number of computation nodes for method inlined before static analysis. 

Inline methods before static analysis.

Maximum depth when inlining during bytecode parsing. 

Inlines trivial methods during bytecode parsing.

Embed all the emitted code for Graal-generated stubs.

Inline calls with megamorphic type profile (i.e., not all types could be recorded).

Inline calls with monomorphic type profile.

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.

Inline calls with polymorphic type profile.

Enable inlining.

Maximum inlining depth during partial evaluation before reporting an infinite recursion. 

Path to the contents of the Inspect web server. 

Provide java.lang.Terminator exit handlers.

Install segfault handler that prints register contents and full Java stacktrace.

Intercept also bailout exceptions.

Compatibility option to make symbols used for the image heap global. Using global symbols is problematic for shared 
libraries because the loader implicitly changes the value when the symbol is already defined in the executable loading
the library. Setting this option to true preserves the broken behavior of old Native Image versions.

The size of each internal thread stack, in bytes. 

Use compiler intrinsifications.

Alignment in bytes for loop header blocks that have no fall through paths. 

Allow iterative peeling of loops up to this many times (each time the peeling phase runs). 

Files describing program elements to be made accessible via JNI (for syntax, see ReflectionConfigurationFiles). 

Resources describing program elements to be made accessible via JNI (see JNIConfigurationFiles). 

Export Invocation API symbols.

Report information about known JNI elements when lookup fails.

Enable Java Native Interface (JNI) support.

Enable dynamic move profiling per method.

Path to jar file containing LIR instruction verifier.

Enable constant load optimization. 

Enable spill move elimination. 

Enable spill position optimization. 

Use linear scan stack slot allocation. 

Enable LIR level optimizations.

Enables profiling of methods.

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).

LSRA optimization: Only split but do not reassign.

Enable LSRA optimization.

The size at or above which an array will be allocated in its own unaligned chunk. 0 implies (AlignedHeapChunkSize / 8). 
Serial and epsilon GC only.

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.

Require all types in given class or module-path entries to be fully defined at image build-time. [Extra help available] 

Require types to be fully defined at image build-time. If used without args, all classes in scope of the option are 
required to be fully defined. [Extra help available]

Path passed to the linker as the -rpath (list of comma-separated directories). 

Show CPU features specific to the target platform and exit.

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.

List observable modules and exit.

Use a VM runtime call to load and clear the exception object from the thread at the start of a compiled exception 
handler.

Regular expressions matching which bundles should be compressed. 

Compress the bundles in parallel.

Optimize the resource bundle lookup using a simple map.

Store the resource bundle content more efficiently in the fallback mode.

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.

Enable more verbose log output when available.

Pattern for specifying scopes in which logging is enabled. See the Dump option for the pattern syntax.

Scaling factor of frequency difference computed based on loop ends or exits. 

Alignment in bytes for loop header blocks. 

Execute an endless loop before printing diagnostics for a fatal error.

Restricts LoopPredication to only focus on array bounds checks that dominate the back edge of a loop.

Hoists array bounds checks out of simple loops. This is ignored if SpeculativeGuardMovement is enabled.

Number of nodes allowed for a loop unswitching per loop frequency. The number of nodes allowed for the unswitching is 
proportional to the relative frequency of the loop by this constant.

Maximun value for the frequency factor of an invariant. 

Minimum value for the frequency factor of an invariant. 

Maximum loop unswitching code size increase in nodes. 

Lower bound for the minimun frequency of an invariant condition to be unswitched. 

Number of nodes allowed for a loop unswitching regardless of the loop frequency. 

Allow backend to match complex expressions.

The maximum length of the methods context chains. 

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.

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.

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.

Maximum total size of NIO direct-buffer allocations. 

Max amount of extra effort to expend handling irreducible loops. A value <= 1 disables support for irreducible loops. 

The maximum length of the context used to model a heap object in addition to the allocation site; used only when 
ContextSensitiveHeap is enabled.

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.

The maximum free bytes reserved for allocations, in bytes (0 for automatic according to GC policy). Serial GC only. 

The maximum heap size at run-time, in bytes. 

Maximum number of invokes in a method so that it is considered trivial (for testing only). 

The maximum number of lines in the stack trace for Java exceptions (0 means all). 

The maximum size of the young generation at run-time, in bytes. 

Maximum number of nodes in a method so that it is considered trivial, if it does not have any invokes. 

Maximum number of nodes in a method so that it is considered trivial. 

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.

Maximum number of types allowed in the image. Used for tests where small number of types is necessary. 

Maximum number of methods allowed for runtime compilation. 

Maximum number of survivor spaces. Serial GC only.

Define the maximum number of stores for which the loop that zeroes out objects is unrolled. 

Maximum desired size of the compiler graph in nodes. 

The maximum length of an array that will be escape analyzed. 

The maximum heap size as percent of physical memory. Serial and epsilon GC only. 

Inlining is explored up to this number of nodes in the graph for each call site. 

Max number of loop explosions per method. 

Maximum level of recursive inlining. 

The maximum size of the young generation as a percentage of the maximum heap size. Serial and epsilon GC only. 

Minimum probability for methods to be inlined for megamorphic type profiles.

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.

Only check MethodFilter against the root method in the context if true, otherwise check all methods.

Pattern for matching methods. The syntax for a pattern is:.

Per-compilation method inlining exploration limit before giving up (use 0 to disable). 

Name of the main entry point method. Optional if --shared is used. 

File to which metrics are dumped per compilation.

The minimum length of the methods context chains. 

The minimum length of the context used to model a heap object in addition to the allocation site; used only when 
ContextSensitiveHeap is enabled.

The minimum heap size at run-time, in bytes. 

If applicable, use bulk zeroing instructions when the zeroing size in bytes exceeds this threshold. 

Minimal size in NodeSize to check the graph size increases of phases. 

Module containing the class that contains the main entry point. Optional if --shared is used. 

Move guard nodes to earlier places in the dominator tree if all successors of basic block share a common guard 
condition.

Enable support for threads and and thread-local variables (disable for single-threaded implementation).

Run level for NoDeadCodeVerifyHandler (0 = off, 1 = info, 2 = verbose, 3 = fatal). 

Name of the output file to be generated. 

Overrides CPUFeatures and uses the native architecture, i.e., the architecture of a machine that builds an image. 
NativeArchitecture takes precedence over CPUFeatures.

Pass the provided raw option that will be appended to the linker command to produce the final binary. The possible 
options are platform specific and passed through without any validation.

Pattern for disabling inlining of methods during image generation. [Extra help available] 

Create a C Annotation Processor Cache. Will erase any previous cache at that same location.

Counts the number of instances of each node class.

The number of threads to use for analysis during native image generation. The number must be smaller than the 
NumberOfThreads.

The maximum number of threads to use concurrently during native image generation. 

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.

Omit generation of DebugLineInfo originating from inlined methods.

Optimize static final fields that get a constant assigned in the class initializer.

Control native-image code optimizations: b - optimize for shortest build time, 0 - no optimizations, 1 - basic 
optimizations, 2 - aggressive optimizations.

Define PageSize of a machine that runs the image. The default = 0 (== same as host machine page size). 

When true, compiler graphs are parsed only once before static analysis. When false, compiler graphs are parsed for 
static analysis and again for AOT compilation.

Parse and consume standard options and system properties from the command line arguments when the VM is created.

Directory of the image file to be generated.

Percentage of total collection time that should be spent on young generation collections. Serial GC with collection 
policy 'BySpaceAndTime' only.

Determines if the collected performance data should be written to a memory-mapped file so that it can be accessed by 
external tools.

Size of performance data memory region. Will be rounded up to a multiple of the native os page size. 

Jvmstat instrumentation sampling interval (in milliseconds). 

Maximum PerfStringConstant string length before truncation. 

Enable the behavior of old GraalVM versions. When enabled, interfaces not available for the current platform are 
filtered.

Files describing predefined classes that can be loaded at runtime.

Resources describing predefined classes that can be loaded at runtime.

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.

Saves stack base pointer on the stack on method entry.

Print logging information during compilation.

Change the output format of the analysis call tree, available options are TXT and CSV. See: Reports.md. 

Print analysis call tree, a breadth-first tree reduction of the call graph.

Print analysis results statistics.

Enables dumping of basic blocks relative PC and frequencies in the dump directory.

Enable dumping scheduled HIR, LIR, register allocation and code generation info to the C1Visualizer.

Enable dumping CFG built during initial BciBlockMapping.

Print call edges with other analysis results statistics.

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).

Enable dumping canonical text from for graphs.

Prints class initialization info for all classes detected by analysis.

Print an informational line to the console for each completed compilation.

Print detailed information for each allocation site.

Print a list of active features.

Print extra help, if available, based on comma-separated option names. Pass * to show all options that contain extra 
help.

Show available options based on comma-separated option-types (allowed categories: User, Expert, Debug).

Print summary GC information after application main method returns. Serial GC only.

Print a time stamp at each collection, if +PrintGC or +VerboseGC. Serial GC only.

Print the time for each of the phases of each collection, if +VerboseGC. Serial GC only.

Print summary GC information after each collection.

Setting to true sets PrintGraph=file, setting to false sets PrintGraph=network.

Host part of the address to which graphs are dumped. 

Port part of the address to which graphs are dumped in binary format. 

Prints the difference in the graph state caused by each phase of the suite.

Schedule graphs as they are dumped.

Where IdealGraphVisualizer graph dumps triggered by Dump or DumpOnError should be written. [Extra help available] 

Print class statistics of native image heap.

Print the shape of the heap before and after each collection, if +VerboseGC. Serial GC only.

Print HIR along side LIR as the latter is generated.

Print the sizes of the elements of the built image.

Print the sizes of the native image heap as the image is built.

Print image object hierarchy.

Print JNI methods added to generated image.

Include the LIR as comments with the final assembly.

Print statistics of methods in native image heap.

Report analysis statistics.

Print profiling information when parsing a method's bytecode.

Print path for @RestrictHeapAccess warnings.

Print warnings for @RestrictHeapAccess annotations.

Print call tree of methods available for runtime compilation.

Print truffle boundaries found during the analysis.

Print types used for Java synchronization.

Print (to stderr) a DOT graph of the @Uninterruptible annotations.

Print information about classes, methods, and fields that are present in the native image.

Dump a graph even if it has not changed since it was last dumped. Change detection is based on adding and deleting 
nodes or changing inputs.

Control the naming and granularity of the counters when using ProfileAllocations. [Extra help available]

Enable profiling of allocation sites.

Track the progress of the static analysis.

Track the creation of constant objects.

Print logging information during object file writing.

Enable profiling of monitor operations.

Directory where query code for target platform should be output. 

Re-associate loop invariants and constants.

Disable optional dead code eliminations.

One or several (comma-separated) paths to JSON files that specify which program elements should be made available via 
reflection. [Extra help available]

Resources describing program elements to be made available for reflection (see ReflectionConfigurationFiles).

Enable trace logging for reflection plugins.

Comma separated list of registers that register allocation is limited to.

Allow a type flow state to contain types not compatible with its declared type.

Enable the type flow saturation analysis performance optimization.

Use linker option to prevent unreferenced symbols in image.

Report error if [:{,}] is discovered during analysis (valid values for UsageKind: 
InHeap, Allocated, Reachable).

Show exception stack traces for exceptions during image building.).

Report performed substitutions.

Print unsafe operation offset warnings.).

Report usage of unsupported methods and fields at run time when they are accessed the first time, instead of as an error 
during image building.

Files describing Java resources to be included in the image. 

Resources describing Java resources to be included in the image. 

Return after analysis.

Initializes and runs main entry point in a new native thread.

Run reachability handlers concurrently during analysis.

Enable or disable Java assert statements at run time. 

Comma separated list of CPU features that will be enabled for runtime checks. The native image may check at run time if 
such features are supported by the target CPU, and can optimize certain operations based on this information. If a
feature is not supported at run time, a less optimized variant will be executed. Because of the presence of multiple
code variants, enabling runtime features can result in larger executables. To completely turn off runtime checked CPU
features, set this option to the empty string. The specific options available are target platform dependent. See
--list-cpu-features for feature list. The default values are: AMD64: 'AVX,AVX2'; AArch64: ''.

Enable or disable Java system assertions at run time.

Exit the VM if I can not come to a safepoint in this many nanoseconds. 0 implies forever. 

Print a warning if I can not come to a safepoint in this many nanoseconds. 0 implies forever. 

Allow sampling-based profiling.

Object scanning in parallel.

One or several (comma-separated) paths to JSON files that specify lists of serialization configurations. [Extra help 
available]

Resources describing program elements to be made available for serialization (see SerializationConfigurationFiles).

One or several (comma-separated) paths to JSON files that specify lists of serialization configurations. [Extra help
available]

Resources describing program elements that must not be made available for serialization.

Comma-separated list of service providers that should be excluded.

Comma-separated list of services that should be excluded.

Build shared library.

Writes to the VM log information about the compiler configuration selected. 

Print the name of each dump file path as it's created.

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.

Handle simple cases for inflated monitors in the fast-path.

If the previous low-level graph size of the method exceeds the threshold, it is not inlined. 

Enable counters for various paths in snippets.

This number of milliseconds multiplied by the free heap memory in MByte is the time span for which a soft reference will 
keep its referent alive after its last access. Serial GC only.

Constrain debug info generation to the comma-separated list of package prefixes given to this option. 

Preserve the local variable information for every Java source line to allow line-by-line stepping in the debugger. Allow 
the lookup of Java-level method information, e.g., in stack traces.

Support multiple isolates. 

Select a strategy to mitigate speculative bounds check bypass (aka Spectre-PHT or Spectre V1). [Extra help available] 

Mask indices to scope access to allocation size after bounds check.

Move loop invariant guards (e.g., array bounds checks) out of loops.

Size (in bytes) of the red zone reserved at the end of the stack. This stack space can only be used by critical VM code 
and C code, e.g., to report fatal errors.

The size of each thread stack at run-time, in bytes. 

Provide method names for stack traces.

Size (in bytes) of the yellow zone reserved at the end of the stack. This stack space is reserved for VM use and cannot 
be used by the application.

Start flight recording with options. 

Builds a statically linked executable with libc dynamically linked.

Build statically linked executable (requires static libc and zlib).

Stress the code emitting explicit exception throwing code.

Stress the code emitting invokes with explicit exception edges.

Stress the code by emitting reads at earliest instead of latest point.

Causes unknown attributes in configuration objects to abort the image build instead of emitting a warning.

Perform checks that guards and deopts aren't introduced in graphs that should handle exceptions explicitly.

Use strict checks when performing query code compilation.

String.indexOf invocations will be evaluated at compile time if the receiver is a constant and its length is smaller 
than this value.

For internal usage. Instead, use the equivalent property 'jdk.virtualThreadScheduler.parallelism' as specified by JEP 
425 Virtual Threads (Project Loom).

Support runtime compilation in separate isolates (enable at runtime with option CompileInIsolates). 

Support continuations (without requiring a Project Loom JDK).

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.

Enable support for predefining additional classes.

Support a per-thread timer that is called at a specific interval.

Suppress console error output for unittests.

Suppress console normal output for unittests.

Selects native-image compilation target (in - format). Defaults to host's OS-architecture pair. 

The number of nanoseconds before tearing down an isolate gives a failure message. 0 implies no message. 

The number of nanoseconds before and between which tearing down an isolate gives a warning message. 0 implies no 
warning.

Directory for temporary files generated during native image generation. If this option is specified, the temporary files 
are not deleted so that you can inspect them after native image generation.

Throw unsafe operation offset errors.).

Pattern for specifying scopes in which timing is enabled. See the Dump option for the pattern syntax. An empty value 
enables all timers unconditionally.

Turn on the benchmark counters, and displays the results every n milliseconds. 

Comma separated names of timers that are enabled irrespective of the value for Time option. An empty value enables all 
timers unconditionally.

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.

Comma-separated list of fully-qualified class names that class initialization is traced for. 

Print logging information for runtime code cache modifications.

Print verbose logging information for every deoptimization.

Print logging information for every deoptimization.

Trace execution of stub used to handle an exception thrown by a callee.

Trace heap chunks during collections, if +VerboseGC and +PrintHeapShape. Serial GC only.

Traces inlining performed during bytecode parsing.

Enable inlining decision tracing in stubs and snippets.

Enable tracing of inlining decisions.

The trace level for the LIR generator. 

When enabled, localization feature details are printed.

When enabled, logging feature details are printed.

Trace monitor operations in methods whose fully qualified name contains this substring.

Trace monitor operations on objects whose type contains this substring.

Trace all native tool invocations as part of image building.

Comma-separated list of fully-qualified class names that object instantiation is traced for. 

Traces use of plugins during bytecode parsing.

Enable tracing of security services automatic registration.

When enabled, each service loader resource and class will be printed out to standard output.

Trace execution of the stub that routes an exception to a handler in the calling frame.

Trace VMOperation execution.

Track the callers for methods and accessing methods for fields.

Track the input for type flows.

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.

Track source stack trace where a node was inserted into the graph.

Track the NodeSourcePosition.

Determines if references from runtime-compiled code to Java heap objects should be treated as strong or weak.

Graphs with less than this number of nodes are trivial and therefore always inlined. 

Fail if a method known as not suitable for partial evaluation is reachable for runtime compilation.

Fail if a method known as not suitable for partial evaluation is reachable for runtime compilation.

Enforce that the Truffle runtime provides the only implementation of Frame.

Check that CompilerAsserts.neverPartOfCompilation is not reachable for runtime compilation.

Select a compiler configuration for Truffle compilation (default: use Graal system compiler configuration).

Maximum budget for Truffle host inlining for runtime compiled methods. 

Maximum budget for Truffle host inlining for runtime compiled methods with a BytecodeInterpreterSwitch annotation.

Determines the maximum call depth for exploration during host inlining.

Maximum number of subtree invokes for a subtree to get inlined until it is considered too complex. 

When logging is activated for this phase enables printing of only explored, but ultimately not inlined call trees.

Whether Truffle host inlining is enabled.

Inline trivial methods in Truffle graphs during native image generation.

Enable support for Truffle background compilation.

Propagate Truffle compilation errors.

Determines whether to treat final fields with default values as constant.

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.

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.

The maximum number of types recorded in a type flow. -1 indicates no limitation. 

Report unresolved elements as errors.

Unsafe automatic substitutions logging level: Disabled=0, Basic=1, Info=2, Debug=3.). 

Print unsafe operation offset warnings.).

Return the application path as the Class.getProtectionDomain().getCodeSource().getLocation() for all classes that have 
no explicit ProtectionDomain.

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.

Indicate the C Annotation Processor to use previously cached native information when generating C Type information.

Use callee saved registers to reduce spilling for low-frequency calls to stubs (if callee saved registers are supported 
by the architecture).

Enables CompilationStatistics.

Use compressed frame encoding for frames without local values.

Enable detection and runtime container configuration support.

Determines if VM operations should be executed in a dedicated thread.

Force many trampolines to be needed for inter-method calls. Normally trampolines are only used when a method destination 
is outside the range of a pc-relative branch instruction.

Use a no-op GC.

Use experimental Reachability Analysis instead of points-to.

Selects the libc implementation to use. Available implementations: glibc, musl, bionic.

Derive loop frequencies only from backedge frequencies instead of from loop exit frequencies.

Use new class initialization strategy that allows all classes to be used at image build time.

Determines if a null region is present between the heap base and the image heap.

Flag to disable jvmstat instrumentation for performance testing.

Use method summaries for Reachability Analysis.

Determines if a remembered sets is used, which is necessary for collecting the young and old generation independently.

Use a serial GC.

Automatically register services for run-time lookup using ServiceLoader.

Use a cache for snippet graphs.

Use a LRU cache for snippet templates.

Use traps for null checks instead of explicit null-checks.

Ratio of used bytes to total allocated bytes for eden space. Setting it to a smaller value will trade more triggered 
hinted GCs for less resident set size.

Print more information about the heap before and after each collection.

Emit extra code to dynamically check monitor operations are balanced.

Verify that all possible deoptimization entry points have been properly compiled and registered in the metadata.

Perform expensive verification of graph inputs, usages, successors and predecessors.

Verify graphs often during compilation when assertions are turned on.

Verify before - after relation of the relative, computed, code size of a graph.

Perform platform dependent validation of the Java heap at returns.

Verify the heap before and after each collection.

Verify that there are no new unused nodes when performing killCFG.

Verify naming conventions during image construction.

Verifies that the phase plan respects the phase ordering constraints.

Verify all object references if VerifyHeap is enabled. Serial GC only.

Verify the remembered set if VerifyHeap is enabled. Serial GC only.

Verify type states computed by the static analysis at run time. This is useful when diagnosing problems in the static 
analysis, but reduces peak performance significantly.

Verify write barriers. Serial GC only.

Pattern for specifying scopes in which logging is enabled. See the Dump option for the pattern syntax.

Print a warning when a missing intrinsic is seen.

Allocate code cache with write access, allowing inlining of objects.

Fill unused memory chunks with a sentinel value. Serial and epsilon GC only.

After use, Fill memory chunks with a sentinel value. Serial and epsilon GC only.

Before use, fill memory chunks with a sentinel value. Serial and epsilon GC only.

Default: - (disabled).