1SQ-KEYRING(1) USER COMMANDS SQ-KEYRING(1)
2
3
4
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
18 sq keyring [FLAGS] <SUBCOMMAND>
19
21 -h, --help
22 Prints help information
23
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
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
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)