NAME

       path - Verify the specified path

SYNOPSIS

       path [--email] [-h|--help] [FINGERPRINT|KEYID USERID]

DESCRIPTION

       Verify the specified path.

       A path is a sequence of certificates starting at the root, and a User ID.  This function checks that each
       path  segment has a valid certification, which also satisfies any constraints (trust amount, trust depth,
       regular expressions).

       If a valid path is not found, then this subcommand also lints the path.  In particular, it report if  any
       certifications  are insufficient, e.g., not enough trust depth, or invalid, e.g., because they use SHA-1,
       but the use of SHA-1 has been disabled.

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

       [FINGERPRINT|KEYID USERID]
              A path consists of one or more certificates (designated by their fingerprint or Key ID) and ending
              in the User ID that is being authenticated

EXTRA

       EXAMPLES:

       # Verify that Neal ceritified Justus's  certificate  for  a  particular  User  ID.   $  sq-wot  --keyring
       keyring.pgp \
         path \
           8F17777118A33DDA9BA48E62AACB3243630052D9 \
           CBCD8F030588653EEDD7E2659B7DD433F254904A \
           "Justus Winter <justus@sequoia-pgp.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 \
         path \
           8F17777118A33DDA9BA48E62AACB3243630052D9 \
           CBCD8F030588653EEDD7E2659B7DD433F254904A \
           "Justus Winter <justus@sequoia-pgp.org>" \
         | dot -Tsvg -o neal--justus.svg

                                                      path                                               path(1)