glfs/general/prog/perl-deps/perl-net-ssleay.xml

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

  <!ENTITY my-download-http "&metacpan_authors;/M/MI/MIKEM/Net-SSLeay-&Net-SSLeay-version;.tar.gz">
  <!ENTITY my-md5sum "d602bdce4e0531c6efc276e3e429ca69">

]>

  <!-- Begin Net::SSLeay -->
  <sect2 id="perl-net-ssleay" xreflabel="Net-SSLeay-&Net-SSLeay-version;">

    <title>Net::SSLeay-&Net-SSLeay-version;</title>

    <indexterm zone="perl-net-ssleay">
      <primary sortas="a-Net-SSLeay">Net::SSLeay</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Net::SSLeay</title>

      <para>
        Net::SSLeay is a PERL extension for using OpenSSL.
      </para>

      <bridgehead renderas="sect4">Additional Download</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Required patch (for openssl-1.1.1):
            <ulink url="&patch-root;/Net-SSLeay-&Net-SSLeay-version;-openssl_1.1.1-1.patch"/>
          </para>
        </listitem>
      </itemizedlist>

      &lfs84_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&my-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &my-md5sum;
          </para>
        </listitem>
      </itemizedlist>

    </sect3>

    <sect3 role="installation">
      <title>Installation of Net::SSLeay</title>

      <para>
        <emphasis>Unless</emphasis> you are still using the 1.1.0 series,
        apply a patch to allow the tests to complete with
        <application>openssl-1.1.1</application>.
      </para>

<screen><userinput>patch -Np1 -i ../Net-SSLeay-&Net-SSLeay-version;-openssl_1.1.1-1.patch</userinput></screen>

      <para>
        This module uses a variant of the standard build and installation
        instructions:

<screen><userinput>yes '' | perl Makefile.PL &amp;&amp;
make             &amp;&amp;
make test</userinput></screen>

        Now, as the <systemitem class="username">root</systemitem> user:

<screen role="root"><userinput>make install</userinput></screen>

      </para>

    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <command>yes ''</command>: Perl will ask if you wish to run external
        tests, which will fail if you do not have network connectivity. The
        default is 'n', specifying this allows you to script the build.
      </para>

    </sect3>

  </sect2>