1SQ-KEYRING-FILTER(1) USER COMMANDS SQ-KEYRING-FILTER(1)
2
3
4
6 sq-keyring-filter - Joins keys into a keyring applying a filter
7
8 This can be used to filter keys based on given predicates, e.g. whether
9 they have a user id containing an email address with a certain domain.
10 Additionally, the keys can be pruned to only include components match‐
11 ing the predicates.
12
13 If no filters are supplied, everything matches.
14
15 If multiple predicates are given, they are or'ed, i.e. a key matches if
16 any of the predicates match. To require all predicates to match, chain
17 multiple invocations of this command. See EXAMPLES for inspiration.
18
19
21 sq keyring filter [FLAGS] [OPTIONS] [--] [FILE]
22
24 -h, --help
25 Prints help information
26
27
28 -P, --prune-certs
29 Removes certificate components not matching the filter
30
31
32 -B, --binary
33 Emits binary data
34
35
36 --to-cert
37 Converts any keys in the input to certificates. Converting a
38 key to a certificate removes secret key material from the key
39 thereby turning it into a certificate.
40
42 -o, --output FILE
43 Writes to FILE or stdout if omitted
44
45
46 --name NAME
47 Matches on NAME
48
49
50 --email ADDRESS
51 Matches on email ADDRESS
52
53
54 --domain FQDN
55 Matches on email domain FQDN
56
58 FILE Reads from FILE or stdin if omitted
59
61 # Converts a key to a cert (i.e., remove any secret key material)
62 $ sq keyring filter --to-cert cat juliet.pgp
63
64 # Gets the keys with a user id on example.org
65 $ sq keyring filter --domain example.org keys.pgp
66
67 # Gets the keys with a user id on example.org or example.net
68 $ sq keyring filter --domain example.org --domain example.net
69 keys.pgp
70
71 # Gets the keys with a user id with the name Juliet
72 $ sq keyring filter --name Juliet keys.pgp
73
74 # Gets the keys with a user id with the name Juliet on example.org
75 $ sq keyring filter --domain example.org keys.pgp | keyring fil‐
76 ter --name Juliet
77
78 # Gets the keys with a user id on example.org, pruning other userids
79 $ sq keyring filter --domain example.org --prune-certs certs.pgp
80
81
83 For the full documentation see <https://docs.sequoia-pgp.org/sq/>.
84
85 sq(1), sq-armor(1), sq-autocrypt(1), sq-certify(1), sq-dearmor(1),
86 sq-decrypt(1), sq-encrypt(1), sq-inspect(1), sq-key(1),
87 sq-key-adopt(1), sq-key-attest-certifications(1),
88 sq-key-extract-cert(1), sq-key-generate(1), sq-keyring(1),
89 sq-keyring-filter(1), sq-keyring-join(1), sq-keyring-list(1),
90 sq-keyring-merge(1), sq-keyring-split(1), sq-keyserver(1),
91 sq-keyserver-get(1), sq-keyserver-send(1), sq-packet(1), sq-sign(1),
92 sq-verify(1), sq-wkd(1)
93
94
95
97 Azul <azul@sequoia-pgp.org>
98 Igor Matuszewski <igor@sequoia-pgp.org>
99 Justus Winter <justus@sequoia-pgp.org>
100 Kai Michaelis <kai@sequoia-pgp.org>
101 Neal H. Walfield <neal@sequoia-pgp.org>
102 Nora Widdecke <nora@sequoia-pgp.org>
103 Wiktor Kwapisiewicz <wiktor@sequoia-pgp.org>
104
105
106
1070.24.0 (SEQUOIA-OPENPGP 1.0.0) MARCH 2021 SQ-KEYRING-FILTER(1)