#+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)}}}
