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

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)

SHA1(3) 						User Contributed Perl Documentation						   SHA1(3)

NAME

       Digest::SHA1 - Perl interface to the SHA-1 Algorithm

SYNOPSIS

	# Functional style
	use Digest::SHA1  qw(sha1 sha1_hex sha1_base64);

	$digest = sha1($data);
	$digest = sha1_hex($data);
	$digest = sha1_base64($data);

	# OO style
	use Digest::SHA1;

	$ctx = Digest::SHA1->new;

	$ctx->add($data);
	$ctx->addfile(*FILE);

	$digest = $ctx->digest;
	$digest = $ctx->hexdigest;
	$digest = $ctx->b64digest;

DESCRIPTION

       The "Digest::SHA1" module allows you to use the NIST SHA-1 message digest algorithm from within Perl programs.  The algorithm takes as
       input a message of arbitrary length and produces as output a 160-bit "fingerprint" or "message digest" of the input.

       The "Digest::SHA1" module provide a procedural interface for simple use, as well as an object oriented interface that can handle messages
       of arbitrary length and which can read files directly.

       A binary digest will be 20 bytes long.  A hex digest will be 40 characters long.  A base64 digest will be 27 characters long.

FUNCTIONS

       The following functions can be exported from the "Digest::SHA1" module.	No functions are exported by default.

       sha1($data,...)
	   This function will concatenate all arguments, calculate the SHA-1 digest of this "message", and return it in binary form.

       sha1_hex($data,...)
	   Same as sha1(), but will return the digest in hexadecimal form.

       sha1_base64($data,...)
	   Same as sha1(), but will return the digest as a base64 encoded string.

METHODS

       The "Digest::SHA1" module provide the standard "Digest" OO-interface.  The constructor looks like this:

       $sha1 = Digest->new('SHA-1')
       $sha1 = Digest::SHA1->new
	   The constructor returns a new "Digest::SHA1" object which encapsulate the state of the SHA-1 message-digest algorithm.  You can add
	   data to the object and finally ask for the digest using the methods described in Digest.

SEE ALSO

       Digest, Digest::HMAC_SHA1, Digest::MD5

       http://www.itl.nist.gov/fipspubs/fip180-1.htm

COPYRIGHT

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

	Copyright 1999-2001 Gisle Aas.
	Copyright 1997 Uwe Hollerbach.

AUTHORS

       Peter C. Gutmann, Uwe Hollerbach <uh@alumni.caltech.edu>, Gisle Aas <gisle@aas.no>

perl v5.8.0							    2001-12-30								   SHA1(3)