Tagging 1.99.1
[linux_from_scratch.git] / BOOK / chapter06 / binutils.xml
blob92c02a803f825c5bf90a969e469e1bacd5aee58e
1 <sect1 id="ch-system-binutils" xreflabel="Binutils">
2 <title>Installing Binutils-&binutils-version;</title>
3 <?dbhtml filename="binutils.html" dir="chapter06"?>
5 <para>The Binutils package contains a linker, an assembler, and other tools for
6 handling object files.</para>
8 <screen>&buildtime; &binutils-time;
9 &diskspace; &binutils-compsize;</screen>
11 &aa-binutils-down;
12 &aa-binutils-dep;
14 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
16 <sect2><title>Installation of Binutils</title>
18 <para>Now is an appropriate time to verify that your pseudo terminals (PTYs) are
19 working properly inside the chroot environment. We will again quickly check that
20 everything is set up correctly by performing a simple test:</para>
22 <screen><userinput>expect -c "spawn ls"</userinput></screen>
24 <para>If you receive the message:</para>
26 <blockquote><screen>The system has no more ptys.  Ask your system administrator to create more.</screen></blockquote>
28 <para>Your chroot environment is not set up for proper PTY operation. In this
29 case there is no point in running the test suites for Binutils and GCC until you
30 are able to resolve the issue. Please refer back to <xref linkend="ch-system-proc"/>
31 and the <xref linkend="ch-system-MAKEDEV"/> section and perform the recommended steps
32 to fix the problem.</para>
34 <para>This package is known to behave badly when you have changed its
35 default optimization flags (including the -march and -mcpu options).
36 Therefore, if you have defined any environment variables that override
37 default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting
38 or modifying them when building Binutils.</para>
40 <para>The Binutils documentation recommends building Binutils outside of the
41 source directory in a dedicated build directory:</para>
43 <screen><userinput>mkdir ../binutils-build
44 cd ../binutils-build</userinput></screen>
46 <para>Now prepare Binutils for compilation:</para>
48 <screen><userinput>../&binutils-dir;/configure --prefix=/usr --enable-shared</userinput></screen>
50 <para>Compile the package:</para>
52 <screen><userinput>make tooldir=/usr</userinput></screen>
54 <para>Normally, the <emphasis>tooldir</emphasis> (the directory where the
55 executables end up) is set to $(exec_prefix)/$(target_alias), which expands
56 into, for example, <filename>/usr/i686-pc-linux-gnu</filename>. Since we only
57 build for our own system, we don't need this target specific directory in
58 <filename>/usr</filename>. That setup would be used if the system was used to
59 cross-compile (for example compiling a package on an Intel machine that
60 generates code that can be executed on PowerPC machines).</para>
62 <important><para>The test suite for Binutils in this section is considered
63 <emphasis>critical</emphasis>. Our advice is to not skip it under any
64 circumstances.</para></important>
66 <para>Test the results:</para>
68 <screen><userinput>make check</userinput></screen>
70 <para>The test suite notes from <xref linkend="ch-tools-binutils-pass2"/> are still
71 very much appropriate here. Be sure to refer back there should you have any
72 doubts.</para>
74 <para>Install the package:</para>
76 <screen><userinput>make tooldir=/usr install</userinput></screen>
78 <para>Install the <emphasis>libiberty</emphasis> header file that is needed by
79 some packages:</para>
81 <screen><userinput>cp ../&binutils-dir;/include/libiberty.h /usr/include</userinput></screen>
83 </sect2>
85 &aa-binutils-shortdesc;
86 &aa-binutils-desc;
88 </sect1>