summaryrefslogtreecommitdiff
path: root/manpages/taler-exchange-keyup.1.rst
blob: e101b4cd5aeac1e7433013e52d9fba6432cc2fce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
taler-exchange-keyup(1)
#######################

.. only:: html

   Name
   ====

   **taler-exchange-keyup** - set up Taler exchange denomination and signing
   keys

Synopsis
========

**taler-exchange-keyup**
[**-h** | **––help**]
[**-m** *FILE* | **––master-key=**\ ‌\ *FILE*]
[**-o** *FILE* | **––output=**\ ‌\ *FILE*]
[**-r** *DKH* | **––revoke=**\ ‌\ *DKH*]
[**-t** *TIMESTAMP* | **––time=**\ ‌\ *TIMESTAMP*]
[**-v** | **––version**]

Description
===========

**taler-exchange-keyup** is a command line tool to setup Taler
denomination and signing keys. This tool requires access to the
exchange’s long-term offline signing key and should be run in a secure
(offline) environment under strict controls. The resulting keys can then
be copied to the main online directory where the Taler HTTP server
operates.

Its options are as follows:

**-c** *FILENAME* \| **––config=**\ ‌\ *FILENAME*
   Use the configuration and other resources for the merchant to operate
   from FILENAME.

**-f** *DIRNAME* \| **––feedir=**\ ‌\ *DIRNAME*
   Directory where to write the wire transfer fee structure. If not given,
   the one from the main configuration will be used.

**-h** \| **––help**
   Print short help on options.

**-L** *LOGLEVEL* \| **––loglevel=**\ ‌\ *LOGLEVEL*
   Specifies the log level to use. Accepted values are: DEBUG, INFO,
   WARNING, ERROR.

**-k** *BITS* \| **––replacement-keysize=**\ ‌\ *BITS*
   When revoke an active denomination key (see **--r** option), use
   *BITS* bit for the replacement denomination key. Default is 2048 (bits).

**-m** *FILE* \| **––master-key=**\ ‌\ *FILE*
   Location of the private EdDSA offline master key of the exchange. If not
   given, the location given in the configuration file will be used.

**-o** *FILE* \| **––output=**\ ‌\ *FILE*
   Where to write a denomination key signing request file to be given to
   the auditor.

**-r** *DKH* \| **––revoke=**\ ‌\ *DKH*
   Revoke the denomination key where the denomination public key’s hash
   is DKH.

**-T** *[+/-]MICROSECONDS* \| **––timetravel=**\ ‌\ *[+/-]MICROSECONDS*
   Modify system time (as seen by this process) by the given offset (for debugging/testing).

**-t** *TIMESTAMP* \| **––time=**\ ‌\ *TIMESTAMP*
   Operate as if the current time was *TIMESTAMP*.

**-v** \| **––version**
   Print version information.

See Also
========

taler-exchange-httpd(1), taler-exchange-keyup(1),
taler-exchange-keycheck(1), taler.conf(5).

Bugs
====

Report bugs by using https://bugs.taler.net/ or by sending electronic
mail to <taler@gnu.org>.