[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[b06ca36] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[673b0d8] | 4 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
[6370fa6] | 7 |
|
---|
[bdea25ce] | 8 | <sect1 id="ch-system-libtool" role="wrap">
|
---|
| 9 | <?dbhtml filename="libtool.html"?>
|
---|
[5888299] | 10 |
|
---|
[e747759] | 11 | <sect1info condition="script">
|
---|
| 12 | <productname>libtool</productname>
|
---|
| 13 | <productnumber>&libtool-version;</productnumber>
|
---|
| 14 | <address>&libtool-url;</address>
|
---|
| 15 | </sect1info>
|
---|
| 16 |
|
---|
[bdea25ce] | 17 | <title>Libtool-&libtool-version;</title>
|
---|
[673b0d8] | 18 |
|
---|
[bdea25ce] | 19 | <indexterm zone="ch-system-libtool">
|
---|
| 20 | <primary sortas="a-Libtool">Libtool</primary>
|
---|
| 21 | </indexterm>
|
---|
[3554fa3a] | 22 |
|
---|
[bdea25ce] | 23 | <sect2 role="package">
|
---|
| 24 | <title/>
|
---|
[73aedd1d] | 25 |
|
---|
[bdea25ce] | 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>
|
---|
[73aedd1d] | 29 |
|
---|
[bdea25ce] | 30 | <segmentedlist>
|
---|
| 31 | <segtitle>&buildtime;</segtitle>
|
---|
| 32 | <segtitle>&diskspace;</segtitle>
|
---|
[73aedd1d] | 33 |
|
---|
[bdea25ce] | 34 | <seglistitem>
|
---|
[6dfcfecc] | 35 | <seg>&libtool-fin-sbu;</seg>
|
---|
| 36 | <seg>&libtool-fin-du;</seg>
|
---|
[bdea25ce] | 37 | </seglistitem>
|
---|
| 38 | </segmentedlist>
|
---|
[73aedd1d] | 39 |
|
---|
[bdea25ce] | 40 | </sect2>
|
---|
[73aedd1d] | 41 |
|
---|
[bdea25ce] | 42 | <sect2 role="installation">
|
---|
| 43 | <title>Installation of Libtool</title>
|
---|
[73aedd1d] | 44 |
|
---|
[bdea25ce] | 45 | <para>Prepare Libtool for compilation:</para>
|
---|
[6370fa6] | 46 |
|
---|
[0445a3d] | 47 | <screen><userinput remap="configure">./configure --prefix=/usr</userinput></screen>
|
---|
[5888299] | 48 |
|
---|
[bdea25ce] | 49 | <para>Compile the package:</para>
|
---|
[81fd230] | 50 |
|
---|
[0445a3d] | 51 | <screen><userinput remap="make">make</userinput></screen>
|
---|
[81fd230] | 52 |
|
---|
[b2c61c6] | 53 | <para>To test the results<!--(about 11.0 SBU)-->, issue:</para>
|
---|
[0445a3d] | 54 |
|
---|
[2844cde] | 55 | <screen><userinput remap="test">make -k check</userinput></screen>
|
---|
[81fd230] | 56 |
|
---|
[093f319] | 57 | <note><para>The test time for libtool can be reduced significantly on a
|
---|
[3b77546] | 58 | system with multiple cores. To do this, append
|
---|
| 59 | <command>TESTSUITEFLAGS=-j<N></command> to the line above. For
|
---|
| 60 | instance, using -j4 can reduce the test time by over 60
|
---|
| 61 | percent.</para></note>
|
---|
| 62 |
|
---|
[bfd117b] | 63 | <para>Five tests are known to fail in the LFS build environment due
|
---|
[2844cde] | 64 | to a circular dependency, but these tests pass if rechecked after
|
---|
| 65 | automake is installed. Additionally, with grep-3.8, two tests will
|
---|
| 66 | trigger a warning for non-POSIX regular expressions and fail.</para>
|
---|
[48a987b] | 67 |
|
---|
[bdea25ce] | 68 | <para>Install the package:</para>
|
---|
[81fd230] | 69 |
|
---|
[0445a3d] | 70 | <screen><userinput remap="install">make install</userinput></screen>
|
---|
[673b0d8] | 71 |
|
---|
[a5c2803] | 72 | <!-- dev: - -disable-static works but causes additional test failures
|
---|
| 73 | so we manually remove the static library -->
|
---|
| 74 |
|
---|
[c522873] | 75 | <para>Remove a useless static library:</para>
|
---|
[a5c2803] | 76 |
|
---|
| 77 | <screen><userinput remap="install">rm -fv /usr/lib/libltdl.a</userinput></screen>
|
---|
| 78 |
|
---|
[bdea25ce] | 79 | </sect2>
|
---|
| 80 |
|
---|
[6dfcfecc] | 81 | <!-- - - - - - - - - - -->
|
---|
| 82 | <!-- Multilib - 32bit -->
|
---|
| 83 | <!-- - - - - - - - - - -->
|
---|
[fd48baa] | 84 |
|
---|
| 85 | <sect2 arch="ml_32,ml_all" role="installation">
|
---|
[6dfcfecc] | 86 | <title>Installation of Libtool - 32bit</title>
|
---|
[b3f1ebb3] | 87 |
|
---|
| 88 | <para>Clean previous build:</para>
|
---|
| 89 |
|
---|
| 90 | <screen><userinput remap="pre">make distclean</userinput></screen>
|
---|
| 91 |
|
---|
| 92 | <para>Prepare Libtool for compilation:</para>
|
---|
| 93 |
|
---|
| 94 | <screen><userinput remap="configure">CC="gcc -m32" ./configure \
|
---|
[70aadfb] | 95 | --host=i686-pc-linux-gnu \
|
---|
| 96 | --prefix=/usr \
|
---|
| 97 | --libdir=/usr/lib32</userinput></screen>
|
---|
[b3f1ebb3] | 98 |
|
---|
| 99 | <para>Compile the package:</para>
|
---|
| 100 |
|
---|
| 101 | <screen><userinput remap="make">make</userinput></screen>
|
---|
| 102 |
|
---|
| 103 | <para>Install the package:</para>
|
---|
| 104 |
|
---|
[6dfcfecc] | 105 | <screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
|
---|
[0ebda11] | 106 | cp -Rv DESTDIR/usr/lib32/* /usr/lib32
|
---|
[b3f1ebb3] | 107 | rm -rf DESTDIR</userinput></screen>
|
---|
| 108 |
|
---|
[6dfcfecc] | 109 | </sect2><!-- m32 -->
|
---|
[b3f1ebb3] | 110 |
|
---|
[6dfcfecc] | 111 | <!-- - - - - - - - - - -->
|
---|
| 112 | <!-- Multilib - x32bit -->
|
---|
| 113 | <!-- - - - - - - - - - -->
|
---|
[fd48baa] | 114 |
|
---|
| 115 | <sect2 arch="ml_x32,ml_all" role="installation">
|
---|
[6dfcfecc] | 116 | <title>Installation of Libtool - x32bit</title>
|
---|
[b3f1ebb3] | 117 |
|
---|
| 118 | <para>Clean previous build:</para>
|
---|
| 119 |
|
---|
| 120 | <screen><userinput remap="pre">make distclean</userinput></screen>
|
---|
| 121 |
|
---|
| 122 | <para>Prepare Libtool for compilation:</para>
|
---|
| 123 |
|
---|
[0aaf6a31] | 124 | <screen><userinput remap="configure">CC="gcc -mx32" ./configure \
|
---|
[70aadfb] | 125 | --host=x86_64-pc-linux-gnux32 \
|
---|
| 126 | --prefix=/usr \
|
---|
| 127 | --libdir=/usr/libx32</userinput></screen>
|
---|
[b3f1ebb3] | 128 |
|
---|
| 129 | <para>Compile the package:</para>
|
---|
| 130 |
|
---|
| 131 | <screen><userinput remap="make">make</userinput></screen>
|
---|
| 132 |
|
---|
| 133 | <para>Install the package:</para>
|
---|
| 134 |
|
---|
[6dfcfecc] | 135 | <screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
|
---|
[0ebda11] | 136 | cp -Rv DESTDIR/usr/libx32/* /usr/libx32
|
---|
[b3f1ebb3] | 137 | rm -rf DESTDIR</userinput></screen>
|
---|
| 138 |
|
---|
[6dfcfecc] | 139 | </sect2><!-- mx32 -->
|
---|
[b3f1ebb3] | 140 |
|
---|
[bdea25ce] | 141 | <sect2 id="contents-libtool" role="content">
|
---|
| 142 | <title>Contents of Libtool</title>
|
---|
| 143 |
|
---|
| 144 | <segmentedlist>
|
---|
| 145 | <segtitle>Installed programs</segtitle>
|
---|
| 146 | <segtitle>Installed libraries</segtitle>
|
---|
[fe05b08] | 147 | <segtitle>Installed directories</segtitle>
|
---|
[bdea25ce] | 148 |
|
---|
| 149 | <seglistitem>
|
---|
| 150 | <seg>libtool and libtoolize</seg>
|
---|
[040ecb6] | 151 | <seg>libltdl.so</seg>
|
---|
[7bb9fda] | 152 | <seg>/usr/include/libltdl and /usr/share/libtool</seg>
|
---|
[bdea25ce] | 153 | </seglistitem>
|
---|
| 154 | </segmentedlist>
|
---|
| 155 |
|
---|
| 156 | <variablelist>
|
---|
| 157 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 158 | <?dbfo list-presentation="list"?>
|
---|
| 159 | <?dbhtml list-presentation="table"?>
|
---|
| 160 |
|
---|
| 161 | <varlistentry id="libtool">
|
---|
| 162 | <term><command>libtool</command></term>
|
---|
| 163 | <listitem>
|
---|
| 164 | <para>Provides generalized library-building support services</para>
|
---|
| 165 | <indexterm zone="ch-system-libtool libtool">
|
---|
| 166 | <primary sortas="b-libtool">libtool</primary>
|
---|
| 167 | </indexterm>
|
---|
| 168 | </listitem>
|
---|
| 169 | </varlistentry>
|
---|
| 170 |
|
---|
| 171 | <varlistentry id="libtoolize">
|
---|
| 172 | <term><command>libtoolize</command></term>
|
---|
| 173 | <listitem>
|
---|
| 174 | <para>Provides a standard way to add <command>libtool</command>
|
---|
| 175 | support to a package</para>
|
---|
| 176 | <indexterm zone="ch-system-libtool libtoolize">
|
---|
| 177 | <primary sortas="b-libtoolize">libtoolize</primary>
|
---|
| 178 | </indexterm>
|
---|
| 179 | </listitem>
|
---|
| 180 | </varlistentry>
|
---|
| 181 |
|
---|
| 182 | <varlistentry id="libltdl">
|
---|
| 183 | <term><filename class="libraryfile">libltdl</filename></term>
|
---|
| 184 | <listitem>
|
---|
| 185 | <para>Hides the various difficulties of dlopening libraries</para>
|
---|
| 186 | <indexterm zone="ch-system-libtool libltdl">
|
---|
| 187 | <primary sortas="c-libltdl">libltdl</primary>
|
---|
| 188 | </indexterm>
|
---|
| 189 | </listitem>
|
---|
| 190 | </varlistentry>
|
---|
| 191 |
|
---|
| 192 | </variablelist>
|
---|
| 193 |
|
---|
| 194 | </sect2>
|
---|
[673b0d8] | 195 |
|
---|
| 196 | </sect1>
|
---|