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
% 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
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
This can be simple, such as
$TMPDIR/foo, or complex,
Values that represent a time duration are represented as a series
of one or more
NUMBER UNIT pairs, e.g.
4 weeks 1 day,
5 years 2 minutes.
Values that represent an amount are in the usual amount syntax:
FRACTION portion may extend up to 8 places.
Files containing default values for many of the options described below
are installed under
The configuration file given with -c to Sync binaries
overrides these defaults.
A configuration file may include another, by using the
for example, in
main.conf, you could write
@INLINE@ sub.conf to
include the entirety of
sub.conf at that point in
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.
::1for loopback. Can also be given as a hostname. We will bind to the wildcard (dual-stack) if left empty. Only used if
UNIXPATH? Only used if
sync-dbinit(1), sync-httpd(1), sync-config(1).