GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CRYPT::DSA::KEYCHAIN (3)

.ds Aq ’

NAME

Crypt::DSA::KeyChain - DSA key generation system

CONTENTS

SYNOPSIS



    use Crypt::DSA::KeyChain;
    my $keychain = Crypt::DSA::KeyChain->new;

    my $key = $keychain->generate_params(
                    Size      => 512,
                    Seed      => $seed,
                    Verbosity => 1,
              );

    $keychain->generate_keys($key);



DESCRIPTION

Crypt::DSA::KeyChain is a lower-level interface to key generation than the interface in Crypt::DSA (the keygen method). It allows you to separately generate the p, q, and g key parameters, given an optional starting seed, and a mandatory bit size for p (q and g are 160 bits each).

You can then call generate_keys to generate the public and private portions of the key.

USAGE

CW$keychain = Crypt::DSA::KeyChain->new

Constructs a new Crypt::DSA::KeyChain object. At the moment this isn’t particularly useful in itself, other than being the object you need in order to call the other methods.

Returns the new object.

CW$key = CW$keychain->generate_params(%arg)

Generates a set of DSA parameters: the p, q, and g values of the key. This involves finding primes, and as such it can be a relatively long process.

When invoked in scalar context, returns a new Crypt::DSA::Key object.

In list context, returns the new Crypt::DSA::Key object, along with: the value of the internal counter when a suitable prime p was found; the value of h when g was derived; and the value of the seed (a 20-byte string) when q was found. These values aren’t particularly useful in normal circumstances, but they could be useful.

%arg can contain:
o Size

The size in bits of the p value to generate. The q and g values are always 160 bits each.

This argument is mandatory.

o Seed

A seed with which q generation will begin. If this seed does not lead to a suitable prime, it will be discarded, and a new random seed chosen in its place, until a suitable prime can be found.

This is entirely optional, and if not provided a random seed will be generated automatically.

o Verbosity

Should be either 0 or 1. A value of 1 will give you a progress meter during p and q generation—this can be useful, since the process can be relatively long.

The default is 0.

CW$keychain->generate_keys($key)

Generates the public and private portions of the key $key, a Crypt::DSA::Key object.

AUTHOR & COPYRIGHT

Please see the Crypt::DSA manpage for author, copyright, and license information.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CRYPT::DSA::KEYCHAIN (3) 2011-06-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.