NAME

       lookup - Lookup the certificates associated with a User ID

SYNOPSIS

       lookup [--email] [-h|--help] <USERID>

DESCRIPTION

       Lookup the certificates associated with a User ID.

       Identifies  authenticated  bindings  (User  ID  and  certificate  pairs) where the User ID
       matches the specified User ID.

       If  a  binding  could  be  authenticated  to  the  specified  level  (by  default:   fully
       authenticated,  i.e.,  a  trust  amount of 120), then the exit status is 0.  Otherwise the
       exit status is 1.

       If a binding could be partially authenticated (i.e., its trust amount is greater than  0),
       then the binding is displayed, even if the trust is below the specified threshold.

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

       <USERID>
              The User ID to authenticate.

              This is case sensitive, and must be the whole User ID, not just a substring  or  an
              email address.

EXTRA

       EXAMPLES:

         # Lookup a certificate with the given User ID.
         $ sq-wot --keyring keyring.pgp \
             --partial \
             --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
           lookup \
             'Alice <alice@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 \
           lookup \
             'Alice <alice@example.org>' \
           | dot -Tsvg -o alice.svg

         # Lookup a certificate with the given email address.
         $ sq-wot --keyring keyring.pgp \
             --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
           lookup \
             --email 'alice@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 \
             --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
           lookup \
             --email 'alice@example.org' \
           | dot -Tsvg -o alice.svg

                                             lookup                                     lookup(1)