truffle: README.md annotate

annotate README.md @ 15388:769fc3629f59

Add phase FlowSensitiveReductionPhase. It is possible to remove GuardingPiNodes, CheckCastNodes, and FixedGuards during HighTier under certain conditions (control-flow sensitive conditions). The phase added in this commit (FlowSensitiveReductionPhase) does that, and in addition replaces usages with "downcasting" PiNodes when possible thus resulting in more precise object stamps (e.g., non-null). Finally, usages of floating, side-effects free, expressions are also simplified (as per control-flow sensitive conditions). The newly added phase runs only during HighTier and can be deactivated using Graal option FlowSensitiveReduction (it is active by default).

author	Miguel Garcia <miguel.m.garcia@oracle.com>
date	Fri, 25 Apr 2014 16:50:52 +0200
parents	8dfd3f53ba4a
children	271eee87201c

rev	line source
13962 258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	1 ## Building Graal
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	2
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	3 There is a Python script in mxtool/mx.py that simplifies working with the code
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	4 base. It requires Python 2.7. While you can run this script by using an absolute path,
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	5 it's more convenient to add graal/mxtool to your PATH environment variable so that the
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	6 'mx' helper script can be used. The following instructions in this file assume this
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	7 setup.
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	8
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	9 Building both the Java and C++ source code comprising the Graal VM
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	10 can be done with the following simple command.
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	11
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	12 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	13 % mx build
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	14 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	15
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	16 There are a number of VM configurations supported by mx which can
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	17 be explicitly specified using the --vm option. However, you'll typically
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	18 want one of these VM configurations:
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	19
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	20 1. The 'server' configuration is a standard HotSpot VM that includes the
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	21 runtime support for Graal but uses the existing compilers for normal
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	22 compilation (e.g., when the interpreter threshold is hit for a method).
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	23 Compilation with Graal is only done by explicit requests to the
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	24 Graal API. This is how Truffle uses Graal.
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	25
14722 8dfd3f53ba4a Update vm descriptions in readme Gilles Duboscq <duboscq@ssw.jku.at> parents: 13964 diff changeset	26 2. The 'graal' configuration is a VM where normal compilations are performed
8dfd3f53ba4a Update vm descriptions in readme Gilles Duboscq <duboscq@ssw.jku.at> parents: 13964 diff changeset	27 by Graal. This VM will bootstrap Graal itself at startup unless the
8dfd3f53ba4a Update vm descriptions in readme Gilles Duboscq <duboscq@ssw.jku.at> parents: 13964 diff changeset	28 -XX:-BootstrapGraal. Note that if tiered compilation is enabled, Graal
8dfd3f53ba4a Update vm descriptions in readme Gilles Duboscq <duboscq@ssw.jku.at> parents: 13964 diff changeset	29 will be used at the last tier while C1 will be used for the first compiled
8dfd3f53ba4a Update vm descriptions in readme Gilles Duboscq <duboscq@ssw.jku.at> parents: 13964 diff changeset	30 tiers.
13962 258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	31
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	32 Unless you use the --vm option with the build command, you will be presented
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	33 with a dialogue to choose one of the above VM configurations for the build
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	34 as well as have the option to make it your default for subsequent commands
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	35 that need a VM specified.
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	36
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	37 To build the debug or fastdebug builds:
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	38
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	39 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	40 % mx --vmbuild debug build
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	41 % mx --vmbuild fastdebug build
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	42 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	43
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	44 ## Running Graal
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	45
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	46 To run the VM, use 'mx vm' in place of the standard 'java' command:
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	47
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	48 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	49 % mx vm ...
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	50 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	51
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	52 To select the fastdebug or debug builds of the VM:
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	53
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	54 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	55 % mx --vmbuild fastdebug vm ...
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	56 % mx --vmbuild debug vm ...
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	57 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	58
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	59 ## Other VM Configurations
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	60
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	61 In addition to the VM configurations described above, there are
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	62 VM configurations that omit all VM support for Graal:
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	63
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	64 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	65 % mx --vm server-nograal build
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	66 % mx --vm server-nograal vm -version
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	67 java version "1.7.0_25"
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	68 Java(TM) SE Runtime Environment (build 1.7.0_25-b15)
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	69 OpenJDK 64-Bit Server VM (build 25.0-b43-internal, mixed mode)
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	70 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	71
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	72 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	73 % mx --vm client-nograal build
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	74 % mx --vm client-nograal vm -version
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	75 java version "1.7.0_25"
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	76 Java(TM) SE Runtime Environment (build 1.7.0_25-b15)
13964 8df361535530 Fix typo. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: 13962 diff changeset	77 OpenJDK 64-Bit Client VM (build 25.0-b43-internal, mixed mode)
13962 258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	78 ```
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	79
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	80 These configurations aim to match as closely as possible the
258a09b6449b Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. Thomas Wuerthinger <thomas.wuerthinger@oracle.com> parents: diff changeset	81 VM(s) included in the OpenJDK binaries one can download.

Mercurial > hg > truffle

annotate README.md @ 15388:769fc3629f59