crypt::des_ede3(3pm) [debian man page]

Crypt::DES_EDE3(3pm)					User Contributed Perl Documentation				      Crypt::DES_EDE3(3pm)

NAME

       Crypt::DES_EDE3 - Triple-DES EDE encryption/decryption

SYNOPSIS

	   use Crypt::DES_EDE3;
	   my $ede3 = Crypt::DES_EDE3->new($key);
	   $ede3->encrypt($block);

DESCRIPTION

       Crypt::DES_EDE3 implements DES-EDE3 encryption. This is triple-DES encryption where an encrypt operation is encrypt-decrypt-encrypt, and
       decrypt is decrypt-encrypt-decrypt. This implementation uses Crypt::DES to do its dirty DES work, and simply provides a wrapper around that
       module: setting up the individual DES ciphers, initializing the keys, and performing the encryption/decryption steps.

       DES-EDE3 encryption requires a key size of 24 bytes.

       You're probably best off not using this module directly, as the encrypt and decrypt methods expect 8-octet blocks. You might want to use
       the module in conjunction with Crypt::CBC, for example. This would be DES-EDE3-CBC, or triple-DES in outer CBC mode.

USAGE

       $ede3 = Crypt::DES_EDE3->new($key)

       Creates a new Crypt::DES_EDE3 object (really, a collection of three DES ciphers), and initializes each cipher with part of $key, which
       should be at least 24 bytes. If it's longer than 24 bytes, the extra bytes will be ignored.

       Returns the new object.

       $ede3->encrypt($block)

       Encrypts an 8-byte block of data $block using the three DES ciphers in an encrypt-decrypt-encrypt operation.

       Returns the encrypted block.

       $ede3->decrypt($block)

       Decrypts an 8-byte block of data $block using the three DES ciphers in a decrypt-encrypt-decrypt operation.

       Returns the decrypted block.

       $ede3->blocksize

       Returns the block size(8).

       $ede3->keysize

       Returns the key size(24).

LICENSE

       Crypt::DES_EDE3 is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR &; COPYRIGHTS
       Crypt::DES_EDE3 is Copyright 2001 Benjamin Trott, ben@rhumba.pair.com. All rights reserved.

perl v5.8.8							    2001-09-15						      Crypt::DES_EDE3(3pm)

DES(3pm)						User Contributed Perl Documentation						  DES(3pm)

NAME

       Crypt::DES - Perl DES encryption module

SYNOPSIS

	   use Crypt::DES;

DESCRIPTION

       The module implements the Crypt::CBC interface, which has the following methods

       blocksize =item keysize =item encrypt =item decrypt

FUNCTIONS

       blocksize
	   Returns the size (in bytes) of the block cipher.

       keysize
	   Returns the size (in bytes) of the key. Optimal size is 8 bytes.

       new
		   my $cipher = new Crypt::DES $key;

	   This creates a new Crypt::DES BlockCipher object, using $key, where $key is a key of "keysize()" bytes.

       encrypt
		   my $cipher = new Crypt::DES $key;
		   my $ciphertext = $cipher->encrypt($plaintext);

	   This function encrypts $plaintext and returns the $ciphertext where $plaintext and $ciphertext should be of "blocksize()" bytes.

       decrypt
		   my $cipher = new Crypt::DES $key;
		   my $plaintext = $cipher->decrypt($ciphertext);

	   This function decrypts $ciphertext and returns the $plaintext where $plaintext and $ciphertext should be of "blocksize()" bytes.

EXAMPLE

	       my $key = pack("H16", "0123456789ABCDEF");
	       my $cipher = new Crypt::DES $key;
	       my $ciphertext = $cipher->encrypt("plaintex");  # NB - 8 bytes
	       print unpack("H16", $ciphertext), "
";

NOTES

       Do note that DES only uses 8 byte keys and only works on 8 byte data blocks.  If you're intending to encrypt larger blocks or entire files,
       please use Crypt::CBC in conjunction with this module.  See the Crypt::CBC documentation for proper syntax and use.

       Also note that the DES algorithm is, by today's standard, weak encryption.  Crypt::Blowfish is highly recommended if you're interested in
       using strong encryption and a faster algorithm.

SEE ALSO

       Crypt::Blowfish Crypt::IDEA

       Bruce Schneier, Applied Cryptography, 1995, Second Edition, published by John Wiley & Sons, Inc.

COPYRIGHT

       The implementation of the DES algorithm was developed by, and is copyright of, Eric Young (eay@mincom.oz.au).  Other parts of the perl
       extension and module are copyright of Systemics Ltd ( http://www.systemics.com/ ).  Cross-platform work and packaging for single algorithm
       distribution is copyright of W3Works, LLC.

MAINTAINER

       This single-algorithm package and cross-platform code is maintained by Dave Paris <amused@pobox.com>.

perl v5.14.2							    2005-12-08								  DES(3pm)