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

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 929aaed was 3f8be484, checked in by Jim Gifford <clfs@…>, 19 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 5.3 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 <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6 %general-entities;
7 %patches-entities;
8]>
9
10<sect1 id="ch-cross-tools-binutils" role="wrap">
11 <?dbhtml filename="binutils.html"?>
12
13 <title>Cross Binutils-&binutils-version;</title>
14
15 <indexterm zone="ch-cross-tools-binutils">
16 <primary sortas="a-Binutils">Binutils</primary>
17 <secondary>cross tools</secondary>
18 </indexterm>
19
20 <sect2 role="package">
21 <title/>
22
23 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
24 href="../../final-system/common/binutils.xml"
25 xpointer="xpointer(//*[@role='package']/para[1])"/>
26
27 <segmentedlist>
28 <segtitle>&buildtime;</segtitle>
29 <segtitle>&diskspace;</segtitle>
30
31 <seglistitem>
32 <seg>Not checked yet</seg>
33 <seg>Not checked yet</seg>
34 </seglistitem>
35 </segmentedlist>
36
37 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
38 href="../../final-system/common/binutils.xml"
39 xpointer="xpointer(//*[@role='package']/segmentedlist[2])"/>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Cross Binutils</title>
45
46 <para os="ba">To make sure that the proper syntax is used for a couple of
47 tools, apply the following patch:</para>
48
49<screen os="bb"><userinput>patch -Np1 -i ../&binutils-posix-patch;</userinput></screen>
50
51 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
52 href="../../final-system/common/binutils.xml"
53 xpointer="xpointer(//*[@os='g'])"/>
54
55 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
56 href="../../final-system/common/binutils.xml"
57 xpointer="xpointer(//*[@os='h'])"/>
58
59 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
60 href="../../final-system/common/binutils.xml"
61 xpointer="xpointer(//*[@os='i'])"/>
62
63<screen os="bc"><userinput>../binutils-&binutils-version;/configure --prefix=/cross-tools \
64 --host=${LFS_HOST} --target=${LFS_TARGET} --with-lib-path=/tools/lib \
65 --disable-nls --enable-shared --enable-64-bit-bfd</userinput></screen>
66
67 <variablelist os="bd">
68 <title>The meaning of the configure options:</title>
69
70 <varlistentry os="bd1">
71 <term><parameter>--prefix=/cross-tools</parameter></term>
72 <listitem>
73 <para>This tells the configure script to prepare to install the
74 package in the <filename class="directory">/cross-tools</filename>
75 directory.</para>
76 </listitem>
77 </varlistentry>
78
79 <varlistentry os="bd2">
80 <term><parameter>--host=${LFS_HOST}</parameter></term>
81 <listitem>
82 <para>This do ...</para>
83 </listitem>
84 </varlistentry>
85
86 <varlistentry os="bd3">
87 <term><parameter>--target=${LFS_TARGET}</parameter></term>
88 <listitem>
89 <para>This do ...</para>
90 </listitem>
91 </varlistentry>
92
93 <varlistentry os="bd4">
94 <term><parameter>--with-lib-path=/tools/lib</parameter></term>
95 <listitem>
96 <para>This tells the configure script to specify the library
97 search path during the compilation of Binutils, resulting in
98 <filename class="directory">/tools/lib</filename> being passed
99 to the linker. This prevents the linker from searching through
100 library directories on the host.</para>
101 </listitem>
102 </varlistentry>
103
104 <varlistentry os="bd5">
105 <term><parameter>--disable-nls</parameter></term>
106 <listitem>
107 <para>This disables internationalization as i18n is not needed for the
108 cross-compile tools.</para>
109 </listitem>
110 </varlistentry>
111
112 <varlistentry os="bd6">
113 <term><parameter>--enable-shared</parameter></term>
114 <listitem>
115 <para>Enable the creation of the shared libraries.</para>
116 </listitem>
117 </varlistentry>
118
119 <varlistentry os="bd7">
120 <term><parameter>--enable-64-bit-bfd</parameter></term>
121 <listitem>
122 <para>This adds 64 bit support to our toolchain.</para>
123 </listitem>
124 </varlistentry>
125
126 </variablelist>
127
128 <para os="be">Compile the package:</para>
129
130<screen os="bf"><userinput>make configure-host
131make headers -C bfd
132make</userinput></screen>
133
134 <variablelist os="bf1">
135 <title>The meaning of the make options:</title>
136
137 <varlistentry>
138 <term><parameter>configure-host</parameter></term>
139 <listitem>
140 <para>This do ...</para>
141 </listitem>
142 </varlistentry>
143
144 <varlistentry>
145 <term><parameter>headers -C bfd</parameter></term>
146 <listitem>
147 <para>This do ...</para>
148 </listitem>
149 </varlistentry>
150
151 </variablelist>
152
153 <para os="bg">Install the package:</para>
154
155<screen os="bh"><userinput>make install</userinput></screen>
156
157 <para os="bi">Copy <filename class="headerfile">libiberty.h</filename> file to
158 <filename class="directory">/tools/include</filename> directory:</para>
159
160<screen os="bj"><userinput>cp ../binutils-&binutils-version;/include/libiberty.h /tools/include</userinput></screen>
161
162 </sect2>
163
164 <sect2 role="content">
165 <title/>
166
167 <para>Details on this package are located in <xref
168 linkend="contents-binutils" role="."/></para>
169
170 </sect2>
171
172</sect1>
Note: See TracBrowser for help on using the repository browser.