summaryrefslogtreecommitdiff
path: root/manpages/taler-config.1.rst
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2020-12-10 03:08:00 -0500
committerThien-Thi Nguyen <ttn@gnuvola.org>2020-12-10 03:08:00 -0500
commit773ead040a3ae91f1700998ea68a57ae741a36a4 (patch)
tree70027ecfa8f93da4022c9a4b12196ae06821a45e /manpages/taler-config.1.rst
parenta4240a3f575902b6a095becea0450a4731148a4f (diff)
downloaddocs-773ead040a3ae91f1700998ea68a57ae741a36a4.tar.gz
docs-773ead040a3ae91f1700998ea68a57ae741a36a4.tar.bz2
docs-773ead040a3ae91f1700998ea68a57ae741a36a4.zip
new manpage: taler-config(1)
This is basically a copy of gnunet-config, reformatted into ReST, with minor changes to s/gnunet-config/taler-config/g.
Diffstat (limited to 'manpages/taler-config.1.rst')
-rw-r--r--manpages/taler-config.1.rst87
1 files changed, 87 insertions, 0 deletions
diff --git a/manpages/taler-config.1.rst b/manpages/taler-config.1.rst
new file mode 100644
index 0000000..2728e71
--- /dev/null
+++ b/manpages/taler-config.1.rst
@@ -0,0 +1,87 @@
+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.
+
+**-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>.