Name: rs88542 Date: 10/04/2001


Errors in Solaris Build instructions for Beta 2 (b77)

(./j2se/src/share/doc/build/build-solaris.html from licensee source bundle
j2sdk-1_4_0-beta2-src-b77-solaris-22_aug_2001.zip):

* The title of the build instructions should indicate Beta2 not Beta

* gnumake (3.78.1 or later) needs to be on PATH (this is implicitly mentioned in
"Solaris Setup" section - explicitly adding it to the "Solaris Configuration"
section would be helpful)

* compiler version 5.2 needs to be on PATH (not 5.0 as specified in the
instructions)

* At the end of the section "Solaris Configuration", the instructions:
"You will need to copy file devtools/linux/plugin/libg/glibconfig.h to
devtools/linux/plugin/gtk/include/glibconfig.h"
  should refer to the appropriate architecture, not just linux.

* The Hotspot Server VM build generates loader warnings:
Linking vm...
ld: warning: mapfile: text segment: section `.text%void
JavaThread::pd_set_post_Java_state_has_flushed(int)' does not appear in file
`interpreterRuntime.o'
ld: warning: mapfile: text segment: section `.text%int oopDesc::identity_hash()'
does not appear in file `systemDictionary.o'
...

* The HotSpot Client VM build generates loader warnings:
Linking vm...
ld: warning: mapfile: text segment: section `.text%void
MacroAssembler::br(Assembler::Condition,int,Assembler::Predict,Label&)' does not
appear in file `icache_sparc.o'
ld: warning: mapfile: text segment: section `.text%void
StubGenerator::generate_initial()' does not appear in file
`stubGenerator_sparc.o'
ld: warning: mapfile: text segment: section `.text%void
Assembler::st(RegisterImpl*,RegisterImpl*,RegisterImpl*)' does not appear in
file `stubGenerator_sparc.o'
...

* The plugin build fails with the following errors:

ERROR: Your BOOTDIR environment variable does not point
       to a valid Java 2 SDK for bootstrapping this build.
       A Java 2 SDK 1.4 build must be bootstrapped against any
       1.4 build. Apparently, your bootstrap JDK is version 1.3.1_01
       Please update your ALT_BOOTDIR setting and start your build again.

ERROR: HOTSPOT_CLIENT_PATH does not point to a valid HotSpot VM.
       Please check your access to
           hotspot_client_bootstrap/libjvm.so
       and/or check your value of ALT_HOTSPOT_CLIENT_PATH.

ERROR: HOTSPOT_CLIENT_PATH does not point to a valid HotSpot debug VM.
       Please check your access to
           hotspot_client_bootstrap/libjvm_g.so
       and/or check your value of ALT_HOTSPOT_CLIENT_PATH.

ERROR: HOTSPOT_SERVER_PATH does not point to a valid HotSpot VM.
       Please check your access to
           hotspot_server_bootstrap/libjvm.so
       and/or check your value of ALT_HOTSPOT_SERVER_PATH.

ERROR: HOTSPOT_SERVER_PATH does not point to a valid HotSpot debug VM.
       Please check your access to
           hotspot_server_bootstrap/libjvm_g.so
       and/or check your value of ALT_HOTSPOT_SERVER_PATH.

======================================================================

###@###.### 2001-10-09

The initial bug report referred to the build readmes for Beta 2 (b77) as received by the Licensees.

Alan Sommerer suggested I look at the most recent Beta 3 build README:
file:/java/re/jdk/1.4/promoted/beta3/b82/licenseebundles/tmp/readme/README-SRCLI
C.html

I used these instructions on the b82 source bundle (j2sdk-1_4_0-pre-beta3-src-b82-solaris-03_oct_2001.zip)

This build was much more successful. The new errors I found are as follows:

* Build Overview, "Testing the Build":
  - the location of java should be ../../../bin/java not ../../../java

* Solaris Build Instructions (1.4.0 beta3):

  - Section "Solaris System Setup":
    - There are no patches listed for building on Solaris 5.8, even though in the following section there are patches listed for the Compiler for Solaris 5.8.
   
  - Section "Solaris Build Tools and Libraries Setup":
    - I used /java/devtools/sparc/SUNWspro/SC6.1/bin/ for the Sun Workshop compiler. I notice that this compiler only has patch 109508-03 installed (at least according to CC -V), whereas the instructions indicate patches 109505, 109513 and 109510 are also needed. Does jano need to be updated or are the recommended compiler patches incorrect ?
    - For completeness, I checked that these recommended compiler patches could be installed by trying to install them on my local machine. This failed: patchadd for each patch gave "One or more patch packages included in XXXXXX-XX are not installed on this system." and there was no obvious reason why (there were no missing dependencies in the documentation that I could see). Is the documentation on the patches incorrect/incomplete ?

    - I also downloaded and tried to install the recommended patches associated with the bootstrap J2SDK ("Download Solaris SPARC/Intel Operating System Patches" in http://java.sun.com/j2se/1.4/). Should this step be added as part of the build instructions ? BTW this mostly worked except for patch 108773-08, which failed with "One or more patch packages included in XXXXXX-XX are not installed on this system."; again, there was no obvious reason why this should fail

  - Section "Solaris Configuration":
    The instructions "You will need to copy file devtools/linux/plugin/libg/glibconfig.h to devtools/linux/plugin/gtk/include/glibconfig.h" are incorrect for Solaris

(the architecture should be "sparc" not "linux" and the file copy would seem to be from devtools/sparc/plugin/libg/lib/glib/include/glibconfig.h to
devtools/sparc/plugin/gtk/lib/glib/include/glibconfig.h)

  - Section "Solaris Build Environment Variables":
    - The description for ALT_BOOTDIR is incomplete
    - In the description for ALT_DEVTROOLS_PATH you may want to mention that, for 32-bit Solaris builds, this location also implies the existence of the Mozilla headers and libraries and the GLib and libIDL libraries, as described in the previous sub-section "Mozilla Headers and Libraries (32-bit Solaris build only)

  - Section "Solaris Build":
    - The build generated several "/bin/sh: whoami: not found" messages until I added /usr/ucb to my path
    - The build genearted the following error at the end:
/bin/sh: ./../../cobundle/make: does not exist
gnumake: *** [cobundle-build] Error 1