README-builds.html

Mon, 29 Jun 2009 22:13:31 -0700

author
xdono
date
Mon, 29 Jun 2009 22:13:31 -0700
changeset 106
38c6ee1015aa
parent 105
8ca3d95b1ea3
parent 90
60b818e5e4f9
child 125
4079d923a501
permissions
-rw-r--r--

Merge

duke@2 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
duke@2 2 <html>
ohair@13 3 <head>
ohair@13 4 <title>OpenJDK Build README</title>
ohair@13 5 </head>
ohair@13 6 <body style="background-color:lightcyan">
ohair@13 7 <!-- ====================================================== -->
ohair@41 8 <table width="100%">
ohair@13 9 <tr>
ohair@13 10 <td align="center">
ohair@25 11 <img alt="OpenJDK"
ohair@25 12 src="http://openjdk.java.net/images/openjdk.png"
ohair@25 13 width=256 />
ohair@13 14 </td>
ohair@13 15 </tr>
ohair@13 16 <tr>
ohair@13 17 <td align=center>
ohair@13 18 <h1>OpenJDK Build README</h1>
ohair@13 19 </td>
ohair@13 20 </tr>
ohair@13 21 </table>
ohair@13 22 <!-- ------------------------------------------------------ -->
ohair@13 23 <hr>
ohair@13 24 <h2><a name="introduction">Introduction</a></h2>
ohair@13 25 <blockquote>
ohair@13 26 <p>
ohair@13 27 This README file contains build instructions for the
ohair@13 28 <a href="http://openjdk.java.net" target="_blank">OpenJDK</a>.
ohair@13 29 Building the source code for the
ohair@13 30 OpenJDK
ohair@13 31 requires
ohair@13 32 a certain degree of technical expertise.
ohair@13 33 </blockquote>
ohair@13 34 <!-- ------------------------------------------------------ -->
ohair@13 35 <hr>
ohair@13 36 <h2><a name="contents">Contents</a></h2>
ohair@13 37 <blockquote>
ohair@13 38 <ul>
ohair@13 39 <li><a href="#introduction">Introduction</a></li>
ohair@13 40 <li><a href="#MBE">Minimum Build Environments</a></li>
ohair@13 41 <li><a href="#SDBE">Specific Developer Build Environments</a></li>
ohair@41 42 <ul>
ohair@41 43 <li><a href="#fedora">Fedora Linux</a> </li>
ohair@41 44 <li><a href="#centos">CentOS Linux</a> </li>
ohair@41 45 <li><a href="#ubuntu">Ubuntu Linux</a> </li>
ohair@41 46 </ul>
ohair@13 47 <li><a href="#directories">Source Directory Structure</a> </li>
ohair@13 48 <li><a href="#building">Build Information</a>
ohair@13 49 <ul>
ohair@13 50 <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
ohair@13 51 <li><a href="#linux">Basic Linux System Setup</a> </li>
ohair@13 52 <li><a href="#solaris">Basic Solaris System Setup</a> </li>
ohair@13 53 <li><a href="#windows">Basic Windows System Setup</a> </li>
ohair@13 54 <li><a href="#dependencies">Build Dependencies</a> </li>
duke@2 55 <ul>
ohair@13 56 <li><a href="#bootjdk">Bootstrap JDK</a> </li>
ohair@13 57 <li><a href="#binaryplugs">Binary Plugs</a> </li>
ohair@13 58 <li><a href="#importjdk">Optional Import JDK</a> </li>
ohair@25 59 <li><a href="#ant">Ant</a> </li>
ohair@13 60 <li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
ohair@13 61 <li><a href="#compilers">Compilers</a>
ohair@13 62 <ul>
ohair@13 63 <li><a href="#msvc">Microsoft Visual Studio</a> </li>
ohair@13 64 <li><a href="#mssdk">Microsoft Platform SDK</a> </li>
ohair@13 65 <li><a href="#gcc">Linux gcc/binutils</a> </li>
ohair@13 66 <li><a href="#studio">Sun Studio</a> </li>
ohair@13 67 </ul>
ohair@13 68 </li>
ohair@13 69 <li><a href="#zip">Zip and Unzip</a> </li>
ohair@13 70 <li><a href="#freetype">FreeType2 Fonts</a> </li>
peterz@74 71 <li><a href="#jibx">JIBX Libraries</a> </li>
ohair@13 72 <li>Linux and Solaris:
ohair@13 73 <ul>
ohair@13 74 <li><a href="#cups">CUPS Include files</a> </li>
andrew@90 75 <li><a href="#xrender">XRender Include files</a></li>
ohair@13 76 </ul>
ohair@13 77 </li>
ohair@13 78 <li>Linux only:
ohair@13 79 <ul>
ohair@13 80 <li><a href="#alsa">ALSA files</a> </li>
ohair@13 81 </ul>
ohair@13 82 </li>
ohair@13 83 <li>Windows only:
ohair@13 84 <ul>
ohair@13 85 <li>Unix Command Tools (<a href="#cygwin">CYGWIN</a>)</li>
ohair@13 86 <li><a href="#dxsdk">DirectX 9.0 SDK</a> </li>
ohair@13 87 </ul>
ohair@13 88 </li>
duke@2 89 </ul>
ohair@13 90 </ul>
ohair@13 91 </li>
ohair@13 92 <li><a href="#creating">Creating the Build</a> </li>
ohair@13 93 <li><a href="#testing">Testing the Build</a> </li>
ohair@13 94 <li><a href="#variables">Environment/Make Variables</a></li>
ohair@13 95 <li><a href="#troubleshooting">Troubleshooting</a></li>
ohair@13 96 </ul>
ohair@13 97 </blockquote>
ohair@13 98 <!-- ------------------------------------------------------ -->
ohair@13 99 <hr>
ohair@13 100 <h2><a name="MBE">Minimum Build Environments</a></h2>
ohair@13 101 <blockquote>
ohair@13 102 This file often describes specific requirements for what we call the
ohair@49 103 "minimum build environments" (MBE) for this
ohair@49 104 specific release of the JDK,
ohair@13 105 Building with the MBE will generate the most compatible
ohair@13 106 bits that install on, and run correctly on, the most variations
ohair@13 107 of the same base OS and hardware architecture.
ohair@13 108 These usually represent what is often called the
ohair@13 109 least common denominator platforms.
ohair@13 110 It is understood that most developers will NOT be using these
ohair@13 111 specific platforms, and in fact creating these specific platforms
ohair@13 112 may be difficult due to the age of some of this software.
ohair@13 113 <p>
ohair@13 114 The minimum OS and C/C++ compiler versions needed for building the
ohair@13 115 OpenJDK:
ohair@13 116 <p>
ohair@13 117 <table border="1">
ohair@13 118 <thead>
ohair@13 119 <tr>
ohair@13 120 <th>Base OS and Architecture</th>
ohair@13 121 <th>OS</th>
ohair@49 122 <th>C/C++ Compiler</th>
xdono@105 123 <th>BOOT JDK</th>
ohair@13 124 </tr>
ohair@13 125 </thead>
ohair@13 126 <tbody>
ohair@13 127 <tr>
ohair@49 128 <td>Linux X86 (32-bit)</td>
ohair@49 129 <td>Fedora 9</td>
ohair@13 130 <td>gcc 4 </td>
xdono@105 131 <td>JDK 6u14 FCS </td>
ohair@13 132 </tr>
ohair@13 133 <tr>
ohair@49 134 <td>Linux X64 (64-bit)</td>
ohair@49 135 <td>Fedora 9</td>
ohair@13 136 <td>gcc 4 </td>
xdono@105 137 <td>JDK 6u14 FCS </td>
ohair@13 138 </tr>
ohair@13 139 <tr>
ohair@49 140 <td>Solaris SPARC (32-bit)</td>
xdono@105 141 <td>Solaris 10u2 + patches
ohair@13 142 <br>
ohair@13 143 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
ohair@13 144 SunSolve</a> for patch downloads.
ohair@13 145 </td>
ohair@30 146 <td>Sun Studio 12</td>
xdono@105 147 <td>JDK 6u14 FCS </td>
ohair@13 148 </tr>
ohair@13 149 <tr>
ohair@49 150 <td>Solaris SPARCV9 (64-bit)</td>
xdono@105 151 <td>Solaris 10u2 + patches
ohair@13 152 <br>
ohair@13 153 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
ohair@13 154 SunSolve</a> for patch downloads.
ohair@13 155 </td>
ohair@30 156 <td>Sun Studio 12</td>
xdono@105 157 <td>JDK 6u14 FCS </td>
ohair@13 158 </tr>
ohair@13 159 <tr>
ohair@49 160 <td>Solaris X86 (32-bit)</td>
xdono@105 161 <td>Solaris 10u2 + patches
ohair@13 162 <br>
ohair@13 163 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
ohair@13 164 SunSolve</a> for patch downloads.
ohair@13 165 </td>
ohair@30 166 <td>Sun Studio 12</td>
xdono@105 167 <td>JDK 6u14 FCS </td>
ohair@13 168 </tr>
ohair@13 169 <tr>
ohair@49 170 <td>Solaris X64 (64-bit)</td>
xdono@105 171 <td>Solaris 10u2 + patches
ohair@13 172 <br>
ohair@13 173 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
ohair@13 174 SunSolve</a> for patch downloads.
ohair@13 175 </td>
ohair@30 176 <td>Sun Studio 12</td>
xdono@105 177 <td>JDK 6u14 FCS </td>
ohair@13 178 </tr>
ohair@13 179 <tr>
ohair@49 180 <td>Windows X86 (32-bit)</td>
ohair@13 181 <td>Windows XP</td>
ohair@49 182 <td>Microsoft Visual Studio C++ 2008 Standard Edition</td>
xdono@105 183 <td>JDK 6u14 FCS </td>
ohair@13 184 </tr>
ohair@13 185 <tr>
ohair@49 186 <td>Windows X64 (64-bit)</td>
ohair@13 187 <td>Windows Server 2003 - Enterprise x64 Edition</td>
ohair@13 188 <td>Microsoft Platform SDK - April 2005</td>
xdono@105 189 <td>JDK 6u14 FCS </td>
ohair@13 190 </tr>
ohair@13 191 </tbody>
ohair@13 192 </table>
ohair@49 193 <p>
ohair@49 194 These same sources do indeed build on many more systems than the
ohair@49 195 above older generation systems, again the above is just a minimum.
ohair@49 196 <p>
ohair@49 197 Compilation problems with newer or different C/C++ compilers is a
ohair@49 198 common problem.
ohair@49 199 Similarly, compilation problems related to changes to the
ohair@49 200 <tt>/usr/include</tt> or system header files is also a
ohair@49 201 common problem with newer or unreleased OS versions.
ohair@49 202 Please report these types of problems as bugs so that they
ohair@49 203 can be dealt with accordingly.
ohair@13 204 </blockquote>
ohair@13 205 <!-- ------------------------------------------------------ -->
ohair@13 206 <hr>
ohair@13 207 <h2><a name="SDBE">Specific Developer Build Environments</a></h2>
ohair@13 208 <blockquote>
ohair@13 209 We won't be listing all the possible environments, but
ohair@13 210 we will try to provide what information we have available to us.
ohair@13 211 </blockquote>
ohair@13 212 <!-- ------------------------------------------------------ -->
ohair@41 213 <h3><a name="fedora">Fedora 9</a></h3>
ohair@13 214 <blockquote>
ohair@41 215 After installing
ohair@41 216 <a href="http://www.fedoraproject.org/">Fedora 9</a>
ohair@41 217 you need to make sure you have
ohair@41 218 the "Software Development" bundle installed, plus the
ohair@41 219 following packages:
ohair@41 220 <blockquote>
ohair@41 221 <ul>
ohair@41 222 <li>cups devel: Cups Development Package</li>
ohair@41 223 <li>freetype 2.3+ devel: Freetype 2.3 Development Package</li>
ohair@41 224 <li>hg: Mercurial, if you need to clone or manage source repositories</li>
ohair@41 225 <li>ksh: May be needed when using <tt>webrev</tt></li>
ohair@41 226 </ul>
ohair@41 227 </blockquote>
ohair@41 228 <p>
ohair@41 229 Always a good idea to do a complete Software Update/Refresh
ohair@41 230 after you get all the packages installed.
ohair@13 231 </blockquote>
ohair@13 232 <!-- ------------------------------------------------------ -->
ohair@41 233 <h3><a name="centos">CentOS 5.2</a></h3>
ohair@13 234 <blockquote>
ohair@41 235 After installing
ohair@41 236 <a href="http://www.centos.org/">CentOS 5.2</a>
ohair@41 237 you need to make sure you have
ohair@41 238 the following Development bundles installed:
ohair@41 239 <blockquote>
ohair@41 240 <ul>
ohair@41 241 <li>Development Libraries</li>
ohair@41 242 <li>Development Tools</li>
ohair@41 243 <li>Java Development</li>
ohair@41 244 <li>X Software Development</li>
ohair@41 245 </ul>
ohair@41 246 </blockquote>
ohair@41 247 <p>
ohair@41 248 Plus the following packages:
ohair@41 249 <blockquote>
ohair@41 250 <ul>
ohair@41 251 <li>cups devel: Cups Development Package</li>
ohair@41 252 <li>alsa devel: Alsa Development Package</li>
ohair@41 253 <li>ant: Ant Package</li>
ohair@41 254 <li>Xi devel: libXi.so Development Package</li>
ohair@41 255 </ul>
ohair@41 256 </blockquote>
ohair@41 257 <p>
ohair@41 258 The freetype 2.3 packages don't seem to be available,
ohair@41 259 but the freetype 2.3 sources can be downloaded, built,
ohair@41 260 and installed easily enough from
ohair@41 261 <a href="http://downloads.sourceforge.net/freetype">
ohair@41 262 the freetype site</a>.
ohair@41 263 Build and install with something like:
ohair@41 264 <blockquote>
ohair@41 265 <tt>./configure && make && sudo -u root make install</tt>
ohair@41 266 </blockquote>
ohair@41 267 <p>
ohair@41 268 Mercurial packages could not be found easily, but a Google
ohair@41 269 search should find ones, and they usually include Python if
ohair@41 270 it's needed.
ohair@13 271 </blockquote>
ohair@13 272 <!-- ------------------------------------------------------ -->
ohair@13 273 <h3><a name="ubuntu">Ubuntu</a></h3>
ohair@13 274 <blockquote>
ohair@13 275 In addition to needing the Bootstrap JDK and the Binary Plugs,
ohair@13 276 when building on Ubuntu you will need to
ohair@13 277 make sure certain packages are installed.
ohair@13 278 In particular, certain X11 packages, make, m4, gawk, gcc 4,
ohair@13 279 binutils, cups, freetype
ohair@13 280 and alsa.
ohair@13 281 <!-- ------------------------------------------------------ -->
ohair@13 282 <h4>Ubuntu 6.06</h4>
ohair@13 283 <p>
ohair@13 284 The following list of packages for Ubuntu 6.06 is a working set that
ohair@13 285 does appear to work.
ohair@13 286 <p>
ohair@13 287 <b>Note that it's quite possible that some of these
ohair@13 288 packages are not required, so anyone discovering that some of the
ohair@13 289 packages listed below are NOT required,
ohair@13 290 please let the
ohair@13 291 OpenJDK
ohair@13 292 team know.</b>
ohair@13 293 <p>
ohair@13 294 All the packages below can be installed with the
ohair@13 295 Synaptic Package manager provided with the base Ubuntu 6.06 release.
ohair@13 296 <blockquote>
ohair@13 297 <ul>
ohair@13 298 <li>binutils (2.16.1cvs20060117-1ubuntu2.1)</li>
ohair@13 299 <li>cpp (4:4.0.3-1)</li>
ohair@13 300 <li>cpp-4.0 (4.0.3-1ubuntu5)</li>
ohair@13 301 <li>libfreetype6-dev</li>
ohair@13 302 <li>g++ (4:4.0.3-1)</li>
ohair@13 303 <li>g++-4.0 (4.0.3-1ubuntu5)</li>
ohair@13 304 <li>gawk (1:3.1.5-2build1)</li>
ohair@13 305 <li>gcc (4:4.0.3-1)</li>
ohair@13 306 <li>gcc-4.0 (4.0.3-1ubuntu5)</li>
ohair@13 307 <li>libasound2-dev (1.0.10-2ubuntu4)</li>
ohair@13 308 <li>libc6 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
ohair@13 309 <li>libc6-dev (2.3.6-0ubuntu20.4)</li>
ohair@13 310 <li>libc6-i686 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
ohair@13 311 <li>libcupsys2-dev (1.2.2-0ubuntu0.6.06)</li>
ohair@13 312 <li>libgcrypt11-dev (1.2.2-1)</li>
ohair@13 313 <li>libgnutls-dev (1.2.9-2ubuntu1.1)</li>
ohair@13 314 <li>libgnutls12 (1.2.9-2ubuntu1) to 1.2.9-2ubuntu1.1</li>
ohair@13 315 <li>libgpg-error-dev (1.1-4)</li>
ohair@13 316 <li>libice-dev (2:1.0.0-0ubuntu2)</li>
ohair@13 317 <li>liblockfile1 (1.06.1)</li>
ohair@13 318 <li>libopencdk8-dev (0.5.7-2)</li>
ohair@13 319 <li>libpopt-dev (1.7-5)</li>
ohair@13 320 <li>libsm-dev (2:1.0.0-0ubuntu2)</li>
ohair@13 321 <li>libstdc++6-4.0-dev (4.0.3-1ubuntu5)</li>
ohair@13 322 <li>libtasn1-2-dev (0.2.17-1ubuntu1)</li>
ohair@13 323 <li>libx11-dev (2:1.0.0-0ubuntu9)</li>
ohair@13 324 <li>libxau-dev (1:1.0.0-0ubuntu4)</li>
ohair@13 325 <li>libxaw-headers (2:1.0.1-0ubuntu3)</li>
ohair@13 326 <li>libxaw7-dev (2:1.0.1-0ubuntu3)</li>
ohair@13 327 <li>libxdmcp-dev (1:1.0.0-0ubuntu2)</li>
ohair@13 328 <li>libxext-dev (2:1.0.0-0ubuntu4)</li>
ohair@13 329 <li>libxi-dev (2:1.0.0-0ubuntu3) </li>
ohair@13 330 <li>libxmu-dev (2:1.0.0-0ubuntu3)</li>
ohair@13 331 <li>libxmu-headers (2:1.0.0-0ubuntu3)</li>
ohair@13 332 <li>libxmuu-dev (2:1.0.0-0ubuntu3)</li>
ohair@13 333 <li>libxp-dev (6.8.2-11ubuntu2)</li>
ohair@13 334 <li>libxpm-dev (1:3.5.4.2-0ubuntu3)</li>
ohair@13 335 <li>libxrandr-dev (1:1.1.0.2-0ubuntu4)</li>
ohair@13 336 <li>libxt-dev (1:1.0.0-0ubuntu3)</li>
ohair@13 337 <li>libxtrap-dev (2:1.0.0-0ubuntu2)</li>
ohair@13 338 <li>libxtst-dev (2:1.0.1-0ubuntu2)</li>
ohair@13 339 <li>libxv-dev (2:1.0.1-0ubuntu3)</li>
ohair@13 340 <li>linux-kernel-headers (2.6.11.2-0ubuntu18)</li>
ohair@13 341 <li>m4 (1.4.4-1)</li>
ohair@13 342 <li>make (3.80+3.81.b4-1)</li>
ohair@13 343 <li>ssl-cert (1.0.13)</li>
ohair@13 344 <li>x-dev (7.0.4-0ubuntu2)</li>
ohair@13 345 <li>x11proto-core-dev (7.0.4-0ubuntu2)</li>
ohair@13 346 <li>x11proto-input-dev (1.3.2-0ubuntu2)</li>
ohair@13 347 <li>x11proto-kb-dev (1.0.2-0ubuntu2)</li>
ohair@13 348 <li>x11proto-randr-dev (1.1.2-0ubuntu2)</li>
ohair@13 349 <li>x11proto-record-dev (1.13.2-0ubuntu2)</li>
ohair@13 350 <li>x11proto-trap-dev (3.4.3-0ubuntu2)</li>
ohair@13 351 <li>x11proto-video-dev (2.2.2-0ubuntu2)</li>
ohair@13 352 <li>x11proto-xext-dev (7.0.2-0ubuntu2)</li>
ohair@13 353 <li>xlibs-dev (7.0.0-0ubuntu45)</li>
ohair@13 354 <li>zlib1g-dev (1:1.2.3-6ubuntu4)</li>
duke@2 355 </ul>
ohair@13 356 </blockquote>
ohair@13 357 <!-- ------------------------------------------------------ -->
ohair@13 358 <h4>Ubuntu 7.04</h4>
ohair@13 359 <p>
ohair@13 360 Using the Synaptic Package Manager, download the following
ohair@13 361 packages (double indented packages are automatically aquired
ohair@13 362 due to package dependencies):
ohair@13 363 <blockquote>
ohair@13 364 <ul>
ohair@13 365 <li>build-essential</li>
ohair@13 366 <ul>
ohair@13 367 <li>dpkg-dev</li>
ohair@13 368 <li>g++</li>
ohair@13 369 <li>g++-4.1</li>
ohair@13 370 <li>libc6-dev</li>
ohair@13 371 <li>libstdc++6.4.1-dev</li>
ohair@13 372 <li>linux-libc-dev</li>
ohair@13 373 </ul>
ohair@13 374 <li>gawk</li>
ohair@13 375 <li>m4</li>
ohair@13 376 <li>libasound2-dev</li>
ohair@13 377 <li>libcupsys2-dev</li>
ohair@13 378 <ul>
ohair@13 379 <li>libgcrypt11-dev</li>
ohair@13 380 <li>lgnutls-dev</li>
ohair@13 381 <li>libgpg-error-dev</li>
ohair@13 382 <li>liblzo-dev</li>
ohair@13 383 <li>libopencdk8-dev</li>
ohair@13 384 <li>libpopt-dev</li>
ohair@13 385 <li>libtasn1-3-dev</li>
ohair@13 386 <li>zlib1g-dev</li>
ohair@13 387 </ul>
ohair@13 388 <li>sun-java6-jdk</li>
ohair@13 389 <ul>
ohair@13 390 <li>java-common</li>
ohair@13 391 <li>libltdl3</li>
ohair@13 392 <li>odbcinst1debian1</li>
ohair@13 393 <li>sun-java6-bin</li>
ohair@13 394 <li>sun-java6-jre</li>
ohair@13 395 <li>unixodbc</li>
ohair@13 396 </ul>
ohair@13 397 <li>xlibs-dev</li>
ohair@13 398 <ul>
ohair@13 399 <li>(many)</li>
ohair@13 400 </ul>
ohair@13 401 <li>x11proto-print-dev</li>
ohair@13 402 <li>libxaw7-dev</li>
ohair@13 403 <ul>
ohair@13 404 <li>libxaw-headers</li>
ohair@13 405 </ul>
ohair@13 406 <li>libxp-dev</li>
ohair@13 407 <li>libfreetype6-dev</li>
ohair@13 408 </ul>
ohair@13 409 </blockquote>
ohair@13 410 </blockquote>
ohair@13 411 <!-- ------------------------------------------------------ -->
ohair@13 412 <hr>
ohair@13 413 <h2><a name="directories">Source Directory Structure</a></h2>
ohair@13 414 <blockquote>
ohair@13 415 <p>
ohair@13 416 The source code for the OpenJDK is delivered in a set of
ohair@13 417 directories:
ohair@13 418 <tt>hotspot</tt>,
ohair@13 419 <tt>langtools</tt>,
ohair@13 420 <tt>corba</tt>,
ohair@13 421 <tt>jaxws</tt>,
ohair@13 422 <tt>jaxp</tt>,
ohair@13 423 and
ohair@13 424 <tt>jdk</tt>.
ohair@13 425 The <tt>hotspot</tt> directory contains the source code and make
ohair@13 426 files for building the OpenJDK Hotspot Virtual Machine.
ohair@13 427 The <tt>langtools</tt> directory contains the source code and make
ohair@13 428 files for building the OpenJDK javac and language tools.
ohair@13 429 The <tt>corba</tt> directory contains the source code and make
ohair@13 430 files for building the OpenJDK Corba files.
ohair@13 431 The <tt>jaxws</tt> directory contains the source code and make
ohair@13 432 files for building the OpenJDK JAXWS files.
ohair@13 433 The <tt>jaxp</tt> directory contains the source code and make
ohair@13 434 files for building the OpenJDK JAXP files.
ohair@13 435 The <tt>jdk</tt> directory contains the source code and make files for
ohair@13 436 building the OpenJDK runtime libraries and misc files.
ohair@13 437 The top level <tt>Makefile</tt>
ohair@13 438 is used to build the entire OpenJDK.
ohair@13 439 </blockquote>
ohair@13 440 <!-- ------------------------------------------------------ -->
ohair@13 441 <hr>
ohair@13 442 <h2><a name="building">Build Information</a></h2>
ohair@13 443 <blockquote>
ohair@13 444 Building the OpenJDK
ohair@13 445 is done with a <tt><i>gmake</i></tt>
ohair@13 446 command line and various
ohair@13 447 environment or make variable settings that direct the make rules
ohair@13 448 to where various components have been installed.
ohair@13 449 Where possible the makefiles will attempt to located the various
ohair@13 450 components in the default locations or any component specific
ohair@13 451 variable settings.
ohair@13 452 When the normal defaults fail or components cannot be found,
ohair@13 453 the various
ohair@13 454 <tt>ALT_*</tt> variables (alternates)
ohair@13 455 can be used to help the makefiles locate components.
ohair@13 456 <p>
ohair@13 457 Refer to the bash/sh/ksh setup file
ohair@13 458 <tt>jdk/make/jdk_generic_profile.sh</tt>
ohair@13 459 if you need help in setting up your environment variables.
ohair@13 460 A build could be as simple as:
ohair@13 461 <blockquote>
ohair@13 462 <pre><tt>
duke@2 463 bash
duke@2 464 . jdk/make/jdk_generic_profile.sh
duke@2 465 <i>gmake</i> sanity &amp;&amp; <i>gmake</i>
ohair@13 466 </tt></pre>
ohair@13 467 </blockquote>
ohair@13 468 <p>
ohair@13 469 Of course ksh or sh would work too.
ohair@13 470 But some customization will probably be necessary.
ohair@13 471 The <tt>sanity</tt> rule will make some basic checks on build
ohair@13 472 dependencies and generate appropriate warning messages
ohair@13 473 regarding missing, out of date, or newer than expected components
ohair@13 474 found on your system.
ohair@13 475 </blockquote>
ohair@13 476 <!-- ------------------------------------------------------ -->
ohair@13 477 <hr>
ohair@13 478 <h3><a name="gmake">GNU make (<tt><i>gmake</i></tt>)</a></h3>
ohair@13 479 <blockquote>
ohair@13 480 The Makefiles in the OpenJDK are only valid when used with the
ohair@13 481 GNU version of the utility command <tt>make</tt>
ohair@13 482 (<tt><i>gmake</i></tt>).
ohair@13 483 A few notes about using GNU make:
ohair@13 484 <ul>
ohair@13 485 <li>
ohair@13 486 In general, you need GNU make version 3.78.1 or newer.
ohair@13 487 </li>
ohair@13 488 <li>
ohair@13 489 Place the location of the GNU make binary in the <tt>PATH</tt>.
ohair@13 490 </li>
ohair@13 491 <li>
ohair@13 492 <strong>Linux:</strong>
ohair@13 493 The <tt>/usr/bin/make</tt> command should work fine for you.
ohair@13 494 </li>
ohair@13 495 <li>
ohair@13 496 <strong>Solaris:</strong>
ohair@13 497 Do NOT use <tt>/usr/bin/make</tt> on Solaris.
ohair@13 498 If your Solaris system has the software
ohair@13 499 from the Solaris Companion CD installed,
ohair@13 500 you should use <tt>gmake</tt>
ohair@13 501 which will be located in either the <tt>/opt/sfw/bin</tt> or
ohair@13 502 <tt>/usr/sfw/bin</tt> directory.
ohair@25 503 In more recent versions of Solaris GNU make can be found
ohair@25 504 at <tt>/usr/bin/gmake</tt>.
ohair@13 505 </li>
ohair@13 506 <li>
ohair@13 507 <strong>Windows:</strong>
ohair@13 508 Make sure you start your build inside a bash/sh/ksh shell.
ohair@13 509 <br>
ohair@13 510 <b>WARNING:</b> Watch out for make version 3.81, it may
ohair@25 511 not work due to a lack of support for MS-DOS drive letter paths
ohair@25 512 like <tt>C:/</tt> or <tt>C:\</tt>.
ohair@13 513 Use a 3.80 version, or find a newer
ohair@49 514 version that has this problem fixed.
ohair@13 515 The older 3.80 version of make.exe can be downloaded with this
ohair@13 516 <a href="http://cygwin.paracoda.com/release/make/make-3.80-1.tar.bz2" target="_blank">
ohair@13 517 link</a>.
ohair@25 518 Use of this older 3.80 make.exe may require that you install the
ohair@25 519 libintl2.dll library or libintl2 cygwin package which is
ohair@25 520 no longer installed by default by the cygwin installer.
ohair@25 521 <br>
ohair@13 522 Also see the
ohair@13 523 <a href="http://developer.mozilla.org/en/docs/Windows_build_prerequisites_using_cygwin#make" target="_blank">
ohair@13 524 mozilla developer center</a>
ohair@13 525 on this topic.
ohair@25 526 <br>
ohair@25 527 It's hoped that when make 3.82 starts shipping in a future cygwin
ohair@25 528 release that this MS-DOS path issue will be fixed.
ohair@25 529 In addition to the above 3.80 make.exe you can download
ohair@25 530 this
ohair@25 531 <a href="http://www.cmake.org/files/cygwin/make.exe">
ohair@25 532 www.cmake.org make.exe</a> which will not have a libintl2.dll
ohair@25 533 dependency.
ohair@13 534 </li>
ohair@13 535 </ul>
ohair@13 536 <p>
ohair@13 537 Information on GNU make, and access to ftp download sites, are
ohair@13 538 available on the
ohair@13 539 <a href="http://www.gnu.org/software/make/make.html" target="_blank">
ohair@13 540 GNU make web site
ohair@13 541 </a>.
ohair@13 542 The latest source to GNU make is available at
ohair@13 543 <a href="http://ftp.gnu.org/pub/gnu/make/" target="_blank">
ohair@13 544 ftp.gnu.org/pub/gnu/make/</a>.
ohair@13 545 </blockquote>
ohair@13 546 <!-- ------------------------------------------------------ -->
ohair@13 547 <hr>
ohair@13 548 <h3><a name="linux">Basic Linux System Setup</a></h3>
ohair@13 549 <blockquote>
ohair@13 550 <strong>i586 only:</strong>
ohair@13 551 The minimum recommended hardware for building the Linux version
ohair@13 552 is a Pentium class processor or better, at least 256 MB of RAM, and
ohair@13 553 approximately 1.5 GB of free disk space.
ohair@13 554 <p>
ohair@13 555 <strong>X64 only:</strong>
ohair@13 556 The minimum recommended hardware for building the Linux
ohair@13 557 version is an AMD Opteron class processor, at least 512 MB of RAM, and
ohair@13 558 approximately 4 GB of free disk space.
ohair@13 559 <p>
ohair@13 560 The build will use the tools contained in
ohair@13 561 <tt>/bin</tt> and
ohair@13 562 <tt>/usr/bin</tt>
ohair@13 563 of a standard installation of the Linux operating environment.
ohair@13 564 You should ensure that these directories are in your
ohair@13 565 <tt>PATH</tt>.
ohair@13 566 <p>
ohair@13 567 Note that some Linux systems have a habit of pre-populating
ohair@13 568 your environment variables for you, for example <tt>JAVA_HOME</tt>
ohair@13 569 might get pre-defined for you to refer to the JDK installed on
ohair@13 570 your Linux system.
ohair@13 571 You will need to unset <tt>JAVA_HOME</tt>.
ohair@13 572 It's a good idea to run <tt>env</tt> and verify the
ohair@13 573 environment variables you are getting from the default system
ohair@13 574 settings make sense for building the
ohair@13 575 OpenJDK.
ohair@13 576 </blockquote>
ohair@13 577 <!-- ------------------------------------------------------ -->
ohair@13 578 <h4><a name="linux_checklist">Basic Linux Check List</a></h4>
ohair@13 579 <blockquote>
ohair@13 580 <ol>
ohair@13 581 <li>
ohair@13 582 Install the
ohair@13 583 <a href="#bootjdk">Bootstrap JDK</a>, set
ohair@13 584 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
ohair@13 585 </li>
ohair@13 586 <li>
ohair@13 587 Install the
ohair@13 588 <a href="#binaryplugs">Binary Plugs</a>, set
ohair@13 589 <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
ohair@13 590 </li>
ohair@13 591 <li>
ohair@13 592 <a href="#importjdk">Optional Import JDK</a>, set
ohair@13 593 <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
ohair@13 594 </li>
ohair@13 595 <li>
ohair@13 596 Install or upgrade the <a href="#freetype">FreeType development
ohair@13 597 package</a>.
ohair@13 598 </li>
ohair@25 599 <li>
peterz@74 600 Install the
peterz@74 601 <a href="#jibx">JIBX Libraries</a>, set
peterz@74 602 <tt><a href="#ALT_JIBX_LIBS_PATH">ALT_JIBX_LIBS_PATH</a></tt>.
peterz@74 603 </li>
peterz@74 604 <li>
ohair@25 605 Install
ohair@49 606 <a href="#ant">Ant</a>,
ohair@49 607 make sure it is in your PATH.
ohair@25 608 </li>
ohair@13 609 </ol>
ohair@13 610 </blockquote>
ohair@13 611 <!-- ------------------------------------------------------ -->
ohair@13 612 <hr>
ohair@13 613 <h3><a name="solaris">Basic Solaris System Setup</a></h3>
ohair@13 614 <blockquote>
ohair@13 615 The minimum recommended hardware for building the
ohair@13 616 Solaris SPARC version is an UltraSPARC with 512 MB of RAM.
ohair@13 617 For building
ohair@13 618 the Solaris x86 version, a Pentium class processor or better and at
ohair@13 619 least 512 MB of RAM are recommended.
ohair@13 620 Approximately 1.4 GB of free disk
ohair@13 621 space is needed for a 32-bit build.
ohair@13 622 <p>
ohair@49 623 If you are building the 64-bit version, you should
ohair@13 624 run the command "isainfo -v" to verify that you have a
ohair@13 625 64-bit installation, it should say <tt>sparcv9</tt> or
ohair@13 626 <tt>amd64</tt>.
ohair@13 627 An additional 7 GB of free disk space is needed
ohair@13 628 for a 64-bit build.
ohair@13 629 <p>
ohair@13 630 The build uses the tools contained in <tt>/usr/ccs/bin</tt>
ohair@13 631 and <tt>/usr/bin</tt> of a standard developer or full installation of
ohair@13 632 the Solaris operating environment.
ohair@13 633 <p>
ohair@13 634 Solaris patches specific to the JDK can be downloaded from the
ohair@13 635 <a href="http://sunsolve.sun.com/show.do?target=patches/JavaSE" target="_blank">
ohair@13 636 SunSolve JDK Solaris patches download page</a>.
ohair@13 637 You should ensure that the latest patch cluster for
ohair@13 638 your version of the Solaris operating environment has also
ohair@13 639 been installed.
ohair@13 640 </blockquote>
ohair@13 641 <!-- ------------------------------------------------------ -->
ohair@13 642 <h4><a name="solaris_checklist">Basic Solaris Check List</a></h4>
ohair@13 643 <blockquote>
ohair@13 644 <ol>
ohair@13 645 <li>
ohair@13 646 Install the
ohair@13 647 <a href="#bootjdk">Bootstrap JDK</a>, set
ohair@13 648 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
ohair@13 649 </li>
ohair@13 650 <li>
ohair@13 651 Install the
ohair@13 652 <a href="#binaryplugs">Binary Plugs</a>, set
ohair@13 653 <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
ohair@13 654 </li>
ohair@13 655 <li>
ohair@13 656 <a href="#importjdk">Optional Import JDK</a>, set
ohair@13 657 <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
ohair@13 658 </li>
ohair@13 659 <li>
ohair@13 660 Install the
ohair@13 661 <a href="#studio">Sun Studio Compilers</a>, set
ohair@13 662 <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
ohair@13 663 </li>
ohair@13 664 <li>
ohair@13 665 Install the
ohair@13 666 <a href="#cups">CUPS Include files</a>, set
ohair@13 667 <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
ohair@13 668 </li>
ohair@25 669 <li>
andrew@90 670 Install the <a href="#xrender">XRender Include files</a>.
andrew@90 671 </li>
andrew@90 672 <li>
peterz@74 673 Install the
peterz@74 674 <a href="#jibx">JIBX Libraries</a>, set
peterz@74 675 <tt><a href="#ALT_JIBX_LIBS_PATH">ALT_JIBX_LIBS_PATH</a></tt>.
peterz@74 676 </li>
peterz@74 677 <li>
ohair@25 678 Install
ohair@49 679 <a href="#ant">Ant</a>,
ohair@49 680 make sure it is in your PATH.
ohair@25 681 </li>
ohair@13 682 </ol>
ohair@13 683 </blockquote>
ohair@13 684 <!-- ------------------------------------------------------ -->
ohair@13 685 <hr>
ohair@13 686 <h3><a name="windows">Basic Windows System Setup</a></h3>
ohair@13 687 <blockquote>
ohair@13 688 <strong>i586 only:</strong>
ohair@49 689 The minimum recommended hardware for building the 32-bit or X86
ohair@13 690 Windows version is an Pentium class processor or better, at least
ohair@13 691 512 MB of RAM, and approximately 600 MB of free disk space.
ohair@13 692 <strong>
ohair@49 693 NOTE: The Windows build machines need to use the
ohair@13 694 file system NTFS.
ohair@13 695 Build machines formatted to FAT32 will not work
ohair@13 696 because FAT32 doesn't support case-sensitivity in file names.
ohair@13 697 </strong>
ohair@13 698 <p>
ohair@13 699 <strong>X64 only:</strong>
ohair@13 700 The minimum recommended hardware for building
ohair@13 701 the Windows X64 version is an AMD Opteron class processor, at least 1
ohair@13 702 GB of RAM, and approximately 10 GB of free disk space.
ohair@13 703 </blockquote>
ohair@13 704 <!-- ------------------------------------------------------ -->
ohair@13 705 <h4><a name="paths">Windows Paths</a></h4>
ohair@13 706 <blockquote>
duke@2 707 <strong>Windows:</strong>
ohair@13 708 Note that GNU make is a historic utility and is based very
ohair@13 709 heavily on shell scripting, so it does not tolerate the Windows habit
ohair@13 710 of having spaces in pathnames or the use of the <tt>\</tt>characters in pathnames.
ohair@13 711 Luckily on most Windows systems, you can use <tt>/</tt>instead of \, and
ohair@13 712 there is always a 'short' pathname without spaces for any path that
ohair@13 713 contains spaces.
ohair@13 714 Unfortunately, this short pathname can be somewhat dynamic and the
ohair@13 715 formula is difficult to explain.
ohair@13 716 You can use <tt>cygpath</tt> utility to map pathnames with spaces
ohair@13 717 or the <tt>\</tt>character into the <tt>C:/</tt> style of pathname
ohair@13 718 (called 'mixed'), e.g.
ohair@13 719 <tt>cygpath -s -m "<i>path</i>"</tt>.
ohair@13 720 <p>
ohair@13 721 The makefiles will try to translate any pathnames supplied
ohair@13 722 to it into the <tt>C:/</tt> style automatically.
ohair@13 723 <p>
ohair@13 724 Note that use of CYGWIN creates a unique problem with regards to
ohair@13 725 setting <a href="#path"><tt>PATH</tt></a>. Normally on Windows
ohair@13 726 the <tt>PATH</tt> variable contains directories
ohair@13 727 separated with the ";" character (Solaris and Linux uses ":").
ohair@13 728 With CYGWIN, it uses ":", but that means that paths like "C:/path"
ohair@13 729 cannot be placed in the CYGWIN version of <tt>PATH</tt> and
ohair@13 730 instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
ohair@13 731 which CYGWIN understands, but only CYGWIN understands.
ohair@13 732 So be careful with paths on Windows.
ohair@13 733 </blockquote>
ohair@13 734 <!-- ------------------------------------------------------ -->
ohair@13 735 <h4><a name="windows_checklist">Basic Windows Check List</a></h4>
duke@2 736 <blockquote>
ohair@13 737 <ol>
ohair@13 738 <li>
ohair@13 739 Install the
ohair@13 740 <a href="#cygwin">CYGWIN product</a>.
ohair@13 741 </li>
ohair@13 742 <li>
ohair@13 743 Install the
ohair@13 744 <a href="#bootjdk">Bootstrap JDK</a>, set
ohair@13 745 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
ohair@13 746 </li>
ohair@13 747 <li>
ohair@13 748 Install the
ohair@13 749 <a href="#binaryplugs">Binary Plugs</a>, set
ohair@13 750 <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>..
ohair@13 751 </li>
ohair@13 752 <li>
ohair@13 753 <a href="#importjdk">Optional Import JDK</a>, set
ohair@13 754 <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
ohair@13 755 </li>
ohair@13 756 <li>
ohair@13 757 Install the
ohair@49 758 <a href="#msvc">Microsoft Visual Studio Compilers</a> (32-bit).
ohair@49 759 </li>
ohair@49 760 <li>
ohair@49 761 Install the
ohair@49 762 <a href="#mssdk">Microsoft Platform SDK</a>.
ohair@13 763 </li>
ohair@13 764 <li>
ohair@13 765 Setup all environment variables for compilers
ohair@13 766 (see <a href="#msvc">compilers</a>).
ohair@13 767 </li>
ohair@13 768 <li>
ohair@13 769 Install
ohair@13 770 <a href="#dxsdk">Microsoft DirectX SDK</a>.
ohair@13 771 </li>
ohair@25 772 <li>
peterz@74 773 Install the
peterz@74 774 <a href="#jibx">JIBX Libraries</a>, set
peterz@74 775 <tt><a href="#ALT_JIBX_LIBS_PATH">ALT_JIBX_LIBS_PATH</a></tt>.
peterz@74 776 </li>
peterz@74 777 <li>
ohair@25 778 Install
ohair@49 779 <a href="#ant">Ant</a>,
ohair@49 780 make sure it is in your PATH and set
ohair@25 781 <tt><a href="#ANT_HOME">ANT_HOME</a></tt>.
ohair@25 782 </li>
ohair@13 783 </ol>
duke@2 784 </blockquote>
ohair@13 785 <!-- ------------------------------------------------------ -->
ohair@13 786 <hr>
ohair@13 787 <h3><a name="dependencies">Build Dependencies</a></h3>
duke@2 788 <blockquote>
ohair@13 789 Depending on the platform, the OpenJDK build process has some basic
ohair@13 790 dependencies on components not part of the OpenJDK sources.
ohair@13 791 Some of these are specific to a platform, some even specific to
ohair@13 792 an architecture.
ohair@13 793 Each dependency will have a set of ALT variables that can be set
ohair@13 794 to tell the makefiles where to locate the component.
ohair@13 795 In most cases setting these ALT variables may not be necessary
ohair@13 796 and the makefiles will find defaults on the system in standard
ohair@13 797 install locations or through component specific variables.
ohair@13 798 <!-- ------------------------------------------------------ -->
ohair@13 799 <h4><a name="bootjdk">Bootstrap JDK</a></h4>
ohair@13 800 <blockquote>
ohair@13 801 All OpenJDK builds require access to the previously released
ohair@13 802 JDK 6, this is often called a bootstrap JDK.
ohair@13 803 The JDK 6 binaries can be downloaded from Sun's
ohair@13 804 <a href="http://java.sun.com/javase/1.6.0/download.html" target="_blank">JDK 6 download site</a>.
ohair@13 805 For build performance reasons
ohair@13 806 is very important that this bootstrap JDK be made available on the
ohair@13 807 local disk of the machine doing the build.
ohair@13 808 You should always set
ohair@13 809 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
ohair@13 810 to point to the location of
ohair@13 811 the bootstrap JDK installation, this is the directory pathname
ohair@13 812 that contains a <tt>bin, lib, and include</tt>
ohair@13 813 It's also a good idea to also place its <tt>bin</tt> directory
ohair@13 814 in the <tt>PATH</tt> environment variable, although it's
ohair@13 815 not required.
ohair@13 816 <p>
ohair@13 817 <strong>Solaris:</strong>
ohair@13 818 Some pre-installed JDK images may be available to you in the
ohair@13 819 directory <tt>/usr/jdk/instances</tt>.
ohair@13 820 If you don't set
ohair@13 821 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
ohair@13 822 the makefiles will look in that location for a JDK it can use.
ohair@13 823 </blockquote>
ohair@13 824 <!-- ------------------------------------------------------ -->
ohair@13 825 <h4><a name="binaryplugs">Binary Plugs</a></h4>
ohair@13 826 <blockquote>
ohair@13 827 Not all of the source code that makes up the JDK is available
ohair@13 828 under an open-source license.
ohair@13 829 This is a temporary situation and these binary plugs will be
ohair@13 830 replaced with fully open source replacements as soon as possible.
ohair@13 831 So currently, in order to build a complete OpenJDK image,
ohair@13 832 you must first download and install the appropriate
ohair@13 833 binary plug bundles for the OpenJDK, go to the
ohair@13 834 <a href="http://openjdk.java.net" target="_blank">OpenJDK</a> site and select
ohair@49 835 the
ohair@49 836 "<b>Bundles(7)</b>"
ohair@49 837 link and download the binaryplugs for
ohair@13 838 your particular platform.
ohair@13 839 The file downloaded is a jar file that must be extracted by running
ohair@13 840 the jar file with:
ohair@13 841 <blockquote>
ohair@13 842 <pre>
ohair@13 843 <tt><b>java -jar jdk-7-ea-plug-b<i>nn</i>-<i>os</i>-<i>arch</i>-<i>dd</i>_<i>month</i>_<i>year</i>.jar</b></tt>
ohair@13 844 </pre>
ohair@13 845 </blockquote>
ohair@13 846 A prompt will be issued for acceptance of these binary plug files.
ohair@13 847 During the OpenJDK build process these "binary plugs"
ohair@13 848 for the encumbered components will be copied into your
ohair@13 849 resulting OpenJDK binary build image.
ohair@13 850 These binary plug files are only for the purpose of
ohair@13 851 building an OpenJDK binary.
ohair@13 852 Make sure you set
ohair@13 853 <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
ohair@13 854 to the root of this installation.
ohair@13 855 </blockquote>
ohair@13 856 <!-- ------------------------------------------------------ -->
ohair@13 857 <h4><a name="importjdk">Optional Import JDK</a></h4>
ohair@13 858 <blockquote>
ohair@13 859 The <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
ohair@13 860 setting is only needed if you are not building the entire
ohair@13 861 JDK. For example, if you have built the entire JDK once, and
ohair@13 862 wanted to avoid repeatedly building the Hotspot VM, you could
ohair@13 863 set this to the location of the previous JDK install image
ohair@13 864 and the build will copy the needed files from this import area.
ohair@13 865 </blockquote>
ohair@13 866 <!-- ------------------------------------------------------ -->
ohair@25 867 <h4><a name="ant">Ant</a></h4>
ohair@25 868 <blockquote>
ohair@25 869 All OpenJDK builds require access to least Ant 1.6.5.
ohair@25 870 The Ant tool is available from the
ohair@51 871 <a href="http://ant.apache.org" target="_blank">
ohair@25 872 Ant download site</a>.
ohair@49 873 You should always make sure <tt>ant</tt> is in your PATH, and
ohair@49 874 on Windows you may also need to set
ohair@25 875 <tt><a href="#ANT_HOME">ANT_HOME</a></tt>
ohair@25 876 to point to the location of
ohair@25 877 the Ant installation, this is the directory pathname
ohair@25 878 that contains a <tt>bin and lib</tt>.
ohair@25 879 </blockquote>
ohair@25 880 <!-- ------------------------------------------------------ -->
ohair@13 881 <h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
ohair@13 882 <blockquote>
ohair@13 883 See <a href="http://en.wikipedia.org/wiki/Certificate_Authority" target="_blank">
ohair@13 884 http://en.wikipedia.org/wiki/Certificate_Authority</a>
ohair@13 885 for a better understanding of the Certificate Authority (CA).
ohair@13 886 A certificates file named "cacerts"
ohair@13 887 represents a system-wide keystore with CA certificates.
ohair@13 888 In JDK and JRE
ohair@13 889 binary bundles, the "cacerts" file contains root CA certificates from
ohair@13 890 several public CAs (e.g., VeriSign, Thawte, and Baltimore).
ohair@13 891 The source contain a cacerts file
ohair@13 892 without CA root certificates.
ohair@13 893 Formal JDK builders will need to secure
ohair@13 894 permission from each public CA and include the certificates into their
ohair@13 895 own custom cacerts file.
ohair@13 896 Failure to provide a populated cacerts file
ohair@13 897 will result in verification errors of a certificate chain during runtime.
ohair@13 898 The variable
ohair@13 899 <tt><a href="#ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt>
ohair@13 900 can be used to override the default location of the
ohair@13 901 cacerts file that will get placed in your build.
ohair@13 902 By default an empty cacerts file is provided and that should be
ohair@13 903 fine for most JDK developers.
ohair@13 904 </blockquote>
ohair@13 905 <!-- ------------------------------------------------------ -->
peterz@74 906 <h4><a name="jibx">JIBX</a></h4>
peterz@74 907 <blockquote>
peterz@74 908 JIBX libraries version 1.1.5 is required for building the OpenJDK.
peterz@74 909 Namely, the following JAR files from the JIBX distribution package
peterz@74 910 are required:
peterz@74 911 <ul>
peterz@74 912 <li>bcel.jar
peterz@74 913 <li>jibx-bind.jar
peterz@74 914 <li>jibx-run.jar
peterz@74 915 <li>xpp3.jar
peterz@74 916 </ul>
peterz@74 917 <p>
peterz@74 918 You can download the package from the
peterz@74 919 <a href="http://jibx.sourceforge.net" target="_blank">JIBX site</a>.
peterz@74 920 <p>
peterz@74 921 You will need to set the
peterz@74 922 <tt><a href="#ALT_JIBX_LIBS_PATH">ALT_JIBX_LIBS_PATH</a></tt>
peterz@74 923 environment variable to refer to place where the JAR files,
peterz@74 924 above, are located.
peterz@74 925 </blockquote>
peterz@74 926 <!-- ------------------------------------------------------ -->
ohair@13 927 <h4><a name="compilers">Compilers</a></h4>
ohair@13 928 <blockquote>
ohair@13 929 <strong><a name="gcc">Linux gcc/binutils</a></strong>
ohair@13 930 <blockquote>
ohair@49 931 The GNU gcc compiler version should be 4 or newer.
ohair@13 932 The compiler used should be the default compiler installed
ohair@13 933 in <tt>/usr/bin</tt>.
ohair@13 934 </blockquote>
ohair@13 935 <strong><a name="studio">Solaris: Sun Studio</a></strong>
ohair@13 936 <blockquote>
ohair@13 937 At a minimum, the
ohair@13 938 <a href="http://developers.sun.com/sunstudio/index.jsp" target="_blank">
ohair@30 939 Sun Studio 12 Compilers</a>
ohair@30 940 (containing version 5.9 of the C and C++ compilers) is required,
ohair@13 941 with patches from the
ohair@13 942 <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access" target="_blank">
ohair@13 943 SunSolve web site</a>.
ohair@13 944 <p>
ohair@13 945 Set
ohair@13 946 <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>
ohair@13 947 to point to the location of
ohair@13 948 the compiler binaries, and place this location in the <tt>PATH</tt>.
ohair@13 949 <p>
ohair@13 950 The Sun Studio Express compilers at:
ohair@13 951 <a href="http://developers.sun.com/sunstudio/downloads/express.jsp" target="_blank">
ohair@13 952 Sun Studio Express Download site</a>
ohair@13 953 are also an option, although these compilers have not
ohair@13 954 been extensively used yet.
ohair@13 955 </blockquote>
ohair@49 956 <strong><a name="msvc">Windows i586: Microsoft Visual Studio Compilers</a></strong>
ohair@13 957 <blockquote>
ohair@13 958 The 32-bit OpenJDK Windows build
ohair@49 959 requires
ohair@49 960 Microsoft Visual Studio C++ 2008 (VS2008) Standard
ohair@13 961 Edition compiler.
ohair@13 962 The compiler and other tools are expected to reside
ohair@49 963 in the location defined by the variable
ohair@49 964 <tt>VS90COMNTOOLS</tt> which
ohair@49 965 is set by the Microsoft Visual Studio installer.
ohair@13 966 <p>
ohair@13 967 Once the compiler is installed,
ohair@13 968 it is recommended that you run <tt>VCVARS32.BAT</tt>
ohair@13 969 to set the compiler environment variables
ohair@13 970 <tt>INCLUDE</tt>,
ohair@13 971 <tt>LIB</tt>, and
ohair@13 972 <tt>PATH</tt>
ohair@13 973 prior to building the
ohair@13 974 OpenJDK.
ohair@13 975 The above environment variables <b>MUST</b> be set.
ohair@13 976 <p>
ohair@41 977 <b>WARNING:</b> Make sure you check out the
ohair@41 978 <a href="#cygwin">CYGWIN link.exe WARNING</a>.
ohair@41 979 The path <tt>/usr/bin</tt> must be after the path to the
ohair@41 980 Visual Studio product.
ohair@13 981 </blockquote>
ohair@49 982 <strong><a name="mssdk">Windows: Microsoft Platform SDK</a></strong>
ohair@13 983 <blockquote>
ohair@13 984 On <b>X64</b>, the Microsoft Platform Software
ohair@13 985 Development Kit (SDK), April 2005 Edition compiler,
ohair@13 986 is required for building the OpenJDK
ohair@13 987 because it contains the C/C++ compiler.
ohair@13 988 You will need to minimally install the Core SDK and
ohair@13 989 the MDAC SDK features of this compiler.
ohair@13 990 <p>
ohair@13 991 Once the Platform SDK is installed,
ohair@13 992 it is recommended that you run <tt>SetEnv.Cmd /X64</tt>
ohair@13 993 to set the compiler environment variables
ohair@13 994 <tt>MSSDK</tt>,
ohair@13 995 <tt>MSTOOLS</tt>,
ohair@13 996 <tt>INCLUDE</tt>,
ohair@13 997 <tt>LIB</tt>, and
ohair@13 998 <tt>PATH</tt>
ohair@13 999 prior to building the
ohair@13 1000 OpenJDK.
ohair@13 1001 The above environment variables <b>MUST</b> be set.
ohair@13 1002 <p>
ohair@49 1003 This Platform SDK compiler is only used on X64 builds
ohair@49 1004 but other parts of the Platform SDK may be used
ohair@49 1005 for the X86 builds.
ohair@13 1006 </blockquote>
ohair@13 1007 </blockquote>
ohair@13 1008 <!-- ------------------------------------------------------ -->
ohair@13 1009 <h4><a name="zip">Zip and Unzip</a></h4>
ohair@13 1010 <blockquote>
ohair@13 1011 Version 2.2 (November 3rd 1997) or newer of the zip utility
ohair@13 1012 and version 5.12 or newer of the unzip utility is needed
ohair@13 1013 to build the JDK.
ohair@13 1014 With Solaris, Linux, and Windows CYGWIN, the zip and unzip
ohair@13 1015 utilities installed on the system should be fine.
ohair@13 1016 Information and the source code for
ohair@13 1017 ZIP.EXE and UNZIP.EXE is available on the
ohair@13 1018 <a href="http://www.info-zip.org"
ohair@13 1019 target="_blank">info-zip web site</a>.
ohair@13 1020 </blockquote>
ohair@13 1021 <!-- ------------------------------------------------------ -->
ohair@13 1022 <h4><a name="cups">Common UNIX Printing System (CUPS) Headers (Solaris &amp; Linux)</a></h4>
ohair@13 1023 <blockquote>
ohair@13 1024 <strong>Solaris:</strong>
ohair@13 1025 CUPS header files are required for building the
ohair@13 1026 OpenJDK on Solaris.
ohair@13 1027 The Solaris header files can be obtained by installing
ohair@13 1028 the package <strong>SFWcups</strong> from the Solaris Software
ohair@13 1029 Companion CD/DVD, these often will be installed into
ohair@13 1030 <tt>/opt/sfw/cups</tt>.
ohair@13 1031 <p>
ohair@13 1032 <strong>Linux:</strong>
ohair@13 1033 CUPS header files are required for building the
ohair@13 1034 OpenJDK on Linux.
ohair@13 1035 The Linux header files are usually available from a "cups"
ohair@13 1036 development package, it's recommended that you try and use
ohair@13 1037 the package provided by the particular version of Linux that
ohair@13 1038 you are using.
ohair@13 1039 <p>
ohair@13 1040 The CUPS header files can always be downloaded from
ohair@13 1041 <a href="http://www.cups.org" target="_blank">www.cups.org</a>.
ohair@13 1042 The variable
ohair@13 1043 <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>
ohair@13 1044 can be used to override the default location of the
ohair@13 1045 CUPS Header files.
ohair@13 1046 </blockquote>
ohair@13 1047 <!-- ------------------------------------------------------ -->
andrew@90 1048 <h4><a name="xrender">XRender Extension Headers (Solaris &amp; Linux)</a></h4>
andrew@90 1049 <blockquote>
andrew@90 1050 <p>
andrew@90 1051 <strong>Solaris:</strong>
andrew@90 1052 XRender header files are required for building the
andrew@90 1053 OpenJDK on Solaris.
andrew@90 1054 The XRender header file is included with the other X11 header files
andrew@90 1055 in the package <strong>SFWxwinc</strong> on new enough versions of
andrew@90 1056 Solaris and will be installed in
andrew@90 1057 <tt>/usr/X11/include/X11/extensions/Xrender.h</tt>
andrew@90 1058 </p><p>
andrew@90 1059 <strong>Linux:</strong>
andrew@90 1060 XRender header files are required for building the
andrew@90 1061 OpenJDK on Linux.
andrew@90 1062 The Linux header files are usually available from a "Xrender"
andrew@90 1063 development package, it's recommended that you try and use
andrew@90 1064 the package provided by the particular distribution of Linux that
andrew@90 1065 you are using.
andrew@90 1066 </p>
andrew@90 1067 </blockquote>
andrew@90 1068 <!-- ------------------------------------------------------ -->
ohair@13 1069 <h4><a name="freetype">FreeType 2</a></h4>
ohair@13 1070 <blockquote>
ohair@13 1071 Version 2.3 or newer of FreeType is required for building the OpenJDK.
ohair@13 1072 On Unix systems required files can be available as part of your
ohair@13 1073 distribution (while you still may need to upgrade them).
ohair@13 1074 Note that you need development version of package that
ohair@13 1075 includes both FreeType library and header files.
ohair@13 1076 <p>
ohair@13 1077 You can always download latest FreeType version from the
ohair@13 1078 <a href="http://www.freetype.org" target="_blank">FreeType website</a>.
ohair@13 1079 <p>
ohair@13 1080 Makefiles will try to pick FreeType from /usr/lib and /usr/include.
ohair@13 1081 In case it is installed elsewhere you will need to set environment
ohair@13 1082 variables
ohair@13 1083 <tt><a href="#ALT_FREETYPE_LIB_PATH">ALT_FREETYPE_LIB_PATH</a></tt>
ohair@13 1084 and
ohair@13 1085 <tt><a href="#ALT_FREETYPE_HEADERS_PATH">ALT_FREETYPE_HEADERS_PATH</a></tt>
ohair@13 1086 to refer to place where library and header files are installed.
ohair@25 1087 <p>
ohair@25 1088 Building the freetype 2 libraries from scratch is also possible,
ohair@25 1089 however on Windows refer to the
ohair@25 1090 <a href="http://freetype.freedesktop.org/wiki/FreeType_DLL">
ohair@25 1091 Windows FreeType DLL build instructions</a>.
ohair@25 1092 <p>
ohair@25 1093 Note that by default FreeType is built with byte code hinting
ohair@25 1094 support disabled due to licensing restrictions.
ohair@25 1095 In this case, text appearance and metrics are expected to
ohair@25 1096 differ from Sun's official JDK build.
ohair@25 1097 See
ohair@25 1098 <a href="http://freetype.sourceforge.net/freetype2/index.html">
ohair@25 1099 the SourceForge FreeType2 Home Page
ohair@25 1100 </a>
ohair@25 1101 for more information.
ohair@13 1102 </blockquote>
ohair@13 1103 <!-- ------------------------------------------------------ -->
ohair@13 1104 <h4><a name="alsa">Advanced Linux Sound Architecture (ALSA) (Linux only)</a></h4>
ohair@13 1105 <blockquote>
ohair@13 1106 <strong>Linux only:</strong>
ohair@13 1107 Version 0.9.1 or newer of the ALSA files are
ohair@13 1108 required for building the OpenJDK on Linux.
ohair@13 1109 These Linux files are usually available from an "alsa"
ohair@13 1110 of "libasound"
ohair@13 1111 development package, it's highly recommended that you try and use
ohair@13 1112 the package provided by the particular version of Linux that
ohair@13 1113 you are using.
ohair@13 1114 The makefiles will check this emit a sanity error if it is
ohair@13 1115 missing or the wrong version.
ohair@13 1116 <p>
ohair@13 1117 In particular, older Linux systems will likely not have the
ohair@13 1118 right version of ALSA installed, for example
ohair@13 1119 Redhat AS 2.1 U2 and SuSE 8.1 do not include a sufficiently
ohair@13 1120 recent ALSA distribution.
ohair@13 1121 On rpm-based systems, you can see if ALSA is installed by
ohair@13 1122 running this command:
ohair@13 1123 <pre>
ohair@13 1124 <tt>rpm -qa | grep alsa</tt>
ohair@13 1125 </pre>
ohair@13 1126 Both <tt>alsa</tt> and <tt>alsa-devel</tt> packages are needed.
ohair@13 1127 <p>
ohair@13 1128 If your distribution does not come with ALSA, and you can't
ohair@13 1129 find ALSA packages built for your particular system,
ohair@13 1130 you can try to install the pre-built ALSA rpm packages from
ohair@13 1131 <a href="http://www.freshrpms.net/" target="_blank">
ohair@13 1132 <tt>www.freshrpms.net</tt></a>.
ohair@13 1133 Note that installing a newer ALSA could
ohair@13 1134 break sound output if an older version of ALSA was previously
ohair@13 1135 installed on the system, but it will enable JDK compilation.
ohair@13 1136 <blockquote>
ohair@13 1137 Installation: execute as root<br>
ohair@13 1138 [i586]: <code>rpm -Uv --force alsa-lib-devel-0.9.1-rh61.i386.rpm</code><br>
ohair@13 1139 [x64]: <code>rpm -Uv --force alsa-lib-devel-0.9.8-amd64.x86_64.rpm</code><br>
ohair@13 1140 Uninstallation:<br>
ohair@13 1141 [i586]: <code>rpm -ev alsa-lib-devel-0.9.1-rh61</code><br>
ohair@13 1142 [x64]:<code>rpm -ev alsa-lib-devel-0.9.8-amd64</code><br>
ohair@13 1143 Make sure that you do not link to the static library
ohair@13 1144 (<tt>libasound.a</tt>),
ohair@13 1145 by verifying that the dynamic library (<tt>libasound.so</tt>) is
ohair@13 1146 correctly installed in <tt>/usr/lib</tt>.
ohair@13 1147 </blockquote>
ohair@13 1148 As a last resort you can go to the
ohair@13 1149 <a href="http://www.alsa-project.org" target="_blank">
ohair@13 1150 Advanced Linux Sound Architecture Site</a> and build it from
ohair@13 1151 source.
ohair@13 1152 <blockquote>
ohair@13 1153 Download driver and library
ohair@13 1154 source tarballs from
ohair@13 1155 <a href="http://www.alsa-project.org" target="_blank">ALSA's homepage</a>.
ohair@13 1156 As root, execute the following
ohair@13 1157 commands (you may need to adapt the version number):
ohair@13 1158 <pre>
ohair@13 1159 <tt>
ohair@13 1160 $ tar xjf alsa-driver-0.9.1.tar.bz2
ohair@13 1161 $ cd alsa-driver-0.9.1
ohair@13 1162 $ ./configure
ohair@13 1163 $ make install
ohair@13 1164 $ cd ..
ohair@13 1165 $ tar xjf alsa-lib-0.9.1.tar.bz2
ohair@13 1166 $ cd alsa-lib-0.9.1
ohair@13 1167 $ ./configure
ohair@13 1168 $ make install
ohair@13 1169 </tt>
ohair@13 1170 </pre>
ohair@13 1171 Should one of the above steps fail, refer to the documentation on
ohair@13 1172 ALSA's home page.
ohair@13 1173 </blockquote>
ohair@13 1174 Note that this is a minimum install that enables
ohair@13 1175 building the JDK platform. To actually use ALSA sound drivers, more
ohair@13 1176 steps are necessary as outlined in the documentation on ALSA's homepage.
ohair@13 1177 <p>
ohair@13 1178 ALSA can be uninstalled by executing <tt>make uninstall</tt> first in
ohair@13 1179 the <tt>alsa-lib-0.9.1</tt> directory and then in
ohair@13 1180 <tt>alsa-driver-0.9.1</tt>.
ohair@13 1181 </blockquote>
ohair@13 1182 There are no ALT* variables to change the assumed locations of ALSA,
ohair@13 1183 the makefiles will expect to find the ALSA include files and library at:
ohair@13 1184 <tt>/usr/include/alsa</tt> and <tt>/usr/lib/libasound.so</tt>.
duke@2 1185 </blockquote>
ohair@13 1186 <!-- ------------------------------------------------------ -->
ohair@13 1187 <h4>Windows Specific Dependencies</h4>
duke@2 1188 <blockquote>
ohair@13 1189 <strong>Unix Command Tools (<a name="cygwin">CYGWIN</a>)</strong>
ohair@13 1190 <blockquote>
ohair@13 1191 The OpenJDK requires access to a set of unix command tools
ohair@13 1192 on Windows which can be supplied by
ohair@13 1193 <a href="http://www.cygwin.com" target="_blank">CYGWIN</a>.
ohair@13 1194 <p>
ohair@13 1195 The OpenJDK build requires CYGWIN version 1.5.12 or newer.
ohair@13 1196 Information about CYGWIN can
ohair@13 1197 be obtained from the CYGWIN website at
ohair@13 1198 <a href="http://www.cygwin.com" target="_blank">www.cygwin.com</a>.
ohair@13 1199 <p>
ohair@13 1200 By default CYGWIN doesn't install all the tools required for building
ohair@13 1201 the OpenJDK.
ohair@13 1202 Along with the default installation, you need to install
ohair@13 1203 the following tools.
ohair@13 1204 <blockquote>
ohair@13 1205 <table border="1">
ohair@13 1206 <thead>
ohair@13 1207 <tr>
ohair@13 1208 <td>Binary Name</td>
ohair@41 1209 <td>Category</td>
ohair@13 1210 <td>Package</td>
ohair@13 1211 <td>Description</td>
ohair@13 1212 </tr>
ohair@13 1213 </thead>
ohair@13 1214 <tbody>
ohair@13 1215 <tr>
ohair@13 1216 <td>ar.exe</td>
ohair@13 1217 <td>Devel</td>
ohair@41 1218 <td>binutils</td>
ohair@41 1219 <td>The GNU assembler, linker and binary
ohair@13 1220 utilities</td>
ohair@13 1221 </tr>
ohair@13 1222 <tr>
ohair@13 1223 <td>make.exe</td>
ohair@13 1224 <td>Devel</td>
ohair@41 1225 <td>make</td>
ohair@41 1226 <td>The GNU version of the 'make' utility built for CYGWIN.<br>
ohair@25 1227 <b>NOTE</b>: See <a href="#gmake">the GNU make section</a></td>
ohair@13 1228 </tr>
ohair@13 1229 <tr>
ohair@13 1230 <td>m4.exe</td>
ohair@13 1231 <td>Interpreters</td>
ohair@41 1232 <td>m4</td>
ohair@41 1233 <td>GNU implementation of the traditional Unix macro
ohair@13 1234 processor</td>
ohair@13 1235 </tr>
ohair@13 1236 <tr>
ohair@13 1237 <td>cpio.exe</td>
ohair@13 1238 <td>Utils</td>
ohair@41 1239 <td>cpio</td>
ohair@41 1240 <td>A program to manage archives of files</td>
ohair@13 1241 </tr>
ohair@13 1242 <tr>
ohair@25 1243 <td>gawk.exe</td>
ohair@13 1244 <td>Utils</td>
ohair@41 1245 <td>awk</td>
ohair@41 1246 <td>Pattern-directed scanning and processing language</td>
ohair@13 1247 </tr>
ohair@13 1248 <tr>
ohair@13 1249 <td>file.exe</td>
ohair@13 1250 <td>Utils</td>
ohair@41 1251 <td>file</td>
ohair@41 1252 <td>Determines file type using 'magic' numbers</td>
ohair@13 1253 </tr>
ohair@13 1254 <tr>
ohair@13 1255 <td>zip.exe</td>
ohair@25 1256 <td>Archive</td>
ohair@41 1257 <td>zip</td>
ohair@41 1258 <td>Package and compress (archive) files</td>
ohair@13 1259 </tr>
ohair@13 1260 <tr>
ohair@13 1261 <td>unzip.exe</td>
ohair@25 1262 <td>Archive</td>
ohair@41 1263 <td>unzip</td>
ohair@41 1264 <td>Extract compressed files in a ZIP archive</td>
ohair@13 1265 </tr>
ohair@13 1266 <tr>
ohair@13 1267 <td>free.exe</td>
ohair@41 1268 <td>System</td>
ohair@41 1269 <td>procps</td>
ohair@41 1270 <td>Display amount of free and used memory in the system</td>
ohair@13 1271 </tr>
ohair@13 1272 </tbody>
ohair@13 1273 </table>
ohair@13 1274 </blockquote>
ohair@13 1275 <p>
ohair@13 1276 Note that the CYGWIN software can conflict with other non-CYGWIN
ohair@13 1277 software on your Windows system.
ohair@13 1278 CYGWIN provides a
ohair@13 1279 <a href="http://cygwin.com/faq/faq.using.html" target="_blank">FAQ</a> for
ohair@13 1280 known issues and problems, of particular interest is the
ohair@13 1281 section on
ohair@13 1282 <a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
ohair@13 1283 BLODA (applications that interfere with CYGWIN)</a>.
ohair@41 1284 <p>
ohair@41 1285 <b>WARNING:</b>
ohair@41 1286 Be very careful with <b><tt>link.exe</tt></b>, it will conflict
ohair@41 1287 with the Visual Studio version. You need the Visual Studio
ohair@41 1288 version of <tt>link.exe</tt>, not the CYGWIN one.
ohair@41 1289 So it's important that the Visual Studio paths in PATH preceed
ohair@41 1290 the CYGWIN path <tt>/usr/bin</tt>.
ohair@13 1291 </blockquote>
ohair@13 1292 <strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong>
duke@2 1293 <blockquote>
ohair@13 1294 Microsoft DirectX 9.0 SDK (Summer 2004)
ohair@13 1295 headers are required for building
ohair@13 1296 OpenJDK.
ohair@13 1297 This SDK can be downloaded from
ohair@13 1298 <a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=FD044A42-9912-42A3-9A9E-D857199F888E&amp;displaylang=en" target="_blank">
ohair@13 1299 Microsoft DirectX 9.0 SDK (Summer 2004)</a>.
ohair@13 1300 If the link above becomes obsolete, the SDK can be found from
ohair@13 1301 <a href="http://download.microsoft.com" target="_blank">the Microsoft Download Site</a>
ohair@13 1302 (search with "DirectX 9.0 SDK Update Summer 2004").
ohair@13 1303 The location of this SDK can be set with
ohair@13 1304 <tt><a href="#ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt>
ohair@13 1305 but it's normally found via the DirectX environment variable
ohair@13 1306 <tt>DXSDK_DIR</tt>.
ohair@13 1307 </blockquote>
ohair@13 1308 <strong><a name="msvcrt"><tt>MSVCRT.DLL</tt></a></strong>
ohair@13 1309 <blockquote>
ohair@13 1310 <strong>i586 only:</strong>
ohair@49 1311 The OpenJDK 32-bit build requires access to a redistributable
ohair@49 1312 <tt>MSVCRT.DLL</tt>.
ohair@13 1313 If the <tt>MSVCRT.DLL</tt> is not installed in
ohair@13 1314 the system32 directory set the
ohair@13 1315 <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
ohair@49 1316 variable to the location of this file.
ohair@13 1317 <p>
ohair@13 1318 <strong>X64 only:</strong>
ohair@49 1319 The OpenJDK 64-bit build requires access to a redistributable
ohair@49 1320 <tt>MSVCRT.DLL</tt>, which is
ohair@13 1321 usually supplied by the
ohair@13 1322 <a href="#mssdk">Platform SDK</a>.
ohair@13 1323 If it is not available from the Platform SDK,
ohair@13 1324 set the
ohair@13 1325 <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
ohair@49 1326 variable to the location of this file.
ohair@13 1327 </blockquote>
ohair@49 1328 <strong><tt><a name="msvcr90">MSVCR90.DLL</a></tt></strong>
ohair@13 1329 <blockquote>
ohair@13 1330 <strong>i586 only:</strong>
ohair@13 1331 The
ohair@13 1332 OpenJDK
ohair@49 1333 build requires access to a redistributable
ohair@49 1334 <tt>MSVCR90.DLL</tt> which should be
ohair@13 1335 supplied by the
ohair@49 1336 <a href="#msvc">Visual Studio product</a>.
ohair@49 1337 If the <tt>MSVCR90.DLL</tt> is not available from the
ohair@13 1338 Visual Studio product
ohair@13 1339 set the
ohair@49 1340 <a href="#ALT_MSVCR90_DLL_PATH"><tt>ALT_MSVCR90_DLL_PATH</tt></a>
ohair@49 1341 variable to the location of this file.
duke@2 1342 </blockquote>
duke@2 1343 </blockquote>
ohair@13 1344 <!-- ------------------------------------------------------ -->
ohair@13 1345 <hr>
ohair@13 1346 <h2><a name="creating">Creating the Build</a></h2>
duke@2 1347 <blockquote>
ohair@13 1348 Once a machine is setup to build the OpenJDK,
ohair@13 1349 the steps to create the build are fairly simple.
ohair@13 1350 The various ALT settings can either be made into variables
ohair@13 1351 or can be supplied on the
ohair@13 1352 <a href="#gmake"><tt><i>gmake</i></tt></a>
ohair@13 1353 command.
ohair@13 1354 <ol>
ohair@13 1355 <li>Use the sanity rule to double check all the ALT settings:
ohair@13 1356 <blockquote>
ohair@13 1357 <tt>
ohair@13 1358 <i>gmake</i>
ohair@13 1359 sanity
ohair@13 1360 [ARCH_DATA_MODEL=<i>32 or 64</i>]
ohair@13 1361 [other "ALT_" overrides]
ohair@13 1362 </tt>
ohair@13 1363 </blockquote>
ohair@13 1364 </li>
ohair@13 1365 <li>Start the build with the command:
ohair@13 1366 <blockquote>
ohair@13 1367 <tt>
ohair@13 1368 <i>gmake</i>
ohair@13 1369 [ARCH_DATA_MODEL=<i>32 or 64</i>]
ohair@13 1370 [ALT_OUTPUTDIR=<i>output_directory</i>]
ohair@13 1371 [other "ALT_" overrides]
ohair@13 1372 </tt>
ohair@13 1373 </blockquote>
ohair@13 1374 </li>
ohair@13 1375 </ol>
duke@2 1376 <p>
ohair@13 1377 <strong>Solaris:</strong>
ohair@13 1378 Note that ARCH_DATA_MODEL is really only needed on Solaris to
ohair@13 1379 indicate you want to built the 64-bit version.
ohair@13 1380 And before the Solaris 64-bit binaries can be used, they
ohair@13 1381 must be merged with the binaries from a separate 32-bit build.
ohair@13 1382 The merged binaries may then be used in either 32-bit or 64-bit mode, with
ohair@13 1383 the selection occurring at runtime
ohair@13 1384 with the <tt>-d32</tt> or <tt>-d64</tt> options.
duke@2 1385 </blockquote>
ohair@13 1386 <!-- ------------------------------------------------------ -->
ohair@13 1387 <hr>
ohair@13 1388 <h2><a name="testing">Testing the Build</a></h2>
ohair@13 1389 <blockquote>
ohair@13 1390 When the build is completed, you should see the generated
ohair@13 1391 binaries and associated files in the <tt>j2sdk-image</tt>
ohair@13 1392 directory in the output directory.
ohair@13 1393 The default output directory is
ohair@13 1394 <tt>build/<i>platform</i></tt>,
ohair@13 1395 where <tt><i>platform</i></tt> is one of
ohair@13 1396 <tt><ul>
ohair@13 1397 <li>solaris-sparc</li>
ohair@13 1398 <li>solaris-sparcv9</li>
ohair@13 1399 <li>solaris-i586</li>
ohair@13 1400 <li>solaris-amd64</li>
ohair@13 1401 <li>linux-i586</li>
ohair@13 1402 <li>linux-amd64</li>
ohair@13 1403 <li>windows-i586</li>
ohair@13 1404 <li>windows-amd64</li>
ohair@13 1405 </ul></tt>
ohair@13 1406 In particular, the
ohair@13 1407 <tt>build/<i>platform</i>/j2sdk-image/bin</tt>
ohair@13 1408 directory should contain executables for the
ohair@13 1409 OpenJDK tools and utilities.
duke@2 1410 <p>
ohair@13 1411 You can test that the build completed properly by using the build
ohair@13 1412 to run the various demos that you will find in the
ohair@13 1413 <tt>build/<i>platform</i>/j2sdk-image/demo</tt>
ohair@13 1414 directory.
ohair@13 1415 <p>
ohair@13 1416 The provided regression tests can be run with the <tt>jtreg</tt>
ohair@13 1417 utility from
ohair@13 1418 <a href="http://openjdk.java.net/jtreg/" target="_blank">the jtreg site</a>.
duke@2 1419 </blockquote>
ohair@13 1420 <!-- ------------------------------------------------------ -->
ohair@13 1421 <hr>
ohair@13 1422 <h2><a name="variables">Environment/Make Variables</a></h2>
ohair@13 1423 <p>
ohair@13 1424 Some of the
ohair@13 1425 environment or make variables (just called <b>variables</b> in this
ohair@13 1426 document) that can impact the build are:
duke@2 1427 <blockquote>
duke@2 1428 <dl>
ohair@49 1429 <dt><a name="path"><tt>PATH</tt></a> </dt>
ohair@49 1430 <dd>Typically you want to set the <tt>PATH</tt> to include:
ohair@49 1431 <ul>
ohair@49 1432 <li>The location of the GNU make binary</li>
ohair@49 1433 <li>The location of the Bootstrap JDK <tt>java</tt>
ohair@49 1434 (see <a href="#bootjdk">Bootstrap JDK</a>)</li>
ohair@49 1435 <li>The location of the C/C++ compilers
ohair@49 1436 (see <a href="#compilers"><tt>compilers</tt></a>)</li>
ohair@49 1437 <li>The location or locations for the Unix command utilities
ohair@49 1438 (e.g. <tt>/usr/bin</tt>)</li>
ohair@49 1439 </ul>
ohair@49 1440 </dd>
ohair@49 1441 <dt><tt>MILESTONE</tt> </dt>
ohair@49 1442 <dd>
ohair@49 1443 The milestone name for the build (<i>e.g.</i>"beta").
ohair@49 1444 The default value is "internal".
ohair@49 1445 </dd>
ohair@49 1446 <dt><tt>BUILD_NUMBER</tt> </dt>
ohair@49 1447 <dd>
ohair@49 1448 The build number for the build (<i>e.g.</i> "b27").
ohair@49 1449 The default value is "b00".
ohair@49 1450 </dd>
ohair@49 1451 <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
ohair@49 1452 <dd>The <tt>ARCH_DATA_MODEL</tt> variable
ohair@49 1453 is used to specify whether the build is to generate 32-bit or 64-bit
ohair@49 1454 binaries.
ohair@49 1455 The Solaris build supports either 32-bit or 64-bit builds, but
ohair@49 1456 Windows and Linux will support only one, depending on the specific
ohair@49 1457 OS being used.
ohair@49 1458 Normally, setting this variable is only necessary on Solaris.
ohair@49 1459 Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries,
ohair@49 1460 or to <tt>64</tt> for generating 64-bit binaries.
ohair@49 1461 </dd>
ohair@49 1462 <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
ohair@49 1463 <dd>
ohair@49 1464 The location of the bootstrap JDK installation.
ohair@49 1465 See <a href="#bootjdk">Bootstrap JDK</a> for more information.
ohair@49 1466 You should always install your own local Bootstrap JDK and
ohair@49 1467 always set <tt>ALT_BOOTDIR</tt> explicitly.
ohair@49 1468 </dd>
ohair@25 1469 <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
duke@2 1470 <dd>
ohair@25 1471 The location of the binary plugs installation.
ohair@25 1472 See <a href="#binaryplugs">Binary Plugs</a> for more information.
ohair@25 1473 You should always have a local copy of a
ohair@25 1474 recent Binary Plugs install image
ohair@25 1475 and set this variable to that location.
ohair@13 1476 </dd>
ohair@49 1477 <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
duke@2 1478 <dd>
ohair@49 1479 The location of a previously built JDK installation.
ohair@49 1480 See <a href="#importjdk">Optional Import JDK</a> for more information.
ohair@49 1481 </dd>
ohair@49 1482 <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
ohair@49 1483 <dd>
ohair@49 1484 An override for specifying the (absolute) path of where the
ohair@49 1485 build output is to go.
ohair@49 1486 The default output directory will be build/<i>platform</i>.
ohair@49 1487 </dd>
ohair@49 1488 <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
ohair@49 1489 <dd>
ohair@49 1490 The location of the C/C++ compiler.
ohair@49 1491 The default varies depending on the platform.
ohair@49 1492 </dd>
ohair@49 1493 <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
ohair@49 1494 <dd>
ohair@49 1495 The location of the <a href="#cacerts">cacerts</a> file.
ohair@49 1496 The default will refer to
ohair@49 1497 <tt>jdk/src/share/lib/security/cacerts</tt>.
ohair@49 1498 </dd>
peterz@74 1499 <dt><tt><a name="ALT_JIBX_LIBS_PATH">ALT_JIBX_LIBS_PATH</a></tt></dt>
peterz@74 1500 <dd>
peterz@74 1501 The location of the <a href="#jibx">JIBX libraries</a> file.
peterz@74 1502 The default value is
peterz@74 1503 <tt>$(ALT_SLASH_JAVA)/devtools/share/jibx/lib</tt>.
peterz@74 1504 </dd>
ohair@49 1505 <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt>
ohair@49 1506 <dd>
ohair@49 1507 The location of the CUPS header files.
ohair@49 1508 See <a href="#cups">CUPS information</a> for more information.
ohair@49 1509 If this path does not exist the fallback path is
ohair@49 1510 <tt>/usr/include</tt>.
ohair@49 1511 </dd>
ohair@49 1512 <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt>
ohair@49 1513 <dd>
ohair@49 1514 The location of the FreeType shared library.
ohair@49 1515 See <a href="#freetype">FreeType information</a> for details.
ohair@49 1516 </dd>
ohair@49 1517 <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt>
ohair@49 1518 <dd>
ohair@49 1519 The location of the FreeType header files.
ohair@49 1520 See <a href="#freetype">FreeType information</a> for details.
ohair@49 1521 </dd>
ohair@49 1522 <dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt>
ohair@49 1523 <dd>
ohair@49 1524 The default root location of the devtools.
ohair@49 1525 The default value is
ohair@49 1526 <tt>$(ALT_SLASH_JAVA)/devtools</tt>.
ohair@49 1527 </dd>
ohair@49 1528 <dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt>
ohair@49 1529 <dd>
ohair@49 1530 The location of tools like the
ohair@49 1531 <a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a>
ohair@49 1532 binaries, but might also contain the GNU make utility
ohair@49 1533 (<tt><i>gmake</i></tt>).
ohair@49 1534 So this area is a bit of a grab bag, especially on Windows.
ohair@49 1535 The default value depends on the platform and
ohair@49 1536 Unix Commands being used.
ohair@49 1537 On Linux the default will be
ohair@49 1538 <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>,
ohair@49 1539 on Solaris
ohair@49 1540 <tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>,
ohair@49 1541 and on Windows with CYGWIN
ohair@49 1542 <tt>/usr/bin</tt>.
ohair@49 1543 </dd>
ohair@49 1544 <dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt>
ohair@49 1545 <dd>
ohair@49 1546 <strong>Solaris only:</strong>
ohair@49 1547 An override for specifying where the Unix CCS
ohair@49 1548 command set are located.
ohair@49 1549 The default location is <tt>/usr/ccs/bin</tt>
ohair@49 1550 </dd>
ohair@49 1551 <dt><a name="ALT_SLASH_JAVA"><tt>ALT_SLASH_JAVA</tt></a></dt>
ohair@49 1552 <dd>
ohair@49 1553 The default root location for many of the ALT path locations
ohair@49 1554 of the following ALT variables.
ohair@49 1555 The default value is
ohair@49 1556 <tt>"/java"</tt> on Solaris and Linux,
ohair@49 1557 <tt>"J:"</tt> on Windows.
ohair@49 1558 </dd>
ohair@49 1559 <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt>
ohair@49 1560 <dd>
ohair@49 1561 These are useful in managing builds on multiple platforms.
ohair@49 1562 The default network location for all of the import JDK images
ohair@49 1563 for all platforms.
ohair@49 1564 If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
ohair@49 1565 is not set, this directory will be used and should contain
ohair@49 1566 the following directories:
ohair@49 1567 <tt>solaris-sparc</tt>,
ohair@49 1568 <tt>solaris-i586</tt>,
ohair@49 1569 <tt>solaris-sparcv9</tt>,
ohair@49 1570 <tt>solaris-amd64</tt>,
ohair@49 1571 <tt>linux-i586</tt>,
ohair@49 1572 <tt>linux-amd64</tt>,
ohair@49 1573 <tt>windows-i586</tt>,
ohair@49 1574 and
ohair@49 1575 <tt>windows-amd64</tt>.
ohair@49 1576 Where each of these directories contain the import JDK image
ohair@49 1577 for that platform.
duke@2 1578 </dd>
ohair@25 1579 <dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt>
duke@2 1580 <dd>
ohair@25 1581 These are useful in managing builds on multiple platforms.
ohair@25 1582 The default network location for all of the binary plug images
ohair@25 1583 for all platforms.
ohair@25 1584 If <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
ohair@25 1585 is not set, this directory will be used and should contain
ohair@25 1586 the following directories:
ohair@25 1587 <tt>solaris-sparc</tt>,
ohair@25 1588 <tt>solaris-i586</tt>,
ohair@25 1589 <tt>solaris-sparcv9</tt>,
ohair@25 1590 <tt>solaris-amd64</tt>,
ohair@25 1591 <tt>linux-i586</tt>,
ohair@25 1592 <tt>linux-amd64</tt>,
ohair@25 1593 <tt>windows-i586</tt>,
ohair@25 1594 and
ohair@25 1595 <tt>windows-amd64</tt>.
ohair@25 1596 Where each of these directories contain the binary plugs image
ohair@25 1597 for that platform.
ohair@13 1598 </dd>
ohair@49 1599 <dt><strong>Windows specific:</strong></dt>
ohair@13 1600 <dd>
ohair@49 1601 <dl>
ohair@49 1602 <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt>
ohair@49 1603 <dd>
ohair@49 1604 The location of the
ohair@49 1605 Microsoft Visual Studio
ohair@49 1606 tools 'bin' directory.
ohair@49 1607 The default is usually derived from
ohair@49 1608 <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
ohair@49 1609 </dd>
ohair@49 1610 <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
ohair@49 1611 <dd>
ohair@49 1612 The location of the
ohair@49 1613 <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
ohair@49 1614 The default will be to try and use the DirectX environment
ohair@49 1615 variable <tt>DXSDK_DIR</tt>,
ohair@49 1616 failing that, look in <tt>C:/DXSDK</tt>.
ohair@49 1617 </dd>
ohair@49 1618 <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt>
ohair@49 1619 <dd>
ohair@49 1620 The location of the
ohair@49 1621 <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>.
ohair@49 1622 </dd>
ohair@49 1623 <dt><tt><a name="ALT_MSVCR90_DLL_PATH">ALT_MSVCR90_DLL_PATH</a></tt> </dt>
ohair@49 1624 <dd>
ohair@49 1625 <strong>i586 only:</strong>
ohair@49 1626 The location of the
ohair@49 1627 <a href="#msvcr90"><tt>MSVCR90.DLL</tt></a>.
ohair@49 1628 </dd>
ohair@49 1629 </dl>
duke@2 1630 </dd>
duke@2 1631 </dl>
ohair@13 1632 </blockquote>
ohair@13 1633 <!-- ------------------------------------------------------ -->
ohair@13 1634 <hr>
ohair@13 1635 <h2><a name="troubleshooting">Troubleshooting</a></h2>
ohair@13 1636 <blockquote>
ohair@13 1637 A build can fail for any number of reasons.
ohair@13 1638 Most failures
ohair@13 1639 are a result of trying to build in an environment in which all the
ohair@13 1640 pre-build requirements have not been met.
ohair@13 1641 The first step in
ohair@13 1642 troubleshooting a build failure is to recheck that you have satisfied
ohair@13 1643 all the pre-build requirements for your platform.
ohair@13 1644 Look for the check list of the platform you are building on in the
ohair@13 1645 <a href="#contents">Table of Contents</a>.
ohair@13 1646 <p>
ohair@13 1647 You can validate your build environment by using the <tt>sanity</tt>
ohair@13 1648 target.
ohair@13 1649 Any errors listed
ohair@13 1650 will stop the build from starting, and any warnings may result in
ohair@13 1651 a flawed product build.
ohair@13 1652 We strongly encourage you to evaluate every
ohair@13 1653 sanity check warning and fix it if required, before you proceed
ohair@13 1654 further with your build.
ohair@13 1655 <p>
ohair@13 1656 Some of the more common problems with builds are briefly described
ohair@13 1657 below, with suggestions for remedies.
ohair@13 1658 <ul>
ohair@13 1659 <li>
ohair@13 1660 <b>Slow Builds:</b>
ohair@13 1661 <blockquote>
ohair@13 1662 If your build machine seems to be overloaded from too many
ohair@13 1663 simultaneous C++ compiles, try setting the <tt>HOTSPOT_BUILD_JOBS</tt>
ohair@13 1664 variable to <tt>1</tt> (if you're using a multiple CPU
ohair@13 1665 machine, setting it to more than the the number of CPUs is probably
ohair@13 1666 not a good idea).
ohair@13 1667 <p>
ohair@13 1668 Creating the javadocs can be very slow, if you are running
ohair@13 1669 javadoc, consider skipping that step.
ohair@13 1670 <p>
ohair@13 1671 Faster hardware and more RAM always helps too.
ohair@13 1672 The VM build tends to be CPU intensive (many C++ compiles),
ohair@13 1673 and the rest of the JDK will often be disk intensive.
ohair@13 1674 <p>
ohair@13 1675 Faster compiles are possible using a tool called
ohair@13 1676 <a href="http://ccache.samba.org/" target="_blank">ccache</a>.
ohair@13 1677 </blockquote>
ohair@13 1678 </li>
ohair@13 1679 <li>
ohair@13 1680 <b>File time issues:</b>
ohair@13 1681 <blockquote>
ohair@13 1682 If you see warnings that refer to file time stamps, e.g.
ohair@13 1683 <blockquote>
ohair@13 1684 <i>Warning message:</i><tt> File `xxx' has modification time in
ohair@13 1685 the future.</tt>
ohair@13 1686 <br>
ohair@13 1687 <i>Warning message:</i> <tt> Clock skew detected. Your build may
ohair@13 1688 be incomplete.</tt>
ohair@13 1689 </blockquote>
ohair@13 1690 These warnings can occur when the clock on the build machine is out of
ohair@13 1691 sync with the timestamps on the source files. Other errors, apparently
ohair@13 1692 unrelated but in fact caused by the clock skew, can occur along with
ohair@13 1693 the clock skew warnings. These secondary errors may tend to obscure the
ohair@13 1694 fact that the true root cause of the problem is an out-of-sync clock.
ohair@13 1695 For example, an out-of-sync clock has been known to cause an old
ohair@13 1696 version of javac to be used to compile some files, resulting in errors
ohair@13 1697 when the pre-1.4 compiler ran across the new <tt>assert</tt> keyword
ohair@13 1698 in the 1.4 source code.
ohair@13 1699 <p>
ohair@13 1700 If you see these warnings, reset the clock on the build
ohair@13 1701 machine, run "<tt><i>gmake</i> clobber</tt>" or delete the directory
ohair@13 1702 containing the build output, and restart the build from the beginning.
ohair@13 1703 </blockquote>
ohair@13 1704 </li>
ohair@13 1705 <li>
ohair@13 1706 <b>Error message: <tt>Trouble writing out table to disk</tt></b>
ohair@13 1707 <blockquote>
ohair@13 1708 Increase the amount of swap space on your build machine.
ohair@13 1709 </blockquote>
ohair@13 1710 </li>
ohair@13 1711 <li>
ohair@13 1712 <b>Error Message: <tt>libstdc++ not found:</tt></b>
ohair@13 1713 <blockquote>
ohair@13 1714 This is caused by a missing libstdc++.a library.
ohair@13 1715 This is installed as part of a specific package
ohair@13 1716 (e.g. libstdc++.so.devel.386).
ohair@49 1717 By default some 64-bit Linux versions (e.g. Fedora)
ohair@49 1718 only install the 64-bit version of the libstdc++ package.
ohair@13 1719 Various parts of the JDK build require a static
ohair@13 1720 link of the C++ runtime libraries to allow for maximum
ohair@13 1721 portability of the built images.
ohair@13 1722 </blockquote>
ohair@13 1723 </li>
ohair@13 1724 <li>
ohair@13 1725 <b>Error Message: <tt>cannot restore segment prot after reloc</tt></b>
ohair@13 1726 <blockquote>
ohair@13 1727 This is probably an issue with SELinux (See
ohair@13 1728 <a href="http://en.wikipedia.org/wiki/SELinux" target="_blank">
ohair@13 1729 http://en.wikipedia.org/wiki/SELinux</a>).
ohair@13 1730 Parts of the VM is built without the <tt>-fPIC</tt> for
ohair@13 1731 performance reasons.
ohair@13 1732 <p>
ohair@13 1733 To completely disable SELinux:
ohair@13 1734 <tt>
ohair@13 1735 <ol>
ohair@13 1736 <li>$ su root</li>
ohair@13 1737 <li># system-config-securitylevel</li>
ohair@13 1738 <li>In the window that appears, select the SELinux tab</li>
ohair@13 1739 <li>Disable SELinux</li>
ohair@13 1740 </ol>
ohair@13 1741 </tt>
ohair@13 1742 <p>
ohair@13 1743 Alternatively, instead of completely disabling it you could
ohair@13 1744 disable just this one check.
ohair@13 1745 <tt>
ohair@13 1746 <ol>
ohair@13 1747 <li>Select System->Administration->SELinux Management</li>
ohair@13 1748 <li>In the SELinux Management Tool which appears,
ohair@13 1749 select "Boolean" from the menu on the left</li>
ohair@13 1750 <li>Expand the "Memory Protection" group</li>
ohair@13 1751 <li>Check the first item, labeled
ohair@13 1752 "Allow all unconfined executables to use libraries requiring text relocation ..."</li>
ohair@13 1753 </ol>
ohair@13 1754 </tt>
ohair@13 1755 </blockquote>
ohair@13 1756 </li>
ohair@13 1757 <li>
ohair@13 1758 <b>Windows Error Message: <tt>*** fatal error - couldn't allocate heap, ... </tt></b>
ohair@13 1759 <blockquote>
ohair@13 1760 The CYGWIN software can conflict with other non-CYGWIN
ohair@13 1761 software. See the CYGWIN FAQ section on
ohair@13 1762 <a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
ohair@13 1763 BLODA (applications that interfere with CYGWIN)</a>.
ohair@13 1764 </blockquote>
ohair@13 1765 </li>
ohair@13 1766 <li>
ohair@13 1767 <b>Windows Error Message: <tt>*** multiple target patterns. Stop.</tt></b>
ohair@13 1768 <blockquote>
ohair@13 1769 The CYGWIN make version 3.81 may not like the Windows <tt>C:/</tt>
ohair@13 1770 style paths, it may not like the ':' character in the path
ohair@13 1771 when used in a makefile target definition.
ohair@13 1772 See the <a href="#gmake"><tt><i>gmake</i></tt></a> section.
ohair@13 1773 </blockquote>
ohair@13 1774 </li>
ohair@13 1775 </ul>
ohair@13 1776 </blockquote>
ohair@13 1777 <hr>
ohair@13 1778 </body>
ohair@13 1779 </html>

mercurial