source: chapter08/libtool.xml@ 0ebda11

ml-11.0 multilib
Last change on this file since 0ebda11 was 0ebda11, checked in by Thomas Trepl (Moody) <thomas@…>, 7 months ago

Remove entities for multilib pathes
Add usage of libc_cv_rtlddir

  • Property mode set to 100644
File size: 5.7 KB
Line 
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
8<sect1 id="ch-system-libtool" role="wrap">
9 <?dbhtml filename="libtool.html"?>
10
11 <sect1info condition="script">
12 <productname>libtool</productname>
13 <productnumber>&libtool-version;</productnumber>
14 <address>&libtool-url;</address>
15 </sect1info>
16
17 <title>Libtool-&libtool-version;</title>
18
19 <indexterm zone="ch-system-libtool">
20 <primary sortas="a-Libtool">Libtool</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Libtool package contains the GNU generic library support script.
27 It wraps the complexity of using shared libraries in a consistent, portable
28 interface.</para>
29
30 <segmentedlist>
31 <segtitle>&buildtime;</segtitle>
32 <segtitle>&diskspace;</segtitle>
33
34 <seglistitem>
35 <seg>&libtool-fin-sbu;</seg>
36 <seg>&libtool-fin-du;</seg>
37 </seglistitem>
38 </segmentedlist>
39
40 </sect2>
41
42 <sect2 role="installation">
43 <title>Installation of Libtool</title>
44
45 <para>Prepare Libtool for compilation:</para>
46
47<screen><userinput remap="configure">./configure --prefix=/usr</userinput></screen>
48
49 <para>Compile the package:</para>
50
51<screen><userinput remap="make">make</userinput></screen>
52
53<para>To test the results<!--(about 11.0 SBU)-->, issue:</para>
54
55<screen><userinput remap="test">make check</userinput></screen>
56
57 <note><para>The test time for libtool can be reduced significantly on a
58 system with multiple cores. To do this, append
59 <command>TESTSUITEFLAGS=-j&lt;N&gt;</command> to the line above. For
60 instance, using -j4 can reduce the test time by over 60
61 percent.</para></note>
62
63 <para>Five tests are known to fail in the LFS build environment due
64 to a circular dependency, but all tests pass if rechecked after
65 automake is installed.</para>
66
67 <para>Install the package:</para>
68
69<screen><userinput remap="install">make install</userinput></screen>
70
71 <!-- dev: - -disable-static works but causes additional test failures
72 so we manually remove the static library -->
73
74 <para>Remove an useless static library:</para>
75
76<screen><userinput remap="install">rm -fv /usr/lib/libltdl.a</userinput></screen>
77
78 </sect2>
79
80 <!-- - - - - - - - - - -->
81 <!-- Multilib - 32bit -->
82 <!-- - - - - - - - - - -->
83
84 <sect2 arch="ml_32,ml_all" role="installation">
85 <title>Installation of Libtool - 32bit</title>
86
87 <para>Clean previous build:</para>
88
89<screen><userinput remap="pre">make distclean</userinput></screen>
90
91 <para>Prepare Libtool for compilation:</para>
92
93<screen><userinput remap="configure">CC="gcc -m32" ./configure \
94 --prefix=/usr \
95 --libdir=/usr/lib32 \
96 --host=i686-pc-linux-gnu</userinput></screen>
97
98 <para>Compile the package:</para>
99
100<screen><userinput remap="make">make</userinput></screen>
101
102 <para>Install the package:</para>
103
104<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
105cp -Rv DESTDIR/usr/lib32/* /usr/lib32
106rm -rf DESTDIR</userinput></screen>
107
108 </sect2><!-- m32 -->
109
110 <!-- - - - - - - - - - -->
111 <!-- Multilib - x32bit -->
112 <!-- - - - - - - - - - -->
113
114 <sect2 arch="ml_x32,ml_all" role="installation">
115 <title>Installation of Libtool - x32bit</title>
116
117 <para>Clean previous build:</para>
118
119<screen><userinput remap="pre">make distclean</userinput></screen>
120
121 <para>Prepare Libtool for compilation:</para>
122
123<screen><userinput remap="configure">CC="gcc -mx32" ./configure \
124 --prefix=/usr \
125 --libdir=/usr/libx32 \
126 --host=x86_64-pc-linux-gnux32</userinput></screen>
127
128 <para>Compile the package:</para>
129
130<screen><userinput remap="make">make</userinput></screen>
131
132 <para>Install the package:</para>
133
134<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
135cp -Rv DESTDIR/usr/libx32/* /usr/libx32
136rm -rf DESTDIR</userinput></screen>
137
138 </sect2><!-- mx32 -->
139
140 <sect2 id="contents-libtool" role="content">
141 <title>Contents of Libtool</title>
142
143 <segmentedlist>
144 <segtitle>Installed programs</segtitle>
145 <segtitle>Installed libraries</segtitle>
146 <segtitle>Installed directories</segtitle>
147
148 <seglistitem>
149 <seg>libtool and libtoolize</seg>
150 <seg>libltdl.so</seg>
151 <seg>/usr/include/libltdl and /usr/share/libtool</seg>
152 </seglistitem>
153 </segmentedlist>
154
155 <variablelist>
156 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
157 <?dbfo list-presentation="list"?>
158 <?dbhtml list-presentation="table"?>
159
160 <varlistentry id="libtool">
161 <term><command>libtool</command></term>
162 <listitem>
163 <para>Provides generalized library-building support services</para>
164 <indexterm zone="ch-system-libtool libtool">
165 <primary sortas="b-libtool">libtool</primary>
166 </indexterm>
167 </listitem>
168 </varlistentry>
169
170 <varlistentry id="libtoolize">
171 <term><command>libtoolize</command></term>
172 <listitem>
173 <para>Provides a standard way to add <command>libtool</command>
174 support to a package</para>
175 <indexterm zone="ch-system-libtool libtoolize">
176 <primary sortas="b-libtoolize">libtoolize</primary>
177 </indexterm>
178 </listitem>
179 </varlistentry>
180
181 <varlistentry id="libltdl">
182 <term><filename class="libraryfile">libltdl</filename></term>
183 <listitem>
184 <para>Hides the various difficulties of dlopening libraries</para>
185 <indexterm zone="ch-system-libtool libltdl">
186 <primary sortas="c-libltdl">libltdl</primary>
187 </indexterm>
188 </listitem>
189 </varlistentry>
190
191 </variablelist>
192
193 </sect2>
194
195</sect1>
Note: See TracBrowser for help on using the repository browser.