NAME

verify - Verifies signed messages or detached signatures

SYNOPSIS

verify [-o|--output] [--detached] [-n|--signatures] [--signer-cert] [-h|--help] [FILE]

DESCRIPTION

Verifies signed messages or detached signatures

When verifying signed messages, the message is written to stdout or the file given to --output.

When a detached message is verified, no output is produced. Detached signatures are often used to sign software packages.

Verification is only successful if there is no bad signature, and the number of successfully verified signatures reaches the threshold configured with the "--signatures" parameter. If the verification fails, the program terminates with an exit status indicating failure. In addition to that, the last 25 MiB of the message are withheld, i.e. if the message is smaller than 25 MiB, no output is produced, and if it is larger, then the output will be truncated.

The converse operation is "sq sign".

OPTIONS

-o, --output=FILE

Writes to FILE or stdout if omitted

--detached=SIG

Verifies a detached signature

-n, --signatures=N [default: 1]

Sets the threshold of valid signatures to N. If this threshold is not reached, the message will not be considered verified.

--signer-cert=CERT

Verifies signatures with CERT

-h, --help

Print help information

[FILE]

Reads from FILE or stdin if omitted

EXAMPLES

Verify a signed message

 sq verify --signer-cert juliet.pgp signed-message.pgp

Verify a detached message

 sq verify --signer-cert juliet.pgp --detached message.sig message.txt

SEE ALSO

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

sq(1) sq-armor(1) sq-autocrypt(1) sq-certify(1) sq-dearmor(1) sq-decrypt(1) sq-encrypt(1) sq-inspect(1) sq-key(1) sq-keyring(1) sq-keyserver(1) sq-packet(1) sq-revoke(1) sq-sign(1) sq-wkd(1)