Mercurial > hg > graal-compiler
comparison README_GRAAL.txt @ 11592:4dbd3e3adda6
Merge
author | Mick Jordan <mick.jordan@oracle.com> |
---|---|
date | Tue, 10 Sep 2013 09:30:09 -0700 |
parents | c106320fab79 |
children | a8132e3fd0d8 |
comparison
equal
deleted
inserted
replaced
11591:e460aa80fa46 | 11592:4dbd3e3adda6 |
---|---|
12 % mx build | 12 % mx build |
13 | 13 |
14 This builds the 'product' version of HotSpot with the Graal modifications. | 14 This builds the 'product' version of HotSpot with the Graal modifications. |
15 To build the debug or fastdebug versions: | 15 To build the debug or fastdebug versions: |
16 | 16 |
17 mx build debug | 17 mx --vmbuild debug build |
18 mx build fastdebug | 18 mx --vmbuild fastdebug build |
19 | 19 |
20 Running Graal | 20 Running Graal |
21 ------------- | 21 ------------- |
22 | 22 |
23 To run the VM, use 'mx vm' in place of the standard 'java' command: | 23 To run the VM, use 'mx vm' in place of the standard 'java' command: |
24 | 24 |
25 % mx vm ... | 25 % mx vm ... |
26 | 26 |
27 To select the fastdebug or debug versions of the VM: | 27 To select the fastdebug or debug versions of the VM: |
28 | 28 |
29 % mx --fastdebug vm ... | 29 % mx --vmbuild fastdebug vm ... |
30 % mx --debug vm ... | 30 % mx --vmbuild debug vm ... |
31 | 31 |
32 Graal has an optional bootstrap step where it compiles itself before | 32 Graal has an optional bootstrap step where it compiles itself before |
33 compiling any application code. This bootstrap step currently takes about 7 seconds | 33 compiling any application code. This bootstrap step currently takes about 20 seconds |
34 on a fast x64 machine. It's useful to disable this bootstrap step when running small | 34 on a fast x64 machine. It's useful to disable this bootstrap step when running small |
35 programs with the -XX:-BootstrapGraal options. For example: | 35 programs with the -XX:-BootstrapGraal options. For example: |
36 | 36 |
37 % mx vm -XX:-BootstrapGraal ... | 37 % mx vm -XX:-BootstrapGraal ... |
38 | 38 |
43 By default the build commands above create a HotSpot binary where Graal | 43 By default the build commands above create a HotSpot binary where Graal |
44 is the only compiler. This binary is the Graal VM binary and identifies as | 44 is the only compiler. This binary is the Graal VM binary and identifies as |
45 such with the -version option: | 45 such with the -version option: |
46 | 46 |
47 % mx vm -XX:-BootstrapGraal -version | 47 % mx vm -XX:-BootstrapGraal -version |
48 java version "1.7.0_07" | 48 java version "1.7.0_25" |
49 Java(TM) SE Runtime Environment (build 1.7.0_07-b10) | 49 Java(TM) SE Runtime Environment (build 1.7.0_25-b15) |
50 OpenJDK 64-Bit Graal VM (build 25.0-b10-internal, mixed mode) | 50 OpenJDK 64-Bit Graal VM (build 25.0-b43-internal, mixed mode) |
51 | 51 |
52 It's also possible to build and execute the standard HotSpot binaries | 52 It's also possible to build and execute the standard HotSpot binaries |
53 using the --vm option: | 53 using the --vm option: |
54 | 54 |
55 % mx --vm server build | 55 % mx --vm server build |
56 % mx --vm server vm -version | 56 % mx --vm server vm -version |
57 java version "1.7.0_07" | 57 java version "1.7.0_25" |
58 Java(TM) SE Runtime Environment (build 1.7.0_07-b10) | 58 Java(TM) SE Runtime Environment (build 1.7.0_25-b15) |
59 OpenJDK 64-Bit Server VM (build 25.0-b10-internal, mixed mode) | 59 OpenJDK 64-Bit Server VM (build 25.0-b43-internal, mixed mode) |
60 | 60 |
61 These standard binaries still include the code necessary to support use of the | 61 These standard binaries still include the code necessary to support use of the |
62 Graal compiler for explicit compilation requests. However, in this configuration | 62 Graal compiler for explicit compilation requests. However, in this configuration |
63 the Graal compiler will not service VM issued compilation requests (e.g., upon | 63 the Graal compiler will not service VM issued compilation requests (e.g., upon |
64 counter overflow in the interpreter). | 64 counter overflow in the interpreter). |
65 | 65 |
66 To build a HotSpot binary that completely omits all VM support for Graal, | 66 To build and run a HotSpot binary that completely omits all VM support for Graal, |
67 define an environment variable OMIT_GRAAL (its value does not matter) and build | 67 use the following as a guide: |
68 with the --vm option as above (doing a clean first if necessary): | |
69 | 68 |
70 % env OMIT_GRAAL= mx --vm server build | 69 % mx --vm server-nograal build |
70 % mx --vm server-nograal vm -version | |
71 java version "1.7.0_25" | |
72 Java(TM) SE Runtime Environment (build 1.7.0_25-b15) | |
73 OpenJDK 64-Bit Server VM (build 25.0-b43-internal, mixed mode) | |
74 | |
75 % mx --vm client-nograal build | |
76 % mx --vm client-nograal vm -version | |
77 java version "1.7.0_25" | |
78 Java(TM) SE Runtime Environment (build 1.7.0_25-b15) | |
79 OpenJDK 64-Bit Cleint VM (build 25.0-b43-internal, mixed mode) | |
80 |