summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2019-09-18 19:23:51 +0200
committerFlorian Dold <florian.dold@gmail.com>2019-09-18 19:23:51 +0200
commit128dd21665396575f1e752d2fbc77ca5719972da (patch)
treebf43e6671f80f01e1e9415a54aa64edd51d1facf
parent12f0c8ca6c907850aa0457a5ddbdc4640a3b7a33 (diff)
downloaddocs-128dd21665396575f1e752d2fbc77ca5719972da.tar.gz
docs-128dd21665396575f1e752d2fbc77ca5719972da.tar.bz2
docs-128dd21665396575f1e752d2fbc77ca5719972da.zip
prebuilt: man
-rw-r--r--man/taler-auditor-exchange.183
-rw-r--r--man/taler-auditor-sign.186
-rw-r--r--man/taler-auditor.180
-rw-r--r--man/taler-bank-transfer.195
-rw-r--r--man/taler-config-generate.1117
-rw-r--r--man/taler-exchange-aggregator.170
-rw-r--r--man/taler-exchange-benchmark.184
-rw-r--r--man/taler-exchange-dbinit.179
-rw-r--r--man/taler-exchange-httpd.1127
-rw-r--r--man/taler-exchange-keycheck.171
-rw-r--r--man/taler-exchange-keyup.191
-rw-r--r--man/taler-exchange-wire.168
-rw-r--r--man/taler-exchange-wirewatch.193
-rw-r--r--man/taler-merchant-benchmark.1118
-rw-r--r--man/taler-merchant-httpd.178
-rw-r--r--man/taler.conf.5390
-rw-r--r--manpages/taler-auditor-exchange.1.rst60
-rw-r--r--manpages/taler-auditor-sign.1.rst63
-rw-r--r--manpages/taler-auditor.1.rst55
-rw-r--r--manpages/taler-bank-transfer.1.rst72
-rw-r--r--manpages/taler-config-generate.1.rst93
-rw-r--r--manpages/taler-exchange-aggregator.1.rst47
-rw-r--r--manpages/taler-exchange-benchmark.1.rst63
-rw-r--r--manpages/taler-exchange-dbinit.1.rst57
-rw-r--r--manpages/taler-exchange-httpd.1.rst101
-rw-r--r--manpages/taler-exchange-keycheck.1.rst49
-rw-r--r--manpages/taler-exchange-keyup.1.rst69
-rw-r--r--manpages/taler-exchange-wire.1.rst46
-rw-r--r--manpages/taler-exchange-wirewatch.1.rst57
-rw-r--r--manpages/taler-merchant-benchmark.1.rst109
-rw-r--r--manpages/taler-merchant-httpd.1.rst63
-rw-r--r--manpages/taler.conf.5.rst364
32 files changed, 1730 insertions, 1368 deletions
diff --git a/man/taler-auditor-exchange.1 b/man/taler-auditor-exchange.1
new file mode 100644
index 00000000..cb36bb24
--- /dev/null
+++ b/man/taler-auditor-exchange.1
@@ -0,0 +1,83 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-AUDITOR-EXCHANGE" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-auditor-exchange \- add or remove exchange from auditor’s list
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-auditor\-exchange\fP [\fB\-h\fP\ |\ \fB–help\fP] [\fB\-r\fP\ |\ \fB–remove\fP]
+[\fB\-m\fP\ \fIMASTERKEY\fP\ |\ \fB–exchange\-key=\fP‌\fIMASTERKEY\fP]
+[\fB\-u\fP\ \fIEXCHANGE_URL\fP\ |\ \fB–auditor\-url=\fP‌\fIEXCHANGE_URL\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-auditor\-exchange\fP is a command line tool to be used by an
+auditor to add or remove an exchange from the list of exchange’s audited
+by the auditor. You must add an exchange to that list before signing
+denomination keys with taler\-auditor\-sign or trying to audit it with
+taler\-auditor or taler\-wire\-auditor. Afterwards the exchange will be
+visible via the /exchanges API of the taler\-auditor\-httpd.
+.INDENT 0.0
+.TP
+\fB\-m\fP \fIMASTERKEY\fP | \fB–exchange\-key=\fP‌\fIMASTERKEY\fP
+Public key of the exchange in Crockford base32 encoding, for example
+as generated by gnunet\-ecc \-p.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-u\fP \fIEXCHANGE_URL\fP | \fB–auditor\-url=\fP‌\fIEXCHANGE_URL\fP
+URL of the exchange. The exchange’s HTTP API must be available at
+this address.
+.TP
+\fB\-r\fP | \fB–remove\fP
+Instead of adding the exchange, remove it. Note that this will drop
+ALL data associated with that exchange, including existing auditing
+information. So use with extreme care!
+.UNINDENT
+.SH SEE ALSO
+.sp
+gnunet\-ecc(1), taler\-auditor\-sign(1), taler.conf(5)
+.SH BUGS
+.sp
+We should optionally verify the correctness of this exchange’s base URL
+and that it matches the master public key (note that the exchange may
+still be offline, so it should be possible to bypass such a verfication
+step). Furthermore, if we do verification, as a (less secure)
+convenience option, we should make \fB\-\fP m optional and obtain it from
+the base URL.
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-auditor-sign.1 b/man/taler-auditor-sign.1
new file mode 100644
index 00000000..41e450ea
--- /dev/null
+++ b/man/taler-auditor-sign.1
@@ -0,0 +1,86 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-AUDITOR-SIGN" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-auditor-sign \- sign exchange denomination as auditor
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-auditor\-sign\fP [\fB\-a\fP\ \fIFILE\fP\ |\ \fB–auditor\-key=\fP‌\fIFILE\fP]
+[\fB\-h\fP\ |\ \fB–help\fP] [\fB\-m\fP\ \fIKEY\fP\ |\ \fB–exchange\-key=\fP‌\fIKEY\fP]
+[\fB\-u\fP\ \fIURL\fP\ |\ \fB–auditor\-url=\fP‌\fIURL\fP]
+[\fB\-r\fP\ \fIFILE\fP\ |\ \fB–exchange\-request=\fP‌\fIFILE\fP]
+[\fB\-o\fP\ \fIFILE\fP\ |\ \fB–output=\fP‌\fIFILE\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-auditor\-sign\fP is a command line tool to be used by an auditor
+to sign that he is aware of certain keys being used by a exchange. Using
+this signature, the auditor affirms that he will verify that the
+exchange is properly accounting for those coins.
+.sp
+The exchange for which keys were signed must have been added to the
+auditor using taler\-auditor\-exchange first!
+.INDENT 0.0
+.TP
+\fB\-a\fP \fIFILE\fP | \fB–auditor\-key=\fP‌\fIFILE\fP
+Location of the private EdDSA auditor key. If it does not exist, it
+will be created.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP‌\fIKEY\fP
+Public key of the exchange in Crockford base32 encoding, for example
+as generated by gnunet\-ecc \-p.
+.TP
+\fB\-u\fP \fIURL\fP | \fB–auditor\-url=\fP‌\fIURL\fP
+URL of the auditor. Provides informative link for the user to learn
+more about the auditor.
+.TP
+\fB\-r\fP \fIFILE\fP | \fB–exchange\-request=\fP‌\fIFILE\fP
+File with the exchange’s denomination key signing request as
+generated by taler\-exchange\-keyup \-o.
+.TP
+\fB\-o\fP \fIFILE\fP | \fB–output=\fP‌\fIFILE\fP
+File where the auditor should write the EdDSA signature.
+.UNINDENT
+.SH SEE ALSO
+.sp
+gnunet\-ecc(1), taler\-auditor\-exchange(1), taler\-exchange\-keyup(1),
+taler.conf(5)
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-auditor.1 b/man/taler-auditor.1
new file mode 100644
index 00000000..7a1c9654
--- /dev/null
+++ b/man/taler-auditor.1
@@ -0,0 +1,80 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-AUDITOR" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-auditor \- audit exchange
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.sp
+\fBtaler\-auditor\fP \- audit exchange
+.SH SYNOPSIS
+.sp
+\fBtaler\-auditor\fP [\fB\-h\fP\ |\ \fB–help\fP]
+[\fB\-m\fP\ \fIMASTER_KEY\fP\ |\ \fB–exchange\-key=\fP‌\fIMASTER_KEY\fP]
+[\fB\-r\fP\ |\ \fB–reset\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-auditor\fP 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 \fB\-r\fP 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.
+.INDENT 0.0
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-m\fP \fIKEY\fP | \fB–exchange\-key=\fP‌\fIKEY\fP
+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.
+.TP
+\fB\-r\fP | \fB–reset\fP
+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 \fB\-r\fP option
+should not be used again.
+.UNINDENT
+.SH SEE ALSO
+.sp
+gnunet\-ecc(1), taler\-auditor\-sign(1), taler.conf(5)
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://bugs.gnunet.org\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-bank-transfer.1 b/man/taler-bank-transfer.1
new file mode 100644
index 00000000..6a380995
--- /dev/null
+++ b/man/taler-bank-transfer.1
@@ -0,0 +1,95 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-BANK-TRANSFER" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-bank-transfer \- trigger a transfer at the bank
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-bank\-transfer\fP [\fB\-a\fP\ \fIVALUE\fP\ |\ \fB–amount=\fP‌\fIVALUE\fP]
+[\fB\-b\fP\ \fIURL\fP\ |\ \fB–bank=\fP‌\fIURL\fP]
+[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP‌\fIFILENAME\fP] [\fB\-h\fP\ |\ \fB–help\fP]
+[\fB\-D\fP\ \fIACCOUNT\fP\ |\ \fB–debit=\fP‌\fIACCOUNT\fP]
+[\fB\-C\fP\ \fIACCOUNT\fP\ |\ \fB–credit=\fP‌\fIACCOUNT\fP]
+[\fB\-s\fP\ \fISTRING\fP\ |\ \fB–subject=\fP‌\fISTRING\fP]
+[\fB\-u\fP\ \fIUSERNAME\fP\ |\ \fB–user=\fP‌\fIUSERNAME\fP]
+[\fB\-p\fP\ \fIPASSPHRASE\fP\ |\ \fB–pass=\fP‌\fIPASSPHRASE\fP]
+[\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-bank\-transfer\fP is a command line tool to trigger bank
+transfers.
+.INDENT 0.0
+.TP
+\fB\-a\fP \fIVALUE\fP | \fB–amount=\fP‌\fIVALUE\fP
+Amount to transfer. Given in the Taler\-typical format of
+CURRENCY:VALUE.FRACTION
+.TP
+\fB\-b\fP \fIURL\fP | \fB–bank=\fP‌\fIURL\fP
+URL at which the bank is operation.
+.TP
+\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP‌\fIFILENAME\fP
+Use the given configuration file.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-D\fP \fIACCOUNT\fP | \fB–debit=\fP‌\fIACCOUNT\fP
+The money should be debited from ACCOUNT. Specifies the number of the
+account.
+.TP
+\fB\-C\fP \fIACCOUNT\fP | \fB–credit=\fP‌\fIACCOUNT\fP
+The money should be credited to ACCOUNT. Specifies the number of the
+account.
+.TP
+\fB\-s\fP \fISTRING\fP | \fB–subject=\fP‌\fISTRING\fP
+Use STRING for the wire transfer subject.
+.TP
+\fB\-u\fP \fIUSERNAME\fP | \fB–user=\fP‌\fIUSERNAME\fP
+Specifies the username for authentication.
+.TP
+\fB\-p\fP \fIPASSPHRASE\fP | \fB–pass=\fP‌\fIPASSPHRASE\fP
+Specifies the pass phrase for authentication.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-bank\-manage(1), taler.conf(5)
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-config-generate.1 b/man/taler-config-generate.1
new file mode 100644
index 00000000..3fcf8bd2
--- /dev/null
+++ b/man/taler-config-generate.1
@@ -0,0 +1,117 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-CONFIG-GENERATE" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-config-generate \- tool to simplify Taler configuration generation
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-config\-generate\fP
+[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP‌\fIFILENAME\fP]
+[\fB\-C\fP\ \fICURRENCY\fP\ |\ \fB–currency=\fP‌\fICURRENCY\fP]
+[\fB\-e\fP\ |\ \fB–exchange\fP] [\fB\-f\fP\ \fIAMOUNT\fP\ |\ \fI\-wirefee=\fP‌\fIAMOUNT\fP]
+[\fB\-m\fP\ |\ \fB–merchant\fP] [\fB\-t\fP\ |\ \fB–trusted\fP]
+[\fB\-w\fP\ \fIWIREFORMAT\fP\ |\ \fB–wire\fP\ \fIWIREFORMAT\fP]
+[\fB\-j\fP\ \fIJSON\fP\ |\ \fB–wire\-json\-merchant=\fP‌\fIJSON\fP]
+[\fB\-J\fP\ \fIJSON\fP\ |\ \fB–wire\-json\-exchange=\fP‌\fIJSON\fP] [\fB–bank\-uri\fP]
+[\fB–exchange\-bank\-account\fP] [\fB–merchant\-bank\-account\fP]
+[\fB\-h\fP\ |\ \fB–help\fP]
+[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP‌\fILOGLEVEL\fP]
+[\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-config\-generate\fP can be used to generate configuration files
+for the Taler exchange or Taler merchants.
+.INDENT 0.0
+.TP
+\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP‌\fIFILENAME\fP
+Location where to write the generated configuration. Existing file
+will be updated, not overwritten.
+.TP
+\fB\-C\fP \fICURRENCY\fP | \fB–currency=\fP‌\fICURRENCY\fP
+Which currency should we use in the configuration.
+.TP
+\fB\-e\fP | \fB–exchange\fP
+Generate configuration for a Taler exchange.
+.TP
+\fB\-f\fP \fIAMOUNT\fP | \fI\-wirefee=\fP‌\fIAMOUNT\fP
+Setup wire transfer fees for the next 5 years for the exchange (for
+all wire methods).
+.TP
+\fB\-m\fP | \fB–merchant\fP
+Generate configuration for a Taler merchant.
+.TP
+\fB\-t\fP | \fB–trusted\fP
+Setup current exchange as trusted with current merchant. Generally
+only useful when configuring for testcases.
+.TP
+\fB\-w\fP \fIWIREFORMAT\fP | \fB–wire\fP \fIWIREFORMAT\fP
+Specifies which wire format to use (i.e.\ “test” or “sepa”)
+.TP
+\fB\-j\fP \fIJSON\fP | \fB–wire\-json\-merchant=\fP‌\fIJSON\fP
+Wire configuration to use for the merchant.
+.TP
+\fB\-J\fP \fIJSON\fP | \fB–wire\-json\-exchange=\fP‌\fIJSON\fP
+Wire configuration to use for the exchange.
+.TP
+\fB–bank\-uri\fP
+Alternative to specify wire configuration to use for the exchange and
+merchant for the “test” wire method. Only useful if WIREFORMAT was
+set to “test”. Specifies the URI of the bank.
+.TP
+\fB–exchange\-bank\-account\fP
+Alternative to specify wire configuration to use for the exchange for
+the “test” wire method. Only useful if WIREFORMAT was set to “test”.
+Specifies the bank account number of the exchange.
+.TP
+\fB–merchant\-bank\-account\fP
+Alternative to specify wire configuration to use for the merchant for
+the “test” wire method. Only useful if WIREFORMAT was set to “test”.
+Specifies the bank account number of the merchant.
+.TP
+\fB\-h\fP | \fB–help\fP
+Shows this man page.
+.TP
+\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP‌\fILOGLEVEL\fP
+Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and
+ERROR.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print GNUnet version number.
+.UNINDENT
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-aggregator.1 b/man/taler-exchange-aggregator.1
new file mode 100644
index 00000000..4d3773e6
--- /dev/null
+++ b/man/taler-exchange-aggregator.1
@@ -0,0 +1,70 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-AGGREGATOR" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-aggregator \- aggregate and execute exchange transactions
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-aggregator\fP
+[\fB\-d\fP\ \fIDIRNAME\fP\ |\ \fB–exchange\-dir=\fP‌\fIDIRNAME\fP]
+[\fB\-h\fP\ |\ \fB–help\fP] [\fB\-t\fP\ |\ \fB–test\fP] [\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-aggregator\fP is a command line tool to run pending
+transactions from the Taler exchange.
+.INDENT 0.0
+.TP
+\fB\-d\fP \fIDIRNAME\fP | \fB–exchange\-dir=\fP‌\fIDIRNAME\fP
+Use the configuration and other resources for the exchange to operate
+from \fIDIRNAME\fP\&.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-t\fP | \fB–test\fP
+Run in test mode and exit when idle.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-dbinit(1), taler\-exchange\-keyup(1),
+taler\-exchange\-httpd(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-benchmark.1 b/man/taler-exchange-benchmark.1
new file mode 100644
index 00000000..b4c4debd
--- /dev/null
+++ b/man/taler-exchange-benchmark.1
@@ -0,0 +1,84 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-BENCHMARK" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-benchmark \- measure exchange performance
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-benchmark\fP
+[\fB\-c\fP\ \fICONFIG_FILENAME\fP\ |\ \fB–config=\fP‌\fICONFIG_FILENAME\fP]
+[\fB\-b\fP\ \fIBANK_URL\fP\ |\ \fB—bank\-url=\fP‌\fIBANK_URL\fP]
+[\fB\-n\fP\ \fIHOWMANY_COINS\fP\ |\ \fB–coins\-number=\fP‌\fIHOWMANY_COINS\fP]
+[\fB\-l\fP\ \fILOGLEVEL\fP\ |\ \fB–log\-level=\fP‌\fILOGLEVEL\fP]
+[\fB\-h\fP\ |\ \fB–help\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-benchmark\fP is a command line tool to measure the time
+spent to serve withdrawals/deposits/refreshes. It usually needs a
+dedicate configuration file where all the services \- the exchange and
+the (fake)bank \- listen to URLs not subject to any reverse proxy, as say
+Nginx. Moreover, the benchmark runs on a “volatile” database, that means
+that table are always erased during a single benchmark run.
+.INDENT 0.0
+.TP
+\fB\-c\fP \fICONFIG_FILENAME\fP | \fB–config=\fP‌\fICONFIG_FILENAME\fP
+(Mandatory) Use CONFIG_FILENAME.
+.TP
+\fB\-b\fP \fIBANK_URL\fP | \fB—bank\-url=\fP‌\fIBANK_URL\fP
+(Mandatory) The URL where the fakebank listens at. Must match the
+host component in the exchange’s escrow account “payto” URL.
+.TP
+\fB\-n\fP \fIHOWMANY_COINS\fP | \fB–coins\-number=\fP‌\fIHOWMANY_COINS\fP
+Defaults to 1. Specifies how many coins this benchmark should
+withdraw and spend. After being spent, each coin will be refreshed
+with a REFRESH_PROBABILITY probability, which is (hardcoded as) 0.1;
+future versions of this tool should offer this parameter as a CLI
+option.
+.TP
+\fB\-l\fP \fILOGLEVEL\fP | \fB–log\-level=\fP‌\fILOGLEVEL\fP
+GNUnet\-compatible log level, takes values “ERROR/WARNING/INFO/DEBUG”
+.TP
+\fB\-h\fP | \fB–help\fP
+Prints a compiled\-in help text.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-dbinit(1), taler\-exchange\-keyup(1),
+taler\-exchange\-httpd(1), taler.conf(5)
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-dbinit.1 b/man/taler-exchange-dbinit.1
new file mode 100644
index 00000000..284e648e
--- /dev/null
+++ b/man/taler-exchange-dbinit.1
@@ -0,0 +1,79 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-DBINIT" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-dbinit \- initialize Taler exchange database
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-dbinit\fP
+[\fB\-d\fP\ \fIDIRNAME\fP\ |\ \fB–exchange\-dir=\fP‌\fIDIRNAME\fP]
+[\fB\-h\fP\ |\ \fB–help\fP] [\fB\-g\fP\ |\ \fB–gc\fP] [\fB\-r\fP\ |\ \fB–reset\fP]
+[\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-dbinit\fP is a command line tool to initialize the Taler
+exchange database. It creates the necessary tables and indices for the
+Taler exchange to operate.
+.sp
+Its options are as follows:
+.INDENT 0.0
+.TP
+\fB\-d\fP \fIDIRNAME\fP | \fB–exchange\-dir=\fP‌\fIDIRNAME\fP
+Use the configuration and other resources for the exchange to operate
+from \fIDIRNAME\fP\&.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-g\fP | \fB–gc\fP
+Garbage collect database. Deletes all unnecessary data in the
+database.
+.TP
+\fB\-r\fP | \fB–reset\fP
+Drop tables. Dangerous, will delete all existing data in the database
+before creating the tables.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-httpd(1), taler\-exchange\-keyup(1),
+taler\-exchange\-reservemod(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://bugs.gnunet.org\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-httpd.1 b/man/taler-exchange-httpd.1
new file mode 100644
index 00000000..13dd886a
--- /dev/null
+++ b/man/taler-exchange-httpd.1
@@ -0,0 +1,127 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-HTTPD" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-httpd \- run Taler exchange (with RESTful API)
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-httpd\fP [\fB\-C\fP\ |\ \fB–connection\-close\fP]
+[\fB\-c\fP\ \fIFILENAME\fP\ |\ \fB–config=\fP‌\fIFILENAME\fP]
+[\fB\-f\fP\ \fIFILENAME\fP\ |\ \fB–file\-input=\fP‌\fIFILENAME\fP]
+[\fB\-h\fP\ |\ \fB–help\fP] [\fB\-i\fP\ |\ \fB–init\-db\fP]
+[\fB\-L\fP\ \fILOGLEVEL\fP\ |\ \fB–loglevel=\fP‌\fILOGLEVEL\fP]
+[\fB\-t\fP\ \fISECONDS\fP\ |\ \fB–timeout=\fP‌\fISECONDS\fP] [\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-httpd\fP is a command line tool to run the Taler
+exchange (HTTP server). The required configuration, keys and database
+must exist before running this command.
+.sp
+Its options are as follows:
+.INDENT 0.0
+.TP
+\fB\-C\fP | \fB–connection\-close\fP
+Force each HTTP connection to be closed after each request (useful in
+combination with \fB\-f\fP to avoid having to wait for nc to time out).
+.TP
+\fB\-c\fP \fIFILENAME\fP | \fB–config=\fP‌\fIFILENAME\fP
+Use the configuration and other resources for the merchant to operate
+from FILENAME.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-i\fP | \fB–init\-db\fP
+Initialize the database by creating tables and indices if necessary.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.TP
+\fB\-f\fP \fIFILENAME\fP | \fB–file\-input=\fP‌\fIFILENAME\fP
+This option is only available if the exchange was compiled with the
+configure option –enable\-developer\-mode. It is used for generating
+test cases against the exchange using AFL. When this option is
+present, the HTTP server will
+.INDENT 7.0
+.IP 1. 3
+terminate after the first client’s HTTP connection is completed,
+and
+.IP 2. 3
+automatically start such a client using a helper process based on
+the nc(1) or ncat(1) binary using FILENAME as the standard input
+to the helper process.
+.UNINDENT
+.sp
+As a result, the process will effectively run with \fIFILENAME\fP as the
+input from an HTTP client and then immediately exit. This is useful
+to test taler\-exchange\-httpd against many different possible inputs
+in a controlled way.
+.TP
+\fB\-t\fP \fISECONDS\fP | \fB–timeout=\fP‌\fISECONDS\fP
+Specifies the number of SECONDS after which the HTTPD should close
+(idle) HTTP connections.
+.TP
+\fB\-L\fP \fILOGLEVEL\fP | \fB–loglevel=\fP‌\fILOGLEVEL\fP
+Specifies the log level to use. Accepted values are: DEBUG, INFO,
+WARNING, ERROR.
+.UNINDENT
+.SH SIGNALS
+.sp
+\fBtaler\-exchange\-httpd\fP responds to the following signals:
+.INDENT 0.0
+.TP
+.B \fBSIGUSR1\fP
+Sending a SIGUSR1 to the process will cause it to reload denomination
+and signing keys.
+.TP
+.B \fBSIGTERM\fP
+Sending a SIGTERM to the process will cause it to shutdown cleanly.
+.TP
+.B \fBSIGHUP\fP
+Sending a SIGHUP to the process will cause it to re\-execute the
+taler\-exchange\-httpd binary in the PATH, passing it the existing
+listen socket. Then the old server process will automatically exit
+after it is done handling existing client connections; the new server
+process will accept and handle new client connections.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-dbinit(1), taler\-exchange\-keyup(1),
+taler\-exchange\-reservemod(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-keycheck.1 b/man/taler-exchange-keycheck.1
new file mode 100644
index 00000000..e8172140
--- /dev/null
+++ b/man/taler-exchange-keycheck.1
@@ -0,0 +1,71 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-KEYCHECK" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-keycheck \- check validity of Taler signing and denomination keys
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-keycheck\fP
+[\fB\-d\fP\ \fIDIRNAME\fP\ |\ \fB–exchange\-dir=\fP‌\fIDIRNAME\fP]
+[\fB\-h\fP\ |\ \fB–help\fP] [\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-keycheck\fP can be used to check if the signing and
+denomination keys in the operation directory are well\-formed. This can
+be useful after importing fresh keys from the offline system to ensure
+that the files are correct.
+.sp
+Its options are as follows:
+.INDENT 0.0
+.TP
+\fB\-d\fP \fIDIRNAME\fP | \fB–exchange\-dir=\fP‌\fIDIRNAME\fP
+Use the configuration and other resources for the exchange to operate
+from \fIDIRNAME\fP\&.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-httpd(1), taler\-exchange\-keyup(1),
+taler\-exchange\-dbinit(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-keyup.1 b/man/taler-exchange-keyup.1
new file mode 100644
index 00000000..77e43add
--- /dev/null
+++ b/man/taler-exchange-keyup.1
@@ -0,0 +1,91 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-KEYUP" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-keyup \- set up Taler exchange denomination and signing
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-keyup\fP
+[\fB\-d\fP\ \fIDIRNAME\fP\ |\ \fB–exchange\-dir=\fP‌\fIDIRNAME\fP]
+[\fB\-h\fP\ |\ \fB–help\fP] [\fB\-m\fP\ \fIFILE\fP\ |\ \fB–master\-key=\fP‌\fIFILE\fP]
+[\fB\-o\fP\ \fIFILE\fP\ |\ \fB–output=\fP‌\fIFILE\fP]
+[\fB\-r\fP\ \fIDKH\fP\ |\ \fB–revoke=\fP‌\fIDKH\fP]
+[\fB\-t\fP\ \fITIMESTAMP\fP\ |\ \fB–time=\fP‌\fITIMESTAMP\fP]
+[\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-keyup\fP is a command line tool to setup Taler
+denomination and signing keys. This tool requires access to the
+exchange’s long\-term offline signing key and should be run in a secure
+(offline) environment under strict controls. The resulting keys can then
+be copied to the main online directory where the Taler HTTP server
+operates.
+.sp
+Its options are as follows:
+.INDENT 0.0
+.TP
+\fB\-d\fP \fIDIRNAME\fP | \fB–exchange\-dir=\fP‌\fIDIRNAME\fP
+Use the configuration and other resources for the exchange to operate
+from \fIDIRNAME\fP\&.
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-m\fP \fIFILE\fP | \fB–master\-key=\fP‌\fIFILE\fP
+Location of the private EdDSA offline master key of the exchange.
+.TP
+\fB\-o\fP \fIFILE\fP | \fB–output=\fP‌\fIFILE\fP
+Where to write a denomination key signing request file to be given to
+the auditor.
+.TP
+\fB\-r\fP \fIDKH\fP | \fB–revoke=\fP‌\fIDKH\fP
+Revoke the denomination key where the denomination public key’s hash
+is DKH.
+.TP
+\fB\-t\fP \fITIMESTAMP\fP | \fB–time=\fP‌\fITIMESTAMP\fP
+Operate as if the current time was \fITIMESTAMP\fP\&.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-httpd(1), taler\-exchange\-keyup(1),
+taler\-exchange\-keycheck(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-wire.1 b/man/taler-exchange-wire.1
new file mode 100644
index 00000000..9690bad2
--- /dev/null
+++ b/man/taler-exchange-wire.1
@@ -0,0 +1,68 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-WIRE" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-wire \- create the master-key signed responses to /wire
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-wire\fP [\fB\-h\fP\ |\ \fB–help\fP]
+[\fB\-m\fP\ \fIMASTERKEYFILE\fP\ |\ \fB–master=\fP‌\fIMASTERKEYFILE\fP]
+[\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-wire\fP is used to create the exchange’s reply to a
+/wire request. It converts the bank details into the appropriate signed
+response. This needs to be done using the long\-term offline master key.
+.sp
+Its options are as follows:
+.INDENT 0.0
+.TP
+\fB\-h\fP | \fB–help\fP
+Print short help on options.
+.TP
+\fB\-m\fP \fIMASTERKEYFILE\fP | \fB–master=\fP‌\fIMASTERKEYFILE\fP
+Specifies the name of the file containing the exchange’s master key.
+.TP
+\fB\-v\fP | \fB–version\fP
+Print version information.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-httpd(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-exchange-wirewatch.1 b/man/taler-exchange-wirewatch.1
new file mode 100644
index 00000000..1000caf7
--- /dev/null
+++ b/man/taler-exchange-wirewatch.1
@@ -0,0 +1,93 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-EXCHANGE-WIREWATCH" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-exchange-wirewatch \- watch for incoming wire transfers
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-exchange\-wirewatch\fP
+[\fB\-t\fP\ \fIPLUGINNAME\fP\ |\ \fB–type=\fP‌\fIPLUGINNAME\fP] [\fB\-h\fP\ |\ \fB–help\fP]
+[\fB\-T\fP\ |\ \fB–test\fP] [\fB\-r\fP\ |\ \fB–reset\fP] [\fB\-v\fP\ |\ \fB–version\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-exchange\-wirewatch\fP is a command line tool to import wire
+transactions into the Taler exchange database.
+.sp
+Its options are as follows:
+.sp
+\fB\-t\fP \fIPLUGINNAME\fP | \fB–type=\fP‌\fIPLUGINNAME\fP
+.INDENT 0.0
+.INDENT 3.5
+Use the specified wire plugin and its configuration to talk to the
+bank.
+.UNINDENT
+.UNINDENT
+.sp
+\fB\-h\fP | \fB–help\fP
+.INDENT 0.0
+.INDENT 3.5
+Print short help on options.
+.UNINDENT
+.UNINDENT
+.sp
+\fB\-T\fP | \fB–test\fP
+.INDENT 0.0
+.INDENT 3.5
+Run in test mode and exit when idle.
+.UNINDENT
+.UNINDENT
+.sp
+\fB\-r\fP | \fB–reset\fP
+.INDENT 0.0
+.INDENT 3.5
+Ignore our own database and start with transactions from the
+beginning of time.
+.UNINDENT
+.UNINDENT
+.sp
+\fB\-v\fP | \fB–version\fP
+.INDENT 0.0
+.INDENT 3.5
+Print version information.
+.UNINDENT
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-aggregator(1), taler\-exchange\-httpd(1), taler.conf(5).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-merchant-benchmark.1 b/man/taler-merchant-benchmark.1
new file mode 100644
index 00000000..ca4326f5
--- /dev/null
+++ b/man/taler-merchant-benchmark.1
@@ -0,0 +1,118 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-MERCHANT-BENCHMARK" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-merchant-benchmark \- generate Taler-style benchmarking payments
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-merchant\-benchmark\fP [\fIsubcommand\fP] [\fIoptions\fP]
+.SH DESCRIPTION
+.sp
+\fBtaler\-merchant\-benchmark\fP is a command line tool to populate your
+merchant database with payments for benchmarking.
+.SH SUBCOMMANDS
+.INDENT 0.0
+.TP
+.B ordinary
+Generate normal payments: all the payments are performed (by the
+default instance) and aggregated by the exchange. Takes the following
+options.
+.INDENT 7.0
+.TP
+.BI \-p \ PN\fP,\fB \ \-\-payments\-number\fB= PN
+Perform PN many payments, defaults to 1.
+.TP
+.BI \-t \ TN\fP,\fB \ \-\-tracks\-number\fB= TN
+Perform TN many tracking operations, defaults to 1.
+.UNINDENT
+.TP
+.B corner
+Drive the generator to create unusual situations, like for example
+leaving payments unaggregated, or using a non\-default merchant
+instance. Takes the following options.
+.INDENT 7.0
+.TP
+.BI \-t \ TC\fP,\fB \ \-\-two\-coins\fB= TC
+Perform TC many payments that use two coins (normally, all the
+payments use only one coin). TC defaults to 1.
+.TP
+.BI \-i \ AI\fP,\fB \ \-\-alt\-instance\fB= AI
+Use AI as the instance, instead of ‘default’ (which is the
+default instance used.)
+.TP
+.BI \-u \ UN\fP,\fB \ \-\-unaggregated\-number\fB= UN
+Generate UN payments that will be left unaggregated. Note that
+subsequent invocations of the generator may pick those
+unaggregated payments and actually aggregated them.
+.UNINDENT
+.UNINDENT
+.SH COMMON OPTIONS
+.INDENT 0.0
+.TP
+.BI \-k \ K\fP,\fB \ \-\-currency\fB= K
+Use currency K, mandatory.
+.TP
+.BI \-m \ URL\fP,\fB \ \-\-merchant\-url\fB= URL
+Use URL as the merchant base URL during the benchmark. The URL
+is mainly used to download and pay for contracts. Mandatory.
+.TP
+.BI \-b \ URL\fP,\fB \ \-\-bank\-url\fB= URL
+Use URL as the bank’s base URL during the benchmark. The URL is
+used to test whether the bank is up and running. Mandatory.
+.TP
+.BI \-c \ FILENAME\fP,\fB \ \-\-config\fB= FILENAME
+Use the configuration and other resources for the merchant to
+operate from FILENAME.
+.TP
+.B \-h\fP,\fB \-\-help
+Print short help on options.
+.TP
+.B \-v\fP,\fB \-\-version
+Print version information.
+.TP
+.BI \-l \ LF\fP,\fB \ \-\-logfile\fB= LF
+Sends logs to file whose path is LF.
+.TP
+.BI \-L \ LOGLEVEL\fP,\fB \ \-\-log\fB= LOGLEVEL
+Use loglevel LOGLEVEL.
+.UNINDENT
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH SEE ALSO
+.sp
+taler\-merchant\-dbinit(1), taler\-merchant\-tip\-enable(1), taler.conf(5)
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler-merchant-httpd.1 b/man/taler-merchant-httpd.1
new file mode 100644
index 00000000..58cc1d85
--- /dev/null
+++ b/man/taler-merchant-httpd.1
@@ -0,0 +1,78 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER-MERCHANT-HTTPD" "1" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler-merchant-httpd \- run Taler merchant backend (with RESTful API)
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBtaler\-merchant\-httpd\fP [\fIoptions\fP]
+.SH DESCRIPTION
+.sp
+taler\-merchant\-httpd is a command line tool to run the Taler merchant
+(HTTP backend). The required configuration and database must exist
+before running this command.
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-C\fP,\fB \-\-connection\-close
+Force each HTTP connection to be closed after each request
+(useful in combination with \-f to avoid having to wait for nc to
+time out).
+.TP
+.BI \-c \ FILENAME\fP,\fB \ \-\-config\fB= FILENAME
+Use the configuration and other resources for the merchant to
+operate from FILENAME.
+.TP
+.B \-h\fP,\fB \-\-help
+Print short help on options.
+.TP
+.B \-v\fP,\fB \-\-version
+Print version information.
+.UNINDENT
+.SH SIGNALS
+.INDENT 0.0
+.TP
+.B SIGTERM
+Sending a SIGTERM to the process will cause it to shutdown
+cleanly.
+.UNINDENT
+.SH BUGS
+.sp
+Report bugs by using Mantis <\fI\%https://gnunet.org/bugs/\fP> or by sending
+electronic mail to <\fI\%taler@gnu.org\fP>
+.SH SEE ALSO
+.sp
+taler\-merchant\-dbinit(1), taler\-merchant\-tip\-enable(1), taler.conf(5)
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/man/taler.conf.5 b/man/taler.conf.5
new file mode 100644
index 00000000..627821f1
--- /dev/null
+++ b/man/taler.conf.5
@@ -0,0 +1,390 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TALER.CONF" "5" "Sep 18, 2019" "0.6pre1" "GNU Taler"
+.SH NAME
+taler.conf \- Taler configuration file
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH DESCRIPTION
+.sp
+The basic structure of the configuration file is the following. The file
+is split into sections. Every section begins with “[SECTIONNAME]” and
+contains a number of options of the form “OPTION=VALUE”. Empty lines and
+lines beginning with a “#” are treated as comments. Files containing
+default values for many of the options described below are installed
+under $TALER_PREFIX/share/taler/config.d/. The configuration file given
+with \fB\-c\fP to Taler binaries overrides these defaults.
+.SS Global Options
+.sp
+The following options are from the “[taler]” section and used by
+virtually all Taler components.
+.INDENT 0.0
+.TP
+.B CURRENCY
+Name of the currency, i.e.\ “EUR” for Euro.
+.UNINDENT
+.sp
+The “[PATHS]” section is special in that it contains paths that can be
+referenced using “$” in other configuration values that specify
+filenames. For Taler, it commonly contains the following paths:
+.INDENT 0.0
+.TP
+.B TALER_HOME
+Home directory of the user, usually “${HOME}”. Can be overwritten by
+testcases by setting ${TALER_TEST_HOME}.
+.TP
+.B TALER_DATA_HOME
+Where should Taler store its long\-term data. Usually
+“${TALER_HOME}/.local/share/taler/”
+.TP
+.B TALER_CONFIG_HOME
+Where is the Taler configuration kept. Usually
+“${TALER_HOME}/.config/taler/”
+.TP
+.B TALER_CACHE_HOME
+Where should Taler store cached data. Usually
+“${TALER_HOME}/.cache/taler/”
+.TP
+.B TALER_RUNTIME_DIR
+Where should Taler store system runtime data (like UNIX domain
+sockets). Usually “${TMP}/taler\-system\-runtime”.
+.UNINDENT
+.SS EXCHANGE OPTIONS
+.sp
+The following options are from the “[exchange]” section and used by most
+exchange tools.
+.INDENT 0.0
+.TP
+.B DB
+Plugin to use for the database, i.e.\ “postgres”
+.TP
+.B PORT
+Port on which the HTTP server listens, i.e.\ 8080.
+.TP
+.B MASTER_PUBLIC_KEY
+Crockford Base32\-encoded master public key, public version of the
+exchange\'s long\-time offline signing key.
+.TP
+.B MASTER_PRIV_FILE
+Location of the master private key on disk. Only used by tools that
+can be run offline (as the master key is for offline signing).
+.TP
+.B BASE_URL
+Specifies the base URL under which the exchange can be reached. Added
+to wire transfers to enable tracking by merchants.
+.TP
+.B SIGNKEY_DURATION
+For how long is a signing key valid?
+.TP
+.B LEGAL_DURATION
+For how long are signatures with signing keys legally valid?
+.TP
+.B LOOKAHEAD_SIGN
+How long do we generate denomination and signing keys ahead of time?
+.TP
+.B LOOKAHEAD_PROVIDE
+How long into the future do we provide signing and denomination keys
+to clients?
+.UNINDENT
+.SS EXCHANGE POSTGRES BACKEND DATABASE OPTIONS
+.sp
+The following options must be in section “[exchangedb\-postgres]” if the
+“postgres” plugin was selected for the database.
+.INDENT 0.0
+.TP
+.B CONFIG
+How to access the database, i.e.\ “postgres:///taler” to use the
+“taler” database. Testcases use “talercheck”.
+.UNINDENT
+.SS MERCHANT OPTIONS
+.sp
+The following options are from the “[merchant]” section and used by the
+merchant backend.
+.INDENT 0.0
+.TP
+.B DB
+Plugin to use for the database, i.e.\ “postgres”
+.TP
+.B PORT
+Port on which the HTTP server listens, i.e.\ 8080.
+.TP
+.B WIRE_TRANSFER_DELAY
+How quickly do we want the exchange to send us money? Note that wire
+transfer fees will be higher if we ask for money to be wired often.
+Given as a relative time, i.e.\ “5 s”
+.TP
+.B DEFAULT_MAX_WIRE_FEE
+Maximum wire fee we are willing to accept from exchanges. Given as a
+Taler amount, i.e.\ “EUR:0.1”
+.TP
+.B DEFAULT_MAX_DEPOSIT_FEE
+Maximum deposit fee we are willing to cover. Given as a Taler amount,
+i.e.\ “EUR:0.1”
+.UNINDENT
+.SS MERCHANT POSTGRES BACKEND DATABASE OPTIONS
+.sp
+The following options must be in section “[merchantdb\-postgres]” if the
+“postgres” plugin was selected for the database.
+.INDENT 0.0
+.TP
+.B CONFIG
+How to access the database, i.e.\ “postgres:///taler” to use the
+“taler” database. Testcases use “talercheck”.
+.UNINDENT
+.SS MERCHANT INSTANCES
+.sp
+The merchant configuration must specify a set of instances, containing
+at least the “default” instance. The following options must be given in
+each “[instance\-NAME]” section.
+.INDENT 0.0
+.TP
+.B KEYFILE
+Name of the file where the instance\'s private key is to be stored,
+i.e.\ “${TALER_CONFIG_HOME}/merchant/instance/name.priv”
+.TP
+.B NAME
+Human\-readable name of the instance, i.e.\ “Kudos Inc.”
+.UNINDENT
+.sp
+Additionally, for instances that support tipping, the following options
+are required.
+.INDENT 0.0
+.TP
+.B TIP_EXCHANGE
+Base\-URL of the exchange that holds the reserve for tipping,
+i.e.\ “\fI\%https://exchange.demo.taler.net/\fP”
+.TP
+.B TIP_EXCHANGE_PRIV_FILENAME
+Filename with the private key granting access to the reserve,
+i.e.\ “${TALER_CONFIG_HOME}/merchant/reserve/tip.priv”
+.UNINDENT
+.SS KNOWN EXCHANGES (for merchants and wallets)
+.sp
+The merchant configuration can include a list of known exchanges if the
+merchant wants to specify that certain exchanges are explicitly trusted.
+For each trusted exchange, a section [exchange\-NAME] must exist, where
+NAME is a merchant\-given name for the exchange. The following options
+must be given in each “[exchange\-NAME]” section.
+.INDENT 0.0
+.TP
+.B BASE_URL
+Base URL of the exchange, i.e.\ “\fI\%https://exchange.demo.taler.net/\fP”
+.TP
+.B MASTER_KEY
+Crockford Base32 encoded master public key, public version of the
+exchange\'s long\-time offline signing key
+.TP
+.B CURRENCY
+Name of the currency for which this exchange is trusted, i.e.\ “KUDOS”
+.UNINDENT
+.SS KNOWN AUDITORS (for merchants and wallets)
+.sp
+The merchant configuration can include a list of known exchanges if the
+merchant wants to specify that certain auditors are explicitly trusted.
+For each trusted exchange, a section [auditor\-NAME] must exist, where
+NAME is a merchant\-given name for the exchange. The following options
+must be given in each “[auditor\-NAME]” section.
+.INDENT 0.0
+.TP
+.B BASE_URL
+Base URL of the auditor, i.e.\ “\fI\%https://auditor.demo.taler.net/\fP”
+.TP
+.B AUDITOR_KEY
+Crockford Base32 encoded auditor public key.
+.TP
+.B CURRENCY
+Name of the currency for which this auditor is trusted, i.e.\ “KUDOS”
+.UNINDENT
+.SS ACCOUNT OPTIONS (for exchanges and merchants)
+.sp
+An exchange (or merchant) can have multiple bank accounts. The following
+options are for sections named “[account\-SOMETHING]”. The SOMETHING is
+arbitrary and should be chosen to uniquely identify the bank account for
+the operator. Additional authentication options may need to be specified
+in the account section depending on the PLUGIN used.
+.INDENT 0.0
+.TP
+.B URL
+Specifies the payto://\-URL of the account. The general format is
+payto://METHOD/DETAILS. This option is used for exchanges and
+merchants.
+.TP
+.B WIRE_RESPONSE
+Specifies the name of the file in which the /wire response for this
+account should be located. Used by the Taler exchange service and the
+taler\-exchange\-wire tool and the taler\-merchant\-httpd (to generate
+the files).
+.TP
+.B PLUGIN
+Name of the plugin can be used to access the account
+(i.e.\ “taler\-bank” or “ebics”). Used by the merchant backend for back
+office operations (i.e.\ to identify incoming wire transfers) and by
+the exchange.
+.TP
+.B ENABLE_DEBIT
+Must be set to YES for the accounts that the
+taler\-exchange\-aggregator should debit. Not used by merchants.
+.TP
+.B ENABLE_CREDIT
+Must be set to YES for the accounts that the taler\-exchange\-wirewatch
+should check for credits. It is yet uncertain if the merchant
+implementation may check this flag as well.
+.TP
+.B HONOR_instance
+Must be set to YES for the instances (where “instance” is the section
+name of the instance) of the merchant backend that should allow
+incoming wire transfers for this bank account.
+.TP
+.B ACTIVE_instance
+Must be set to YES for the instances (where “instance” is the section
+name of the instance) of the merchant backend that should use this
+bank account in new offers/contracts. Setting ACTIVE_instance to YES
+requires also setting ENABLE_instance to YES.
+.UNINDENT
+.SS TALER\-BANK AUTHENTICATION OPTIONS (for accounts)
+.sp
+The following authentication options are supported by the “taler\-bank”
+wire plugin. They must be specified in the “[account\-]” section that
+uses the “taler\-bank” plugin.
+.INDENT 0.0
+.TP
+.B TALER_BANK_AUTH_METHOD
+Authentication method to use. “none” or “basic” are currently
+supported.
+.TP
+.B USERNAME
+Username to use for authentication. Used with the “basic”
+authentication method.
+.TP
+.B PASSWORD
+Password to use for authentication. Used with the “basic”
+authentication method.
+.UNINDENT
+.SS EBICS AUTHENTICATION OPTIONS
+.sp
+The following authentication options are supported by the “ebics” wire
+plugin. They must be specified in the “[account\-]” section that uses the
+“ebics” plugin.
+.INDENT 0.0
+.TP
+.B NONE
+Currently the “ebics” implementation is incomplete and does not
+support authentication.
+.UNINDENT
+.SS EXCHANGE WIRE FEE OPTIONS
+.sp
+For each supported wire method (i.e.\ “x\-taler\-bank” or “sepa”), sections
+named “[fees\-METHOD]” state the (aggregate) wire transfer fee and the
+reserve closing fees charged by the exchange. Note that fees are
+specified using the name of the wire method, not by the plugin name. You
+need to replace “YEAR” in the option name by the calendar year for which
+the fee should apply. Usually, fees should be given for serveral years
+in advance.
+.INDENT 0.0
+.TP
+.B WIRE\-FEE\-YEAR
+Aggregate wire transfer fee merchants are charged in YEAR. Specified
+as a Taler amount using the usual amount syntax
+(CURRENCY:VALUE.FRACTION).
+.TP
+.B CLOSING\-FEE\-YEAR
+Reserve closing fee customers are charged in YEAR. Specified as a
+Taler amount using the usual amount syntax (CURRENCY:VALUE.FRACTION).
+.UNINDENT
+.SS EXCHANGE COIN OPTIONS
+.sp
+The following options must be in sections starting with \fB"[coin_]"\fP and
+are used by taler\-exchange\-keyup to create denomination keys.
+.INDENT 0.0
+.TP
+.B VALUE
+Value of the coin, i.e.\ “EUR:1.50” for 1 Euro and 50 Cents (per
+coin).
+.TP
+.B DURATION_OVERLAP
+How much should validity periods for these coins overlap?
+.TP
+.B DURATION_WITHDRAW
+How long should the same key be used for clients to withdraw coins of
+this value?
+.TP
+.B DURATION_SPEND
+How long do clients have to spend these coins?
+.TP
+.B FEE_WITHDRAW
+What fee is charged for withdrawl?
+.TP
+.B FEE_DEPOSIT
+What fee is charged for depositing?
+.TP
+.B FEE_REFRESH
+What fee is charged for refreshing?
+.TP
+.B FEE_REFUND
+What fee is charged for refunds? When a coin is refunded, the deposit
+fee is returned. Instead, the refund fee is charged to the customer.
+.TP
+.B RSA_KEYSIZE
+What is the RSA keysize modulos (in bits)?
+.UNINDENT
+.SS AUDITOR OPTIONS
+.sp
+The following options must be in section “[auditor]” for the Taler
+auditor.
+.INDENT 0.0
+.TP
+.B DB
+Plugin to use for the database, i.e.\ “postgres”
+.TP
+.B AUDITOR_PRIV_FILE
+Name of the file containing the auditor’s private key
+.UNINDENT
+.SS AUDITOR POSTGRES BACKEND DATABASE OPTIONS
+.sp
+The following options must be in section “[auditordb\-postgres]” if the
+“postgres” plugin was selected for the database.
+.INDENT 0.0
+.TP
+.B CONFIG
+How to access the database, i.e.\ “postgres:///taler” to use the
+“taler” database. Testcases use “talercheck”.
+.UNINDENT
+.SH SEE ALSO
+.sp
+taler\-exchange\-dbinit(1), taler\-exchange\-httpd(1),
+taler\-exchange\-keyup(1), taler\-exchange\-wire(1).
+.SH BUGS
+.sp
+Report bugs by using \fI\%https://gnunet.org/bugs/\fP or by sending electronic
+mail to <\fI\%taler@gnu.org\fP>.
+.SH AUTHOR
+GNU Taler contributors
+.SH COPYRIGHT
+2014, 2015, 2016 Florian Dold, Benedikt Muller, Sree Harsha Totakura, Christian Grothoff, Marcello Stanisci (GPLv3+ or GFDL 1.3+)
+.\" Generated by docutils manpage writer.
+.
diff --git a/manpages/taler-auditor-exchange.1.rst b/manpages/taler-auditor-exchange.1.rst
deleted file mode 100644
index b7ef1d2f..00000000
--- a/manpages/taler-auditor-exchange.1.rst
+++ /dev/null
@@ -1,60 +0,0 @@
-taler-auditor-exchange(1)
-##########################
-
-.. only:: html
-
- Name
- ====
-
- **taler-auditor-exchange** - add or remove exchange from auditor’s list
-
-Synopsis
-========
-
-**taler-auditor-exchange** [**-h** | **--help**] [**-r** | **--remove**]
-[**-m** *MASTERKEY* | **--exchange-key=**\ ‌\ *MASTERKEY*]
-[**-u** *EXCHANGE_URL* | **--auditor-url=**\ ‌\ *EXCHANGE_URL*]
-
-Description
-===========
-
-**taler-auditor-exchange** is a command line tool to be used by an
-auditor to add or remove an exchange from the list of exchange’s audited
-by the auditor. You must add an exchange to that list before signing
-denomination keys with taler-auditor-sign or trying to audit it with
-taler-auditor or taler-wire-auditor. Afterwards the exchange will be
-visible via the /exchanges API of the taler-auditor-httpd.
-
-**-m** *MASTERKEY* \| **--exchange-key=**\ ‌\ *MASTERKEY*
- Public key of the exchange in Crockford base32 encoding, for example
- as generated by gnunet-ecc -p.
-
-**-h** \| **--help**
- Print short help on options.
-
-**-u** *EXCHANGE_URL* \| **--auditor-url=**\ ‌\ *EXCHANGE_URL*
- URL of the exchange. The exchange’s HTTP API must be available at
- this address.
-
-**-r** \| **--remove**
- Instead of adding the exchange, remove it. Note that this will drop
- ALL data associated with that exchange, including existing auditing
- information. So use with extreme care!
-
-See Also
-========
-
-gnunet-ecc(1), taler-auditor-sign(1), taler.conf(5)
-
-Bugs
-====
-
-We should optionally verify the correctness of this exchange’s base URL
-and that it matches the master public key (note that the exchange may
-still be offline, so it should be possible to bypass such a verfication
-step). Furthermore, if we do verification, as a (less secure)
-convenience option, we should make **-** m optional and obtain it from
-the base URL.
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>. \ No newline at end of file
diff --git a/manpages/taler-auditor-sign.1.rst b/manpages/taler-auditor-sign.1.rst
deleted file mode 100644
index b9c34fb8..00000000
--- a/manpages/taler-auditor-sign.1.rst
+++ /dev/null
@@ -1,63 +0,0 @@
-taler-auditor-sign(1)
-#####################
-
-.. only:: html
-
- Name
- ====
-
- **taler-auditor-sign** - sign exchange denomination as auditor
-
-Synopsis
-========
-
-**taler-auditor-sign** [**-a** *FILE* | **--auditor-key=**\ ‌\ *FILE*]
-[**-h** | **--help**] [**-m** *KEY* | **--exchange-key=**\ ‌\ *KEY*]
-[**-u** *URL* | **--auditor-url=**\ ‌\ *URL*]
-[**-r** *FILE* | **--exchange-request=**\ ‌\ *FILE*]
-[**-o** *FILE* | **--output=**\ ‌\ *FILE*]
-
-Description
-===========
-
-**taler-auditor-sign** is a command line tool to be used by an auditor
-to sign that he is aware of certain keys being used by a exchange. Using
-this signature, the auditor affirms that he will verify that the
-exchange is properly accounting for those coins.
-
-The exchange for which keys were signed must have been added to the
-auditor using taler-auditor-exchange first!
-
-**-a** *FILE* \| **--auditor-key=**\ ‌\ *FILE*
- Location of the private EdDSA auditor key. If it does not exist, it
- will be created.
-
-**-h** \| **--help**
- Print short help on options.
-
-**-m** *KEY* \| **--exchange-key=**\ ‌\ *KEY*
- Public key of the exchange in Crockford base32 encoding, for example
- as generated by gnunet-ecc -p.
-
-**-u** *URL* \| **--auditor-url=**\ ‌\ *URL*
- URL of the auditor. Provides informative link for the user to learn
- more about the auditor.
-
-**-r** *FILE* \| **--exchange-request=**\ ‌\ *FILE*
- File with the exchange’s denomination key signing request as
- generated by taler-exchange-keyup -o.
-
-**-o** *FILE* \| **--output=**\ ‌\ *FILE*
- File where the auditor should write the EdDSA signature.
-
-See Also
-========
-
-gnunet-ecc(1), taler-auditor-exchange(1), taler-exchange-keyup(1),
-taler.conf(5)
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-auditor.1.rst b/manpages/taler-auditor.1.rst
deleted file mode 100644
index e3742d94..00000000
--- a/manpages/taler-auditor.1.rst
+++ /dev/null
@@ -1,55 +0,0 @@
-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>.
diff --git a/manpages/taler-bank-transfer.1.rst b/manpages/taler-bank-transfer.1.rst
deleted file mode 100644
index 12944e60..00000000
--- a/manpages/taler-bank-transfer.1.rst
+++ /dev/null
@@ -1,72 +0,0 @@
-taler-bank-transfer(1)
-######################
-
-.. only:: html
-
- Name
- ====
-
- **taler-bank-transfer** - trigger a transfer at the bank
-
-Synopsis
-========
-
-**taler-bank-transfer** [**-a** *VALUE* | **--amount=**\ ‌\ *VALUE*]
-[**-b** *URL* | **--bank=**\ ‌\ *URL*]
-[**-c** *FILENAME* | **--config=**\ ‌\ *FILENAME*] [**-h** | **--help**]
-[**-D** *ACCOUNT* | **--debit=**\ ‌\ *ACCOUNT*]
-[**-C** *ACCOUNT* | **--credit=**\ ‌\ *ACCOUNT*]
-[**-s** *STRING* | **--subject=**\ ‌\ *STRING*]
-[**-u** *USERNAME* | **--user=**\ ‌\ *USERNAME*]
-[**-p** *PASSPHRASE* | **--pass=**\ ‌\ *PASSPHRASE*]
-[**-v** | **--version**]
-
-Description
-===========
-
-**taler-bank-transfer** is a command line tool to trigger bank
-transfers.
-
-**-a** *VALUE* \| **--amount=**\ ‌\ *VALUE*
- Amount to transfer. Given in the Taler-typical format of
- CURRENCY:VALUE.FRACTION
-
-**-b** *URL* \| **--bank=**\ ‌\ *URL*
- URL at which the bank is operation.
-
-**-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME*
- Use the given configuration file.
-
-**-h** \| **--help**
- Print short help on options.
-
-**-D** *ACCOUNT* \| **--debit=**\ ‌\ *ACCOUNT*
- The money should be debited from ACCOUNT. Specifies the number of the
- account.
-
-**-C** *ACCOUNT* \| **--credit=**\ ‌\ *ACCOUNT*
- The money should be credited to ACCOUNT. Specifies the number of the
- account.
-
-**-s** *STRING* \| **--subject=**\ ‌\ *STRING*
- Use STRING for the wire transfer subject.
-
-**-u** *USERNAME* \| **--user=**\ ‌\ *USERNAME*
- Specifies the username for authentication.
-
-**-p** *PASSPHRASE* \| **--pass=**\ ‌\ *PASSPHRASE*
- Specifies the pass phrase for authentication.
-
-**-v** \| **--version**
- Print version information.
-
-See Also
-========
-
-taler-bank-manage(1), taler.conf(5)
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>
diff --git a/manpages/taler-config-generate.1.rst b/manpages/taler-config-generate.1.rst
deleted file mode 100644
index f7fd1cc5..00000000
--- a/manpages/taler-config-generate.1.rst
+++ /dev/null
@@ -1,93 +0,0 @@
-taler-config-generate(1)
-########################
-
-.. only:: html
-
- Name
- ====
-
- **taler-config-generate** - tool to simplify Taler configuration
- generation
-
-Synopsis
-========
-
-**taler-config-generate**
-[**-c** *FILENAME* | **--config=**\ ‌\ *FILENAME*]
-[**-C** *CURRENCY* | **--currency=**\ ‌\ *CURRENCY*]
-[**-e** | **--exchange**] [**-f** *AMOUNT* | *-wirefee=*\ ‌\ *AMOUNT*]
-[**-m** | **--merchant**] [**-t** | **--trusted**]
-[**-w** *WIREFORMAT* | **--wire** *WIREFORMAT*]
-[**-j** *JSON* | **--wire-json-merchant=**\ ‌\ *JSON*]
-[**-J** *JSON* | **--wire-json-exchange=**\ ‌\ *JSON*] [**--bank-uri**]
-[**--exchange-bank-account**] [**--merchant-bank-account**]
-[**-h** | **--help**]
-[**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*]
-[**-v** | **--version**]
-
-Description
-===========
-
-**taler-config-generate** can be used to generate configuration files
-for the Taler exchange or Taler merchants.
-
-**-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME*
- Location where to write the generated configuration. Existing file
- will be updated, not overwritten.
-
-**-C** *CURRENCY* \| **--currency=**\ ‌\ *CURRENCY*
- Which currency should we use in the configuration.
-
-**-e** \| **--exchange**
- Generate configuration for a Taler exchange.
-
-**-f** *AMOUNT* \| *-wirefee=*\ ‌\ *AMOUNT*
- Setup wire transfer fees for the next 5 years for the exchange (for
- all wire methods).
-
-**-m** \| **--merchant**
- Generate configuration for a Taler merchant.
-
-**-t** \| **--trusted**
- Setup current exchange as trusted with current merchant. Generally
- only useful when configuring for testcases.
-
-**-w** *WIREFORMAT* \| **--wire** *WIREFORMAT*
- Specifies which wire format to use (i.e. “test” or “sepa”)
-
-**-j** *JSON* \| **--wire-json-merchant=**\ ‌\ *JSON*
- Wire configuration to use for the merchant.
-
-**-J** *JSON* \| **--wire-json-exchange=**\ ‌\ *JSON*
- Wire configuration to use for the exchange.
-
-**--bank-uri**
- Alternative to specify wire configuration to use for the exchange and
- merchant for the “test” wire method. Only useful if WIREFORMAT was
- set to “test”. Specifies the URI of the bank.
-
-**--exchange-bank-account**
- Alternative to specify wire configuration to use for the exchange for
- the “test” wire method. Only useful if WIREFORMAT was set to “test”.
- Specifies the bank account number of the exchange.
-
-**--merchant-bank-account**
- Alternative to specify wire configuration to use for the merchant for
- the “test” wire method. Only useful if WIREFORMAT was set to “test”.
- Specifies the bank account number of the merchant.
-
-**-h** \| **--help**
- Shows this man page.
-
-**-L** *LOGLEVEL* \| **--loglevel=**\ ‌\ *LOGLEVEL*
- Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and
- ERROR.
-
-**-v** \| **--version**
- Print GNUnet version number.
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-aggregator.1.rst b/manpages/taler-exchange-aggregator.1.rst
deleted file mode 100644
index 8f9afaaf..00000000
--- a/manpages/taler-exchange-aggregator.1.rst
+++ /dev/null
@@ -1,47 +0,0 @@
-taler-exchange-aggregator(1)
-############################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-aggregator** - aggregate and execute exchange transactions
-
-Synopsis
-========
-
-**taler-exchange-aggregator**
-[**-d** *DIRNAME* | **--exchange-dir=**\ ‌\ *DIRNAME*]
-[**-h** | **--help**] [**-t** | **--test**] [**-v** | **--version**]
-
-Description
-===========
-
-**taler-exchange-aggregator** is a command line tool to run pending
-transactions from the Taler exchange.
-
-**-d** *DIRNAME* \| **--exchange-dir=**\ ‌\ *DIRNAME*
- Use the configuration and other resources for the exchange to operate
- from *DIRNAME*.
-
-**-h** \| **--help**
- Print short help on options.
-
-**-t** \| **--test**
- Run in test mode and exit when idle.
-
-**-v** \| **--version**
- Print version information.
-
-See Also
-========
-
-taler-exchange-dbinit(1), taler-exchange-keyup(1),
-taler-exchange-httpd(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-benchmark.1.rst b/manpages/taler-exchange-benchmark.1.rst
deleted file mode 100644
index 4ea23784..00000000
--- a/manpages/taler-exchange-benchmark.1.rst
+++ /dev/null
@@ -1,63 +0,0 @@
-taler-exchange-benchmark(1)
-###########################
-
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-benchmark** - measure exchange performance
-
-
-Synopsis
-========
-
-**taler-exchange-benchmark**
-[**-c** *CONFIG_FILENAME* | **--config=**\ ‌\ *CONFIG_FILENAME*]
-[**-b** *BANK_URL* | **—bank-url=**\ ‌\ *BANK_URL*]
-[**-n** *HOWMANY_COINS* | **--coins-number=**\ ‌\ *HOWMANY_COINS*]
-[**-l** *LOGLEVEL* | **--log-level=**\ ‌\ *LOGLEVEL*]
-[**-h** | **--help**]
-
-Description
-===========
-
-**taler-exchange-benchmark** is a command line tool to measure the time
-spent to serve withdrawals/deposits/refreshes. It usually needs a
-dedicate configuration file where all the services - the exchange and
-the (fake)bank - listen to URLs not subject to any reverse proxy, as say
-Nginx. Moreover, the benchmark runs on a “volatile” database, that means
-that table are always erased during a single benchmark run.
-
-**-c** *CONFIG_FILENAME* \| **--config=**\ ‌\ *CONFIG_FILENAME*
- (Mandatory) Use CONFIG_FILENAME.
-
-**-b** *BANK_URL* \| **—bank-url=**\ ‌\ *BANK_URL*
- (Mandatory) The URL where the fakebank listens at. Must match the
- host component in the exchange’s escrow account “payto” URL.
-
-**-n** *HOWMANY_COINS* \| **--coins-number=**\ ‌\ *HOWMANY_COINS*
- Defaults to 1. Specifies how many coins this benchmark should
- withdraw and spend. After being spent, each coin will be refreshed
- with a REFRESH_PROBABILITY probability, which is (hardcoded as) 0.1;
- future versions of this tool should offer this parameter as a CLI
- option.
-
-**-l** *LOGLEVEL* \| **--log-level=**\ ‌\ *LOGLEVEL*
- GNUnet-compatible log level, takes values “ERROR/WARNING/INFO/DEBUG”
-
-**-h** \| **--help**
- Prints a compiled-in help text.
-
-See Also
-========
-
-taler-exchange-dbinit(1), taler-exchange-keyup(1),
-taler-exchange-httpd(1), taler.conf(5)
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-dbinit.1.rst b/manpages/taler-exchange-dbinit.1.rst
deleted file mode 100644
index b693e7fc..00000000
--- a/manpages/taler-exchange-dbinit.1.rst
+++ /dev/null
@@ -1,57 +0,0 @@
-taler-exchange-dbinit(1)
-########################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-dbinit** - initialize Taler exchange database
-
-
-Synopsis
-========
-
-**taler-exchange-dbinit**
-[**-d** *DIRNAME* | **–exchange-dir=**\ ‌\ *DIRNAME*]
-[**-h** | **–help**] [**-g** | **–gc**] [**-r** | **–reset**]
-[**-v** | **–version**]
-
-Description
-===========
-
-**taler-exchange-dbinit** is a command line tool to initialize the Taler
-exchange database. It creates the necessary tables and indices for the
-Taler exchange to operate.
-
-Its options are as follows:
-
-**-d** *DIRNAME* \| **–exchange-dir=**\ ‌\ *DIRNAME*
- Use the configuration and other resources for the exchange to operate
- from *DIRNAME*.
-
-**-h** \| **–help**
- Print short help on options.
-
-**-g** \| **–gc**
- Garbage collect database. Deletes all unnecessary data in the
- database.
-
-**-r** \| **–reset**
- Drop tables. Dangerous, will delete all existing data in the database
- before creating the tables.
-
-**-v** \| **–version**
- Print version information.
-
-See Also
-========
-
-taler-exchange-httpd(1), taler-exchange-keyup(1),
-taler-exchange-reservemod(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://bugs.gnunet.org or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-httpd.1.rst b/manpages/taler-exchange-httpd.1.rst
deleted file mode 100644
index 6c9977a6..00000000
--- a/manpages/taler-exchange-httpd.1.rst
+++ /dev/null
@@ -1,101 +0,0 @@
-taler-exchange-httpd(1)
-#######################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-httpd** - run Taler exchange (with RESTful API)
-
-Synopsis
-========
-
-**taler-exchange-httpd** [**-C** | **–connection-close**]
-[**-c** *FILENAME* | **–config=**\ ‌\ *FILENAME*]
-[**-f** *FILENAME* | **–file-input=**\ ‌\ *FILENAME*]
-[**-h** | **–help**] [**-i** | **–init-db**]
-[**-L** *LOGLEVEL* | **–loglevel=**\ ‌\ *LOGLEVEL*]
-[**-t** *SECONDS* | **–timeout=**\ ‌\ *SECONDS*] [**-v** | **–version**]
-
-Description
-===========
-
-**taler-exchange-httpd** is a command line tool to run the Taler
-exchange (HTTP server). The required configuration, keys and database
-must exist before running this command.
-
-Its options are as follows:
-
-**-C** \| **–connection-close**
- Force each HTTP connection to be closed after each request (useful in
- combination with **-f** to avoid having to wait for nc to time out).
-
-**-c** *FILENAME* \| **–config=**\ ‌\ *FILENAME*
- Use the configuration and other resources for the merchant to operate
- from FILENAME.
-
-**-h** \| **–help**
- Print short help on options.
-
-**-i** \| **–init-db**
- Initialize the database by creating tables and indices if necessary.
-
-**-v** \| **–version**
- Print version information.
-
-**-f** *FILENAME* \| **–file-input=**\ ‌\ *FILENAME*
- This option is only available if the exchange was compiled with the
- configure option –enable-developer-mode. It is used for generating
- test cases against the exchange using AFL. When this option is
- present, the HTTP server will
-
- 1. terminate after the first client’s HTTP connection is completed,
- and
- 2. automatically start such a client using a helper process based on
- the nc(1) or ncat(1) binary using FILENAME as the standard input
- to the helper process.
-
- As a result, the process will effectively run with *FILENAME* as the
- input from an HTTP client and then immediately exit. This is useful
- to test taler-exchange-httpd against many different possible inputs
- in a controlled way.
-
-**-t** *SECONDS* \| **–timeout=**\ ‌\ *SECONDS*
- Specifies the number of SECONDS after which the HTTPD should close
- (idle) HTTP connections.
-
-**-L** *LOGLEVEL* \| **–loglevel=**\ ‌\ *LOGLEVEL*
- Specifies the log level to use. Accepted values are: DEBUG, INFO,
- WARNING, ERROR.
-
-SIGNALS
-=======
-
-**taler-exchange-httpd** responds to the following signals:
-
-``SIGUSR1``
- Sending a SIGUSR1 to the process will cause it to reload denomination
- and signing keys.
-
-``SIGTERM``
- Sending a SIGTERM to the process will cause it to shutdown cleanly.
-
-``SIGHUP``
- Sending a SIGHUP to the process will cause it to re-execute the
- taler-exchange-httpd binary in the PATH, passing it the existing
- listen socket. Then the old server process will automatically exit
- after it is done handling existing client connections; the new server
- process will accept and handle new client connections.
-
-See Also
-========
-
-taler-exchange-dbinit(1), taler-exchange-keyup(1),
-taler-exchange-reservemod(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-keycheck.1.rst b/manpages/taler-exchange-keycheck.1.rst
deleted file mode 100644
index 6693b6e3..00000000
--- a/manpages/taler-exchange-keycheck.1.rst
+++ /dev/null
@@ -1,49 +0,0 @@
-taler-exchange-keycheck(1)
-##########################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-keycheck** - check validity of Taler signing and
- denomination keys
-
-Synopsis
-========
-
-**taler-exchange-keycheck**
-[**-d** *DIRNAME* | **–exchange-dir=**\ ‌\ *DIRNAME*]
-[**-h** | **–help**] [**-v** | **–version**]
-
-Description
-===========
-
-**taler-exchange-keycheck** can be used to check if the signing and
-denomination keys in the operation directory are well-formed. This can
-be useful after importing fresh keys from the offline system to ensure
-that the files are correct.
-
-Its options are as follows:
-
-**-d** *DIRNAME* \| **–exchange-dir=**\ ‌\ *DIRNAME*
- Use the configuration and other resources for the exchange to operate
- from *DIRNAME*.
-
-**-h** \| **–help**
- Print short help on options.
-
-**-v** \| **–version**
- Print version information.
-
-See Also
-========
-
-taler-exchange-httpd(1), taler-exchange-keyup(1),
-taler-exchange-dbinit(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-keyup.1.rst b/manpages/taler-exchange-keyup.1.rst
deleted file mode 100644
index 07a6b441..00000000
--- a/manpages/taler-exchange-keyup.1.rst
+++ /dev/null
@@ -1,69 +0,0 @@
-taler-exchange-keyup(1)
-#######################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-keyup** - set up Taler exchange denomination and signing
- keys
-
-Synopsis
-========
-
-**taler-exchange-keyup**
-[**-d** *DIRNAME* | **–exchange-dir=**\ ‌\ *DIRNAME*]
-[**-h** | **–help**] [**-m** *FILE* | **–master-key=**\ ‌\ *FILE*]
-[**-o** *FILE* | **–output=**\ ‌\ *FILE*]
-[**-r** *DKH* | **–revoke=**\ ‌\ *DKH*]
-[**-t** *TIMESTAMP* | **–time=**\ ‌\ *TIMESTAMP*]
-[**-v** | **–version**]
-
-Description
-===========
-
-**taler-exchange-keyup** is a command line tool to setup Taler
-denomination and signing keys. This tool requires access to the
-exchange’s long-term offline signing key and should be run in a secure
-(offline) environment under strict controls. The resulting keys can then
-be copied to the main online directory where the Taler HTTP server
-operates.
-
-Its options are as follows:
-
-**-d** *DIRNAME* \| **–exchange-dir=**\ ‌\ *DIRNAME*
- Use the configuration and other resources for the exchange to operate
- from *DIRNAME*.
-
-**-h** \| **–help**
- Print short help on options.
-
-**-m** *FILE* \| **–master-key=**\ ‌\ *FILE*
- Location of the private EdDSA offline master key of the exchange.
-
-**-o** *FILE* \| **–output=**\ ‌\ *FILE*
- Where to write a denomination key signing request file to be given to
- the auditor.
-
-**-r** *DKH* \| **–revoke=**\ ‌\ *DKH*
- Revoke the denomination key where the denomination public key’s hash
- is DKH.
-
-**-t** *TIMESTAMP* \| **–time=**\ ‌\ *TIMESTAMP*
- Operate as if the current time was *TIMESTAMP*.
-
-**-v** \| **–version**
- Print version information.
-
-See Also
-========
-
-taler-exchange-httpd(1), taler-exchange-keyup(1),
-taler-exchange-keycheck(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-wire.1.rst b/manpages/taler-exchange-wire.1.rst
deleted file mode 100644
index 22ab8572..00000000
--- a/manpages/taler-exchange-wire.1.rst
+++ /dev/null
@@ -1,46 +0,0 @@
-taler-exchange-wire(1)
-######################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-wire** - create the master-key signed responses to
- /wire
-
-Synopsis
-========
-
-**taler-exchange-wire** [**-h** | **–help**]
-[**-m** *MASTERKEYFILE* | **–master=**\ ‌\ *MASTERKEYFILE*]
-[**-v** | **–version**]
-
-Description
-===========
-
-**taler-exchange-wire** is used to create the exchange’s reply to a
-/wire request. It converts the bank details into the appropriate signed
-response. This needs to be done using the long-term offline master key.
-
-Its options are as follows:
-
-**-h** \| **–help**
- Print short help on options.
-
-**-m** *MASTERKEYFILE* \| **–master=**\ ‌\ *MASTERKEYFILE*
- Specifies the name of the file containing the exchange’s master key.
-
-**-v** \| **–version**
- Print version information.
-
-See Also
-========
-
-taler-exchange-httpd(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-exchange-wirewatch.1.rst b/manpages/taler-exchange-wirewatch.1.rst
deleted file mode 100644
index 8aaa50fb..00000000
--- a/manpages/taler-exchange-wirewatch.1.rst
+++ /dev/null
@@ -1,57 +0,0 @@
-taler-exchange-wirewatch(1)
-###########################
-
-.. only:: html
-
- Name
- ====
-
- **taler-exchange-wirewatch** - watch for incoming wire transfers
-
-Synopsis
-========
-
-**taler-exchange-wirewatch**
-[**-t** *PLUGINNAME* | **–type=**\ ‌\ *PLUGINNAME*] [**-h** | **–help**]
-[**-T** | **–test**] [**-r** | **–reset**] [**-v** | **–version**]
-
-Description
-===========
-
-**taler-exchange-wirewatch** is a command line tool to import wire
-transactions into the Taler exchange database.
-
-Its options are as follows:
-
-**-t** *PLUGINNAME* \| **–type=**\ ‌\ *PLUGINNAME*
-
- Use the specified wire plugin and its configuration to talk to the
- bank.
-
-**-h** \| **–help**
-
- Print short help on options.
-
-**-T** \| **–test**
-
- Run in test mode and exit when idle.
-
-**-r** \| **–reset**
-
- Ignore our own database and start with transactions from the
- beginning of time.
-
-**-v** \| **–version**
-
- Print version information.
-
-See Also
-========
-
-taler-exchange-aggregator(1), taler-exchange-httpd(1), taler.conf(5).
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
diff --git a/manpages/taler-merchant-benchmark.1.rst b/manpages/taler-merchant-benchmark.1.rst
deleted file mode 100644
index b4a1af36..00000000
--- a/manpages/taler-merchant-benchmark.1.rst
+++ /dev/null
@@ -1,109 +0,0 @@
-taler-merchant-benchmark(1)
-###########################
-
-
-.. only:: html
-
- Name
- ====
-
- **taler-merchant-benchmark** - generate Taler-style benchmarking payments
-
-
-Synopsis
-========
-
-**taler-merchant-benchmark** [*subcommand*] [*options*]
-
-
-Description
-===========
-
-**taler-merchant-benchmark** is a command line tool to populate your
-merchant database with payments for benchmarking.
-
-
-Subcommands
-===========
-
-ordinary
- Generate normal payments: all the payments are performed (by the
- default instance) and aggregated by the exchange. Takes the following
- options.
-
- -p PN, --payments-number=PN
- Perform PN many payments, defaults to 1.
-
-
- -t TN, --tracks-number=TN
- Perform TN many tracking operations, defaults to 1.
-
-
-corner
- Drive the generator to create unusual situations, like for example
- leaving payments unaggregated, or using a non-default merchant
- instance. Takes the following options.
-
-
- -t TC, --two-coins=TC
- Perform TC many payments that use two coins (normally, all the
- payments use only one coin). TC defaults to 1.
-
-
- -i AI, --alt-instance=AI
- Use AI as the instance, instead of 'default' (which is the
- default instance used.)
-
-
- -u UN, --unaggregated-number=UN
- Generate UN payments that will be left unaggregated. Note that
- subsequent invocations of the generator may pick those
- unaggregated payments and actually aggregated them.
-
-
-
-Common Options
-==============
-
--k K, --currency=K
- Use currency K, mandatory.
-
-
--m URL, --merchant-url=URL
- Use URL as the merchant base URL during the benchmark. The URL
- is mainly used to download and pay for contracts. Mandatory.
-
-
--b URL, --bank-url=URL
- Use URL as the bank's base URL during the benchmark. The URL is
- used to test whether the bank is up and running. Mandatory.
-
--c FILENAME, --config=FILENAME
- Use the configuration and other resources for the merchant to
- operate from FILENAME.
-
--h, --help
- Print short help on options.
-
--v, --version
- Print version information.
-
--l LF, --logfile=LF
- Sends logs to file whose path is LF.
-
-
--L LOGLEVEL, --log=LOGLEVEL
- Use loglevel LOGLEVEL.
-
-
-Bugs
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.
-
-
-See Also
-========
-
-taler-merchant-dbinit(1), taler-merchant-tip-enable(1), taler.conf(5)
diff --git a/manpages/taler-merchant-httpd.1.rst b/manpages/taler-merchant-httpd.1.rst
deleted file mode 100644
index 0d12030f..00000000
--- a/manpages/taler-merchant-httpd.1.rst
+++ /dev/null
@@ -1,63 +0,0 @@
-taler-merchant-httpd(1)
-#######################
-
-.. only:: html
-
- Name
- ====
-
- **taler-merchant-httpd** - Run Taler merchant backend (with RESTful API)
-
-
-Synopsis
-========
-
-**taler-merchant-httpd** [*options*]
-
-
-Description
-===========
-
-taler-merchant-httpd is a command line tool to run the Taler merchant
-(HTTP backend). The required configuration and database must exist
-before running this command.
-
-
-Options
-=======
-
--C, --connection-close
- Force each HTTP connection to be closed after each request
- (useful in combination with -f to avoid having to wait for nc to
- time out).
-
--c FILENAME, --config=FILENAME
- Use the configuration and other resources for the merchant to
- operate from FILENAME.
-
--h, --help
- Print short help on options.
-
--v, --version
- Print version information.
-
-
-Signals
-========
-
-SIGTERM
- Sending a SIGTERM to the process will cause it to shutdown
- cleanly.
-
-
-Bugs
-====
-
-Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
-electronic mail to <taler@gnu.org>
-
-
-See Also
-========
-
-taler-merchant-dbinit(1), taler-merchant-tip-enable(1), taler.conf(5)
diff --git a/manpages/taler.conf.5.rst b/manpages/taler.conf.5.rst
deleted file mode 100644
index 853f05c6..00000000
--- a/manpages/taler.conf.5.rst
+++ /dev/null
@@ -1,364 +0,0 @@
-taler.conf(5)
-#############
-
-.. only:: html
-
- Name
- ====
-
- **taler.conf** - Taler configuration file
-
-
-Description
-===========
-
-The basic structure of the configuration file is the following. The file
-is split into sections. Every section begins with “[SECTIONNAME]” and
-contains a number of options of the form “OPTION=VALUE”. Empty lines and
-lines beginning with a “#” are treated as comments. Files containing
-default values for many of the options described below are installed
-under $TALER_PREFIX/share/taler/config.d/. The configuration file given
-with **-c** to Taler binaries overrides these defaults.
-
-Global Options
---------------
-
-The following options are from the “[taler]” section and used by
-virtually all Taler components.
-
-CURRENCY
- Name of the currency, i.e. “EUR” for Euro.
-
-The “[PATHS]” section is special in that it contains paths that can be
-referenced using “$” in other configuration values that specify
-filenames. For Taler, it commonly contains the following paths:
-
-TALER_HOME
- Home directory of the user, usually “${HOME}”. Can be overwritten by
- testcases by setting ${TALER_TEST_HOME}.
-
-TALER_DATA_HOME
- Where should Taler store its long-term data. Usually
- “${TALER_HOME}/.local/share/taler/”
-
-TALER_CONFIG_HOME
- Where is the Taler configuration kept. Usually
- “${TALER_HOME}/.config/taler/”
-
-TALER_CACHE_HOME
- Where should Taler store cached data. Usually
- “${TALER_HOME}/.cache/taler/”
-
-TALER_RUNTIME_DIR
- Where should Taler store system runtime data (like UNIX domain
- sockets). Usually “${TMP}/taler-system-runtime”.
-
-EXCHANGE OPTIONS
-----------------
-
-The following options are from the “[exchange]” section and used by most
-exchange tools.
-
-DB
- Plugin to use for the database, i.e. “postgres”
-
-PORT
- Port on which the HTTP server listens, i.e. 8080.
-
-MASTER_PUBLIC_KEY
- Crockford Base32-encoded master public key, public version of the
- exchange´s long-time offline signing key.
-
-MASTER_PRIV_FILE
- Location of the master private key on disk. Only used by tools that
- can be run offline (as the master key is for offline signing).
-
-BASE_URL
- Specifies the base URL under which the exchange can be reached. Added
- to wire transfers to enable tracking by merchants.
-
-SIGNKEY_DURATION
- For how long is a signing key valid?
-
-LEGAL_DURATION
- For how long are signatures with signing keys legally valid?
-
-LOOKAHEAD_SIGN
- How long do we generate denomination and signing keys ahead of time?
-
-LOOKAHEAD_PROVIDE
- How long into the future do we provide signing and denomination keys
- to clients?
-
-EXCHANGE POSTGRES BACKEND DATABASE OPTIONS
-------------------------------------------
-
-The following options must be in section “[exchangedb-postgres]” if the
-“postgres” plugin was selected for the database.
-
-CONFIG
- How to access the database, i.e. “postgres:///taler” to use the
- “taler” database. Testcases use “talercheck”.
-
-MERCHANT OPTIONS
-----------------
-
-The following options are from the “[merchant]” section and used by the
-merchant backend.
-
-DB
- Plugin to use for the database, i.e. “postgres”
-
-PORT
- Port on which the HTTP server listens, i.e. 8080.
-
-WIRE_TRANSFER_DELAY
- How quickly do we want the exchange to send us money? Note that wire
- transfer fees will be higher if we ask for money to be wired often.
- Given as a relative time, i.e. “5 s”
-
-DEFAULT_MAX_WIRE_FEE
- Maximum wire fee we are willing to accept from exchanges. Given as a
- Taler amount, i.e. “EUR:0.1”
-
-DEFAULT_MAX_DEPOSIT_FEE
- Maximum deposit fee we are willing to cover. Given as a Taler amount,
- i.e. “EUR:0.1”
-
-MERCHANT POSTGRES BACKEND DATABASE OPTIONS
-------------------------------------------
-
-The following options must be in section “[merchantdb-postgres]” if the
-“postgres” plugin was selected for the database.
-
-CONFIG
- How to access the database, i.e. “postgres:///taler” to use the
- “taler” database. Testcases use “talercheck”.
-
-MERCHANT INSTANCES
-------------------
-
-The merchant configuration must specify a set of instances, containing
-at least the “default” instance. The following options must be given in
-each “[instance-NAME]” section.
-
-KEYFILE
- Name of the file where the instance´s private key is to be stored,
- i.e. “${TALER_CONFIG_HOME}/merchant/instance/name.priv”
-
-NAME
- Human-readable name of the instance, i.e. “Kudos Inc.”
-
-Additionally, for instances that support tipping, the following options
-are required.
-
-TIP_EXCHANGE
- Base-URL of the exchange that holds the reserve for tipping,
- i.e. “https://exchange.demo.taler.net/”
-
-TIP_EXCHANGE_PRIV_FILENAME
- Filename with the private key granting access to the reserve,
- i.e. “${TALER_CONFIG_HOME}/merchant/reserve/tip.priv”
-
-KNOWN EXCHANGES (for merchants and wallets)
--------------------------------------------
-
-The merchant configuration can include a list of known exchanges if the
-merchant wants to specify that certain exchanges are explicitly trusted.
-For each trusted exchange, a section [exchange-NAME] must exist, where
-NAME is a merchant-given name for the exchange. The following options
-must be given in each “[exchange-NAME]” section.
-
-BASE_URL
- Base URL of the exchange, i.e. “https://exchange.demo.taler.net/”
-
-MASTER_KEY
- Crockford Base32 encoded master public key, public version of the
- exchange´s long-time offline signing key
-
-CURRENCY
- Name of the currency for which this exchange is trusted, i.e. “KUDOS”
-
-KNOWN AUDITORS (for merchants and wallets)
-------------------------------------------
-
-The merchant configuration can include a list of known exchanges if the
-merchant wants to specify that certain auditors are explicitly trusted.
-For each trusted exchange, a section [auditor-NAME] must exist, where
-NAME is a merchant-given name for the exchange. The following options
-must be given in each “[auditor-NAME]” section.
-
-BASE_URL
- Base URL of the auditor, i.e. “https://auditor.demo.taler.net/”
-
-AUDITOR_KEY
- Crockford Base32 encoded auditor public key.
-
-CURRENCY
- Name of the currency for which this auditor is trusted, i.e. “KUDOS”
-
-ACCOUNT OPTIONS (for exchanges and merchants)
----------------------------------------------
-
-An exchange (or merchant) can have multiple bank accounts. The following
-options are for sections named “[account-SOMETHING]”. The SOMETHING is
-arbitrary and should be chosen to uniquely identify the bank account for
-the operator. Additional authentication options may need to be specified
-in the account section depending on the PLUGIN used.
-
-URL
- Specifies the payto://-URL of the account. The general format is
- payto://METHOD/DETAILS. This option is used for exchanges and
- merchants.
-
-WIRE_RESPONSE
- Specifies the name of the file in which the /wire response for this
- account should be located. Used by the Taler exchange service and the
- taler-exchange-wire tool and the taler-merchant-httpd (to generate
- the files).
-
-PLUGIN
- Name of the plugin can be used to access the account
- (i.e. “taler-bank” or “ebics”). Used by the merchant backend for back
- office operations (i.e. to identify incoming wire transfers) and by
- the exchange.
-
-ENABLE_DEBIT
- Must be set to YES for the accounts that the
- taler-exchange-aggregator should debit. Not used by merchants.
-
-ENABLE_CREDIT
- Must be set to YES for the accounts that the taler-exchange-wirewatch
- should check for credits. It is yet uncertain if the merchant
- implementation may check this flag as well.
-
-HONOR_instance
- Must be set to YES for the instances (where “instance” is the section
- name of the instance) of the merchant backend that should allow
- incoming wire transfers for this bank account.
-
-ACTIVE_instance
- Must be set to YES for the instances (where “instance” is the section
- name of the instance) of the merchant backend that should use this
- bank account in new offers/contracts. Setting ACTIVE_instance to YES
- requires also setting ENABLE_instance to YES.
-
-TALER-BANK AUTHENTICATION OPTIONS (for accounts)
-------------------------------------------------
-
-The following authentication options are supported by the “taler-bank”
-wire plugin. They must be specified in the “[account-]” section that
-uses the “taler-bank” plugin.
-
-TALER_BANK_AUTH_METHOD
- Authentication method to use. “none” or “basic” are currently
- supported.
-
-USERNAME
- Username to use for authentication. Used with the “basic”
- authentication method.
-
-PASSWORD
- Password to use for authentication. Used with the “basic”
- authentication method.
-
-EBICS AUTHENTICATION OPTIONS
-----------------------------
-
-The following authentication options are supported by the “ebics” wire
-plugin. They must be specified in the “[account-]” section that uses the
-“ebics” plugin.
-
-NONE
- Currently the “ebics” implementation is incomplete and does not
- support authentication.
-
-EXCHANGE WIRE FEE OPTIONS
--------------------------
-
-For each supported wire method (i.e. “x-taler-bank” or “sepa”), sections
-named “[fees-METHOD]” state the (aggregate) wire transfer fee and the
-reserve closing fees charged by the exchange. Note that fees are
-specified using the name of the wire method, not by the plugin name. You
-need to replace “YEAR” in the option name by the calendar year for which
-the fee should apply. Usually, fees should be given for serveral years
-in advance.
-
-WIRE-FEE-YEAR
- Aggregate wire transfer fee merchants are charged in YEAR. Specified
- as a Taler amount using the usual amount syntax
- (CURRENCY:VALUE.FRACTION).
-
-CLOSING-FEE-YEAR
- Reserve closing fee customers are charged in YEAR. Specified as a
- Taler amount using the usual amount syntax (CURRENCY:VALUE.FRACTION).
-
-EXCHANGE COIN OPTIONS
----------------------
-
-The following options must be in sections starting with ``"[coin_]"`` and
-are used by taler-exchange-keyup to create denomination keys.
-
-VALUE
- Value of the coin, i.e. “EUR:1.50” for 1 Euro and 50 Cents (per
- coin).
-
-DURATION_OVERLAP
- How much should validity periods for these coins overlap?
-
-DURATION_WITHDRAW
- How long should the same key be used for clients to withdraw coins of
- this value?
-
-DURATION_SPEND
- How long do clients have to spend these coins?
-
-FEE_WITHDRAW
- What fee is charged for withdrawl?
-
-FEE_DEPOSIT
- What fee is charged for depositing?
-
-FEE_REFRESH
- What fee is charged for refreshing?
-
-FEE_REFUND
- What fee is charged for refunds? When a coin is refunded, the deposit
- fee is returned. Instead, the refund fee is charged to the customer.
-
-RSA_KEYSIZE
- What is the RSA keysize modulos (in bits)?
-
-AUDITOR OPTIONS
----------------
-
-The following options must be in section “[auditor]” for the Taler
-auditor.
-
-DB
- Plugin to use for the database, i.e. “postgres”
-
-AUDITOR_PRIV_FILE
- Name of the file containing the auditor’s private key
-
-AUDITOR POSTGRES BACKEND DATABASE OPTIONS
------------------------------------------
-
-The following options must be in section “[auditordb-postgres]” if the
-“postgres” plugin was selected for the database.
-
-CONFIG
- How to access the database, i.e. "postgres:///taler" to use the
- "taler" database. Testcases use “talercheck”.
-
-SEE ALSO
-========
-
-taler-exchange-dbinit(1), taler-exchange-httpd(1),
-taler-exchange-keyup(1), taler-exchange-wire(1).
-
-BUGS
-====
-
-Report bugs by using https://gnunet.org/bugs/ or by sending electronic
-mail to <taler@gnu.org>.