SQ(1)

✨ sq-pki-link-list — the links list, bestie ✨

okay so you found the SQ(1) manual page for sq-pki-link-list? iconic. This is the sq pki link list command, from the SQ(1) manual in the User Commands section, and it is literally here to show u the links. 💅

---

🎀 NAME 🎀

sq-pki-link-list — List links 💖

🦋 SYNOPSIS 🦋

sq pki link list [OPTIONS] PATTERN

🌸 DESCRIPTION 🌸

List links. periodt.

This command lists all bindings that are linked or whose link has been retracted. Like, both the still-linked ones and the retracted-link ones get shown. 👑

Returns a non-zero exit code if an explicitly designated certificate was never linked. So if u point at a cert and it was never linked, the command is not gonna exit 0, bestie. 😭

💅 OPTIONS 💅

✨ Subcommand options ✨

• --ca — Only lists bindings linked as CAs. That is, only list a link if its trust depth is greater than 0. 👑
• --cert=FINGERPRINT|KEYID — Use certificates with the specified fingerprint or key ID. 🔑
• --cert-domain=DOMAIN — Use certificates where a user ID includes an email address for the specified domain. 📧
• --cert-email=EMAIL — Use certificates where a user ID includes the specified email address. 💌
• --cert-grep=PATTERN — Use certificates with a user ID that matches the pattern, case insensitively. 🔍
• --cert-userid=USERID — Use certificates with the specified user ID. 🪪
• PATTERN — A pattern to select the bindings to authenticate. The pattern is treated as a UTF-8 encoded string and a case insensitive substring search (using the current locale) is performed against each User ID. If a User ID is not valid UTF-8, the binding is ignored. 🧚

🌈 Global options 🌈

See sq(1) for a description of the global options.

👑 EXAMPLES 👑

Example time, bestie. Let's go. ✨

Link the certificate EB28F26E2739A4870ECC47726F0073F60FD0CBF0 with the email address alice@example.org.

sq pki link add \
       --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
       --email=alice@example.org

List all links.

sq pki link list

List links to certificates with an authenticated user ID that contains an email address in the specified domain.

sq pki link list --cert-domain=example.org

🎀 SEE ALSO 🎀

sq(1), sq-pki(1), sq-pki-link(1).

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

⭐ VERSION ⭐

1.5.0

---

Sequoia PGP · 1.5.0 · SQ(1) — no date on the page, just version energy, bestie 💖🫶