---
name: "GnuPG::Signature"
section: "3pm"
platform: "linux"
package: "perl-gnupg-interface"
version: "1.07-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/GnuPG::Signature"
---

# GnuPG::Signature(3pm)

GnuPG Key Signature Objects

## 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)](/gpg/1.md).

- 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