taler-docs

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

taler-merchant-passwd.1.rst (2215B)

      1 taler-merchant-passwd(1)
      2 ########################
      3 
      4 .. only:: html
      5 
      6    Name
      7    ====
      8 
      9    **taler-merchant-passwd** - reset password of existing instance and/or create admin instance
     10 
     11 
     12 Synopsis
     13 ========
     14 
     15 **taler-merchant-passwd**
     16 [**-c** *FILENAME* | **--config=**\ ‌\ *FILENAME*]
     17 [**-h** | **--help**]
     18 [**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*]
     19 [**-l** *FILENAME* | **--logfile=**\ ‌\ *FILENAME*]
     20 [**-i** *NAME* | **--instance**\ \ *NAME*]
     21 [**-v** | **--version**]
     22 [PASSWORD]
     23 
     24 Description
     25 ===========
     26 
     27 **taler-merchant-passwd** is a command-line tool to reset passwords
     28 of existing Taler instances.  The password must either be specified
     29 as the last command-line argument or in the TALER_MERCHANT_PASSWORD
     30 environment variable.
     31 
     32 Usually, the instance for which the password is being set must
     33 already exist.  However, as a special exception, if the instance
     34 specified is the "admin" instance, then it is created (with
     35 sensible defaults) if it does not yet exist.
     36 
     37 Its options are as follows:
     38 
     39 **-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME*
     40    Use the configuration and other resources for the merchant to operate
     41    from *FILENAME*.
     42 
     43 **-h** \| **--help**
     44    Print short help on options.
     45 
     46 **-i** *NAME* \| **--instance**\ \ *NAME*
     47    Specifies the name of the instance for which the password should be
     48    updated. If not given, the "admin" instance is modified.
     49 
     50 **-L** *LOGLEVEL* \| **--loglevel=**\ ‌\ *LOGLEVEL*
     51    Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``,
     52    ``WARNING``, ``ERROR``.
     53 
     54 **-l** *FILENAME* \| **--logfile=**\ ‌\ *FILENAME*
     55    Send logging output to *FILENAME*.
     56 
     57 **-v** \| **–version**
     58    Print version information.
     59 
     60 Exit Status
     61 ===========
     62 
     63 ``0``
     64    The password was updated successfully.
     65 
     66 ``1``
     67    The merchant database could not be opened.
     68 
     69 ``2``
     70    The requested merchant instance does not exist.
     71 
     72 ``3``
     73    Command-line processing or a database operation failed.
     74 
     75 ``255``
     76    The new password is missing or a superfluous positional argument was given.
     77 
     78 See Also
     79 ========
     80 
     81 taler-merchant-httpd(1), taler-merchant.conf(5).
     82 
     83 Bugs
     84 ====
     85 
     86 Report bugs by using https://bugs.taler.net or by sending electronic
     87 mail to <taler@gnu.org>.