blob: 5ea47c1266027985b0b201ca9c8f3350048faff0 (
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
taler-merchant-httpd(1)
#######################
.. only:: html
Name
====
**taler-merchant-httpd** - Run Taler merchant backend (with RESTful API)
Synopsis
========
**taler-merchant-httpd**
[**-C** | **--connection-close**]
[**-c** *FILENAME* | **--config=**\ \ *FILENAME*]
[**-h** | **--help**]
[**-L** *LOGLEVEL* | **--loglevel=**\ \ *LOGLEVEL*]
[**-l** *FILENAME* | **--logfile=**\ \ *FILENAME*]
[**-T** *USEC* | **--timetravel**\ \ *USEC*]
[**-v** | **--version**]
Description
===========
**taler-merchant-httpd** is a command-line tool to run the Taler merchant
(HTTP backend). The required configuration and database must exist
before running this command.
Options
=======
**-a** *TOKEN* \| **--auth=**\ \ *TOKEN*
Use TOKEN for initial access control to the merchant backend. The value
given in TOKEN must appear in backoffice requests to the default instance
of the merchant, i.e. "Authorization: Bearer secret-token:TOKEN" to obtain
access to the merchant backend. Note that setting a passphrase for the
default instance by any means will block future access via TOKEN. This
is basically a way to reset the passphrase protecting access. TOKEN
should be a "pchar" as per RFC 8959, but this is NOT checked. Note that
TOKEN will only grant access to the 'default' instance, not other instances.
Instead of using the command-line, which exposes TOKEN to users on the
system, you may want to consider setting the
TALER_MERCHANT_TOKEN environment variable instead.
**-C** \| **--connection-close**
Force each HTTP connection to be closed after each request
(useful in combination with -f to avoid having to wait for nc to
time out).
**-c** *FILENAME* \| **--config=**\ \ *FILENAME*
Use the configuration and other resources for the merchant to
operate from FILENAME.
**-h** \| **--help**
Print short help on options.
**-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*.
**-T** *USEC* \| **--timetravel=**\ \ *USEC*
Modify the system time by *USEC* microseconds.
*USEC* may be prefixed with ``+`` or ``-`` (e.g. ``-T +300``).
This option is intended for debugging/testing only.
**-v** \| **--version**
Print version information.
Signals
========
SIGTERM
Sending a SIGTERM to the process will cause it to shutdown
cleanly.
Environment Variables
=====================
TALER_MERCHANT_TOKEN
Like the "-a" option, resets the access token for the default
instance to the given value.
See Also
========
taler-merchant-dbinit(1), taler-merchant-tip-enable(1), taler.conf(5)
Bugs
====
Report bugs by using Mantis https://bugs.taler.net/ or by sending
electronic mail to <taler@gnu.org>
|