identify(1)

💖 identify(1) — bestie, we're identifying a certificate 💖

okay so this is a page from the General Commands Manual, section 1, and it's literally called identify. yeah. that's the whole vibe. let's go 🫶

---

✨ NAME ✨

identify — Identify a certificate. that's it. that's the job. 💅

---

🌸 SYNOPSIS 🌸

identify [-h|--help] <FINGERPRINT|KEYID>

---

🦋 DESCRIPTION 🦋

okay bestie so identify a certificate. simple on the surface, main character underneath.

the way it works is: it identifies a certificate by finding authenticated bindings (that's User ID and certificate pairs, iykyk 🎀).

now here's the trust tea ☕ — if a binding could be authenticated to the specified level, then the exit status is 0. and what's the specified level by default? fully authenticated, which literally means a trust amount of 120. periodt.

if it can't hit that bar, the exit status is 1. no cap. 😭

BUT — and this is the part people sleep on — if a binding could be partially authenticated (meaning its trust amount is greater than 0), then the binding is displayed anyway, even if the trust is below the specified threshold. so like, it still shows up. it just doesn't count as a win for the exit status. 💀

---

💅 OPTIONS 💅

• -h, --help — Print help (see a summary with '-h'). the little -h gives you the short version, the long one gives you the whole meal. 🍓
• <FINGERPRINT|KEYID> — The fingerprint or Key ID of the certificate to authenticate. give it one of these and it knows who you're talking about. ✨

---

🔥 EXTRA 🔥

okay now the EXAMPLES because this is where it eats:

# Identify a certificate.
$ sq-wot --keyring keyring.pgp \
    --partial \
    --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
  identify \
    C7B1406CD2F612E9CE2136156F2DA183236153AE

# The same as above, but output in DOT format and convert it to
# an SVG using Graphviz's DOT compiler.
$ sq-wot --format dot \
    --keyring keyring.pgp \
    --partial \
    --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
  identify \
    C7B1406CD2F612E9CE2136156F2DA183236153AE \
  | dot -Tsvg -o C7B1406CD2F612E9CE2136156F2DA183236153AE.svg

the second one? iconic. you pipe it through Graphviz's DOT compiler and suddenly you've got yourself an SVG. obsessed. 🌈

ngl that | dot -Tsvg -o ... pipeline is giving art student energy and I'm here for it 🎨

---

okay that's the whole page!! 🥳 and for the cute sign-off: this lil legend comes to you from the identify manual page, section 1, living its best life under the General Commands Manual — and yeah, the footer just says identify and identify(1) again, which is very "she's her own hype woman" of it. 👑💖

go identify something, bestie. you got this. 🧚