SQ(1)

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

🌸 NAME 🌸

okay so this is the SQ(1) page — section 1, User Commands — and the actual star of the show is sq-packet-dump, which does one (1) thing and does it gorgeously: it lists packets. 💖

🦋 SYNOPSIS 🦋

sq packet dump [OPTIONS] FILE

that's the shape of it, bestie. options, then a file. iconic. ✨

💅 DESCRIPTION 💅

List packets. yeah that's it, that's the whole vibe. 🎀

What you actually get is a human-readable description of the packet sequence. So like, not just vibes — real, readable structure. 🫶

On top of that? It can also print cryptographic artifacts, and it can print the raw octet stream, kinda like hexdump(1) does — except it annotates specifically which bytes are parsed into OpenPGP values. it's giving annotated, it's giving academic, it's giving slay. 🔥

And if the packet stream includes an encryption container, sq will attempt to decrypt it. no cap. 👑

✨ OPTIONS ✨

🎀 Subcommand options 🎀

  • --cert=FINGERPRINT|KEYID — dump the packets of the certificate that has this fingerprint or key ID. literally tell it who and it'll spill. 🙈
  • --cert-email=EMAIL — dump the packets of the certificate where a user ID includes this email address. 📧
  • --cert-file=PATH — dump the packets of the cert, read from PATH. 📂
  • --cert-userid=USERID — dump the packets of the certificate with this user ID. 🪪
  • --hex — print a hexdump. every byte, exposed. 💀
  • --mpis — print cryptographic artifacts. the math is mathing. 🧚
  • --output=FILE — write to FILE, or to stdout if you leave it out. ⭐

[default: -]

  • --recipient-file=KEY_FILE — decrypt the message using the key in KEY_FILE. bestie's got the key literally right there. 🔑
  • --session-key=SESSION-KEY — decrypt an encrypted message using SESSION-KEY. 🗝️
  • FILE — read from FILE, or from stdin if FILE is '-'. 🌈

[default: -]

💜 Global options 💜

See sq(1) for a description of the global options. (yes, the global options live over there, go say hi.) 👋

🔥 EXAMPLES 🔥

Print the packets of a certificate.

sq packet dump juliet.pgp

Print the packets including cryptographic artifacts of a certificate.

sq packet dump --mpis juliet.pgp

Print the packets including a dump of every byte of a certificate.

sq packet dump --hex juliet.pgp

Prints the packets of an encrypted message, decrypting it using a secret key file.

sq packet dump --recipient-file bob-secret.pgp message.pgp

👑 SEE ALSO 👑

⭐ VERSION ⭐

1.5.0

and that's the page, bestie 🫶 this whole thing is brought to you by Sequoia PGP, version 1.5.0, and yeah the footer is just that — Sequoia PGP, 1.5.0, SQ(1) — no date up in here, so don't come for me about timestamps. go dump some packets, you absolute main character. 💅✨

📦 where this page comes from