./README-builds.html

Print this page




  47                     <ul>
  48                         <li><a href="#fedora">Fedora Linux</a> </li>
  49                         <li><a href="#centos">CentOS Linux</a> </li>
  50                         <li><a href="#debian">Debian GNU/Linux</a></li>
  51                         <li><a href="#ubuntu">Ubuntu Linux</a> </li>
  52                         <li><a href="#opensuse">OpenSUSE</a></li>
  53                         <li><a href="#mandriva">Mandriva</a></li>
  54                         <li><a href="#opensolaris">OpenSolaris</a></li>
  55                     </ul>
  56                 </li>
  57                 <li><a href="#directories">Source Directory Structure</a> </li>
  58                 <li><a href="#building">Build Information</a>
  59                     <ul>
  60                         <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
  61                         <li><a href="#linux">Basic Linux System Setup</a> </li>
  62                         <li><a href="#solaris">Basic Solaris System Setup</a> </li>
  63                         <li><a href="#windows">Basic Windows System Setup</a> </li>
  64                         <li><a href="#dependencies">Build Dependencies</a>
  65                             <ul>
  66                                 <li><a href="#bootjdk">Bootstrap JDK</a> </li>
  67                                 <li><a href="#binaryplugs">Binary Plugs</a> </li>
  68                                 <li><a href="#importjdk">Optional Import JDK</a> </li>
  69                                 <li><a href="#ant">Ant</a> </li>
  70                                 <li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
  71                                 <li><a href="#compilers">Compilers</a>
  72                                     <ul>
  73                                         <li><a href="#msvc32">Microsoft Visual Studio Professional/Express for 32 bit</a> </li>
  74                                         <li><a href="#msvc64">Microsoft Visual Studio Professional for 64 bit</a> </li>
  75                                         <li><a href="#mssdk64">Microsoft Windows SDK for 64 bit</a> </li>
  76                                         <li><a href="#gcc">Linux gcc/binutils</a> </li>
  77                                         <li><a href="#studio">Sun Studio</a> </li>
  78                                     </ul>
  79                                 </li>
  80                                 <li><a href="#zip">Zip and Unzip</a> </li>
  81                                 <li><a href="#freetype">FreeType2 Fonts</a> </li>
  82                                 <li>Linux and Solaris:
  83                                     <ul>
  84                                         <li><a href="#cups">CUPS Include files</a> </li>
  85                                         <li><a href="#xrender">XRender Include files</a></li>
  86                                     </ul>
  87                                 </li>


 688                 Note that some Linux systems have a habit of pre-populating
 689                 your environment variables for you, for example <tt>JAVA_HOME</tt>
 690                 might get pre-defined for you to refer to the JDK installed on
 691                 your Linux system.
 692                 You will need to unset <tt>JAVA_HOME</tt>.
 693                 It's a good idea to run <tt>env</tt> and verify the
 694                 environment variables you are getting from the default system
 695                 settings make sense for building the
 696                 OpenJDK.
 697         </blockquote>
 698         <!-- ------------------------------------------------------ -->
 699         <h4><a name="linux_checklist">Basic Linux Check List</a></h4>
 700         <blockquote>
 701             <ol>
 702                 <li>
 703                     Install the
 704                     <a href="#bootjdk">Bootstrap JDK</a>, set
 705                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
 706                 </li>
 707                 <li>
 708                     Install the
 709                     <a href="#binaryplugs">Binary Plugs</a>, set
 710                     <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
 711                 </li>
 712                 <li>
 713                     <a href="#importjdk">Optional Import JDK</a>, set
 714                     <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
 715                 </li>
 716                 <li>
 717                     Install or upgrade the <a href="#freetype">FreeType development
 718                         package</a>.
 719                 </li>
 720                 <li>
 721                     Install
 722                     <a href="#ant">Ant</a>, 
 723                     make sure it is in your PATH.
 724                 </li>
 725             </ol>
 726         </blockquote>
 727         <!-- ------------------------------------------------------ -->
 728         <hr>
 729         <h3><a name="solaris">Basic Solaris System Setup</a></h3>
 730         <blockquote>
 731             The minimum recommended hardware for building the
 732             Solaris SPARC version is an UltraSPARC with 512 MB of RAM. 


 747                 and <tt>/usr/bin</tt> of a standard developer or full installation of
 748                 the Solaris operating environment.
 749             <p> 
 750                 Solaris patches specific to the JDK can be downloaded from the
 751                 <a href="http://sunsolve.sun.com/show.do?target=patches/JavaSE" target="_blank">
 752                     SunSolve JDK Solaris patches download page</a>.
 753                 You should ensure that the latest patch cluster for
 754                 your version of the Solaris operating environment has also
 755                 been installed.
 756         </blockquote>
 757         <!-- ------------------------------------------------------ -->
 758         <h4><a name="solaris_checklist">Basic Solaris Check List</a></h4>
 759         <blockquote>
 760             <ol>
 761                 <li>
 762                     Install the
 763                     <a href="#bootjdk">Bootstrap JDK</a>, set
 764                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
 765                 </li>
 766                 <li>
 767                     Install the
 768                     <a href="#binaryplugs">Binary Plugs</a>, set
 769                     <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
 770                 </li>
 771                 <li>
 772                     <a href="#importjdk">Optional Import JDK</a>, set
 773                     <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
 774                 </li>
 775                 <li>
 776                     Install the
 777                     <a href="#studio">Sun Studio Compilers</a>, set
 778                     <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
 779                 </li>
 780                 <li>
 781                     Install the
 782                     <a href="#cups">CUPS Include files</a>, set
 783                     <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
 784                 </li>
 785                 <li>
 786                     Install the <a href="#xrender">XRender Include files</a>.
 787                 </li>
 788                 <li>
 789                     Install
 790                     <a href="#ant">Ant</a>, 
 791                     make sure it is in your PATH.


 839                 With CYGWIN, it uses ":", but that means that paths like "C:/path"
 840                 cannot be placed in the CYGWIN version  of <tt>PATH</tt> and
 841                 instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
 842                 which CYGWIN understands, but only CYGWIN understands.
 843                 So be careful with paths on Windows.
 844         </blockquote>
 845         <!-- ------------------------------------------------------ -->
 846         <h4><a name="windows_checklist">Basic Windows Check List</a></h4>
 847         <blockquote>
 848             <ol>
 849                 <li>
 850                     Install the
 851                     <a href="#cygwin">CYGWIN product</a>. 
 852                 </li>
 853                 <li>
 854                     Install the 
 855                     <a href="#bootjdk">Bootstrap JDK</a>, set
 856                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
 857                 </li>
 858                 <li>
 859                     Install the
 860                     <a href="#binaryplugs">Binary Plugs</a>, set
 861                     <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>..
 862                 </li>
 863                 <li>
 864                     <a href="#importjdk">Optional Import JDK</a>, set
 865                     <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
 866                 </li>
 867                 <li>
 868                     Install the
 869                     <a href="#msvc32">Microsoft Visual Studio Compilers</a>).
 870                 </li>
 871                 <li>
 872                     Setup all environment variables for compilers 
 873                     (see <a href="#msvc32">compilers</a>).
 874                 </li>
 875                 <li>
 876                     Install 
 877                     <a href="#dxsdk">Microsoft DirectX SDK</a>.
 878                 </li>
 879                 <li>
 880                     Install
 881                     <a href="#ant">Ant</a>, 
 882                     make sure it is in your PATH and set
 883                     <tt><a href="#ANT_HOME">ANT_HOME</a></tt>.


 908                 For build performance reasons
 909                 is very important that this bootstrap JDK be made available on the
 910                 local disk of the machine doing the build.
 911                 You should always set 
 912                 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
 913                 to point to the location of
 914                 the bootstrap JDK installation, this is the directory pathname
 915                 that contains a <tt>bin, lib, and include</tt>
 916                 It's also a good idea to also place its <tt>bin</tt> directory
 917                 in the <tt>PATH</tt> environment variable, although it's
 918                 not required.
 919                 <p>
 920                     <strong>Solaris:</strong>
 921                     Some pre-installed JDK images may be available to you in the
 922                     directory <tt>/usr/jdk/instances</tt>.
 923                     If you don't set
 924                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
 925                     the makefiles will look in that location for a JDK it can use.
 926             </blockquote>
 927             <!-- ------------------------------------------------------ -->
 928             <h4><a name="binaryplugs">Binary Plugs</a></h4>
 929             <blockquote>
 930                 Not all of the source code that makes up the JDK is available
 931                 under an open-source license.
 932                 This is a temporary situation and these binary plugs will be
 933                 replaced with fully open source replacements as soon as possible.
 934                 So currently, in order to build a complete OpenJDK image,
 935                 you must first download and install the appropriate
 936                 binary plug bundles for the OpenJDK, go to the
 937                 <a href="http://openjdk.java.net" target="_blank">OpenJDK</a> site and select
 938                 the 
 939                 "<b>Bundles(7)</b>"
 940                 link and download the binaryplugs for
 941                 your particular platform.
 942                 The file downloaded is a jar file that must be extracted by running
 943                 the jar file with:
 944                 <blockquote>
 945                     <pre>
 946             <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>
 947                     </pre>
 948                 </blockquote>
 949                 A prompt will be issued for acceptance of these binary plug files.
 950                 During the OpenJDK build process these "binary plugs"
 951                 for the encumbered components will be copied into your
 952                 resulting OpenJDK binary build image.
 953                 These binary plug files are only for the purpose of
 954                 building an OpenJDK binary.
 955                 Make sure you set
 956                 <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
 957                 to the root of this installation.
 958             </blockquote>
 959             <!-- ------------------------------------------------------ -->
 960             <h4><a name="importjdk">Optional Import JDK</a></h4>
 961             <blockquote>
 962                 The <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
 963                 setting is only needed if you are not building the entire
 964                 JDK. For example, if you have built the entire JDK once, and
 965                 wanted to avoid repeatedly building the Hotspot VM, you could
 966                 set this to the location of the previous JDK install image
 967                 and the build will copy the needed files from this import area.
 968             </blockquote>
 969             <!-- ------------------------------------------------------ -->
 970             <h4><a name="ant">Ant</a></h4>
 971             <blockquote>
 972                 All OpenJDK builds require access to least Ant 1.6.5.
 973                 The Ant tool is available from the 
 974                 <a href="http://ant.apache.org" target="_blank">
 975                     Ant download site</a>.
 976                 You should always make sure <tt>ant</tt> is in your PATH, and
 977                 on Windows you may also need to set 
 978                 <tt><a href="#ANT_HOME">ANT_HOME</a></tt>
 979                 to point to the location of


