source: cross-tools/common/binutils.xml@ e719005

Last change on this file since e719005 was cbfa0a3, checked in by Jim Gifford <clfs@…>, 19 years ago

r974@server (orig r972): jim | 2005-12-28 21:29:16 -0800

r1216@server: jim | 2005-12-28 21:26:31 -0800
Text Updates from Chris Staub. Thank you


  • Property mode set to 100644
File size: 5.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
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
18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
19 href="../../final-system/common/binutils.xml"
20 xpointer="xpointer(//*[@role='package'])"/>
21
22 <sect2 role="installation">
23 <title>Installation of Cross Binutils</title>
24
25 <para os="ba">To make sure that the proper syntax is used for a couple of
26 tools, apply the following patch:</para>
27
28<screen os="bb"><userinput>patch -Np1 -i ../&binutils-posix-patch;</userinput></screen>
29
30 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
31 href="../../final-system/common/binutils.xml"
32 xpointer="xpointer(//*[@os='g'])"/>
33
34 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
35 href="../../final-system/common/binutils.xml"
36 xpointer="xpointer(//*[@os='h'])"/>
37
38 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
39 href="../../final-system/common/binutils.xml"
40 xpointer="xpointer(//*[@os='i'])"/>
41
42<screen os="bc"><userinput>../binutils-&binutils-version;/configure --prefix=/cross-tools \
43 --host=${LFS_HOST} --target=${LFS_TARGET} --with-lib-path=/tools/lib \
44 --disable-nls --enable-shared --disable-multilib</userinput></screen>
45
46 <variablelist os="bd">
47 <title>The meaning of the configure options:</title>
48
49 <varlistentry os="bd1">
50 <term><parameter>--prefix=/cross-tools</parameter></term>
51 <listitem>
52 <para>This tells the configure script to prepare to install the
53 package in the <filename class="directory">/cross-tools</filename>
54 directory.</para>
55 </listitem>
56 </varlistentry>
57
58 <varlistentry os="bd2">
59 <term><parameter>--host=${LFS_HOST}</parameter></term>
60 <listitem>
61 <para>When used with --target, this creates a cross-architecture
62 executable that creates files for ${LFS_TARGET} but runs on ${LFS_HOST).</para>
63 </listitem>
64 </varlistentry>
65
66 <varlistentry os="bd3">
67 <term><parameter>--target=${LFS_TARGET}</parameter></term>
68 <listitem>
69 <para>When used with --host, this creates a cross-architecture
70 executable that creates files for ${LFS_TARGET} but runs on ${LFS_HOST).</para>
71 </listitem>
72 </varlistentry>
73
74 <varlistentry os="bd4">
75 <term><parameter>--with-lib-path=/tools/lib</parameter></term>
76 <listitem>
77 <para>This tells the configure script to specify the library
78 search path during the compilation of Binutils, resulting in
79 <filename class="directory">/tools/lib</filename> being passed
80 to the linker. This prevents the linker from searching through
81 library directories on the host.</para>
82 </listitem>
83 </varlistentry>
84
85 <varlistentry os="bd5">
86 <term><parameter>--disable-nls</parameter></term>
87 <listitem>
88 <para>This disables internationalization as i18n is not needed for the
89 cross-compile tools.</para>
90 </listitem>
91 </varlistentry>
92
93 <varlistentry os="bd6">
94 <term><parameter>--enable-shared</parameter></term>
95 <listitem>
96 <para>Enable the creation of the shared libraries.</para>
97 </listitem>
98 </varlistentry>
99
100 <varlistentry os="bd7">
101 <term><parameter>--disable-multilib</parameter></term>
102 <listitem>
103 <para>This option disables the building of a multilib
104 capable binutils.</para>
105 </listitem>
106 </varlistentry>
107
108 </variablelist>
109
110 <para os="be">Compile the package:</para>
111
112<screen os="bf"><userinput>make configure-host
113make</userinput></screen>
114
115 <variablelist os="bg">
116 <title>The meaning of the make options:</title>
117
118 <varlistentry os="bg1">
119 <term><parameter>configure-host</parameter></term>
120 <listitem>
121 <para>This checks the host environment and makes sure all the
122 necessary tools are available to compile binutils.</para>
123 </listitem>
124 </varlistentry>
125
126 </variablelist>
127
128 <para os="bh">Install the package:</para>
129
130<screen os="bi"><userinput>make install</userinput></screen>
131
132 <para os="bj">Copy the <filename class="headerfile">libiberty.h</filename> file to
133 <filename class="directory">/tools/include</filename> directory:</para>
134
135<screen os="bk"><userinput>cp ../binutils-&binutils-version;/include/libiberty.h /tools/include</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="content">
140 <title/>
141
142 <para>Details on this package are located in <xref
143 linkend="contents-binutils" role="."/></para>
144
145 </sect2>
146
147</sect1>
Note: See TracBrowser for help on using the repository browser.