summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/Crypt/IDEA.pod
blob: d026f8b7eccb685dbfc5882bffe2b6e593ac4266 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
=head1 NAME

IDEA - Perl interface to IDEA block cipher

=head1 SYNOPSIS

    use Crypt::IDEA;
    

=head1 DESCRIPTION

This perl extension is an implementation of the IDEA block cipher algorithm.
The module implements the Crypt::BlockCipher interface,
which has the following methods

=over 4

=item blocksize
=item keysize
=item encrypt
=item decrypt

=back

=head1 FUNCTIONS

=over 4

=item blocksize

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

=item keysize

Returns the size (in bytes) of the key.

=item new

	my $cipher = new IDEA $key;

This creates a new IDEA BlockCipher object, using $key,
where $key is a key of C<keysize()> bytes.

=item encrypt

	my $cipher = new IDEA $key;
	my $ciphertext = $cipher->encrypt($plaintext);

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

=item decrypt

	my $cipher = new IDEA $key;
	my $plaintext = $cipher->decrypt($ciphertext);

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

=back

=head1 EXAMPLE

	my $key = pack("H32", "0123456789ABCDEF0123456789ABCDEF");
	my $cipher = new IDEA $key;
	my $ciphertext = $cipher->encrypt("plaintex");	# NB - 8 bytes
	print unpack("H16", $ciphertext), "\n";

=head1 SEE ALSO

Crypt::CBD, Crypt::DES, Crypt::Blowfish

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


=head1 COPYRIGHT

This implementation is copyright Systemics Ltd ( http://www.systemics.com/ ).

The IDEA algorithm is patented in Europe and the United States
by Ascom-Tech AG.

Module altered between 1999 and 2005  to allow added functionality with perl -MCPAN,
Changes by Dave Paris  (edited lib paths, endian issues, new tests).

Thank you to contributors for endian patches and new test suite!