1GnuPG::Key(3)         User Contributed Perl Documentation        GnuPG::Key(3)
2
3
4

NAME

6       GnuPG::Key - GnuPG Key Object
7

SYNOPSIS

9         # assumes a GnuPG::Interface object in $gnupg
10         my @keys = $gnupg->get_public_keys( 'ftobin' );
11
12         # now GnuPG::PublicKey objects are in @keys
13

DESCRIPTION

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

OBJECT METHODS

20   Initialization Methods
21       new( %initialization_args )
22           This methods creates a new object.  The optional arguments are
23           initialization of data members.
24
25       hash_init( %args ).
26       short_hex_id
27           This returns the commonly-used short, 8 character short hex id of
28           the key.
29
30       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

OBJECT DATA MEMBERS

36       length
37           Number of bits in the key.
38
39       algo_num
40           They algorithm number that the Key is used for.
41
42       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
47           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
52           See "key capabilities" DETAILS from the GnuPG sources for more
53           details.
54
55       hex_data
56           The data of the key.  WARNING: this seems to have never been
57           instantiated, and should always be undef.
58
59       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
63           For DSA keys, the values are: prime (p), group order (q), group
64           generator (g), y
65
66           For RSA keys, the values are: modulus (n), exponent (e)
67
68           For El Gamal keys, the values are: prime (p), group generator (g),
69           y
70
71           For more details, see: http://tools.ietf.org/html/rfc4880#page-42
72
73       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
77       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
82       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
88       fingerprint
89           A GnuPG::Fingerprint object.
90
91       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
97       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
104       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

SEE ALSO

110       GnuPG::Fingerprint, GnuPG::Signature, GnuPG::Revoker,
111
112
113
114perl v5.28.1                      2014-03-13                     GnuPG::Key(3)
Impressum