Skip to content

CAUTION: This site hosts draft documentation for the next release. For published content of the latest release, visit www.eclipse.org/openj9/docs

-Xjit / -Xnojit

Use this option to control the behavior of the JIT compiler.

Specifying -Xjit with no parameters has no effect because the JIT compiler is enabled by default.

Specifying -Xnojit turns off the JIT compiler but does not affect the AOT compiler.

Specify the -Xjit option only once. By default, if you specify this option multiple times, only the last option takes effect. You can use the -XX:+MergeCompilerOptions option to merge all the existing instances of the -Xjit options logically.

You can specify multiple parameters for the -Xjit option by using commas to separate the parameters. For example:

-Xjit:enableGPU,exclude={ilog/rules/engine/sequential/generated/*}

Parameters such as exclude are additive so you can specify them multiple times within the same -Xjit option.

Syntax

Setting Action Default
-Xjit Enable JIT yes
-Xjit[:<parameter>=<value>{,<parameter>=<value>}] Enable JIT with options
-Xnojit Disable JIT

Parameters

These parameters can be used to modify the behavior of -Xjit:

Parameter Effect
count Specifies the number of times a method is called before it is compiled.
disableRMODE64 Allows the JIT to allocate executable code caches above the 2 GB memory bar.
enableGPU Allows the JIT to offload certain processing tasks to a graphics processing unit (GPU)
exclude Excludes the specified method from compilation.
limit Includes the specified method in compilation.
limitFile Compile methods that are listed in the limit file.
optlevel Forces the JIT compiler to compile all methods at a specific optimization level.
verbose Reports information about the JIT and AOT compiler configuration and method compilation.
vlog Sends verbose output to a file.
perfTool Facilitates JIT-compiled code symbol resolution when profiling the VM on Linux.

count

    -Xjit:count=<n>
Specifies the number of times, <n>, a method is called before it is compiled. For example, setting count=0 forces the JIT compiler to compile everything on first execution, which is useful for problem determination.

disableRMODE64

(z/OS® only)

    -Xjit:disableRMODE64
From z/OS V2R3, residency mode for 64-bit applications (RMODE64) is enabled by default. This feature allows the JIT to allocate executable code caches above the 2 GB memory bar, which is the default behavior. Use this option to turn off this JIT behavior.

enableGPU

(Windows (x86-64) or Linux (x86-64 and IBM POWER LE))

    -Xjit:enableGPU
Enables the JIT compiler to offload certain processing tasks to a graphics processing unit (GPU). The JIT determines which functions to offload based on performance heuristics. Systems must support NVIDIA Compute Unified Device Architecture (CUDA). The JIT requires the CUDA Toolkit 7.5 and your GPU device must have a minimum compute capability of 3.0.
To troubleshoot operations between the JIT compiler and the GPU, use -Xjit:enableGPU={verbose}, which provides output showing the processing tasks that are offloaded and their status. To send this output to a file (output.txt), run -Xjit:enableGPU={verbose},vlog=output.txt when you start your application.

exclude

    -Xjit:exclude={<method>}

Excludes the specified method from compilation.

<method_name> is the method or methods that are to be excluded; the wildcard * may be used. Specify as much of the full package, class and method as necessary.

For example, -Xjit:exclude={test/sample/MyClass.testMethod()V} excludes the single method specified.
However, -Xjit:exclude={test/sample/MyClass.testMethod()*} excludes the method regardless of return type.
Similarly, -Xjit:exclude={*} excludes all methods.

Note: exclude has the same effect regardless of whether it is specified on -Xaot or -Xjit. In consequence, if you specify -Xjit:exclude, AOT compilation is also prevented and the methods specified are always interpreted.

limit

    -Xjit:limit={<method_name>}
Only the Java™ methods specified are included when code is compiled or loaded from the shared classes cache. <method_name> is the method or methods that are to be included (the wildcard * can be used, see -Xjit:exclude for details).
Note: limit has the same effect regardless of whether it is specified on -Xaot or -Xjit. In consequence, if you specify -Xjit:limit, AOT compilation is also restricted to those methods specified; other methods are always interpreted.

limitFile

    -Xjit:limitFile=(<vlog_filename>, <m>, <n>)
Compile only the methods that are listed on lines <m> to <n> in the specified limit file, where the limit file is a verbose log that you generated with the -Xjit:verbose,vlog=<vlog_filename> option. Methods that are not listed in the limit file and methods that are listed on lines outside the range are not compiled.
Note: limitFile has the same effect regardless of whether it is specified on -Xaot or -Xjit. In consequence, if you specify -Xjit:limitFile, AOT compilation is also restricted to those methods specified; other methods are always interpreted.

optlevel

    -Xjit:optlevel=[noOpt|cold|warm|hot|veryHot|scorching]
Forces the JIT compiler to compile all methods at a specific optimization level. Specifying optlevel might have an unexpected effect on performance, including reduced overall performance.

verbose

    -Xjit:verbose
Generates a JIT verbose log. The log provides a summary of which methods were compiled by the JIT and some of the compilation heuristic decisions that were taken while the JIT operates inside the Eclipse OpenJ9™ VM.
-Xjit:verbose={compileStart}

Prints a line when the JIT is about to start compiling a method.

-Xjit:verbose={compileEnd}

Prints a line when the JIT stops compiling a method.

-Xjit:verbose={compilePerformance}

Adds the values time (time taken to do the compilation) and mem (the amount of memory that was allocated during the compilation) into each line. This option includes the compileStart and compileEnd suboptions by default.

-Xjit:verbose={disableInlining}

Turns off inlining operations.

-Xjit:verbose={inlining}

Shows the methods that are inlined.

Note: Suboptions can be chained together by using a pipe (|) symbol. When used, you must enclose the full option name in single quotation marks (') to avoid the shell misinterpreting these characters as pipe commands. For example:

java '-Xjit:verbose={compileStart|compileEnd|inlining}' -version

vlog

    -Xjit:vlog=<vlog_filename>
Sends verbose output to a file, of the format <vlog_filename>.<date>.<time>.<JVM_process_ID>, which is created in your current directory. Running the command multiple times produces multiple distinct versions of this file. If you do not specify this parameter, the output is sent to the standard error output stream (STDERR). This type of log file can be used with the limitFile suboption to target the compilation of specific methods.

perfTool

    -Xjit:perfTool
generates a /tmp/perf-<pid>.map file for the JIT-compiled code. This file is used by the Linux® system profiler, perf, to map the samples in the JIT-compiled code to the corresponding Java method names for profiling the VM.

For more information, see -XX:[+|-]PerfTool.

Examples

Generating a JIT verbose log

The following example requests a JIT verbose log of the java -version command:

java -Xjit:verbose,vlog=vlogfile -version

Analyzing JIT performance

The following example requests information about the performance of JIT compiler threads, with output written to vlogfile.

java -Xjit:verbose={compilePerformance},vlog=vlogfile -version

The output generated by using this command adds the following information to compilation entry:

  • the amount of time taken to do the compilation.
  • the amount of memory that was allocated during the compilation.

Analyzing inlining operations

The following example generates output that contains performance data and inlining operations. The suboptions count and -XcompilationThreads1 are used only to simplify the output. These options are not recommended for production because performance will be affected.

java '-Xjit:verbose={compileStart|compileEnd|inlining},count=5,vlog=vlogfile' -XcompilationThreads1 -version

See also