File: README

package info (click to toggle)
libdigest-bubblebabble-perl 0.02-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 296 kB
  • sloc: perl: 4,425; makefile: 2
file content (56 lines) | stat: -rw-r--r-- 2,221 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
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::SHA1 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::SHA1*, 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::SHA1*.

    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.