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

NAME

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

SYNOPSIS

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

DESCRIPTION

12       List all authenticated bindings (User ID and certificate pairs).
13
14       Only bindings that meet the specified trust amount (by default bindings
15       that are fully authenticated, i.e., have a trust amount  of  120),  are
16       shown.
17
18       Even if no bindings are shown, the exit status is 0.
19
20       If --email is provided, then a pattern matches if it is a case insensi‐
21       tive substring of the email address as-is or the normalized  email  ad‐
22       dress.   Note: unlike the email address, the pattern is not normalized.
23       In particular, puny code normalization is not done on the pattern.
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       [PATTERN]
47              A pattern to select the bindings to authenticate.
48
49              The pattern is treated as a UTF-8 encoded string and a case  in‐
50              sensitive  substring  search  (using the current locale) is per‐
51              formed against each User ID.  If a User ID is not  valid  UTF-8,
52              the binding is ignored.
53

EXTRA

55       EXAMPLES:
56
57       #  List  all bindings for example.org that are at least partially # au‐
58       thenticated.  $ sq --keyring keyring.pgp \
59           --partial \
60           --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
61         list @example.org
62
63
64
65                                     list                              list(1)