sq-wot-list - Man Page

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

List all authenticated bindings (User ID and certificate pairs).

Only bindings that meet the specified trust amount (by default bindings that are fully authenticated, i.e., have a trust amount of 120), are shown.

Even if no bindings are shown, the exit status is 0.

If --email is provided, then a pattern matches if it is a case insensitive substring of the email address as-is or the normalized email address.  Note: unlike the email address, the pattern is not normalized.  In particular, puny code normalization is not done on the pattern.

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

[PATTERN]

A pattern to select the bindings to authenticate.

The pattern is treated as a UTF-8 encoded string and a case insensitive substring search (using the current locale) is performed against each User ID.  If a User ID is not valid UTF-8, the binding is ignored.

EXAMPLES:

# List all bindings for example.org that are at least partially # authenticated. $ sq-wot --keyring keyring.pgp \
   --partial \
   --trust-root 8F17777118A33DDA9BA48E62AACB3243630052D9 \
 list @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 \
 list @example.org \
 | dot -Tsvg -o example_org.svg