NAME

       sq toolbox - Tools for developers, maintainers, and forensic specialists

SYNOPSIS

       sq toolbox keyring [OPTIONS]  SUBCOMMAND
       sq toolbox extract-cert [OPTIONS] FILE
       sq toolbox packet [OPTIONS]  SUBCOMMAND
       sq toolbox armor [OPTIONS] FILE
       sq toolbox dearmor [OPTIONS] FILE

DESCRIPTION

       Tools for developers, maintainers, and forensic specialists.

       This is a collection of low-level tools to inspect and manipulate OpenPGP data structures.

SUBCOMMANDS

   sq toolbox keyring
       Manage collections of keys or certs.

       Collections of keys or certificates (also known as "keyrings" when they contain secret key
       material, and "certrings" when they don't) are any number  of  concatenated  certificates.
       This subcommand provides tools to list, split, merge, and filter keyrings.

       Note:  In  the documentation of this subcommand, we sometimes use the terms keys and certs
       interchangeably.

   sq toolbox extract-cert
       Convert a key to a cert.

       After generating a key, use this command to get the certificate corresponding to the  key.
       The key must be kept secure, while the certificate should be handed out to correspondents,
       e.g. by uploading it to a key server.

   sq toolbox packet
       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.

   sq toolbox armor
       Convert binary to ASCII.

       To  make encrypted data easier to handle and transport, OpenPGP data can be transformed to
       an ASCII representation called ASCII Armor.  sq emits armored data by  default,  but  this
       subcommand   can   be   used  to  convert  existing  OpenPGP  data  to  its  ASCII-encoded
       representation.

       The converse operation is `sq toolbox dearmor`.

   sq toolbox dearmor
       Convert ASCII to binary.

       To make encrypted data easier to handle and transport, OpenPGP data can be transformed  to
       an  ASCII  representation  called ASCII Armor.  sq transparently handles armored data, but
       this subcommand can be used to explicitly convert existing ASCII-encoded OpenPGP  data  to
       its binary representation.

       The converse operation is `sq toolbox armor`.

EXAMPLES

   sq toolbox extract-cert
       First, generate a key

              sq key generate --userid '<juliet@example.org>' \
                     --output juliet.key.pgp

       Then, extract the certificate for distribution

              sq toolbox extract-cert --output juliet.cert.pgp juliet.key.pgp

   sq toolbox armor
       Convert a binary certificate to ASCII

              sq toolbox armor binary-juliet.pgp

       Convert a binary message to ASCII

              sq toolbox armor binary-message.pgp

   sq toolbox dearmor
       Convert a ASCII certificate to binary

              sq toolbox dearmor ascii-juliet.pgp

       Convert a ASCII message to binary

              sq toolbox dearmor ascii-message.pgp

SEE ALSO

       sq(1),     sq-toolbox-keyring(1),     sq-toolbox-extract-cert(1),    sq-toolbox-packet(1),
       sq-toolbox-armor(1), sq-toolbox-dearmor(1).

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

VERSION

       0.34.0 (sequoia-openpgp 1.19.0)