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

NAME

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

SYNOPSIS

21       sq keyring filter [FLAGS] [OPTIONS] [--] [FILE]
22

FLAGS

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

OPTIONS

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

ARGS

58       FILE   Reads from FILE or stdin if omitted
59

EXAMPLES

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

SEE ALSO

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

AUTHORS

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)
Impressum