source: BOOK/final-system/multilib/perl-64bit.xml@ de4db44

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-perl" role="wrap">
  <?dbhtml filename="perl-64bit.html"?>

  <title>Perl-&perl-version;</title>

  <indexterm zone="ch-system-perl">
    <primary sortas="a-Perl">Perl</primary>
  </indexterm>

  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
  href="../common/perl.xml"
  xpointer="xpointer(//*[@role='package'])"/>

  <sect2 role="installation">
    <title>Installation of Perl</title>

    <para os="m1">In multilib builds we install compilers and libraries for each available
    architecture.  The description below says that perl installs several hundred
    libraries, but they are used by invoking <command>perl</command>, not by linking
    to them with <command>ld</command>.  Although it is possible to install perl for
    32 bits, move it to a different name, and then install the 64-bit version, it is
    almost always invoked as just <command>perl</command>. That means only the
    libraries and modules for the last version installed will be accessible. We
    therefore only install one version.</para>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='p1'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='p2'])"/>

    <para os="p3">Perl does not, by default, know about library directories with names other
    than lib, such as lib64.  The following patch will allow it to install to lib64.</para>

<screen os="p4"><userinput>patch -Np1 -i ../&perl-multilib-patch;</userinput></screen>

    <para os="p5">There is a further (possibly cosmetic) anomaly - if we install perl and
    then run <command>perl -V</command> it will claim that libc is in /lib.  The
    following patch fixes this, but only takes effect when <command>make install
    </command> is run.</para>

<screen os="p6"><userinput>patch -Np1 -i ../&perl-lib64-patch;</userinput></screen>

    <para os="m2">We still need to tell perl to actually use lib64</para>

<screen os="m3"><userinput>echo 'installstyle="lib64/perl5"' >>hints/linux.sh</userinput></screen>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='a00'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='a01'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='a'])"/>

<screen os="b"><userinput>./configure.gnu --prefix=/usr -Dpager="/bin/less -isR" \
   -Dlibpth="/usr/local/lib64 /lib64 /usr/lib64" \
   -Dcc="gcc ${BUILD64}"</userinput></screen>

    <variablelist os="m4">
      <title>The meaning of the new configure option:</title>

      <varlistentry>
        <term><parameter>-Dlibpth="/usr/local/lib64 /lib64 /usr/lib64"</parameter></term>
        <listitem>
          <para>This tells Perl to link against the 64-bit libraries.</para>
        </listitem>
      </varlistentry>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='c1'])"/>

    </variablelist>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='d'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='e'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='h'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='i'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='j'])"/>

    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    href="../common/perl.xml"
    xpointer="xpointer(//*[@os='k'])"/>

  </sect2>

  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
  href="../common/perl.xml"
  xpointer="xpointer(id('contents-perl'))"/>

</sect1>