.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH NAME
sq\-pki\-link\-list \- List links
.SH SYNOPSIS
.br
\fBsq pki link list\fR [\fIOPTIONS\fR] \fIPATTERN\fR
.SH DESCRIPTION
List links.
.PP
This command lists all bindings that are linked or whose link has been retracted.
.PP
Returns a non\-zero exit code if an explicitly designated certificate
was never linked.
.PP

.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-ca\fR
Only lists bindings linked as CAs
.IP
That is, only list a link if its trust depth is greater than 0.
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
Use certificates with the specified fingerprint or key ID
.TP
\fB\-\-cert\-domain\fR=\fIDOMAIN\fR
Use certificates where a user ID includes an email address for the specified domain
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
Use certificates where a user ID includes the specified email address
.TP
\fB\-\-cert\-grep\fR=\fIPATTERN\fR
Use certificates with a user ID that matches the pattern, case insensitively
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
Use certificates with the specified user ID
.TP
 \fIPATTERN\fR
A pattern to select the bindings to authenticate
.IP
The pattern is treated as a UTF\-8 encoded string and a case insensitive substring search (using the current locale) is performed against each User ID.  If a User ID is not valid UTF\-8, the binding is ignored.
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Link the certificate EB28F26E2739A4870ECC47726F0073F60FD0CBF0 with the
email address alice@example.org.
.PP
.nf
.RS
sq pki link add \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RE
.RS
.RS
\-\-email=alice@example.org
.RE
.RE
.PP
.fi

.PP
List all links.
.PP
.nf
.RS
sq pki link list
.RE
.PP
.fi

.PP
List links to certificates with an authenticated user ID that contains
an email address in the specified domain.
.PP
.nf
.RS
sq pki link list \-\-cert\-domain=example.org
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-pki\fR(1), \fBsq\-pki\-link\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org/>.
.SH VERSION
1.4.0