Mercurial > hg > graal-compiler
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