From 5c91c3f6c001e37366ad9bf9dfd8835fed9d4d10 Mon Sep 17 00:00:00 2001 From: Florian Dold Date: Wed, 18 Sep 2019 18:50:34 +0200 Subject: manpages live here now --- manpages/taler-auditor-exchange.1.rst | 60 +++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 manpages/taler-auditor-exchange.1.rst (limited to 'manpages/taler-auditor-exchange.1.rst') diff --git a/manpages/taler-auditor-exchange.1.rst b/manpages/taler-auditor-exchange.1.rst new file mode 100644 index 00000000..b7ef1d2f --- /dev/null +++ b/manpages/taler-auditor-exchange.1.rst @@ -0,0 +1,60 @@ +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 . \ No newline at end of file -- cgit v1.2.3