6b1358ea48
Fix some typos, small errors, debug leftovers. Removed unused mu-cmd-count.cc. Improve test-coverage. Fix manpage. Make the errors for unknown commands a little friendlier.
69 lines
1.8 KiB
Org Mode
69 lines
1.8 KiB
Org Mode
#+TITLE: MU VERIFY
|
||
#+MAN_CLASS_OPTIONS: :section-id "@SECTION_ID@" :date "@MAN_DATE@"
|
||
#+include: macros.inc
|
||
|
||
* NAME
|
||
|
||
mu-verify - verify message signatures and display information about them
|
||
|
||
* SYNOPSIS
|
||
|
||
*mu* [_COMMON-OPTIONS_] *verify* [_OPTIONS_] [_FILE_...]
|
||
|
||
* DESCRIPTION
|
||
|
||
*mu verify* is the *mu* command for verifying message signatures (such as PGP/GPG
|
||
signatures) and displaying information about them. The sub-command works on
|
||
message files, and does not require the message to be indexed in the database.
|
||
|
||
If no message file is provided, the command expects the message on
|
||
standard-input.
|
||
|
||
* VERIFY OPTIONS
|
||
|
||
** -r, --auto-retrieve
|
||
Attempt to find keys online (see the *auto-key-retrieve* option in the
|
||
{{{man-link(gnupg,1)}}} documentation).
|
||
|
||
** --decrypt
|
||
Attempt to decrypt the message.
|
||
|
||
#+include: "common-options.inc" :minlevel 1
|
||
|
||
* EXAMPLES
|
||
|
||
To display aggregated (one-line) information about the verification status in a
|
||
message:
|
||
#+begin_example
|
||
$ mu verify msgfile
|
||
#+end_example
|
||
|
||
To display information about all the signatures:
|
||
#+begin_example
|
||
$ mu verify --verbose msgfile
|
||
#+end_example
|
||
|
||
If you only want to use the exit code, you can use:
|
||
#+begin_example
|
||
$ mu verify --quiet msgfile
|
||
#+end_example
|
||
which does not give any output unless there is an error.
|
||
|
||
#+include: "prefooter.inc" :minlevel 1
|
||
|
||
* EXIT CODE
|
||
|
||
This command returns 0 when all signatures could be verified successfully, or a
|
||
non-zero exit code otherwise.
|
||
|
||
0. success; all signatures were verified
|
||
1. verification failed; at least one signature was bad, or could not be
|
||
verified. The latter includes messages without any signed parts,
|
||
signed parts without verifiable signatures and failures to set up the
|
||
crypto machinery for verification.
|
||
|
||
|
||
* SEE ALSO
|
||
|
||
{{{man-link(mu,1)}}}
|