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 in GnuPG 1.4. It is populated on secret keys In GnuPG >= 2.2.0.

           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.36.0                                       2023-12-15                                    GnuPG::Key(3pm)