NAME

       sq toolbox packet - Low-level packet manipulation

SYNOPSIS

       sq toolbox packet dump [OPTIONS] FILE
       sq toolbox packet decrypt [OPTIONS] FILE
       sq toolbox packet split [OPTIONS] FILE
       sq toolbox packet join [OPTIONS] FILE

DESCRIPTION

       Low-level packet manipulation.

       An  OpenPGP  data  stream  consists of packets.  These tools allow working with packet streams.  They are
       mostly of interest to developers, but `sq toolbox packet dump` may be helpful to a wider audience both to
       provide valuable information in bug reports to OpenPGP-related software, and as a learning tool.

SUBCOMMANDS

   sq toolbox packet dump
       List packets.

       Creates  a  human-readable  description of the packet sequence.  Additionally, it can print cryptographic
       artifacts, and print the raw octet stream similar to hexdump(1), annotating specifically which bytes  are
       parsed into OpenPGP values.

       To inspect encrypted messages, either supply the session key, or see `sq decrypt` with the `--dump` flag,
       or `sq toolbox packet decrypt`.

   sq toolbox packet decrypt
       Unwrap an encryption container.

       Decrypts a message, dumping the content of the encryption  container  without  further  processing.   The
       result  is  a  valid  OpenPGP message that can, among other things, be inspected using `sq toolbox packet
       dump`.

   sq toolbox packet split
       Split a message into packets.

       Splitting a packet sequence into individual packets, then recombining them freely with `sq toolbox packet
       join` is a great way to experiment with OpenPGP data.

       The converse operation is `sq toolbox packet join`.

   sq toolbox packet join
       Join packets split across files.

       Splitting a packet sequence into individual packets, then recombining them freely with `sq toolbox packet
       join` is a great way to experiment with OpenPGP data.

       The converse operation is `sq toolbox packet split`.

EXAMPLES

   sq toolbox packet dump
       Prints the packets of a certificate

              sq toolbox packet dump juliet.pgp

       Prints cryptographic artifacts of a certificate

              sq toolbox packet dump --mpis juliet.pgp

       Prints a hexdump of a certificate

              sq toolbox packet dump --hex juliet.pgp

       Prints the packets of an encrypted message

              sq toolbox packet dump --session-key AABBCC... ciphertext.pgp

   sq toolbox packet decrypt
       Unwraps the encryption revealing the signed message

              sq toolbox packet decrypt --recipient-file juliet.pgp \
                     ciphertext.pgp

   sq toolbox packet split
       Split a certificate into individual packets

              sq toolbox packet split juliet.pgp

   sq toolbox packet join
       Split a certificate into individual packets

              sq toolbox packet split juliet.pgp

       Then join only a subset of these packets

              sq toolbox packet join juliet.pgp-[0-3]*

SEE ALSO

       sq(1),          sq-toolbox(1),          sq-toolbox-packet-dump(1),          sq-toolbox-packet-decrypt(1),
       sq-toolbox-packet-split(1), sq-toolbox-packet-join(1).

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

VERSION

       0.34.0 (sequoia-openpgp 1.19.0)