Mercurial > hg > release > icedtea7-2.5
view README @ 2789:d4df8b91c361
PR2341: Update README & INSTALL files
2015-07-06 Andrew John Hughes <gnu.andrew@member.fsf.org>
* INSTALL: Update list of detected
JDKs, specifying that bootstrap mode is
not specific to Classpath JDKs. Remove
dead --with-netbeans-home, --with-ant-home,
--with-xalan2-jar, --with-xalan2-serializer-jar,
--with-xerces2-jar, --enable-systemtap and
--with-gcj-home options. Document --with-jdk-home.
Move --enable-system-kerberos to be listed with other
system library options. Update XRender and SystemTap
documentation. Document the SunEC provider. Update
list of architectures supported by native HotSpot ports.
Mention ARM32 JIT.
* NEWS: Updated.
* README: Remove outdated notes about in-development
OpenJDK 7. Update list of architectures supported
by native HotSpot ports and mention ARM32 JIT.
Remove section about PulseAudio mixer (moved
to IcedTea-Sound).
* acinclude.m4:
(IT_CHECK_FOR_JDK): Match ICEDTEA7_VMS ordering
to ICEDTEA6_VMS ordering.
author | Andrew John Hughes <gnu_andrew@member.fsf.org> |
---|---|
date | Tue, 07 Jul 2015 00:14:45 +0100 |
parents | 91cb89e3e986 |
children |
line wrap: on
line source
IcedTea7 ======== The IcedTea project provides a harness to build the source code from openjdk.java.net using Free Software tools and dependencies. IcedTea addresses two problems: it eliminates the build requirement on proprietary build tools and provides additional patches and features (such as Javascript support via Rhino) not available in OpenJDK. IcedTea also provides build scripts and patches that fix a number of issues which are as yet unresolved upstream. See INSTALL for build instructions. Homepage (wiki): http://icedtea.classpath.org/ Bugs (bugzilla): http://icedtea.classpath.org/bugzilla Mailing List: distro-pkg-dev@openjdk.java.net http://mail.openjdk.java.net/mailman/listinfo/distro-pkg-dev FAQ: http://icedtea.classpath.org/wiki/FrequentlyAskedQuestions Anonymous Mercurial checkout: hg clone http://icedtea.classpath.org/hg/icedtea Java compatibility ------------------ IcedTea is derived from OpenJDK, an open-source implementation of the Java SE platform. See http://openjdk.java.net/groups/conformance/ for information on compatibility testing. A Note About License Headers ---------------------------- Some sources downloaded from openjdk.java.net do not display the GPL license header. Instances are: - We are assuming that these files are owned by Sun/Oracle: openjdk/jdk/src/share/classes/**/resources/*.properties The Zero Assembler and Shark Ports ================================== Gary Benson has developed a port of the interpreter included in the HotSpot virtual machine which avoids using any assembly language. As a pure C++ interpreter, it should be possible to build this on most architectures and have a working (albeit slow) version of OpenJDK. Successful builds have been made on ppc, ppc64 and arm. The zero assembler port is enabled by default on platforms without a native HotSpot port (i.e. other than x86, x86_64, sparc, AArch64, ppc64, ppc64le). To enable it on these platforms, use the --enable-zero option. Gary is now working on a JIT called Shark to provide better performance on platforms which need to use the zero port. A preliminary version of this is now included with IcedTea and can be built with the --enable-shark option. On ARM32, there is also a native JIT port built on top of Zero, which is built on this platform by default. CACAO as VM =========== The CACAO virtual machine (http://cacaovm.org) can be used as an alternative to the HotSpot virtual machine. One advantage of this is that it already provides a JIT for many platforms to which HotSpot has not yet been ported, including ppc, arm and mips. To use CACAO as the VM, use the --with-cacao option. This will download a snapshot of CACAO during the build, which has been tested with this version of IcedTea7. The environment variable CACAO_CONFIGURE_ARGS can be used to pass additional arguments to the cacao configure. SystemTap Support ================= configure will try to find the systemtap runtime development files (sdt.h and the dtrace python script wrapper), enable compilation of static markers in the hotspot code and install a systemtap hotspot.stp tapset for easy tracing with systemtap's stap utility. The probes are documented in tapset/hotspot.stp. This requires the systemtap-sdt-devel package as a build dependency and optionally the systemtap package at run time when the user want to use the tapset to trace Java programs. The probes have zero overhead when not used and can safely be compiled in even when not used at runtime. Support for Additional VMs ========================== Although IcedTea can be built multiple times to use a different virtual machine, additional VMs can be built without building the other components multiple times. On architectures where hotspot is available, use --with-additional-vms=cacao,zero (or shark instead of zero) on architectures where only zero (or shark) is available, use --with-additional-vms=cacao to build the additional VM's. It's not possible to build cacao as the default VM, and zero as additional VM. To build zero as the default VM and shark as an additional VM, use --enable-zero --with-additional-vms=shark The additional VM's are available by calling the java with the option `-cacao', `-zero' or `-shark', or by calling the java tools with `-J-<vm name>'. If the build was configured with '--enable-shark', use `-Xint' to just use the zero VM.