diff README_GRAAL.txt @ 7154:5d0bb7d52783

changes to support Graal co-existing with the other HotSpot compiler(s) and being used for explicit compilation requests and code installation via the Graal API
author Doug Simon <doug.simon@oracle.com>
date Wed, 12 Dec 2012 21:36:40 +0100
parents a89a18a57617
children 3a6a718af535
line wrap: on
line diff
--- a/README_GRAAL.txt	Wed Dec 12 15:46:11 2012 +0100
+++ b/README_GRAAL.txt	Wed Dec 12 21:36:40 2012 +0100
@@ -9,7 +9,7 @@
 Building both the Java and C++ source code comprising the Graal VM
 can be done with the following simple command.
 
-  mx build
+% mx build
 
 This builds the 'product' version of HotSpot with the Graal modifications.
 To build the debug or fastdebug versions:
@@ -22,16 +22,49 @@
 
 To run the VM, use 'mx vm' in place of the standard 'java' command:
 
-  mx vm ...
+% mx vm ...
 
 To select the fastdebug or debug versions of the VM:
 
-  mx --fastdebug vm ...
-  mx --debug vm ...
+% mx --fastdebug vm ...
+% mx --debug vm ...
 
 Graal has an optional bootstrap step where it compiles itself before
 compiling any application code. This bootstrap step currently takes about 7 seconds
 on a fast x64 machine. It's useful to disable this bootstrap step when running small
 programs with the -XX:-BootstrapGraal options. For example:
 
-  mx vm -XX:-BootstrapGraal ...
+% mx vm -XX:-BootstrapGraal ...
+
+
+Other Build Configurations
+--------------------------
+
+By default the build commands above create a HotSpot binary where the Graal
+is the only compiler. This binary is the Graal VM binary and identifies as
+such with the -version option:
+
+% mx vm -XX:-BootstrapGraal -version
+java version "1.7.0_07"
+Java(TM) SE Runtime Environment (build 1.7.0_07-b10)
+OpenJDK 64-Bit Graal VM (build 25.0-b10-internal, mixed mode)
+
+It's also possible to build and execute the standard HotSpot binaries
+using the --vm option:
+
+% mx --vm server build
+% mx --vm server vm -version
+java version "1.7.0_07"
+Java(TM) SE Runtime Environment (build 1.7.0_07-b10)
+OpenJDK 64-Bit Server VM (build 25.0-b10-internal, mixed mode)
+
+These standard binaries still include the code necessary to support use of the
+Graal compiler for explicit compilation requests. However, in this configuration
+the Graal compiler will not service VM issued compilation requests (e.g., upon
+counter overflow in the interpreter).
+
+To build a HotSpot binary that completely omits all VM support for Graal,
+define an environment variable OMIT_GRAAL (its value does not matter) and build
+with the --vm option as above (doing a clean first if necessary):
+
+% env OMIT_GRAAL= mx --vm server build