NAME

       sq-pki-link-list - List links

SYNOPSIS

       sq pki link list [OPTIONS] PATTERN

DESCRIPTION

       List links.

       This command lists all bindings that are linked or whose link has been retracted.

       Returns a non-zero exit code if an explicitly designated certificate was never linked.

OPTIONS

   Subcommand options
       --ca   Only lists bindings linked as CAs

              That is, only list a link if its trust depth is greater than 0.

       --cert=FINGERPRINT|KEYID
              Use certificates with the specified fingerprint or key ID

       --cert-domain=DOMAIN
              Use certificates where a user ID includes an email address for the specified domain

       --cert-email=EMAIL
              Use certificates where a user ID includes the specified email address

       --cert-grep=PATTERN
              Use certificates with a user ID that matches the pattern, case insensitively

       --cert-userid=USERID
              Use certificates with the specified user ID

        PATTERN
              A pattern to select the bindings to authenticate

              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.

   Global options
       See sq(1) for a description of the global options.

EXAMPLES

       Link the certificate EB28F26E2739A4870ECC47726F0073F60FD0CBF0 with the email address alice@example.org.

              sq pki link add \
                     --cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \
                     --email=alice@example.org

       List all links.

              sq pki link list

       List  links to certificates with an authenticated user ID that contains an email address in the specified
       domain.

              sq pki link list --cert-domain=example.org

SEE ALSO

       sq(1), sq-pki(1), sq-pki-link(1).

       For the full documentation see <https://book.sequoia-pgp.org/>.

VERSION

       1.3.1

Sequoia PGP                                           1.3.1                                                SQ(1)