1584                     The default value is "b00".
1585                 </dd>
1586                 <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
1587                 <dd>The <tt>ARCH_DATA_MODEL</tt> variable
1588                     is used to specify whether the build is to generate 32-bit or 64-bit
1589                     binaries. 
1590                     The Solaris build supports either 32-bit or 64-bit builds, but
1591                     Windows and Linux will support only one, depending on the specific
1592                     OS being used.
1593                     Normally, setting this variable is only necessary on Solaris.
1594                     Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries, 
1595                     or to <tt>64</tt> for generating 64-bit binaries.
1596                 </dd>
1597                 <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
1598                 <dd>
1599                     The location of the bootstrap JDK installation. 
1600                     See <a href="#bootjdk">Bootstrap JDK</a> for more information.
1601                     You should always install your own local Bootstrap JDK and
1602                     always set <tt>ALT_BOOTDIR</tt> explicitly.
1603                 </dd>
1604                 <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
1605                 <dd>
1606                     The location of the binary plugs installation.
1607                     See <a href="#binaryplugs">Binary Plugs</a> for more information.
1608                     You should always have a local copy of a
1609                     recent Binary Plugs install image
1610                     and set this variable to that location.
1611                 </dd>
1612                 <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
1613                 <dd>
1614                     The location of a previously built JDK installation. 
1615                     See <a href="#importjdk">Optional Import JDK</a> for more information.
1616                 </dd>
1617                 <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
1618                 <dd>
1619                     An override for specifying the (absolute) path of where the
1620                     build output is to go.
1621                     The default output directory will be build/<i>platform</i>.
1622                 </dd>
1623                 <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
1624                 <dd>
1625                     The location of the C/C++ compiler.
1626                     The default varies depending on the platform. 
1627                 </dd>
1628                 <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
1629                 <dd>
1630                     The location of the <a href="#cacerts">cacerts</a> file.
1631                     The default will refer to 


