1GnuPG::Key(3) User Contributed Perl Documentation GnuPG::Key(3)
2
6 GnuPG::Key - GnuPG Key Object
7
9 # assumes a GnuPG::Interface object in $gnupg
10 my @keys = $gnupg->get_public_keys( 'ftobin' );
11 # now GnuPG::PublicKey objects are in @keys
13
15 GnuPG::Key objects are generally not instantiated on their own, but
16 rather used as a superclass of GnuPG::PublicKey, GnuPG::SecretKey, or
17 GnuPG::SubKey objects.
18
20 Initialization Methods
21 new( %initialization_args )
22 This methods creates a new object. The optional arguments are
23 initialization of data members.
24 hash_init( %args ).
26 short_hex_id
27 This returns the commonly-used short, 8 character short hex id of
28 the key.
29 compare( $other, $deep )
31 Returns non-zero only when this Key is identical to the other
32 GnuPG::Key. If $deep is present and non-zero, the key's associated
33 signatures, revocations, and revokers will also be compared.
34
36 length
37 Number of bits in the key.
38 algo_num
40 They algorithm number that the Key is used for.
41 usage_flags
43 The Key Usage flags associated with this key, represented as a
44 string of lower-case letters. Possible values include: (a)
45 authenticate, (c) certify, (e) encrypt, and (s) sign.
46 A key may have any combination of them in any order. In addition
48 to these letters, the primary key has uppercase versions of the
49 letters to denote the _usable_ capabilities of the entire key, and
50 a potential letter 'D' to indicate a disabled key.
51 See "key capabilities" DETAILS from the GnuPG sources for more
53 details.
54 hex_data
56 The data of the key. WARNING: this seems to have never been
57 instantiated, and should always be undef.
58 pubkey_data
60 A list of Math::BigInt objects that correspond to the public key
61 material for the given key (this member is empty on secret keys).
62 For DSA keys, the values are: prime (p), group order (q), group
64 generator (g), y
65 For RSA keys, the values are: modulus (n), exponent (e)
67 For El Gamal keys, the values are: prime (p), group generator (g),
69 y
70 For more details, see: http://tools.ietf.org/html/rfc4880#page-42
72 hex_id
74 The long hex id of the key. This is not the fingerprint nor the
75 short hex id, which is 8 hex characters.
76 creation_date_string
78 expiration_date_string
79 Formatted date of the key's creation and expiration. If the key
80 has no expiration, expiration_date_string will return undef.
81 creation_date
83 expiration_date
84 Date of the key's creation and expiration, stored as the number of
85 seconds since midnight 1970-01-01 UTC. If the key has no
86 expiration, expiration_date will return undef.
87 fingerprint
89 A GnuPG::Fingerprint object.
90 signatures
92 A list of GnuPG::Signature objects embodying the signatures on this
93 key. For subkeys, the signatures are usually subkey-binding
94 signatures. For primary keys, the signatures are statements about
95 the key itself.
96 revocations
98 A list of revocations associated with this key, stored as
99 GnuPG::Signature objects (since revocations are a type of
100 certification as well). Note that a revocation of a primary key
101 has a different semantic meaning than a revocation associated with
102 a subkey.
103 revokers
105 A list of GnuPG::Revoker objects associated with this key,
106 indicating other keys which are allowed to revoke certifications
107 made by this key.
108
110 GnuPG::Fingerprint, GnuPG::Signature, GnuPG::Revoker,
111perl v5.30.1 2020-01-30 GnuPG::Key(3)