Mercurial > hg > truffle

comparison README_GRAAL.txt @ 11558:c106320fab79

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated README_GRAAL.txt to reflect recent mx changes
author Doug Simon <doug.simon@oracle.com>
date Tue, 10 Sep 2013 00:15:32 +0200
parents 3a6a718af535
children a8132e3fd0d8
comparison
equal deleted inserted replaced
11557:e08a9328ce92 11558:c106320fab79
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