source: general/prog/perl-modules/perl-io-socket-ssl.xml@ f09a697

<?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 "&perl_authors;/id/S/SU/SULLR/IO-Socket-SSL-&IO-Socket-SSL-version;.tar.gz">
  <!ENTITY my-md5sum "97fa6cd64f15db60f810cd8ab02d57fc">

  <!ENTITY IO-Socket-SSL-download-http "&perl_authors;/id/S/SU/SULLR/IO-Socket-SSL-&IO-Socket-SSL-version;.tar.gz">
]>

  <!-- Begin IO::Socket::SSL -->
  <sect2 id="perl-io-socket-ssl" xreflabel="IO-Socket-SSL-&IO-Socket-SSL-version;">

    <title>IO::Socket::SSL-&IO-Socket-SSL-version;</title>

    <indexterm zone="perl-io-socket-ssl">
      <primary sortas="a-IO-Socket-SSL">IO::Socket::SSL</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to IO::Socket::SSL</title>

      <para>
        IO::Socket::SSL makes using SSL/TLS much easier by wrapping the necessary
        functionality into the familiar IO::Socket interface and providing secure
        defaults whenever possible.
      </para>

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

      <bridgehead renderas="sect4">IO::Socket::SSL Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="make-ca"/> and
        <xref linkend="perl-net-ssleay"/>
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of IO::Socket::SSL</title>

      <note>
        <para>
          The tests hang if you are using openssl-1.1.1.
          Therefore, running them is at the moment not recommended.     
          If you are using the cpan method of installation, use the -T 
          option to avoid running the tests.
        </para>
      </note>

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

<screen><userinput>yes | perl Makefile.PL &amp;&amp;
make</userinput></screen>
<!--
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 soft' if there are network problems. The
        default is 'y', this allows you to script the build.
      </para>

    </sect3>

  </sect2>