source: BOOK/final-system/multilib/libtool.xml @ 464b09f

sysvinit
Last change on this file since 464b09f was b27081c4, checked in by Chris Staub <chris@…>, 7 years ago

Put one configure option per line

  • Property mode set to 100644
File size: 4.2 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-32" role="wrap">
9  <?dbhtml filename="libtool.html"?>
10
11  <title>Libtool-&libtool-version; 32 Bit Libraries</title>
12
13<!-- with the introduction of an LDEMULATION  on make check, to fix a test
14 failure which has appeared for unknown reasons, this text is now specific
15 to mips -o32. -->
16
17  <indexterm zone="ch-system-libtool-32">
18    <primary sortas="a-Libtool">Libtool</primary>
19    <secondary>32 Bit</secondary>
20  </indexterm>
21
22  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
23  href="../common/libtool.xml"
24  xpointer="xpointer(//*[@role='package'])"/>
25
26  <sect2 role="installation">
27    <title>Installation of Libtool</title>
28
29    <para os="a1">The following <filename>config.cache</filename> entry
30    overrides the default search path, which does not take
31    multilib into account:</para>
32
33<screen os="a2"><userinput>echo "lt_cv_sys_dlsearch_path='/lib /usr/lib /usr/local/lib /opt/lib'" &gt; config.cache</userinput></screen>
34
35    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
36    href="../common/libtool.xml"
37    xpointer="xpointer(//*[@os='a'])"/>
38
39<screen os="b"><userinput>CC="gcc ${BUILD32}" ./configure \
40    --prefix=/usr \
41    --cache-file=config.cache</userinput></screen>
42
43    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
44    href="../common/libtool.xml"
45    xpointer="xpointer(//*[@os='c'])"/>
46
47    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
48    href="../common/libtool.xml"
49    xpointer="xpointer(//*[@os='d'])"/>
50
51    <para os="e">To test the results, first identify whether you are on a big- or
52    little-endian machine.  SGI machines are usually big-endian, Cobalt are
53    usually little-endian.  If in doubt you can <command>echo ${MACHTYPE} | grep 'el-'
54    </command>- this will match a little-endian machine.</para>
55
56    <para os="e2">To test on a little-endian machine issue:
57    <userinput>make LDEMULATION=elf32ltsmip check</userinput>.</para>
58
59    <para os="e1">To test on a big-endian machine issue:
60    <userinput>make LDEMULATION=elf32btsmip check</userinput>.</para>
61
62    <variablelist os="c">
63      <title>The meaning of the override on make check:</title>
64
65      <varlistentry>
66        <term><parameter>LDEMULATION=[emulation]</parameter></term>
67        <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
68        href="../ppc64/libtool.xml"
69        xpointer="xpointer(//*[@os='c2'])"/> -->
70        <listitem os="c2">
71          <para>Libtool tends to do the wrong thing when building for multilib,
72          at least on the non-default size(s) of architecture.  The causes of
73          these errors are not well understood and they can appear, or disappear,
74          as a result of apparently innocuous other changes in the build.  In
75          this version of the book, one of the tests (pdemo-make) fails to link
76          because it tries to link the 32-bit objects against 64-bit system
77          libraries. This option enables the test to succeed without impacting
78          the other tests (compare the common alternative fixes of
79          <literal>LD="gcc ${BUILD32}"</literal> which causes far fewer tests
80          to be executed, and configuring with
81          <literal>LDFLAGS='-L/lib -L/usr/lib'</literal> which in this case
82          causes other tests to fail.)</para>
83        </listitem>
84      </varlistentry>
85
86    </variablelist>
87
88    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
89    href="../common/libtool.xml"
90    xpointer="xpointer(//*[@os='f'])"/>
91
92    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
93    href="../common/libtool.xml"
94    xpointer="xpointer(//*[@os='g'])"/>
95
96    <para os="m1">Prepare <filename>libtool</filename> to be wrapped by
97    the multiarch wrapper. Libtool by itself is not multilib aware:</para>
98
99<screen os="m2"><userinput>mv -v /usr/bin/libtool{,-32}</userinput></screen>
100
101  </sect2>
102
103  <sect2 role="content">
104    <title/>
105
106    <para>Details on this package are located in <xref
107    linkend="contents-libtool" role="."/></para>
108
109  </sect2>
110
111</sect1>
Note: See TracBrowser for help on using the repository browser.