taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit db83b526373744c4e652827a45f1d7c97d9235d2
parent b35bb74a826d74018f9d5b3ac4856a1abe57c966
Author: Christian Grothoff <christian@grothoff.org>
Date:   Tue, 26 Jan 2021 21:45:50 +0100

document #6724 in man pages

Diffstat:
Mmanpages/taler-auditor-offline.1.rst | 24++++++++++++------------
Mmanpages/taler-exchange-offline.1.rst | 24+++++++++++++-----------
2 files changed, 25 insertions(+), 23 deletions(-)

diff --git a/manpages/taler-auditor-offline.1.rst b/manpages/taler-auditor-offline.1.rst @@ -79,19 +79,11 @@ by the auditor. To obtain the auditor's public key, use: .. code-block:: console - $ AUDITOR_PRIV_FILE=`taler-config -f -c $CONF -s AUDITOR -o AUDITOR_PRIV_FILE` - $ gnunet-ecc -p $AUDITOR_PRIV_FILE - -Note that if the private key file does not yet exist, the above will fail. -In this case, create the private key using: - -.. code-block:: console - - $ AUDITOR_PRIV_FILE=`taler-config -f -c $CONF -s AUDITOR -o AUDITOR_PRIV_FILE` - $ AUDITOR_PRIV_DIR=`dirname $AUDITOR_PRIV_FILE` - $ mkdir -p $AUDITOR_PRIV_DIR - $ gnunet-ecc -g1 $AUDITOR_PRIV_FILE + $ taler-auditor-offline setup +Note that if the private key file already exists, the above will simply output +the existing key. Passing additional arguments after setup (including "-") +will cause the output to be encapsulated in JSON. Relevant configuration options for **taler-auditor-offline** are: @@ -102,6 +94,14 @@ Relevant configuration options for **taler-auditor-offline** are: Subcommands =========== +setup +----- + +When run the first time, this subcommand sets up the offline private key and +outputs the resulting public key. Subsequent invocations will simply again +output the (same) public key (in the format usable for the exchange +configuration). + download -------- diff --git a/manpages/taler-exchange-offline.1.rst b/manpages/taler-exchange-offline.1.rst @@ -74,18 +74,11 @@ obtain the master public key, use: .. code-block:: console - $ MASTER_PRIV_FILE=`taler-config -f -c $CONF -s EXCHANGE -o MASTER_PRIV_FILE` - $ gnunet-ecc -p $MASTER_PRIV_FILE + $ taler-exchange-offline setup -Note that if the private key file does not yet exist, the above will fail. -In this case, create the private key using: - -.. code-block:: console - - $ MASTER_PRIV_FILE=`taler-config -f -c $CONF -s EXCHANGE -o MASTER_PRIV_FILE` - $ MASTER_PRIV_DIR=`dirname $MASTER_PRIV_FILE` - $ mkdir -p $MASTER_PRIV_DIR - $ gnunet-ecc -g1 $MASTER_PRIV_FILE +Note that if the private key file already exists, the above will simply output +the existing key. Passing additional arguments after setup (including "-") +will cause the output to be encapsulated in JSON. Relevant configuration options for **taler-exchange-offline** are: @@ -99,6 +92,15 @@ Relevant configuration options for **taler-exchange-offline** are: Subcommands =========== +setup +----- + +When run the first time, this subcommand sets up the offline private key and +outputs the resulting public key. Subsequent invocations will simply again +output the (same) public key (in the format usable for the exchange +configuration). + + download --------