NAME

       list - List all authenticated bindings (User ID and certificate pairs)

SYNOPSIS

       list [--email] [-h|--help] [PATTERN]

DESCRIPTION

       List all authenticated bindings (User ID and certificate pairs).

       Only  bindings  that  meet  the specified trust amount (by default bindings that are fully
       authenticated, i.e., have a trust amount of 120), are shown.

       Even if no bindings are shown, the exit status is 0.

       If --email is provided, then a pattern matches if it is a case  insensitive  substring  of
       the  email address as-is or the normalized email address.  Note: unlike the email address,
       the pattern is not normalized.  In particular, puny code normalization is not done on  the
       pattern.

OPTIONS

       --email
              Changes the USERID parameter to match User IDs with the specified email address.

              Interprets  the  USERID parameter as an email address, which is then used to select
              User IDs with that email address.

              Unlike when comparing User IDs, email addresses are first normalized by the  domain
              to  ASCII  using  IDNA2008  Punycode  conversion, and then converting the resulting
              email address to lowercase using the empty locale.

              If multiple User IDs match, they are each considered in  turn,  and  this  function
              returns  success if at least one of those User IDs can be authenticated.  Note: The
              paths to the different User IDs are not combined.

       -h, --help
              Print help (see a summary with '-h')

       [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.

EXTRA

       EXAMPLES:

       # List all bindings for example.org that are at least partially # authenticated.  $ sq-wot
       --keyring keyring.pgp \
           --partial \
           --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
         list @example.org

       #  The same as above, but output in DOT format and convert it to # an SVG using Graphviz's
       DOT compiler.  $ sq-wot --format dot \
           --keyring keyring.pgp \
           --partial \
           --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
         list @example.org \
         | dot -Tsvg -o example_org.svg

                                              list                                        list(1)