NAME

       GnuPG::Signature - GnuPG Key Signature Objects

SYNOPSIS

         # assumes a GnuPG::Key or GnuPG::UserID or GnuPG::UserAttribute object in $signed
         my $signing_id = $signed->signatures->[0]->hex_id();

DESCRIPTION

       GnuPG::Signature objects are generally not instantiated on their own, but rather as part
       of GnuPG::Key objects.  They embody various aspects of a GnuPG signature on a key.

OBJECT METHODS

       new( %initialization_args )
           This methods creates a new object.  The optional arguments are initialization of data
           members.

       is_valid()
           Returns 1 if GnuPG was able to cryptographically verify the signature, otherwise 0.

       compare( $other )
           Returns non-zero only when this Signature is identical to the other GnuPG::Signature.

OBJECT DATA MEMBERS

       validity
           A character indicating the cryptographic validity of the key.  GnuPG uses at least the
           following characters: "!" means valid, "-" means not valid, "?" means unknown (e.g. if
           the supposed signing key is not present in the local keyring), and "%" means an error
           occurred (e.g. a non-supported algorithm).  See the documentation for --check-sigs in
           gpg(1).

       algo_num
           The number of the algorithm used for the signature.

       hex_id
           The hex id of the signing key.

       user_id_string
           The first user id string on the key that made the signature.  This may not be defined
           if the signing key is not on the local keyring.

       sig_class
           Signature class.  This is the numeric value of the class of signature.

           A table of possible classes of signatures and their numeric types can be found at
           http://tools.ietf.org/html/rfc4880#section-5.2.1

       is_exportable
           returns 0 for local-only signatures, non-zero for exportable signatures.

       date_string
           The formatted date the signature was performed on.

       date
           The date the signature was performed, represented as the number of seconds since
           midnight 1970-01-01 UTC.

       expiration_date_string
           The formatted date the signature will expire (signatures without expiration return
           undef).

       expiration_date
           The date the signature will expire, represented as the number of seconds since
           midnight 1970-01-01 UTC (signatures without expiration return undef)

SEE ALSO