1SQ-KEYRING(1)                    USER COMMANDS                   SQ-KEYRING(1)
2
3
4

NAME

6       sq-keyring - Manages collections of keys or certs
7
8       Collections  of  keys  or  certficicates (also known as "keyrings" when
9       they contain secret key material, and "certrings" when they don't)  are
10       any  number  of  concatenated  certificates.   This subcommand provides
11       tools to list, split, join, merge, and filter keyrings.
12
13       Note: In the documentation of this subcommand,  we  sometimes  use  the
14       terms keys and certs interchangeably.
15
16

SYNOPSIS

18       sq keyring [FLAGS] <SUBCOMMAND>
19

FLAGS

21       -h, --help
22              Prints help information
23

SUBCOMMANDS

25       help   Prints this message or the help of the given subcommand(s)
26
27
28       filter Joins keys into a keyring applying a filter
29
30              This  can be used to filter keys based on given predicates, e.g.
31              whether they have a user id containing an email address  with  a
32              certain  domain.   Additionally,  the keys can be pruned to only
33              include components matching the predicates.
34
35              If no filters are supplied, everything matches.
36
37              If multiple predicates are given, they are  or'ed,  i.e.  a  key
38              matches  if  any of the predicates match.  To require all predi‐
39              cates to match, chain multiple invocations of this command.  See
40              EXAMPLES for inspiration.
41
42
43       join   Joins keys or keyrings into a single keyring
44
45              Unlike "sq keyring merge", multiple versions of the same key are
46              not merged together.
47
48              The converse operation is "sq keyring split".
49
50
51       merge  Merges keys or keyrings into a single keyring
52
53              Unlike "sq keyring join", the certificates are buffered and mul‐
54              tiple  versions  of  the  same  certificate are merged together.
55              Where data is replaced (e.g., secret key  material),  data  from
56              the later certificate is preferred.
57
58
59       list   Lists keys in a keyring
60
61              Prints  the fingerprint as well one userid for every certificate
62              encountered in the keyring.
63
64
65       split  Splits a keyring into individual keys
66
67              Splitting up a keyring into individual keys helps with  curating
68              a keyring.
69
70              The converse operation is "sq keyring join".
71

SEE ALSO

73       For the full documentation see <https://docs.sequoia-pgp.org/sq/>.
74
75       sq(1), sq-armor(1), sq-autocrypt(1), sq-certify(1), sq-dearmor(1),
76       sq-decrypt(1), sq-encrypt(1), sq-inspect(1), sq-key(1),
77       sq-key-adopt(1), sq-key-attest-certifications(1),
78       sq-key-extract-cert(1), sq-key-generate(1), sq-keyring(1),
79       sq-keyring-filter(1), sq-keyring-join(1), sq-keyring-list(1),
80       sq-keyring-merge(1), sq-keyring-split(1), sq-keyserver(1),
81       sq-keyserver-get(1), sq-keyserver-send(1), sq-packet(1), sq-sign(1),
82       sq-verify(1), sq-wkd(1)
83
84
85

AUTHORS

87         Azul <azul@sequoia-pgp.org>
88         Igor Matuszewski <igor@sequoia-pgp.org>
89         Justus Winter <justus@sequoia-pgp.org>
90         Kai Michaelis <kai@sequoia-pgp.org>
91         Neal H. Walfield <neal@sequoia-pgp.org>
92         Nora Widdecke <nora@sequoia-pgp.org>
93         Wiktor Kwapisiewicz <wiktor@sequoia-pgp.org>
94
95
96
970.24.0 (SEQUOIA-OPENPGP 1.0.0)    MARCH 2021                     SQ-KEYRING(1)
Impressum