Bitsize of the key to be generated. This should be an even integer; there is no low end currently set, but for the sake of security Size should be at least 1024 bits.
This is a required argument.
Set to a true value to enable a status display during key generation; since key generation is a relatively length process, it is helpful to have an indication that some action is occurring.
Verbosity is 0 by default.
Crypt::OpenPGP::Key is not meant to be used directly (unless you are generating keys; see KEY GENERATION, above); instead you should use the subclasses of this module. There are, however, useful interface methods that are shared by all subclasses.
Each public-key algorithm has different key data associated with it. For example, a public DSA key has 4 attributes: p, q, g, and y. A secret DSA key has the same attributes as a public key, and in addition it has an attribute x.
All of the key data attributes can be accessed by calling methods of the same name on the Key object. For example:
my $q = $dsa_key->q;
The attributes for each public-key algorithm are:
Public key: n, e
Secret key: n, e, d, p, q, u
Public key: p, q, g, y
Secret key: p, q, g, y, x
Public key: p, g, y
Secret key: p, g, y, x
CW$key->checkCheck the key data to determine if it is valid. For example, an RSA secret key would multiply the values of p and q and verify that the product is equal to the value of n. Returns true if the key is valid, false otherwise.
Not all public key algorithm implementations implement a check method; for those that dont, check will always return true.
CW$key->sizeReturns the size of the key. The definition of size depends on the public key algorithm; for example, DSA defines the size of a key as the bitsize of the value of p.
CW$key->bytesizeWhereas size will return a bitsize of the key, bytesize returns the size in bytes. This value is defined as int((bitsize(key)+7)/8).
CW$key->is_secretReturns true if the key $key is a secret key, false otherwise.
CW$key->public_keyReturns the public part of the key $key. If $key is already a public key, $key is returned; otherwise a new public key object (Crypt::OpenPGP::Key::Public) is constructed, and the public values from the secret key are copied into the public key. The new public key is returned.
CW$key->can_encryptReturns true if the key algorithm has encryption/decryption capabilities, false otherwise.
CW$key->can_signReturns true if the key algorithm has signing/verification capabilities, false otherwise.
CW$key->algReturns the name of the public key algorithm.
CW$key->alg_idReturns the number ID of the public key algorithm.
Please see the Crypt::OpenPGP manpage for author, copyright, and license information.
|perl v5.20.3||CRYPT::OPENPGP::KEY (3)||2009-12-10|