Add ARM files
[dh-make-perl] / dev / arm / libwww-perl / libwww-perl-5.813 / debian / libwww-perl / usr / share / doc / libwww-perl / README.SSL
diff --git a/dev/arm/libwww-perl/libwww-perl-5.813/debian/libwww-perl/usr/share/doc/libwww-perl/README.SSL b/dev/arm/libwww-perl/libwww-perl-5.813/debian/libwww-perl/usr/share/doc/libwww-perl/README.SSL
new file mode 100644 (file)
index 0000000..66a7b65
--- /dev/null
@@ -0,0 +1,24 @@
+SSL SUPPORT
+-----------
+
+The libwww-perl package has support for using SSL/TLSv1 with its HTTP
+client and server classes. This support makes it possible to access
+https schemed URLs with LWP. Because of the problematic status of
+encryption software in general and certain encryption algorithms in
+particular, in several countries, libwww-perl package doesn't include
+SSL functionality out-of-the-box.
+
+Encryption support is obtained through the use of Crypt::SSLeay or
+IO::Socket::SSL, which can both be found from CPAN. While libwww-perl
+has "plug-and-play" support for both of these modules (as of v5.45),
+the recommended module to use is Crypt::SSLeay. In addition to
+bringing SSL support to the LWP package, IO::Socket::SSL can be used
+as an object oriented interface to SSL encrypted network sockets.
+
+There is yet another SSL interface for perl called Net::SSLeay. It has
+a more complete SSL interface and can be used for web client
+programming among other things but doesn't directly support LWP.
+
+The underlying SSL support in all of these modules is based on OpenSSL
+<http://www.openssl.org/> (formerly SSLeay). For WWW-server side SSL
+support (e.g. CGI/FCGI scripts) in Apache see <http://www.modssl.org/>.