summaryrefslogtreecommitdiff
path: root/manpages/taler-config.1.rst
blob: de4a589d8e32c6bd87f524adcaae5a526b474611 (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
taler-config(1)
###############

.. only:: html

   Name
   ====

   **taler-config** - configure GNU Taler configuration files

Synopsis
========

**taler-config**
[**-b** *backend* | **––supported-backend=**\ \ *backend*]
[**-c** *filename* | **––config=**\ \ *filename*]
[**-f** | **––filename**]
[**-h** | **––help**]
[**-L** *loglevel* | **––loglevel=**\ \ *loglevel*]
[**-o** *option* | **––option=**\ \ *option*]
[**-S** | **––list-sections**]
[**-s** *section* | **––section=**\ \ *section*]
[**-V** *value* | **––value=**\ \ *value*]
[**-v** | **––version**]
[**-W** | **––rewrite**]

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

**taler-config** can be used to read or modify GNU Taler configuration files.

**-b** *BACKEND* \| **––supported-backend=**\ \ *BACKEND*
    Tests whether the specified *BACKEND* is supported by the current installation.
    The backend must match the name of a plugin, i.e. "namestore_postgres" for
    the Postgres database backend of the "NAMESTORE" service.  If *BACKEND* is
    supported, taler-config will return a status code of 0 (success), otherwise
    77 (unsupported).  When this option is specified, no other options may be
    specified. Specifying this option together with other options will cause
    taler-config to return a status code of 1 (error).

**-c** *FILENAME* \| **––config=**\ \ *FILENAME*
    Use the configuration file *FILENAME*.

**-f** \| **––filename**
    Try to perform expansions as if the option values represent filenames (will
    also be applied even if the option is not really a filename).

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

**-L** *LOGLEVEL* \| **––loglevel=**\ \ *LOGLEVEL*
    Use *LOGLEVEL* for logging.
    Valid values are ``DEBUG``, ``INFO``, ``WARNING``, and ``ERROR``.

**-o** *OPTION* \| **––option=**\ \ *OPTION*
    Which configuration option should be accessed or edited.  Required to set a
    value.  If not given, all values of a given section will be printed in the
    format "OPTION = VALUE".

**-S** \| **––list-sections**
    List available configuration sections for use with ``--section``.

**-s** *SECTION* \| **––section=**\ \ *SECTION*
    Which configuration section should be accessed or edited.
    Required option.

**-V** *VALUE* \| **––value=**\ \ *VALUE*
    Configuration value to store in the given section under the given option.
    Must only be given together with ``-s`` and ``-o`` options.

    Note:
       Changing the configuration file with ``-V`` will remove comments
       and may reorder sections and remove ``@INLINE@`` directives.

**-v** \| **––version**
    Print GNU Taler version number.

**-W** \| **––rewrite**
    Consider differences to defaults only.


See Also
========

taler.conf(5), taler-config-generate(1)

Bugs
====

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