taler-docs

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

taler-merchant-httpd.1.rst (2933B)

      1 taler-merchant-httpd(1)
      2 #######################
      3 
      4 .. only:: html
      5 
      6    Name
      7    ====
      8 
      9    **taler-merchant-httpd** - Run Taler merchant backend (with RESTful API)
     10 
     11 
     12 Synopsis
     13 ========
     14 
     15 **taler-merchant-httpd**
     16 [**-3** | **--http3**]
     17 [**-C** | **--connection-close**]
     18 [**-c** *FILENAME* | **--config=**\ \ *FILENAME*]
     19 [**-h** | **--help**]
     20 [**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*]
     21 [**-l** *FILENAME* | **--logfile=**\ ‌\ *FILENAME*]
     22 [**-T** *USEC* | **--timetravel**\ \ *USEC*]
     23 [**-v** | **--version**]
     24 
     25 Description
     26 ===========
     27 
     28 **taler-merchant-httpd** is a command-line tool to run the Taler merchant
     29 (HTTP backend).  The required configuration and database must exist
     30 before running this command.
     31 
     32 
     33 Options
     34 =======
     35 
     36 **-3** \| **--http3**
     37    Enable the use of HTTP/2 and HTTP/3. Without this option, we
     38    force libcurl to only use HTTP/1.1 when talking to the exchange
     39    or to the Donau.
     40    Note that for some libcurl builds, we will still use HTTP/1.1
     41    even with this option if HTTP/2 or HTTP/3 support are not deemed
     42    to be stable enough.  Setting this option may provide a minor
     43    performance benefit, but it may cause stability issues depending
     44    on the libcurl version used, hence it is off by default.
     45 
     46 **-C** \| **--connection-close**
     47    Force each HTTP connection to be closed after each request
     48    (useful in combination with -f to avoid having to wait for nc to
     49    time out).
     50 
     51 **-c** *FILENAME* \| **--config=**\ \ *FILENAME*
     52    Use the configuration and other resources for the merchant to
     53    operate from FILENAME.
     54 
     55 **-h** \| **--help**
     56    Print short help on options.
     57 
     58 **-L** *LOGLEVEL* \| **--loglevel=**\ ‌\ *LOGLEVEL*
     59    Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``,
     60    ``WARNING``, ``ERROR``.
     61 
     62 **-l** *FILENAME* \| **--logfile=**\ ‌\ *FILENAME*
     63    Send logging output to *FILENAME*.
     64 
     65 **-T** *USEC* \| **--timetravel=**\ \ *USEC*
     66    Modify the system time by *USEC* microseconds.
     67    *USEC* may be prefixed with ``+`` or ``-`` (e.g. ``-T +300``).
     68    This option is intended for debugging/testing only.
     69 
     70 **-v** \| **--version**
     71    Print version information.
     72 
     73 
     74 Signals
     75 ========
     76 
     77 SIGTERM
     78        Sending a SIGTERM to the process will cause it to shutdown
     79        cleanly.
     80 
     81 Exit Status
     82 ===========
     83 
     84 ``0``
     85    Successful termination.
     86 
     87 ``1``
     88    An operational failure occurred.
     89 
     90 ``2``
     91    The command-line arguments are invalid.
     92 
     93 ``4``
     94    Required database access is unavailable.
     95 
     96 ``5``
     97    Required templates or single-page application resources are unavailable.
     98 
     99 ``6``
    100    A required configuration setting is missing or invalid.
    101 
    102 ``9``
    103    A hard failure occurred. Automatic restart should be suppressed until an
    104    operator has intervened.
    105 
    106 
    107 See Also
    108 ========
    109 
    110 taler-merchant-dbinit(1), taler-merchant-setup-reserve(1), taler-merchant.conf(5)
    111 
    112 
    113 Bugs
    114 ====
    115 
    116 Report bugs by using Mantis https://bugs.taler.net/ or by sending
    117 electronic mail to <taler@gnu.org>