binutils-pass2.xml 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  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-pass2" role="wrap">
  8. <?dbhtml filename="binutils-pass2.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 2</title>
  15. <indexterm zone="ch-tools-binutils-pass2">
  16. <primary sortas="a-Binutils">Binutils</primary>
  17. <secondary>tools, pass 2</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-ch5p2-sbu;</seg>
  29. <seg>&binutils-ch5p2-du;</seg>
  30. </seglistitem>
  31. </segmentedlist>
  32. </sect2>
  33. <sect2 role="installation">
  34. <title>Installation of Binutils</title>
  35. <para>Create a separate build directory again:</para>
  36. <screen><userinput remap="pre">mkdir -v ../binutils-build
  37. cd ../binutils-build</userinput></screen>
  38. <para>Prepare Binutils for compilation:</para>
  39. <screen><userinput remap="configure">CC=$LFS_TGT-gcc \
  40. AR=$LFS_TGT-ar \
  41. RANLIB=$LFS_TGT-ranlib \
  42. ../binutils-&binutils-version;/configure \
  43. --prefix=/tools \
  44. --disable-nls \
  45. --disable-werror \
  46. --with-lib-path=/tools/lib \
  47. --with-sysroot</userinput></screen>
  48. <variablelist>
  49. <title>The meaning of the new configure options:</title>
  50. <varlistentry>
  51. <term><parameter>CC=$LFS_TGT-gcc AR=$LFS_TGT-ar RANLIB=$LFS_TGT-ranlib</parameter></term>
  52. <listitem>
  53. <para>Because this is really a native build of Binutils, setting these
  54. variables ensures that the build system uses the cross-compiler and
  55. associated tools instead of the ones on the host system.</para>
  56. </listitem>
  57. </varlistentry>
  58. <varlistentry>
  59. <term><parameter>--with-lib-path=/tools/lib</parameter></term>
  60. <listitem>
  61. <para>This tells the configure script to specify the library
  62. search path during the compilation of Binutils, resulting in
  63. <filename class="directory">/tools/lib</filename> being passed
  64. to the linker. This prevents the linker from searching through
  65. library directories on the host.</para>
  66. </listitem>
  67. </varlistentry>
  68. <varlistentry>
  69. <term><parameter>--with-sysroot</parameter></term>
  70. <listitem>
  71. <para>The sysroot feature enables the linker to find shared objects
  72. which are required by other shared objects explicitly included on the
  73. linker's command line. Without this, some packages may not build
  74. successfully on some hosts.</para>
  75. </listitem>
  76. </varlistentry>
  77. </variablelist>
  78. <para>Compile the package:</para>
  79. <screen><userinput remap="make">make</userinput></screen>
  80. <para>Install the package:</para>
  81. <screen><userinput remap="install">make install</userinput></screen>
  82. <para>Now prepare the linker for the <quote>Re-adjusting</quote> phase in
  83. the next chapter:</para>
  84. <screen><userinput remap="adjust">make -C ld clean
  85. make -C ld LIB_PATH=/usr/lib:/lib
  86. cp -v ld/ld-new /tools/bin</userinput></screen>
  87. <variablelist>
  88. <title>The meaning of the make parameters:</title>
  89. <varlistentry>
  90. <term><parameter>-C ld clean</parameter></term>
  91. <listitem>
  92. <para>This tells the make program to remove all compiled
  93. files in the <filename class="directory">ld</filename>
  94. subdirectory.</para>
  95. </listitem>
  96. </varlistentry>
  97. <varlistentry>
  98. <term><parameter>-C ld LIB_PATH=/usr/lib:/lib</parameter></term>
  99. <listitem>
  100. <para>This option rebuilds everything in the <filename
  101. class="directory">ld</filename> subdirectory. Specifying the
  102. <envar>LIB_PATH</envar> Makefile variable on the command line
  103. allows us to override the default value of the temporary tools
  104. and point it to the proper final path. The value of this variable
  105. specifies the linker's default library search path. This
  106. preparation is used in the next chapter.</para>
  107. </listitem>
  108. </varlistentry>
  109. </variablelist>
  110. </sect2>
  111. <sect2 role="content">
  112. <title/>
  113. <para>Details on this package are located in
  114. <xref linkend="contents-binutils" role="."/></para>
  115. </sect2>
  116. </sect1>