NAME

       sq-keyring - Manages collections of keys or certs

       Collections of keys or certficicates (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, join, merge, and filter keyrings.

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

SYNOPSIS

       sq keyring [FLAGS] <SUBCOMMAND>

FLAGS

       -h, --help
              Prints help information

SUBCOMMANDS

       help   Prints this message or the help of the given subcommand(s)

       filter Joins keys into a keyring applying a filter

              This  can  be  used  to  filter  keys  based on given predicates, e.g. whether they have a user id
              containing an email address with a certain domain.  Additionally, the keys can be pruned  to  only
              include components matching the predicates.

              If no filters are supplied, everything matches.

              If  multiple  predicates  are  given,  they are or'ed, i.e. a key matches if any of the predicates
              match.  To require all predicates to match, chain  multiple  invocations  of  this  command.   See
              EXAMPLES for inspiration.

       join   Joins keys or keyrings into a single keyring

              Unlike "sq keyring merge", multiple versions of the same key are not merged together.

              The converse operation is "sq keyring split".

       merge  Merges keys or keyrings into a single keyring

              Unlike  "sq  keyring  join",  the  certificates  are  buffered  and  multiple versions of the same
              certificate are merged together.  Where data is replaced (e.g., secret key  material),  data  from
              the later certificate is preferred.

       list   Lists keys in a keyring

              Prints the fingerprint as well one userid for every certificate encountered in the keyring.

       split  Splits a keyring into individual keys

              Splitting up a keyring into individual keys helps with curating a keyring.

              The converse operation is "sq keyring join".

SEE ALSO

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

       sq(1), sq-armor(1), sq-autocrypt(1), sq-certify(1), sq-dearmor(1), sq-decrypt(1), sq-encrypt(1),
       sq-inspect(1), sq-key(1), sq-key-adopt(1), sq-key-attest-certifications(1), sq-key-extract-cert(1),
       sq-key-generate(1), sq-keyring(1), sq-keyring-filter(1), sq-keyring-join(1), sq-keyring-list(1),
       sq-keyring-merge(1), sq-keyring-split(1), sq-packet(1), sq-sign(1), sq-verify(1)

AUTHORS

         Azul <azul@sequoia-pgp.org>
         Igor Matuszewski <igor@sequoia-pgp.org>
         Justus Winter <justus@sequoia-pgp.org>
         Kai Michaelis <kai@sequoia-pgp.org>
         Neal H. Walfield <neal@sequoia-pgp.org>
         Nora Widdecke <nora@sequoia-pgp.org>
         Wiktor Kwapisiewicz <wiktor@sequoia-pgp.org>

0.24.0 (SEQUOIA-OPENPGP 1.0.0)                     MARCH 2021                                      SQ-KEYRING(1)