README

JavaTM 2 SDK, Standard Edition

Version 1.4.2

Contents
Introduction
System Requirements & Installation
Java 2 SDK Documentation
Release Notes
Compatibility
Bug Reports and Feedback
Contents of the Java 2 SDK
Java 2 Runtime Environment
Redistribution
Web Pages

Introduction
Thank you for downloading this release of the Java TM 2 SDK, Standard
Edition. The Java 2 SDK is a development environment for building
applications, applets, and components using the Java programming
language.

The Java 2 SDK includes tools useful for developing and testing
programs written in the Java programming language and running on the
Java platform. These tools are designed to be used from the command
line. Except for the appletviewer, these tools do not provide a graphical
user interface.

System Requirements & Installation

System requirements, installation instructions and troubleshooting tips
are located on the Java Software web site at:

Java 2 SDK, Standard Edition, v 1.4.2 Installation Instructions

Java 2 SDK Documentation

The on-line Java 2 Platform Documentation contains API specifications,
 feature descriptions, developer guides, reference pages for SDK tools
and utilities, demos, and links to related information. This
documentation is also available in a download bundle which you can
install on your machine. To obtain the documentation bundle, see the
download page.

For API documentation, refer to the following sources:

The Java 2 Platform API Specification This provides brief

descriptions of the API with an emphasis on specifications, not on
code examples.

The Java Class Libraries, Second Edition, published by Addison-

Wesley Longman as part of The Java Series. These volumes
include much more elaborate descriptions, with definitions of
terminology and examples for classes, interfaces and members in
ten core packages.

Release Notes
See the Release Notes on the Java Software web site for additional
information pertaining to this release. The on-line release notes will be
updated as needed, so you should check it occasionally for the latest
information.

Compatibility
See Compatibility with Previous Releases on the Java Software web site
for the list of known compatibility issues. Every effort has been made
to support programs written for previous version of the Java platform.
Although some incompatible changes were necessary, most software
should migrate to current version with no reprogramming. Any failure
to do so is considered a bug, except for a small number of cases where
compatibility was deliberately broken, as described on our compatibility
web page. Some compatibility-breaking changes were required to close
potential security holes or to fix implementation or design bugs.

Bug Reports and Feedback

The Bug Parade Web Page on the Java Developer Connection web site
lets you search for and examine existing bug reports, submit your own
bug reports, and tell us which bug fixes matter most to you. To directly
submit a bug or request a feature, fill out this form:
 http://java.sun.com/webapps/bugreport

You can also send comments directly to Java Software engineering

team email addresses.

Note - You should not seek technical support from Bug Parade or our
development teams. For support options, see Support and Services on
the Java Software web site.

Contents of the Java 2 SDK

This section contains a general summary of the files and directories in
the Java 2 SDK. For details on the files and directories, see SDK File
Structure portion of the J2SE documentation.

Development Tools
(In the bin subdirectory.) Tools and utilities that will help you
develop, execute, debug, and document programs written in the
Java programming language. For further information, see the tool
documentation.

Runtime Environment
(In the jre subdirectory.) An implementation of the Java 2
runtime environment for use by the SDK. The runtime
environment includes a Java virtual machine, class libraries, and
other files that support the execution of programs written in the
Java programming language.

Additional Libraries
(In the lib subdirectory.) Additional class libraries and support
files required by the development tools.

Demo Applets and Applications

(In the demo subdirectory.) Examples, with source code, of
programming for the Java platform. These include examples that
use Swing and other Java Foundation Classes, and the Java
Platform Debugger Architecture.

C header Files
(In the include subdirectory.) Header files that support native-
code programming using the Java Native Interface, the Java
Virtual Machine Debugger Interface, the Java Virtual Machine
Profiler Interface and other functionality of the Java 2 Platform.

Source Code
(In src.zip.) Java programming language source files for all
 classes that make up the Java 2 core API (that is, sources files for
the java.*, javax.* and some org.* packages, but not for
com.sun.* packages). This source code is provided for
informational purposes only, to help developers learn and use the
Java programming language. These files do not include platform-
specific implementation code and cannot be used to rebuild the
class libraries. To extract these file, use any common zip utility.
Or, you may use the Jar utility in the Java 2 SDK's bin directory:
jar xvf src.zip

The Java 2 Runtime Environment

The Java 2 Runtime Environment is available as a separately
downloadable product. See the download web site.

The Java 2 Runtime Environment allows you to run applications written

in the Java programming language. Like the Java 2 SDK, it contains the
Java virtual machine, classes comprising the Java 2 Platform API, and
supporting files. Unlike the Java 2 SDK, it does not contain
development tools such as compilers and debuggers.

