From 49ed051fd55cc7df9aa84455d1efef6efadf350a Mon Sep 17 00:00:00 2001 From: Thien-Thi Nguyen Date: Fri, 26 Nov 2021 18:31:18 -0500 Subject: Add manpage: sync.conf(5) * manpages/sync.conf.5.rst: New. * conf.py (man_pages): Add entry for new manpage. This partially addresses . --- manpages/sync.conf.5.rst | 92 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 manpages/sync.conf.5.rst (limited to 'manpages') diff --git a/manpages/sync.conf.5.rst b/manpages/sync.conf.5.rst new file mode 100644 index 00000000..f2a0e6a9 --- /dev/null +++ b/manpages/sync.conf.5.rst @@ -0,0 +1,92 @@ +sync.conf(5) +############ + +.. only:: html + + Name + ==== + + **sync.conf** - Sync configuration file + + +Description +=========== + +.. include:: ../frags/common-conf-syntax.rst + +Files containing default values for many of the options described below +are installed under ``$PREFIX/share/sync/config.d/``. +The configuration file given with **-c** to Sync binaries +overrides these defaults. + +A configuration file may include another, by using the ``@INLINE@`` directive, +for example, in ``main.conf``, you could write ``@INLINE@ sub.conf`` to +include the entirety of ``sub.conf`` at that point in ``main.conf``. + +Be extra careful when using ``sync-config -V VALUE`` to change configuration +values: it will destroy all uses of ``@INLINE@`` and furthermore remove all +comments from the configuration file! + + +GLOBAL OPTIONS +-------------- + +The following options are from the “[sync]” section. +This is normally the only section in a sync.conf file. + +SERVE + This can either be ``tcp`` or ``unix``. + +PORT + Port on which the HTTP server listens, e.g. 9967. + Only used if ``SERVE`` is ``tcp``. + +BIND_TO + Which IP address should we bind to? E.g. ``127.0.0.1`` or ``::1`` + for loopback. Can also be given as a hostname. We will bind to + the wildcard (dual-stack) if left empty. + Only used if ``SERVE`` is ``tcp``. + +UNIXPATH + Which unix domain path should we bind to? + Only used if ``SERVE`` is ``unix``. + +UNIXPATH_MODE = 660 + What should be the file access permissions for ``UNIXPATH``? + Only used if ``SERVE`` is ``unix``. + +DB + Plugin to use for the database, e.g. “postgres”. + +ANNUAL_FEE + Annual fee for an account. + This is in the usual amount syntax, e.g. ``TESTKUDOS:0.1``. + +INSURANCE + Insurance provided against loss, e.g. ``TESTKUDOS:0.0``. + +UPLOAD_LIMIT_MB + Upload limit per backup, in megabytes, e.g. ``16``. + +FULFILLMENT_URL + Fulfillment URL of the SYNC service itself. + +PAYMENT_BACKEND_URL + Base URL of our payment backend. + +API_KEY + API key to pass when accessing the merchant backend. + This is a secret value. + + +SEE ALSO +======== + +sync-dbinit(1), sync-httpd(1), sync-config(1). + + +BUGS +==== + +Report bugs by using https://bugs.taler.net/ or by sending electronic +mail to . -- cgit v1.2.3