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

<?xml version="1.0" encoding="UTF-8"?>
<!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 "1e9cf40beaaafa502de8f3b560a9adee">

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

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

      <bridgehead renderas="sect5">Recommended</bridgehead>
      <para role="recommended">
        <xref linkend="perl-uri"/> (to access international domain names)
      </para>

    </sect3>

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

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

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

       <para>
         One test, <filename>Client non-SSL connection</filename>, is known to
         fail.
       </para>

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

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

    </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', which will allow you to script the build.
      </para>

    </sect3>

  </sect2>