digest::multihash(3pm) [debian man page]

Digest::MultiHash(3pm)					User Contributed Perl Documentation				    Digest::MultiHash(3pm)

NAME

       Digest::MultiHash - XOR based, variable width multiplexing of hashes (a generalized Digest::SV1).

SYNOPSIS

	       use Digest::MultiHash;

	       my $d = Digest::Multihash->new(
		       width => 16, # bytes
		       hashs => ["SHA-512", "Whirlpool"], # see below for arbitrary arguments
	       );

	       $d->add($data);

	       print $d->hexdigest;

DESCRIPTION

       This class inherits from Digest::base, and provides generalized digest multiplexing.

       It will multiplex all calls to "add" to all of it's sub digest objects.	Likewise, when the final digest is extracted the digests will be
       extracted and then XOR'd over eachother according to "width".

       "width" will default to the width of the first hash if unspecified.

       "hashes" defaults to "SHA-1" for compatibility reasons.

       This module is useful for generating keys from passphrases, by supplying the desired width and simply making sure there is enough data from
       the combined hashes.

METHODS

       See Digest for the complete API. This module inherits from Digest::base.

       new This methods accepts a hash reference or an even sized list of parameters named according to the methods.

       add
       digest
	   Compute the hash by calling "digest" on all of the subhashes, splitting the result up into "width" sized chunk, and then XORing these
	   together.

	   If the result is not aligned on "width" the result will not be truncated. The shorter string will still be XOR'd with the hash, even if
	   this only affects part of the result.

	   If there are not at least "width" bytes of data in the output of the combined hashes an error is thrown.

       clone
	   Clones the hash.

       hashes
	   Get the array of hashes to use. Array values in this will be dereferenced before the call to "new" in Digest to allow passing of
	   arbitrary arguments.  Blessed objects (of any class) will be used verbatim.

	   The list of hashes cannot be changed after construction.

       width
	   Get/set the byte-width to use.

SEE ALSO

       Digest, Digest::SV1, Digest::SHA1

perl v5.14.2							    2009-10-19						    Digest::MultiHash(3pm)

Digest::BubbleBabble(3pm)				User Contributed Perl Documentation				 Digest::BubbleBabble(3pm)

NAME

       Digest::BubbleBabble - Create bubble-babble fingerprints

SYNOPSIS

	   # Create a fingerprint of a simple string.
	   use Digest::BubbleBabble qw( bubblebabble );
	   my $fingerprint = bubblebabble( Digest => "Pineapple" );

	   # Create a fingerprint of a SHA-1 hash.
	   use Digest::SHA qw( sha1 );
	   $fingerprint = bubblebabble( Digest => sha1("hello") );

DESCRIPTION

       Digest::BubbleBabble takes a message digest (often generated by either of the MD5 or SHA-1 message digest algorithms) and creates a
       fingerprint of that digest in "bubble babble" format.  Bubble babble is a method of representing a message digest as a string of "real"
       words, to make the fingerprint easier to remember. The "words" are not necessarily real words, but they look more like words than a string
       of hex characters.

       Bubble babble fingerprinting is used by the SSH2 suite (and, consequently, by Net::SSH::Perl, the Perl SSH implementation) to display easy-
       to-remember key fingerprints.  The key (a DSA or RSA key) is converted into a textual form, digested using Digest::SHA, and run through
       bubblebabble to create the key fingerprint.

USAGE

       Digest::BubbleBabble conditionally exports one function called bubblebabble; to import the function you must choose to import it, like
       this:

	   use Digest::BubbleBabble qw( bubblebabble );

   bubblebabble( Digest => $digest )
       Currently takes only one pair of arguments, the key of which must be Digest, the value of which is the actual message digest $digest. You
       should generate this message digest yourself using either Digest::MD5 of Digest::SHA.

       Returns the bubble babble form of the digest.

SEE ALSO

       The BubbleBabble specification is available at: http://web.mit.edu/kenta/www/one/bubblebabble/spec/jrtrjwzi/draft-huima-01.txt

LICENSE

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

AUTHOR &; COPYRIGHTS
       Benjamin Trott, cpan@stupidfool.org

       Except where otherwise noted, Digest::BubbleBabble is Copyright 2001 Benjamin Trott. All rights reserved.

perl v5.14.2							    2012-01-21						 Digest::BubbleBabble(3pm)