Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Crypt::DSA::KeyChain(3User Contributed Perl DocumentatiCrypt::DSA::KeyChain(3)

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

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
   $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.

   $key	= $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.

   $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.

perl v5.32.1			  2011-06-17	       Crypt::DSA::KeyChain(3)

NAME | SYNOPSIS | DESCRIPTION | USAGE | AUTHOR & COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Crypt::DSA::KeyChain&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help