.TH SQ 1 1.2.0 "Sequoia PGP" "User Commands" .SH NAME sq keyring \- Manage collections of keys or certs .SH SYNOPSIS .br \fBsq keyring list\fR [\fIOPTIONS\fR] \fIFILE\fR .br \fBsq keyring split\fR [\fIOPTIONS\fR] \fIFILE\fR .br \fBsq keyring merge\fR [\fIOPTIONS\fR] \fIFILE\fR .br \fBsq keyring filter\fR [\fIOPTIONS\fR] \fIFILE\fR .SH DESCRIPTION Manage collections of keys or certs. .PP Collections of keys or certificates (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, merge, and filter keyrings. .PP Note: In the documentation of this subcommand, we sometimes use the terms keys and certs interchangeably. .PP .SH SUBCOMMANDS .SS "sq keyring list" List keys in a keyring. .PP Prints the fingerprint as well as the primary userid for every certificate encountered in the keyring. .PP .SS "sq keyring split" Split a keyring into individual keys. .PP Splitting up a keyring into individual keys helps with curating a keyring. .PP The converse operation is `sq keyring merge`. .PP .SS "sq keyring merge" Merge keys or keyrings into a single keyring. .PP 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. .PP .SS "sq keyring filter" Join keys into a keyring applying a filter. .PP 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. .PP If no filters are supplied, everything matches. .PP 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. .PP Note: this command is considered experimental and may change in future releases. To acknowledge this, you must give the `\-\-experimental` flag when invoking this command. .PP .SH EXAMPLES .SS "sq keyring list" .PP .PP List all certificates. .PP .nf .RS sq keyring list certs.pgp .RE .PP .fi .PP List all certificates with a user ID on example.org. .PP .nf .RS sq keyring filter \-\-experimental \-\-domain=example.org \\ .RE .RS .RS certs.pgp \\ .RE .RE .RS .RS | sq keyring list .RE .RE .fi .PP .SS "sq keyring split" .PP .PP Split all certificates. .PP .nf .RS sq keyring split certs.pgp .RE .PP .fi .PP Split all certificates, merging them first to avoid duplicates. .PP .nf .RS sq keyring merge certs.pgp \\ .RE .RS .RS | sq keyring split .RE .RE .fi .PP .SS "sq keyring merge" .PP .PP Merge certificate updates. .PP .nf .RS sq keyring merge bob.pgp bob\-updates.pgp .RE .fi .PP .SS "sq keyring filter" .PP .PP Convert all keys to certificates (i.e. remove any secret key material). .PP .nf .RS sq keyring filter \-\-experimental \-\-to\-cert certs.pgp .RE .PP .fi .PP Get all certificates with a user ID on example.org. .PP .nf .RS sq keyring filter \-\-experimental \-\-domain=example.org \\ .RE .RS .RS certs.pgp .RE .RE .PP .fi .PP Get all certificates with a user ID on example.org or example.net. .PP .nf .RS sq keyring filter \-\-experimental \-\-domain=example.org \\ .RE .RS .RS \-\-domain=example.net certs.pgp .RE .RE .PP .fi .PP Get all certificates with a name user ID matching Romeo. .PP .nf .RS sq keyring filter \-\-experimental \-\-name=Romeo certs.pgp .RE .PP .fi .PP Get all certificates with a name user ID matching Romeo on example.org. .PP .nf .RS sq keyring filter \-\-experimental \-\-domain=example.org \\ .RE .RS .RS certs.pgp \\ .RE .RE .RS .RS | sq keyring filter \-\-experimental \-\-name=Romeo .RE .RE .PP .fi .PP Get all certificates with a user ID on example.org, pruning other user IDs. .PP .nf .RS sq keyring filter \-\-experimental \-\-domain=example.org \\ .RE .RS .RS \-\-prune\-certs certs.pgp .RE .RE .fi .SH "SEE ALSO" .nh \fBsq\fR(1), \fBsq\-keyring\-list\fR(1), \fBsq\-keyring\-split\fR(1), \fBsq\-keyring\-merge\fR(1), \fBsq\-keyring\-filter\fR(1). .hy .PP For the full documentation see . .SH VERSION 1.2.0 (sequoia\-openpgp 1.22.0)