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

-Xlp:codecache

Requests the OpenJ9 VM to allocate the JIT code cache by using large page sizes.

If the requested large page size is not available, the VM starts, but the JIT code cache is allocated by using a platform-defined size. A warning is displayed when the requested page size is not available.

To find out the large page sizes available and the current setting, use the -verbose:sizes option. Note that the current settings are the requested sizes and not the sizes obtained. For object heap size information, check the -verbose:gc output.

Syntax

AIX®, Linux®, macOS®, and Windows™:

    -Xlp:codecache:pagesize=<size>

z/OS®:

    -Xlp:codecache:pagesize=<size>,pageable

See Using -X command-line options for more information about the <size> parameter.

Default values

AIX

The code cache page size is controlled by the DATAPSIZE setting of the LDR_CNTRL environment variable. The page size cannot be controlled by the -Xlp:codecache:pagesize=<size> option. Specifying any other page size results in a warning that the page size is not available. The -verbose:sizes output reflects the current operating system setting.

For more information about the LDR_CNTRL environment variable, see Working with the LDR_CNTRL environment variable.

Linux

The default size for the code cache depends on the architecture:

  • Linux on x86 and AMD64/EM64T systems: 2 MB large pages
  • Linux on IBM Z®: 1 MB large pages
  • Linux on Power Systems™: The code cache page size cannot be controlled by the -Xlp:codecache:pagesize=<size> option. Specifying any other page size results in a warning that the page size is not available. The -verbose:sizes output reflects the current operating system setting.
  • On other architectures, the VM uses the default operating system page size.

macOS

The default size for the code cache is 4 KB large pages.

z/OS

1 MB pageable pages, when available, are the default size for the code cache.

The -Xlp:codecache:pagesize=<size>,pageable option supports only a large page size of 1 MB pageable large pages. The use of 1 MB pageable large pages for the JIT code cache can improve the runtime performance of some Java™ applications. A page size of 4 KB can also be used.

See also