summaryrefslogtreecommitdiff
path: root/manpages/taler-merchant-setup-reserve.1.rst
diff options
context:
space:
mode:
Diffstat (limited to 'manpages/taler-merchant-setup-reserve.1.rst')
-rw-r--r--manpages/taler-merchant-setup-reserve.1.rst96
1 files changed, 62 insertions, 34 deletions
diff --git a/manpages/taler-merchant-setup-reserve.1.rst b/manpages/taler-merchant-setup-reserve.1.rst
index 5559d3fe..321af52a 100644
--- a/manpages/taler-merchant-setup-reserve.1.rst
+++ b/manpages/taler-merchant-setup-reserve.1.rst
@@ -13,13 +13,27 @@ taler-merchant-setup-reserve(1)
Synopsis
========
-**taler-merchant-setup-reserve** [*options*]
+**taler-merchant-setup-reserve**
+[**-A** *USERNAME:PASSWORD* | **––auth=**\ \ *USERNAME:PASSWORD*]
+[**-a** *VALUE* | **––amount=**\ \ *VALUE*]
+[**-C** *CERTFILE* | **––cert=**\ \ *CERTFILE*]
+[**-c** *FILENAME* | **––config=**\ \ *FILENAME*]
+[**-e** *URL* | **––exchange-url=**\ \ *URL*]
+[**-h** | **––help**]
+[**-k** *KEYFILE* | **––key=**\ \ *KEYFILE*]
+[**-L** *LOGLEVEL* | **––loglevel=**\ ‌\ *LOGLEVEL*]
+[**-l** *FILENAME* | **––logfile=**\ ‌\ *FILENAME*]
+[**-m** *URL* | **––merchant-url=**\ \ *URL*]
+[**-p** *KEYFILEPASSPHRASE* | **––pass=**\ \ *KEYFILEPASSPHRASE*]
+[**-t** *CERTTYPE* | **––type=**\ \ *CERTTYPE*]
+[**-w** *METHOD* | **––wire-method=**\ \ *METHOD*]
+[**-v** | **––version**]
Description
===========
-**taler-merchant-setup-reserve** is a command line tool to setup a reserve
+**taler-merchant-setup-reserve** is a command-line tool to setup a reserve
(creating the private reserve key) and obtaining the wire transfer information
from the exchange needed to fill the reserve.
@@ -27,55 +41,69 @@ from the exchange needed to fill the reserve.
Options
=======
-**-a** *VALUE* \| **––amount=**\ \ *VALUE*
- Amount to be transferred to the reserve. Mandatory.
-
**-A** *USERNAME:PASSWORD* \| **––auth=**\ \ *USERNAME:PASSWORD*
- Use USERNAME and PASSWORD for HTTP client authentication. The ":" must be present as a separator. Note that this form of authentication has nothing to do with the TLS client certificate authentication supported with the "-C", "-k" and "-p" options. The PASSWORD given to this option is given to the server! Optional.
+ Use ``USERNAME`` and ``PASSWORD`` for HTTP client authentication.
+ The ":" must be present as a separator.
+ Note that this form of authentication has nothing to do with the TLS client
+ certificate authentication supported with the ``-C``, ``-k`` and ``-p`` options.
+ The ``PASSWORD`` given to this option is given to the server!
+
+**-a** *VALUE* \| **––amount=**\ \ *VALUE*
+ Mandatory.
+ Amount to be transferred to the reserve.
**-C** *CERTFILE* \| **––cert=**\ \ *CERTFILE*
- The specified CERTFILE contains a TLS client certificate to be used to authenticate the client. Optional. See also "-t".
+ The specified ``CERTFILE`` contains a TLS client certificate to be used to
+ authenticate the client. See also ``-t``.
+
+**-c** *FILENAME* \| **––config=**\ \ *FILENAME*
+ Use the configuration and other resources for the merchant to
+ operate from ``FILENAME``.
**-e** *URL* \| **––exchange-url=**\ \ *URL*
- Use URL for the exchange base URL. This is the exchange where
- the reserve will be created. The currency used in the amount
- specification must be offered by this exchange. Mandatory.
+ Mandatory.
+ Use ``URL`` for the exchange base URL.
+ This is the exchange where the reserve will be created.
+ The currency used in the amount specification must be offered by this exchange.
+
+**-h** \| **––help**
+ Print short help on options.
**-k** *KEYFILE* \| **––key=**\ \ *KEYFILE*
- The specified KEYFILE contains a TLS client private key to be used to authenticate the client. Optional. See also "-p" and "-C".
+ The specified ``KEYFILE`` contains a TLS client private key to be used to
+ authenticate the client. See also ``-p`` and ``-C``.
+
+**-L** *LOGLEVEL* \| **––loglevel=**\ ‌\ *LOGLEVEL*
+ Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``,
+ ``WARNING``, ``ERROR``.
+
+**-l** *FILENAME* \| **––logfile=**\ ‌\ *FILENAME*
+ Send logging output to *FILENAME*.
**-m** *URL* \| **––merchant-url=**\ \ *URL*
- Use URL as the merchant base URL. Should include the path to
- the instance if the reserve is to be created for a non-default instance.
- Mandatory.
+ Mandatory.
+ Use ``URL`` as the merchant base URL.
+ Should include the path to the instance if the reserve is to be
+ created for a non-default instance.
**-p** *KEYFILEPASSPHRASE* \| **––pass=**\ \ *KEYFILEPASSPHRASE*
- The specified KEYFILEPASSPHRASE is to be used to decrypt the KEYFILE. Optional. See also "-k". Not to be confused with "-A". The KEYFILEPASSPHRASE given here is only used locally to decrypt the KEYFILE.
+ The specified ``KEYFILEPASSPHRASE`` is to be used to decrypt the KEYFILE.
+ See also ``-k``. Not to be confused with ``-A``.
+ The ``KEYFILEPASSPHRASE`` given here is only used locally to decrypt the KEYFILE.
**-t** *CERTTYPE* \| **––type=**\ \ *CERTTYPE*
- The specified CERTFILE contains a TLS client certificate of CERTTYPE. Default is "PEM". Optional. See also "-C".
+ The specified CERTFILE contains a TLS client certificate of ``CERTTYPE``.
+ Default is ``PEM``. See also ``-C``.
**-w** *METHOD* \| **––wire-method=**\ \ *METHOD*
- Which wire method should be used. Needed to select the wire
- transfer method of the exchange. The method must be supported
- by the exchange. Typical values would be "iban" or "x-taler-bank".
- 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.
+ Mandatory.
+ Which wire method should be used.
+ Needed to select the wire transfer method of the exchange.
+ The method must be supported by the exchange.
+ Typical values would be ``iban`` or ``x-taler-bank``.
**-v** \| **––version**
- Print version information.
-
-**-l** *LF* \| **––logfile=**\ \ *LF*
- Sends logs to file whose path is LF.
-
-**-L** *LOGLEVEL* \| **––log=**\ \ *LOGLEVEL*
- Use loglevel LOGLEVEL.
+ Print version information.
See Also