diff options
Diffstat (limited to 'man/taler-auditor-exchange.1')
-rw-r--r-- | man/taler-auditor-exchange.1 | 83 |
1 files changed, 83 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. +. |