diff options
Diffstat (limited to 'man')
-rw-r--r-- | man/taler-auditor-exchange.1 | 83 | ||||
-rw-r--r-- | man/taler-auditor-sign.1 | 86 | ||||
-rw-r--r-- | man/taler-auditor.1 | 80 | ||||
-rw-r--r-- | man/taler-bank-transfer.1 | 95 | ||||
-rw-r--r-- | man/taler-config-generate.1 | 117 | ||||
-rw-r--r-- | man/taler-exchange-aggregator.1 | 70 | ||||
-rw-r--r-- | man/taler-exchange-benchmark.1 | 84 | ||||
-rw-r--r-- | man/taler-exchange-dbinit.1 | 79 | ||||
-rw-r--r-- | man/taler-exchange-httpd.1 | 127 | ||||
-rw-r--r-- | man/taler-exchange-keycheck.1 | 71 | ||||
-rw-r--r-- | man/taler-exchange-keyup.1 | 91 | ||||
-rw-r--r-- | man/taler-exchange-wire.1 | 68 | ||||
-rw-r--r-- | man/taler-exchange-wirewatch.1 | 93 | ||||
-rw-r--r-- | man/taler-merchant-benchmark.1 | 118 | ||||
-rw-r--r-- | man/taler-merchant-httpd.1 | 78 | ||||
-rw-r--r-- | man/taler.conf.5 | 390 |
16 files changed, 1730 insertions, 0 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. +. |