SQ(1)

💅 SQ(1) — sq-inspect, bestie

okay so this is the manual page for sq-inspect, one of the sq girlies. it lives in the User Commands section of the manual, section 1, iykyk. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

sq-inspect — Inspect data, like file(1) 🕵️♀️

---

✨ SYNOPSIS ✨

sq inspect [OPTIONS] FILE

---

✨ DESCRIPTION ✨

Inspect data, like file(1). that's the whole vibe fr fr.

so here's the thing: sometimes you're staring at some random OpenPGP blob and you're like... what is this?? and a cursory little peek with cat(1) or file(1) is giving absolutely nothing. no context. no clue. just vibes 💀

that's where this subcommand comes in. sq inspect goes in, inspects the data, and hands you back a meaningful, human-readable description of whatever it is you're looking at. iconic behaviour, honestly. 👑

sq inspect respects the reference time set by the top-level --time argument. it uses that reference time when it's figuring out which binding signatures are active. so like, time travel but make it cryptography ⏰✨

---

✨ OPTIONS ✨

🎀 Subcommand options

• --cert=FINGERPRINT|KEYID — inspect certificates with the specified fingerprint or key ID, bestie. give it the fingerprint or the key ID, we'll find your cert.
• --cert-domain=DOMAIN — inspect certificates where a user ID includes an email address for the specified domain (btw note: User IDs are not authenticated 👀).
• --cert-email=EMAIL — inspect certificates where a user ID includes the specified email address (again, note: User IDs are not authenticated 👀).
• --cert-file=PATH — read certificates from PATH.
• --cert-grep=PATTERN — inspect certificates with a user ID that matches the pattern, case insensitively (and yeah, note: User IDs are not authenticated 👀).
• --cert-userid=USERID — inspect certificates with the specified user ID (note: User IDs are not authenticated 👀).
• --certifications — print third-party certifications. the receipts!! ✨
• --dump-bad-signatures — dump signatures that are definitively bad. goodbye, trash 🗑️
• FILE — read from FILE, or from stdin if FILE is '-'.

[default: -]

🌍 Global options

See sq(1) for a description of the global options. she's got her own page, go read her 💖

---

✨ EXAMPLES ✨

Inspect a certificate. 🎀

sq inspect juliet.pgp

Show how the certificate looked on July 21, 2013. time machine moment 🕰️

sq inspect --time 20130721 juliet.pgp

Inspect an encrypted message. 🔐

sq inspect message.pgp

Inspect a detached signature. ✍️

sq inspect document.sig

---

✨ SEE ALSO ✨

• sq(1).

For the full documentation see <https://book.sequoia-pgp.org/>. 📖

---

✨ VERSION ✨

1.5.0

---

okay that's the whole page, you ate that 🫶 this was Sequoia PGP, version 1.5.0, living her best life in the SQ(1) manual slot. go inspect something and slay 💅🌈⭐