GnuPG::Revoker(3pm) User Contributed Perl Documentation GnuPG::Revoker(3pm)NAME
GnuPG::Revoker - GnuPG Key Revoker Objects
SYNOPSIS
# assumes a GnuPG::PrimaryKey object in $key
my $revokerfpr = $key->revokers->[0]->fingerprint();
DESCRIPTION
GnuPG::Revoker objects are generally not instantiated on their own, but rather as part of GnuPG::Key objects. They represent a statement
that another key is designated to revoke certifications made by the key in question.
OBJECT METHODS
new( %initialization_args )
This methods creates a new object. The optional arguments are initialization of data members.
is_sensitive()
Returns 0 if the revoker information can be freely distributed. If this is non-zero, the information should be treated as "sensitive".
Please see http://tools.ietf.org/html/rfc4880#section-5.2.3.15 for more explanation.
compare( $other, $deep )
Returns non-zero only when this designated revoker is identical to the other GnuPG::Revoker. If $deep is present and non-zero, the
revokers' signatures will also be compared.
OBJECT DATA MEMBERS
fingerprint
A GnuPG::Fingerprint object indicating the fingerprint of the specified revoking key. (Note that this is *not* the fingerprint of the
key whose signatures can be revoked by this revoker).
algo_num
The numeric identifier of the algorithm of the revoker's key.
signatures
A list of GnuPG::Signature objects which cryptographically bind the designated revoker to the primary key. If the material was
instantiated using the *_with_sigs() functions from GnuPG::Interface, then a valid revoker designation should have a valid signature
associated with it from the relevant key doing the designation (not from the revoker's key).
Note that designated revoker certifications are themselves irrevocable, so there is no analogous list of revocations in a
GnuPG::Revoker object.
SEE ALSO
GnuPG::Interface, GnuPG::Fingerprint, GnuPG::Key, GnuPG::Signature, http://tools.ietf.org/html/rfc4880#section-5.2.3.15
<http://tools.ietf.org/html/rfc4880#section-5.2.3.15>
perl v5.12.4 2010-06-07 GnuPG::Revoker(3pm)
Check Out this Related Man Page
GnuPG::Key(3pm) User Contributed Perl Documentation GnuPG::Key(3pm)NAME
GnuPG::Key - GnuPG Key Object
SYNOPSIS
# assumes a GnuPG::Interface object in $gnupg
my @keys = $gnupg->get_public_keys( 'ftobin' );
# now GnuPG::PublicKey objects are in @keys
DESCRIPTION
GnuPG::Key objects are generally not instantiated on their own, but rather used as a superclass of GnuPG::PublicKey, GnuPG::SecretKey, or
GnuPG::SubKey objects.
OBJECT METHODS
Initialization Methods
new( %initialization_args )
This methods creates a new object. The optional arguments are initialization of data members.
hash_init( %args ).
short_hex_id
This returns the commonly-used short, 8 character short hex id of the key.
compare( $other, $deep )
Returns non-zero only when this Key is identical to the other GnuPG::Key. If $deep is present and non-zero, the key's associated
signatures, revocations, and revokers will also be compared.
OBJECT DATA MEMBERS
length
Number of bits in the key.
algo_num
They algorithm number that the Key is used for.
usage flags
The Key Usage flags associated with this key, represented as a string of lower-case letters. Possible values include: (a)
authenticate, (c) certify, (e) encrypt, and (s) sign.
A key may have any combination of them in any order. In addition to these letters, the primary key has uppercase versions of the
letters to denote the _usable_ capabilities of the entire key, and a potential letter 'D' to indicate a disabled key.
See "key capabilities" DETAILS from the GnuPG sources for more details.
hex_data
The data of the key. WARNING: this seems to have never been instantiated, and should always be undef.
pubkey_data
A list of Math::BigInt objects that correspond to the public key material for the given key (this member is empty on secret keys).
For DSA keys, the values are: prime (p), group order (q), group generator (g), y
For RSA keys, the values are: modulus (n), exponent (e)
For El Gamal keys, the values are: prime (p), group generator (g), y
For more details, see: http://tools.ietf.org/html/rfc4880#page-42
hex_id
The long hex id of the key. This is not the fingerprint nor the short hex id, which is 8 hex characters.
creation_date_string
expiration_date_string
Formatted date of the key's creation and expiration. If the key has no expiration, expiration_date_string will return undef.
creation_date
expiration_date
Date of the key's creation and expiration, stored as the number of seconds since midnight 1970-01-01 UTC. If the key has no
expiration, expiration_date will return undef.
fingerprint
A GnuPG::Fingerprint object.
signatures
A list of GnuPG::Signature objects embodying the signatures on this key. For subkeys, the signatures are usually subkey-binding
signatures. For primary keys, the signatures are statements about the key itself.
revocations
A list of revocations associated with this key, stored as GnuPG::Signature objects (since revocations are a type of certification as
well). Note that a revocation of a primary key has a different semantic meaning than a revocation associated with a subkey.
revokers
A list of GnuPG::Revoker objects associated with this key, indicating other keys which are allowed to revoke certifications made by
this key.
SEE ALSO
GnuPG::Fingerprint, GnuPG::Signature, GnuPG::Revoker,
perl v5.12.4 2010-06-07 GnuPG::Key(3pm)