source: general/prog/perl-deps/perl-net-ssleay.xml@ 42961885

<?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"> author will probably change for next release -->
  <!ENTITY my-download-http "https://github.com/rurban/Net-SSLeay/archive/&Net-SSLeay-version;/Net-SSLeay-&Net-SSLeay-version;.tar.gz">
  <!ENTITY my-md5sum "888b770e65f894f394ff253d0d42cd5a">

]>

  <!-- 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>

      <note>
        <para>
          This is a development version which is required to work properly with
          <xref linkend="perl-io-socket-ssl"/>
        </para>
<!--
        <para>
          The source tarball shown above downloads with the correct name if using
          a browser such as Firefox. If you prefer to use a command line program
          such as wget, you normally would obtain &Net-SSLeay-version;.tar.gz
          To obtain this package with the proper filename, run:

<screen><userinput>wget -c https://github.com/rurban/Net-SSLeay/archive/&Net-SSLeay-version;.tar.gz \
     -O Net-SSLeay-&Net-SSLeay-version;.tar.gz</userinput></screen>.
        </para>i-->
      </note>

    </sect3>

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

      <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>