| 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 |   %general-entities;
 | 
|---|
| 6 | ]>
 | 
|---|
| 7 | 
 | 
|---|
| 8 | <sect1 id="ch-system-perl" role="wrap">
 | 
|---|
| 9 |   <?dbhtml filename="perl-64bit.html"?>
 | 
|---|
| 10 | 
 | 
|---|
| 11 |   <title>Perl-&perl-version;</title>
 | 
|---|
| 12 | 
 | 
|---|
| 13 |   <indexterm zone="ch-system-perl">
 | 
|---|
| 14 |     <primary sortas="a-Perl">Perl</primary>
 | 
|---|
| 15 |   </indexterm>
 | 
|---|
| 16 | 
 | 
|---|
| 17 |   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 18 |   href="../common/perl.xml"
 | 
|---|
| 19 |   xpointer="xpointer(//*[@role='package'])"/>
 | 
|---|
| 20 | 
 | 
|---|
| 21 |   <sect2 role="installation">
 | 
|---|
| 22 |     <title>Installation of Perl</title>
 | 
|---|
| 23 | 
 | 
|---|
| 24 |     <para os="m1">In multilib builds we install compilers and libraries for each available
 | 
|---|
| 25 |     architecture.  The description below says that perl installs several hundred
 | 
|---|
| 26 |     libraries, but they are used by invoking <command>perl</command>, not by linking
 | 
|---|
| 27 |     to them with <command>ld</command>.  Although it is possible to install perl for
 | 
|---|
| 28 |     32 bits, move it to a different name, and then install the 64-bit version, it is
 | 
|---|
| 29 |     almost always invoked as just <command>perl</command>. That means only the
 | 
|---|
| 30 |     libraries and modules for the last version installed will be accessible. We
 | 
|---|
| 31 |     therefore only install one version.</para>
 | 
|---|
| 32 | 
 | 
|---|
| 33 |     <para os="p3">Perl does not, by default, know about library directories with names other
 | 
|---|
| 34 |     than lib, such as lib64.  The following patch will allow it to install to lib64.</para>
 | 
|---|
| 35 | 
 | 
|---|
| 36 | <screen os="p4"><userinput>patch -Np1 -i ../&perl-multilib-patch;</userinput></screen>
 | 
|---|
| 37 | 
 | 
|---|
| 38 |     <para os="p5">There is a further (possibly cosmetic) anomaly - if we install perl and
 | 
|---|
| 39 |     then run <command>perl -V</command> it will claim that libc is in /lib.  The
 | 
|---|
| 40 |     following patch fixes this, but only takes effect when <command>make install
 | 
|---|
| 41 |     </command> is run.</para>
 | 
|---|
| 42 | 
 | 
|---|
| 43 | <screen os="p6"><userinput>patch -Np1 -i ../&perl-lib64-patch;</userinput></screen>
 | 
|---|
| 44 | 
 | 
|---|
| 45 |     <para os="m2">We still need to tell perl to actually use lib64</para>
 | 
|---|
| 46 | 
 | 
|---|
| 47 | <screen os="m3"><userinput>echo 'installstyle="lib64/perl5"' >>hints/linux.sh</userinput></screen>
 | 
|---|
| 48 | 
 | 
|---|
| 49 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 50 |     href="../common/perl.xml"
 | 
|---|
| 51 |     xpointer="xpointer(//*[@os='a00'])"/>
 | 
|---|
| 52 | 
 | 
|---|
| 53 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 54 |     href="../common/perl.xml"
 | 
|---|
| 55 |     xpointer="xpointer(//*[@os='a01'])"/>
 | 
|---|
| 56 | 
 | 
|---|
| 57 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 58 |     href="../common/perl.xml"
 | 
|---|
| 59 |     xpointer="xpointer(//*[@os='a'])"/>
 | 
|---|
| 60 | 
 | 
|---|
| 61 | <screen os="b"><userinput>./configure.gnu --prefix=/usr -Dpager="/bin/less -isR" \
 | 
|---|
| 62 |    -Dlibpth="/usr/local/lib64 /lib64 /usr/lib64" \
 | 
|---|
| 63 |    -Dcc="gcc ${BUILD64}"</userinput></screen>
 | 
|---|
| 64 | 
 | 
|---|
| 65 |     <variablelist os="m4">
 | 
|---|
| 66 |       <title>The meaning of the new configure option:</title>
 | 
|---|
| 67 | 
 | 
|---|
| 68 |       <varlistentry>
 | 
|---|
| 69 |         <term><parameter>-Dlibpth="/usr/local/lib64 /lib64 /usr/lib64"</parameter></term>
 | 
|---|
| 70 |         <listitem>
 | 
|---|
| 71 |           <para>This tells Perl to link against the 64-bit libraries.</para>
 | 
|---|
| 72 |         </listitem>
 | 
|---|
| 73 |       </varlistentry>
 | 
|---|
| 74 | 
 | 
|---|
| 75 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 76 |     href="../common/perl.xml"
 | 
|---|
| 77 |     xpointer="xpointer(//*[@os='c1'])"/>
 | 
|---|
| 78 | 
 | 
|---|
| 79 |     </variablelist>
 | 
|---|
| 80 | 
 | 
|---|
| 81 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 82 |     href="../common/perl.xml"
 | 
|---|
| 83 |     xpointer="xpointer(//*[@os='d'])"/>
 | 
|---|
| 84 | 
 | 
|---|
| 85 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 86 |     href="../common/perl.xml"
 | 
|---|
| 87 |     xpointer="xpointer(//*[@os='e'])"/>
 | 
|---|
| 88 | 
 | 
|---|
| 89 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 90 |     href="../common/perl.xml"
 | 
|---|
| 91 |     xpointer="xpointer(//*[@os='h'])"/>
 | 
|---|
| 92 | 
 | 
|---|
| 93 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 94 |     href="../common/perl.xml"
 | 
|---|
| 95 |     xpointer="xpointer(//*[@os='j'])"/>
 | 
|---|
| 96 | 
 | 
|---|
| 97 |     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 98 |     href="../common/perl.xml"
 | 
|---|
| 99 |     xpointer="xpointer(//*[@os='k'])"/>
 | 
|---|
| 100 | 
 | 
|---|
| 101 |   </sect2>
 | 
|---|
| 102 | 
 | 
|---|
| 103 |   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
 | 
|---|
| 104 |   href="../common/perl.xml"
 | 
|---|
| 105 |   xpointer="xpointer(id('contents-perl'))"/>
 | 
|---|
| 106 | 
 | 
|---|
| 107 | </sect1>
 | 
|---|