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

NAME

6       lookup - Lookup the certificates associated with a User ID
7

SYNOPSIS

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

DESCRIPTION

12       Lookup the certificates associated with a User ID.
13
14       Identifies authenticated bindings (User ID and certificate pairs) where
15       the User ID matches the specified User ID.
16
17       If a binding could be authenticated to the specified level (by default:
18       fully authenticated, i.e., a trust amount of 120), then the exit status
19       is 0.  Otherwise the exit status is 1.
20
21       If a binding could be patially authenticated (i.e., its trust amount is
22       greater  than  0),  then the binding is displayed, even if the trust is
23       below the specified threshold.
24

OPTIONS

26       --email
27              Changes the USERID parameter to match User IDs with  the  speci‐
28              fied email address.
29
30              Interprets  the  USERID  parameter as an email address, which is
31              then used to select User IDs with that email address.
32
33              Unlike when comparing User IDs, email addresses are  first  nor‐
34              malized  by  the domain to ASCII using IDNA2008 Punycode conver‐
35              sion, and then converting the resulting email address to  lower‐
36              case using the empty locale.
37
38              If  multiple  User  IDs match, they are each considered in turn,
39              and this function returns success if at least one of those  User
40              IDs can be authenticated.  Note: The paths to the different User
41              IDs are not combined.
42
43       -h, --help
44              Print help (see a summary with '-h')
45
46       <USERID>
47              The User ID to authenticate.
48
49              This is case sensitive, and must be the whole User ID, not  just
50              a substring or an email address.
51

EXTRA

53       EXAMPLES:
54
55         # Lookup a certificate with the given a User ID.
56         $ sq --keyring keyring.pgp \
57             --partial \
58             --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
59           lookup \
60             'Alice <alice@example.org>'
61
62         # Lookup a certificate with the given email address.\
63         $ sq --keyring keyring.pgp \
64             --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
65           lookup \
66             --email 'alice@example.org'
67
68
69
70                                    lookup                           lookup(1)