sync.conf - Sync configuration file
The configuration file is line-oriented.
Blank lines and whitespace at the beginning and end of a line are ignored.
Comments start with #
or %
in the first column
(after any beginning-of-line whitespace) and go to the end of the line.
The file is split into sections.
Every section begins with “[SECTIONNAME]” and
contains a number of options of the form “OPTION=VALUE”.
There may be whitespace around the =
(equal sign).
Section names and options are case-insensitive.
The values, however, are case-sensitive.
In particular, boolean values are one of YES
or NO
.
Values can include whitespace by surrounding
the entire value with "
(double quote).
Note, however, that there are no escape characters in such strings;
all characters between the double quotes (including other double quotes)
are taken verbatim.
Values that represent filenames can begin with a /bin/sh
-like
variable reference.
This can be simple, such as $TMPDIR/foo
, or complex,
such as ${TMPDIR:-${TMP:-/tmp}}/foo
.
See [PATHS]
(below).
Values that represent a time duration are represented as a series
of one or more NUMBER UNIT
pairs, e.g. 60 s
, 4 weeks 1 day
,
5 years 2 minutes
.
Values that represent an amount are in the usual amount syntax:
CURRENCY:VALUE.FRACTION
, e.g. EUR:1.50
.
The FRACTION
portion may extend up to 8 places.
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!
The following options are from the “[sync]” section. This is normally the only section in a sync.conf file.
tcp
or unix
.SERVE
is tcp
.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
.SERVE
is unix
.UNIXPATH
?
Only used if SERVE
is unix
.TESTKUDOS:0.1
.TESTKUDOS:0.0
.16
.sync-dbinit(1), sync-httpd(1), sync-config(1).
Report bugs by using https://bugs.taler.net/ or by sending electronic mail to <taler@gnu.org>.