/hg/icedtea: 7 new changesets
andrew at icedtea.classpath.org
andrew at icedtea.classpath.org
Thu Jul 22 16:32:00 PDT 2010
changeset 0e3aba9022ce in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=0e3aba9022ce
author: Andrew John Hughes <ahughes at redhat.com>
date: Thu Jul 22 22:58:42 2010 +0100
Update documentation and configure help output.
2010-07-22 Andrew John Hughes <ahughes at redhat.com>
* INSTALL,
* README: Updated to match current state of play and extended
with missing information.
* acinclude.m4: Add parameter information to configure help
for all options. (FIND_ENDORSED_JARS): Remove unused macro
and correct typos.
* configure.ac: Make the --disable-plugin help clearer by
replacing 'LiveConnect plugin' with 'browser plugin'.
changeset 199a7a1f9a66 in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=199a7a1f9a66
author: Omair Majid <omajid at redhat.com>
date: Thu Jun 24 09:40:43 2010 -0400
netx: handle JNLP files which use native libraries but do not
indicate it
2010-06-24 Omair Majid <omajid at redhat.com>
* netx/net/sourceforge/jnlp/SecurityDesc.java: Fix comments.
* netx/net/sourceforge/jnlp/JNLPClassLoader.java (activateJars):
Always call activateNative. (activateNative): Search for native
code anywhere in the jar.
changeset 1a13fd8125c7 in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=1a13fd8125c7
author: Omair Majid <omajid at redhat.com>
date: Tue Jun 29 14:19:38 2010 -0400
Netx: make path sanitization consistent; use a blacklisting
approach.
2010-06-29 Omair Majid <omajid at redhat.com>
* netx/net/sourceforge/jnlp/cache/CacheUtil.java
(urlToPath): Call FileUtils.sanitizePath. (fixPath): Moved to...
* netx/net/sourceforge/jnlp/util/FileUtils.java (sanitizePath):
New function. Moved from CacheUtil.java (sanitizeFileName): Use
a blacklisting approach rather than a whitelisting approach:
should work better with non ascii filenames.
changeset a8117b0af51d in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=a8117b0af51d
author: Omair Majid <omajid at redhat.com>
date: Tue Jun 29 14:26:57 2010 -0400
Netx: make the SingleInstanceServer thread a daemon thread
2010-06-29 Omair Majid <omajid at redhat.com>
* netx/net/sourceforge/jnlp/services/XSingleInstanceService.java
(startListeningServer): Mark the thread as a daemon so the JVM can
shutdown if there are no other non-daemon thread running.
changeset 3ac6591eded8 in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=3ac6591eded8
author: Omair Majid <omajid at redhat.com>
date: Tue Jun 29 15:48:10 2010 -0400
Netx: allow jnlp classloaders to share native libraries 2010-06-29
Omair Majid <omajid at redhat.com>
* netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java
nativeDirectories: New variable. Contains a list of directories that
contain native libraries. (getInstance): Tell other classloaders
about the native directory. (getNativeDir): Add the new native
directory to nativeDirectories. (addNativeDirectory): New
function. (getNativeDirectories): New function.
(findLibrary): Look in all the native directories for the native
library.
changeset aca7e8363025 in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=aca7e8363025
author: Omair Majid <omajid at redhat.com>
date: Thu Jul 08 14:25:02 2010 -0400
PR460: Add ForbiddenTargetException for legacy support.
2010-07-08 Omair Majid <omajid at redhat.com>
PR icedtea/460
* plugin/icedteanp/java/netscape/security/ForbiddenTargetException.jav
a: New file. Some applets, for legacy support, expect this class
to be present.
changeset b52dc7f36b70 in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=b52dc7f36b70
author: Omair Majid <omajid at redhat.com>
date: Fri Jul 23 00:26:40 2010 +0100
RH506730: BankID (Norwegian common online banking authentication
system) applet fails to load.
2010-07-08 Omair Majid <omajid at redhat.com>
* plugin/icedteanp/java/sun/applet/PluginAppletViewer.java:
(reFrame): Pass the panel to the constructor, dont set it yourself.
(PluginAppletViewer): Set the panel to be the passed in object and
only then add it to the list of all panels.
diffstat:
12 files changed, 598 insertions(+), 291 deletions(-)
ChangeLog | 60 +
INSTALL | 383 +++++++---
README | 83 --
acinclude.m4 | 122 +--
configure.ac | 2
netx/net/sourceforge/jnlp/SecurityDesc.java | 9
netx/net/sourceforge/jnlp/cache/CacheUtil.java | 17
netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java | 93 +-
netx/net/sourceforge/jnlp/services/XSingleInstanceService.java | 11
netx/net/sourceforge/jnlp/util/FileUtils.java | 51 -
plugin/icedteanp/java/netscape/security/ForbiddenTargetException.java | 52 +
plugin/icedteanp/java/sun/applet/PluginAppletViewer.java | 6
diffs (truncated from 1483 to 500 lines):
diff -r 0cae6a810c07 -r b52dc7f36b70 ChangeLog
--- a/ChangeLog Wed Jul 21 09:21:37 2010 +0100
+++ b/ChangeLog Fri Jul 23 00:26:40 2010 +0100
@@ -1,3 +1,63 @@ 2010-07-20 Andrew John Hughes <ahughes
+2010-07-08 Omair Majid <omajid at redhat.com>
+
+ * plugin/icedteanp/java/sun/applet/PluginAppletViewer.java:
+ (reFrame): Pass the panel to the constructor, dont set it yourself.
+ (PluginAppletViewer): Set the panel to be the passed in object and only
+ then add it to the list of all panels.
+
+2010-07-08 Omair Majid <omajid at redhat.com>
+
+ PR icedtea/460
+ * plugin/icedteanp/java/netscape/security/ForbiddenTargetException.java:
+ New file. Some applets, for legacy support, expect this class to be
+ present.
+
+2010-06-29 Omair Majid <omajid at redhat.com>
+
+ * netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java
+ nativeDirectories: New variable. Contains a list of directories that
+ contain native libraries.
+ (getInstance): Tell other classloaders about the native directory.
+ (getNativeDir): Add the new native directory to nativeDirectories.
+ (addNativeDirectory): New function.
+ (getNativeDirectories): New function.
+ (findLibrary): Look in all the native directories for the native library.
+
+2010-06-29 Omair Majid <omajid at redhat.com>
+
+ * netx/net/sourceforge/jnlp/services/XSingleInstanceService.java
+ (startListeningServer): Mark the thread as a daemon so the JVM can
+ shutdown if there are no other non-daemon thread running.
+
+2010-06-29 Omair Majid <omajid at redhat.com>
+
+ * netx/net/sourceforge/jnlp/cache/CacheUtil.java
+ (urlToPath): Call FileUtils.sanitizePath.
+ (fixPath): Moved to...
+ * netx/net/sourceforge/jnlp/util/FileUtils.java
+ (sanitizePath): New function. Moved from CacheUtil.java
+ (sanitizeFileName): Use a blacklisting approach rather than a whitelisting
+ approach: should work better with non ascii filenames.
+
+2010-06-24 Omair Majid <omajid at redhat.com>
+
+ * netx/net/sourceforge/jnlp/SecurityDesc.java: Fix comments.
+ * netx/net/sourceforge/jnlp/JNLPClassLoader.java
+ (activateJars): Always call activateNative.
+ (activateNative): Search for native code anywhere in the jar.
+
+2010-07-22 Andrew John Hughes <ahughes at redhat.com>
+
+ * INSTALL,
+ * README: Updated to match current state of
+ play and extended with missing information.
+ * acinclude.m4: Add parameter information to
+ configure help for all options.
+ (FIND_ENDORSED_JARS): Remove unused macro and
+ correct typos.
+ * configure.ac: Make the --disable-plugin help clearer
+ by replacing 'LiveConnect plugin' with 'browser plugin'.
+
2010-07-20 Andrew John Hughes <ahughes at redhat.com>
* Makefile.am:
diff -r 0cae6a810c07 -r b52dc7f36b70 INSTALL
--- a/INSTALL Wed Jul 21 09:21:37 2010 +0100
+++ b/INSTALL Fri Jul 23 00:26:40 2010 +0100
@@ -1,141 +1,291 @@ Building IcedTea6
-Building IcedTea6
+Building IcedTea7
=================
For convenience we've provided make targets that automatically
-download, extract and patch the source code from openjdk.java.net, in
-a default location.
+download, extract and patch the source code from the IcedTea forest
+(http://hg.openjdk.java.net/icedtea/jdk7/).
The build requirements are as follows:
-GNU libgcj 4.3.0 (or equivalent 1.5 class library, such as GNU Classpath >= 0.95)
-Eclipse Java Compiler
+A bootstrap JDK, either:
+ - GNU libgcj 4.4.0 (or equivalent class library based on GNU Classpath >= 0.95) for --enable-bootstrap mode (the default)
+ - IcedTea6 or IcedTea7 for --disable-bootstrap mode
+Eclipse Java Compiler (ecj)
CUPS
libX11 (libXp, libXtst, libXi, libXt)
Freetype2
patch
sed
tar
-md5sum
+sha256sum (from coreutils)
wget
alsa
xalan
xerces
-firefox-devel
glib2-devel
gtk2-devel
-ant >= 1.6.5
+ant >= 1.6.5 with the regexp task from ant-nodeps
libXinerama-devel
giflib-devel
libpng-devel
libjpeg-devel >= 6b
zlib-devel
+xulrunner-devel (can be disabled using --disable-plugin)
rhino (can be disabled using --without-rhino)
-
-For building the PulseAudio based mixer, you will need
-pulseaudio-libs-devel >= 0.9.11
-
-For building VisualVM, you will need
-netbeans = 6.7.1
-
-For building the zero-assembler port (see below), you will need libffi.
-
-For building the Shark JIT, you will need LLVM 2.5 or current SVN.
-
-For building with systemtap support (--enable-systemtap), you will need
-systemtap-sdt-devel (available since systemtap 0.9.5). This also needs
-the --with-abs-install-dir configure option to make sure the hotspot.stp.in
-tapset gets the correct installation location for the libjvm.so, it
-defaults to the root of the j2sdk-image build dir otherwise (but then
-you cannot move that to another location without adjusting the paths
-in the tapset/hotspot.stp file. For example:
- --enable-systemtap --with-abs-install-dir=/usr/lib/jvm/java-1.6.0-openjdk
-(Java method tracing works starting with systemtap 0.9.9)
+libffi (for --enable-zero or on archs other than x86/x86_64/sparc)
+pulseaudio-libs-devel >= 0.9.11 (for --enable-pulse-java)
+LLVM 2.5 or later (for --enable-shark)
+systemtap-sdl-devel >= 0.9.5 (for --enable-systemtap, Java method tracing requires systemtap >= 0.9.9)
See ./configure --help if you need to override the defaults.
-To bootstrap IcedTea with ecj:
-autoreconf
+To bootstrap IcedTea with ecj and a GNU Classpath-based JDK:
+./autogen.sh
./configure
make
To build IcedTea with an older version of IcedTea, use:
-autoreconf
-./configure --with-icedtea
- [default location: /usr/lib/jvm/java-icedtea,
- to specifiy location use --with-icedtea-home=/path/to/icedtea]
+./autogen.sh
+./configure --disable-bootstrap
make
-There is currently no install target.
+The following locations are checked for a JDK:
+ * /usr/lib/jvm/java-openjdk
+ * /usr/lib/jvm/icedtea6
+ * /usr/lib/jvm/java-6-openjdk
+ * /usr/lib/jvm/openjdk
+ * /usr/lib/jvm/java-icedtea
+in the order given above.
-IcedTea ends up in openjdk/control/build/<os>-<arch> when the build completes.
-Example instantiations of <os>-<arch> include linux-i586, linux-amd64 and linux-ppc64.
+If bootstrapping is enabled, the following JDK locations are prepended to the above list:
+ * /usr/lib/jvm/java-gcj
+ * /usr/lib/jvm/gcj-jdk
+ * /usr/lib/jvm/cacao
-Rebuilding The IcedTea Plugs
-----------------------------
+There is currently no install target. IcedTea ends up in
+openjdk.build when the build completes.
-When IcedTea is initially built, it creates stamp files in the stamps directory
-to determine what and when dependencies were compiled. For example, to rebuild
-the rt plugs certain files need to be deleted before restarting the build.
+Most targets in IcedTea creat stamp files in the stamps directory to
+determine what and when dependencies were compiled. Each target has a
+corresponding clean-x target which removes the output and the stamp
+file, allowing it to be rebuilt. For example, stamps/rt.stamp (alias
+rt) builds the bootstrap classes needed in the bootstrap build and
+clean-rt removes the classes and the stamp file.
- - If the rt plugs have been modified, delete stamps/rt-class-files.stamp.
- - If a new class has been added to the rt plugs, delete
- rt-source-files.txt so it can be recreated with the new class list.
+Build Modification Options
+==========================
-To view all targets that create stamp files, see
-Makefile.am (section 'All Stamped Targets').
+The build process may be modified by passing the following options
+to configure:
-The Zero Assembler Port
------------------------
+* --disable-docs: Don't build the Javadoc documentation.
+* --disable-bootstrap: Perform a quick (no bootstrap) build using an installed
+ copy of IcedTea6 or IcedTea7. If a directory is not specified, a check against
+ the list presented above is performed.
+* --enable-warnings: Produce warnings from the Java compiler during the build.
+* --with-openjdk-src-dir: Copy the specified OpenJDK tree, rather than
+ downloading and extracting a tarball.
+* --disable-optimizations: Build with -O0.
+* --enable-hg: Checkout the OpenJDK tree from Mercurial, rather than
+ downloading and extracting a tarball.
+* --with-gcj: Compile ecj to native code with gcj prior to building.
+* --with-parallel-jobs: Run the specified number of parallel jobs when
+ building HotSpot and the JDK. If this option is passed without an
+ argument, the number of online processors plus one is used.
+* --with-netbeans-home: The location of NetBeans for use in the VisualVM build,
+ defaults to /usr/share/netbeans.
+* --with-ant-home: The location of Ant, defaults to /usr/share/ant.
+* --with-pkgversion=PKG: Include the specified distro package information in
+ the output of java -version.
+* --with-gcj-home: Perform a full bootstrap build using an installed
+ copy of a GNU Classpath JDK such as gcj. If a directory is not specified,
+ a check against the list presented above is performed.
+* --with-java: Specify the location of a 'java' binary. By default, the path
+ is checked for gij and java.
+* --with-ecj: Specify the location of a 'ecj' binary. By default, the path
+ is checked for ecj, ecj-3.1, ecj-3.2 and ecj-3.3.
+* --with-javac: Specify the location of a 'javac' binary. By default, the path
+ is checked for javac.
+* --with-jar: Specify the location of a 'jar' binary. By default, the path
+ is checked for gjar and jar.
+* --with-javah: Specify the location of a 'javah' binary. By default, the path
+ is checked for gjavah and javah.
+* --with-rmic: Specify the location of a 'rmic' binary. By default, the path
+ is checked for grmic and rmic.
+* --with-ecj-jar: Specify the location of an ecj JAR file. By default, the
+ following paths are checked:
+ - /usr/share/java/eclipse-ecj.jar
+ - /usr/share/java/ecj.jar
+ - /usr/share/eclipse-ecj-3.{2,3,4,5}/lib/ecj.jar
+* --with-xalan2-jar: Specify the location of a xalan2 JAR file. By default, the
+ following paths are checked:
+ - /usr/share/java/xalan-j2.jar
+ - /usr/share/java/xalan2.jar
+ - /usr/share/xalan/lib/xalan.jar
+* --with-xalan2-serializer-jar: Specify the location of a xalan2 serializer JAR file.
+ By default, the following paths are checked:
+ - /usr/share/java/xalan-j2-serializer.jar
+ - /usr/share/xalan-serializer/lib/serializer.jar
+ - /usr/share/java/serializer.jar
+* --with-xerces2-jar: Specify the location of a xerces2 JAR file. By default, the
+ following paths are checked:
+ - /usr/share/java/xerces-j2.jar
+ - /usr/share/java/xerces2.jar
+ - /usr/share/xerces-2/lib/xercesImpl.jar
+ - /usr/share/java/xercesImpl.jar
+* --with-openjdk-src-zip: Specify the location of the OpenJDK tarball to avoid downloading.
+* --with-hotspot-src-zip: Specify the location of the HotSpot tarball to avoid downloading.
+* --with-corba-src-zip: Specify the location of the CORBA tarball to avoid downloading.
+* --with-jaxp-src-zip: Specify the location of the JAXP tarball to avoid downloading.
+* --with-jaxws-src-zip: Specify the location of the JAXWS tarball to avoid downloading.
+* --with-jdk-src-zip: Specify the location of the JDK tarball to avoid downloading.
+* --with-langtools-src-zip: Specify the location of the langtools tarball to avoid downloading.
+* --with-alt-jar: Use the specified jar binary in the second stage rather than the one just built.
+* --with-jaxp-drop-zip: Specify the location of the JAXP source drop zip file to avoid downloading.
+* --with-jaf-drop-zip: Specify the location of the JAF source drop zip file to avoid downloading.
+* --with-jaxws-drop-zip: Specify the location of the JAXWS source drop zip file to avoid downloading.
+* --with-cacao-home: Specify the location of an installed CACAO to use rather than downloading
+ and building one.
+* --with-cacao-src-zip: Specify the location of a CACAO tarball to avoid downloading.
+* --with-cacao-src-dir: Specify the location of a CACAO source tree to avoid downloading.
+* --with-hg-revision: Specify a hg revision to use (as opposed to tip) with the --enable-hg option.
+* --with-tzdata-dir: Specify the location of Java timezone data, defaulting to /usr/share/javazi.
+* --with-netbeans: Specify the location of NetBeans for VisualVM, defaulting to the netbeans on the path.
+* --with-abs-install-dir: The final install location of the j2sdk-image, for use in the SystemTap tapset.
+* --with-version-suffix: Appends the given text to the JDK version output.
+* --with-project: Build an OpenJDK project from the following: icedtea, jdk7, closures, cvmi, cacaiocavallo,
+ bsd, nio2. The default is icedtea. Use of others is at the user's risk and builds may fail. This setting
+ affects which forest is checked out when --enable-hg is used and the set of patches applied.
-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 other than x86,
-x86_64 and sparc. To enable it on these platforms, use the
---enable-zero option.
+Other options may be supplied which enable or disable new features.
+These are documented fully in the relevant section below.
-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.
+* --disable-tests: Disable the running of all JTReg tests.
+* --disable-hotspot-tests: Disable the running of the HotSpot JTReg suite.
+* --disable-langtools-tests: Disable the running of the langtools JTReg suite.
+* --disable-jdk-tests: Disable the running of the jdk JTreg suite.
+* --enable-pulse-java: Build the PulseAudio sound provider.
+* --disable-xrender: Don't include the XRender pipeline.
+* --enable-systemtap: Include support for tracing using systemtap.
+* --enable-nss: Enable the NSS security provider.
+* --enable-cacao: Replace HotSpot with the CACAO VM.
+* --enable-shark: Build the Shark LLVM-based JIT.
+* --enable-zero: Build the zero assembler port on x86/x86_64/sparc platforms.
+* --disable-plugin: Don't build the browser plugin.
+* --disable-npplugin: Build the old unsupported plugin rather than NPPlugin.
+* --with-hotspot-build: The HotSpot to use, defaulting to 'original' i.e. hs14 as bundled with OpenJDK.
+* --with-rhino: Include Javascript support using Rhino.
+* --with-additional-vms=vm-list: Additional VMs to build using the system described
+ below.
+
+Testing
+=======
+
+IcedTea7 includes support for running the test suite included with
+OpenJDK, using the in-tree copy of JTReg. Invoking 'make check' will
+cause the HotSpot, JDK and langtools test suites to be run. The
+individual test suites may be run using the check-hotspot, check-jdk
+and check-langtools targets respectively. The --disable-tests option
+can be used to turn off all tests, and the
+--disable-{hotspot,langtools,jdk}-tests options can be used to turn
+off individual suites. This is useful when using 'make distcheck'
+as a way of avoiding running the extensive JDK test suite which
+takes several hours.
+
+The PulseAudio provider
+=======================
+
+IcedTea7 includes an implementation of the javax.sound.* APIs using
+PulseAudio which can be enabled using --enable-pulse-java. The resulting
+provider is org.classpath.icedtea.pulseaudio.PulseAudioMixerProvider.
+
+Xrender Support
+===============
+
+IcedTea7 includes support for an Xrender-based rendering pipeline
+developed by Clemens Eisserer (http://linuxhippy.blogspot.com/). This
+is compiled by default, and can be disabled using --disable-xrender.
+To actually use the pipeline, the sun.java2d.xrender property needs to
+be set to true, e.g. by passing the -Dsun.java2d.xrender=True option
+to java.
+
+SystemTap
+=========
+
+IcedTea7 includes work to allow the existing DTrace probes included in
+OpenJDK to be used with SystemTap. This is enabled using the
+--enable-systemtap option, and requires version 0.9.5 or later (0.9.9
+or later if you want Java method tracing). The tapset needs to know
+the final install location of the JDK, so the --with-abs-install-dir
+should also be used to specify this. If not set, it defaults to the
+in-tree location of openjdk/build/<os>-<arch>/j2sdk-image and requires
+manual changes to tapset/hotspot.stp to work from elsewhere. For
+example, if you plan to install the resulting build in
+/usr/lib/jvm/java-1.6.0-openjdk, then you should specify
+--enable-systemtap
+--with-abs-install-dir=/usr/lib/jvm/java-1.6.0-openjdk.
+
+NSS Security Provider
+=====================
+
+OpenJDK includes an NSS-based security provider in the form of
+sun.security.pkcs11.SunPKCS11. However, as this needs to know the
+location of the NSS installation it should use, it is not enabled
+in normal OpenJDK builds. As IcedTea can detect NSS using configure,
+it can simplify the process of enabling this provider by generating
+a configuration file for the NSS provider. If --enable-nss is specified,
+this configuration will be turned on in lib/security/java.security.
+This can also be done manually at a later date.
CACAO
------
+=====
-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, ppc64, arm and mips. To use CACAO
-as the VM, use the --with-cacao option. This will download CACAO
-0.99.3 during the build. To use a different version, use
---with-cacao-home=<dir> to point to an existing installation which use
-the Sun VM interface.
+IcedTea7 can use CACAO as the virtual machine, as opposed to HotSpot.
+One advantage of this is that CACAO has a JIT implementation for
+more platforms than HotSpot, including ppc, ppc64, arm and mips.
+When --enable-cacao is specified, CACAO will be downloaded and built,
+followed by the JDK portion of OpenJDK resulting in a CACAO+OpenJDK
+image in openjdk/build/<os>-<arch>/j2sdk-image. The --with-cacao-home
+option can be used to specify the use of an existing CACAO install
+instead, and --with-cacao-src-zip/dir options exist to allow the use
+of a pre-downloaded zip or source tree respectively.
-Building additional virtual machines
-------------------------------------
+Zero & Shark
+============
-Although IcedTea can be built multiple times to use a different virtual
-machine, addtional VM's can be built without building the other components
-multiple times.
+IcedTea7 includes a zero assembler port of HotSpot, which avoids
+architecture-specific code as much as possible, allowing an
+interpreter to be built and run on most platforms (albeit very
+slowly). As HotSpot only includes JITs for x86, x86_64 and SPARC, the
+zero assembler port is automatically enabled on all other
+architectures. On x86, x86_64 and SPARC, it may be built using
+--enable-zero.
-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 VMs. 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
+To overcome the performance issues inherent in zero, a LLVM-based JIT
+called Shark has been developed. This performs Just-In-Time compilation
+on any architecture supported by LLVM. To enable it, pass the option
+--enable-shark to configure. Please note that Shark is still in
+development and builds are still likely to fail at present.
-The additional VMs 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.
+The Browser Plugin
+==================
-Support for different versions of HotSpot
------------------------------------------
+IcedTea7 contains a Free Software browser plugin based on NPRuntime
+called NPPlugin. By default, this will be built, and it can be turned
+off using the -disable-plugin option.
+
+A test suite is supplied for the browser plugin. It can be built
+using 'make plugin-tests' and run by loading the HTML page specified
+into a browser with the plugin installed.
+
+For debugging, the environment variable ICEDTEAPLUGIN_DEBUG should be
+set to 'true'. This will produce output on the console from the C++
+side, and output from the Java side in $HOME/.icedteaplugin/java.stdout
+and $HOME/.icedteaplugin/java.stderr. It also starts the debug server
+on port 8787.
+
+Support for Different Versions of HotSpot
+=========================================
IcedTea allows the version of HotSpot provided with the upstream build
drop to be replaced with another. Support for this is provided by the
@@ -166,11 +316,50 @@ download stage and just verifies that th
download stage and just verifies that the zip's MD5 sum matches that
of the requested build.
-At present, two versions of HotSpot are officially supported. These
-are HotSpot 14 ('original') which is provided by the upstream OpenJDK
-tarball, and 'default', which is used in hotspot.map to provide the
-latest version of HotSpot 16. Thus, either --with-hotspot-build
-without an argument or --with-hotspot-build=default provides the
-latest supported hs16, while no HotSpot build argument,
---without-hotspot-build or --with-hotspot-build=original uses the
-upstream HotSpot.
+Currently, IcedTea7 only supports the 'original' HotSpot provided as
+part of the upstream IcedTea forest.
+
+Javascript Support
+==================
+
+IcedTea7 adds Javascript support via the javax.script API by using
+an existing installation of Rhino. Support is enabled by default,
+with the following locations being searched for a Rhino JAR file:
+
+* /usr/share/java/rhino.jar
+* /usr/share/java/js.jar
+* /usr/share/rhino-1.6/lib/js.jar
+
+A JAR file can instead be specified using the --with-rhino option,
+or support may be disabled by specifying --without-rhino.
+
+Note that the final installed JAR file is a modified version with the
+namespace prefixed by 'sun.' as in the proprietary Oracle JDK. This
+avoids conflicts between the JDK's copy of Rhino and any used by other
+applications.
+
+Building Additional Virtual Machines
+====================================
+
+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 VMs. 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
More information about the distro-pkg-dev
mailing list