Hex Artifact Content
Not logged in

Artifact 19c7a6d9626d518c06f1125cd490f5fae043d197:


0000: 70 61 63 6b 61 67 65 20 43 72 79 70 74 3a 3a 52  package Crypt::R
0010: 68 61 73 68 3b 0a 0a 75 73 65 20 35 2e 30 30 38  hash;..use 5.008
0020: 30 30 38 3b 0a 75 73 65 20 73 74 72 69 63 74 3b  008;.use strict;
0030: 0a 75 73 65 20 77 61 72 6e 69 6e 67 73 3b 0a 0a  .use warnings;..
0040: 72 65 71 75 69 72 65 20 45 78 70 6f 72 74 65 72  require Exporter
0050: 3b 0a 6f 75 72 20 40 49 53 41 20 3d 20 28 71 77  ;.our @ISA = (qw
0060: 28 45 78 70 6f 72 74 65 72 29 29 3b 0a 0a 23 20  (Exporter));..# 
0070: 70 6f 73 73 69 62 6c 65 20 74 61 67 73 20 66 6f  possible tags fo
0080: 72 20 65 78 70 6f 72 74 0a 6f 75 72 20 25 45 58  r export.our %EX
0090: 50 4f 52 54 5f 54 41 47 53 20 3d 20 28 0a 09 46  PORT_TAGS = (..F
00a0: 75 6e 63 74 69 6f 6e 73 20 3d 3e 20 5b 71 77 28  unctions => [qw(
00b0: 72 61 77 32 68 65 78 20 72 61 77 32 62 61 73 65  raw2hex raw2base
00c0: 33 32 20 72 61 77 32 62 61 73 65 36 34 29 5d 2c  32 raw2base64)],
00d0: 0a 09 43 6f 6e 73 74 61 6e 74 73 20 3d 3e 20 5b  ..Constants => [
00e0: 71 77 28 52 48 41 53 48 5f 43 52 43 33 32 20 52  qw(RHASH_CRC32 R
00f0: 48 41 53 48 5f 4d 44 34 20 52 48 41 53 48 5f 4d  HASH_MD4 RHASH_M
0100: 44 35 20 52 48 41 53 48 5f 53 48 41 31 20 52 48  D5 RHASH_SHA1 RH
0110: 41 53 48 5f 54 49 47 45 52 0a 09 09 52 48 41 53  ASH_TIGER...RHAS
0120: 48 5f 54 54 48 20 52 48 41 53 48 5f 42 54 49 48  H_TTH RHASH_BTIH
0130: 20 52 48 41 53 48 5f 45 44 32 4b 20 52 48 41 53   RHASH_ED2K RHAS
0140: 48 5f 41 49 43 48 20 52 48 41 53 48 5f 57 48 49  H_AICH RHASH_WHI
0150: 52 4c 50 4f 4f 4c 0a 09 09 52 48 41 53 48 5f 52  RLPOOL...RHASH_R
0160: 49 50 45 4d 44 31 36 30 20 52 48 41 53 48 5f 47  IPEMD160 RHASH_G
0170: 4f 53 54 20 52 48 41 53 48 5f 47 4f 53 54 5f 43  OST RHASH_GOST_C
0180: 52 59 50 54 4f 50 52 4f 20 52 48 41 53 48 5f 48  RYPTOPRO RHASH_H
0190: 41 53 31 36 30 0a 09 09 52 48 41 53 48 5f 53 4e  AS160...RHASH_SN
01a0: 45 46 52 55 31 32 38 20 52 48 41 53 48 5f 53 4e  EFRU128 RHASH_SN
01b0: 45 46 52 55 32 35 36 20 52 48 41 53 48 5f 53 48  EFRU256 RHASH_SH
01c0: 41 32 32 34 20 52 48 41 53 48 5f 53 48 41 32 35  A224 RHASH_SHA25
01d0: 36 0a 09 09 52 48 41 53 48 5f 53 48 41 33 38 34  6...RHASH_SHA384
01e0: 20 52 48 41 53 48 5f 53 48 41 35 31 32 20 52 48   RHASH_SHA512 RH
01f0: 41 53 48 5f 45 44 4f 4e 52 32 35 36 20 52 48 41  ASH_EDONR256 RHA
0200: 53 48 5f 45 44 4f 4e 52 35 31 32 0a 09 09 52 48  SH_EDONR512...RH
0210: 41 53 48 5f 53 48 41 33 5f 32 32 34 20 52 48 41  ASH_SHA3_224 RHA
0220: 53 48 5f 53 48 41 33 5f 32 35 36 20 52 48 41 53  SH_SHA3_256 RHAS
0230: 48 5f 53 48 41 33 5f 33 38 34 20 52 48 41 53 48  H_SHA3_384 RHASH
0240: 5f 53 48 41 33 5f 35 31 32 20 52 48 41 53 48 5f  _SHA3_512 RHASH_
0250: 41 4c 4c 29 5d 0a 29 3b 0a 0a 45 78 70 6f 72 74  ALL)].);..Export
0260: 65 72 3a 3a 65 78 70 6f 72 74 5f 74 61 67 73 28  er::export_tags(
0270: 20 29 3b 0a 45 78 70 6f 72 74 65 72 3a 3a 65 78   );.Exporter::ex
0280: 70 6f 72 74 5f 6f 6b 5f 74 61 67 73 28 20 71 77  port_ok_tags( qw
0290: 28 46 75 6e 63 74 69 6f 6e 73 20 43 6f 6e 73 74  (Functions Const
02a0: 61 6e 74 73 29 20 29 3b 0a 0a 6f 75 72 20 24 56  ants) );..our $V
02b0: 45 52 53 49 4f 4e 20 3d 20 27 30 2e 39 34 27 3b  ERSION = '0.94';
02c0: 0a 0a 72 65 71 75 69 72 65 20 58 53 4c 6f 61 64  ..require XSLoad
02d0: 65 72 3b 0a 58 53 4c 6f 61 64 65 72 3a 3a 6c 6f  er;.XSLoader::lo
02e0: 61 64 28 27 43 72 79 70 74 3a 3a 52 68 61 73 68  ad('Crypt::Rhash
02f0: 27 2c 20 24 56 45 52 53 49 4f 4e 29 3b 0a 0a 23  ', $VERSION);..#
0300: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0310: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0320: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0330: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0340: 23 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 20  #############.# 
0350: 69 64 73 20 6f 66 20 68 61 73 68 20 66 75 6e 63  ids of hash func
0360: 74 69 6f 6e 73 0a 75 73 65 20 63 6f 6e 73 74 61  tions.use consta
0370: 6e 74 20 52 48 41 53 48 5f 43 52 43 33 32 20 3d  nt RHASH_CRC32 =
0380: 3e 20 30 78 30 31 3b 0a 75 73 65 20 63 6f 6e 73  > 0x01;.use cons
0390: 74 61 6e 74 20 52 48 41 53 48 5f 4d 44 34 20 20  tant RHASH_MD4  
03a0: 20 3d 3e 20 30 78 30 32 3b 0a 75 73 65 20 63 6f   => 0x02;.use co
03b0: 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 4d 44 35  nstant RHASH_MD5
03c0: 20 20 20 3d 3e 20 30 78 30 34 3b 0a 75 73 65 20     => 0x04;.use 
03d0: 63 6f 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 53  constant RHASH_S
03e0: 48 41 31 20 20 3d 3e 20 30 78 30 38 3b 0a 75 73  HA1  => 0x08;.us
03f0: 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 41 53 48  e constant RHASH
0400: 5f 54 49 47 45 52 20 3d 3e 20 30 78 31 30 3b 0a  _TIGER => 0x10;.
0410: 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 41  use constant RHA
0420: 53 48 5f 54 54 48 20 20 20 3d 3e 20 30 78 32 30  SH_TTH   => 0x20
0430: 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52  ;.use constant R
0440: 48 41 53 48 5f 42 54 49 48 20 20 3d 3e 20 30 78  HASH_BTIH  => 0x
0450: 34 30 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74  40;.use constant
0460: 20 52 48 41 53 48 5f 45 44 32 4b 20 20 3d 3e 20   RHASH_ED2K  => 
0470: 30 78 38 30 3b 0a 75 73 65 20 63 6f 6e 73 74 61  0x80;.use consta
0480: 6e 74 20 52 48 41 53 48 5f 41 49 43 48 20 20 3d  nt RHASH_AICH  =
0490: 3e 20 30 78 31 30 30 3b 0a 75 73 65 20 63 6f 6e  > 0x100;.use con
04a0: 73 74 61 6e 74 20 52 48 41 53 48 5f 57 48 49 52  stant RHASH_WHIR
04b0: 4c 50 4f 4f 4c 20 3d 3e 20 30 78 32 30 30 3b 0a  LPOOL => 0x200;.
04c0: 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 41  use constant RHA
04d0: 53 48 5f 52 49 50 45 4d 44 31 36 30 20 3d 3e 20  SH_RIPEMD160 => 
04e0: 30 78 34 30 30 3b 0a 75 73 65 20 63 6f 6e 73 74  0x400;.use const
04f0: 61 6e 74 20 52 48 41 53 48 5f 47 4f 53 54 20 20  ant RHASH_GOST  
0500: 20 20 20 20 3d 3e 20 30 78 38 30 30 3b 0a 75 73      => 0x800;.us
0510: 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 41 53 48  e constant RHASH
0520: 5f 47 4f 53 54 5f 43 52 59 50 54 4f 50 52 4f 20  _GOST_CRYPTOPRO 
0530: 3d 3e 20 30 78 31 30 30 30 3b 0a 75 73 65 20 63  => 0x1000;.use c
0540: 6f 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 48 41  onstant RHASH_HA
0550: 53 31 36 30 20 20 20 20 3d 3e 20 30 78 32 30 30  S160    => 0x200
0560: 30 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20  0;.use constant 
0570: 52 48 41 53 48 5f 53 4e 45 46 52 55 31 32 38 20  RHASH_SNEFRU128 
0580: 3d 3e 20 30 78 34 30 30 30 3b 0a 75 73 65 20 63  => 0x4000;.use c
0590: 6f 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 53 4e  onstant RHASH_SN
05a0: 45 46 52 55 32 35 36 20 3d 3e 20 30 78 38 30 30  EFRU256 => 0x800
05b0: 30 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20  0;.use constant 
05c0: 52 48 41 53 48 5f 53 48 41 32 32 34 20 20 20 20  RHASH_SHA224    
05d0: 3d 3e 20 30 78 31 30 30 30 30 3b 0a 75 73 65 20  => 0x10000;.use 
05e0: 63 6f 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 53  constant RHASH_S
05f0: 48 41 32 35 36 20 20 20 20 3d 3e 20 30 78 32 30  HA256    => 0x20
0600: 30 30 30 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e  000;.use constan
0610: 74 20 52 48 41 53 48 5f 53 48 41 33 38 34 20 20  t RHASH_SHA384  
0620: 20 20 3d 3e 20 30 78 34 30 30 30 30 3b 0a 75 73    => 0x40000;.us
0630: 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 41 53 48  e constant RHASH
0640: 5f 53 48 41 35 31 32 20 20 20 20 3d 3e 20 30 78  _SHA512    => 0x
0650: 38 30 30 30 30 3b 0a 75 73 65 20 63 6f 6e 73 74  80000;.use const
0660: 61 6e 74 20 52 48 41 53 48 5f 45 44 4f 4e 52 32  ant RHASH_EDONR2
0670: 35 36 20 20 3d 3e 20 30 78 31 30 30 30 30 30 3b  56  => 0x100000;
0680: 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52 48  .use constant RH
0690: 41 53 48 5f 45 44 4f 4e 52 35 31 32 20 20 3d 3e  ASH_EDONR512  =>
06a0: 20 30 78 32 30 30 30 30 30 3b 0a 75 73 65 20 63   0x200000;.use c
06b0: 6f 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 53 48  onstant RHASH_SH
06c0: 41 33 5f 32 32 34 20 20 3d 3e 20 30 78 30 34 30  A3_224  => 0x040
06d0: 30 30 30 30 3b 0a 75 73 65 20 63 6f 6e 73 74 61  0000;.use consta
06e0: 6e 74 20 52 48 41 53 48 5f 53 48 41 33 5f 32 35  nt RHASH_SHA3_25
06f0: 36 20 20 3d 3e 20 30 78 30 38 30 30 30 30 30 3b  6  => 0x0800000;
0700: 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52 48  .use constant RH
0710: 41 53 48 5f 53 48 41 33 5f 33 38 34 20 20 3d 3e  ASH_SHA3_384  =>
0720: 20 30 78 31 30 30 30 30 30 30 3b 0a 75 73 65 20   0x1000000;.use 
0730: 63 6f 6e 73 74 61 6e 74 20 52 48 41 53 48 5f 53  constant RHASH_S
0740: 48 41 33 5f 35 31 32 20 20 3d 3e 20 30 78 32 30  HA3_512  => 0x20
0750: 30 30 30 30 30 3b 0a 75 73 65 20 63 6f 6e 73 74  00000;.use const
0760: 61 6e 74 20 52 48 41 53 48 5f 41 4c 4c 20 20 20  ant RHASH_ALL   
0770: 20 20 20 20 3d 3e 20 30 78 33 46 46 46 46 46 46      => 0x3FFFFFF
0780: 3b 0a 0a 23 23 23 23 23 23 23 23 23 23 23 23 23  ;..#############
0790: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
07a0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
07b0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
07c0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
07d0: 23 0a 23 20 52 68 61 73 68 20 63 6c 61 73 73 20  #.# Rhash class 
07e0: 6d 65 74 68 6f 64 73 0a 0a 23 20 52 68 61 73 68  methods..# Rhash
07f0: 20 6f 62 6a 65 63 74 20 63 6f 6e 73 74 72 75 63   object construc
0800: 74 6f 72 0a 73 75 62 20 6e 65 77 0a 7b 0a 09 6d  tor.sub new.{..m
0810: 79 20 24 68 61 73 68 5f 69 64 20 3d 20 24 5f 5b  y $hash_id = $_[
0820: 31 5d 20 6f 72 20 64 69 65 20 22 68 61 73 68 5f  1] or die "hash_
0830: 69 64 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64  id not specified
0840: 22 3b 0a 09 6d 79 20 24 63 6f 6e 74 65 78 74 20  ";..my $context 
0850: 3d 20 72 68 61 73 68 5f 69 6e 69 74 28 73 63 61  = rhash_init(sca
0860: 6c 61 72 28 24 68 61 73 68 5f 69 64 29 29 20 6f  lar($hash_id)) o
0870: 72 20 72 65 74 75 72 6e 20 75 6e 64 65 66 3b 0a  r return undef;.
0880: 09 6d 79 20 24 73 65 6c 66 20 3d 20 7b 0a 09 09  .my $self = {...
0890: 63 6f 6e 74 65 78 74 20 3d 3e 20 24 63 6f 6e 74  context => $cont
08a0: 65 78 74 2c 0a 09 7d 3b 0a 09 72 65 74 75 72 6e  ext,..};..return
08b0: 20 62 6c 65 73 73 20 24 73 65 6c 66 3b 0a 7d 0a   bless $self;.}.
08c0: 0a 23 20 64 65 73 74 72 75 63 74 6f 72 0a 73 75  .# destructor.su
08d0: 62 20 44 45 53 54 52 4f 59 28 24 29 0a 7b 0a 09  b DESTROY($).{..
08e0: 6d 79 20 24 73 65 6c 66 20 3d 20 73 68 69 66 74  my $self = shift
08f0: 3b 0a 09 23 20 74 68 65 20 27 69 66 27 20 61 64  ;..# the 'if' ad
0900: 64 65 64 20 61 73 20 77 6f 72 6b 61 72 6f 75 6e  ded as workaroun
0910: 64 20 66 6f 72 20 70 65 72 6c 20 27 67 6c 6f 62  d for perl 'glob
0920: 61 6c 20 64 65 73 74 72 75 63 74 69 6f 6e 27 20  al destruction' 
0930: 62 75 67 0a 09 23 20 28 24 73 65 6c 66 2d 3e 7b  bug..# ($self->{
0940: 63 6f 6e 74 65 78 74 7d 20 63 61 6e 20 64 69 73  context} can dis
0950: 61 70 70 65 61 72 20 6f 6e 20 67 6c 6f 62 61 6c  appear on global
0960: 20 64 65 73 74 72 75 63 74 69 6f 6e 29 0a 09 72   destruction)..r
0970: 68 61 73 68 5f 66 72 65 65 28 24 73 65 6c 66 2d  hash_free($self-
0980: 3e 7b 63 6f 6e 74 65 78 74 7d 29 20 69 66 20 24  >{context}) if $
0990: 73 65 6c 66 2d 3e 7b 63 6f 6e 74 65 78 74 7d 3b  self->{context};
09a0: 0a 7d 0a 0a 73 75 62 20 75 70 64 61 74 65 28 24  .}..sub update($
09b0: 24 29 0a 7b 0a 09 6d 79 20 24 73 65 6c 66 20 3d  $).{..my $self =
09c0: 20 73 68 69 66 74 3b 0a 09 6d 79 20 24 6d 65 73   shift;..my $mes
09d0: 73 61 67 65 20 3d 20 73 68 69 66 74 3b 0a 09 72  sage = shift;..r
09e0: 68 61 73 68 5f 75 70 64 61 74 65 28 24 73 65 6c  hash_update($sel
09f0: 66 2d 3e 7b 63 6f 6e 74 65 78 74 7d 2c 20 24 6d  f->{context}, $m
0a00: 65 73 73 61 67 65 29 3b 0a 09 72 65 74 75 72 6e  essage);..return
0a10: 20 24 73 65 6c 66 3b 0a 7d 0a 0a 73 75 62 20 75   $self;.}..sub u
0a20: 70 64 61 74 65 5f 66 64 28 24 24 3b 24 24 29 0a  pdate_fd($$;$$).
0a30: 7b 0a 09 6d 79 20 28 24 73 65 6c 66 2c 20 24 66  {..my ($self, $f
0a40: 64 2c 20 24 73 74 61 72 74 2c 20 24 73 69 7a 65  d, $start, $size
0a50: 29 20 3d 20 40 5f 3b 0a 09 6d 79 20 24 72 65 73  ) = @_;..my $res
0a60: 20 3d 20 30 3b 0a 09 6d 79 20 24 6e 75 6d 20 3d   = 0;..my $num =
0a70: 20 30 3b 0a 0a 09 62 69 6e 6d 6f 64 65 28 24 66   0;...binmode($f
0a80: 64 29 3b 0a 09 69 66 28 64 65 66 69 6e 65 64 28  d);..if(defined(
0a90: 24 73 74 61 72 74 29 29 20 7b 0a 09 09 73 65 65  $start)) {...see
0aa0: 6b 28 24 66 64 2c 20 73 63 61 6c 61 72 28 24 73  k($fd, scalar($s
0ab0: 74 61 72 74 29 2c 20 30 29 20 6f 72 20 72 65 74  tart), 0) or ret
0ac0: 75 72 6e 20 75 6e 64 65 66 3b 0a 09 7d 0a 0a 09  urn undef;..}...
0ad0: 6d 79 20 24 64 61 74 61 3b 0a 09 69 66 28 64 65  my $data;..if(de
0ae0: 66 69 6e 65 64 28 24 73 69 7a 65 29 29 20 7b 0a  fined($size)) {.
0af0: 09 09 66 6f 72 28 6d 79 20 24 6c 65 66 74 20 3d  ..for(my $left =
0b00: 20 73 63 61 6c 61 72 28 24 73 69 7a 65 29 3b 20   scalar($size); 
0b10: 24 6c 65 66 74 20 3e 20 30 3b 20 24 6c 65 66 74  $left > 0; $left
0b20: 20 2d 3d 20 38 31 39 32 29 20 7b 0a 09 09 09 28   -= 8192) {....(
0b30: 24 72 65 73 20 3d 20 72 65 61 64 28 24 66 64 2c  $res = read($fd,
0b40: 20 24 64 61 74 61 2c 0a 09 09 09 09 28 24 6c 65   $data,.....($le
0b50: 66 74 20 3c 20 38 31 39 32 20 3f 20 24 6c 65 66  ft < 8192 ? $lef
0b60: 74 20 3a 20 38 31 39 32 29 29 29 20 7c 7c 20 6c  t : 8192))) || l
0b70: 61 73 74 3b 0a 09 09 09 72 68 61 73 68 5f 75 70  ast;....rhash_up
0b80: 64 61 74 65 28 24 73 65 6c 66 2d 3e 7b 63 6f 6e  date($self->{con
0b90: 74 65 78 74 7d 2c 20 24 64 61 74 61 29 3b 0a 09  text}, $data);..
0ba0: 09 09 24 6e 75 6d 20 2b 3d 20 24 72 65 73 3b 0a  ..$num += $res;.
0bb0: 09 09 7d 0a 09 7d 20 65 6c 73 65 20 7b 0a 09 09  ..}..} else {...
0bc0: 77 68 69 6c 65 28 20 28 24 72 65 73 20 3d 20 72  while( ($res = r
0bd0: 65 61 64 28 24 66 64 2c 20 24 64 61 74 61 2c 20  ead($fd, $data, 
0be0: 38 31 39 32 29 29 20 29 20 7b 0a 09 09 09 72 68  8192)) ) {....rh
0bf0: 61 73 68 5f 75 70 64 61 74 65 28 24 73 65 6c 66  ash_update($self
0c00: 2d 3e 7b 63 6f 6e 74 65 78 74 7d 2c 20 24 64 61  ->{context}, $da
0c10: 74 61 29 3b 0a 09 09 09 24 6e 75 6d 20 2b 3d 20  ta);....$num += 
0c20: 24 72 65 73 3b 0a 09 09 7d 0a 09 7d 0a 0a 09 72  $res;...}..}...r
0c30: 65 74 75 72 6e 20 28 64 65 66 69 6e 65 64 28 24  eturn (defined($
0c40: 72 65 73 29 20 3f 20 24 6e 75 6d 20 3a 20 75 6e  res) ? $num : un
0c50: 64 65 66 29 3b 20 23 20 72 65 74 75 72 6e 20 75  def); # return u
0c60: 6e 64 65 66 20 6f 6e 20 72 65 61 64 20 65 72 72  ndef on read err
0c70: 6f 72 0a 7d 0a 0a 73 75 62 20 75 70 64 61 74 65  or.}..sub update
0c80: 5f 66 69 6c 65 28 24 24 3b 24 24 29 0a 7b 0a 09  _file($$;$$).{..
0c90: 6d 79 20 28 24 73 65 6c 66 2c 20 24 66 69 6c 65  my ($self, $file
0ca0: 2c 20 24 73 74 61 72 74 2c 20 24 73 69 7a 65 29  , $start, $size)
0cb0: 20 3d 20 40 5f 3b 0a 09 6f 70 65 6e 28 6d 79 20   = @_;..open(my 
0cc0: 24 66 64 2c 20 22 3c 22 2c 20 24 66 69 6c 65 29  $fd, "<", $file)
0cd0: 20 6f 72 20 72 65 74 75 72 6e 20 75 6e 64 65 66   or return undef
0ce0: 3b 0a 09 6d 79 20 24 72 65 73 20 3d 20 24 73 65  ;..my $res = $se
0cf0: 6c 66 2d 3e 75 70 64 61 74 65 5f 66 64 28 24 66  lf->update_fd($f
0d00: 64 2c 20 24 73 74 61 72 74 2c 20 24 73 69 7a 65  d, $start, $size
0d10: 29 3b 0a 09 63 6c 6f 73 65 28 24 66 64 29 3b 0a  );..close($fd);.
0d20: 09 72 65 74 75 72 6e 20 24 72 65 73 3b 0a 7d 0a  .return $res;.}.
0d30: 0a 73 75 62 20 66 69 6e 61 6c 28 24 29 0a 7b 0a  .sub final($).{.
0d40: 09 6d 79 20 24 73 65 6c 66 20 3d 20 73 68 69 66  .my $self = shif
0d50: 74 3b 0a 09 72 68 61 73 68 5f 66 69 6e 61 6c 28  t;..rhash_final(
0d60: 24 73 65 6c 66 2d 3e 7b 63 6f 6e 74 65 78 74 7d  $self->{context}
0d70: 29 3b 0a 09 72 65 74 75 72 6e 20 24 73 65 6c 66  );..return $self
0d80: 3b 0a 7d 0a 0a 73 75 62 20 72 65 73 65 74 28 24  ;.}..sub reset($
0d90: 29 0a 7b 0a 09 6d 79 20 24 73 65 6c 66 20 3d 20  ).{..my $self = 
0da0: 73 68 69 66 74 3b 0a 09 72 68 61 73 68 5f 72 65  shift;..rhash_re
0db0: 73 65 74 28 24 73 65 6c 66 2d 3e 7b 63 6f 6e 74  set($self->{cont
0dc0: 65 78 74 7d 29 3b 0a 09 72 65 74 75 72 6e 20 24  ext});..return $
0dd0: 73 65 6c 66 3b 0a 7d 0a 0a 73 75 62 20 68 61 73  self;.}..sub has
0de0: 68 65 64 5f 6c 65 6e 67 74 68 28 24 29 0a 7b 0a  hed_length($).{.
0df0: 09 6d 79 20 24 73 65 6c 66 20 3d 20 73 68 69 66  .my $self = shif
0e00: 74 3b 0a 09 72 65 74 75 72 6e 20 72 68 61 73 68  t;..return rhash
0e10: 5f 67 65 74 5f 68 61 73 68 65 64 5f 6c 65 6e 67  _get_hashed_leng
0e20: 74 68 28 24 73 65 6c 66 2d 3e 7b 63 6f 6e 74 65  th($self->{conte
0e30: 78 74 7d 29 3b 0a 7d 0a 0a 73 75 62 20 68 61 73  xt});.}..sub has
0e40: 68 5f 69 64 28 24 29 0a 7b 0a 09 6d 79 20 24 73  h_id($).{..my $s
0e50: 65 6c 66 20 3d 20 73 68 69 66 74 3b 0a 09 72 65  elf = shift;..re
0e60: 74 75 72 6e 20 72 68 61 73 68 5f 67 65 74 5f 68  turn rhash_get_h
0e70: 61 73 68 5f 69 64 28 24 73 65 6c 66 2d 3e 7b 63  ash_id($self->{c
0e80: 6f 6e 74 65 78 74 7d 29 3b 0a 7d 0a 0a 23 23 23  ontext});.}..###
0e90: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0ea0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0eb0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0ec0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0ed0: 23 23 23 23 23 23 23 23 23 23 23 0a 23 20 48 61  ###########.# Ha
0ee0: 73 68 20 66 6f 72 6d 61 74 74 69 6e 67 20 66 75  sh formatting fu
0ef0: 6e 63 74 69 6f 6e 73 0a 0a 23 20 70 72 69 6e 74  nctions..# print
0f00: 69 6e 67 20 63 6f 6e 73 74 61 6e 74 73 0a 75 73  ing constants.us
0f10: 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 50 52 5f  e constant RHPR_
0f20: 44 45 46 41 55 4c 54 20 20 20 3d 3e 20 30 78 30  DEFAULT   => 0x0
0f30: 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52  ;.use constant R
0f40: 48 50 52 5f 52 41 57 20 20 20 20 20 20 20 3d 3e  HPR_RAW       =>
0f50: 20 30 78 31 3b 0a 75 73 65 20 63 6f 6e 73 74 61   0x1;.use consta
0f60: 6e 74 20 52 48 50 52 5f 48 45 58 20 20 20 20 20  nt RHPR_HEX     
0f70: 20 20 3d 3e 20 30 78 32 3b 0a 75 73 65 20 63 6f    => 0x2;.use co
0f80: 6e 73 74 61 6e 74 20 52 48 50 52 5f 42 41 53 45  nstant RHPR_BASE
0f90: 33 32 20 20 20 20 3d 3e 20 30 78 33 3b 0a 75 73  32    => 0x3;.us
0fa0: 65 20 63 6f 6e 73 74 61 6e 74 20 52 48 50 52 5f  e constant RHPR_
0fb0: 42 41 53 45 36 34 20 20 20 20 3d 3e 20 30 78 34  BASE64    => 0x4
0fc0: 3b 0a 75 73 65 20 63 6f 6e 73 74 61 6e 74 20 52  ;.use constant R
0fd0: 48 50 52 5f 55 50 50 45 52 43 41 53 45 20 3d 3e  HPR_UPPERCASE =>
0fe0: 20 30 78 38 3b 0a 75 73 65 20 63 6f 6e 73 74 61   0x8;.use consta
0ff0: 6e 74 20 52 48 50 52 5f 52 45 56 45 52 53 45 20  nt RHPR_REVERSE 
1000: 20 20 3d 3e 20 30 78 31 30 3b 0a 0a 73 75 62 20    => 0x10;..sub 
1010: 68 61 73 68 28 24 3b 24 24 29 0a 7b 0a 09 6d 79  hash($;$$).{..my
1020: 20 24 73 65 6c 66 20 3d 20 73 68 69 66 74 3b 0a   $self = shift;.
1030: 09 6d 79 20 24 68 61 73 68 5f 69 64 20 3d 20 73  .my $hash_id = s
1040: 63 61 6c 61 72 28 73 68 69 66 74 29 20 7c 7c 20  calar(shift) || 
1050: 30 3b 0a 09 6d 79 20 24 70 72 69 6e 74 5f 66 6c  0;..my $print_fl
1060: 61 67 73 20 3d 20 73 63 61 6c 61 72 28 73 68 69  ags = scalar(shi
1070: 66 74 29 20 7c 7c 20 52 48 50 52 5f 44 45 46 41  ft) || RHPR_DEFA
1080: 55 4c 54 3b 0a 09 72 65 74 75 72 6e 20 72 68 61  ULT;..return rha
1090: 73 68 5f 70 72 69 6e 74 28 24 73 65 6c 66 2d 3e  sh_print($self->
10a0: 7b 63 6f 6e 74 65 78 74 7d 2c 20 24 68 61 73 68  {context}, $hash
10b0: 5f 69 64 2c 20 24 70 72 69 6e 74 5f 66 6c 61 67  _id, $print_flag
10c0: 73 29 3b 0a 7d 0a 0a 73 75 62 20 68 61 73 68 5f  s);.}..sub hash_
10d0: 62 61 73 65 33 32 28 24 3b 24 29 0a 7b 0a 09 68  base32($;$).{..h
10e0: 61 73 68 28 24 5f 5b 30 5d 2c 20 24 5f 5b 31 5d  ash($_[0], $_[1]
10f0: 2c 20 52 48 50 52 5f 42 41 53 45 33 32 29 3b 0a  , RHPR_BASE32);.
1100: 7d 0a 0a 73 75 62 20 68 61 73 68 5f 62 61 73 65  }..sub hash_base
1110: 36 34 28 24 3b 24 29 0a 7b 0a 09 68 61 73 68 28  64($;$).{..hash(
1120: 24 5f 5b 30 5d 2c 20 24 5f 5b 31 5d 2c 20 52 48  $_[0], $_[1], RH
1130: 50 52 5f 42 41 53 45 36 34 29 3b 0a 7d 0a 0a 73  PR_BASE64);.}..s
1140: 75 62 20 68 61 73 68 5f 68 65 78 28 24 3b 24 29  ub hash_hex($;$)
1150: 0a 7b 0a 09 68 61 73 68 28 24 5f 5b 30 5d 2c 20  .{..hash($_[0], 
1160: 24 5f 5b 31 5d 2c 20 52 48 50 52 5f 48 45 58 29  $_[1], RHPR_HEX)
1170: 3b 0a 7d 0a 0a 73 75 62 20 68 61 73 68 5f 72 68  ;.}..sub hash_rh
1180: 65 78 28 24 3b 24 29 0a 7b 0a 09 68 61 73 68 28  ex($;$).{..hash(
1190: 24 5f 5b 30 5d 2c 20 24 5f 5b 31 5d 2c 20 52 48  $_[0], $_[1], RH
11a0: 50 52 5f 48 45 58 20 7c 20 52 48 50 52 5f 52 45  PR_HEX | RHPR_RE
11b0: 56 45 52 53 45 29 3b 0a 7d 0a 0a 73 75 62 20 68  VERSE);.}..sub h
11c0: 61 73 68 5f 72 61 77 28 24 3b 24 29 0a 7b 0a 09  ash_raw($;$).{..
11d0: 68 61 73 68 28 24 5f 5b 30 5d 2c 20 24 5f 5b 31  hash($_[0], $_[1
11e0: 5d 2c 20 52 48 50 52 5f 52 41 57 29 3b 0a 7d 0a  ], RHPR_RAW);.}.
11f0: 0a 73 75 62 20 6d 61 67 6e 65 74 5f 6c 69 6e 6b  .sub magnet_link
1200: 28 24 3b 24 24 29 0a 7b 0a 09 6d 79 20 28 24 73  ($;$$).{..my ($s
1210: 65 6c 66 2c 20 24 66 69 6c 65 6e 61 6d 65 2c 20  elf, $filename, 
1220: 24 68 61 73 68 5f 6d 61 73 6b 29 20 3d 20 40 5f  $hash_mask) = @_
1230: 3b 0a 09 72 65 74 75 72 6e 20 72 68 61 73 68 5f  ;..return rhash_
1240: 70 72 69 6e 74 5f 6d 61 67 6e 65 74 28 24 73 65  print_magnet($se
1250: 6c 66 2d 3e 7b 63 6f 6e 74 65 78 74 7d 2c 20 24  lf->{context}, $
1260: 66 69 6c 65 6e 61 6d 65 2c 20 24 68 61 73 68 5f  filename, $hash_
1270: 6d 61 73 6b 29 3b 0a 7d 0a 0a 6f 75 72 20 24 41  mask);.}..our $A
1280: 55 54 4f 4c 4f 41 44 3b 0a 0a 23 20 72 65 70 6f  UTOLOAD;..# repo
1290: 72 74 20 65 72 72 6f 72 20 69 66 20 61 20 73 63  rt error if a sc
12a0: 72 69 70 74 20 63 61 6c 6c 65 64 20 75 6e 65 78  ript called unex
12b0: 69 73 74 69 6e 67 20 6d 65 74 68 6f 64 2f 66 69  isting method/fi
12c0: 65 6c 64 0a 73 75 62 20 41 55 54 4f 4c 4f 41 44  eld.sub AUTOLOAD
12d0: 0a 7b 0a 09 6d 79 20 28 24 73 65 6c 66 2c 20 24  .{..my ($self, $
12e0: 66 69 65 6c 64 2c 20 24 74 79 70 65 2c 20 24 70  field, $type, $p
12f0: 6b 67 29 20 3d 20 28 24 5f 5b 30 5d 2c 20 24 41  kg) = ($_[0], $A
1300: 55 54 4f 4c 4f 41 44 2c 20 75 6e 64 65 66 2c 20  UTOLOAD, undef, 
1310: 5f 5f 50 41 43 4b 41 47 45 5f 5f 29 3b 0a 09 24  __PACKAGE__);..$
1320: 66 69 65 6c 64 20 3d 7e 20 73 2f 2e 2a 3a 2f 2f  field =~ s/.*://
1330: 3b 0a 09 64 69 65 20 22 66 75 6e 63 74 69 6f 6e  ;..die "function
1340: 20 24 66 69 65 6c 64 20 64 6f 65 73 20 6e 6f 74   $field does not
1350: 20 65 78 69 73 74 22 20 69 66 20 24 66 69 65 6c   exist" if $fiel
1360: 64 20 3d 7e 20 2f 5e 28 72 68 61 73 68 5f 7c 72  d =~ /^(rhash_|r
1370: 61 77 32 29 2f 3b 0a 09 64 69 65 20 22 6e 6f 20  aw2)/;..die "no 
1380: 61 72 67 75 6d 65 6e 74 73 20 73 70 65 63 69 66  arguments specif
1390: 69 65 64 20 74 6f 20 24 66 69 65 6c 64 28 29 22  ied to $field()"
13a0: 20 69 66 20 21 40 5f 3b 0a 09 64 69 65 20 22 74   if !@_;..die "t
13b0: 68 65 20 24 66 69 65 6c 64 28 29 20 61 72 67 75  he $field() argu
13c0: 6d 65 6e 74 20 69 73 20 75 6e 64 65 66 69 6e 65  ment is undefine
13d0: 64 22 20 69 66 20 21 64 65 66 69 6e 65 64 20 24  d" if !defined $
13e0: 73 65 6c 66 3b 0a 0a 09 28 24 74 79 70 65 20 3d  self;...($type =
13f0: 20 72 65 66 28 24 73 65 6c 66 29 29 20 26 26 20   ref($self)) && 
1400: 24 74 79 70 65 20 65 71 20 24 70 6b 67 20 7c 7c  $type eq $pkg ||
1410: 20 64 69 65 20 22 74 68 65 20 24 66 69 65 6c 64   die "the $field
1420: 28 29 20 61 72 67 75 6d 65 6e 74 20 69 73 20 6e  () argument is n
1430: 6f 74 20 61 20 24 70 6b 67 20 72 65 66 65 72 65  ot a $pkg refere
1440: 6e 63 65 22 3b 0a 09 6d 79 20 24 74 65 78 74 20  nce";..my $text 
1450: 3d 20 28 65 78 69 73 74 73 20 24 73 65 6c 66 2d  = (exists $self-
1460: 3e 7b 24 66 69 65 6c 64 7d 20 3f 20 22 69 73 20  >{$field} ? "is 
1470: 6e 6f 74 20 61 63 63 65 73 73 69 62 6c 65 22 20  not accessible" 
1480: 3a 20 22 64 6f 65 73 20 6e 6f 74 20 65 78 69 73  : "does not exis
1490: 74 22 29 3b 0a 09 64 69 65 20 22 74 68 65 20 6d  t");..die "the m
14a0: 65 74 68 6f 64 20 24 66 69 65 6c 64 28 29 20 24  ethod $field() $
14b0: 74 65 78 74 20 69 6e 20 74 68 65 20 63 6c 61 73  text in the clas
14c0: 73 20 24 70 6b 67 22 3b 0a 7d 0a 0a 23 20 73 74  s $pkg";.}..# st
14d0: 61 74 69 63 20 66 75 6e 63 74 69 6f 6e 73 0a 0a  atic functions..
14e0: 73 75 62 20 6d 73 67 28 24 24 29 0a 7b 0a 09 6d  sub msg($$).{..m
14f0: 79 20 28 24 68 61 73 68 5f 69 64 2c 20 24 6d 73  y ($hash_id, $ms
1500: 67 29 20 3d 20 40 5f 3b 0a 09 6d 79 20 24 72 61  g) = @_;..my $ra
1510: 77 20 3d 20 72 68 61 73 68 5f 6d 73 67 5f 72 61  w = rhash_msg_ra
1520: 77 28 24 68 61 73 68 5f 69 64 2c 20 24 6d 73 67  w($hash_id, $msg
1530: 29 3b 20 23 20 67 65 74 20 62 69 6e 61 72 79 20  ); # get binary 
1540: 68 61 73 68 0a 09 72 65 74 75 72 6e 20 28 69 73  hash..return (is
1550: 5f 62 61 73 65 33 32 28 24 68 61 73 68 5f 69 64  _base32($hash_id
1560: 29 20 3f 20 72 61 77 32 62 61 73 65 33 32 28 24  ) ? raw2base32($
1570: 72 61 77 29 20 3a 20 72 61 77 32 68 65 78 28 24  raw) : raw2hex($
1580: 72 61 77 29 29 3b 0a 7d 0a 0a 31 3b 0a 5f 5f 45  raw));.}..1;.__E
1590: 4e 44 5f 5f 0a 23 20 42 65 6c 6f 77 20 69 73 20  ND__.# Below is 
15a0: 52 68 61 73 68 20 6d 6f 64 75 6c 65 20 64 6f 63  Rhash module doc
15b0: 75 6d 65 6e 74 61 74 69 6f 6e 20 69 6e 20 74 68  umentation in th
15c0: 65 20 73 74 61 6e 64 61 72 64 20 50 4f 44 20 66  e standard POD f
15d0: 6f 72 6d 61 74 0a 0a 3d 68 65 61 64 31 20 4e 41  ormat..=head1 NA
15e0: 4d 45 0a 0a 43 72 79 70 74 3a 3a 52 68 61 73 68  ME..Crypt::Rhash
15f0: 20 2d 20 43 6f 6d 70 75 74 65 20 68 61 73 68 20   - Compute hash 
1600: 73 75 6d 73 20 61 6e 64 20 6d 61 67 6e 65 74 20  sums and magnet 
1610: 6c 69 6e 6b 73 0a 0a 3d 68 65 61 64 31 20 53 59  links..=head1 SY
1620: 4e 4f 50 53 49 53 0a 0a 20 20 75 73 65 20 43 72  NOPSIS..  use Cr
1630: 79 70 74 3a 3a 52 68 61 73 68 3b 0a 20 20 0a 20  ypt::Rhash;.  . 
1640: 20 6d 79 20 24 6d 73 67 20 3d 20 22 61 20 6d 65   my $msg = "a me
1650: 73 73 61 67 65 20 74 65 78 74 22 3b 0a 20 20 70  ssage text";.  p
1660: 72 69 6e 74 20 22 4d 44 35 20 3d 20 22 20 2e 20  rint "MD5 = " . 
1670: 43 72 79 70 74 3a 3a 52 68 61 73 68 3a 3a 6d 73  Crypt::Rhash::ms
1680: 67 28 52 48 41 53 48 5f 4d 44 35 2c 20 24 6d 73  g(RHASH_MD5, $ms
1690: 67 29 20 2e 20 22 5c 6e 22 3b 0a 20 20 0a 20 20  g) . "\n";.  .  
16a0: 23 20 43 61 6c 63 75 6c 61 74 65 20 74 77 6f 20  # Calculate two 
16b0: 68 61 73 68 20 66 75 6e 63 74 69 6f 6e 73 20 73  hash functions s
16c0: 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 0a 20 20  imultaneously.  
16d0: 6d 79 20 24 72 20 3d 20 43 72 79 70 74 3a 3a 52  my $r = Crypt::R
16e0: 68 61 73 68 2d 3e 6e 65 77 28 52 48 41 53 48 5f  hash->new(RHASH_
16f0: 4d 44 35 20 7c 20 52 48 41 53 48 5f 53 48 41 31  MD5 | RHASH_SHA1
1700: 29 3b 0a 20 20 24 72 2d 3e 75 70 64 61 74 65 28  );.  $r->update(
1710: 22 61 20 6d 65 73 73 61 67 65 20 74 65 78 74 22  "a message text"
1720: 29 2d 3e 75 70 64 61 74 65 28 22 20 61 6e 6f 74  )->update(" anot
1730: 68 65 72 20 6d 65 73 73 61 67 65 22 29 3b 0a 20  her message");. 
1740: 20 70 72 69 6e 74 20 20 22 4d 44 35 20 20 3d 20   print  "MD5  = 
1750: 22 20 2e 20 24 72 2d 3e 68 61 73 68 28 52 48 41  " . $r->hash(RHA
1760: 53 48 5f 4d 44 35 29 20 2e 20 22 5c 6e 22 3b 0a  SH_MD5) . "\n";.
1770: 20 20 70 72 69 6e 74 20 20 22 53 48 41 31 20 3d    print  "SHA1 =
1780: 20 22 20 2e 20 24 72 2d 3e 68 61 73 68 28 52 48   " . $r->hash(RH
1790: 41 53 48 5f 53 48 41 31 29 20 2e 20 22 5c 6e 22  ASH_SHA1) . "\n"
17a0: 3b 0a 0a 3d 68 65 61 64 31 20 44 45 53 43 52 49  ;..=head1 DESCRI
17b0: 50 54 49 4f 4e 0a 0a 43 72 79 70 74 3a 3a 52 68  PTION..Crypt::Rh
17c0: 61 73 68 20 6d 6f 64 75 6c 65 20 69 73 20 61 6e  ash module is an
17d0: 20 6f 62 6a 65 63 74 2d 6f 72 69 65 6e 74 65 64   object-oriented
17e0: 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68   interface to th
17f0: 65 20 4c 69 62 52 48 61 73 68 20 6c 69 62 72 61  e LibRHash libra
1800: 72 79 2c 0a 61 6c 6c 6f 77 69 6e 67 20 73 69 6d  ry,.allowing sim
1810: 75 6c 74 61 6e 65 6f 75 73 20 63 61 6c 63 75 6c  ultaneous calcul
1820: 61 74 69 6f 6e 20 6f 66 20 73 65 76 65 72 61 6c  ation of several
1830: 20 68 61 73 68 20 66 75 6e 63 74 69 6f 6e 73 20   hash functions 
1840: 66 6f 72 20 61 20 66 69 6c 65 20 20 6f 72 20 61  for a file  or a
1850: 0a 74 65 78 74 20 6d 65 73 73 61 67 65 2e 0a 0a  .text message...
1860: 52 65 73 75 6c 74 69 6e 67 20 68 61 73 68 20 64  Resulting hash d
1870: 69 67 65 73 74 20 63 61 6e 20 62 65 20 6f 62 74  igest can be obt
1880: 61 69 6e 65 64 20 69 6e 20 68 65 78 61 64 65 63  ained in hexadec
1890: 69 6d 61 6c 2c 20 42 41 53 45 33 32 2c 20 42 41  imal, BASE32, BA
18a0: 53 45 36 34 2c 20 72 61 77 0a 62 69 6e 61 72 79  SE64, raw.binary
18b0: 20 66 6f 72 6d 61 74 20 6f 72 20 61 73 20 61 20   format or as a 
18c0: 6d 61 67 6e 65 74 20 6c 69 6e 6b 2e 0a 0a 3d 68  magnet link...=h
18d0: 65 61 64 31 20 53 55 50 50 4f 52 54 45 44 20 41  ead1 SUPPORTED A
18e0: 4c 47 4f 52 49 54 48 4d 53 0a 0a 54 68 65 20 6d  LGORITHMS..The m
18f0: 6f 64 75 6c 65 20 73 75 70 70 6f 72 74 73 20 74  odule supports t
1900: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 68 61 73  he following has
1910: 68 69 6e 67 20 61 6c 67 6f 72 69 74 68 6d 73 3a  hing algorithms:
1920: 0a 43 52 43 33 32 2c 20 20 4d 44 34 2c 20 4d 44  .CRC32,  MD4, MD
1930: 35 2c 20 20 53 48 41 31 2c 20 53 48 41 32 35 36  5,  SHA1, SHA256
1940: 2c 20 53 48 41 35 31 32 2c 20 53 48 41 33 2c 0a  , SHA512, SHA3,.
1950: 41 49 43 48 2c 20 45 44 32 4b 2c 20 54 69 67 65  AICH, ED2K, Tige
1960: 72 2c 20 20 44 43 2b 2b 20 54 54 48 2c 20 20 42  r,  DC++ TTH,  B
1970: 69 74 54 6f 72 72 65 6e 74 20 42 54 49 48 2c 20  itTorrent BTIH, 
1980: 47 4f 53 54 20 52 20 33 34 2e 31 31 2d 39 34 2c  GOST R 34.11-94,
1990: 20 52 49 50 45 4d 44 2d 31 36 30 2c 0a 48 41 53   RIPEMD-160,.HAS
19a0: 2d 31 36 30 2c 20 45 44 4f 4e 2d 52 20 32 35 36  -160, EDON-R 256
19b0: 2f 35 31 32 2c 20 57 68 69 72 6c 70 6f 6f 6c 20  /512, Whirlpool 
19c0: 61 6e 64 20 53 6e 65 66 72 75 2d 31 32 38 2f 32  and Snefru-128/2
19d0: 35 36 2e 0a 0a 3d 68 65 61 64 31 20 43 4f 4e 53  56...=head1 CONS
19e0: 54 52 55 43 54 4f 52 0a 0a 43 72 65 61 74 65 73  TRUCTOR..Creates
19f0: 20 61 6e 64 20 72 65 74 75 72 6e 73 20 6e 65 77   and returns new
1a00: 20 43 72 79 70 74 3a 3a 52 68 61 73 68 20 6f 62   Crypt::Rhash ob
1a10: 6a 65 63 74 2e 0a 0a 20 20 6d 79 20 24 72 20 3d  ject...  my $r =
1a20: 20 43 72 79 70 74 3a 3a 52 68 61 73 68 2d 3e 6e   Crypt::Rhash->n
1a30: 65 77 28 24 68 61 73 68 5f 69 64 29 3b 0a 20 20  ew($hash_id);.  
1a40: 6d 79 20 24 70 20 3d 20 6e 65 77 20 43 72 79 70  my $p = new Cryp
1a50: 74 3a 3a 52 68 61 73 68 28 24 68 61 73 68 5f 69  t::Rhash($hash_i
1a60: 64 29 3b 20 23 20 61 6c 74 65 72 6e 61 74 69 76  d); # alternativ
1a70: 65 20 77 61 79 20 74 6f 20 63 61 6c 6c 20 74 68  e way to call th
1a80: 65 20 63 6f 6e 73 74 72 75 63 74 6f 72 0a 0a 54  e constructor..T
1a90: 68 65 20 24 68 61 73 68 5f 69 64 20 70 61 72 61  he $hash_id para
1aa0: 6d 65 74 65 72 20 63 61 6e 20 62 65 20 75 6e 69  meter can be uni
1ab0: 6f 6e 20 28 76 69 61 20 62 69 74 77 69 73 65 20  on (via bitwise 
1ac0: 4f 52 29 20 6f 66 20 61 6e 79 20 6f 66 20 74 68  OR) of any of th
1ad0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 74 2d  e following bit-
1ae0: 66 6c 61 67 73 3a 0a 0a 20 20 52 48 41 53 48 5f  flags:..  RHASH_
1af0: 43 52 43 33 32 2c 0a 20 20 52 48 41 53 48 5f 4d  CRC32,.  RHASH_M
1b00: 44 34 2c 0a 20 20 52 48 41 53 48 5f 4d 44 35 2c  D4,.  RHASH_MD5,
1b10: 0a 20 20 52 48 41 53 48 5f 53 48 41 31 2c 0a 20  .  RHASH_SHA1,. 
1b20: 20 52 48 41 53 48 5f 54 49 47 45 52 2c 0a 20 20   RHASH_TIGER,.  
1b30: 52 48 41 53 48 5f 54 54 48 2c 0a 20 20 52 48 41  RHASH_TTH,.  RHA
1b40: 53 48 5f 42 54 49 48 2c 0a 20 20 52 48 41 53 48  SH_BTIH,.  RHASH
1b50: 5f 45 44 32 4b 2c 0a 20 20 52 48 41 53 48 5f 41  _ED2K,.  RHASH_A
1b60: 49 43 48 2c 0a 20 20 52 48 41 53 48 5f 57 48 49  ICH,.  RHASH_WHI
1b70: 52 4c 50 4f 4f 4c 2c 0a 20 20 52 48 41 53 48 5f  RLPOOL,.  RHASH_
1b80: 52 49 50 45 4d 44 31 36 30 2c 0a 20 20 52 48 41  RIPEMD160,.  RHA
1b90: 53 48 5f 47 4f 53 54 2c 0a 20 20 52 48 41 53 48  SH_GOST,.  RHASH
1ba0: 5f 47 4f 53 54 5f 43 52 59 50 54 4f 50 52 4f 2c  _GOST_CRYPTOPRO,
1bb0: 0a 20 20 52 48 41 53 48 5f 48 41 53 31 36 30 2c  .  RHASH_HAS160,
1bc0: 0a 20 20 52 48 41 53 48 5f 53 4e 45 46 52 55 31  .  RHASH_SNEFRU1
1bd0: 32 38 2c 0a 20 20 52 48 41 53 48 5f 53 4e 45 46  28,.  RHASH_SNEF
1be0: 52 55 32 35 36 2c 0a 20 20 52 48 41 53 48 5f 53  RU256,.  RHASH_S
1bf0: 48 41 32 32 34 2c 0a 20 20 52 48 41 53 48 5f 53  HA224,.  RHASH_S
1c00: 48 41 32 35 36 2c 0a 20 20 52 48 41 53 48 5f 53  HA256,.  RHASH_S
1c10: 48 41 33 38 34 2c 0a 20 20 52 48 41 53 48 5f 53  HA384,.  RHASH_S
1c20: 48 41 35 31 32 2c 0a 20 20 52 48 41 53 48 5f 53  HA512,.  RHASH_S
1c30: 48 41 33 5f 32 32 34 2c 0a 20 20 52 48 41 53 48  HA3_224,.  RHASH
1c40: 5f 53 48 41 33 5f 32 35 36 2c 0a 20 20 52 48 41  _SHA3_256,.  RHA
1c50: 53 48 5f 53 48 41 33 5f 33 38 34 2c 0a 20 20 52  SH_SHA3_384,.  R
1c60: 48 41 53 48 5f 53 48 41 33 5f 35 31 32 2c 0a 20  HASH_SHA3_512,. 
1c70: 20 52 48 41 53 48 5f 45 44 4f 4e 52 32 35 36 2c   RHASH_EDONR256,
1c80: 0a 20 20 52 48 41 53 48 5f 45 44 4f 4e 52 35 31  .  RHASH_EDONR51
1c90: 32 0a 0a 41 6c 73 6f 20 74 68 65 20 52 48 41 53  2..Also the RHAS
1ca0: 48 5f 41 4c 4c 20 62 69 74 20 6d 61 73 6b 20 69  H_ALL bit mask i
1cb0: 73 20 74 68 65 20 75 6e 69 6f 6e 20 6f 66 20 61  s the union of a
1cc0: 6c 6c 20 6c 69 73 74 65 64 20 62 69 74 2d 66 6c  ll listed bit-fl
1cd0: 61 67 73 2e 0a 53 6f 20 74 68 65 20 6f 62 6a 65  ags..So the obje
1ce0: 63 74 20 63 72 65 61 74 65 64 20 76 69 61 20 43  ct created via C
1cf0: 72 79 70 74 3a 3a 52 68 61 73 68 2d 3e 6e 65 77  rypt::Rhash->new
1d00: 28 52 48 41 53 48 5f 41 4c 4c 29 20 63 61 6c 63  (RHASH_ALL) calc
1d10: 75 6c 61 74 65 73 20 61 6c 6c 0a 73 75 70 70 6f  ulates all.suppo
1d20: 72 74 65 64 20 68 61 73 68 20 66 75 6e 63 74 69  rted hash functi
1d30: 6f 6e 73 20 66 6f 72 20 74 68 65 20 73 61 6d 65  ons for the same
1d40: 20 64 61 74 61 2e 0a 0a 3d 68 65 61 64 31 20 43   data...=head1 C
1d50: 4f 4d 50 55 54 49 4e 47 20 48 41 53 48 45 53 0a  OMPUTING HASHES.
1d60: 0a 3d 6f 76 65 72 0a 0a 3d 69 74 65 6d 20 24 72  .=over..=item $r
1d70: 68 61 73 68 2d 3e 75 70 64 61 74 65 28 20 24 6d  hash->update( $m
1d80: 73 67 20 29 0a 0a 43 61 6c 63 75 6c 61 74 65 73  sg )..Calculates
1d90: 20 68 61 73 68 65 73 20 6f 66 20 74 68 65 20 24   hashes of the $
1da0: 6d 73 67 20 73 74 72 69 6e 67 2e 0a 54 68 65 20  msg string..The 
1db0: 6d 65 74 68 6f 64 20 63 61 6e 20 62 65 20 63 61  method can be ca
1dc0: 6c 6c 65 64 20 72 65 70 65 61 74 65 64 6c 79 20  lled repeatedly 
1dd0: 77 69 74 68 20 63 68 75 6e 6b 73 20 6f 66 20 74  with chunks of t
1de0: 68 65 20 6d 65 73 73 61 67 65 20 74 6f 20 62 65  he message to be
1df0: 20 68 61 73 68 65 64 2e 0a 49 74 20 72 65 74 75   hashed..It retu
1e00: 72 6e 73 20 74 68 65 20 24 72 68 61 73 68 20 6f  rns the $rhash o
1e10: 62 6a 65 63 74 20 69 74 73 65 6c 66 20 61 6c 6c  bject itself all
1e20: 6f 77 69 6e 67 20 74 68 65 20 66 6f 6c 6c 6f 77  owing the follow
1e30: 69 6e 67 20 63 6f 6e 73 74 72 75 63 74 69 6f 6e  ing construction
1e40: 3a 0a 0a 20 20 24 72 68 61 73 68 20 3d 20 43 72  :..  $rhash = Cr
1e50: 79 70 74 3a 3a 52 68 61 73 68 2d 3e 6e 65 77 28  ypt::Rhash->new(
1e60: 52 48 41 53 48 5f 4d 44 35 29 2d 3e 75 70 64 61  RHASH_MD5)->upda
1e70: 74 65 28 20 24 63 68 75 6e 6b 31 20 29 2d 3e 75  te( $chunk1 )->u
1e80: 70 64 61 74 65 28 20 24 63 68 75 6e 6b 32 20 29  pdate( $chunk2 )
1e90: 3b 0a 0a 3d 69 74 65 6d 20 24 72 68 61 73 68 2d  ;..=item $rhash-
1ea0: 3e 75 70 64 61 74 65 5f 66 69 6c 65 28 20 24 66  >update_file( $f
1eb0: 69 6c 65 5f 70 61 74 68 2c 20 24 73 74 61 72 74  ile_path, $start
1ec0: 2c 20 24 73 69 7a 65 20 29 0a 0a 3d 69 74 65 6d  , $size )..=item
1ed0: 20 24 72 68 61 73 68 2d 3e 75 70 64 61 74 65 5f   $rhash->update_
1ee0: 66 64 28 20 24 66 64 2c 20 24 73 74 61 72 74 2c  fd( $fd, $start,
1ef0: 20 24 73 69 7a 65 20 29 0a 0a 43 61 6c 63 75 6c   $size )..Calcul
1f00: 61 74 65 20 61 20 68 61 73 68 20 6f 66 20 74 68  ate a hash of th
1f10: 65 20 66 69 6c 65 20 28 6f 72 20 69 74 73 20 70  e file (or its p
1f20: 61 72 74 29 20 73 70 65 63 69 66 69 65 64 20 62  art) specified b
1f30: 79 20 24 66 69 6c 65 5f 70 61 74 68 20 6f 72 20  y $file_path or 
1f40: 61 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  a file descripto
1f50: 72 20 24 66 64 2e 0a 54 68 65 20 75 70 64 61 74  r $fd..The updat
1f60: 65 5f 66 64 20 6d 65 74 68 6f 64 20 64 6f 65 73  e_fd method does
1f70: 6e 27 74 20 63 6c 6f 73 65 20 74 68 65 20 24 66  n't close the $f
1f80: 64 2c 20 6c 65 61 76 69 6e 67 20 74 68 65 20 66  d, leaving the f
1f90: 69 6c 65 20 70 6f 73 69 74 69 6f 6e 20 61 66 74  ile position aft
1fa0: 65 72 20 74 68 65 20 68 61 73 68 65 64 20 62 6c  er the hashed bl
1fb0: 6f 63 6b 2e 0a 54 68 65 20 6f 70 74 69 6f 6e 61  ock..The optiona
1fc0: 6c 20 24 73 74 61 72 74 20 61 6e 64 20 24 73 69  l $start and $si
1fd0: 7a 65 20 73 70 65 63 69 66 79 20 74 68 65 20 62  ze specify the b
1fe0: 6c 6f 63 6b 20 6f 66 20 74 68 65 20 66 69 6c 65  lock of the file
1ff0: 20 74 6f 20 68 61 73 68 2e 0a 4e 6f 20 65 72 72   to hash..No err
2000: 6f 72 20 69 73 20 72 65 70 6f 72 74 65 64 20 69  or is reported i
2010: 66 20 74 68 65 20 24 73 69 7a 65 20 69 73 20 67  f the $size is g
2020: 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20  reater than the 
2030: 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 75 6e  number of the un
2040: 72 65 61 64 20 62 79 74 65 73 20 6c 65 66 74 20  read bytes left 
2050: 69 6e 20 74 68 65 20 66 69 6c 65 2e 0a 0a 52 65  in the file...Re
2060: 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72  turns the number
2070: 20 6f 66 20 63 68 61 72 61 63 74 65 72 73 20 61   of characters a
2080: 63 74 75 61 6c 6c 79 20 72 65 61 64 2c 20 30 20  ctually read, 0 
2090: 61 74 20 65 6e 64 20 6f 66 20 66 69 6c 65 2c 20  at end of file, 
20a0: 0a 6f 72 20 75 6e 64 65 66 20 69 66 20 74 68 65  .or undef if the
20b0: 72 65 20 77 61 73 20 61 6e 20 65 72 72 6f 72 20  re was an error 
20c0: 28 69 6e 20 74 68 65 20 6c 61 74 74 65 72 20 63  (in the latter c
20d0: 61 73 65 20 24 21 20 69 73 20 61 6c 73 6f 20 73  ase $! is also s
20e0: 65 74 29 2e 0a 0a 20 20 75 73 65 20 43 72 79 70  et)...  use Cryp
20f0: 74 3a 3a 52 68 61 73 68 3b 0a 20 20 6d 79 20 24  t::Rhash;.  my $
2100: 72 20 3d 20 6e 65 77 20 43 72 79 70 74 3a 3a 52  r = new Crypt::R
2110: 68 61 73 68 28 52 48 41 53 48 5f 53 48 41 31 29  hash(RHASH_SHA1)
2120: 3b 0a 20 20 6f 70 65 6e 28 6d 79 20 24 66 64 2c  ;.  open(my $fd,
2130: 20 22 3c 22 2c 20 22 69 6e 70 75 74 2e 74 78 74   "<", "input.txt
2140: 22 29 20 6f 72 20 64 69 65 20 22 63 61 6e 6e 6f  ") or die "canno
2150: 74 20 6f 70 65 6e 20 3c 20 69 6e 70 75 74 2e 74  t open < input.t
2160: 78 74 3a 20 24 21 22 3b 0a 20 20 77 68 69 6c 65  xt: $!";.  while
2170: 20 28 28 6d 79 20 24 6e 20 3d 20 24 72 2d 3e 75   ((my $n = $r->u
2180: 70 64 61 74 65 5f 66 64 28 24 66 64 2c 20 75 6e  pdate_fd($fd, un
2190: 64 65 66 2c 20 31 30 32 34 29 20 21 3d 20 30 29  def, 1024) != 0)
21a0: 29 20 7b 0a 20 20 20 20 20 20 70 72 69 6e 74 20  ) {.      print 
21b0: 22 24 6e 20 62 79 74 65 73 20 68 61 73 68 65 64  "$n bytes hashed
21c0: 2e 20 54 68 65 20 53 48 41 31 20 68 61 73 68 20  . The SHA1 hash 
21d0: 69 73 20 22 20 2e 20 24 72 2d 3e 66 69 6e 61 6c  is " . $r->final
21e0: 28 29 2d 3e 68 61 73 68 28 29 20 2e 20 22 5c 6e  ()->hash() . "\n
21f0: 22 3b 0a 20 20 20 20 20 20 24 72 2d 3e 72 65 73  ";.      $r->res
2200: 65 74 28 29 3b 0a 20 20 7d 0a 20 20 64 65 66 69  et();.  }.  defi
2210: 6e 65 64 28 24 6e 29 20 6f 72 20 64 69 65 20 22  ned($n) or die "
2220: 72 65 61 64 20 65 72 72 6f 72 20 66 6f 72 20 69  read error for i
2230: 6e 70 75 74 2e 74 78 74 3a 20 24 21 22 3b 0a 20  nput.txt: $!";. 
2240: 20 63 6c 6f 73 65 28 24 66 64 29 3b 0a 0a 3d 69   close($fd);..=i
2250: 74 65 6d 20 24 72 68 61 73 68 2d 3e 66 69 6e 61  tem $rhash->fina
2260: 6c 28 29 0a 0a 46 69 6e 69 73 68 65 73 20 63 61  l()..Finishes ca
2270: 6c 63 75 6c 61 74 69 6f 6e 20 66 6f 72 20 61 6c  lculation for al
2280: 6c 20 64 61 74 61 20 62 75 66 66 65 72 65 64 20  l data buffered 
2290: 62 79 20 75 70 64 61 74 69 6e 67 20 6d 65 74 68  by updating meth
22a0: 6f 64 73 20 61 6e 64 20 73 74 6f 70 73 20 68 61  ods and stops ha
22b0: 73 68 0a 63 61 6c 63 75 6c 61 74 69 6f 6e 2e 20  sh.calculation. 
22c0: 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  The function is 
22d0: 63 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74 69 63  called automatic
22e0: 61 6c 6c 79 20 62 79 20 61 6e 79 20 6f 66 20 74  ally by any of t
22f0: 68 65 20 0a 24 72 68 61 73 68 2d 3e 68 61 73 68  he .$rhash->hash
2300: 2a 28 29 20 6d 65 74 68 6f 64 73 20 69 66 20 74  *() methods if t
2310: 68 65 20 66 69 6e 61 6c 28 29 20 63 61 6c 6c 20  he final() call 
2320: 77 61 73 20 73 6b 69 70 70 65 64 2e 0a 0a 3d 69  was skipped...=i
2330: 74 65 6d 20 24 72 68 61 73 68 2d 3e 72 65 73 65  tem $rhash->rese
2340: 74 28 29 0a 0a 52 65 73 65 74 73 20 74 68 65 20  t()..Resets the 
2350: 24 72 68 61 73 68 20 6f 62 6a 65 63 74 20 74 6f  $rhash object to
2360: 20 74 68 65 20 69 6e 69 74 69 61 6c 20 73 74 61   the initial sta
2370: 74 65 2e 0a 0a 3d 69 74 65 6d 20 24 72 68 61 73  te...=item $rhas
2380: 68 2d 3e 68 61 73 68 65 64 5f 6c 65 6e 67 74 68  h->hashed_length
2390: 28 29 0a 0a 52 65 74 75 72 6e 73 20 74 68 65 20  ()..Returns the 
23a0: 74 6f 74 61 6c 20 6c 65 6e 67 74 68 20 6f 66 20  total length of 
23b0: 74 68 65 20 68 61 73 68 65 64 20 6d 65 73 73 61  the hashed messa
23c0: 67 65 2e 0a 0a 3d 69 74 65 6d 20 24 72 68 61 73  ge...=item $rhas
23d0: 68 2d 3e 68 61 73 68 5f 69 64 28 29 0a 0a 52 65  h->hash_id()..Re
23e0: 74 75 72 6e 73 20 74 68 65 20 68 61 73 68 20 6d  turns the hash m
23f0: 61 73 6b 2c 20 74 68 65 20 24 72 68 61 73 68 20  ask, the $rhash 
2400: 6f 62 6a 65 63 74 20 77 61 73 20 63 6f 6e 73 74  object was const
2410: 72 75 63 74 65 64 20 77 69 74 68 2e 0a 0a 3d 62  ructed with...=b
2420: 61 63 6b 0a 0a 3d 68 65 61 64 31 20 46 4f 52 4d  ack..=head1 FORM
2430: 41 54 54 49 4e 47 20 48 41 53 48 20 56 41 4c 55  ATTING HASH VALU
2440: 45 0a 0a 43 6f 6d 70 75 74 65 64 20 68 61 73 68  E..Computed hash
2450: 20 63 61 6e 20 62 65 20 66 6f 72 6d 61 74 74 65   can be formatte
2460: 64 20 61 73 20 61 20 68 65 78 61 64 65 63 69 6d  d as a hexadecim
2470: 61 6c 20 73 74 72 69 6e 67 20 28 69 6e 20 74 68  al string (in th
2480: 65 20 66 6f 72 77 61 72 64 20 6f 72 0a 72 65 76  e forward or.rev
2490: 65 72 73 65 20 62 79 74 65 20 6f 72 64 65 72 29  erse byte order)
24a0: 2c 20 61 20 62 61 73 65 33 32 2f 62 61 73 65 36  , a base32/base6
24b0: 34 2d 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67  4-encoded string
24c0: 20 6f 72 20 61 73 20 72 61 77 20 62 69 6e 61 72   or as raw binar
24d0: 79 20 64 61 74 61 2e 0a 0a 3d 6f 76 65 72 0a 0a  y data...=over..
24e0: 3d 69 74 65 6d 20 24 72 68 61 73 68 2d 3e 68 61  =item $rhash->ha
24f0: 73 68 28 20 24 68 61 73 68 5f 69 64 20 29 0a 0a  sh( $hash_id )..
2500: 52 65 74 75 72 6e 73 20 74 68 65 20 68 61 73 68  Returns the hash
2510: 20 73 74 72 69 6e 67 20 69 6e 20 74 68 65 20 64   string in the d
2520: 65 66 61 75 6c 74 20 66 6f 72 6d 61 74 2c 0a 77  efault format,.w
2530: 68 69 63 68 20 63 61 6e 20 62 65 20 68 65 78 61  hich can be hexa
2540: 64 65 63 69 6d 61 6c 20 6f 72 20 62 61 73 65 33  decimal or base3
2550: 32 2e 20 41 63 74 75 61 6c 6c 79 20 74 68 65 20  2. Actually the 
2560: 6d 65 74 68 6f 64 20 69 73 20 65 71 75 69 76 61  method is equiva
2570: 6c 65 6e 74 20 6f 66 0a 0a 20 20 28 43 72 79 70  lent of..  (Cryp
2580: 74 3a 3a 52 68 61 73 68 3a 3a 69 73 5f 62 61 73  t::Rhash::is_bas
2590: 65 33 32 28 24 68 61 73 68 5f 69 64 29 20 3f 20  e32($hash_id) ? 
25a0: 24 72 68 61 73 68 2d 3e 68 61 73 68 5f 62 61 73  $rhash->hash_bas
25b0: 65 33 32 28 24 68 61 73 68 5f 69 64 29 20 3a 0a  e32($hash_id) :.
25c0: 20 20 20 20 24 72 68 61 73 68 2d 3e 68 61 73 68      $rhash->hash
25d0: 5f 68 65 78 28 24 68 61 73 68 5f 69 64 29 29 0a  _hex($hash_id)).
25e0: 0a 49 66 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c  .If the optional
25f0: 20 24 68 61 73 68 5f 69 64 20 70 61 72 61 6d 65   $hash_id parame
2600: 74 65 72 20 69 73 20 6f 6d 69 74 74 65 64 20 6f  ter is omitted o
2610: 72 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65  r zero, then the
2620: 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73 20   method returns 
2630: 74 68 65 20 68 61 73 68 0a 66 6f 72 20 74 68 65  the hash.for the
2640: 20 61 6c 67 6f 72 69 74 68 6d 20 63 6f 6e 74 61   algorithm conta
2650: 69 6e 65 64 20 69 6e 20 24 72 68 61 73 68 20 77  ined in $rhash w
2660: 69 74 68 20 74 68 65 20 6c 6f 77 65 73 74 20 69  ith the lowest i
2670: 64 65 6e 74 69 66 69 65 72 2e 0a 0a 3d 69 74 65  dentifier...=ite
2680: 6d 20 24 72 68 61 73 68 2d 3e 68 61 73 68 5f 68  m $rhash->hash_h
2690: 65 78 28 20 24 68 61 73 68 5f 69 64 20 29 0a 0a  ex( $hash_id )..
26a0: 52 65 74 75 72 6e 73 20 74 68 65 20 73 70 65 63  Returns the spec
26b0: 69 66 69 65 64 20 68 61 73 68 20 69 6e 20 74 68  ified hash in th
26c0: 65 20 68 65 78 61 64 65 63 69 6d 61 6c 20 66 6f  e hexadecimal fo
26d0: 72 6d 61 74 2e 0a 0a 20 20 75 73 65 20 43 72 79  rmat...  use Cry
26e0: 70 74 3a 3a 52 68 61 73 68 3b 0a 20 20 6d 79 20  pt::Rhash;.  my 
26f0: 24 6d 73 67 20 3d 20 22 61 62 63 22 3b 0a 20 20  $msg = "abc";.  
2700: 70 72 69 6e 74 20 22 4d 44 35 20 3d 20 22 20 2e  print "MD5 = " .
2710: 20 43 72 79 70 74 3a 3a 52 68 61 73 68 2d 3e 6e   Crypt::Rhash->n
2720: 65 77 28 52 48 41 53 48 5f 4d 44 35 29 2d 3e 75  ew(RHASH_MD5)->u
2730: 70 64 61 74 65 28 24 6d 73 67 29 2d 3e 68 61 73  pdate($msg)->has
2740: 68 5f 68 65 78 28 29 20 2e 20 22 5c 6e 22 3b 0a  h_hex() . "\n";.
2750: 0a 3d 69 74 65 6d 20 24 72 68 61 73 68 2d 3e 68  .=item $rhash->h
2760: 61 73 68 5f 72 68 65 78 28 20 24 68 61 73 68 5f  ash_rhex( $hash_
2770: 69 64 20 29 0a 0a 52 65 74 75 72 6e 73 20 74 68  id )..Returns th
2780: 65 20 73 70 65 63 69 66 69 65 64 20 68 61 73 68  e specified hash
2790: 20 69 6e 20 74 68 65 20 68 65 78 61 64 65 63 69   in the hexadeci
27a0: 6d 61 6c 20 66 6f 72 6d 61 74 20 77 69 74 68 20  mal format with 
27b0: 72 65 76 65 72 73 65 64 20 6f 72 64 65 72 20 6f  reversed order o
27c0: 66 20 62 79 74 65 73 2e 0a 53 6f 6d 65 20 70 72  f bytes..Some pr
27d0: 6f 67 72 61 6d 73 20 70 72 65 66 65 72 20 74 6f  ograms prefer to
27e0: 20 6f 75 74 70 75 74 20 74 68 65 20 47 4f 53 54   output the GOST
27f0: 20 52 20 33 34 2e 31 31 2d 39 34 20 68 61 73 68   R 34.11-94 hash
2800: 20 69 6e 20 74 68 69 73 20 66 6f 72 6d 61 74 2e   in this format.
2810: 0a 0a 3d 69 74 65 6d 20 24 72 68 61 73 68 2d 3e  ..=item $rhash->
2820: 68 61 73 68 5f 62 61 73 65 33 32 28 20 24 68 61  hash_base32( $ha
2830: 73 68 5f 69 64 20 29 0a 0a 52 65 74 75 72 6e 73  sh_id )..Returns
2840: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 68   the specified h
2850: 61 73 68 20 69 6e 20 74 68 65 20 62 61 73 65 33  ash in the base3
2860: 32 20 66 6f 72 6d 61 74 2e 0a 0a 3d 69 74 65 6d  2 format...=item
2870: 20 24 72 68 61 73 68 2d 3e 68 61 73 68 5f 62 61   $rhash->hash_ba
2880: 73 65 36 34 28 20 24 68 61 73 68 5f 69 64 20 29  se64( $hash_id )
2890: 0a 0a 52 65 74 75 72 6e 73 20 74 68 65 20 73 70  ..Returns the sp
28a0: 65 63 69 66 69 65 64 20 68 61 73 68 20 69 6e 20  ecified hash in 
28b0: 74 68 65 20 62 61 73 65 36 34 20 66 6f 72 6d 61  the base64 forma
28c0: 74 2e 0a 0a 3d 69 74 65 6d 20 24 72 68 61 73 68  t...=item $rhash
28d0: 2d 3e 6d 61 67 6e 65 74 5f 6c 69 6e 6b 28 20 24  ->magnet_link( $
28e0: 66 69 6c 65 6e 61 6d 65 2c 20 24 68 61 73 68 5f  filename, $hash_
28f0: 6d 61 73 6b 20 29 0a 0a 52 65 74 75 72 6e 73 20  mask )..Returns 
2900: 74 68 65 20 6d 61 67 6e 65 74 20 6c 69 6e 6b 20  the magnet link 
2910: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63  containing the c
2920: 6f 6d 70 75 74 65 64 20 68 61 73 68 65 73 2c 20  omputed hashes, 
2930: 66 69 6c 65 73 69 7a 65 2c 20 61 6e 64 2c 0a 6f  filesize, and,.o
2940: 70 74 69 6f 6e 61 6c 79 2c 20 24 66 69 6c 65 6e  ptionaly, $filen
2950: 61 6d 65 2e 20 54 68 65 20 24 66 69 6c 65 6e 61  ame. The $filena
2960: 6d 65 20 28 69 66 20 73 70 65 63 69 66 69 65 64  me (if specified
2970: 29 20 69 73 20 55 52 4c 2d 65 6e 63 6f 64 65 64  ) is URL-encoded
2980: 2c 0a 62 79 20 63 6f 6e 76 65 72 74 69 6e 67 20  ,.by converting 
2990: 73 70 65 63 69 61 6c 20 63 68 61 72 61 63 74 65  special characte
29a0: 72 73 20 69 6e 74 6f 20 74 68 65 20 25 3c 68 65  rs into the %<he
29b0: 78 61 64 65 63 69 6d 61 6c 2d 63 6f 64 65 3e 20  xadecimal-code> 
29c0: 66 6f 72 6d 2e 0a 54 68 65 20 6f 70 74 69 6f 6e  form..The option
29d0: 61 6c 20 70 61 72 61 6d 65 74 65 72 20 24 68 61  al parameter $ha
29e0: 73 68 5f 6d 61 73 6b 20 63 61 6e 20 6c 69 6d 69  sh_mask can limi
29f0: 74 20 77 68 69 63 68 20 68 61 73 68 20 76 61 6c  t which hash val
2a00: 75 65 73 20 74 6f 20 70 75 74 0a 69 6e 74 6f 20  ues to put.into 
2a10: 74 68 65 20 6c 69 6e 6b 2e 0a 0a 3d 62 61 63 6b  the link...=back
2a20: 0a 0a 3d 68 65 61 64 31 20 53 54 41 54 49 43 20  ..=head1 STATIC 
2a30: 4d 45 54 48 4f 44 53 0a 0a 3d 6f 76 65 72 0a 0a  METHODS..=over..
2a40: 3d 69 74 65 6d 20 43 72 79 70 74 3a 3a 52 68 61  =item Crypt::Rha
2a50: 73 68 3a 3a 63 6f 75 6e 74 28 29 0a 0a 52 65 74  sh::count()..Ret
2a60: 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20  urns the number 
2a70: 6f 66 20 73 75 70 70 6f 72 74 65 64 20 68 61 73  of supported has
2a80: 68 20 61 6c 67 6f 72 69 74 68 6d 73 0a 0a 3d 69  h algorithms..=i
2a90: 74 65 6d 20 43 72 79 70 74 3a 3a 52 68 61 73 68  tem Crypt::Rhash
2aa0: 3a 3a 69 73 5f 62 61 73 65 33 32 28 24 68 61 73  ::is_base32($has
2ab0: 68 5f 69 64 29 0a 0a 52 65 74 75 72 6e 73 20 6e  h_id)..Returns n
2ac0: 6f 6e 7a 65 72 6f 20 69 66 20 64 65 66 61 75 6c  onzero if defaul
2ad0: 74 20 6f 75 74 70 75 74 20 66 6f 72 6d 61 74 20  t output format 
2ae0: 69 73 20 42 61 73 65 33 32 20 66 6f 72 20 74 68  is Base32 for th
2af0: 65 20 68 61 73 68 20 66 75 6e 63 74 69 6f 6e 20  e hash function 
2b00: 73 70 65 63 69 66 69 65 64 20 62 79 20 24 68 61  specified by $ha
2b10: 73 68 5f 69 64 2e 0a 52 65 74 75 72 6e 73 20 7a  sh_id..Returns z
2b20: 65 72 6f 20 69 66 20 64 65 66 61 75 6c 74 20 66  ero if default f
2b30: 6f 72 6d 61 74 20 69 73 20 68 65 78 61 64 65 63  ormat is hexadec
2b40: 69 6d 61 6c 2e 0a 0a 3d 69 74 65 6d 20 43 72 79  imal...=item Cry
2b50: 70 74 3a 3a 52 68 61 73 68 3a 3a 67 65 74 5f 64  pt::Rhash::get_d
2b60: 69 67 65 73 74 5f 73 69 7a 65 28 24 68 61 73 68  igest_size($hash
2b70: 5f 69 64 29 0a 0a 52 65 74 75 72 6e 73 20 74 68  _id)..Returns th
2b80: 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20  e size in bytes 
2b90: 6f 66 20 72 61 77 20 62 69 6e 61 72 79 20 68 61  of raw binary ha
2ba0: 73 68 20 6f 66 20 74 68 65 20 73 70 65 63 69 66  sh of the specif
2bb0: 69 65 64 20 68 61 73 68 20 61 6c 67 6f 72 69 74  ied hash algorit
2bc0: 68 6d 2e 0a 0a 3d 69 74 65 6d 20 43 72 79 70 74  hm...=item Crypt
2bd0: 3a 3a 52 68 61 73 68 3a 3a 67 65 74 5f 68 61 73  ::Rhash::get_has
2be0: 68 5f 6c 65 6e 67 74 68 28 24 68 61 73 68 5f 69  h_length($hash_i
2bf0: 64 29 0a 0a 52 65 74 75 72 6e 73 20 74 68 65 20  d)..Returns the 
2c00: 6c 65 6e 67 74 68 20 6f 66 20 61 20 68 61 73 68  length of a hash
2c10: 20 73 74 72 69 6e 67 20 69 6e 20 64 65 66 61 75   string in defau
2c20: 6c 74 20 6f 75 74 70 75 74 20 66 6f 72 6d 61 74  lt output format
2c30: 20 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69   for the specifi
2c40: 65 64 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68  ed hash algorith
2c50: 6d 2e 0a 0a 3d 69 74 65 6d 20 43 72 79 70 74 3a  m...=item Crypt:
2c60: 3a 52 68 61 73 68 3a 3a 67 65 74 5f 6e 61 6d 65  :Rhash::get_name
2c70: 28 24 68 61 73 68 5f 69 64 29 0a 0a 52 65 74 75  ($hash_id)..Retu
2c80: 72 6e 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  rns the name of 
2c90: 74 68 65 20 73 70 65 63 69 66 69 65 64 20 68 61  the specified ha
2ca0: 73 68 20 61 6c 67 6f 72 69 74 68 6d 2e 0a 0a 3d  sh algorithm...=
2cb0: 62 61 63 6b 0a 0a 3d 68 65 61 64 31 20 41 4c 54  back..=head1 ALT
2cc0: 45 52 4e 41 54 49 56 45 20 57 41 59 20 54 4f 20  ERNATIVE WAY TO 
2cd0: 43 4f 4d 50 55 54 45 20 48 41 53 48 0a 0a 3d 6f  COMPUTE HASH..=o
2ce0: 76 65 72 0a 0a 3d 69 74 65 6d 20 43 72 79 70 74  ver..=item Crypt
2cf0: 3a 3a 52 68 61 73 68 3a 3a 6d 73 67 28 24 68 61  ::Rhash::msg($ha
2d00: 73 68 5f 69 64 2c 20 24 6d 65 73 73 61 67 65 29  sh_id, $message)
2d10: 0a 0a 43 6f 6d 70 75 74 65 73 20 61 6e 64 20 72  ..Computes and r
2d20: 65 74 75 72 6e 73 20 61 20 73 69 6e 67 6c 65 20  eturns a single 
2d30: 68 61 73 68 20 28 69 6e 20 69 74 73 20 64 65 66  hash (in its def
2d40: 61 75 6c 74 20 66 6f 72 6d 61 74 29 20 6f 66 20  ault format) of 
2d50: 74 68 65 20 24 6d 65 73 73 61 67 65 20 62 79 20  the $message by 
2d60: 74 68 65 20 73 65 6c 65 63 74 65 64 20 68 61 73  the selected has
2d70: 68 20 61 6c 67 6f 72 69 74 68 6d 2e 0a 0a 20 20  h algorithm...  
2d80: 75 73 65 20 43 72 79 70 74 3a 3a 52 68 61 73 68  use Crypt::Rhash
2d90: 3b 0a 20 20 70 72 69 6e 74 20 22 53 48 41 31 28  ;.  print "SHA1(
2da0: 20 27 61 62 63 27 20 29 20 3d 20 22 20 2e 20 43   'abc' ) = " . C
2db0: 72 79 70 74 3a 3a 52 68 61 73 68 3a 3a 6d 73 67  rypt::Rhash::msg
2dc0: 28 52 48 41 53 48 5f 53 48 41 31 2c 20 22 61 62  (RHASH_SHA1, "ab
2dd0: 63 22 29 20 2e 20 22 5c 6e 22 3b 0a 0a 3d 62 61  c") . "\n";..=ba
2de0: 63 6b 0a 0a 3d 68 65 61 64 31 20 4c 49 43 45 4e  ck..=head1 LICEN
2df0: 53 45 0a 0a 20 50 65 72 6d 69 73 73 69 6f 6e 20  SE.. Permission 
2e00: 69 73 20 68 65 72 65 62 79 20 67 72 61 6e 74 65  is hereby grante
2e10: 64 2c 20 66 72 65 65 20 6f 66 20 63 68 61 72 67  d, free of charg
2e20: 65 2c 20 20 74 6f 20 61 6e 79 20 70 65 72 73 6f  e,  to any perso
2e30: 6e 20 6f 62 74 61 69 6e 69 6e 67 20 61 20 63 6f  n obtaining a co
2e40: 70 79 0a 20 6f 66 20 74 68 69 73 20 73 6f 66 74  py. of this soft
2e50: 77 61 72 65 20 61 6e 64 20 61 73 73 6f 63 69 61  ware and associa
2e60: 74 65 64 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f  ted documentatio
2e70: 6e 20 66 69 6c 65 73 20 28 74 68 65 20 22 53 6f  n files (the "So
2e80: 66 74 77 61 72 65 22 29 2c 20 74 6f 20 64 65 61  ftware"), to dea
2e90: 6c 0a 20 69 6e 20 74 68 65 20 53 6f 66 74 77 61  l. in the Softwa
2ea0: 72 65 20 77 69 74 68 6f 75 74 20 72 65 73 74 72  re without restr
2eb0: 69 63 74 69 6f 6e 2c 20 20 69 6e 63 6c 75 64 69  iction,  includi
2ec0: 6e 67 20 77 69 74 68 6f 75 74 20 6c 69 6d 69 74  ng without limit
2ed0: 61 74 69 6f 6e 20 74 68 65 20 72 69 67 68 74 73  ation the rights
2ee0: 0a 20 74 6f 20 20 75 73 65 2c 20 20 63 6f 70 79  . to  use,  copy
2ef0: 2c 20 20 6d 6f 64 69 66 79 2c 20 20 6d 65 72 67  ,  modify,  merg
2f00: 65 2c 20 70 75 62 6c 69 73 68 2c 20 64 69 73 74  e, publish, dist
2f10: 72 69 62 75 74 65 2c 20 73 75 62 6c 69 63 65 6e  ribute, sublicen
2f20: 73 65 2c 20 61 6e 64 2f 6f 72 20 73 65 6c 6c 0a  se, and/or sell.
2f30: 20 63 6f 70 69 65 73 20 20 6f 66 20 20 74 68 65   copies  of  the
2f40: 20 53 6f 66 74 77 61 72 65 2c 20 20 61 6e 64 20   Software,  and 
2f50: 20 74 6f 20 70 65 72 6d 69 74 20 20 70 65 72 73   to permit  pers
2f60: 6f 6e 73 20 20 74 6f 20 77 68 6f 6d 20 20 74 68  ons  to whom  th
2f70: 65 20 53 6f 66 74 77 61 72 65 20 20 69 73 0a 20  e Software  is. 
2f80: 66 75 72 6e 69 73 68 65 64 20 74 6f 20 64 6f 20  furnished to do 
2f90: 73 6f 2e 0a 0a 20 54 68 65 20 53 6f 66 74 77 61  so... The Softwa
2fa0: 72 65 20 20 69 73 20 64 69 73 74 72 69 62 75 74  re  is distribut
2fb0: 65 64 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74  ed in the hope t
2fc0: 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 75  hat it will be u
2fd0: 73 65 66 75 6c 2c 20 20 62 75 74 20 57 49 54 48  seful,  but WITH
2fe0: 4f 55 54 0a 20 41 4e 59 20 57 41 52 52 41 4e 54  OUT. ANY WARRANT
2ff0: 59 3b 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20  Y; without even 
3000: 74 68 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72  the implied warr
3010: 61 6e 74 79 20 6f 66 20 4d 45 52 43 48 41 4e 54  anty of MERCHANT
3020: 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e 45  ABILITY or FITNE
3030: 53 53 0a 20 46 4f 52 20 41 20 50 41 52 54 49 43  SS. FOR A PARTIC
3040: 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 55  ULAR PURPOSE.  U
3050: 73 65 20 20 74 68 69 73 20 20 70 72 6f 67 72 61  se  this  progra
3060: 6d 20 20 61 74 20 20 79 6f 75 72 20 20 6f 77 6e  m  at  your  own
3070: 20 20 72 69 73 6b 21 0a 0a 3d 63 75 74 0a          risk!..=cut.