1688                 <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt>
1689                 <dd>
1690                     These are useful in managing builds on multiple platforms.
1691                     The default network location for all of the import JDK images
1692                     for all platforms. 
1693                     If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
1694                     is not set, this directory will be used and should contain 
1695                     the following directories:
1696                     <tt>solaris-sparc</tt>,
1697                     <tt>solaris-i586</tt>,
1698                     <tt>solaris-sparcv9</tt>,
1699                     <tt>solaris-amd64</tt>,
1700                     <tt>linux-i586</tt>,
1701                     <tt>linux-amd64</tt>,
1702                     <tt>windows-i586</tt>,
1703                     and
1704                     <tt>windows-amd64</tt>.
1705                     Where each of these directories contain the import JDK image
1706                     for that platform.
1707                 </dd>
1708                 <dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt>
1709                 <dd>
1710                     These are useful in managing builds on multiple platforms.
1711                     The default network location for all of the binary plug images
1712                     for all platforms. 
1713                     If <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
1714                     is not set, this directory will be used and should contain 
1715                     the following directories:
1716                     <tt>solaris-sparc</tt>,
1717                     <tt>solaris-i586</tt>,
1718                     <tt>solaris-sparcv9</tt>,
1719                     <tt>solaris-amd64</tt>,
1720                     <tt>linux-i586</tt>,
1721                     <tt>linux-amd64</tt>,
1722                     <tt>windows-i586</tt>,
1723                     and
1724                     <tt>windows-amd64</tt>.
1725                     Where each of these directories contain the binary plugs image
1726                     for that platform.
1727                 </dd>
1728                 <dt><strong>Windows specific:</strong></dt>
1729                 <dd>
1730                     <dl>
1731                         <dt><a name="ALT_WINDOWSSDKDIR"><tt>ALT_WINDOWSSDKDIR</tt></a> </dt>
1732                         <dd>
1733                             The location of the 
1734                             Microsoft Windows SDK where some tools will be
1735                             located.
1736                             The default is whatever WINDOWSSDKDIR is set to
1737                             (or WindowsSdkDir) or the path
1738                             <pre>
1739                             c:\Program Files\Microsoft SDKs\Windows\v6.1a
1740                             </pre>
1741                         </dd>
1742                         <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
1743                         <dd>
1744                             The location of the 
1745                             <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
1746                             The default will be to try and use the DirectX environment
1747                             variable <tt>DXSDK_DIR</tt>,




  47                     <ul>
  48                         <li><a href="#fedora">Fedora Linux</a> </li>
  49                         <li><a href="#centos">CentOS Linux</a> </li>
  50                         <li><a href="#debian">Debian GNU/Linux</a></li>
  51                         <li><a href="#ubuntu">Ubuntu Linux</a> </li>
  52                         <li><a href="#opensuse">OpenSUSE</a></li>
  53                         <li><a href="#mandriva">Mandriva</a></li>
  54                         <li><a href="#opensolaris">OpenSolaris</a></li>
  55                     </ul>
  56                 </li>
  57                 <li><a href="#directories">Source Directory Structure</a> </li>
  58                 <li><a href="#building">Build Information</a>
  59                     <ul>
  60                         <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
  61                         <li><a href="#linux">Basic Linux System Setup</a> </li>
  62                         <li><a href="#solaris">Basic Solaris System Setup</a> </li>
  63                         <li><a href="#windows">Basic Windows System Setup</a> </li>
  64                         <li><a href="#dependencies">Build Dependencies</a>
  65                             <ul>
  66                                 <li><a href="#bootjdk">Bootstrap JDK</a> </li>

  67                                 <li><a href="#importjdk">Optional Import JDK</a> </li>
  68                                 <li><a href="#ant">Ant</a> </li>
  69                                 <li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
  70                                 <li><a href="#compilers">Compilers</a>
  71                                     <ul>
  72                                         <li><a href="#msvc32">Microsoft Visual Studio Professional/Express for 32 bit</a> </li>
  73                                         <li><a href="#msvc64">Microsoft Visual Studio Professional for 64 bit</a> </li>
  74                                         <li><a href="#mssdk64">Microsoft Windows SDK for 64 bit</a> </li>
  75                                         <li><a href="#gcc">Linux gcc/binutils</a> </li>
  76                                         <li><a href="#studio">Sun Studio</a> </li>
  77                                     </ul>
  78                                 </li>
  79                                 <li><a href="#zip">Zip and Unzip</a> </li>
  80                                 <li><a href="#freetype">FreeType2 Fonts</a> </li>
  81                                 <li>Linux and Solaris:
  82                                     <ul>
  83                                         <li><a href="#cups">CUPS Include files</a> </li>
  84                                         <li><a href="#xrender">XRender Include files</a></li>
  85                                     </ul>
  86                                 </li>


 687                 Note that some Linux systems have a habit of pre-populating
 688                 your environment variables for you, for example <tt>JAVA_HOME</tt>
 689                 might get pre-defined for you to refer to the JDK installed on
 690                 your Linux system.
 691                 You will need to unset <tt>JAVA_HOME</tt>.
 692                 It's a good idea to run <tt>env</tt> and verify the
 693                 environment variables you are getting from the default system
 694                 settings make sense for building the
 695                 OpenJDK.
 696         </blockquote>
 697         <!-- ------------------------------------------------------ -->
 698         <h4><a name="linux_checklist">Basic Linux Check List</a></h4>
 699         <blockquote>
 700             <ol>
 701                 <li>
 702                     Install the
 703                     <a href="#bootjdk">Bootstrap JDK</a>, set
 704                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
 705                 </li>
 706                 <li>





 707                     <a href="#importjdk">Optional Import JDK</a>, set
 708                     <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
 709                 </li>
 710                 <li>
 711                     Install or upgrade the <a href="#freetype">FreeType development
 712                         package</a>.
 713                 </li>
 714                 <li>
 715                     Install
 716                     <a href="#ant">Ant</a>, 
 717                     make sure it is in your PATH.
 718                 </li>
 719             </ol>
 720         </blockquote>
 721         <!-- ------------------------------------------------------ -->
 722         <hr>
 723         <h3><a name="solaris">Basic Solaris System Setup</a></h3>
 724         <blockquote>
 725             The minimum recommended hardware for building the
 726             Solaris SPARC version is an UltraSPARC with 512 MB of RAM. 


 741                 and <tt>/usr/bin</tt> of a standard developer or full installation of
 742                 the Solaris operating environment.
 743             <p> 
 744                 Solaris patches specific to the JDK can be downloaded from the
 745                 <a href="http://sunsolve.sun.com/show.do?target=patches/JavaSE" target="_blank">
 746                     SunSolve JDK Solaris patches download page</a>.
 747                 You should ensure that the latest patch cluster for
 748                 your version of the Solaris operating environment has also
 749                 been installed.
 750         </blockquote>
 751         <!-- ------------------------------------------------------ -->
 752         <h4><a name="solaris_checklist">Basic Solaris Check List</a></h4>
 753         <blockquote>
 754             <ol>
 755                 <li>
 756                     Install the
 757                     <a href="#bootjdk">Bootstrap JDK</a>, set
 758                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
 759                 </li>
 760                 <li>





 761                     <a href="#importjdk">Optional Import JDK</a>, set
 762                     <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
 763                 </li>
 764                 <li>
 765                     Install the
 766                     <a href="#studio">Sun Studio Compilers</a>, set
 767                     <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
 768                 </li>
 769                 <li>
 770                     Install the
 771                     <a href="#cups">CUPS Include files</a>, set
 772                     <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
 773                 </li>
 774                 <li>
 775                     Install the <a href="#xrender">XRender Include files</a>.
 776                 </li>
 777                 <li>
 778                     Install
 779                     <a href="#ant">Ant</a>, 
 780                     make sure it is in your PATH.


 828                 With CYGWIN, it uses ":", but that means that paths like "C:/path"
 829                 cannot be placed in the CYGWIN version  of <tt>PATH</tt> and
 830                 instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
 831                 which CYGWIN understands, but only CYGWIN understands.
 832                 So be careful with paths on Windows.
 833         </blockquote>
 834         <!-- ------------------------------------------------------ -->
 835         <h4><a name="windows_checklist">Basic Windows Check List</a></h4>
 836         <blockquote>
 837             <ol>
 838                 <li>
 839                     Install the
 840                     <a href="#cygwin">CYGWIN product</a>. 
 841                 </li>
 842                 <li>
 843                     Install the 
 844                     <a href="#bootjdk">Bootstrap JDK</a>, set
 845                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
 846                 </li>
 847                 <li>





 848                     <a href="#importjdk">Optional Import JDK</a>, set
 849                     <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
 850                 </li>
 851                 <li>
 852                     Install the
 853                     <a href="#msvc32">Microsoft Visual Studio Compilers</a>).
 854                 </li>
 855                 <li>
 856                     Setup all environment variables for compilers 
 857                     (see <a href="#msvc32">compilers</a>).
 858                 </li>
 859                 <li>
 860                     Install 
 861                     <a href="#dxsdk">Microsoft DirectX SDK</a>.
 862                 </li>
 863                 <li>
 864                     Install
 865                     <a href="#ant">Ant</a>, 
 866                     make sure it is in your PATH and set
 867                     <tt><a href="#ANT_HOME">ANT_HOME</a></tt>.


 892                 For build performance reasons
 893                 is very important that this bootstrap JDK be made available on the
 894                 local disk of the machine doing the build.
 895                 You should always set 
 896                 <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
 897                 to point to the location of
 898                 the bootstrap JDK installation, this is the directory pathname
 899                 that contains a <tt>bin, lib, and include</tt>
 900                 It's also a good idea to also place its <tt>bin</tt> directory
 901                 in the <tt>PATH</tt> environment variable, although it's
 902                 not required.
 903                 <p>
 904                     <strong>Solaris:</strong>
 905                     Some pre-installed JDK images may be available to you in the
 906                     directory <tt>/usr/jdk/instances</tt>.
 907                     If you don't set
 908                     <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
 909                     the makefiles will look in that location for a JDK it can use.
 910             </blockquote>
 911             <!-- ------------------------------------------------------ -->
































 912             <h4><a name="importjdk">Optional Import JDK</a></h4>
 913             <blockquote>
 914                 The <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
 915                 setting is only needed if you are not building the entire
 916                 JDK. For example, if you have built the entire JDK once, and
 917                 wanted to avoid repeatedly building the Hotspot VM, you could
 918                 set this to the location of the previous JDK install image
 919                 and the build will copy the needed files from this import area.
 920             </blockquote>
 921             <!-- ------------------------------------------------------ -->
 922             <h4><a name="ant">Ant</a></h4>
 923             <blockquote>
 924                 All OpenJDK builds require access to least Ant 1.6.5.
 925                 The Ant tool is available from the 
 926                 <a href="http://ant.apache.org" target="_blank">
 927                     Ant download site</a>.
 928                 You should always make sure <tt>ant</tt> is in your PATH, and
 929                 on Windows you may also need to set 
 930                 <tt><a href="#ANT_HOME">ANT_HOME</a></tt>
 931                 to point to the location of


