$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