You can freely redistribute the Java 2 Runtime Environment with your
application, according to the terms of the Runtime Environment's
license. Once you have developed your application using the Java 2
SDK, you can ship it with the Runtime Environment so your end-users
will have a Java platform on which to run your software.

Redistribution
The term "vendors" used here refers to licensees, developers, and
independent software vendors (ISVs) who license and distribute the
Java 2 Runtime Environment with their programs. Vendors must follow
the terms of the Java 2 SDK, Standard Edition, Binary Code License
agreement.

Required vs. Optional Files

The files that make up the Java 2 SDK, Standard Edition, are divided
into two categories: required and optional. Optional files may be
excluded from redistributions of the Java 2 SDK at the vendor's
discretion. The following section contains a list of the files and
directories that may optionally be omitted from redistributions of the
Java 2 SDK. All files not in these lists of optional files must be
included in redistributions of the Java 2 SDK.
Optional Files and Directories
The following files may be optionally excluded from redistributions:

jre/lib/charsets.jar
Character conversion classes
jre/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 and jre/bin/rmid
Java RMI Activation System Daemon
bin/rmiregistry and jre/bin/rmiregistry
Java Remote Object Registry
bin/tnameserv and jre/bin/tnameserv
Java IDL Name Server
bin/keytool and jre/bin/keytool
Key and Certificate Management Tool
bin/kinit and jre/bin/kinit
Used to obtain and cache Kerberos ticket-granting tickets
bin/klist and jre/bin/klist
Kerberos display entries in credentials cache and keytab
bin/ktab and jre/bin/ktab
Kerberos key table manager
bin/policytool and jre/bin/policytool
Policy File Creation and Management Tool
bin/orbd and jre/bin/orbd
Object Request Broker Daemon
bin/servertool and jre/bin/servertool
Java IDL Server Tool
src.zip
Archive of source files

In addition, the Java Web Start product may be excluded from

redistributions. The Java Web Start product is contained in a file named
javaws-1_2-solaris-sparc-i.zip, javaws-1_2-solaris-i586-
i.zip, javaws-1_2-linux-i586-i.zip, or javaws-1_2-windows-
i586-i.exe, depending on the platform.

Unlimited Strength Java Cryptography Extension

Due to import control restrictions for some countries, the Java
Cryptography Extension (JCE) policy files shipped with the Java 2
SDK, Standard Edition and the Java 2 Runtime Environment allow
strong but limited cryptography to be used. These files are located at

<java-home>/lib/security/local_policy.jar
<java-home>/lib/security/US_export_policy.jar

where <java-home> is the jre directory of the Java 2 SDK or the top-
level directory of the Java 2 Runtime Environment. An unlimited
strength version of these files indicating no restrictions on cryptographic
strengths is available on the Java 2 SDK web site for those living in
eligible countries. Those living in eligible countries may download the
unlimited strength version and replace the strong cryptography jar files
with the unlimited strength files.

Endorsed Standards Override Mechanism

An endorsed standard is a Java API defined through a standards process
other than the Java Community ProcessSM (JCP SM). Because endorsed
standards are defined outside the JCP, it is anticipated that such
standards will be revised between releases of the Java 2 Platform. In
order to take advantage of new revisions to endorsed standards,
developers and software vendors may use the Endorsed Standards
Override Mechanism to provide newer versions of an endorsed standard
than those included in the Java 2 Platform as released by Sun
Microsystems.

For more information on the Endorsed Standards Override Mechanism,

including the list of platform packages that it may be used to override,
see

http://java.sun.com/j2se/1.4.2/docs/guide/standards/

Classes in the packages listed on that web page may be replaced only
by classes implementing a more recent version of the API as defined by
the appropriate standards body.

In addition to the packages listed in the document at the above URL,

which are part of the Java 2 Platform, Standard Edition (J2SE TM)
specification, redistributors of Sun's J2SE Reference Implementation
are allowed to override classes whose sole purpose is to implement the
functionality provided by public APIs defined in these Endorsed
Standards packages. Redistributors may also override classes in the
org.w3c.dom.* packages, or other classes whose sole purpose is to
implement these APIs.
Web Pages
For additional information, refer to these Sun Microsystems pages on
the World Wide Web:

http://java.sun.com/
The Java Software web site, with the latest information on Java
technology, product information, news, and features.
http://java.sun.com/docs
Java Platform Documentation provides access to white papers, the
Java Tutorial and other documents.
http://java.sun.com/jdc
The Java Developer Connection web site. (Free registration
required.) Additional technical information, news, and features;
user forums; support information, and much more.
http://java.sun.com/products/
Java Technology Products & API

The Java 2 SDK, Standard Edition, is a product of Sun MicrosystemsTM , Inc.

This product includes code licensed from RSA Security.

Copyright 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A.
All rights reserved.