***************************
**                       **
**     simplebackup      **
**                       **
**   Perl Unix modules   **
**     (source code)     **
**                       **
**      readme.txt       **
**                       **
***************************

This directory contains perl modules required by simplebackup for some
operations and where downloaded from Perl Cpan (http://www.cpan.org/).

They are here to make the life of the person installing simplebackup
easier, this does not mean that simplebackup cannot use older or newer
versions of this modules. You are not required to use only this modules.

Notice 1: This modules should be compiled on a Unix System such has Linux,
          OpenBsd, Solaris, etc, do NOT !! attempt to use them on other
          systems such has Microsoft Windows.

Notice 2: You should only attempt to install them if you are 100% shore
          that your perl does not have them installed and if you are
          going to use them (e.g. no need to install the Expect module if
          you are not going to make secure ftp backups).

Notice 3: Many of this modules have extra requirements that are needed to be
          installed before installing them. This means for example that
          to install the HTTP::DAV module you need to have installed several
          extra software. This can complicate the installation of them
          quite a bit.
          For this reason it's recommended before using this modules to
          attempt to install the perl modules from your operating system
          package (CD'S/DVD's/Tape,etc) if possible or from perl cpan
          (across the internet) since those type of installations usually
          deal with all software dependencies automatically.

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ libnet-1.19 ] directory

   Contains the Libnet module that is required by simplebackup if you intend
   to do ftp backups ; email reporting or email backups ; or http web dav
   backups.
   Please notice that most perl distributions come with libnet pre-installed.

   Install with (from libnet-1.19/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ Authen-SASL-2.10 ] directory

   Contains the SASL Authentication module that is required by simplebackup
   if you intend to use email backups or email reporting and only if the smtp
   mail server used requires some authentication (smtp username/password).

   Install with

     perl Makefile.PL
     make
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ Expect-1.20 ] directory

   Contains the Perl Expect module that is required by simplebackup if you
   intend to do sftp backups (secure ftp ssh2 protocol) using the open ssh
   sftp program.

   Install with (from Expect-1.20/readme)

     perl Makefile.PL
     make
     make test
     make install

   This can also be directly installed from perl cpan across the internet
   using the unix command [ perl -MCPAN -e 'install Expect' ].
   This is the recommended method since it will download the most recent
   versions and install most requirements automatically.

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ IO-Tty-1.07 ] directory

   Contains the Perl IO-Tpy module that is required by the Perl Expect module
   (above).

   Install with (from IO-Tty-1.07/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/HTTP-DAV-0.31 ] directory

   Contains the Perl HTTP DAV module that is required by the Perl to support
   http web dav backups.

   Install with (from http-dav/HTTP-DAV-0.31/readme)

     perl Makefile.PL
     make
     make test
     make install

   This can also be directly installed from perl cpan across the internet
   using the unix command [ perl -MCPAN -e 'install HTTP::DAV' ].
   This is the recommended method since it will download the most recent
   versions and install most requirements automatically.

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/XML-DOM-1.44 ] directory

   Contains the Perl XML-DOM module that is required by the HTTP Dav module.

   Install with (from http-dav/XML-DOM-1.44/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/expat-2.0.0 ] directory

   Contains the C expat library for parsing XML (written by James Clark Perl)
   it's needed by XML-DOM module.

   For full install details check the (from expat-2.0.0\readme) file.

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/libxml-perl-0.08 ] directory

   Contains the Perl libxml module that is required by the XML-DOM module.

   Install with (from http-dav/libxml-perl-0.08/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/XML-Parser-2.34 ] directory

   Contains the Perl XML-Parser module that is required by the XML-DOM module.

   Install with (from http-dav/XML-Parser-2.34/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/XML-RegExp-0.03 ] directory

   Contains the Perl XML Regular Expressions module that is required by the
   XML-DOM module.

   Install with

     perl Makefile.PL
     make
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/libwww-perl-5.805 ] directory

   Contains the Perl Libwww module that are required by the HTTP DAV and
   XML-DOM modules.

   Install with (from http-dav/libwww-perl-5.805/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/Digest-MD5-2.36 ] directory

   Contains the Perl Digest-MD5 module that is required by the Libwww
   module.

   Install with

     perl Makefile.PL
     make
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/HTML-Parser-3.55 ] directory

   Contains the Perl HTML-Parser module that is required by the Libwww
   module.

   Install with (from http-dav/HTML-Parser-3.55/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/HTML-Tagset-3.10 ] directory

   Contains the Perl HTML-Tagset module that is required by the HTML-Parser
   module.

   Install with (from http-dav/HTML-Tagset-3.10/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/Compress-Zlib-2.001 ] directory

   Contains the Perl Compress-Zlib module that is required by the Libwww
   module.

   Install with (from http-dav/Compress-Zlib-2.001/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/Compress-Raw-Zlib-2.001 ] directory

   Contains the Perl Compress-Raw-Zlib module that is required by the
   Compress-Zlib module.

   Install with (from http-dav/Compress-Raw-Zlib-2.001/readme)

     perl Makefile.PL
     make
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/IO-Compress-Zlib-2.001 ] directory

   Contains the Perl IO-Compress-Zlib module that is required by the
   Compress-Zlib module.

   Install with (from http-dav/IO-Compress-Zlib/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/IO-Compress-Base-2.001 ] directory

   Contains the Perl IO-Compress-Base module that is required by the
   IO-Compress-Zlib module.

   Install with (from http-dav/IO-Compress-Base-2.001/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/MIME-Base64-3.07 ] directory

   Contains the Perl MIME-Base64 module that is required by the
   Libwww module.

   Install with (from http-dav/MIME-Base64-3.07/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/URI-1.35 ] directory

   Contains the Perl URI module that is required by the Libwww module.

   Install with (from http-dav/URI-1.35/readme)

     perl Makefile.PL
     make
     make test
     make install


# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/Crypt-SSLeay-0.51 ] directory

   Contains the Perl Crypt-SSLeay that is a optional requirement of the
   Libwww module. To install this you need to have the openssh and the
   openssh libraries installed.
   The Crypt-SSLeay provides https webdav support (encrypted http) to perl
   programs, future simplebackup versions might support this so you are
   suggested to install it.

   Install with (from http-dav/Crypt-SSLeay-0.51/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/IO-Socket-SSL-1.01 ] directory

   Contains the Perl IO-Socket-SSL that is a optional requirement of the
   Libwww module.
   The IO-Socket-SSL provides https webdav support (encrypted http) to perl
   programs, future simplebackup versions might support this so you are
   suggested to install it.

   Install with (from http-dav/IO-Socket-SSL-1.01/readme)

     perl Makefile.PL
     make
     make test
     make install

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

   The [ http-dav/Net_SSLeay.pm-1.30 ] directory

   Contains the Perl Net_SSLeay that is a requirement of the IO-Socket-SSL
   module. To install this you need to have the OpenSSL and the OpenSSL
   libraries installed.
   The Net_SSLeay provides https webdav support (encrypted http) to perl
   programs, future simplebackup versions might support this so you are
   suggested to install it.

   Install with (from http-dav/Net_SSLeay.pm-1.30/readme)

     perl Makefile.PL -t
     make install