1
0

binutils-pass1.xml 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  4. <!ENTITY % general-entities SYSTEM "../general.ent">
  5. %general-entities;
  6. ]>
  7. <sect1 id="ch-tools-binutils-pass1" role="wrap">
  8. <?dbhtml filename="binutils-pass1.html"?>
  9. <sect1info condition="script">
  10. <productname>binutils</productname>
  11. <productnumber>&binutils-version;</productnumber>
  12. <address>&binutils-url;</address>
  13. </sect1info>
  14. <title>Binutils-&binutils-version; - Pass 1</title>
  15. <indexterm zone="ch-tools-binutils-pass1">
  16. <primary sortas="a-Binutils">Binutils</primary>
  17. <secondary>tools, pass 1</secondary>
  18. </indexterm>
  19. <sect2 role="package">
  20. <title/>
  21. <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  22. href="../chapter06/binutils.xml"
  23. xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  24. <segmentedlist>
  25. <segtitle>&buildtime;</segtitle>
  26. <segtitle>&diskspace;</segtitle>
  27. <seglistitem>
  28. <seg>&binutils-ch5p1-sbu;</seg>
  29. <seg>&binutils-ch5p1-du;</seg>
  30. </seglistitem>
  31. </segmentedlist>
  32. </sect2>
  33. <sect2 role="installation">
  34. <title>Installation of Cross Binutils</title>
  35. <note><para>Go back and re-read the notes in the previous section.
  36. Understanding the notes labeled important will save you a lot
  37. of problems later.</para></note>
  38. <para>It is important that Binutils be the first package compiled
  39. because both Glibc and GCC perform various tests on the available
  40. linker and assembler to determine which of their own features to
  41. enable.</para>
  42. <para>Apply a patch to prevent a build failure when using compiler optimizations:</para>
  43. <screen><userinput remap="pre">patch -Np1 -i ../&binutils-build-patch;</userinput></screen>
  44. <para>The Binutils documentation recommends building Binutils outside of the
  45. source directory in a dedicated build directory:</para>
  46. <screen><userinput remap="pre">mkdir -v ../binutils-build
  47. cd ../binutils-build</userinput></screen>
  48. <note>
  49. <para>In order for the SBU values listed in the rest of the book
  50. to be of any use, measure the time it takes to build this package from
  51. the configuration, up to and including the first install. To achieve
  52. this easily, wrap the three commands in a <command>time</command>
  53. command like this: <userinput>time { ./configure ... &amp;&amp; make
  54. &amp;&amp; make install; }</userinput>.</para>
  55. </note>
  56. <note><para>The approximate build SBU values and required disk space
  57. in Chapter 5 does not include test suite data.</para></note>
  58. <para>Now prepare Binutils for compilation:</para>
  59. <screen><userinput remap="configure">../binutils-&binutils-version;/configure \
  60. --prefix=/tools \
  61. --with-sysroot=$LFS \
  62. --with-lib-path=/tools/lib \
  63. --target=$LFS_TGT \
  64. --disable-nls \
  65. --disable-werror</userinput></screen>
  66. <variablelist>
  67. <title>The meaning of the configure options:</title>
  68. <varlistentry>
  69. <term><parameter>--prefix=/tools</parameter></term>
  70. <listitem>
  71. <para>This tells the configure script to prepare to install the
  72. Binutils programs in the <filename class="directory">/tools</filename>
  73. directory.</para>
  74. </listitem>
  75. </varlistentry>
  76. <varlistentry>
  77. <term><parameter>--with-sysroot=$LFS</parameter></term>
  78. <listitem>
  79. <para>For cross compilation, this tells the build system to look in
  80. $LFS for the target system libraries as needed.</para>
  81. </listitem>
  82. </varlistentry>
  83. <varlistentry>
  84. <term><parameter>--with-lib-path=/tools/lib</parameter></term>
  85. <listitem>
  86. <para>This specifies which library path the linker should be
  87. configured to use.</para>
  88. </listitem>
  89. </varlistentry>
  90. <varlistentry>
  91. <term><envar>--target=$LFS_TGT</envar></term>
  92. <listitem>
  93. <para>Because the machine description in the <envar>LFS_TGT</envar>
  94. variable is slightly different than the value returned by the
  95. <command>config.guess</command> script, this switch will tell the
  96. <command>configure</command> script to adjust Binutil's build system
  97. for building a cross linker. </para>
  98. </listitem>
  99. </varlistentry>
  100. <varlistentry>
  101. <term><parameter>--disable-nls</parameter></term>
  102. <listitem>
  103. <para>This disables internationalization as i18n is not needed for the
  104. temporary tools.</para>
  105. </listitem>
  106. </varlistentry>
  107. <varlistentry>
  108. <term><parameter>--disable-werror</parameter></term>
  109. <listitem>
  110. <para>This prevents the build from stopping in the event that there
  111. are warnings from the host's compiler.</para>
  112. </listitem>
  113. </varlistentry>
  114. </variablelist>
  115. <para>Continue with compiling the package:</para>
  116. <screen><userinput remap="make">make</userinput></screen>
  117. <para>Compilation is now complete. Ordinarily we would now run the
  118. test suite, but at this early stage the test suite framework (Tcl,
  119. Expect, and DejaGNU) is not yet in place. The benefits of running the
  120. tests at this point are minimal since the programs from this
  121. first pass will soon be replaced by those from the second.</para>
  122. <para>If building on x86_64, create a symlink to ensure the sanity of
  123. the toolchain:</para>
  124. <screen><userinput remap="install">case $(uname -m) in
  125. x86_64) mkdir -v /tools/lib &amp;&amp; ln -sv lib /tools/lib64 ;;
  126. esac</userinput></screen>
  127. <para>Install the package:</para>
  128. <screen><userinput remap="install">make install</userinput></screen>
  129. </sect2>
  130. <sect2 role="content">
  131. <title/>
  132. <para>Details on this package are located in
  133. <xref linkend="contents-binutils" role="."/></para>
  134. </sect2>
  135. </sect1>