From b6f3a26a07b85bf21bf9b115bf53f9bb1092f02a Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Tue, 3 Aug 2021 11:59:13 +0200 Subject: -rename tool --- manpages/taler-exchange-wire-gateway-client.1.rst | 118 ++++++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 manpages/taler-exchange-wire-gateway-client.1.rst (limited to 'manpages/taler-exchange-wire-gateway-client.1.rst') diff --git a/manpages/taler-exchange-wire-gateway-client.1.rst b/manpages/taler-exchange-wire-gateway-client.1.rst new file mode 100644 index 00000000..76e8a1a9 --- /dev/null +++ b/manpages/taler-exchange-wire-gateway-client.1.rst @@ -0,0 +1,118 @@ +taler-exchange-wire-gateway-client(1) +##################################### + +.. only:: html + + Name + ==== + + **taler-exchange-wire-gateway-client** - trigger a transfer at the bank (or obtain transaction history) + +Synopsis +======== + +**taler-exchange-wire-gateway-client** +[**-a** *VALUE* | **--amount=**\ ‌\ *VALUE*] +[**-b** *URL* | **--bank=**\ ‌\ *URL*] +[**-C** *ACCOUNT* | **--credit=**\ ‌\ *ACCOUNT*] +[**-c** *FILENAME* | **--config=**\ ‌\ *FILENAME*] +[**-D** *ACCOUNT* | **--debit=**\ ‌\ *ACCOUNT*] +[**-h** | **--help**] +[**-i** | **--credit-history**] +[**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*] +[**-l** *FILENAME* | **--logfile=**\ ‌\ *FILENAME*] +[**-o** | **--debit-history**] +[**-p** *PASSPHRASE* | **--pass=**\ ‌\ *PASSPHRASE*] +[**-S** *STRING* | **--subject=**\ ‌\ *STRING*] +[**-s** *ACCOUNT-SECTION* | **--section=**\ ‌\ *ACCOUNT-SECTION*] +[**-u** *USERNAME* | **--user=**\ ‌\ *USERNAME*] +[**-v** | **--version**] +[**-w** *ROW* | **--since-when=**\ ‌\ *ROW*] + +Description +=========== + +**taler-exchange-wire-gateway-client** is a command-line tool to trigger bank transfers or +inspect wire transfers for exchange accounts using the wire API. The tool is +expected to be used during testing or for diagnostics. + +You can do one of the following four operations during one invocation. + + (1) Execute wire transfer from the exchange to consumer account (**-C**). + (2) Execute wire transfer from consumer account to the exchange (**-D**). + (3) Inspect credit history of the exchange (**-i**). + (4) Inspect debit history of the exchange (**-o**). + +Doing more than one of these at a time will result in an error. Note, +however, that the **-C** and **-D** options also can be used to act as filters +on transaction history operations. + + +Options +======= + +**-a** *VALUE* \| **--amount=**\ ‌\ *VALUE* + Amount to transfer. Given in the Taler-typical format of + CURRENCY:VALUE.FRACTION. + +**-b** *URL* \| **--bank=**\ ‌\ *URL* + URL at which the bank is operation. Conflicts with **-s**. + +**-C** *ACCOUNT* \| **--credit=**\ ‌\ *ACCOUNT* + When doing a wire transfer from the exchange, the money should be credited to *ACCOUNT*. + Specifies the payto:// URI of the account. Can also be used as a filter by credit + account when looking at transaction histories. + +**-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME* + Use the given configuration file. + +**-D** *ACCOUNT* \| **--debit=**\ ‌\ *ACCOUNT* + When doing a wire transfer to the exchange, the *ACCOUNT* is to be debited. + Specifies the payto:// URI of the account. Can also be used as a filter by debit + account when looking at transaction histories. + +**-h** \| **--help** + Print short help on options. + +**-i** \| **--credit-history** + Obtain credit history of the exchange. Conflicts with **-o**. + +**-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*. + +**-o** \| **--debit-history** + Obtain debit history of the exchange. Conflicts with **-i**. + +**-p** *PASSPHRASE* \| **--pass=**\ ‌\ *PASSPHRASE* + Specifies the pass phrase for authentication. Conflicts with **-s**. + +**-S** *SUBJECT* \| **--subject=**\ ‌\ *SUBJECT* + Use *SUBJECT* for the wire transfer subject. Must be a reserve public key for credit operations and a wire transfer identifier for debit operations. If not specified, a random value will be generated instead. + +**-s** *ACCOUNT_SECTION* \| **--section=**\ ‌\ *ACCOUNT-SECTION* + Obtain exchange account information from the *ACCOUNT-SECTION* of the configuration. Conflicts with **-u**, **-p** and **-b**. Note that either **-b** or **-s** must be specified. + +**-u** *USERNAME* \| **--user=**\ ‌\ *USERNAME* + Specifies the username for authentication. Optional and conflicts with **-s**. If neither **-u** nor **-s** are used, we will attempt to talk to the bank without authentication. + +**-v** \| **--version** + Print version information. + +**-w** *ROW* \| **--since-when=**\ ‌\ *ROW* + Specifies a *ROW* from which the history should be obtained. If not given, the 10 youngest transactions are returned. + + +See Also +======== + +taler-bank-manage(1), taler.conf(5), https://docs.taler.net/core/api-wire.html#wire-transfer-test-apis + +Bugs +==== + +Report bugs by using https://bugs.taler.net/ or by sending electronic +mail to -- cgit v1.2.3