File Coverage

blib/lib/Crypt/Cipher/RC5.pm

Criterion	Covered	Total	%
statement	17	17	100.0
branch			n/a
condition			n/a
subroutine	9	9	100.0
pod	6	6	100.0
total	32	32	100.0

package Crypt::Cipher::RC5;

### BEWARE - GENERATED FILE, DO NOT EDIT MANUALLY!

use strict;
use warnings;
our $VERSION = '0.088_004';

use base qw(Crypt::Cipher);

sub new {
  my ($class, @args) = @_;
  my $obj = Crypt::Cipher->new('RC5', @args);
  return bless $obj, $class;
}

sub blocksize      { Crypt::Cipher::blocksize('RC5')      }
sub keysize        { Crypt::Cipher::keysize('RC5')        }
sub max_keysize    { Crypt::Cipher::max_keysize('RC5')    }
sub min_keysize    { Crypt::Cipher::min_keysize('RC5')    }
sub default_rounds { Crypt::Cipher::default_rounds('RC5') }

1;

=pod

=head1 NAME

Crypt::Cipher::RC5 - Symmetric cipher RC5, key size: 64-1024 bits

=head1 SYNOPSIS

  ### example 1
  use Crypt::Mode::CBC;

  my $key = '...'; # length has to be valid key size for this cipher
  my $iv = '...';  # 16 bytes
  my $cbc = Crypt::Mode::CBC->new('RC5');
  my $ciphertext = $cbc->encrypt("secret data", $key, $iv);

  ### example 2 (slower)
  use Crypt::CBC;
  use Crypt::Cipher::RC5;

  my $key = '...'; # length has to be valid key size for this cipher
  my $iv = '...';  # 16 bytes
  my $cbc = Crypt::CBC->new( -cipher=>'Cipher::RC5', -key=>$key, -iv=>$iv );
  my $ciphertext = $cbc->encrypt("secret data");

=head1 DESCRIPTION

This module implements the RC5 cipher. Provided interface is compliant with L module.

B This module implements just elementary "one-block-(en|de)cryption" operation - if you want to
encrypt/decrypt generic data you have to use some of the cipher block modes - check for example
L, L or L (which will be slower).

=head1 METHODS

Unless noted otherwise, assume C<$c> is an existing cipher object created via
C, for example:

 my $c = Crypt::Cipher::RC5->new($key);

=head2 new

 my $c = Crypt::Cipher::RC5->new($key);
 #or
 my $c = Crypt::Cipher::RC5->new($key, $rounds);

 # $key .... [binary string] key of an accepted length (see keysize, min_keysize, max_keysize)
 # $rounds . [integer] optional, number of rounds (if supported by the cipher; croaks on invalid value)

=head2 encrypt

Encrypts exactly one block of plaintext. The length of C<$plaintext> must
equal L; croaks otherwise. An empty string is accepted and
returned unchanged.



 my $ciphertext = $c->encrypt($plaintext);

Returns the encrypted block as a binary string (raw bytes).

=head2 decrypt

Decrypts exactly one block of ciphertext. The length of C<$ciphertext> must
equal L; croaks otherwise. An empty string is accepted and
returned unchanged.

 my $plaintext = $c->decrypt($ciphertext);

Returns the decrypted block as a binary string (raw bytes).

=head2 keysize

Just an alias for C.

  $c->keysize;
  #or
  Crypt::Cipher::RC5->keysize;
  #or
  Crypt::Cipher::RC5::keysize;

=head2 blocksize

Returns the cipher block size (in bytes).

  $c->blocksize;
  #or
  Crypt::Cipher::RC5->blocksize;
  #or
  Crypt::Cipher::RC5::blocksize;

=head2 max_keysize

Returns the maximum key size (in bytes).

  $c->max_keysize;
  #or
  Crypt::Cipher::RC5->max_keysize;
  #or
  Crypt::Cipher::RC5::max_keysize;

=head2 min_keysize

Returns the minimum key size (in bytes).

  $c->min_keysize;
  #or
  Crypt::Cipher::RC5->min_keysize;
  #or
  Crypt::Cipher::RC5::min_keysize;

=head2 default_rounds

Returns the cipher's default round count.

  $c->default_rounds;
  #or
  Crypt::Cipher::RC5->default_rounds;
  #or
  Crypt::Cipher::RC5::default_rounds;

=head1 SEE ALSO

=over

=item * L, L

=item * L

=back

=cut