GnuPG::Signature(3pm)

💜 GnuPG::Signature(3pm) — the glow-up

okay bestie, so this is the Perl doc for GnuPG::Signature, part of the User Contributed Perl Documentation for GnuPG. it's the little object that holds ✨vibes✨ about a GnuPG key signature. buckle up, it's short but it's iconic.

---

🌸 NAME 🌸

GnuPG::Signature — GnuPG Key Signature Objects. that's it, that's the whole name. 🎀

---

⭐ SYNOPSIS ⭐

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

so like, you've got one of those in $signed, and you just reach in and grab the hex id of the first signature. no big deal. 💅

---

🦋 DESCRIPTION 🦋

okay so GnuPG::Signature objects are literally not meant to be made on their own — they get created as part of GnuPG::Key objects. they embody (love that word) the various aspects of a GnuPG signature on a key. main character energy, but as a data member. 👑

---

✨ OBJECT METHODS ✨

• new( %initialization_args ) — this method creates a brand new object for you 🫶. the arguments are optional and they're just initialization of data members. no stress.
• is_valid() — returns 1 if GnuPG was actually able to cryptographically verify the signature, otherwise 0. like a vibe check but for crypto. 😭
• compare( $other ) — returns non-zero only when this Signature is identical to the other GnuPG::Signature. literally twin flames or nothing. no partial credit. 💀

---

🌈 OBJECT DATA MEMBERS 🌈

• validity — a character indicating the cryptographic validity of the key. GnuPG uses at least these characters:
  • "!" means valid 💖
  • "-" means not valid 🙈
  • "?" means unknown (e.g. if the supposed signing key is not present in the local keyring)
  • "%" means an error occurred (e.g. a non-supported algorithm) 🚨

see the documentation for --check-sigs in gpg(1). iykyk.

• 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. lowkey important caveat: this may not be defined if the signing key is not on the local keyring.
• sig_class — the 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 — go read it, it's giving reference material 📚

• 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 👑

that's literally it for cross-references, bestie. the section's just vibes. ✨

---

ngl the whole thing is short but it ate. remember: every one of those undef returns and every one of those validity characters matters, no cap. 🔥

~~ sign-off ~~ this little gem is perl v5.40.1, dated 2025-03-14, and it lives at GnuPG::Signature(3pm) — go forth and verify some sigs, you absolute icon 🫶💜✨