$Id -------- Abstract -------- Crypt::GCrypt provides a Perl interface to the libgcrypt cryptographic functions. It currently supports symmetric ciphers such as AES/Rikndael, Twofish, Triple DES, Arcfour etc., while asymmetric cryptography is being developed. ------------ Requirements ------------ Crypt::GCrypt requires that libgcrypt is installed on your system. You can use your favourite package manager or download the latest version of libgcrypt at the GNU site: ftp://ftp.gnupg.org/gcrypt/libgcrypt/ and then you can install it just doing: $ ./configure $ make # make install Crypt::GCrypt was tested with libgcrypt 1.2.4. If libgcrypt is installed, but in a non-standard directory, then use the following options to Makefile.PL: GCRYPTLIBPATH=... To set the directory in which to find libgcrypt GCRYPTINCPATH=... To set the directory in which to find gcrypt.h For example: perl Makefile.PL GCRYPTLIBPATH=/home/me/lib GCRYPTINCPATH=/home/me/include Note that if you build against a shareable library in a non-standard location you may (on some platforms) also have to set your LD_LIBRARY_PATH environment variable at run time for perl to find the library. ------------------ Basic Installation ------------------ Crypt::GCrypt may be installed through the CPAN shell in the usual manner. Typically: $ perl -MCPAN -e 'install Crypt::GCrypt' You can also read this README from the CPAN shell: $ perl -MCPAN -e shell cpan> readme Crypt::GCrypt And you can install the component from the CPAN prompt as well: cpan> install Crypt::GCrypt ------------------- Manual Installation ------------------- This module may also be installed manually. Its distribution is available from the author's CPAN directory, <ftp://ftp.cpan.org/pub/CPAN/authors/id/A/AA/AAR/>, or a similarly named directory at your favorite CPAN mirror. Downloading and unpacking the distribution are left as exercises for the reader. To build and test it: perl Makefile.PL make test When you're ready to install the component: make install It should now be ready to use. Thanks for reading! -- Alessandro Ranellucci / aar@cpan.org / http://alex.primafila.net