annotate README-builds.html @ 5109:7077b95d42f6

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