source: BOOK/cross-tools/common/binutils.xml@ f765af0

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since f765af0 was 7150133, checked in by Jim Gifford <clfs@…>, 16 years ago

Updated Binutils to 2.19.1

  • Property mode set to 100644
File size: 5.6 KB
RevLine 
[3f8be484]1<?xml version="1.0" encoding="ISO-8859-1"?>
[aa18ac0]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[3f8be484]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-cross-tools-binutils" role="wrap">
9 <?dbhtml filename="binutils.html"?>
10
11 <title>Cross Binutils-&binutils-version;</title>
12
13 <indexterm zone="ch-cross-tools-binutils">
14 <primary sortas="a-Binutils">Binutils</primary>
15 <secondary>cross tools</secondary>
16 </indexterm>
17
[cf66ceae]18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
19 href="../../final-system/common/binutils.xml"
20 xpointer="xpointer(//*[@role='package'])"/>
[3f8be484]21
22 <sect2 role="installation">
23 <title>Installation of Cross Binutils</title>
24
[292caee]25 <para os="da">It is important that Binutils be compiled before Glibc and
26 GCC because both Glibc and GCC perform various tests on the available
[eba8490]27 linker and assembler to determine which of their own features to
28 enable.</para>
29
[3f8be484]30 <para os="ba">To make sure that the proper syntax is used for a couple of
31 tools, apply the following patch:</para>
32
33<screen os="bb"><userinput>patch -Np1 -i ../&binutils-posix-patch;</userinput></screen>
34
[7150133]35<!--
[3f8be484]36 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
[1c836291]37 href="../../final-system/common/binutils.xml"
38 xpointer="xpointer(//*[@os='p1'])"/>
39
40 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
41 href="../../final-system/common/binutils.xml"
42 xpointer="xpointer(//*[@os='p2'])"/>
[7150133]43-->
[1c836291]44
45 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
[3f8be484]46 href="../../final-system/common/binutils.xml"
47 xpointer="xpointer(//*[@os='g'])"/>
48
49 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
50 href="../../final-system/common/binutils.xml"
51 xpointer="xpointer(//*[@os='h'])"/>
52
53 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
54 href="../../final-system/common/binutils.xml"
55 xpointer="xpointer(//*[@os='i'])"/>
56
[c1832da]57<screen os="bc"><userinput>AR=ar AS=as ../binutils-&binutils-version;/configure \
58 --prefix=/cross-tools --host=${CLFS_HOST} --target=${CLFS_TARGET} \
59 --with-sysroot=${CLFS} --with-lib-path=/tools/lib --disable-nls --enable-shared \
60 --enable-64-bit-bfd --disable-multilib</userinput></screen>
[3f8be484]61
62 <variablelist os="bd">
63 <title>The meaning of the configure options:</title>
64
65 <varlistentry os="bd1">
[bc2e3fa]66 <term><parameter>--prefix=/cross-tools</parameter></term>
[3f8be484]67 <listitem>
68 <para>This tells the configure script to prepare to install the
[bc2e3fa]69 package in the <filename class="directory">/cross-tools</filename>
[3f8be484]70 directory.</para>
71 </listitem>
72 </varlistentry>
73
74 <varlistentry os="bd2">
[bc2e3fa]75 <term><parameter>--host=${CLFS_HOST}</parameter></term>
[3f8be484]76 <listitem>
[bc2e3fa]77 <para>When used with --target, this creates a cross-architecture
78 executable that creates files for ${CLFS_TARGET} but runs on ${CLFS_HOST}.</para>
[3f8be484]79 </listitem>
80 </varlistentry>
81
82 <varlistentry os="bd3">
[bc2e3fa]83 <term><parameter>--target=${CLFS_TARGET}</parameter></term>
[3f8be484]84 <listitem>
[bc2e3fa]85 <para>When used with --host, this creates a cross-architecture
[3c06a53]86 executable that creates files for ${CLFS_TARGET} but runs on ${CLFS_HOST}.</para>
[3f8be484]87 </listitem>
88 </varlistentry>
89
90 <varlistentry os="bd4">
[bc2e3fa]91 <term><parameter>--with-lib-path=/tools/lib</parameter></term>
[3f8be484]92 <listitem>
[bc2e3fa]93 <para>This tells the configure script to specify the library
94 search path during the compilation of Binutils, resulting in
95 <filename class="directory">/tools/lib</filename> being passed
96 to the linker. This prevents the linker from searching through
97 library directories on the host.</para>
[3f8be484]98 </listitem>
99 </varlistentry>
100
101 <varlistentry os="bd5">
102 <term><parameter>--disable-nls</parameter></term>
103 <listitem>
104 <para>This disables internationalization as i18n is not needed for the
105 cross-compile tools.</para>
106 </listitem>
107 </varlistentry>
108
109 <varlistentry os="bd6">
110 <term><parameter>--enable-shared</parameter></term>
111 <listitem>
112 <para>Enable the creation of the shared libraries.</para>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry os="bd7">
[ed8de1a]117 <term><parameter>--disable-multilib</parameter></term>
118 <listitem>
[8659630]119 <para>This option disables the building of a multilib
[3d11ab9]120 capable Binutils.</para>
[3f8be484]121 </listitem>
122 </varlistentry>
123
124 </variablelist>
125
126 <para os="be">Compile the package:</para>
127
128<screen os="bf"><userinput>make configure-host
129make</userinput></screen>
130
[ed8de1a]131 <variablelist os="bg">
[3f8be484]132 <title>The meaning of the make options:</title>
133
[ed8de1a]134 <varlistentry os="bg1">
[3f8be484]135 <term><parameter>configure-host</parameter></term>
136 <listitem>
[ed8de1a]137 <para>This checks the host environment and makes sure all the
[0cdf4ac]138 necessary tools are available to compile Binutils.</para>
[3f8be484]139 </listitem>
140 </varlistentry>
141
142 </variablelist>
143
[ed8de1a]144 <para os="bh">Install the package:</para>
[3f8be484]145
[ed8de1a]146<screen os="bi"><userinput>make install</userinput></screen>
[3f8be484]147
[3d11ab9]148 <para os="bj">Copy <filename class="headerfile">libiberty.h</filename> to
[bc2e3fa]149 <filename class="directory">/tools/include</filename> directory:</para>
[3f8be484]150
[bc2e3fa]151<screen os="bk"><userinput>cp -v ../binutils-&binutils-version;/include/libiberty.h /tools/include</userinput></screen>
[3f8be484]152
153 </sect2>
154
155 <sect2 role="content">
156 <title/>
157
158 <para>Details on this package are located in <xref
159 linkend="contents-binutils" role="."/></para>
160
161 </sect2>
162
163</sect1>
Note: See TracBrowser for help on using the repository browser.