Crypt::SSLeay - OpenSSL & SSLeay glue that provides LWP https support
This perl module provides support for the https protocol under LWP, so that a LWP::UserAgent can make https GET & HEAD requests.
The Crypt::SSLeay package contains Net::SSL, which is automatically loaded by LWP::Protocol::https on https requests, and provides the necessary SSL glue for that module to work via these deprecated modules:
Crypt::SSLeay::CTX Crypt::SSLeay::Conn Crypt::SSLeay::X509
Work on Crypt::SSLeay has been continued only to provide https support for the LWP - libwww perl libraries. If you want access to the OpenSSL API via perl, check out Sampo's Net::SSLeay.
You must have OpenSSL or SSLeay installed before compiling this module. You can get the latest OpenSSL package from:
When installing openssl make sure your config looks like:
> ./config --openssldir=/usr/local/openssl or > ./config --openssldir=/usr/local/ssl
then > make > make test > make install
This way Crypt::SSLeay will pick up the includes and libraries automatically. If your includes end up going into a separate directory like /usr/local/include, then you will need to symlink /usr/local/openssl/include to /usr/local/include
The latest Crypt::SSLeay can be found at your nearest CPAN, and also:
Once you have downloaded it, Crypt::SSLeay installs easily using the make or nmake commands as shown below.
> perl Makefile.PL > make > make test > make install
* use nmake for win32
This module has been compiled on the following platforms:
PLATFORM CPU SSL PERL DATE WHO -------- --- --- ---- ---- --- WinNT SP4 x86 OpenSSL 0.9.4 5.00404 1999-10-03 Joshua Chamas FreeBSD 3.2 ?x86 OpenSSL 0.9.2b 5.00503 1999-09-29 Rip Toren Solaris 2.6 ?Sparc OpenSSL 0.9.4 5.00404 1999-08-24 Patrick Killelea FreeBSD 2.2.5 x86 OpenSSL 0.9.3 5.00404 1999-08-19 Andy Lee Solaris 2.5.1 USparc OpenSSL 0.9.4 5.00503 1999-08-18 Marek Rouchal Solaris 2.6 x86 OpenSSL 0.9.4 5.00501 1999-08-12 Joshua Chamas Solaris 2.6 x86 SSLeay 0.8.0 5.00501 1999-08-12 Joshua Chamas Linux 2.2.10 x86 OpenSSL 0.9.4 5.00503 1999-08-11 John Barrett WinNT SP4 x86 SSLeay 0.9.2 5.00404 1999-08-10 Joshua Chamas
On Solaris x86, the default PERL configuration, and preferred, is to use the ld linker that comes with the OS, not gcc. Unfortunately during the OpenSSL build process, gcc generates in libcrypto.a, from bn_word.c, the undefined symbol __umoddi3, which is supposed to be later resolved by gcc from libgcc.a
The system ld linker does not know about libgcc.a by default, so when building Crypt::SSLeay, there is a linker error for __umoddi3
The fix for this symlink your libgcc.a to some standard directory like /usr/local/lib, so that the system linker, ld, can find it when building Crypt::SSLeay.
If you encounter this error: ``...des.h:96: #error _ is defined, but some strange definition the DES library cannot handle that...,'' then you need to edit the des.h file and comment out the ``#error'' line.
Its looks like this error might be common to other operating systems, and that occurs with OpenSSL 0.9.3. Upgrades to 0.9.4 seem to fix this problem.
Many thanks to Gisle Aas for the original writing of this module and many others including libwww for perl. The web will never be the same :)
For OpenSSL support, please email the openssl user mailing list at firstname.lastname@example.org
Please send any Crypt::SSLeay questions or comments to me at email@example.com
This module was originally written by Gisle Aas, and I am now maintaining it.
Copyright (c) 1999 Joshua Chamas. Copyright (c) 1998 Gisle Aas.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.