summaryrefslogtreecommitdiff
path: root/manpages/taler-auditor.1.rst
diff options
context:
space:
mode:
Diffstat (limited to 'manpages/taler-auditor.1.rst')
-rw-r--r--manpages/taler-auditor.1.rst55
1 files changed, 55 insertions, 0 deletions
diff --git a/manpages/taler-auditor.1.rst b/manpages/taler-auditor.1.rst
new file mode 100644
index 00000000..e3742d94
--- /dev/null
+++ b/manpages/taler-auditor.1.rst
@@ -0,0 +1,55 @@
+taler-auditor(1)
+################
+
+.. only:: html
+
+ Name
+ ====
+
+**taler-auditor** - audit exchange
+
+Synopsis
+========
+
+**taler-auditor** [**-h** | **--help**]
+[**-m** *MASTER_KEY* | **--exchange-key=**\ ‌\ *MASTER_KEY*]
+[**-r** | **--reset**]
+
+Description
+===========
+
+**taler-auditor** is a command line tool to be used by an auditor to
+audit an exchange’s database and calculate the current financial state
+of the exchange (including revenue, amount expected in escrow and risk
+exposure). The audit is incremental. The first audit must be performed
+with the **-r** option to initialize the tables. The tool reports
+inconsistencies in the balance or incorrect cryptographic signatures
+found in the database. It does NOT check with the bank to see that the
+incoming and outgoing wire transfers that the bank claims to have
+matches the exchange’s database. Its options are as follows.
+
+**-h** \| **--help**
+ Print short help on options.
+
+**-m** *KEY* \| **--exchange-key=**\ ‌\ *KEY*
+ Public master key of the exchange in Crockford base32 encoding, for
+ example as generated by gnunet-ecc -p. If this option is missing,
+ taler-auditor will use the MASTER_PUBLIC_KEY value from the
+ “exchange” section of the configuration.
+
+**-r** \| **--reset**
+ Reset the audit, starts everything from the beginning. Useful for
+ testing and required for the first audit to setup auditor’s tables.
+ Note that if (just) the exchange key changes, the **-r** option
+ should not be used again.
+
+See Also
+========
+
+gnunet-ecc(1), taler-auditor-sign(1), taler.conf(5)
+
+Bugs
+====
+
+Report bugs by using https://bugs.gnunet.org or by sending electronic
+mail to <taler@gnu.org>.