README
Java(TM) 2 Platform Standard Edition
Runtime Environment
Version 5.0
The J2SE(TM) Runtime Environment (JRE) is intended for software developers
and vendors to redistribute with their applications.
The J2SE Runtime Environment contains the Java virtual machine,
runtime class libraries, and Java application launcher that are
necessary to run programs written in the Java programming language.
It is not a development environment and does not contain development
tools such as compilers or debuggers. For development tools, see the
J2SE Development Kit.
=======================================================================
Deploying Applications with the J2SE Runtime Environment
=======================================================================
When you deploy an application written in the Java programming
language, your software bundle will probably consist of the following
parts:
Your own class, resource, and data files.
A runtime environment.
An installation procedure or program.
You already have the first part, of course. The remainder of this
document covers the other two parts. See also the Notes for Developers
page on the Java Software website:
http://java.sun.com/j2se/1.5.0/runtime.html
-----------------------------------------------------------------------
Runtime Environment
-----------------------------------------------------------------------
To run your application, a user needs the J2SE Runtime Environment,
which is freely available from Sun. Or, You can redistribute the
J2SE Runtime Environment for free with your application, according
to the terms of the Runtime Environment's license.
The final step in the deployment process occurs when the software is
installed on individual user system. Installation consists of copying
software onto the user's system, then configuring the user's system
to support that software. You should ensure that your installation
procedure does not overwrite existing JRE installations, as they may
be required by other applications.
=======================================================================
Redistribution of the J2SE Runtime Environment
=======================================================================
--------------------------------------------------------
NOTE - The license for this software does not allow the
redistribution of beta and other pre-release versions.
--------------------------------------------------------
The term "vendors" used here refers to licensees, developers, and
independent software vendors (ISVs) who license and distribute the
J2SE Runtime Environment with their programs.
Vendors must follow the terms of the J2SE Runtime Environment Binary
Code License agreement.
-----------------------------------------------------------------------
Required vs. Optional Files
-----------------------------------------------------------------------
The files that make up the J2SE Runtime Environment are divided into
two categories: required and optional. Optional files may be excluded
from redistributions of the J2SE Runtime Environment at the
licensee's discretion.
The following section contains a list of the files and directories that
may optionally be omitted from redistributions with the J2SE Runtime
Environment. All files not in these lists of optional files must be
included in redistributions of the runtime environment.
-----------------------------------------------------------------------
Optional Files and Directories
-----------------------------------------------------------------------
The following files may be optionally excluded from redistributions.
These files are located in the jre1.5.0_<version> directory, where
<version> is the update version number. Solaris and Linux filenames
and separators are shown. Windows executables have the ".exe" suffix.
Corresponding files with _g in name can also be excluded.
lib/charsets.jar
Character conversion classes
lib/ext/
sunjce_provider.jar - the SunJCE provider for Java
Cryptography APIs
localedata.jar - contains many of the resources
needed for non US English locales
ldapsec.jar - contains security features supported
by the LDAP service provider
dnsns.jar - for the InetAddress wrapper of JNDI DNS provider
bin/rmid
Java RMI Activation System Daemon
bin/rmiregistry
Java Remote Object Registry
bin/tnameserv
Java IDL Name Server
bin/keytool
Key and Certificate Management Tool
bin/kinit
Used to obtain and cache Kerberos ticket-granting tickets
bin/klist
Kerberos display entries in credentials cache and keytab
bin/ktab
Kerberos key table manager
bin/policytool
Policy File Creation and Management Tool
bin/orbd
Object Request Broker Daemon
bin/servertool
Java IDL Server Tool
bin/javaws, lib/javaws/ and lib/javaws.jar
Java Web Start
When redistributing the JRE on Microsoft Windows as a private
application runtime (not accessible by other applications)
with a custom launcher, the following files are also
optional. These are the Netscape and IE plugin modules and
are not useful in a private JRE redistribution.
java.exe
javaw.exe
ActPanel.dll
jpicpl32.exe
jpicpl32.cpl
jpiexp32.dll
jpins32.dll
jpishare.dll
NPJava11.dll
NPJava12.dll
NPJava13.dll
NPJava32.dll
NPJPI141.dll
NPOJI610.dll
-----------------------------------------------------------------------
Redistributable JDK(TM) Files
-----------------------------------------------------------------------
The limited set of files from the JDK listed below may be included in
vendor redistributions of the J2SE Runtime Environment. All paths
are relative to the top-level directory of the JDK.
- jre/lib/cmm/PYCC.pf
Color profile. This file is required only if one wishes to
convert between the PYCC color space and another color space.
- All .ttf font files in the jre/lib/fonts directory. Note that the
LucidaSansRegular.ttf font is already contained in the J2SE
Runtime Environment, so there is no need to bring that file over
from the JDK.
- jre/lib/audio/soundbank.gm
This MIDI soundbank is present in the JDK, but it has
been removed from the J2SE Runtime Environment in order to
reduce the size of the Runtime Environment's download bundle.
However, a soundbank file is necessary for MIDI playback, and
therefore the JDK's soundbank.gm file may be included in
redistributions of the Runtime Environment at the vendor's
discretion. Several versions of enhanced MIDI soundbanks are
available from the Java Sound web site:
http://java.sun.com/products/java-media/sound/
These alternative soundbanks may be included in redistributions
of the J2SE Runtime Environment.
- The javac bytecode compiler, consisting of the following files:
bin/javac [Solaris(TM) Operating System
and Linux]
bin/sparcv9/javac [Solaris Operating System
(SPARC(R) Platform Edition)]
bin/amd64/javac [Solaris Operating Environment (AMD)]
bin/javac.exe [Microsoft Windows]
lib/tools.jar [All platforms]
- The Annotation Processing Tool, consisting of the following files:
bin/apt [Solaris(TM) Operating System
and Linux]
bin/sparcv9/apt [Solaris Operating System
(SPARC(R) Platform Edition)]
bin/amd64/apt [Solaris Operating System (AMD)]
bin/apt.exe [Microsoft