.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH verify 1 "July 2022" "sq 0.26.0" "Sequoia Manual"
.SH NAME
verify \- Verifies signed messages or detached signatures
.SH SYNOPSIS
\fBverify\fR [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-detached\fR] [\fB\-n\fR|\fB\-\-signatures\fR] [\fB\-\-signer\-cert\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIFILE\fR] 
.SH DESCRIPTION
Verifies signed messages or detached signatures
.PP
When verifying signed messages, the message is written to stdout or
the file given to \-\-output.
.PP
When a detached message is verified, no output is produced.  Detached
signatures are often used to sign software packages.
.PP
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.
.PP
The converse operation is "sq sign".
.SH OPTIONS
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
Writes to FILE or stdout if omitted
.TP
\fB\-\-detached\fR=\fISIG\fR
Verifies a detached signature
.TP
\fB\-n\fR, \fB\-\-signatures\fR=\fIN\fR [default: 1]
Sets the threshold of valid signatures to N. If this threshold is not reached, the message will not be considered verified.
.TP
\fB\-\-signer\-cert\fR=\fICERT\fR
Verifies signatures with CERT
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help information
.TP
[\fIFILE\fR]
Reads from FILE or stdin if omitted
.SH EXAMPLES
 Verify a signed message
.PP
.nf
.RS
 sq verify \-\-signer\-cert juliet.pgp signed\-message.pgp
.RE
.fi
.PP
 Verify a detached message
.PP
.nf
.RS
 sq verify \-\-signer\-cert juliet.pgp \-\-detached message.sig message.txt
.RE
.fi
SEE ALSO:
If you are looking for a standalone program to verify detached
signatures, consider using sequoia\-sqv.
.SH "SEE ALSO"
For the full documentation see <https://docs.sequoia\-pgp.org/sq/>.
.PP
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)