SQ(1)

NAME
sq wot path - Verify the specified path

SYNOPSIS
sq [GLOBAL OPTIONS] wot path [OPTIONS] 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

  Global options

--cert-store=PATH
    Specifies the location of the certificate store

-f, --force=FORCE
    Overwrites existing files

--keyring=PATH
    Specifies the location of a keyring to use

--known-notation=NOTATION
    Adds NOTATION to the list of known notations

--no-cert-store=NO_CERT_STORE
    Disables the use of a certificate store

--output-format=FORMAT
    Produces output in FORMAT, if possible

--output-version=VERSION
    Produces output variant VERSION.

--pep-cert-store=PATH
    Specifies the location of a pEp certificate store

--time=TIME
    Sets the reference time as ISO 8601 formatted timestamp

--trust-root=FINGERPRINT|KEYID
    Considers the specified certificate to be a trust root

  Subcommand options

--email=EMAIL
    Changes the USERID parameter to match User IDs with the specified email address

EXAMPLES

Verify that Neal ceritified Justus's certificate for a particular User ID.

    sq --keyring keyring.pgp \

  wot 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 --format dot \

    --keyring keyring.pgp \

  wot path \

    8F17777118A33DDA9BA48E62AACB3243630052D9 \

    CBCD8F030588653EEDD7E2659B7DD433F254904A \

    "Justus Winter <justus@sequoia-pgp.org>" \

  | dot -Tsvg -o neal--justus.svg

SEE ALSO
sq(1).

For the full documentation see <https://docs.sequoia-pgp.org/sq/>.

VERSION
0.31.0 (sequoia-openpgp 1.16.0, using Nettle 3.9 (Cv448: true))