1path(1)                     General Commands Manual                    path(1)
2
3
4

NAME

6       path - Verify the specified path
7

SYNOPSIS

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

DESCRIPTION

12       Verify the specified path.
13
14       A  path  is a sequence of certificates starting at the root, and a User
15       ID.  This function checks that each path segment has a valid certifica‐
16       tion,  which also satisfies any constraints (trust amount, trust depth,
17       regular expressions).
18
19       If a valid path is not found, then this subcommand also lints the path.
20       In  particular, it report if any certifications are insufficient, e.g.,
21       not enough trust depth, or invalid, e.g., because they use  SHA-1,  but
22       the use of SHA-1 has been disabled.
23

OPTIONS

25       --email
26              Changes  the  USERID parameter to match User IDs with the speci‐
27              fied email address.
28
29              Interprets the USERID parameter as an email  address,  which  is
30              then used to select User IDs with that email address.
31
32              Unlike  when  comparing User IDs, email addresses are first nor‐
33              malized by the domain to ASCII using IDNA2008  Punycode  conver‐
34              sion,  and then converting the resulting email address to lower‐
35              case using the empty locale.
36
37              If multiple User IDs match, they are each  considered  in  turn,
38              and  this function returns success if at least one of those User
39              IDs can be authenticated.  Note: The paths to the different User
40              IDs are not combined.
41
42       -h, --help
43              Print help (see a summary with '-h')
44
45       [FINGERPRINT|KEYID USERID]
46              A path consists of one or more certificates (designated by their
47              fingerprint or Key ID) and ending in the User ID that  is  being
48              authenticated
49

EXTRA

51       EXAMPLES:
52
53       #  Verify  that  Neal  ceritified Justus's certificate for a particular
54       User ID.  $ sq --keyring keyring.pgp \
55         path \
56           8F17777118A33DDA9BA48E62AACB3243630052D9 \
57           CBCD8F030588653EEDD7E2659B7DD433F254904A \
58           "Justus Winter <justus@sequoia-pgp.org>"
59
60
61
62                                     path                              path(1)