annotate README-builds.html @ 240:8b474f74f0cc

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