Linux Build Instructions

You will need access to a JDK 5.0 for Linux installation. The 5.0 binaries can be downloaded from Sun's JDK 5.0 download site. Set ALT_BOOTDIR to point to the location of the bootstrap JDK installation.

GNU make version 3.78.1 or later is required to build the JDK. Information on GNU make, including download sites, is available on the GNU Make web site. For convenience, place the GNU make binary in the PATH.

The build requires zip version 2.2 (November 3rd 1997) or later. --> Set ALT_DEVTOOLS_PATH to point to the location of this binary. Information on zip, including download sites, is available on the info-zip web site.

Motif version 2.1 headers and libraries are required for building the Linux JDK. (Motif 2.2 headers will not work.)

As a convenience, the source bundles include an archive of motif workspace that incorporate a number of JDK-related bug fixes. Target gnumake scsl would automatically take care about building our motif workspace and generate motif headers and libraries and use them when it required in the build.

         +- $(OUTPUTDIR)/
            +- motif/           (Automatically ALT_MOTIF_DIR set to this directory.)
               +- include/
               +- lib/
                

CUPS headers

CUPS header files are required for building the JDK.

The default location searched by the build is /usr/include Use the ALT_CUPS_HEADERS_PATH environment variable to point to the absolute path of the directory containing the headers on your system. If not installed, the header files may be downloaded from http://www.cups.org

Mozilla headers are required for building Java Plug-in. Download and unpack the headers into a directory similar to the one shown below, and set the ALT_MOZILLA_HEADERS_PATH environment variable to the absolute path of the plugin directory.

         +- plugin/      (set ALT_MOZILLA_HEADERS_PATH to this level)
            +- mozilla_headers_ns7/
    

cacerts

A certificates file named "cacerts" represents a system-wide keystore with CA certificates. In JDK and JRE binary bundles, the "cacerts" file contains root CA certificates from several public CAs (e.g., VeriSign, Thawte, and Baltimore).

The source bundles contain a cacerts file without CA root certificates. JDK builders will need to secure permission from each public CA and include the certificates into their own custom cacerts file. Failure to provide a populated cacerts file will result in verification of a certificate chain during runtime.

The ALT_CACERTS_FILE should be set to point to the location of the populated cacerts file.

ALSA (i586, amd64)

Advanced Linux Sound Architecture version 0.9.1 or later is required for building the JDK.

Most modern Linux distributions ship with ALSA. On rpm-based systems, you can see if ALSA is installed by running this command:

         rpm -qa | grep alsa

Both alsa and alsa-devel packages are needed.

If your distribution does not come with ALSA, you can install pre-built ALSA rpm packages, for example from Fresh RPMs. Make sure that you do not link to the static library (libasound.a), by verifying that the dynamic library (libasound.so) is correctly installed in /usr/lib.

If you are unable to find a pre-built ALSA package, you need to build it from the source distribution: Download driver and library source tarballs from ALSA's homepage. As root, execute the following commands (you may need to adapt the version number):

      $ tar xjf alsa-driver-0.9.1.tar.bz2
      $ cd alsa-driver-0.9.1
      $ ./configure
      $ make install
      $ cd ..
      $ tar xjf alsa-lib-0.9.1.tar.bz2
      $ cd alsa-lib-0.9.1
      $ ./configure
      $ make install

Should one of the above steps fail, refer to the documentation on ALSA's home page. Note that this is a minimum install that enables building the JDK platform. To actually use ALSA sound drivers, more steps are necessary as outlined in the documentation on ALSA's homepage.
ALSA can be uninstalled by executing make uninstall first in the alsa-lib-0.9.1 directory and then in alsa-driver-0.9.1.

Linux Build Environment Variables

This section describes environment variables that you can set to influence various aspects of the build. Some of these variables are mentioned specifically in the setup and build instructions above. Others you may set at your discretion.

Environment variables may be set in the shell environment or on the GNU make command line.

PATH

Set the PATH to contain:

• The location of the GNU make binary
• The location of the GCC compiler binaries (usually /usr/bin, but see ALT_COMPILER_PATH)
• /usr/bin
• /bin

ALT_BOOTDIR

The location of the JDK 5.0 bootstrap installation.

ALT_OUTPUTDIR

An override for specifying the (absolute) path of where the build output is to go.

ALT_UNIXCOMMAND_PATH

An override for specifying where the Unix /bin commands are located. You usually do not need to set this variable: the default location is /bin.

ALT_USRBIN_PATH

An override for specifying where the Unix /usr/bin commands are located. You usually do not need to set this variable: the default location is /usr/bin)

ALT_COMPILER_PATH

An override for specifying the location of the GCC compiler. See GCC Compiler for details.

ALT_GCC29_COMPILER_PATH

An override for specifying the location of the GCC 2.9 compiler. See OJI Plug-in library Compiled with GCC 2.9 for details.

ALT_GCC29_PLUGIN_LIB_PATH

An override for specifying the location of the OJI Plug-in library compiled with GCC 2.9. See OJI Plug-in library Compiled with GCC 2.9 for details.

ALT_DEVTOOLS_PATH

The location of the gnumake binary. See gnumake for details.

ALT_CACERTS_FILE

The location of the cacerts file. See cacerts file for details.

ALT_MOTIF_DIR

The location of the Motif 2.1 headers and libraries. See Motif 2.1 for details.

ALT_MOZILLA_HEADERS_PATH

The location of the Mozilla headers. See Mozilla Headers for details.

MILESTONE

The milestone name for the build (e.g. "beta").

BUILD_NUMBER

The build number for the build (e.g. "b27").

Linux Build

1. cd into the control/make directory.
2. Start the build with the command:
       make scsl [ALT_OUTPUTDIR=directory-name-for-output] [MILESTONE=milestone_name] [BUILD_NUMBER=build_number] [other "ALT_" overrides]

Please be sure to use the GNU version of make.

---

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