Back to Zing Documentation Home

Using ZVM with the Falcon Compiler

The Falcon compiler is the default optimizing JIT (Just-In-Time) compiler in the Zing VM.

Falcon Compiler Features

Supported Java platforms: Java 7, Java 8, and Java 11

Recommended Hardware: Modern Intel Chipset (Haswell or later)

Falcon Optimization Notes

The main focus of the Falcon compiler is generating high performance code. This may result in longer compile times because additional CPU time is required for higher levels of optimization. Longer Falcon compile times can increase the application startup and warm-up times when compared to the startup and warm-up times when running the ZVM using the C2 compiler.

Falcon fully supports Azul ReadyNow! technology, which helps improve consistency of application performance during warmup.

While future versions of Zing will likely include automatic ongoing eviction of contents in the Falcon cache, the current Zing version does not, and as of version 18.01.0.0, the Falcon cache is not automatically cleared or evicted. The cache will accumulate contents up to FalconMaxCacheSize. Once it reaches that size, newly encountered compilations will no longer be added to the cache. The cache can be reset at any time (including while the Zing JVM is running) by destroying the contents of the cache with, for example, rm -r .zing-falcon-cache.

History and Alternatives

The Falcon compiler first became available as a feature in Zing version 16.12.0.0. Falcon became the default optimizing compiler in version 17.03.0.0.

If, for some reason, you need to switch to C2, use the -XX:+UseC2 option. For example,

$JAVA_HOME/bin/java -XX:+UseC2 –cp . myprog

Note that while C2 is entirely supported, active development has mostly stopped. As such, switching to C2 should be seen as a workaround until a Falcon issue can be resolved, and you are encouraged to retry Falcon after every major upgrade.

Performance Analysis

Run Zing Vision Robot (ZVRobot), the profiling and diagnostic snapshot collection tool for the Zing Virtual Machine (ZVM), together with the application. Basic ZVRobot Usage:

  1. To the ZVM command-line options add:
    • -Xloggc:gclogfile_%t_%p.log
    • -XX:ARTAPort=12345 -XX:+UseTickProfiler
    • -XX:EventTickBufferDataBufferMargin=1000
  2. Optionally, configure the VM to collect compiler intermediate representation (IR) dumps for sharing with Azul Support
    • -XX:FalconIRDumpRoot=<path> – sets the directory in which to dump IR. If not set, defaults to ./falcon-ir.
    • -XX:FalconDumpIRToDiskOf=* – tells the Falcon compiler to dump its internal IR for compiles which match the specified pattern to disk. This IR can be provided to Azul Support to assist in analyzing performance issues. Enabling this option may affect the performance of the application. This option should not be used outside of a test environment.
  1. Configure ZVRobot to connect to the ZVM by modifying the ZVRobot properties file. You can configure ZVRobot to collect different amounts of information. Please refer to the Using Zing Vision Robot chapter for more details about the tool.
  2. Start ZVRobot using the modified properties file created in step 3. Example command: java -jar ZVRobot-<version>.jar <output_directory> ZVRobot.prop.

See Also


© Azul Systems, Inc. 2020 All rights reserved.

Privacy Policy | Legal | Terms of Use