b89c172c1d
- This implementation has been moved from the Sequoia repository to
its own repository. To inspect the history, either look at the
Sequoia repository, or graft it onto this repository like this:
$ git remote add sequoia https://gitlab.com/sequoia-pgp/sequoia
$ git fetch sequoia 82eb0d7b240d137141fc0aaaa3dff1685bb11864
$ git replace --graft <THIS-COMMIT> 82eb0d7b240d137141fc0aaaa3dff1685bb11864
101 lines
2.4 KiB
Groff
101 lines
2.4 KiB
Groff
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.TH SQ 1 0.28.0 Sequoia-PGP "User Commands"
|
|
.SH NAME
|
|
sq verify \- Verifies signed messages or detached signatures
|
|
.SH SYNOPSIS
|
|
.br
|
|
\fBsq\fR [\fIGLOBAL OPTIONS\fR] \fBverify\fR [\fIOPTIONS\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".
|
|
.PP
|
|
If you are looking for a standalone program to verify detached
|
|
signatures, consider using sequoia\-sqv.
|
|
.PP
|
|
|
|
|
|
.SH OPTIONS
|
|
.SS "Global options"
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-force\fR
|
|
Overwrites existing files
|
|
.TP
|
|
\fB\-\-help\fR
|
|
Print help information
|
|
.TP
|
|
\fB\-\-known\-notation\fR=\fINOTATION\fR
|
|
Adds NOTATION to the list of known notations
|
|
.TP
|
|
\fB\-\-output\-format\fR=\fIFORMAT\fR
|
|
Produces output in FORMAT, if possible
|
|
.TP
|
|
\fB\-\-output\-version\fR=\fIVERSION\fR
|
|
Produces output variant VERSION.
|
|
.TP
|
|
\fB\-\-version\fR
|
|
Print version information
|
|
.SS "Subcommand options"
|
|
.TP
|
|
\fB\-\-detached\fR=\fISIG\fR
|
|
Verifies a detached signature
|
|
.TP
|
|
\fB\-\-help\fR
|
|
Print help information
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-signatures\fR=\fIN\fR
|
|
Sets the threshold of valid signatures to N
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
|
|
Writes to FILE or stdout if omitted
|
|
.TP
|
|
\fB\-\-signer\-file\fR=\fICERT_FILE\fR
|
|
Verifies signatures using the certificate in CERT_FILE
|
|
.TP
|
|
\fB\-\-version\fR
|
|
Print version information
|
|
.SH EXAMPLES
|
|
.PP
|
|
|
|
.PP
|
|
Verify a signed message
|
|
.PP
|
|
.nf
|
|
.RS
|
|
sq verify \-\-signer\-file juliet.pgp signed\-message.pgp
|
|
.RE
|
|
.fi
|
|
.PP
|
|
|
|
.PP
|
|
Verify a detached message
|
|
.PP
|
|
.nf
|
|
.RS
|
|
sq verify \-\-signer\-file juliet.pgp \-\-detached message.sig message.txt
|
|
.RE
|
|
.fi
|
|
.SH "SEE ALSO"
|
|
.nh
|
|
\fBsq\fR(1).
|
|
.hy
|
|
.PP
|
|
For the full documentation see <https://docs.sequoia\-pgp.org/sq/>.
|
|
.SH VERSION
|
|
0.28.0 (sequoia\-openpgp 1.13.0, using Nettle)
|