chapter06/libtool.xml

   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-ch6-sbu;</seg>
  36         <seg>&libtool-ch6-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   </sect2>
  72
  73
  74   <sect2 id="contents-libtool" role="content">
  75     <title>Contents of Libtool</title>
  76
  77     <segmentedlist>
  78       <segtitle>Installed programs</segtitle>
  79       <segtitle>Installed libraries</segtitle>
  80       <segtitle>Installed directories</segtitle>
  81
  82       <seglistitem>
  83         <seg>libtool and libtoolize</seg>
  84         <seg>libltdl.so</seg>
  85         <seg>/usr/include/libltdl and /usr/share/libtool</seg>
  86       </seglistitem>
  87     </segmentedlist>
  88
  89     <variablelist>
  90       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  91       <?dbfo list-presentation="list"?>
  92       <?dbhtml list-presentation="table"?>
  93
  94       <varlistentry id="libtool">
  95         <term><command>libtool</command></term>
  96         <listitem>
  97           <para>Provides generalized library-building support services</para>
  98           <indexterm zone="ch-system-libtool libtool">
  99             <primary sortas="b-libtool">libtool</primary>
 100           </indexterm>
 101         </listitem>
 102       </varlistentry>
 103
 104       <varlistentry id="libtoolize">
 105         <term><command>libtoolize</command></term>
 106         <listitem>
 107           <para>Provides a standard way to add <command>libtool</command>
 108           support to a package</para>
 109           <indexterm zone="ch-system-libtool libtoolize">
 110             <primary sortas="b-libtoolize">libtoolize</primary>
 111           </indexterm>
 112         </listitem>
 113       </varlistentry>
 114
 115       <varlistentry id="libltdl">
 116         <term><filename class="libraryfile">libltdl</filename></term>
 117         <listitem>
 118           <para>Hides the various difficulties of dlopening libraries</para>
 119           <indexterm zone="ch-system-libtool libltdl">
 120             <primary sortas="c-libltdl">libltdl</primary>
 121           </indexterm>
 122         </listitem>
 123       </varlistentry>
 124
 125     </variablelist>
 126
 127   </sect2>
 128
 129 </sect1>