1536                     The default value is "b00".
1537                 </dd>
1538                 <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
1539                 <dd>The <tt>ARCH_DATA_MODEL</tt> variable
1540                     is used to specify whether the build is to generate 32-bit or 64-bit
1541                     binaries. 
1542                     The Solaris build supports either 32-bit or 64-bit builds, but
1543                     Windows and Linux will support only one, depending on the specific
1544                     OS being used.
1545                     Normally, setting this variable is only necessary on Solaris.
1546                     Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries, 
1547                     or to <tt>64</tt> for generating 64-bit binaries.
1548                 </dd>
1549                 <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
1550                 <dd>
1551                     The location of the bootstrap JDK installation. 
1552                     See <a href="#bootjdk">Bootstrap JDK</a> for more information.
1553                     You should always install your own local Bootstrap JDK and
1554                     always set <tt>ALT_BOOTDIR</tt> explicitly.
1555                 </dd>








1556                 <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
1557                 <dd>
1558                     The location of a previously built JDK installation. 
1559                     See <a href="#importjdk">Optional Import JDK</a> for more information.
1560                 </dd>
1561                 <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
1562                 <dd>
1563                     An override for specifying the (absolute) path of where the
1564                     build output is to go.
1565                     The default output directory will be build/<i>platform</i>.
1566                 </dd>
1567                 <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
1568                 <dd>
1569                     The location of the C/C++ compiler.
1570                     The default varies depending on the platform. 
1571                 </dd>
1572                 <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
1573                 <dd>
1574                     The location of the <a href="#cacerts">cacerts</a> file.
1575                     The default will refer to 


