SQ(1)

📦
version 1.5.0 · 4 versions
, in fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0

💖 SQ(1) — the girlies' guide to sq key subkey delete 💖

okay bestie, welcome to the Sequoia PGP manual page for sq key subkey delete. yes it's a whole mouthful, no we're not skipping it, and yes it's genuinely useful. sit down, hydrate, let's go ✨

🌸 NAME 🌸

sq-key-subkey-delete — delete a certificate's secret key material 💅

🦋 SYNOPSIS 🦋

sq key subkey delete [OPTIONS]

🎀 DESCRIPTION 🎀

so this command deletes a certificate's secret key material. that's the whole vibe. bye secret, hello peace ✌️

but here's the part that's giving main character:

unlike sq key delete, which deletes all the secret key material, this command only deletes the specified secret key material. we are being surgical here. precise. iconic. 🎯

and ALSO, lowkey important: if the secret key material is managed by multiple devices, it gets deleted from all of them. every single one. no stragglers.

now, the way that the secret key material is gone but the public keys are retained… that's on purpose! so if you don't want the keys to be used anymore, deleting the secret isn't enough — you should revoke the keys using sq key subkey revoke. do that. fr fr. 🫶

✨ OPTIONS ✨

💜 Subcommand options

  • --cert=FINGERPRINT|KEYID — delete secret key material from the key with the specified fingerprint or key ID 🔑
  • --cert-email=EMAIL — delete secret key material from the key where a user ID includes the specified email address 📧
  • --cert-file=PATH — delete the secret key material from the key read from PATH 📂
  • --cert-userid=USERID — delete secret key material from the key with the specified user ID 🪪
  • --key=FINGERPRINT|KEYID — delete the specified key's secret key material 🗝️
  • --output=FILE — write the stripped certificate to the specified file 📝
heads up bestie: this option only makes sense when deleting the secret key material from a file. if you're deleting secret key material managed by the key store using --cert, you can get the stripped certificate with sq key export instead. iykyk 💅

🌈 Global options

see sq(1) for a description of the global options — that's where the whole squad of universal flags lives 💖

🌟 EXAMPLES 🌟

delete Alice's signing subkey. periodt.

sq key subkey delete \
       --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
       --key=42020B87D51877E5AF8D272124F3955B0B8DECC8

👀 SEE ALSO 👀

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

⭐ VERSION ⭐

1.5.0

aight that's the whole page, bestie. this manual page came to you from Sequoia PGP, version 1.5.0, and it's literally titled SQ(1). you ate that. now go revoke your subkeys if you meant it 😭💖🌷

📦 where this page comes from