README
1NAME
2 Digest::BubbleBabble - Create bubble-babble fingerprints
3
4SYNOPSIS
5 # Create a fingerprint of a simple string.
6 use Digest::BubbleBabble qw( bubblebabble );
7 my $fingerprint = bubblebabble( Digest => "Pineapple" );
8
9 # Create a fingerprint of a SHA-1 hash.
10 use Digest::SHA1 qw( sha1 );
11 $fingerprint = bubblebabble( Digest => sha1("hello") );
12
13DESCRIPTION
14 *Digest::BubbleBabble* takes a message digest (often generated by either
15 of the MD5 or SHA-1 message digest algorithms) and creates a fingerprint
16 of that digest in "bubble babble" format. Bubble babble is a method of
17 representing a message digest as a string of "real" words, to make the
18 fingerprint easier to remember. The "words" are not necessarily real
19 words, but they look more like words than a string of hex characters.
20
21 Bubble babble fingerprinting is used by the SSH2 suite (and,
22 consequently, by *Net::SSH::Perl*, the Perl SSH implementation) to
23 display easy-to-remember key fingerprints. The key (a DSA or RSA key) is
24 converted into a textual form, digested using *Digest::SHA1*, and run
25 through *bubblebabble* to create the key fingerprint.
26
27USAGE
28 *Digest::BubbleBabble* conditionally exports one function called
29 *bubblebabble*; to import the function you must choose to import it,
30 like this:
31
32 use Digest::BubbleBabble qw( bubblebabble );
33
34 bubblebabble( Digest => $digest )
35 Currently takes only one pair of arguments, the key of which must be
36 *Digest*, the value of which is the actual message digest *$digest*. You
37 should generate this message digest yourself using either *Digest::MD5*
38 of *Digest::SHA1*.
39
40 Returns the bubble babble form of the digest.
41
42SEE ALSO
43 The BubbleBabble specification is available at:
44 http://web.mit.edu/kenta/www/one/bubblebabble/spec/jrtrjwzi/draft-huima-
45 01.txt
46
47LICENSE
48 Digest::BubbleBabble is free software; you may redistribute it and/or
49 modify it under the same terms as Perl itself.
50
51AUTHOR & COPYRIGHTS
52 Benjamin Trott, cpan@stupidfool.org
53
54 Except where otherwise noted, Digest::BubbleBabble is Copyright 2001
55 Benjamin Trott. All rights reserved.
56
57