1632                 <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt>
1633                 <dd>
1634                     These are useful in managing builds on multiple platforms.
1635                     The default network location for all of the import JDK images
1636                     for all platforms. 
1637                     If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
1638                     is not set, this directory will be used and should contain 
1639                     the following directories:
1640                     <tt>solaris-sparc</tt>,
1641                     <tt>solaris-i586</tt>,
1642                     <tt>solaris-sparcv9</tt>,
1643                     <tt>solaris-amd64</tt>,
1644                     <tt>linux-i586</tt>,
1645                     <tt>linux-amd64</tt>,
1646                     <tt>windows-i586</tt>,
1647                     and
1648                     <tt>windows-amd64</tt>.
1649                     Where each of these directories contain the import JDK image
1650                     for that platform.
1651                 </dd>




















1652                 <dt><strong>Windows specific:</strong></dt>
1653                 <dd>
1654                     <dl>
1655                         <dt><a name="ALT_WINDOWSSDKDIR"><tt>ALT_WINDOWSSDKDIR</tt></a> </dt>
1656                         <dd>
1657                             The location of the 
1658                             Microsoft Windows SDK where some tools will be
1659                             located.
1660                             The default is whatever WINDOWSSDKDIR is set to
1661                             (or WindowsSdkDir) or the path
1662                             <pre>
1663                             c:\Program Files\Microsoft SDKs\Windows\v6.1a
1664                             </pre>
1665                         </dd>
1666                         <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
1667                         <dd>
1668                             The location of the 
1669                             <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
1670                             The default will be to try and use the DirectX environment
1671                             variable <tt>DXSDK_DIR</tt>,